@seams/wallet-server

中文文档
0.41.1发布于 2026/11/02Apache-2.0TypeScriptES Module构建来源已验证

seam服务器TypeScript SDK,用于NEAR和evm系列钱包

中文使用文档
文档目录3 节
  1. 谷歌BYO认证
  2. 支持的运行时和入口点
  3. 部署要求

接缝钱包服务器

这个包拥有可重用的签名者服务器表面:路由适配器、 WebAuthn验证策略、阈值签名服务、签名者存储 适配器和服务器wasm绑定。

软件包版本为 @seams/[email protected]. 搭配 @seams/[email protected] 以及匹配托管资产。使用 @seams/[email protected]. 钱包iframe协议是 23.0.0.

pnpm add @seams/[email protected]

谷歌BYO认证

版本0.41.1验证配置的应用程序的签名会话断言或应用程序的谷歌ID令牌,或将其交换为浏览器绑定的切换。 需要特定于环境的谷歌客户机配置和所有者批准的钱包关联。 在启用该特性之前应用打包的签名人迁移。 外部会话授予设置读取权限,并与所有者和签名凭据保持独立。 看到 谷歌单点登录指南 用于配置、后端交换和撤销。

支持的运行时和入口点

打包的钱包后端运行在Cloudflare worker和耐久对象上, D1,角色私有备份存储,以及Rust/WASM协议工作者。包 不提供节点网关或快速适配器。

入口点目的
@seams/wallet-server共享服务器服务、契约和存储适配器
@seams/wallet-server/router/cloudflareCloudflare路由器适配器
@seams/wallet-server/router/rorRouter-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-workerGateway 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 中描述的角色和初始化命令 这个 库的自述.

部署要求

  • 应用网关迁移 0081_registration_directory_publications.sql 之前 服务注册。自定义网关必须进行调度 resumeRegistrationDirectoryPublicationsV1 从 cloud-host 入口点。
  • 将路由器、派生程序A、派生程序B和签名Worker一起部署。他们的私人 对象地址分配契约采用批量方式。
  • 仅在创建日志之前更新过期的初始租户授权 就开始了。保留已开始仪式的原始授权。
  • 验证APAC对象主机和数据库主。这个 apac-se 提示请求 东南亚的位置,并没有证明物理共置。

看到 服务器参考, 主持集成, 和 发布说明.

托管的产品服务及其操作工具位于私有环境中 seams-monorepo 存储库。

使用 createApplicationAuthAssertion 从 @seams/wallet-server/application-auth 在经过身份验证的应用程序后端。 通过现有的环境信任设置配置发行者和公钥。 断言绑定了稳定的主题、环境、钱包、接缝尝试、目的和到期。 身份变更和NEAR交易仍然需要新的钱包来源所有者证明。 看到 应用程序会话指导.

版本与发布记录

@seams/wallet-server 共发布 81 个版本,首次发布于 2026/09/13;过去 12 个月发布了 81 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.41.1latest2026/11/021 天前
0.41.02026/11/011 天前
0.40.02026/11/012 天前
0.39.02026/11/012 天前
0.37.02026/11/012 天前
0.36.02026/10/312 天前

关于 @seams/wallet-server 的常见问题

@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 和提交记录判断。