用途:在 Starknet 上注册和管理 AI 智能体的链上身份,用于需要 ERC-8004 身份、反馈或验证者证明的场景。不适用于不依赖 ERC-8004 注册表的钱包、支付、DeFi 流程,也不用于 Cairo 合约编写、仅部署任务或安全审计。
主要能力:ERC-8004 定义三个互联的链上注册表——身份注册表(智能体作为带元数据的 ERC-721 NFT)、声誉注册表(反馈,读取时按评价者过滤)、验证注册表(第三方评估,如 zkML、TEE、质押者)。参考实现为 erc8004-cairo。
使用方式:先 npm install starknet,连接有资金的账户到目标 ERC-8004 注册表部署。可调用 register_with_metadata 注册智能体并写入 token_uri 与元数据;用 agent_exists、total_agents、get_metadata、owner_of 查询;仅智能体所有者可 set_metadata 更新元数据。声誉方面,任何客户可调用 give_feedback,分值以 i128 的 value 加 u8 的 value_decimals 表示(如 9977/2 表示 99.77),负数需编码为 FELT_PRIME - abs(value)。get_summary 在客户列表为空时会回滚,必须传入非空可信地址列表,并按 tag1 过滤;返回的 value 可达 ±1e38,应使用 BigInt 与整数格式化。验证方面可调用 validation_request 请求,验证者用 validation_response 回应(分数 0-100),再用 get_summary、get_validation_status 查询。还可结合 A2A Agent Card,在 /.well-known/agent.json 提供发现信息,并推荐 agentName、agentType、version、model、status 等元数据键。
限制与安全:反馈没有所有者签名门槛,任何地址都可写入,无链上反垃圾保护,原始反馈应视为不可信输入并按评价者过滤后再展示或聚合。同一智能体所有者侧(含被授权地址和操作者)不能给自己反馈;也禁止自我验证。签名包含链 ID 与过期时间以防重放。智能体 NFT 可转移,新所有者继承声誉。文档另列出 REGISTRATION_FAILED、AUTHORIZATION_DENIED、VALIDATION_TIMEOUT、SIGNATURE_EXPIRED、OWNER_TRANSFERRED 等错误码及恢复建议。