React Native Setup

The Satora Swaps SDK is pure TypeScript with no WASM or native dependencies. It works in React Native out of the box - you just need to provide storage adapters since IndexedDB is not available.

Installation

npm install @satora/swap react-native-mmkv

Storage Adapters

The SDK requires two storage interfaces: WalletStorage (for your mnemonic and key index) and SwapStorage (for swap state). On the web, the SDK ships IdbWalletStorage and IdbSwapStorage backed by IndexedDB. In React Native, you need to implement these interfaces using a native storage solution. Below is a complete implementation using react-native-mmkv, a fast key-value storage library for React Native.

Key Storage

import type { WalletStorage } from "@satora/swap";
import { MMKV } from "react-native-mmkv";

const mmkv = new MMKV({ id: "satora-keys" });

export class MmkvWalletStorage implements WalletStorage {
  async getMnemonic(): Promise<string | null> {
    return mmkv.getString("mnemonic") ?? null;
  }

  async setMnemonic(mnemonic: string): Promise<void> {
    mmkv.set("mnemonic", mnemonic);
  }

  async getKeyIndex(): Promise<number> {
    return mmkv.getNumber("keyIndex") ?? 0;
  }

  async setKeyIndex(index: number): Promise<void> {
    mmkv.set("keyIndex", index);
  }

  async incrementKeyIndex(): Promise<number> {
    const current = await this.getKeyIndex();
    await this.setKeyIndex(current + 1);
    return current;
  }

  async clear(): Promise<void> {
    mmkv.delete("mnemonic");
    mmkv.delete("keyIndex");
  }
}

Swap Storage

import type { StoredSwap, SwapStorage } from "@satora/swap";
import type { GetSwapResponse } from "@satora/swap";
import { MMKV } from "react-native-mmkv";

const mmkv = new MMKV({ id: "lendaswap-swaps" });

export class MmkvSwapStorage implements SwapStorage {
  private key(swapId: string): string {
    return `swap:${swapId}`;
  }

  async get(swapId: string): Promise<StoredSwap | null> {
    const data = mmkv.getString(this.key(swapId));
    return data ? JSON.parse(data) : null;
  }

  async store(swap: StoredSwap): Promise<void> {
    mmkv.set(this.key(swap.swapId), JSON.stringify(swap));
  }

  async update(swapId: string, response: GetSwapResponse): Promise<void> {
    const swap = await this.get(swapId);
    if (!swap) throw new Error(`Swap ${swapId} not found`);
    swap.response = response;
    swap.updatedAt = Date.now();
    await this.store(swap);
  }

  async delete(swapId: string): Promise<void> {
    mmkv.delete(this.key(swapId));
  }

  async list(): Promise<string[]> {
    return mmkv
      .getAllKeys()
      .filter((k) => k.startsWith("swap:"))
      .map((k) => k.replace("swap:", ""));
  }

  async getAll(): Promise<StoredSwap[]> {
    const ids = await this.list();
    const swaps = await Promise.all(ids.map((id) => this.get(id)));
    return swaps.filter(Boolean) as StoredSwap[];
  }

  async clear(): Promise<void> {
    mmkv
      .getAllKeys()
      .filter((k) => k.startsWith("swap:"))
      .forEach((k) => mmkv.delete(k));
  }
}

Initialize Client

import { Client } from "@satora/swap";
import { MmkvSwapStorage, MmkvWalletStorage } from "./storage";

const client = await Client.builder()
  .withSignerStorage(new MmkvWalletStorage())
  .withSwapStorage(new MmkvSwapStorage())
  .build();

From here, all SDK methods (createLightningToEvmSwapGeneric, createArkadeToEvmSwapGeneric, claim, getSwap, listAllSwaps, etc.) work identically to the web version.

EVM Transactions

React Native does not have window.ethereum or BrowserProvider. For EVM interactions (depositing stablecoins, manual claiming on Ethereum), use ethers.js with a direct provider:

import { JsonRpcProvider, Wallet } from "ethers";

const provider = new JsonRpcProvider("https://polygon-rpc.com");
const signer = new Wallet(YOUR_PRIVATE_KEY, provider);

See the EVM to BTC page for complete examples with React Native tabs.

Notes

Secure storage - MMKV stores data unencrypted by default. For production apps, enable MMKV encryption or use a secure enclave for the mnemonic.
Alternative storage - You can use any storage backend (AsyncStorage, expo-sqlite, etc.) by implementing the WalletStorage and SwapStorage interfaces.
WebSocket support - React Native has built-in WebSocket support, so the SDK’s SwapStatusWatcher (used internally by subscribeToSwaps(...) for real-time swap status updates) works without changes.
No polyfills needed - The SDK uses only standard JavaScript APIs available in React Native.

Introduction

Integration

Advanced

Installation

Storage Adapters

Key Storage

Swap Storage

Initialize Client

EVM Transactions

Notes

​Installation

​Storage Adapters

​Key Storage

​Swap Storage

​Initialize Client

​EVM Transactions

​Notes

Installation

Storage Adapters

Key Storage

Swap Storage

Initialize Client

EVM Transactions

Notes