TUWATUWA

连接、登录与交易追踪 （EVM 与 Solana）

专为自托管 Web3 应用打造的开源 TypeScript 工具包：集成钱包连接、基于 CAIP-122 标准的统一登录，以及即使页面刷新也能持续跟踪交易状态的追踪引擎。提供即用型 React 组件，后端可选用云服务或自主部署，绝无按 MAU 计费的门槛。

开始构建→GitHub
在线体验

体验 统一技术栈 的强大功能

观看 Satellite Connect（钱包连接）、Pulsar（交易跟踪）与 Nova UI Kit（通知与模态框）的无缝协作。您可以尝试模拟交互，也可以连接真实钱包向 Sepolia 或 Solana Devnet 发送测试交易。

EVM 演示

交互式引擎全真模拟

智能合约交互

使用简易计数器合约测试完整的交易追踪流程

需要连接钱包

连接钱包以查看和追踪您的合约交易

连接钱包

💡 自动化全真演示沙盒

准备好连接自己的钱包了吗？连接即可解锁组件：
在 Playground 中体验失败恢复、加速替换、SIWX 与 Quasar 同步 →

一应俱全的 统一 SDK

适用于 EVM 和 Solana 应用的完整技术栈。可通过单一套件 @tuwaio/sdk 安装，也可按需引入独立包。

第 1 阶段 — 核心认证与底层基语面向 EVM 和 Solana 的 CAIP-122 登录与多链基础工具

Orbit Utils — 多链工具库

面向 EVM 与 Solana 的多链工具包：网络与账户规范（CAIP-2, CAIP-10, CAIP-19）、缓存化 viem 与 @solana/kit 客户端、ENS/SNS 域名解析、ERC-4337 智能账户。

CAIP 工具viem & @solana/kitERC-4337
查看文档

SIWX — 多链身份认证

遵循 CAIP-122 标准的统一钱包签名登录流程，支持在自主服务端完成验签、会话管理、单次防重放 Nonce 与 JWT 颁发。

CAIP-122EVM 及智能钱包Solana (ed25519)JWT + JWKS
查看文档
第 2 阶段 — 状态机与网络连接无头钱包连接与交易全流程跟踪

Satellite Connect — 钱包连接管理

面向 EVM 和 Solana 的无头钱包连接状态机与 React 绑定库。基于 EIP-6963 和 Wallet Standard 等开放协议打造。

钱包连接EVM & SolanaSIWX 会话联动
查看文档

Pulsar — 交易生命周期跟踪

持久化跟踪 EVM 与 Solana 上的交易状态，无惧页面刷新与标签关闭：涵盖待处理、成功、失败及加速/取消替换，支持 ERC-4337、EIP-5792 与 Safe。

交易跟踪本地持久化替换/加速/取消侦测
查看文档
第 3 阶段 — 云端索引与状态同步Quasar — 服务端交易索引、历史记录与 Webhook，支持托管云与自部署

Quasar — 云端索引与状态同步

服务端交易生命周期跟踪、多端交易历史同步与带签名的 Webhook 消息通知。可选用 Quasar Cloud 或自建开源社区版。

服务端跟踪多端历史同步安全 Webhook支持私有化部署
了解 Quasar
第 4 阶段 — 用户界面与交互组件Nova UI Kit — 针对 Satellite Connect 和 Pulsar 的 React UI 组件库

Nova UI Kit — React 交互组件库

专为 EVM 与 Solana 设计的钱包连接与交易组件库：连接按钮、选择弹窗、交易状态 Toast、历史抽屉，均可通过 CSS 变量深度定制。

React 组件库主题深度定制Tailwind CSS v4
查看文档
第 5 阶段 — SDK 集成层TUWA SDK — 适用于 React 应用的整合包，附带 EVM 和 Solana 插件

TUWA SDK — React 整合总包

面向 React 应用的总括包：在各子路径下重新导出 Orbit Utils、SIWX、Satellite Connect、Pulsar 与 Nova UI Kit，并提供 EVM 或 Solana 插件。

一体化总包@tuwaio/sdkEVM 插件Solana 插件
查看文档
阅读文档→

