核心用法
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) |