Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Phase 5 (#37): optional feeless Nano (XNO) settle leg for the credit top-up

Đang mở
  • Có gì không ổn?
#52 2 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
38/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
blockchain, payments

Hướng nghiên cứu

Start with the Phase 5 credits-ledger design in #37 and the sequencing in epic #31, then review the existing top-up provider-verification entry point. The suggested scope is complete when nano:mainnet is opt-in and per-wallet, proof-of-send verification credits a ledger top-up row, and tests cover the adapter; Phase 6 seller accounting remains separate.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement

A feeless Nano (XNO) settle leg for the SkillX credits ledger (Phase 5, #37)

Hi, thanks for the skillx marketplace this is shaping into — the Phase 5 credits/orders design (#37) with its append-only buyer credit ledger and atomic debit+entitlement grant is exactly the seam a feeless settlement option could sit beside when you wire in the top-up provider.

Why this fits your roadmap

Your own sequencing in the epic (#31) is deliberate: make packages trustworthy, then installable, then "only then attach money and creator payouts." Phase 5 (#37) adds a buyer credit ledger topped up by "verified provider events" with quote/order/atomic-debit and agent-safe confirmation, and Phase 6 (#38) adds creator settlement. The top-up leg is the one place a network itself does the money movement.

The additive Nano (XNO) rail

A Native (Nano) transfer is a single self-custodied L1 block with:

  • Zero fee on any amount — a 0.0001 XNO top-up costs the same $0 as a large one. If credits are per-skill micro-amounts, every other rail charges more in fees than the value that moves.
  • Single-block deterministic finality. At check time the network's block_count equals cemented (both 224,640,663), so a send is final in the next block with no multi-block confirmation wait.
  • No bridging and no approve step. The buyer signs directly to their own Nano account; the ledger can credit on a confirmed block hash they can verify themselves.
  • Atomic debit that matches your model. A Nano send is one signed intent that either lands or does not — there is no partial state, which maps cleanly to your "atomic debit + entitlement grant" acceptance test and your no-double-debit rule.

Your Phase 6 "seller payable placeholder accounting separate from credits" is untouched: Nano only makes the settlement leg costless; your ledger, quotes, entitlements and refund policy stay exactly as designed.

Live evidence, checked moments ago
  • Nano RPC {"action":"block_count"} returns {"count":"224640663","cemented":"224640663"} — fully cemented frontier (rpc.nano.to).
  • A settled Nano x402 purchase verified earlier this week: block E67FB89426F46E6AE4E0E5750B5F814A699965B8639DA89F38689EA1AFE57FC3, confirmed:true, amount 0.00001292 XNO, settled in a single block.
  • @x402nano/exact on npm (v0.3.0, MIT) already implements the Nano x402 exact scheme if you want a programmatic payer for the CLI/agent path: https://www.npmjs.com/package/@x402nano/exact
  • Nano protocol docs: https://docs.nano.org/
Suggested scope
  • Add nano:mainnet as an accepted top-up asset behind your Phase 5 credit-ledger provider-verification gate.
  • Keep it opt-in and per-wallet; the credits ledger, quotes and entitlements remain your contract of record.
  • If useful, I can open a PR adding a Nano settlement adapter against your Phase 5 spec (proof-of-send verification + ledger top-up row) with tests.

No action is required to test the rail yourself — the evidence block above is live on mainnet and verifiable at rpc.nano.to or nanexplorer.com.

Ngôn ngữ chính
TypeScript
Star
186
Fork
40
Merge trung bình
10 giờ 12 phút
Pull request đã merge (30 ngày)
16

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của nextlevelbuilder/skillx

Tất cả issue của nextlevelbuilder/skillx

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.