Introduction

XRPL Wallet Kit is a framework-agnostic wallet adapter toolkit for building XRPL and Xahau browser dApps. It provides a unified connection and transaction API, a headless core, and optional DOM-based UI components.

Why XRPL Wallet Kit?

Each XRPL wallet has its own JavaScript API: Xaman uses OAuth + deep links, GemWallet injects a browser extension, WalletConnect uses a relay protocol, Ledger talks to USB hardware. Without an abstraction layer, your dApp must implement and maintain a different integration for every wallet — and break whenever a wallet updates its API.

XRPL Wallet Kit solves this with a uniform adapter contract:

adapter.connect(options)      // → ConnectResult
adapter.signTransaction(req)  // → { txBlob, ... } when supported
adapter.signAndSubmit(req)    // → { hash, ... }
adapter.signMessage(req)      // → { signatureKind, proof, ... } when supported
adapter.disconnect()

Every adapter speaks the same language. Your app talks to the manager; the manager talks to the adapters.

Architecture

Your dApp
    │
    ▼
WalletManager          ← orchestrates adapters, sessions, events
    │
    ├── XamanAdapter
    ├── GemWalletAdapter
    ├── JoeyWalletAdapter (opt-in)
    ├── WalletConnectAdapter
    ├── CrossmarkAdapter
    ├── LedgerAdapter
    ├── DropFiAdapter
    ├── XrplSnapAdapter
    ├── GhostsigAdapter (opt-in)
    └── XyraAdapter (opt-in)

The core package contains the manager, types, errors, and storage logic. It has zero dependencies on any UI framework. The ui package adds a DOM-based modal and connect button. The adapters are separate packages — install only what you need.

Supported Wallets

The table below covers XRPL. The Xahau integration uses a chain-filtered subset with its own transaction scope and wallet configuration.

Wallet	Package	Type	Connect	Sign only	Sign and submit
Xaman	adapter-xaman	Mobile QR / OAuth	✅	Manager fallback	✅
GemWallet	adapter-gemwallet	Browser Extension	✅	Provider dependent	✅
Joey Wallet	adapter-joey-wallet	Browser Extension (opt-in)	✅	✅	✅
WalletConnect	adapter-walletconnect	Multi-wallet QR	✅	Wallet dependent	Wallet dependent
Crossmark	adapter-crossmark	Browser Extension	✅	Not exposed	✅
Ledger	adapter-ledger	Hardware (USB/HID)	✅	✅	✅
DropFi	adapter-dropfi	Extension + Mobile App	✅	Not exposed	✅
XRPL Snap	adapter-xrpl-snap	MetaMask Snap	✅	Not exposed	✅
GhostSig	adapter-ghostsig	Hosted web / popup (opt-in)	✅	✅	✅
Xyra	adapter-xyra	Hosted web / popup (opt-in)	✅	✅	✅

Joey Wallet connects directly to Joey's browser extension on XRPL Mainnet, Testnet and Devnet. Enable wallets: ["joey-wallet"] or use createJoeyWalletAdapter() explicitly. The separate joey entry continues to use WalletConnect. Extension support includes passive restore and transaction signing with or without submission; it does not expose signMessage() or Xahau.

GhostSig supports transaction signing and submission, including Payment and NFT offers, but not signMessage(). Enable it explicitly with wallets: ["ghostsig"] or createGhostsigAdapter(); the default client list and wallets: "all" do not include it.

Xyra supports XRPL and Xahau mainnet/testnet connection and transaction signing with or without submission. Select wallets: ["xyra"] on XRPL or add createXyraAdapter() explicitly; the full client includes it by default on Xahau. It does not support signMessage() or passive session restore. The Sign only column refers to manager.signTransaction(); see the capability matrix for message signing, native sign-in and session guarantees.

Package Overview

Package	Description
@xrpl-wallet-kit/core	Headless core, WalletManager, types
@xrpl-wallet-kit/ui	DOM modal, connect button
@xrpl-wallet-kit/client	All-in-one client with adapters and automatic Xahau configuration
@xrpl-wallet-kit/browser	IIFE bundle for plain HTML, with a separately loaded Xahau runtime
@xrpl-wallet-kit/xahau	Xahau protocol and network presets for core/selective integration

TIP

For production apps using a bundler (Vite, webpack), import from individual packages so tree-shaking removes unused adapters.
The IIFE bundle includes everything and is intended for quick prototyping or legacy HTML pages.

Supported Frameworks

XRPL Wallet Kit has no React dependency. The headless core works with any JavaScript environment.

Framework	Guide
React	React guide
Next.js	Next.js guide
Vue 3	Vue 3 guide
Nuxt 3	Nuxt 3 guide
Vanilla TypeScript	Vanilla TS guide
Plain HTML / CDN	HTML legacy guide

Experimental Batch Integration

The kit provides opt-in, single-account All-or-Nothing Batch preparation, inner-transaction preflight and per-operation confirmation tracking. Applications can group 2-8 operations while retaining the existing signing API. Enable compatible wallets explicitly. See Batch Transactions for scope, examples and integration requirements.

Next Steps

For Xahau, configure network: "xahau-mainnet" and a positive fee ceiling with the full client. Xaman, GemWallet and Xyra are configured automatically; select Ledger explicitly for the fourth wallet. The separate codec runtime loads on demand. Payment, Invoke/HookParameters and URITokens use the existing signing methods; Batch and multisign remain outside that runtime's scope.

• Installation — install the packages
• Quick Start — connect your first wallet in 5 minutes
• Adapters — pick the wallets you want to support
• Xahau — configure Xahau wallets, payments, Hooks and URITokens
• Theming — customize colors, fonts, and layout