@tuwaio/sdk 0.1.14 → 0.2.0

package/README.md

@@ -1,322 +1,125 @@
 # @tuwaio/sdk
 
 [![NPM Version](https://img.shields.io/npm/v/@tuwaio/sdk.svg)](https://www.npmjs.com/package/@tuwaio/sdk)
-[![License](https://img.shields.io/npm/l/@tuwaio/sdk.svg)](./LICENSE)
+[![License](https://img.shields.io/npm/l/@tuwaio/sdk.svg)](https://github.com/TuwaIO/sdk/blob/main/packages/sdk/LICENSE)
 
-The **Layer 8 (L8)** Core Umbrella SDK for the TUWA Ecosystem. It provides a unified entry point bundling `Orbit`, `Pulsar`, `Satellite`, and `Nova UI` core layers into modular subpath entrypoints, minimizing boilerplate while ensuring maximum type safety.
+`@tuwaio/sdk` is the Layer 8 (L8) package of the **TUWA SDK**: one package for React apps that re-exports the client packages of the TUWA projects under subpaths — Orbit Utils, Pulsar (transaction tracking), Satellite Connect (wallet connection), SIWX (sign-in with a wallet) and Nova UI Kit (connect and transaction components) — with the Nova stylesheets. Chain support comes from its two add-ons, [`@tuwaio/evm-sdk`](https://sdk.docs.tuwa.io/packages/evm-sdk) and [`@tuwaio/solana-sdk`](https://sdk.docs.tuwa.io/packages/solana-sdk); none of the subpaths below loads EVM or Solana code.
 
 ---
 
-## 🏛️ What is `@tuwaio/sdk`?
+## 🏛️ Core Capabilities
 
-`@tuwaio/sdk` is **Layer 8 (L8)** of the TUWA ecosystem architecture — the all-in-one UI and Logic foundation. Instead of manually resolving versions and importing from a dozen decoupled packages (`@tuwaio/pulsar-core`, `@tuwaio/nova-connect`, etc.), you install this single SDK and access clean, modular subpath exports.
-
-It abstracts away complex dependency management (automatically handling `zustand`, `framer-motion`, `radix-ui`, etc.) and lets you focus on building your application.
-
----
-
-## ✨ Key Features
-
-- **📦 Zero-Config Integration**: Combines Orbit (adapters), Pulsar (tracking), Satellite (connections), Nova (UI), and SIWX (CAIP-122 Auth) out of the box.
-- **⚡ Modular Subpath Imports**: Clean exports for each domain (e.g. `@tuwaio/sdk/pulsar`, `@tuwaio/sdk/satellite`, `@tuwaio/sdk/siwx`, `@tuwaio/sdk/nova-connect`).
-- **🔐 Headless SIWX (CAIP-122) Auth**: Off-chain authentication across EVM and Solana with session management (`@tuwaio/sdk/siwx` and `@tuwaio/sdk/siwx/server`).
-- **🎨 Includes Nova UI & Styles**: Access beautifully styled wallet connection modals and transaction toasts with simple CSS imports (`@import '@tuwaio/sdk/styles/all.css'`).
-- **🛡️ Strict Singleton Contexts**: Uses intelligent peer dependencies to ensure you never run into multiple instances of React or Web3 singletons.
-
-> [!WARNING]
-> **SIWX Migration Notice**: Legacy SIWE authorization flows in Satellite are **deprecated**. Use `@tuwaio/sdk/siwx` and `@tuwaio/sdk/siwx/server` for multi-chain CAIP-122 authentication.
+- **One version to install:** the TUWA packages and the libraries they share (`zustand`, `immer`, `framer-motion`, Radix UI, `react-toastify`, `dayjs`) are dependencies of `@tuwaio/sdk`, so a release of the SDK pins a set of TUWA versions that work together. `react` and `react-dom` are peer dependencies: the app keeps one copy of React.
+- **Subpaths:** every subpath re-exports one entry point of a TUWA package, unchanged (see [Subpaths](#-subpaths)). Its reference is on the site of that package.
+- **Stylesheets:** `@tuwaio/sdk/styles/*.css` are copies of the compiled stylesheets of Nova Core, Nova Connect and Nova Transactions. The app does not need Tailwind CSS.
 
 ---
 
 ## 💾 Installation
 
-To install the core SDK, simply run:
-
 ```bash
 pnpm add @tuwaio/sdk react react-dom
 ```
 
-_Note: For network-specific capabilities, you must also install either `@tuwaio/evm-sdk` or `@tuwaio/solana-sdk`._
+Then add the chains of your app:
 
----
+```bash
+# EVM
+pnpm add @tuwaio/evm-sdk @wagmi/core viem
 
-## 🎨 Styles Configuration
+# Solana
+pnpm add @tuwaio/solana-sdk @solana/kit @wallet-standard/react @wallet-standard/app @wallet-standard/base @wallet-standard/features @wallet-standard/ui @wallet-standard/ui-registry
+```
+
+Do not install the re-exported TUWA packages separately at other versions: two copies of a package with a store or a React context, such as `@tuwaio/satellite-react` or `@tuwaio/nova-connect`, do not share their state or their types.
 
-Import the bundled CSS styles into your global CSS file (e.g., `globals.css`):
+Import the stylesheets once, for example in the global CSS file of the app:
 
 ```css
-/* Import all Nova UI styles at once */
 @import '@tuwaio/sdk/styles/all.css';
-
-/* Optional: if your dApp uses Tailwind CSS v4 */
-@import 'tailwindcss';
-
-/* Or import individually if needed */
-/* @import '@tuwaio/sdk/styles/nova-core.css'; */
-/* @import '@tuwaio/sdk/styles/nova-connect.css'; */
-/* @import '@tuwaio/sdk/styles/nova-transactions.css'; */
 ```
 
-> **Note**: Nova UI components include fully compiled, self-contained styles inside `@tuwaio/sdk/styles/all.css`. Tailwind CSS is **optional** — we use Tailwind utility classes in our documentation layout examples for convenience, but you can use any styling solution (CSS Modules, Styled Components, Vanilla CSS) for your dApp layout. If you do use Tailwind CSS v4 in your project, include `@import 'tailwindcss';` in your global CSS file.
+`all.css` joins `nova-core.css` (the `--tuwa-*` theme variables), `nova-connect.css` and `nova-transactions.css`; import them one by one to leave one out.
 
 ---
 
-## 🚀 Quick Start (Multi-Chain Integration)
-
-The true power of the TUWA Umbrella SDKs is composability. Below is a complete production-grade architectural guide showing how to compose **EVM**, **Solana**, headless transaction state, and Nova UI layers effortlessly.
-
-> **Note:** This example uses standard client-side state. If you are building a Quasar-powered app (with cloud syncing, history, and pagination), please refer to the `@tuwaio/quasar-sdk` documentation.
-
-### 1. Define Your Transaction Types (`types.ts`)
-
-First, define the strict union of all possible transactions your app supports.
-
-```ts
-// src/types.ts
-import type { Transaction } from '@tuwaio/sdk/pulsar';
-
-export enum AppTxType {
-  SWAP = 'SWAP',
-}
-
-export type SwapTx = Transaction & {
-  type: AppTxType.SWAP;
-  payload: { tokenIn: string; tokenOut: string; amount: number };
-};
-
-export type TransactionUnion = SwapTx;
-```
-
-### 2. Multi-Chain Tracking Store (`usePulsarStore.ts`)
-
-Configure the headless tracking store with both EVM and Solana adapters.
-
-```ts
-// src/hooks/usePulsarStore.ts
-'use client';
-
-import { createPulsarStore, createBoundedUseStore } from '@tuwaio/sdk/pulsar';
-import { pulsarEvmAdapter } from '@tuwaio/evm-sdk/pulsar';
-import { pulsarSolanaAdapter } from '@tuwaio/solana-sdk/pulsar';
-
-import { wagmiConfig, appEVMChains, solanaRPCUrls } from '@/configs/appConfig';
-import { TransactionUnion } from '@/types';
-
-// Create the headless tracking store with BOTH EVM and Solana adapters
-const initialStore = createPulsarStore<TransactionUnion>({
-  name: 'tuwa-transactions-multi',
-  adapter: [pulsarEvmAdapter(wagmiConfig, appEVMChains), pulsarSolanaAdapter({ rpcUrls: solanaRPCUrls })],
-});
-
-export const usePulsarStore = createBoundedUseStore(initialStore);
-```
-
-### 3. Nova Transactions Provider (`NovaTransactionsProvider.tsx`)
+## 🧭 Subpaths
+
+| Import path                               | Re-exports                                                                                                 | Reference                                                                                                                                                  |
+| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@tuwaio/sdk/orbit`                       | `@tuwaio/orbit-core`                                                                                       | [orbit.docs.tuwa.io](https://orbit.docs.tuwa.io/packages/orbit-core)                                                                                       |
+| `@tuwaio/sdk/pulsar`                      | `@tuwaio/pulsar-core` and `@tuwaio/pulsar-react`                                                           | [pulsar-core](https://pulsar.docs.tuwa.io/packages/pulsar-core), [pulsar-react](https://pulsar.docs.tuwa.io/packages/pulsar-react)                         |
+| `@tuwaio/sdk/satellite`                   | `@tuwaio/satellite-core` and `@tuwaio/satellite-react` (its `Connector` type as `SatelliteReactConnector`) | [satellite-core](https://satellite.docs.tuwa.io/packages/satellite-core), [satellite-react](https://satellite.docs.tuwa.io/packages/satellite-react/react) |
+| `@tuwaio/sdk/siwx`                        | `@tuwaio/siwx-react`                                                                                       | [siwx.docs.tuwa.io](https://siwx.docs.tuwa.io/packages/siwx-react)                                                                                         |
+| `@tuwaio/sdk/siwx/core`                   | `@tuwaio/siwx-core`                                                                                        | [siwx.docs.tuwa.io](https://siwx.docs.tuwa.io/packages/siwx-core)                                                                                          |
+| `@tuwaio/sdk/siwx/server`                 | `@tuwaio/siwx-server`                                                                                      | [siwx.docs.tuwa.io](https://siwx.docs.tuwa.io/packages/siwx-server/server)                                                                                 |
+| `@tuwaio/sdk/siwx/server-next`            | `@tuwaio/siwx-server/next`                                                                                 | [siwx.docs.tuwa.io](https://siwx.docs.tuwa.io/packages/siwx-server/next)                                                                                   |
+| `@tuwaio/sdk/nova-core`                   | `@tuwaio/nova-core`                                                                                        | [Storybook](https://stories.tuwa.io/?path=/docs/packages-nova-core-overview--docs)                                                                         |
+| `@tuwaio/sdk/nova-connect`                | `@tuwaio/nova-connect`                                                                                     | [Storybook](https://stories.tuwa.io/?path=/docs/packages-nova-connect-connect-overview--docs)                                                              |
+| `@tuwaio/sdk/nova-connect/components`     | `@tuwaio/nova-connect/components`                                                                          | [Storybook](https://stories.tuwa.io/?path=/docs/packages-nova-connect-components-overview--docs)                                                           |
+| `@tuwaio/sdk/nova-connect/hooks`          | `@tuwaio/nova-connect/hooks`                                                                               | [Storybook](https://stories.tuwa.io/?path=/docs/packages-nova-connect-hooks-overview--docs)                                                                |
+| `@tuwaio/sdk/nova-connect/i18n`           | `@tuwaio/nova-connect/i18n`                                                                                | [Storybook](https://stories.tuwa.io/?path=/docs/packages-nova-connect-i18n-overview--docs)                                                                 |
+| `@tuwaio/sdk/nova-connect/satellite`      | `@tuwaio/nova-connect/satellite`                                                                           | [Storybook](https://stories.tuwa.io/?path=/docs/packages-nova-connect-satellite-overview--docs)                                                            |
+| `@tuwaio/sdk/nova-transactions`           | `@tuwaio/nova-transactions`                                                                                | [Storybook](https://stories.tuwa.io/?path=/docs/packages-nova-transactions-transactions-overview--docs)                                                    |
+| `@tuwaio/sdk/nova-transactions/providers` | `@tuwaio/nova-transactions/providers`                                                                      | [Storybook](https://stories.tuwa.io/?path=/docs/packages-nova-transactions-providers-overview--docs)                                                       |
+| `@tuwaio/sdk/styles/*.css`                | `dist/index.css` of the three Nova packages                                                                | `all.css`, `nova-core.css`, `nova-connect.css`, `nova-transactions.css`                                                                                    |
+
+`@tuwaio/sdk/nova-connect/evm` and `@tuwaio/sdk/nova-connect/solana` re-export the chain entry points of Nova Connect for the add-ons; import them as `@tuwaio/evm-sdk/nova-connect` and `@tuwaio/solana-sdk/nova-connect`. They need the chain packages that the add-ons install, and going through `@tuwaio/sdk` makes their chain registration and types apply to the same copy of Nova Connect and Satellite React as the other subpaths.
 
-Binds the React UI elements to the headless transaction state.
-
-```tsx
-// src/providers/NovaTransactionsProvider.tsx
-'use client';
-
-import { useSatelliteConnectStore } from '@tuwaio/sdk/satellite';
-import { useInitializeTransactionsPool } from '@tuwaio/sdk/pulsar';
-import { getAdapterFromConnectorType } from '@tuwaio/sdk/orbit';
-import { NovaTransactionsProvider as NTP } from '@tuwaio/sdk/nova-transactions/providers';
-import { usePulsarStore } from '@/hooks/usePulsarStore';
-
-export function NovaTransactionsProvider() {
-  const initialTx = usePulsarStore((s) => s.initialTx);
-  const closeTxTrackedModal = usePulsarStore((s) => s.closeTxTrackedModal);
-  const executeTxAction = usePulsarStore((s) => s.executeTxAction);
-  const initializeTransactionsPool = usePulsarStore((s) => s.initializeTransactionsPool);
-  const getAdapter = usePulsarStore((s) => s.getAdapter);
-  const transactionsPool = usePulsarStore((s) => s.transactionsPool);
-
-  const activeConnection = useSatelliteConnectStore((s) => s.activeConnection);
-
-  useInitializeTransactionsPool({ initializeTransactionsPool });
-
-  return (
-    <NTP
-      transactionsPool={transactionsPool}
-      initialTx={initialTx}
-      closeTxTrackedModal={closeTxTrackedModal}
-      executeTxAction={executeTxAction}
-      connectedWalletAddress={activeConnection?.isConnected ? activeConnection.address : undefined}
-      connectedAdapterType={getAdapterFromConnectorType(activeConnection?.connectorType ?? 'evm:')}
-      adapter={getAdapter()}
-    />
-  );
-}
-```
+---
 
-### 4. App Providers Layout (`AppProviders.tsx`)
+## 🚀 Usage
 
-Assembling the complete multi-chain ecosystem layout. Notice how both `EVMConnectorsWatcher` and `SolanaConnectorsWatcher` operate simultaneously in the background.
+The providers of an EVM app with a connect button:
 
 ```tsx
-// src/providers/AppProviders.tsx
 'use client';
 
-import { SatelliteConnectProvider } from '@tuwaio/sdk/satellite';
-import { NovaConnectProvider } from '@tuwaio/sdk/nova-connect';
-import { satelliteEVMAdapter } from '@tuwaio/evm-sdk/satellite';
 import { EVMConnectorsWatcher } from '@tuwaio/evm-sdk/nova-connect';
-import { satelliteSolanaAdapter } from '@tuwaio/solana-sdk/satellite';
-import { SolanaConnectorsWatcher } from '@tuwaio/solana-sdk/nova-connect';
-import { useSiwxSession } from '@tuwaio/sdk/siwx';
-
-import { appEVMChains, solanaRPCUrls, wagmiConfig } from '@/configs/appConfig';
-import { usePulsarStore } from '@/hooks/usePulsarStore';
-import { NovaTransactionsProvider } from '@/providers/NovaTransactionsProvider';
-
-export function AppProviders({ children }: { children: React.ReactNode }) {
-  const getAdapter = usePulsarStore((state) => state.getAdapter);
-  const transactionsPool = usePulsarStore((state) => state.transactionsPool);
+import { satelliteEVMAdapter } from '@tuwaio/evm-sdk/satellite';
+import { NovaConnectProvider } from '@tuwaio/sdk/nova-connect';
+import { ConnectButton } from '@tuwaio/sdk/nova-connect/components';
+import { SatelliteConnectProvider } from '@tuwaio/sdk/satellite';
+import { createConfig, http, injected } from '@wagmi/core';
+import type { ReactNode } from 'react';
+import { mainnet } from 'viem/chains';
 
-  const siwxSession = useSiwxSession();
+const appChains = [mainnet] as const;
+const wagmiConfig = createConfig({ chains: appChains, connectors: [injected()], transports: { [mainnet.id]: http() } });
+const adapter = satelliteEVMAdapter(wagmiConfig, appChains);
 
+export function Providers({ children }: { children: ReactNode }) {
   return (
-    <SatelliteConnectProvider
-      adapter={[satelliteEVMAdapter(wagmiConfig, appEVMChains), satelliteSolanaAdapter({ rpcUrls: solanaRPCUrls })]}
-      autoConnect={true}
-    >
-      <EVMConnectorsWatcher wagmiConfig={wagmiConfig} siwx={siwxSession} />
-      <SolanaConnectorsWatcher siwx={siwxSession} />
-
-      <NovaTransactionsProvider />
-
-      <NovaConnectProvider
-        appChains={appEVMChains}
-        solanaRPCUrls={solanaRPCUrls}
-        transactionPool={transactionsPool}
-        pulsarAdapter={getAdapter()}
-        withImpersonated
-        withBalance
-        withChain
-        siwx={{
-          verifier: async (payload) => {
-            const res = await fetch('/api/siwx/verify', {
-              method: 'POST',
-              headers: { 'Content-Type': 'application/json' },
-              body: JSON.stringify(payload),
-            });
-            return res.ok ? res.json() : null;
-          },
-          destroyer: async () => {
-            await fetch('/api/siwx/logout', { method: 'POST' });
-          },
-        }}
-      >
-        {children}
-      </NovaConnectProvider>
+    <SatelliteConnectProvider adapter={adapter} autoConnect>
+      <EVMConnectorsWatcher wagmiConfig={wagmiConfig} />
+      <NovaConnectProvider appChains={appChains}>{children}</NovaConnectProvider>
     </SatelliteConnectProvider>
   );
 }
-```
-
-### 5. Creating a Multi-Chain Transaction (Usage)
-
-Now you can safely execute strictly-typed, cross-chain transactions anywhere in your app. The store automatically routes the transaction to the correct adapter.
-
-```tsx
-// src/components/SwapButton.tsx
-'use client';
 
-import { getAdapterFromConnectorType, OrbitAdapter } from '@tuwaio/sdk/orbit';
-import { useSatelliteConnectStore } from '@tuwaio/sdk/satellite';
-import { TxActionButton } from '@tuwaio/sdk/nova-transactions';
-import { usePulsarStore } from '@/hooks/usePulsarStore';
-import { AppTxType } from '@/types';
-
-export function SwapButton() {
-  const executeTxAction = usePulsarStore((s) => s.executeTxAction);
-  const getLastTxKey = usePulsarStore((s) => s.getLastTxKey);
-  const transactionsPool = usePulsarStore((s) => s.transactionsPool);
-  const activeConnection = useSatelliteConnectStore((s) => s.activeConnection);
-
-  const handleSwapAction = async () => {
-    const adapterType = activeConnection?.connectorType
-      ? getAdapterFromConnectorType(activeConnection.connectorType)
-      : OrbitAdapter.EVM;
-    const isEvm = adapterType === OrbitAdapter.EVM;
-
-    await executeTxAction({
-      actionFunction: async () => {
-        // Execute smart contract call (e.g. writeContract via Viem/Wagmi or signAndSendSolanaTx via @solana/kit)
-        /* return await swapTokensContractCall(); */
-      },
-      onSuccess: (tx) => {
-        console.log('Swap transaction completed successfully:', tx);
-      },
-      params: {
-        type: AppTxType.SWAP,
-        adapter: adapterType,
-        desiredChainID: isEvm ? 1 : 'mainnet',
-        rpcUrl: isEvm ? undefined : activeConnection?.rpcURL,
-        title: ['Swapping Tokens', 'Tokens Swapped', 'Error During Swap', 'Swap Transaction Replaced'],
-        description: [
-          `Swapping 100 USDC for ${isEvm ? 'ETH' : 'SOL'}...`,
-          `Success! Swapped 100 USDC for ${isEvm ? 'ETH' : 'SOL'}.`,
-          'Something went wrong during token swap.',
-          'Transaction was replaced in wallet.',
-        ],
-        payload: {
-          tokenIn: 'USDC',
-          tokenOut: isEvm ? 'ETH' : 'SOL',
-          amount: 100,
-        },
-        withTrackedModal: true,
-        requiredConfirmations: isEvm ? 3 : undefined,
-      },
-    });
-  };
-
-  return (
-    <TxActionButton
-      action={handleSwapAction}
-      getLastTxKey={getLastTxKey}
-      transactionsPool={transactionsPool}
-      walletAddress={activeConnection?.address}
-    >
-      Cross-Chain Swap
-    </TxActionButton>
-  );
+export function Header() {
+  return <ConnectButton />;
 }
 ```
 
+The full setup — EVM and Solana, transaction tracking with Pulsar and Nova Transactions, SIWX sign-in and Quasar sync — is the **[Full-Stack React guide](https://docs.tuwa.io/guides/full-stack-react)**. Ready-made apps are in the [starter templates](https://docs.tuwa.io/guides/starter-templates).
+
 ---
 
-## 📦 Available Subpath Exports
-
-This package provides direct subpath entry points for clean, tree-shakeable imports:
-
-- **`@tuwaio/sdk/pulsar`** — State machine & tracking stores (`createPulsarStore`, `createTxInMemoryStore`, `useInitializeTransactionsPool`).
-- **`@tuwaio/sdk/satellite`** — Wallet state & react hooks (`useSatelliteConnectStore`, `SatelliteConnectProvider`, `useAccount`).
-- **`@tuwaio/sdk/siwx`** — Client-side SIWX (CAIP-122) auto-authentication hooks.
-- **`@tuwaio/sdk/siwx/core`** — SIWX core types, error handling, and message building logic.
-- **`@tuwaio/sdk/siwx/server`** — Server-side SIWX session handlers.
-- **`@tuwaio/sdk/nova-connect`** — Connect UI main entry (`ConnectButton`, `NovaConnectProvider`).
-- **`@tuwaio/sdk/nova-connect/components`** — Standalone UI components (`ConnectButton`, Modals, Customization interfaces).
-- **`@tuwaio/sdk/nova-connect/hooks`** — Helper hooks (`useGetWalletNameAndAvatar`, `useWalletChainsList`).
-- **`@tuwaio/sdk/nova-connect/i18n`** — Internationalization and label providers (`NovaConnectLabelsProvider`).
-- **`@tuwaio/sdk/nova-transactions`** — Transaction UI components (`TxActionButton`).
-- **`@tuwaio/sdk/nova-transactions/providers`** — Transaction UI provider (`NovaTransactionsProvider`).
-- **`@tuwaio/sdk/nova-core`** — UI Core variables, base components, and utilities.
-- **`@tuwaio/sdk/orbit`** — Core multi-chain types and adapters (`OrbitAdapter`, `getAdapterFromConnectorType`).
-- **`@tuwaio/sdk/styles/all.css`** — Complete bundled stylesheet for Nova UI components.
+## 🗄️ Browser Storage
 
----
+`@tuwaio/sdk` saves nothing itself. The re-exported packages use these `localStorage` keys; each page lists when they are written:
 
-## 🤝 Contributing & Support
+- `orbit-core:lastConnectedConnector`, `orbit-core:recentlyConnectedConnectorsListHelpers` and `satellite-connect:impersonatedAddress`: the last connection, the recent wallets and the impersonated address ([`@tuwaio/satellite-core`](https://satellite.docs.tuwa.io/packages/satellite-core), read by Nova Connect);
+- the `name` passed to `createPulsarStore`: the tracked transactions ([`@tuwaio/pulsar-core`](https://pulsar.docs.tuwa.io/packages/pulsar-core));
+- `siwx-react:session`: the SIWX session shown in the UI ([`@tuwaio/siwx-react`](https://siwx.docs.tuwa.io/packages/siwx-react)).
 
-Contributions are welcome! Please read our main **[Contribution Guidelines](https://github.com/TuwaIO/workflows/blob/main/CONTRIBUTING.md)**.
+## 🌐 External Services
 
-If you find this library useful, please consider supporting its development. Every contribution helps!
+`@tuwaio/sdk` sends no requests itself. Of the packages it re-exports, only `@tuwaio/nova-core` does: it loads network and wallet icons that `@web3icons/common` does not have from `raw.githubusercontent.com` ([details](https://stories.tuwa.io/?path=/docs/packages-nova-core-overview--docs)). The chain requests (RPC endpoints, ENS, SNS, Pimlico, Safe Transaction Service) come from the chain packages of the add-ons: see [`@tuwaio/evm-sdk`](https://sdk.docs.tuwa.io/packages/evm-sdk) and [`@tuwaio/solana-sdk`](https://sdk.docs.tuwa.io/packages/solana-sdk). The SIWX endpoints are those of your server.
 
-[**➡️ View Support Options**](https://github.com/TuwaIO/workflows/blob/main/Donation.md)
+---
 
 ## 📄 License
 
-This project is licensed under the **Apache-2.0 License** - see the [LICENSE](./LICENSE) file for details.
+Licensed under the **Apache-2.0 License**. See the [LICENSE](https://github.com/TuwaIO/sdk/blob/main/packages/sdk/LICENSE) file for details.

package/dist/nova-connect-components.d.cts

@@ -1,7 +1,9 @@
 export * from '@tuwaio/nova-connect/components';
+import '@tuwaio/nova-connect/evm';
 import '@tuwaio/nova-connect/hooks';
 import '@tuwaio/nova-connect/i18n';
 import '@tuwaio/nova-connect/satellite';
+import '@tuwaio/nova-connect/solana';
 import '@tuwaio/nova-connect';
 import '@tuwaio/nova-core';
 import '@tuwaio/nova-transactions/providers';

package/dist/nova-connect-components.d.ts

@@ -1,7 +1,9 @@
 export * from '@tuwaio/nova-connect/components';
+import '@tuwaio/nova-connect/evm';
 import '@tuwaio/nova-connect/hooks';
 import '@tuwaio/nova-connect/i18n';
 import '@tuwaio/nova-connect/satellite';
+import '@tuwaio/nova-connect/solana';
 import '@tuwaio/nova-connect';
 import '@tuwaio/nova-core';
 import '@tuwaio/nova-transactions/providers';

package/dist/nova-connect-evm.cjs

@@ -0,0 +1 @@
+'use strict';var evm=require('@tuwaio/nova-connect/evm');Object.keys(evm).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return evm[k]}})});

package/dist/nova-connect-evm.d.cts

@@ -0,0 +1 @@
+export * from '@tuwaio/nova-connect/evm';

package/dist/nova-connect-evm.d.ts

@@ -0,0 +1 @@
+export * from '@tuwaio/nova-connect/evm';

package/dist/nova-connect-evm.js

@@ -0,0 +1 @@
+export*from'@tuwaio/nova-connect/evm';

package/dist/nova-connect-solana.cjs

@@ -0,0 +1 @@
+'use strict';var solana=require('@tuwaio/nova-connect/solana');Object.keys(solana).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return solana[k]}})});

package/dist/nova-connect-solana.d.cts

@@ -0,0 +1 @@
+export * from '@tuwaio/nova-connect/solana';

package/dist/nova-connect-solana.d.ts

@@ -0,0 +1 @@
+export * from '@tuwaio/nova-connect/solana';

package/dist/nova-connect-solana.js

@@ -0,0 +1 @@
+export*from'@tuwaio/nova-connect/solana';

package/dist/satellite.d.cts

@@ -1,2 +1,2 @@
 export * from '@tuwaio/satellite-core';
-export { AllConnections, AllConnectors, Connection, SatelliteConnectProvider, SatelliteConnectProviderProps, Connector as SatelliteReactConnector, SatelliteStoreContext, useInitializeAutoConnect, useSatelliteConnectStore } from '@tuwaio/satellite-react';
+export { AllConnections, AllConnectors, Connection, InitializeAutoConnectProps, SatelliteConnectProvider, SatelliteConnectProviderProps, SatelliteContextType, Connector as SatelliteReactConnector, SatelliteStoreContext, useInitializeAutoConnect, useSatelliteConnectStore } from '@tuwaio/satellite-react';

package/dist/satellite.d.ts

@@ -1,2 +1,2 @@
 export * from '@tuwaio/satellite-core';
-export { AllConnections, AllConnectors, Connection, SatelliteConnectProvider, SatelliteConnectProviderProps, Connector as SatelliteReactConnector, SatelliteStoreContext, useInitializeAutoConnect, useSatelliteConnectStore } from '@tuwaio/satellite-react';
+export { AllConnections, AllConnectors, Connection, InitializeAutoConnectProps, SatelliteConnectProvider, SatelliteConnectProviderProps, SatelliteContextType, Connector as SatelliteReactConnector, SatelliteStoreContext, useInitializeAutoConnect, useSatelliteConnectStore } from '@tuwaio/satellite-react';

package/dist/styles/all.css

@@ -723,9 +723,6 @@ html {
   .novatx\:max-w-\[55\%\] {
     max-width: 55%;
   }
-  .novatx\:max-w-\[200px\] {
-    max-width: 200px;
-  }
   .novatx\:min-w-0 {
     min-width: 0px;
   }
@@ -1666,7 +1663,6 @@ html {
     --novacon-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New',
     monospace;
     --novacon-color-red-500: oklch(63.7% 0.237 25.331);
-    --novacon-color-red-600: oklch(57.7% 0.245 27.325);
     --novacon-color-green-600: oklch(62.7% 0.194 149.214);
     --novacon-color-blue-500: oklch(62.3% 0.214 259.815);
     --novacon-color-white: #fff;
@@ -2119,9 +2115,6 @@ html {
     --tw-pan-x: pan-x;
     touch-action: var(--tw-pan-x,) var(--tw-pan-y,) var(--tw-pinch-zoom,);
   }
-  .novacon\:scrollbar-thin {
-    scrollbar-width: thin;
-  }
   .novacon\:flex-col {
     flex-direction: column;
   }
@@ -2313,19 +2306,12 @@ html {
   .novacon\:bg-\[var\(--tuwa-warning-bg\)\] {
     background-color: var(--tuwa-warning-bg);
   }
-  .novacon\:bg-blue-500 {
-    background-color: var(--novacon-color-blue-500);
-  }
   .novacon\:bg-red-500 {
     background-color: var(--novacon-color-red-500);
   }
   .novacon\:bg-transparent {
     background-color: transparent;
   }
-  .novacon\:bg-gradient-to-b {
-    --tw-gradient-position: to bottom in oklab;
-    background-image: linear-gradient(var(--tw-gradient-stops));
-  }
   .novacon\:bg-gradient-to-r {
     --tw-gradient-position: to right in oklab;
     background-image: linear-gradient(var(--tw-gradient-stops));
@@ -2551,14 +2537,6 @@ html {
   .novacon\:opacity-100 {
     opacity: 100%;
   }
-  .novacon\:shadow-2xl {
-    --tw-shadow: 0 25px 50px -12px var(--tw-shadow-color, rgb(0 0 0 / 0.25));
-    box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
-  }
-  .novacon\:shadow-lg {
-    --tw-shadow: 0 10px 15px -3px var(--tw-shadow-color, rgb(0 0 0 / 0.1)), 0 4px 6px -4px var(--tw-shadow-color, rgb(0 0 0 / 0.1));
-    box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
-  }
   .novacon\:shadow-sm {
     --tw-shadow: 0 1px 3px 0 var(--tw-shadow-color, rgb(0 0 0 / 0.1)), 0 1px 2px -1px var(--tw-shadow-color, rgb(0 0 0 / 0.1));
     box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
@@ -2757,9 +2735,6 @@ html {
     .novacon\:hover\:bg-\[var\(--tuwa-text-accent\)\]:hover {
       background-color: var(--tuwa-text-accent);
     }
-    .novacon\:hover\:bg-red-600:hover {
-      background-color: var(--novacon-color-red-600);
-    }
     .novacon\:hover\:text-\[var\(--tuwa-error-text\)\]:hover {
       color: var(--tuwa-error-text);
     }

package/dist/styles/nova-connect.css

@@ -6,7 +6,6 @@
     --novacon-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New',
     monospace;
     --novacon-color-red-500: oklch(63.7% 0.237 25.331);
-    --novacon-color-red-600: oklch(57.7% 0.245 27.325);
     --novacon-color-green-600: oklch(62.7% 0.194 149.214);
     --novacon-color-blue-500: oklch(62.3% 0.214 259.815);
     --novacon-color-white: #fff;
@@ -459,9 +458,6 @@
     --tw-pan-x: pan-x;
     touch-action: var(--tw-pan-x,) var(--tw-pan-y,) var(--tw-pinch-zoom,);
   }
-  .novacon\:scrollbar-thin {
-    scrollbar-width: thin;
-  }
   .novacon\:flex-col {
     flex-direction: column;
   }
@@ -653,19 +649,12 @@
   .novacon\:bg-\[var\(--tuwa-warning-bg\)\] {
     background-color: var(--tuwa-warning-bg);
   }
-  .novacon\:bg-blue-500 {
-    background-color: var(--novacon-color-blue-500);
-  }
   .novacon\:bg-red-500 {
     background-color: var(--novacon-color-red-500);
   }
   .novacon\:bg-transparent {
     background-color: transparent;
   }
-  .novacon\:bg-gradient-to-b {
-    --tw-gradient-position: to bottom in oklab;
-    background-image: linear-gradient(var(--tw-gradient-stops));
-  }
   .novacon\:bg-gradient-to-r {
     --tw-gradient-position: to right in oklab;
     background-image: linear-gradient(var(--tw-gradient-stops));
@@ -891,14 +880,6 @@
   .novacon\:opacity-100 {
     opacity: 100%;
   }
-  .novacon\:shadow-2xl {
-    --tw-shadow: 0 25px 50px -12px var(--tw-shadow-color, rgb(0 0 0 / 0.25));
-    box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
-  }
-  .novacon\:shadow-lg {
-    --tw-shadow: 0 10px 15px -3px var(--tw-shadow-color, rgb(0 0 0 / 0.1)), 0 4px 6px -4px var(--tw-shadow-color, rgb(0 0 0 / 0.1));
-    box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
-  }
   .novacon\:shadow-sm {
     --tw-shadow: 0 1px 3px 0 var(--tw-shadow-color, rgb(0 0 0 / 0.1)), 0 1px 2px -1px var(--tw-shadow-color, rgb(0 0 0 / 0.1));
     box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
@@ -1097,9 +1078,6 @@
     .novacon\:hover\:bg-\[var\(--tuwa-text-accent\)\]:hover {
       background-color: var(--tuwa-text-accent);
     }
-    .novacon\:hover\:bg-red-600:hover {
-      background-color: var(--novacon-color-red-600);
-    }
     .novacon\:hover\:text-\[var\(--tuwa-error-text\)\]:hover {
       color: var(--tuwa-error-text);
     }

package/dist/styles/nova-transactions.css

@@ -184,9 +184,6 @@
   .novatx\:max-w-\[55\%\] {
     max-width: 55%;
   }
-  .novatx\:max-w-\[200px\] {
-    max-width: 200px;
-  }
   .novatx\:min-w-0 {
     min-width: 0px;
   }

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@tuwaio/sdk",
-  "version": "0.1.14",
+  "version": "0.2.0",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
-  "description": "Layer 8 (L8) of the TUWA Ecosystem. The Core SDK bundling logic and Nova UI components into clean subpath entrypoints.",
+  "description": "Layer 8 (L8) of the TUWA Ecosystem. One package for React apps: re-exports Orbit, Pulsar, Satellite Connect, SIWX and Nova UI Kit under subpaths, with their stylesheets. Add @tuwaio/evm-sdk or @tuwaio/solana-sdk for the chains.",
   "type": "module",
   "exports": {
     "./pulsar": {
@@ -42,6 +42,16 @@
       "import": "./dist/nova-connect-i18n.js",
       "require": "./dist/nova-connect-i18n.cjs"
     },
+    "./nova-connect/evm": {
+      "types": "./dist/nova-connect-evm.d.ts",
+      "import": "./dist/nova-connect-evm.js",
+      "require": "./dist/nova-connect-evm.cjs"
+    },
+    "./nova-connect/solana": {
+      "types": "./dist/nova-connect-solana.d.ts",
+      "import": "./dist/nova-connect-solana.js",
+      "require": "./dist/nova-connect-solana.cjs"
+    },
     "./nova-transactions": {
       "types": "./dist/nova-transactions.d.ts",
       "import": "./dist/nova-transactions.js",
@@ -127,12 +137,7 @@
     "i18n",
     "modal",
     "toast",
-    "quasar",
-    "cloud",
     "sdk",
-    "cosmos",
-    "playground",
-    "cli",
     "siwx"
   ],
   "repository": {
@@ -151,41 +156,77 @@
     }
   ],
   "dependencies": {
-    "@emotion/is-prop-valid": "^1.4.0",
     "@heroicons/react": "^2.2.0",
     "@radix-ui/react-dialog": "^1.1.23",
     "@radix-ui/react-select": "^2.3.7",
-    "@tuwaio/nova-connect": "^0.6.0",
-    "@tuwaio/nova-core": "^0.6.0",
-    "@tuwaio/nova-transactions": "^0.6.0",
-    "@tuwaio/orbit-core": "^0.3.0",
-    "@tuwaio/pulsar-core": "^0.7.0",
-    "@tuwaio/pulsar-react": "^0.5.0",
-    "@tuwaio/satellite-core": "^0.5.0",
-    "@tuwaio/satellite-react": "^0.5.0",
-    "@tuwaio/siwx-core": "^0.3.0",
-    "@tuwaio/siwx-react": "^0.3.0",
-    "@tuwaio/siwx-server": "^0.3.0",
-    "@web3icons/common": "^0.11.50",
-    "@web3icons/react": "^4.1.21",
+    "@tuwaio/nova-connect": "^0.7.2",
+    "@tuwaio/nova-core": "^0.7.1",
+    "@tuwaio/nova-transactions": "^0.7.2",
+    "@tuwaio/orbit-core": "^0.3.1",
+    "@tuwaio/pulsar-core": "^0.8.2",
+    "@tuwaio/pulsar-react": "^0.6.1",
+    "@tuwaio/satellite-core": "^0.6.2",
+    "@tuwaio/satellite-react": "^0.6.2",
+    "@tuwaio/siwx-core": "^0.4.0",
+    "@tuwaio/siwx-react": "^0.4.0",
+    "@tuwaio/siwx-server": "^0.4.1",
+    "@web3icons/common": "^0.11.51",
+    "@web3icons/react": "^4.1.22",
     "clsx": "^2.1.1",
     "dayjs": "^1.11.23",
     "ethereum-blockies-base64": "^1.0.2",
-    "framer-motion": "^13.2.0",
+    "framer-motion": "^13.4.6",
     "immer": "^11.1.18",
     "react-toastify": "^11.1.0",
-    "tailwind-merge": "^3.6.0",
+    "tailwind-merge": "^3.7.0",
     "zustand": "^5.0.15"
   },
   "peerDependencies": {
     "react": ">=19.2.3",
-    "react-dom": ">=19.2.3"
+    "react-dom": ">=19.2.3",
+    "@tuwaio/orbit-evm": ">=0.3",
+    "@tuwaio/orbit-solana": ">=0.3",
+    "@tuwaio/satellite-evm": ">=0.6",
+    "@tuwaio/satellite-solana": ">=0.6",
+    "@wagmi/core": "3.x.x",
+    "@wallet-standard/react": "1.x.x",
+    "viem": "2.x.x"
+  },
+  "peerDependenciesMeta": {
+    "@tuwaio/orbit-evm": {
+      "optional": true
+    },
+    "@tuwaio/orbit-solana": {
+      "optional": true
+    },
+    "@tuwaio/satellite-evm": {
+      "optional": true
+    },
+    "@tuwaio/satellite-solana": {
+      "optional": true
+    },
+    "@wagmi/core": {
+      "optional": true
+    },
+    "@wallet-standard/react": {
+      "optional": true
+    },
+    "viem": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "react": "^19.2.8",
-    "react-dom": "^19.2.8",
+    "@tuwaio/orbit-evm": "^0.3.2",
+    "@tuwaio/orbit-solana": "^0.3.3",
+    "@tuwaio/satellite-evm": "^0.6.1",
+    "@tuwaio/satellite-solana": "^0.6.1",
+    "@wagmi/core": "^3.6.5",
+    "@wallet-standard/react": "^1.0.3",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
     "tsup": "^8.5.1",
-    "typescript": "6.0.3"
+    "typescript": "6.0.3",
+    "viem": "^2.57.1"
   },
   "scripts": {
     "start": "tsup --watch",