Get a clank.money Human Bitcoin Address

🏷️ 注册人类可读比特币地址

通过L402付费流程注册BIP-353人类可读比特币地址,支持DNS解析的链下身份服务,需妥善保管管理令牌。

收藏
4.2k
安装
1k
版本
1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Clank Registration 是一项基于 BIP-353 标准的人类可读比特币地址注册服务,允许用户获取 username.user._bitcoin-payment.clank.money 格式的 DNS 可解析地址。核心交互流程如下:

1. 初始请求:向 POST /api/v1/registrations 提交 username 与 bip321Uri(必须以 bitcoin: 开头)
2. L402 付费挑战:若返回 402,需支付 200 sats 的 Lightning Invoice,获取 preimage 后重试

3. 成功注册:返回 201(DNS 生效)或 202(DNS 待处理),同时下发 managementToken

4. 地址更新:使用 PATCH /api/v1/registrations/{username} + Bearer Token 修改收款地址

该 Skill 深度集成 MoneyDevKit L402 协议(@moneydevkit/nextjs@0.12.0),采用 macaroon-preimage 授权模式。

显著优点

  • 人类可读身份:替代长串地址,提升支付体验与品牌辨识度
  • 标准兼容:严格遵循 BIP-321(支付URI)与 BIP-353(DNS支付指令)规范
  • 即时解析:注册成功后 DNS TXT 记录即时(或短暂延迟后)全球可解析
  • 付费即服务:200 sats 低成本门槛,L402 协议确保"无支付无消耗"
  • 可更新性:通过 managementToken 支持地址变更,无需重新注册

潜在缺点与局限性

  • DNS 依赖:202 状态表明 DNS 发布可能失败,需人工介入或轮询检查
  • 管理令牌风险:managementToken 一旦丢失,地址将永久无法更新(无恢复机制)
  • 用户名锁定:409 冲突需重新选择,热门名称存在抢注风险
  • 链下服务:Clank 作为中心化注册商,其运营持续性影响地址可用性
  • L402 复杂度:要求 Agent 具备 Lightning 支付能力与 preimage 管理能力

适合人群

  • AI Agent 开发者:需要为 Agent 配置可识别的收款身份
  • 比特币 Lightning 应用:构建支持 BIP-353 解析的支付工具
  • 品牌/创作者:希望拥有 brand.user._bitcoin-payment.clank.money 专属地址

常规风险

| 风险类型 | 说明 |
|---------|------|
| **密钥管理** | managementToken 明文存储或泄露导致地址被恶意篡改 |
| **DNS 劫持** | 虽概率极低,但 DNS 层级存在被攻击理论可能 |
| **服务中断** | Clank 运营方故障导致注册/解析不可用 |
| **支付前置** | L402 流程要求先付费后验证,存在"付费但用户名被抢"的竞态窗口(虽文档称409先于402) |

Get a clank.money Human Bitcoin Address 内容

手动下载zip · 2.0 kB
SKILL.mdtext/markdown
请选择文件