Introduction

TUWA Orbit provides modular, headless-first Web3 frontend primitives engineered for absolute application sovereignty, performance, and self-custody.

As a framework-agnostic primitive layer, Orbit manages low-level multi-chain communication while remaining completely decoupled from higher-level visual layers (such as Nova UI Kit) or transaction tracking engines (such as Pulsar / Quasar).

🏛️ Ecosystem Alignment & Architecture

In high-reliability Web3 frontends, mixing user interface layouts with blockchain communication primitives causes codebase fragmentation, dependency bloat, and maintenance overhead. Orbit provides a unified, logic-only integration boundary.

Core Architectural Advantages

1. Low-Level Communication Primitives: Define cross-chain operations through the common BaseAdapter interface. Resolving ENS addresses, Solana signatures, and network state returns consistent models.
2. Headless Execution: Contains zero CSS rules, UI layouts, or framework bindings. Integrates with React, Vue, Svelte, Solid, or vanilla JavaScript.
3. Application Sovereignty: Restores developer control over network connections. Restricts wallet handling to self-custodial protocols and rejects SaaS dependency lock-ins.
4. Decoupled Architecture: Serves as the Tier 1/2 layer beneath state lifecycle trackers (Pulsar) or CSS design frameworks (Nova), preventing circular dependencies and side effects.

🧩 Monorepo Modules

The Orbit monorepo is split into distinct, lightweight packages:

• @tuwaio/orbit-core (Tier 1): Defines common types, error definitions, and provides localStorage connection persistence helpers.
• @tuwaio/orbit-evm (Tier 2): Resolves EVM-specific communication primitives, public client caching, and ENS resolution powered by viem and @wagmi/core.
• @tuwaio/orbit-solana (Tier 2): Implements Solana RPC client caches, Wallet Standard connector discovery, and metadata lookups powered by gill.

💾 Installation

Install Orbit depending on target networks:

# Tier 1 Core
pnpm add @tuwaio/orbit-core
 
# Tier 2 EVM Platform
pnpm add @tuwaio/orbit-evm @wagmi/core viem
 
# Tier 2 Solana Platform
pnpm add @tuwaio/orbit-solana gill @wallet-standard/app @wallet-standard/ui-core @wallet-standard/ui-registry

📚 Technical Reference

• Refer to the API Reference to explore generated definitions for exported adapter interfaces, classes, and types.
• Read package README specifications:
  • @tuwaio/orbit-core Reference
  • @tuwaio/orbit-evm Reference
  • @tuwaio/orbit-solana Reference