Skip to Content
Core ConceptsLayer Architecture & Overview

Layer Architecture & Overview

The TUWA Ecosystem is built around a multi-tiered architecture that decouples low-level Web3 primitives, state management, UI rendering components, and cloud transaction indexing.

🏛️ Ecosystem Layer Model (L1 – L9)

+-----------------------------------------------------------------------------------+
| L1–L2: Orbit Primitives                                                           |
|     L1: @tuwaio/orbit-core | L2: @tuwaio/orbit-evm, @tuwaio/orbit-solana          |
+-----------------------------------------------------------------------------------+
| L3–L4: Headless Core Engines & Adapters                                           |
|     Satellite (L3-L4), Pulsar (L3-L4)                                             |
+-----------------------------------------------------------------------------------+
| L5: Quasar Cloud Engine Client (@tuwaio/quasar-sdk)                               |
|     Server-Side Node.js / Edge Client + QuasarAuthBridge                          |
+-----------------------------------------------------------------------------------+
| L6–L7: Nova UI Kit (React View Layer)                                             |
|     L6: @tuwaio/nova-core | L7: @tuwaio/nova-connect, @tuwaio/nova-transactions  |
+-----------------------------------------------------------------------------------+
| L8: Core SDK (@tuwaio/sdk)                                                        |
|     Modular Subpaths: /orbit, /satellite, /pulsar, /nova-connect, /nova-transactions|
+------------------------------------+----------------------------------------------+
| L9: EVM Adapter SDK (@tuwaio/evm-sdk)| L9: Solana Adapter SDK (@tuwaio/solana-sdk)|
|     Wagmi/Viem + EVMConnectorsWatcher|     Gill/Wallet Standard + SolanaWatcher  |
+------------------------------------+----------------------------------------------+

Layer Breakdown

  1. L1 – L2: Orbit Utils (Foundation Primitives)

    • L1 Core (@tuwaio/orbit-core): Low-level, framework-agnostic multi-chain communication primitives, formatting helpers, and core adapter types (OrbitAdapter.EVM, OrbitAdapter.SOLANA).
    • L2 Platforms (@tuwaio/orbit-evm, @tuwaio/orbit-solana): Chain-specific client creators and wrappers (Viem, Wagmi, Gill).

  2. L3 – L4: Headless Core Engines (Connection & Lifecycle)

    • L3 Engines (@tuwaio/satellite-core, @tuwaio/pulsar-core): Framework-agnostic state machines for wallet connectivity (Satellite) and transaction tracking lifecycles (Pulsar).
    • L4 Adapters & Bindings (@tuwaio/satellite-evm, @tuwaio/satellite-solana, @tuwaio/satellite-react, @tuwaio/pulsar-evm, @tuwaio/pulsar-solana, @tuwaio/pulsar-react, @tuwaio/satellite-siwe-next-auth): Chain adapters, React hooks, and SIWE session auth modules.

  3. L5: Quasar Cloud Engine (@tuwaio/quasar-sdk)

    • The official server-side Node.js & Edge client for transaction indexing, cloud sync, history pagination, and authentication verification.

  4. L6 – L7: Nova UI Kit (React Visual Layer)

    • L6 UI Core (@tuwaio/nova-core): Foundational styling primitives, theme CSS variables, and design tokens.
    • L7 UI Components (@tuwaio/nova-connect, @tuwaio/nova-transactions): High-level React components (ConnectButton, TxActionButton), modals, and transaction status toasts.

  5. L8: Core SDK (@tuwaio/sdk)

    • The unified client entrypoint bundling Orbit, Satellite, Pulsar, and Nova UI components into version-aligned, tree-shakeable subpaths.

  6. L9: Dedicated Network Adapters (@tuwaio/evm-sdk, @tuwaio/solana-sdk)

    • Specialized network packages bundling chain connectors, transports, and background state watchers (EVMConnectorsWatcher, SolanaConnectorsWatcher).

🔗 Documentation Links

Access dedicated documentation portals across the TUWA ecosystem:

Last updated on
Security & SignaturesApps & API Keys