Вступ

TUWA SDK — найкоротший шлях до TUWA в React-застосунку. @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	Відстеження транзакцій на сервері, історія та вебхуки
4 — Інтерфейс користувача	Nova UI Kit	Дизайн-система та компоненти React
5 — Рівень інтеграції SDK	`@tuwaio/sdk`, `@tuwaio/evm-sdk`, `@tuwaio/solana-sdk`	Клієнтські пакети етапів 1, 2 і 4 в одному встановленні

Пакети Етапу 5 не додають власної логіки: кожен підшлях — це одна точка входу пакета TUWA, а його довідник розміщено на сайті відповідного проєкту. SDK визначає, які версії пакетів TUWA працюють разом, і дає кожному з них один шлях імпорту.

🧭 Принципи

Одне встановлення, перевірені версії: пакети TUWA — це залежності @tuwaio/sdk та його доповнень, тож кожен реліз SDK фіксує версії, які працюють разом. React, viem, @wagmi/core, @solana/kit і пакети Wallet Standard залишаються peer-залежностями, тож ваш застосунок тримає лише одну копію кожного з них.
Лише ті мережі, які ви використовуєте: @tuwaio/sdk не завантажує коду EVM чи Solana. EVM-застосунок додає @tuwaio/evm-sdk, Solana-застосунок — @tuwaio/solana-sdk, а застосунок з обома мережами — обидва пакети.
Ті самі пакети, та сама документація: підшляхи реекспортують пакети TUWA без змін, тож усе, що написано на сайтах Orbit, Pulsar, Satellite Connect, SIWX і Nova UI Kit, діє так, як написано; змінюється лише шлях імпорту.

🧩 Пакети

Пакет	Рівень	Що надає	Peer-залежності
`@tuwaio/sdk`	L8	Orbit, Pulsar, Satellite Connect, SIWX і Nova UI Kit через підшляхи; таблиці стилів Nova	`react`, `react-dom` (>=19.2.3)
`@tuwaio/evm-sdk`	L9	EVM-пакети Orbit, Satellite Connect, Pulsar, SIWX і Nova Connect	`@tuwaio/sdk` ≥ 0.6, `@wagmi/core` 3.x, `viem` 2.x
`@tuwaio/solana-sdk`	L9	Solana-пакети Orbit, Satellite Connect, Pulsar, SIWX і Nova Connect	`@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 також встановлюють peer-залежності Wallet Standard пакета @tuwaio/solana-sdk (@wallet-standard/app, base, features, react, ui і ui-registry); з Yarn додайте їх до команди.

📚 Що далі

Створіть повний застосунок — підключення гаманців, відстеження транзакцій, вхід через SIWX і синхронізацію з Quasar для EVM і Solana — за посібником «Full-Stack React застосунок» .
Почніть із готового застосунку: стартові шаблони .
Синхронізуйте транзакції з Quasar за посібником «Синхронізація транзакцій із Quasar» , а про застосунки, ключі, квоти та вебхуки читайте в документації Quasar .
Перегляньте компоненти в Storybook Nova UI Kit , а вихідний код — на GitHub .