SIWA - 用代理签名

Claude 代码技术,用于在互联网上注册AI代理 ERC-8004(不信任代理人) 通过 SIWA 标准并认证它们 EIP-4361 (SIWE) (英语)。 。 。 .

它会做什么

• 创建钱包 通过密钥环代理生成一个 Ethereum 钱包( 私人密钥从未进入代理进程)
• 注册代理( 签名) ERC-8004 身份登记簿上装有元数据(端点、信任模式、服务)的ERC-721身份
• 认证( 签名入) ——通过签署结构化的SIWA信息,证明对链上代理身份的所有权;收到依赖方的核查收据并使用ERC-8128按请求的签名进行后续API通话

项目结构

src/               Core SDK modules
  keystore.ts        Proxy-only keystore (signing delegated over HMAC-authenticated HTTP)
  identity.ts        SIWA_IDENTITY.md read/write helpers
  siwa.ts            SIWA message building, signing, verification
  proxy-auth.ts      HMAC-SHA256 authentication utilities
  registry.ts        Onchain agent profile & reputation lookups
  addresses.ts       Deployed contract addresses
  receipt.ts         Stateless HMAC receipt creation and verification
  erc8128.ts         ERC-8128 HTTP Message Signatures (sign/verify)

references/        Protocol documentation
  siwa-spec.md       Full SIWA specification
  security-model.md  Threat model and keystore architecture

assets/            Templates
  SIWA_IDENTITY.template.md

快速启动( 本地测试)

试管在 siwa-testing 软件包( 在此单曲中的兄弟):

cd packages/siwa-testing
pnpm install

# Terminal 1: Start the SIWA relying-party server
pnpm run server

# Terminal 2: Run the full agent flow (create wallet → register → sign in → authenticated call)
pnpm run agent:flow

# Or run both at once:
pnpm run dev

见 packages/siwa-testing/README.md 关于试验环境的全部细节.

担保模式

代理商的私钥从不进入代理程序. 所有签名都委托给 密钥环代理 超过HMAC认证的HTTP。 即使是完全的代理人妥协也无法取出钥匙——只有请求签名.

见 references/security-model.md 完全威胁模型.

技术堆栈

• 类型脚本 (ES模块,严格模式)
• 维姆 钱包管理和合同互动
• 小时 ——软件包管理器

参考资料

• 技术 md ——全技能文献和API参考
• ERC-8004 规格
• SIWA 协议光谱