React Native Quickstart

npm install @utexo/rgb-sdk-rn

cd ios && pod install

import { generateKeys } from '@utexo/rgb-sdk-rn';

const keys = await generateKeys('testnet');
console.log('Mnemonic:', keys.mnemonic); // Store securely — never log in production
console.log('Pubkey:', keys.xpub);

import { UTEXOWallet } from '@utexo/rgb-sdk-rn';
import RNFS from 'react-native-fs';

const dataDir = `${RNFS.DocumentDirectoryPath}/wallet`;

const wallet = new UTEXOWallet(keys.mnemonic, {
  network: 'testnet',
  dataDir
});
await wallet.initialize();
console.log('Wallet initialised successfully');

const address = await wallet.getAddress();
console.log('Deposit address:', address);

await wallet.createUtxos({ num: 5, size: 1000 });
await wallet.refreshWallet();
console.log('UTXOs created and wallet synced');

const assets = await wallet.listAssets();
const usdtAssetId = assets.find(a => a.ticker === 'USDT')?.id;
console.log('USDT Asset ID:', usdtAssetId);

const receiveData = await wallet.blindReceive({
  assetId: usdtAssetId,
  amount: 100,
  minConfirmations: 1,
  durationSeconds: 3600
});
console.log('RGB Invoice:', receiveData.invoice);
// Present receiveData.invoice as a QR code or share via deep link

const sendResult = await wallet.send({
  invoice: receiveData.invoice,
  assetId: usdtAssetId,
  amount: 100
});
console.log('Transfer TXID:', sendResult.txid);

// Sync both wallets after the transfer
await wallet.refreshWallet(); // Sender
// The receiver should also call refreshWallet() on their device

const receiverAssets = await receiverWallet.listAssets();
console.log('Receiver assets:', JSON.stringify(receiverAssets, null, 2));

import { UTEXOWallet } from '@utexo/rgb-sdk-rn';

// Open a channel with the Utexo LSP node (values in satoshis)
await wallet.openChannel({
  nodeId: '<LSP_NODE_ID>',    // provided by your Utexo node operator
  capacitySats: 100000,
  pushAmountSats: 0,
});

// Verify the channel is active before transacting
const channels = await wallet.listChannels();
console.log('Open channels:', channels);

import { UTEXOWallet } from '@utexo/rgb-sdk-rn';

// Receiver: create a Lightning invoice (BTC)
const inv = await receiverWallet.createLightningInvoice({
  amountSats: 3000,
  expirySeconds: 900,
  asset: { assetId: '', amount: 0 }, // use assetId + amount for RGB-asset payments
});

// Sender: pay the invoice
const result = await senderWallet.payLightningInvoice({
  lnInvoice: inv.lnInvoice,
});

// Poll until settled
const payment = await senderWallet.getLightningSendRequest(result.txid);
// payment.status === 'Settled' when complete

// Get a Bitcoin deposit address
const address = await wallet.getAddress();
// Send testnet BTC to this address to fund the wallet

// Receiver: generate a blinded invoice for on-chain RGB receipt
const receiveData = await receiverWallet.blindReceive({
  minConfirmations: 1,
  durationSeconds: 3600,
});

// Sender: broadcast an on-chain RGB transfer
await senderWallet.send({
  invoice: receiveData.invoice,
  assetId: usdtAssetId,
  amount: 100,
  donation: false,
  feeRate: 7,
  minConfirmations: 1,
});
await senderWallet.refreshWallet();

// Receiver: sync to see the incoming transfer
await receiverWallet.refreshWallet();