用途:通过 identity-registry 合约执行 ERC-8004 标准的链上智能体身份操作。读取操作(get、get-metadata、get-last-id)无需钱包;写入操作(register、set-uri、set-metadata、set-approval、set-wallet、unset-wallet、transfer)需要已解锁钱包(bun run wallet/wallet.ts unlock)。
主要能力:register 链上注册新身份并返回交易 ID;get 查询所有者地址、URI 与钱包;set-uri 更新元数据地址;set-metadata 设置键值对(值需为十六进制缓冲区,最大 512 字节,键 agentWallet 为保留键会被合约拒绝);set-approval 授予或撤销操作员(可代更新 URI、元数据与钱包);set-wallet 将智能体钱包设为当前 tx-sender;unset-wallet 解除钱包关联;transfer 将身份 NFT 转给新所有者,并自动清除钱包关联。
用法:统一命令为 bun run identity/identity.ts <subcommand> [options]。各子命令按需传入 --agent-id(必填,非负整数)、--uri、--key、--value、--operator、--recipient 等参数,可选 --fee(low/medium/high 或 micro-STX 数值)与 --sponsored 提交赞助交易。智能体 ID 由合约在注册时分配,需查看交易结果获取。
限制:写入需解锁钱包;仅所有者或已授权操作员可修改;元数据值须为十六进制编码;转账后钱包关联被清除,如需可再次 set-wallet;未提供的收费与部署细节暂未说明。