SuperAPI AI 工具集

agentkit-x402

智能体与模型

查看项目

更新于 10-16 01:50

技能介绍

用途:当智能体访问受 x402 + AgentKit 保护的网站或 API 并收到 402 Payment Required 时,先检查响应中是否存在 agentkit 扩展。若存在,尝试 AgentKit 认证以获得免费或折扣访问;仅在无扩展、认证失败服务器仍要求付费、或免费试用次数用尽时,才回退到常规 x402 付费。

主要能力:解析 402 响应中的 agentkit 扩展字段,包括 info(待签名挑战数据)、supportedChains(支持的链与签名类型)以及 mode(访问策略)。模式分为 free(有人类背书的智能体始终免费)、free-trial(前 N 次免费,N 按人类计数)、discount(按折扣价通过 x402 支付)。支持 EOA(eip191)与智能合约钱包(eip1271)两种签名类型。

使用方式:可选用 @worldcoin/agentkit 的 createAgentkitClient 并将请求路由到 agentkit.fetch,使“先试 AgentKit 再付费”的规则确定化。核心流程为:从挑战 info 构造 SIWE(EIP-4361)消息并签名;将 info 字段加上 address、chainId、type、signature 组成 JSON,base64 编码后作为 agentkit HTTP 请求头发送;成功则直接获得资源。注册使用 npx @worldcoin/agentkit-cli register <your-wallet-address>,每个钱包只需注册一次。

限制与注意事项:SIWE 消息格式要求严格,statement 前后需空行、字段顺序固定、使用 LF 换行且末尾无换行;chainId 在请求载荷中为 CAIP-2 格式(如 eip155:8453),在 SIWE 消息中为数字(8453);地址须为 EIP-55 校验和格式;挑战默认 5 分钟过期,过期需重新获取。常见错误包括未在 AgentBook 注册、签名类型或格式错误、header 非有效 base64、挑战过期、不支持链命名空间等。付费价格、具体免费次数等细节资料未提供。