TUWA 的 核心优势

专为自托管应用而设计：用户掌握私钥，服务器自主存储数据，TUWA 承诺不采集任何行为遥测。

本地优先状态机

Pulsar 将交易持久化到 localStorage，刷新后立刻继续追踪；Satellite 自动重连上一次的钱包。绝无任何隐私追踪或遥测数据发送给 TUWA，涉及的外部第三方节点（RPC、WalletConnect 中继、SNS）均为可选并在各包 README 中明文列出。

客户端全生命周期

告别 MAU 阶梯收费

全部客户端软件包终身免费；Quasar Cloud 公测期间免费使用，为每个团队赠送 1,000 点免费配额。计费指标仅与实际跟踪的交易次数挂钩，与月活用户数（MAU）无关，业务规模爆发不再受高额账单钳制。

透明可预期的成本

拥抱开放钱包协议

多链登录基于 CAIP-122 开放规范，钱包发现由 Wallet Standard 和 EIP-6963 驱动，未来切换提供商或钱包服务时无需重构业务核心代码。

原生适配 EVM 与 Solana

开源且支持自主托管

全部前端组件与客户端套件完全开源；Quasar 后端同样开放了免费的 Community Edition，支持通过 Docker Compose 一键私有化交付。

Apache-2.0 协议

查看 TUWA 与 RainbowKit、Privy、thirdweb 等方案在六大维度上的严谨技术对比，条条皆有据可查。

查看深度对比与雷达图→
Oleksandr Tkach架构设计：Oleksandr Tkach创始人 & 首席架构师 · Aave Protocol V1–V3 与 Governance V3 前端缔造者查看作者主页 →阅读官方文档→

TUWA Ecosystem 生态路线图

