Skip to main content

Documentation Index

Fetch the complete documentation index at: https://utexo-e7ed9bd0-feat-faucet-bot.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through converting an RGB asset (such as RGB USDT or SatoshiRamen) back into native Bitcoin (BTC) using the Utexo swap interface and Tribe Wallet. By the end you will have:
  • Sent an RGB asset from Tribe Wallet via an RGB invoice
  • Received native BTC at a Bitcoin address you control
  • Confirmed the transaction status in both interfaces
Looking to go the other direction? See Swap BTC to RGB.

How It Works

Every RGB to BTC swap runs through the HotPot protocol lifecycle:
  1. Quote - Utexo fetches a time-limited quote for the RGB asset amount and target BTC output. Quotes expire and must be executed before the expiry timestamp.
  2. Intent - A signed swap intent is created off-chain, committing to the quoted conditions.
  3. PSBT - Utexo generates an RGB invoice tied to a PSBT. You pay the invoice from Tribe Wallet, authorising the RGB asset transfer.
  4. Execution - A resolver confirms the RGB asset receipt and releases BTC to your specified receive address.
  5. Settlement - BTC is sent to your Bitcoin wallet. If execution times out or fails, the RGB asset is refunded to your Tribe Wallet.
The RGB side of the swap is validated client-side by Tribe Wallet before broadcasting. Utexo acts as the swap counterparty and releases BTC upon confirmed receipt of the RGB asset.

Prerequisites

Before you start:
  • Tribe Wallet (mobile app) with an RGB asset balance to swap (e.g. RGB USDT or SatoshiRamen)
  • A Bitcoin address where you want to receive BTC (Taproot address recommended - see What is a Bitcoin Taproot Address)
  • Sufficient RGB asset balance to cover the swap amount
Ensure your Tribe Wallet has an adequate RGB asset balance before initiating the swap. The RGB invoice generated by Utexo is time-limited - if Tribe Wallet does not send within the validity window, the swap will fail and you will need to start again.

Step 1: Enter the Transfer Details in Utexo

In the Utexo swap interface:
  1. Set You send to the RGB token you want to swap (for example, SatoshiRamen)
  2. Set You receive to BTC (Bitcoin)
  3. Enter the amount of RGB tokens to send
  4. Click Swap to proceed
Review the preview details:
  • The estimated BTC amount you will receive
  • The swap fee
  • The quote expiry time
  1. Click Confirm to generate the RGB invoice
The preview is an estimate. The final BTC amount may vary slightly based on network fees at the time of settlement.

Step 2: Copy Your BTC Receive Address

Utexo needs a Bitcoin address to send BTC to once it receives your RGB asset.
  1. Copy a BTC receive address from your Bitcoin wallet
  2. Paste it into the BTC receive address field in Utexo
Use a Taproot (P2TR) address where possible. Standard Bitcoin addresses are also accepted, but Taproot addresses offer better privacy. See What is a Bitcoin Taproot Address for more.

Step 3: Pay the RGB Invoice in Tribe Wallet

Utexo will display an RGB invoice (as a QR code and a string). In Tribe Wallet:
  1. Open Other assets (bottom navigation)
  2. Select the RGB asset you are sending
  3. Tap Send
  4. Scan the QR code from the Utexo screen, or paste the invoice string manually
  5. Tribe Wallet will pre-fill the recipient invoice details - confirm the asset and amount
  6. Swipe to send to broadcast the RGB transfer
Double-check the asset and amount before swiping. RGB transfers are irreversible once broadcast.

Step 4: Track Swap Status

After sending from Tribe Wallet, monitor progress in both interfaces:
StatusMeaning
InitiatedSwap created; awaiting your RGB asset payment
ApprovalAddedPSBT signed; RGB transfer pending
AcceptedResolver accepted the intent and is preparing BTC release
UserDepositedRGB asset confirmed; resolver executing BTC release
FulfilledBTC sent to your receive address
ExpiredThe intent expired before execution
RefundRequestedRefund has been initiated
RefundedRGB asset returned to your Tribe Wallet
  • In Tribe Wallet: the transaction appears with a status label. Refresh to see updates.
  • In Utexo: once the RGB transfer is confirmed, Utexo releases BTC to your address. The swap status updates to Fulfilled.
  • In your Bitcoin wallet: the incoming BTC transaction will appear, typically within 1-3 Bitcoin confirmations.
On mainnet, expect 10-30 minutes for full settlement.

Troubleshooting

IssueLikely causeFix
Swap stuck after sending from Tribe WalletRGB transfer not yet confirmedWait for Bitcoin confirmations; check status in Utexo
BTC not received after Fulfilled statusWrong BTC address enteredVerify the address in Utexo; contact support if needed
Tribe Wallet shows invoice as expiredInvoice timed out before paymentStart a new swap in Utexo and pay the new invoice promptly
RGB balance unchanged after sendTransfer failed client-side validationCheck Tribe Wallet for error details; regenerate invoice and retry
Status shows RefundedExecution failed or timed outRGB asset has been returned to your Tribe Wallet
If your swap is stuck or you believe BTC has been lost, contact Utexo support with your swap transaction ID.

Next Steps