Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

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

未关闭
#52 2 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
38/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
typescript

调研方向

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.

由索引模型根据 Issue 内容生成。

描述

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.

主要语言
TypeScript
星标
186
派生
40
平均合并
10 小时 12 分钟
30 天内合并 PR
16

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

nextlevelbuilder/skillx 的其他 Issue

查看 nextlevelbuilder/skillx 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。