Repository packages

LiteVerse SDK packages keep integrations consistent.

The repository contains real TypeScript packages for platform access, React state, mobile helpers, and the widget. Use them from the workspace today; publish them to npm only after the package release is approved.

Package map

Start with the package that matches your surface.

The base SDK owns the platform calls. React, mobile, and widget packages build on the same account and service contracts.

Package

@liteverse/sdk

Base TypeScript client for health, public stats, service catalog, account bootstrap, auth exchange, pairing, rewards, activity, and streams.

Package

@liteverse/sdk-react

React provider and hooks for dashboard-style interfaces that need live account and service state.

Package

@liteverse/sdk-mobile

Mobile client helpers for Android-first participation, account sync, and shared session flows.

Package

@liteverse/widget

Embeddable LiteVerse account snapshot built on top of the base SDK.

Base client

The base SDK reads the live platform API.

Client coverage

getHealth, getPublicStats, and getServiceCatalog for platform and service state.
getBootstrapProfile, getCurrentSession, and getAccount for signed-in account screens.
exchangeFirebaseToken, exchangeFirebaseEmailPassword, and exchangeOidcToken for sign-in flows.
createPairingSession, claimPairingSession, and getPairingSession for multi-device pairing.
subscribeControlPlaneStream for realtime updates from the LiteVerse control plane.
Client usage
import { createLiteVerseClient } from "@liteverse/sdk";

const client = createLiteVerseClient({
  apiBaseUrl: "https://api.liteverse.network",
});

const bootstrap = await client.getBootstrapProfile();
const stop = await client.subscribeControlPlaneStream((event) => {
  console.log(event.kind, event.emittedAt);
});

stop();
React and mobile

App shells use the same LiteVerse account language.

React bindings

LiteVerseProvider for shared client state.
useLiteVerseAccount, useLiteVerseRewards, and useLiteVerseActivity for account reads.
useLiteVerseServices and useLiteVerseInterLayerService for service-aware UI.
useLiteVerseControlPlaneStream for realtime dashboard updates.

Mobile helpers

Use Android-friendly defaults for mobile node state.
Share account and pairing flows with the dashboard.
Read device data from the native runtime when available.
Keep Google, email/password, and wallet sign-in under one account model.
Local usage

Run the packages from the workspace until registry release.

The packages are real source packages in this repository. A public npm release is a separate publishing step, not a requirement for running the local examples.

Workspace commands
pnpm install
pnpm build:packages
pnpm --dir examples/vanilla-sdk dev
pnpm --dir examples/react-sdk dev
pnpm --dir examples/widget-embed dev
Next steps

Use the SDK pages with the widget and examples.