# @buildersgarden/siwa 中文文档

规范地址：https://npmcn.com/package/%40buildersgarden/siwa/

版本：0\.0\.24
npm 元数据更新时间：2026-03-05T11:53:21.520Z
中文译文更新时间：2026-11-08T22:00:09.709Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40buildersgarden/siwa
原文对照：https://npmcn.com/package/%40buildersgarden/siwa/?lang=original
项目主页：https://github.com/builders-garden/siwa#readme
源码仓库：https://github.com/builders-garden/siwa

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：235 kB，56 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：@circle-fin/developer-controlled-wallets \>=6\.0\.0，@fastify/cors \>=9\.0\.0，@openfort/openfort-node \>=0\.9\.0，@privy-io/node \>=1\.0\.0，express ^4\.0\.0 \|\| ^5\.0\.0，fastify \>=4\.0\.0，hono \>=4\.0\.0
- 首次发布：2026-02-05T16:46:19.749Z
- 最新版本发布：2026-03-05T11:53:21.224Z
- 近 30 天下载量：2055（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

Claude 代码技术,用于在互联网上注册AI代理 [ERC-8004(不信任代理人)](https://github.com/builders-garden/ERC-8004) 由\[EIP-4361(SIWE)\]启发的质疑-应对协议(SIWA)认证的标准(SIWA)[https://eips.earthum.or (英语)](https://eips.ethereum.or/)

## 安装

```sh
npm install @buildersgarden/siwa
```

也可以使用：`pnpm add @buildersgarden/siwa`、`yarn add @buildersgarden/siwa`、`bun add @buildersgarden/siwa`

## README

# SIWA - 用代理签名

Claude 代码技术,用于在互联网上注册AI代理 [ERC-8004(不信任代理人)](https://github.com/builders-garden/ERC-8004) 通过 SIWA 标准并认证它们 [EIP-4361 (SIWE) (英语)](https://eips.ethereum.org/EIPS/eip-4361)。 。 。 .

## 它会做什么

-   **创建钱包** 通过密钥环代理生成一个 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` 软件包( 在此单曲中的兄弟):

```bash
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`](https://npmcn.com/package/%40buildersgarden/siwa-testing/README.md) 关于试验环境的全部细节.

## 担保模式

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

见 [`references/security-model.md`](https://npmcn.com/package/%40buildersgarden/siwa/references/security-model.md) 完全威胁模型.

## 技术堆栈

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

## 参考资料

-   [技术 md](https://npmcn.com/package/%40buildersgarden/siwa/skill.md) ——全技能文献和API参考
-   [ERC-8004 规格](https://github.com/builders-garden/ERC-8004)
-   [SIWA 协议光谱](https://npmcn.com/package/%40buildersgarden/siwa/references/siwa-spec.md)

## 常见问题

### @buildersgarden/siwa 是什么？

Claude 代码技术,用于在互联网上注册AI代理 ERC-8004\(不信任代理人\) 由\[EIP-4361\(SIWE\)\]启发的质疑-应对协议\(SIWA\)认证的标准\(SIWA\)https://eips\.earthum\.or \(英语\)

### 如何安装 @buildersgarden/siwa？

在项目目录运行 npm install @buildersgarden/siwa，或使用 pnpm add / yarn add / bun add。

### @buildersgarden/siwa 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @buildersgarden/siwa 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @buildersgarden/siwa 可以商用吗？

@buildersgarden/siwa 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @buildersgarden/siwa 的下载量有多少？

根据 npm 官方下载统计，@buildersgarden/siwa 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,055 次，日均约 69 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @buildersgarden/siwa 还在维护吗？

最新版本 0\.0\.24 发布于 2026/03/05（8 个月前）；至今共发布 24 个版本，其中过去 12 个月发布了 24 个；首次发布于 2026/02/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。