Web Quickstart

npm install @utexo/rgb-sdk-web

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

const keys = await generateKeys('testnet');
console.log('Mnemonic:', keys.mnemonic); // Encrypt and store securely
console.log('Pubkey:', keys.xpub);

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

const wallet = new UTEXOWallet(keys.mnemonic, {
  network: 'testnet'
});
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 copyable string in your UI

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() in their browser session

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

// Receiver: create a Lightning invoice (BTC-only)
const inv = await receiverWallet.createLightningInvoice({
  amountSats: 3000,
  expirySeconds: 900,
  asset: { assetId: '', amount: 0 }, // set 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);
console.log('Payment status:', payment.status); // 'Settled' when complete

// Get a Bitcoin deposit address for on-chain funding
const address = await wallet.getAddress();
console.log('Deposit address:', address);

// Receiver: generate a blinded RGB invoice for on-chain 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,
});

// Both parties sync state
await senderWallet.refreshWallet();
await receiverWallet.refreshWallet();