文档
面向 EVM 与 Solana 的开源 TypeScript 工具包：钱包连接、CAIP-122 签名登录与交易生命周期追踪，配以可选 React 组件库以及托管云或自部署后端。
所有 TUWA 软件包及 Quasar Community Edition 均采用 Apache-2.0 许可证，并将始终保持 Apache-2.0。
第 1 阶段 — 核心认证与底层原语— 面向 EVM 与 Solana 的 CAIP-122 登录与多链基础工具
@tuwaio/siwx-corev0.7.2SIWX (TUWA) 的 L1 核心包：面向 EVM 与 Solana 的 CAIP-122 登录消息构建器、解析器与验证器，包含验证策略、会话匹配、Nonce 与强类型错误。
必需对等依赖@tuwaio/orbit-core >=0.6.1
被以下包使用@tuwaio/sdk@tuwaio/siwx-evm@tuwaio/siwx-react@tuwaio/siwx-server@tuwaio/siwx-solana
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/siwx-evmv0.5.4SIWX (TUWA) 的 L2 EVM 包：基于 viem 与 @wagmi/core 的 CAIP-122 签名器，支持 EIP-191 (EOA)、EIP-1271（智能合约钱包）与 ERC-6492（预部署智能钱包）签名校验。
必需对等依赖@tuwaio/orbit-core >=0.5@tuwaio/siwx-core >=0.4.1@wagmi/core >=3viem >=2.18.6
被以下包使用@tuwaio/evm-sdk@tuwaio/siwx-server
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/siwx-solanav0.7.2SIWX (TUWA) 的 L2 Solana 包：面向 Wallet Standard 与 @solana/kit 钱包的 CAIP-122 签名器，以及基于 Web Crypto 的 ed25519 签名验证。
必需对等依赖@tuwaio/orbit-core >=0.5@tuwaio/orbit-solana >=0.7.1@tuwaio/siwx-core >=0.4.1@solana/kit >=6@wallet-standard/base >=1.1.0
被以下包使用@tuwaio/siwx-server@tuwaio/solana-sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/siwx-reactv0.6.6SIWX (TUWA) 的 L2 React 包：提供用于 CAIP-122 登录流程的 useSiwx 与 useSiwxSession Hook、Zustand 会话存储以及 Satellite Connect 辅助函数。
必需对等依赖@tuwaio/orbit-core >=0.6.1@tuwaio/siwx-core >=0.5immer >=10.0.0react >=18zustand >=5.0.0
被以下包使用@tuwaio/nova-connect@tuwaio/quasar-sdk@tuwaio/sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/siwx-serverv0.8.2SIWX (TUWA) 的 L2 服务端包：提供 EVM 与 Solana 的 CAIP-122 后端验签、一次性 Nonce 与会话存储、HttpOnly Cookie 工具、Next.js App Router 路由处理器以及面向外部认证方的 JWT/JWKS。
必需对等依赖@tuwaio/orbit-core >=0.6.1@tuwaio/siwx-core >=0.5
被以下包使用@tuwaio/sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/orbit-corev0.6.2Orbit Utils (TUWA) 的 L1 核心包：零依赖、与框架无关的多链类型定义、CAIP-2/CAIP-10/CAIP-19 工具、连接器与地址格式化、错误标准化以及 SSR 安全的连接持久化。
被以下包使用@tuwaio/nova-connect@tuwaio/nova-core@tuwaio/nova-transactions@tuwaio/orbit-solana@tuwaio/pulsar-core@tuwaio/pulsar-evm+11 项更多
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/orbit-evmv0.4.2Orbit Utils (TUWA) 的 L2 EVM 包：基于 viem 与 @wagmi/core 构建的缓存客户端、切链工具、ENS 解析以及 ERC-4337 智能账户（Solady 配合 Pimlico Bundler 与 Paymaster）。
必需对等依赖@wagmi/core 3.x.xviem 2.x.x
被以下包使用@tuwaio/evm-sdk@tuwaio/nova-connect@tuwaio/pulsar-evm@tuwaio/satellite-evm@tuwaio/sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/orbit-solanav0.7.4Orbit Utils (TUWA) 的 L2 Solana 包：带缓存的 @solana/kit RPC 客户端、Wallet Standard 钱包发现、集群与区块浏览器工具，以及 SNS 域名与头像解析。
必需对等依赖@tuwaio/orbit-core >=0.4@solana/kit >=6
被以下包使用@tuwaio/nova-connect@tuwaio/pulsar-solana@tuwaio/satellite-solana@tuwaio/sdk@tuwaio/siwx-solana@tuwaio/solana-sdk
点击查看包含对等依赖的安装命令、指南与链接第 2 阶段 — 状态机与连接层— 无头钱包连接与交易生命周期追踪
@tuwaio/satellite-corev0.12.0Satellite Connect (TUWA) 的 L3 核心包：面向 EVM 与 Solana 钱包连接的无头、框架无关 Zustand 状态库，支持自动重连上次钱包及 SIWX 状态类型。
必需对等依赖@tuwaio/orbit-core >=0.6.1immer 11.x.xzustand 5.x.x
被以下包使用@tuwaio/evm-sdk@tuwaio/nova-connect@tuwaio/satellite-evm@tuwaio/satellite-react@tuwaio/satellite-solana@tuwaio/sdk+1 项更多
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/satellite-evmv0.11.0Satellite Connect (TUWA) 的 L4 EVM 包：基于 @wagmi/core 与 viem 的 wagmi 连接器适配器、连接监听器、合约账户检测及 wagmi 配置辅助函数。
必需对等依赖@tuwaio/orbit-core >=0.6.1@tuwaio/orbit-evm >=0.3@tuwaio/satellite-core >=0.7@wagmi/core 3.x.xviem 2.x.x
被以下包使用@tuwaio/evm-sdk@tuwaio/nova-connect@tuwaio/satellite-react@tuwaio/sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/satellite-solanav0.11.4Satellite Connect (TUWA) 的 L4 Solana 包：基于 @solana/kit 构建的 Wallet Standard 适配器、连接监听器与消息签名器。
必需对等依赖@tuwaio/orbit-core >=0.6.1@tuwaio/orbit-solana >=0.7.2@tuwaio/satellite-core >=0.7@solana/kit >=8.2@wallet-standard/base 1.1.x@wallet-standard/features 1.1.x+2 项更多
被以下包使用@tuwaio/nova-connect@tuwaio/satellite-react@tuwaio/sdk@tuwaio/solana-sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/satellite-reactv0.10.4Satellite Connect (TUWA) 的 L4 React 包：提供 Provider、状态 Hook 以及保持 EVM/Solana 钱包与 SIWX 会话同步的监听组件。
必需对等依赖@tuwaio/orbit-core >=0.6.1@tuwaio/satellite-core >=0.7react >=19.2.3zustand 5.x.x
被以下包使用@tuwaio/nova-connect@tuwaio/sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/satellite-siwe-next-authv0.4.2已弃用： 请改用 @tuwaio/siwx-react 与 @tuwaio/siwx-server。TUWA 生态系统第 4 层 (L4)。用于服务端会话认证的历史遗留适配器，已被现代化的跨链 SIWX 模块取代。
必需对等依赖@wagmi/core 3.x.xiron-session 8.x.xnext >=16.1react >=19.2.3viem 2.x.xwagmi 3.x.x
点击查看详情@tuwaio/pulsar-corev0.12.4Pulsar (TUWA) 的 L3 核心包：支持 localStorage 持久化的无头、框架无关交易状态库，定义链适配器契约、元数据校验及跨 EVM 与 Solana 的远程同步钩子。
必需对等依赖@tuwaio/orbit-core >=0.6.2dayjs 1.x.ximmer 11.x.xzustand 5.x.x
被以下包使用@tuwaio/nova-connect@tuwaio/nova-transactions@tuwaio/pulsar-evm@tuwaio/pulsar-solana@tuwaio/quasar-sdk@tuwaio/sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/pulsar-evmv0.13.3Pulsar (TUWA) 的 L4 EVM 包：基于 viem 与 @wagmi/core 的交易适配器与追踪器，支持标准 EVM 交易、ERC-4337 UserOperation 与 Safe 多签，并提供加速与取消操作。
必需对等依赖@tuwaio/orbit-core >=0.6.1@tuwaio/orbit-evm >=0.3@tuwaio/pulsar-core >=0.12@wagmi/core 3.x.xdayjs 1.x.xviem 2.x.x
被以下包使用@tuwaio/evm-sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/pulsar-solanav0.11.2Pulsar (TUWA) 的 L4 Solana 包：基于 @solana/kit 构建的 Wallet Standard 交易适配器、签名追踪器以及签名广播辅助函数。
必需对等依赖@tuwaio/orbit-core >=0.6.1@tuwaio/orbit-solana >=0.4@tuwaio/pulsar-core >=0.12@solana/kit >=8.2dayjs 1.x.x
被以下包使用@tuwaio/solana-sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/pulsar-reactv0.8.0Pulsar (TUWA) 的 L4 React 包：useInitializeTransactionsPool 在页面刷新后恢复挂起交易的追踪，useTxFinished 响应每一笔完成的交易。
必需对等依赖react >=19.2.3
被以下包使用@tuwaio/sdk
点击查看包含对等依赖的安装命令、指南与链接第 3 阶段 — 服务端与状态同步— 托管云或私有化自部署的 Quasar 引擎
@tuwaio/quasar-sdkv0.8.0Quasar (TUWA) 的 L5 客户端：适用于 Quasar Cloud 与自部署 Quasar 节点的 API 客户端（提供 Pulsar 交易同步与历史查询），以及将 Webhook 转发至 localhost 的 quasar-sdk CLI。
点击查看包含对等依赖的安装命令、指南与链接Quasar Dashboard
第 4 阶段 — 用户界面组件— 面向 Satellite 与 Pulsar 的 React 组件库
@tuwaio/nova-corev0.13.1Nova UI Kit (TUWA) 的 L6 核心包：包含 --tuwa-* 主题 CSS 变量、通用对话框、网络与钱包图标，以及 Nova 组件共享的 Hook 与工具函数。
必需对等依赖@tuwaio/orbit-core >=0.6.1@radix-ui/react-dialog 1.x.x@web3icons/common >=0.11@web3icons/react >=4.1.24clsx 2.x.xframer-motion 12.x.x || 13.x.x || 14.x.x+2 项更多
被以下包使用@tuwaio/nova-connect@tuwaio/nova-transactions@tuwaio/sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/nova-connectv0.13.0Nova UI Kit (TUWA) 的 L7 钱包连接组件包：提供连接按钮、连接与账户模态框、网络切换器以及 EVM 和 Solana 的 SIWX 登录，内置英文、乌克兰语与简体中文文案，构建于 @tuwaio/satellite-react 之上。
必需对等依赖@tuwaio/nova-core >=0.13@tuwaio/nova-transactions >=0.11@tuwaio/orbit-core >=0.6.2@tuwaio/pulsar-core >=0.12@tuwaio/satellite-core >=0.12@tuwaio/satellite-react >=0.7+7 项更多
被以下包使用@tuwaio/sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/nova-transactionsv0.13.1Nova UI Kit (TUWA) 的 L7 交易组件包：为 Pulsar 追踪的交易提供弹窗提示 (Toast)、支持加速与取消的追踪模态框以及交易历史列表。
必需对等依赖@tuwaio/nova-core >=0.13@tuwaio/orbit-core >=0.6.2@tuwaio/pulsar-core >=0.12@heroicons/react 2.x.xdayjs 1.x.xframer-motion 12.x.x || 13.x.x || 14.x.x+2 项更多
被以下包使用@tuwaio/nova-connect@tuwaio/sdk
点击查看包含对等依赖的安装命令、指南与链接第 5 阶段 — SDK 统一集成层— 核心客户端 SDK 与特定网络适配器
@tuwaio/sdkv0.7.1TUWA SDK 的 L8 核心包：面向 React 应用的一体化安装包，通过子路径导出 Orbit Utils、SIWX、Satellite Connect、Pulsar 与 Nova UI Kit 及其样式表。按目标网络搭配 @tuwaio/evm-sdk 或 @tuwaio/solana-sdk 即可。
必需对等依赖react >=19.2.3react-dom >=19.2.3
被以下包使用@tuwaio/evm-sdk@tuwaio/solana-sdk
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/evm-sdkv0.7.0TUWA SDK 的 L9 EVM 扩展包：通过子路径统一重导出 Orbit Utils、SIWX、Satellite Connect、Pulsar 与 Nova Connect 的 EVM 模块。
必需对等依赖@tuwaio/satellite-core >=0.7@tuwaio/sdk >=0.7@wagmi/core 3.x.xviem 2.x.x
点击查看包含对等依赖的安装命令、指南与链接@tuwaio/solana-sdkv0.7.0TUWA SDK 的 L9 Solana 扩展包：通过子路径统一重导出 Orbit Utils、SIWX、Satellite Connect、Pulsar 与 Nova Connect 的 Solana 模块。
必需对等依赖@tuwaio/satellite-core >=0.7@tuwaio/sdk >=0.7@solana/kit >=8.2@wallet-standard/app 1.1.x@wallet-standard/base 1.1.x@wallet-standard/features 1.1.x+3 项更多
点击查看包含对等依赖的安装命令、指南与链接几分钟内 Cosmos Playground
挑选适合您应用的软件包，构建完整的 React dApp，或者在您自己的服务器上运行 Quasar。
$npx @tuwaio/create-cosmos-playground
1
运行命令
在您的项目目录中执行交互式 CLI 命令。
2
选择模板
选择适用于 EVM、Solana 或多链的 React 或 Next.js 模板。 对比模板差异
3
开始构建
启动本地开发服务器，开始构建非托管的 Web3 去中心化应用。
配置您的技术栈
选择框架、区块链网络与所需特性，立即生成安装命令与全套配置文件。
安装命令
pnpm add @tuwaio/sdk @tuwaio/evm-sdk @wagmi/core viem