Skip to Content
简介

简介

TUWA SDK

TUWA SDK 是在 React 应用中使用 TUWA 的最短路径。@tuwaio/sdk 通过子路径重导出 Orbit Utils、Pulsar、Satellite Connect、SIWX 与 Nova UI Kit 的客户端包，其扩展包 @tuwaio/evm-sdk 与 @tuwaio/solana-sdk 则添加应用所用的链。支付是建立在其上的独立模块：@tuwaio/payments-sdk。

🏛️ SDK 在 TUWA 中的位置

TUWA 按阶段构建，每个阶段都建立在之前的阶段之上：

阶段项目作用
1 — 核心认证与底层原语SIWX 、Orbit Utils CAIP-122 身份认证与多链原语
2 — 状态机与连接层Satellite Connect 、Pulsar 钱包连接状态与交易追踪
3 — 服务端与状态同步Quasar （Cloud 或自部署的 Community 版），配合 Quasar Client 服务端交易追踪、历史记录与 Webhook
4 — 用户界面组件Nova UI Kit React 设计系统与组件
5 — SDK 统一集成层@tuwaio/sdk、@tuwaio/evm-sdk、@tuwaio/solana-sdk一次安装即可获得第 1、2、4 阶段的客户端包

第 5 阶段的包不包含自己的逻辑：每个子路径都是某个 TUWA 包的一个入口，其参考文档位于对应项目的站点上。SDK 决定哪些版本的 TUWA 包可以协同工作，并为每个包提供唯一的导入路径。

🧭 设计原则

  1. 一次安装，版本经过测试： TUWA 包是 @tuwaio/sdk 及其扩展包的依赖，因此 SDK 的每个版本都会锁定可以协同工作的包版本。React、viem、@wagmi/core、@solana/kit 与 Wallet Standard 包仍为对等依赖，因此应用中每个库只保留一份。
  2. 只引入所用的链： @tuwaio/sdk 不加载任何 EVM 或 Solana 代码。EVM 应用添加 @tuwaio/evm-sdk，Solana 应用添加 @tuwaio/solana-sdk，同时使用两者的应用则两者都添加。
  3. 相同的包，相同的文档： 子路径原样重导出 TUWA 包，因此 Orbit、Pulsar、Satellite Connect、SIWX 与 Nova UI Kit 站点上的所有内容照常适用；只有导入路径不同。

🧩 软件包

软件包层级提供的功能对等依赖
@tuwaio/sdkL8通过子路径提供 Orbit、Pulsar、Satellite Connect、SIWX 与 Nova UI Kit；Nova 样式表react, react-dom (>=19.2.3)
@tuwaio/evm-sdkL9Orbit、Satellite Connect、Pulsar、SIWX 与 Nova Connect 的 EVM 包@tuwaio/sdk ≥ 0.6, @wagmi/core 3.x, viem 2.x
@tuwaio/solana-sdkL9Orbit、Satellite Connect、Pulsar、SIWX 与 Nova Connect 的 Solana 包@tuwaio/sdk ≥ 0.6, @solana/kit ≥ 8.2, Wallet Standard 包

@tuwaio/sdk、@tuwaio/evm-sdk 与 @tuwaio/solana-sdk 的页面列出各自的子路径，并附有指向每个被重导出包参考文档的链接。

💾 安装

# React app: the SDK and the chains it uses
pnpm add @tuwaio/sdk react react-dom
pnpm add @tuwaio/evm-sdk @wagmi/core viem
pnpm add @tuwaio/solana-sdk @solana/kit

pnpm（8 及以上）、npm（7 及以上）与 Bun 还会安装 @tuwaio/solana-sdk 的 Wallet Standard 对等依赖（@wallet-standard/app、base、features、react、ui 与 ui-registry）；使用 Yarn 时，请将它们加入安装命令。

📚 后续步骤

最后更新于
概览