从底层原生基语到去中心化多链基础设施的九大递进阶段

  1. 阶段 1已完成

    核心基语与多链认证

    Orbit Utils & SIWX
    • @tuwaio/orbit-core零依赖、跨框架的多链原生类型系统，提供 CAIP-2、CAIP-10 与 CAIP-19 辅助工具、连接器与地址处理、错误归一化及 SSR 安全的状态持久化。
    • @tuwaio/orbit-evm基于 viem 与 @wagmi/core 构建的高性能 EVM 客户端缓存、网络无缝切换、ENS 域名解析及 ERC-4337 智能账户（结合 Solady 与 Pimlico Bundler/Paymaster）。
    • @tuwaio/orbit-solana基于 @solana/kit 的 RPC 客户端缓存机制、Wallet Standard 钱包自动探测、网络集群与浏览器链接生成器，以及 SNS 域名与链上头像解析。
    • @tuwaio/siwx-core基于 CAIP-122 标准的签名消息构建、解析与校验器，支持严格的验证策略、会话匹配、单次 Nonce 防重放机制及 EVM 与 Solana 双生态类型化错误系统。
    • @tuwaio/siwx-evm面向 wagmi 与 viem 钱包的 CAIP-122 消息签名器，支持目标链上 EIP-191 (EOA)、EIP-1271 (智能合约钱包) 与 ERC-6492 (未部署智能账户) 全能验签。
    • @tuwaio/siwx-solana面向 Wallet Standard 与 @solana/kit 钱包的 CAIP-122 消息签名模块，借助原生 Web Crypto 实现高效可靠的 ed25519 签名验证。
    • @tuwaio/siwx-react提供 useSiwx 与 useSiwxSession 专属 React Hook，结合 Zustand 状态库驱动完整的 CAIP-122 登录认证流程，并无缝集成 Satellite Connect 辅助工具。
    • @tuwaio/siwx-server服务端 CAIP-122 登录验证组件，支持 EVM 与 Solana 双端校验、单次 Nonce 与持久化会话存储、安全 HttpOnly Cookie、Next.js App Router 接口以及用于第三方集成的 JWT/JWKS 端点。
  2. 阶段 2已完成

    无头状态与生命周期跟踪

    Satellite Connect & Pulsar
    • @tuwaio/satellite-core基于 Zustand 构建的轻量级、无 UI、跨框架 EVM 与 Solana 钱包连接状态库，具备统一链适配器契约、上次连接自动重连与原生 SIWX 状态映射。
    • @tuwaio/satellite-evm针对 wagmi 连接器的钱包适配器与连接监听器，支持智能合约账户快速探针及基于 @wagmi/core 与 viem 构建的配置辅助套件。
    • @tuwaio/satellite-solana基于 @solana/kit 开发的 Wallet Standard 钱包适配器、连接状态监听器与离链/链上消息签名核心。
    • @tuwaio/satellite-react提供 React 上下文 Provider、状态 Hook 以及 EVM 与 Solana 深度监听组件，确保钱包连接与链上状态及 SIWX 鉴权会话实时同步。
    • @tuwaio/pulsar-core轻量级、无 UI 的框架无关交易状态中心，支持 localStorage 持久化、统一链适配器规范、元数据严格校验及支持 EVM 与 Solana 交易追踪的云端同步钩子。
    • @tuwaio/pulsar-evm基于 viem 与 @wagmi/core 构建的 EVM 交易追踪适配器，全面覆盖标准交易、ERC-4337 用户操作 (UserOperation) 与 Safe 多签协同，内置加速与取消功能。
    • @tuwaio/pulsar-solana面向 Solana Wallet Standard 钱包的交易适配器、签名终局状态追踪器以及基于 @solana/kit 构建的交易签名与广播辅助模块。
    • @tuwaio/pulsar-react包含 useInitializeTransactionsPool（页面刷新后无缝恢复未决交易生命周期追踪）以及 useTxFinished（精准监听每笔已完成交易事件）的专属 React Hooks。
  3. 阶段 3已完成

    视觉界面与设计规范系统

    Nova UI Kit
    • @tuwaio/nova-coreNova 视觉体系核心，提供全套 --tuwa-* 设计令牌与主题变量、无障碍弹窗系统、多链网络与钱包矢量图标集，以及通用的 UI 辅助函数与 Hooks。
    • @tuwaio/nova-connect基于 @tuwaio/satellite-react 构建的高颜值 Web3 连接套件：包含连接按钮、钱包选择与账户详情弹窗、多链网络切换器及开箱即用的 SIWX 一键签名登录。
    • @tuwaio/nova-transactions基于 Pulsar 追踪内核的高级交易体验界面：包含动态交易气泡提示 (Toasts)、支持一键加速与取消的生命周期追踪弹窗，以及完整的历史交易面板。加速后的交易仍是同一笔操作，状态变化流畅自然。
    • stories.tuwa.io：交互式组件浏览器、主题指南与 API 规范
  4. 阶段 4已完成

    开发者效能与工程模板

    TUWA SDK & Cosmos Playground
    • @tuwaio/sdk面向 React 应用的一站式核心 SDK，通过模块化子路径聚合重导出 Orbit Utils、SIWX、Satellite Connect、Pulsar 与 Nova UI Kit 及其配套样式集。
    • @tuwaio/evm-sdk专属 EVM 增强扩展包：以清晰的子路径导出 Orbit Utils、SIWX、Satellite Connect、Pulsar 与 Nova Connect 的 EVM 链适配库。
    • @tuwaio/solana-sdk专属 Solana 增强扩展包：以清晰的子路径导出 Orbit Utils、SIWX、Satellite Connect、Pulsar 与 Nova Connect 的 Solana 链适配库。
    • @tuwaio/create-cosmos-playground基于 TUWA 技术栈极速脚手架：一键生成适配 EVM、Solana 或双链的 Next.js/Vite 起步模版工程，可自由选择是否开启 Quasar 云端同步。
    • docs.tuwa.io：深度指南、自动生成 API 字典以及针对 AI 编码 Agent 的规范说明
  5. 阶段 5已完成

    云端索引与异步同步引擎

    Quasar Cloud
    • @tuwaio/quasar-sdkQuasar 官方 API 客户端，兼容 Quasar Cloud 与私有化自部署节点（为 Pulsar 提供分布式交易同步与历史存储），附带将 Webhook 转发至 localhost 的 CLI。
    • 基于 NestJS 与 BullMQ 双阶段队列的分布式交易索引引擎
    • 分区化 PostgreSQL 16 时序存储集群与分布式 Redlock 互斥锁
    • 支持 SIWX 登录、WebAuthn Passkey 与多租户组织的开发者控制台
    • 防 SSRF 穿透的 Webhook 分发网关，配备 HMAC 签名、限流与 IP 白名单
    • Quasar Cloud 正式开启面向公众的免费公测
  6. 阶段 6已完成

    开源去中心化与社区版

    Quasar Community Edition
    • TuwaIO/quasar-community 在 GitHub 上按 Apache-2.0 协议完整开源
    • 提供最小化与高可用双配置的 Docker Compose 模版（Traefik, Cloudflare Tunnel）
    • 由 Payload CMS 驱动、具备邮箱/密码与 TOTP 2FA 双重防护的单租户管理面板
    • 经由 cosign、SBOM 与 Trivy 签名的 GHCR 官方镜像及自动化流水线
  7. 阶段 7进行中

    支付集成与云数据互通

    当前重心
    • 面向 Quasar Cloud 与社区版的专属 Payments 支付组件
    • 基于 viem 与 @solana/kit 的支付处理内核，结合 Pimlico 实现无感 Gas 垫付代付
    • 集成 GoPlus 实现毫秒级实时 AML、制裁名单与高危恶意地址拦截
    • 只增不可改的发票账本及全流程链上清算审计溯源机制
    • @tuwaio/nova-payments 极简收银台前端组件
    • Quasar Cloud 结束公测：步入生产可用期并开放商业计费包
    • Done: 支持将 Quasar Cloud 的应用配置与历史交易完整迁移导出至自建实例
  8. 阶段 8规划中

    WooCommerce 与 AI 智能体支付

    下一阶段
    • Quasar Payments 专属 WooCommerce 插件：自动生成发票、Webhook 订单回执与原路退款
    • @tuwaio/ai-payments：基于 x402 协议的自主 AI 智能体微计费方案
  9. 阶段 9规划中

    全链生态大扩张

    未来里程碑
    • Starknet 账户抽象与原生执行生命周期追踪适配器
    • 波场（Tron）网络交易状态监听与确认适配器
    • 比特币 Taproot 与 Ordinals 铭文交易解析器
    • TON 钱包协议与链上消息状态绑定库

