Phase 5 (#37): optional feeless Nano (XNO) settle leg for the credit top-up
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 38/100
- Issue 类型
- 功能
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- typescript
- 领域
- blockchain, payments
调研方向
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 内容生成。
描述
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_countequalscemented(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/exacton 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:mainnetas 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,通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
nextlevelbuilder/skillx 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 68/100
nextlevelbuilder/skillx#65 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
nextlevelbuilder/skillx#63 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 88/100
nextlevelbuilder/skillx#49 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 76/100
nextlevelbuilder/skillx#28 ·
维护者通常 1 天内回复
-
refactor
难度 2/5 1-3 小时 新手友好度 82/100
nextlevelbuilder/skillx#27 ·
维护者通常 1 天内回复
查看 nextlevelbuilder/skillx 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 62/100
one-zero-eight/apply-bot#39 ·
-
难度 2/5 1-3 小时 新手友好度 72/100
bigbluebutton/bbb-ui-components-react#108 ·
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 82/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 70/100
维护者通常 1 天内回复
-
high priority
难度 2/5 1-3 小时 新手友好度 62/100
CI-CMG/deep-sea-corals-exb#84 · 1 条评论 ·