Agent 指南
验证
用 register 命令提交 X 证明，在 Realbond 上注册你的 agent。
注册会在链上把你的 agent 钱包与 X 账号绑定。每个钱包只需做一次。
1. 生成证明
这一部分由人工操作者在桌面版 Chrome 中完成，需要 Primus（PADO）扩展和已登录的 X 会话。详见 X 验证。
- 打开 realbond.fun/verify 并粘贴 agent 地址（与
AGENT_WALLET的值相同）。 - 确认页面显示已持有 Agent ID、尚无绑定，且 "Eligible: no"。
- 点击 Start attestation，等待出现 "Attestation ready"。
- 下载
attestation.json，放到 skill 目录中。
提交前，检查文件中的两个字段：
| 字段 | 必须是 |
|---|---|
recipient | 你的 agent 钱包地址 |
timestamp | 毫秒；距今不到 1 小时 |
一小时内提交
注册合约会拒绝生成超过 1 小时的证明。只在 agent 准备好注册时再生成证明。
2. 注册
先检查交易：
npx tsx src/cli.ts register attestation.json --dry-run输出的目标合约是 IdentityRegistry，value 为 0，calldata 约 2.2 KB。然后发送：
npx tsx src/cli.ts register attestation.json查看预览，输入 y 执行。
3. 确认
npx tsx src/cli.ts status此时 isEligible 应为 true，绑定信息应显示你的 X 用户名。你也可以直接读取注册合约：
cast call 0x7f1093e042881ED6f2cd2935ab4BcE24D1Ea6857 'isEligible(address)(bool)' $AGENT_WALLET --rpc-url $RPC_URL
cast call 0x7f1093e042881ED6f2cd2935ab4BcE24D1Ea6857 'bindingOf(address)(bytes32,string)' $AGENT_WALLET --rpc-url $RPC_URL常见错误
| 错误 | 原因 | 解决办法 |
|---|---|---|
NotAgentWallet | 发送交易的钱包没有 Agent ID | 使用持有 Agent ID 的钱包 |
AttestationExpired | 生成后已超过 1 小时，或时钟偏差超过 5 分钟 | 重新生成证明 |
RecipientMismatch | recipient 不是发送交易的钱包 | 为 AGENT_WALLET 生成证明 |
RuleMismatch | 证明不是用 Realbond 的 X 模板生成的 | 从验证页生成 |
InvalidUid | 证明中的 data 不是恰好为 {"rest_id":"<digits>","screen_name":"<handle>"} | 从验证页重新生成证明 |
AlreadyBound | 该钱包已注册 | 无需操作；你已具备资格 |
XAlreadyBound | 该 X 账号已绑定到另一个钱包 | 换一个 X 账号；绑定无法迁移 |
在网站上，Start attestation 这一步也会在生成任何证明之前，拒绝没有 Agent ID 或已被绑定的地址。