闪电初始化 TUWA

运行单条命令，自选模板，即可快速获得包含钱包连接、身份认证与交易跟踪的完整 Next.js 或 Vite 生产工程。

终端安装命令
$ npx @tuwaio/create-cosmos-playground
想安装进现有工程中？
EVM:pnpm add @tuwaio/sdk @tuwaio/evm-sdk @wagmi/core viem
Solana:pnpm add @tuwaio/sdk @tuwaio/solana-sdk @solana/kit
1
运行命令
2
挑选模板
3
即刻开发！
Apache 2.0 与 MIT-0 双重保障极度宽松

TUWA 核心软件包基于 Apache 2.0 协议发布，而初始化模板均采用 MIT-0 协议，您享有 无需署名即可自由商业化复制代码的完全自由。

起步需要协助？请参阅 docs.tuwa.io 上的实战指南，或直接在 GitHub 上查看源码。

探索 GitHub

开源 • TypeScript • Apache-2.0

常见 问题解答

关于 TUWA 架构理念、自主可控性以及与传统托管式 WaaS 差异的核心速览。

TUWA 是面向 EVM 与 Solana 的开源（Apache-2.0）TypeScript 工具包，专注解决自托管 Web3 应用必经的基础设施难题：钱包连接（Satellite Connect）、基于 CAIP-122 的多链登录（SIWX）、刷新不丢失的交易状态追踪（Pulsar）、React UI 组件（Nova UI Kit）以及负责历史记录与 Webhook 的云端或自建后端（Quasar）。您既可通过 @tuwaio/sdk 一键装配，亦可按需分拆引用。
核心权威技术指南

了解为何交易生命周期状态易受损、CAIP-122 认证机制以及 TUWA 的全景对比。

交易状态痛点解析 →多链身份认证 (CAIP-122) →技术对比与雷达图 →