Introduction
The TUWA SDK is the shortest way to use TUWA in a React app. @tuwaio/sdk re-exports the client packages of Orbit Utils, Pulsar, Satellite Connect, SIWX and Nova UI Kit under subpaths, and its add-ons @tuwaio/evm-sdk and @tuwaio/solana-sdk add the chains your app uses. Payments are a module of their own on top of it, @tuwaio/payments-sdk.
🏛️ Where the SDK Fits in TUWA
TUWA is built in stages. Each stage builds on the ones below it:
| Stage | Projects | Role |
|---|---|---|
| 1 — Core Auth & Primitives | SIWX , Orbit Utils | CAIP-122 authentication and multi-chain primitives |
| 2 — State & Connection | Satellite Connect , Pulsar | Wallet connection state and transaction tracking |
| 3 — Backend & Sync | Quasar (Cloud or self-hosted Community), with Quasar Client | Server-side transaction tracking, history and webhooks |
| 4 — User Interface | Nova UI Kit | React design system and components |
| 5 — SDK Integration | @tuwaio/sdk, @tuwaio/evm-sdk, @tuwaio/solana-sdk | The client packages of stages 1, 2 and 4 in one install |
The Stage 5 packages add no logic of their own: every subpath is one entry point of a TUWA package, and its reference is on the site of that project. The SDK decides which versions of the TUWA packages work together and gives them one import path each.
🧭 Principles
- One install, tested versions: the TUWA packages are dependencies of
@tuwaio/sdkand of its add-ons, so a release of the SDK pins versions that work together. React,viem,@wagmi/core,@solana/kitand the Wallet Standard packages stay peer dependencies, so your app keeps one copy of each. - Only the chains you use:
@tuwaio/sdkloads no EVM or Solana code. An EVM app adds@tuwaio/evm-sdk, a Solana app@tuwaio/solana-sdk, and an app with both adds both. - Same packages, same docs: the subpaths re-export the TUWA packages unchanged, so everything on the sites of Orbit, Pulsar, Satellite Connect, SIWX and Nova UI Kit applies as written; only the import path changes.
🧩 Packages
| Package | Layer | Provides | Peer dependencies |
|---|---|---|---|
@tuwaio/sdk | L8 | Orbit, Pulsar, Satellite Connect, SIWX and Nova UI Kit under subpaths; the Nova stylesheets | react, react-dom (>=19.2.3) |
@tuwaio/evm-sdk | L9 | The EVM packages of Orbit, Satellite Connect, Pulsar, SIWX and Nova Connect | @tuwaio/sdk ≥ 0.6, @wagmi/core 3.x, viem 2.x |
@tuwaio/solana-sdk | L9 | The Solana packages of Orbit, Satellite Connect, Pulsar, SIWX and Nova Connect | @tuwaio/sdk ≥ 0.6, @solana/kit ≥ 8.2, the Wallet Standard packages |
The pages of @tuwaio/sdk, @tuwaio/evm-sdk and @tuwaio/solana-sdk list their subpaths with a link to the reference of each re-exported package.
💾 Installation
# 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/kitpnpm (8 and later), npm (7 and later) and Bun also install the Wallet Standard peers of @tuwaio/solana-sdk (@wallet-standard/app, base, features, react, ui and ui-registry); with Yarn, add them to the command.
📚 Next Steps
- Build the complete app — wallet connection, transaction tracking, SIWX sign-in and Quasar sync, for EVM and Solana — with the Full-Stack React guide .
- Start from a ready-made app with the starter templates .
- Sync transactions to Quasar with the Quasar transaction sync guide , and read about apps, keys, quotas and webhooks in the Quasar docs .
- Browse the components in the Nova UI Kit Storybook , and read the source on GitHub .