# @seams/wallet-server 中文文档 规范地址：https://npmcn.com/package/%40seams/wallet-server/ 版本：0\.41\.1 npm 元数据更新时间：2026-11-02T07:57:44.803Z 中文译文更新时间：2026-11-02T10:51:37.858Z 软件包许可：Apache-2\.0 本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40seams/wallet-server 原文对照：https://npmcn.com/package/%40seams/wallet-server/?lang=original 项目主页：https://github.com/seams-tech/seams-wallet#readme 源码仓库：https://github.com/seams-tech/seams-wallet ## 关键信息（来自 npm 元数据） - 包体积（解压后）：51.8 MB，1291 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：2 个 - 首次发布：2026-09-13T01:44:54.921Z - 最新版本发布：2026-11-02T07:57:44.453Z - 已发布版本数：81（近 12 个月 81 个） ## 中文简介 seam服务器TypeScript SDK，用于NEAR和evm系列钱包 ## 安装 ```sh npm install @seams/wallet-server ``` 也可以使用：`pnpm add @seams/wallet-server`、`yarn add @seams/wallet-server`、`bun add @seams/wallet-server` ## README # 接缝钱包服务器 这个包拥有可重用的签名者服务器表面：路由适配器、 WebAuthn验证策略、阈值签名服务、签名者存储 适配器和服务器wasm绑定。 软件包版本为 `@seams/wallet-server@0.41.1`． 搭配 `@seams/wallet@0.41.1` 以及匹配托管资产。使用 `@seams/wallet-cli@0.29.0`. 钱包iframe协议是 **23.0.0**. ```sh pnpm add @seams/wallet-server@0.41.1 ``` ## 谷歌BYO认证 版本0.41.1验证配置的应用程序的签名会话断言或应用程序的谷歌ID令牌，或将其交换为浏览器绑定的切换。 需要特定于环境的谷歌客户机配置和所有者批准的钱包关联。 在启用该特性之前应用打包的签名人迁移。 外部会话授予设置读取权限，并与所有者和签名凭据保持独立。 看到 [谷歌单点登录指南](https://wallet.seams.sh/docs/guides/google-sso) 用于配置、后端交换和撤销。 ## 支持的运行时和入口点 打包的钱包后端运行在Cloudflare worker和耐久对象上， D1，角色私有备份存储，以及Rust/WASM协议工作者。包 不提供节点网关或快速适配器。 | 入口点 | 目的 | | --- | --- | | `@seams/wallet-server` | 共享服务器服务、契约和存储适配器 | | `@seams/wallet-server/router/cloudflare` | Cloudflare路由器适配器 | | `@seams/wallet-server/router/ror` | Router-of-Routers适配器 | | `@seams/wallet-server/storage/tenant-route` | 租户路由存储 | | `@seams/wallet-server/wasm/signer` | 签名器WASM绑定 | | `@seams/wallet-server/cloud-host` | 托管注册和授权服务 | | `@seams/wallet-server/hosted-wallet-gateway` | 托管网关组成 | | `@seams/wallet-server/hosted-wallet-gateway-worker` | Gateway Worker入口点 | | `@seams/wallet-server/local-hosted-wallet-gateway-worker` | 本地网关Worker入口点 | | `@seams/wallet-server/tenant-root` | 租户根生命周期和恢复契约 | | `@seams/wallet-server/local-runtime` | 打包的本地运行时配置 | 该软件包还包括 `artifact-manifest.json`，签名者D1迁移，本地 运行时脚本，以及预构建的托管worker。使用存储库根目录 `pnpm router` 用于源代码开发。已安装用户使用 `seams-wallet-server-local` 中描述的角色和初始化命令 这个 [库的自述](https://npmcn.com/package/README.md#packaged-local-runtime). ## 部署要求 - 应用网关迁移 `0081_registration_directory_publications.sql` 之前 服务注册。自定义网关必须进行调度 `resumeRegistrationDirectoryPublicationsV1` 从 `cloud-host` 入口点。 - 将路由器、派生程序A、派生程序B和签名Worker一起部署。他们的私人 对象地址分配契约采用批量方式。 - 仅在创建日志之前更新过期的初始租户授权 就开始了。保留已开始仪式的原始授权。 - 验证APAC对象主机和数据库主。这个 `apac-se` 提示请求 东南亚的位置，并没有证明物理共置。 看到 [服务器参考](https://wallet.seams.sh/docs/reference/server)， [主持集成](https://wallet.seams.sh/docs/deploy-and-operate/hosted-integration)， 和 [发布说明](https://wallet.seams.sh/docs/releases). 托管的产品服务及其操作工具位于私有环境中 `seams-monorepo` 存储库。 使用 `createApplicationAuthAssertion` 从 `@seams/wallet-server/application-auth` 在经过身份验证的应用程序后端。 通过现有的环境信任设置配置发行者和公钥。 断言绑定了稳定的主题、环境、钱包、接缝尝试、目的和到期。 身份变更和NEAR交易仍然需要新的钱包来源所有者证明。 看到 [应用程序会话指导](https://wallet.seams.sh/docs/guides/application-auth). ## 常见问题 ### @seams/wallet-server 是什么？ seam服务器TypeScript SDK，用于NEAR和evm系列钱包 ### 如何安装 @seams/wallet-server？ 在项目目录运行 npm install @seams/wallet-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 seams-wallet-server-local、seams-wallet-server-d1-migrate、seams-wallet-server-local-init、seams-wallet-server-local-roles，可以用 npx seams-wallet-server-local 直接运行。 ### @seams/wallet-server 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @seams/wallet-server 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @seams/wallet-server 可以商用吗？ @seams/wallet-server 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @seams/wallet-server 还在维护吗？ 最新版本 0\.41\.1 发布于 2026/11/02（1 天前）；至今共发布 81 个版本，其中过去 12 个月发布了 81 个；首次发布于 2026/09/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。