Introduction

Welcome to the TUWA SDK documentation — the official server-side SDK for the Quasar Cloud, featuring built-in React authentication bridges.

What is Quasar SDK?

@tuwaio/quasar-sdk is a type-safe Node.js & Edge SDK for interacting with the TUWA Quasar Cloud API. It provides two main ways to interact with the platform:

1. Quasar Client: A stateful, server-side client for high-level operations like Pulsar transaction syncing.
2. Utils: A set of stateless, functional utilities for signature verification and security (ideal for both server and browser).

Key Features

• 🔐 Iron Dome Protocol — every request is authenticated via secret key headers
• 🛡️ QuasarAuthBridge — built-in React component for unified EVM & Solana authentication
• 📦 Dual module format — ships as ESM and CJS
• 🧩 Modular architecture — isolated modules for Pulsar (Transactions) and Utils (Security)
• 🔒 Server-side only — your secret keys never leak to the browser
• 📖 Auto-generated API reference — TypeDoc annotations powering this docs site

Quick Start (Core & Utils)

import { Quasar, utils } from '@tuwaio/quasar-sdk';
 
// Initialize the client
const quasar = new Quasar({ secretKey: 'sk_live_...' });
 
// Use domain modules to sync a transaction to the cloud
const { txKey } = await quasar.pulsar.syncCreate({
  txKey: 'tx_local_18f2...',
  chainId: 1,
  from: '0xabc...',
  type: 'TRANSFER',
  connectorType: 'evm:metamask',
  adapter: 'evm',
  tracker: 'ethereum',
  pending: true,
  localTimestamp: Date.now(),
});
 
// Or use stateless utilities directly to verify client signatures
const isValid = await utils.verifyMiniSession({
  walletAddress,
  signature,
  timestamp,
  chainType,
});

Quick Start (React)

For EVM-only applications, use the EVM subpath to prevent missing @solana/react errors:

import { QuasarEvmAuthBridge } from '@tuwaio/quasar-sdk/react/evm';
 
// Mount within your SatelliteConnectProvider tree to handle EVM signatures
<QuasarEvmAuthBridge
  activeConnection={activeConnection}
  store={store}
  wagmiConfig={config}
  session={miniSession}
  setSession={setMiniSession}
/>

For Solana-only or multi-chain applications, see the Security Section for appropriate components and subpaths.

Installation

pnpm add @tuwaio/quasar-sdk ofetch

Next Steps

• Browse the API Reference for full type documentation
• View the Scalar API Viewer for endpoint exploration
• Check the GitHub Repository  for source code

Built with ❤️ by the TUWA Team