xion.js

Official XION JavaScript SDK monorepo.

Packages

See ARCHITECTURE.md for how the layers fit together.

Removed in v1

These packages have been removed from the active workspace and will not be published in the v1 line:

• @burnt-labs/abstraxion — renamed to @burnt-labs/abstraxion-react. Same React wrapper; npm name only. See the package's README for the migration note.
• @burnt-labs/ui — deprecated. The legacy <Abstraxion> modal it powered is superseded by <AbstraxionEmbed> in @burnt-labs/abstraxion-react. Last published version is @burnt-labs/ui@1.0.0-alpha.26.
• @burnt-labs/tailwind-config, @burnt-labs/tsconfig, @burnt-labs/eslint-config-custom — workspace ergonomics only, never load-bearing for external consumers. Consumers that extended these should switch to standard configs (e.g. @vercel/style-guide, @tsconfig/*).

Quick start

React (web)

npm i @burnt-labs/abstraxion-react

import {
  AbstraxionProvider,
  AbstraxionEmbed,
  useAbstraxionAccount,
} from "@burnt-labs/abstraxion-react";

const config = {
  chainId: "xion-testnet-2",
  treasury: "xion1...",
  authentication: { type: "auto" }, // popup on desktop, redirect on mobile
};

export default function App() {
  return (
    <AbstraxionProvider config={config}>
      <AbstraxionEmbed />
      <Account />
    </AbstraxionProvider>
  );
}

React Native (Expo)

npm i @burnt-labs/abstraxion-react-native \
      @react-native-async-storage/async-storage \
      expo-web-browser expo-linking
# embedded mode only:
npm i react-native-webview

Other framework (Svelte / Vue / vanilla JS)

npm i @burnt-labs/abstraxion-js

import { createAbstraxionRuntime } from "@burnt-labs/abstraxion-js";

const runtime = createAbstraxionRuntime(config);
runtime.subscribe((state) => {
  /* mirror state into your framework's reactivity primitive */
});
await runtime.login();

See demos/svelte/ for a worked example.

Demos

• demos/react — Vite + React (replaces the previous apps/demo-app Next.js demo)
• demos/react-native — Expo + React Native; redirect and embedded modes
• demos/svelte — Vite + Svelte wired directly against abstraxion-js
• demos/node — Node.js placeholder

Development

pnpm dev      # Start all packages in dev mode
pnpm build    # Build all packages
pnpm lint     # Lint code
pnpm format   # Format code
pnpm test     # Run tests

Publishing

pnpm changeset          # Create a changeset
pnpm version:packages   # Version packages
pnpm publish:packages   # Publish to npm

Built with Turborepo, TypeScript, and Tailwind CSS.