Introduction

Orbit Utils is a headless, framework-agnostic, and multi-chain library ecosystem built to abstract blockchain complexity. It provides unified, type-safe interfaces for EVM and Solana operations, allowing you to create self-custodial user interfaces with zero vendor lock-in and complete developer autonomy.

🏛️ What is Orbit Utils?

In Web3 frontend engineering, supporting multiple blockchains often results in scattered conditional logic, duplicated boilerplate, and tight coupling with bloated wallet SDKs. Orbit Utils addresses this by providing a unified adapter architecture.

Why Orbit Utils?

1. Unified Cross-Chain Abstraction: Define your UI state once. The common BaseAdapter interface maps operations like ENS/Solana resolution and transaction exploration to a single consistent model.
2. Headless by Design: Contains zero UI code or layout assumptions. Use it with React, Vue, Svelte, Solid, or vanilla JavaScript.
3. Self-Custodial & Sovereign: Built strictly to support self-custody and user autonomy, with no external SaaS hooks or forced vendor structures.
4. Modular Footprint: Split into separate, lightweight packages. Only install and bundle the chain implementations your application actually requires.

🧩 Modular Packages

The Orbit Utils ecosystem is split into three independent, TypeScript-first packages:

• @tuwaio/orbit-core: The brain. Establishes the OrbitAdapter selectors, interfaces, and provides SSR-safe storage layers for wallet connection persistence.
• @tuwaio/orbit-evm: The EVM muscle. Bundles public client caching and ENS resolution helpers using viem and @wagmi/core.
• @tuwaio/orbit-solana: The Solana muscle. Implements wallet standard discovery, client instance caching, and account metadata lookups using gill (modern Solana kit).

💾 Installation

Get started by adding the core engine and the specific adapters needed for your application:

# Core package
pnpm add @tuwaio/orbit-core
 
# EVM Adapter
pnpm add @tuwaio/orbit-evm @wagmi/core viem
 
# Solana Adapter
pnpm add @tuwaio/orbit-solana gill @wallet-standard/app @wallet-standard/ui-core @wallet-standard/ui-registry

📚 Next Steps

• Explore the API Reference to view automatically generated documentation for all exported types, adapters, and utility methods.
• Read individual package guides:
  • @tuwaio/orbit-core README
  • @tuwaio/orbit-evm README
  • @tuwaio/orbit-solana README

Built with ❤️ by TUWA