Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 22 additions & 22 deletions bridge/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,10 @@ title: "Getting Started"
description: "Transfer USDT between Ethereum and the Bitcoin RGB layer using the Utexo Bridge."
---

This guide walks you through both directions of a bridge transfer: depositing USDT from an EVM wallet onto the Bitcoin RGB layer and withdrawing it back. USDT from Ethereum, Tron, and Solana is supported — under the hood, it is routed through the USDT0 / LayerZero protocol to Arbitrum before being locked and minted as RGB USDT on Bitcoin. This routing is handled transparently; from your wallet, the experience is the same regardless of which network you connect from.
This guide walks you through both directions of a mint transfer: depositing USDT from an EVM wallet onto the Bitcoin RGB layer and withdrawing it back. USDT from EVM, Tron, and Solana is supported — under the hood, it is routed through the USDT0 / LayerZero protocol to Arbitrum before being locked and minted as RGB USDT on Bitcoin. This routing is handled transparently; from your wallet, the experience is the same regardless of which network you connect from.

<Info>
All transfers are atomic and non-custodial. Signing authority is distributed across three independent Federated Signer Nodes, each running inside an AWS Nitro Enclave, using a 2-of-3 threshold — no single node can produce a valid signature unilaterally.
Signing authority is distributed across three independent Federated Signer Nodes, each running inside an AWS Nitro Enclave, using a 2-of-3 threshold — no single node can produce a valid signature unilaterally.
</Info>

## Prerequisites
Expand All @@ -21,8 +21,8 @@ Before initiating a transfer, ensure you have the following ready.
**Utexo SDK** powered Wallets

- BTC balance to cover the RGB transaction fee on the Bitcoin side.
- Your Utexo Wallet connected to the Bridge. You can connect it in two ways:
- Click **CONNECT RGB WALLET** at the bottom of the bridge form.
- Your Utexo Wallet connected to the Mint. You can connect it in two ways:
- Click **CONNECT RGB WALLET** at the bottom of the Mint form.
- Open the wallet list in the top-right corner of the bridge page and click the power button next to **RGBWallet**.

---
Expand All @@ -40,32 +40,32 @@ On [transfer.utexo.com](https://bridge.utexo.com), set:

In the **Amount** field, enter the number of USDT tokens to transfer.

In the **Destination** field, paste an RGB invoice generated in Utexo Wallet:
In the **Destination** field, paste an RGB invoice generated in Utexo SDK Wallet:

1. Open Utexo Wallet and ensure your BTC balance can cover the network fee.
1. Open Utexo SDK Wallet and ensure your BTC balance can cover the network fee.
2. Select **Receive assets**.
3. Generate an invoice for the USDT asset and copy it.
4. Paste the invoice into the **Destination** field on the Bridge.
4. Paste the invoice into the **Destination** field on the Mint protocol.

### Step 2 — Review and confirm

After filling in the form, a **Transaction Preview** appears with:

- **You will receive** — estimated USDT amount after fees.
- **Estimated gas fee** — live Arbitrum network gas cost.
- **Bridge commission** — fixed percentage fee charged by Utexo.
- **Mint commission** — fixed percentage fee charged by Utexo.

Click **Transfer**. MetaMask will prompt you through two confirmation steps:
Click **Transfer**. EVM wallet will prompt you through two confirmation steps:

1. **Approve token spending** — Authorises the Bridge contract to spend your USDT. Click **Confirm**.
2. **Confirm the transaction** — Wait 2–10 seconds for the second MetaMask prompt. Review the details and click **Confirm** to submit.

### Step 3 — Wait for USDT to arrive

Open Utexo Wallet and monitor your USDT balance. Settlement time depends on Bitcoin network congestion. During periods of high congestion, confirmation may take longer than usual.
Open Utexo SDK Wallet and monitor your USDT balance. Settlement time depends on Bitcoin network congestion. During periods of high congestion, confirmation may take longer than usual.

<Tip>
In Utexo Wallet, a completed Ethereum → Bitcoin transfer is highlighted in **green** (asset credit).
In Utexo SDK Wallets, a completed Ethereum → Bitcoin transfer is highlighted in **green** (asset credit).
</Tip>

---
Expand Down Expand Up @@ -94,7 +94,7 @@ Click **Transfer**.

### Step 2 — Pay the RGB invoice

The Bridge generates an RGB invoice displayed as a popup with a QR code. Open Utexo Wallet:
The Bridge generates an RGB invoice displayed as a popup with a QR code. Open Utexo SDK Wallet:

1. Navigate to your **USDT** token.
2. Tap **Send**.
Expand All @@ -103,12 +103,12 @@ The Bridge generates an RGB invoice displayed as a popup with a QR code. Open Ut

### Step 3 — Monitor the transaction status

After sending, the transaction appears in Utexo Wallet with the status **WAITING\_COUNTERPARTY**.
After sending, the transaction appears in Utexo SDK Wallet with the status **WAITING\_COUNTERPARTY**.

Refresh your wallet (tap the refresh icon). Once the Bitcoin network picks up the transaction, the status changes to **WAITING\_CONFIRMATIONS**. When confirmations are complete, the USDT is released to your EVM address.

<Tip>
In Utexo Wallet, a completed Bitcoin → Ethereum transfer is highlighted in **red** (asset deduction from the RGB layer).
In Utexo SDK Wallet, a completed Bitcoin → Ethereum transfer is highlighted in **red** (asset deduction from the RGB layer).
</Tip>

---
Expand All @@ -119,18 +119,18 @@ Refresh your wallet (tap the refresh icon). Once the Bitcoin network picks up th
| --- | --- |
| **Arbitrum gas fee** | Variable; priced at live market rates at the time of signing. |
| **Bridge commission** | Fixed percentage of the transferred amount, charged by Utexo. Shown in the Transaction Preview before you confirm. |
| **Bitcoin RGB fee** | Small BTC amount deducted from your Utexo Wallet to settle the RGB transaction on-chain. |
| **Bitcoin RGB fee** | Small BTC amount deducted from your Utexo SDK Wallet to settle the RGB transaction on-chain. |

**Utexo SDK** powered Wallets

- BTC balance to cover the RGB transaction fee on the Bitcoin side.
- Your Utexo Wallet connected to the Bridge. You can connect it in two ways:
- Your Utexo SDK Wallet connected to the Bridge. You can connect it in two ways:
- Click **CONNECT RGB WALLET** at the bottom of the bridge form.
- Open the wallet list in the top-right corner of the bridge page and click the power button next to **RGBWallet**.

This direction moves USDT from your EVM wallet to the Bitcoin RGB layer, where you receive an equivalent RGB USDT token.

1. Open Utexo Wallet and ensure your BTC balance can cover the network fee.
1. Open Utexo SDK Wallet and ensure your BTC balance can cover the network fee.
2. Select **Receive assets**.
3. Generate an invoice for the USDT asset and copy it.
4. Paste the invoice into the **Destination** field on the Bridge.
Expand All @@ -143,28 +143,28 @@ This direction moves USDT from your EVM wallet to the Bitcoin RGB layer, where y
2. **Confirm the transaction** — Wait 2–10 seconds for the second MetaMask prompt. Review the details and click **Confirm** to submit.

<Tip>
In Utexo Wallet, a completed Ethereum → Bitcoin transfer is highlighted in **green** (asset credit).
In Utexo SDK Wallet, a completed Ethereum → Bitcoin transfer is highlighted in **green** (asset credit).
</Tip>

This direction burns USDT on the Bitcoin RGB layer and releases the equivalent USDT on Ethereum.

The Bridge generates an RGB invoice displayed as a popup with a QR code. Open Utexo Wallet:
The Bridge generates an RGB invoice displayed as a popup with a QR code. Open Utexo SDK Wallet:

1. Navigate to your **USDT** token.
2. Tap **Send**.
3. Tap the **QR scanner** icon and scan the QR code from the Bridge popup.
4. Review the transfer details and tap **Send** to confirm.

After sending, the transaction appears in Utexo Wallet with the status **WAITING\_COUNTERPARTY**.
After sending, the transaction appears in Utexo SDK Wallet with the status **WAITING\_COUNTERPARTY**.

Refresh your wallet (tap the refresh icon). Once the Bitcoin network picks up the transaction, the status changes to **WAITING\_CONFIRMATIONS**. When confirmations are complete, the USDT is released to your EVM address.

<Tip>
In Utexo Wallet, a completed Bitcoin → Ethereum transfer is highlighted in **red** (asset deduction from the RGB layer).
In Utexo SDK Wallet, a completed Bitcoin → Ethereum transfer is highlighted in **red** (asset deduction from the RGB layer).
</Tip>

| Fee type | Description |
| --- | --- |
| **Arbitrum gas fee** | Variable; priced at live market rates at the time of signing. |
| **Bridge commission** | Fixed percentage of the transferred amount, charged by Utexo. Shown in the Transaction Preview before you confirm. |
| **Bitcoin RGB fee** | Small BTC amount deducted from your Utexo Wallet to settle the RGB transaction on-chain. |
| **Bitcoin RGB fee** | Small BTC amount deducted from your Utexo SDK Wallet to settle the RGB transaction on-chain. |
27 changes: 10 additions & 17 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,13 @@
"pages": [
"getting-started/the-problem",
"getting-started/architecture",
"getting-started/quickstart",
{
"group": "Quickstart",
"pages": [
"getting-started/general-overview",
"getting-started/quickstart"
]
},
"getting-started/glossary"
]
},
Expand Down Expand Up @@ -84,26 +90,13 @@
]
},
{
"group": "Bridge",
"group": "Mint",
"pages": [
"product-suite/bridge",
"product-suite/mint",
"bridge/getting-started"
]
},
{
"group": "Swap",
"pages": [
"product-suite/swap",
{
"group": "Bitcoin Basics",
"pages": []
},
{
"group": "Legacy AMM Swap",
"pages": []
}
]
}
"product-suite/swap"
]
}
]
Expand Down
4 changes: 2 additions & 2 deletions getting-started/architecture.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ sidebarTitle: "Architecture"

Utexo is built on a layered stack. Each layer has a distinct and non-overlapping role. Together they deliver the properties that make Bitcoin-native stablecoin settlement viable for production payment systems: deterministic costs, settlement privacy, and Bitcoin-backed security. The Bridge and Swap layers extend this stack outward — connecting external EVM-based networks and enabling non-custodial BTC/USDT exchange on Bitcoin.

<Frame caption="Utexo Architecture">
![Screenshot 2026 05 12 At 09 45 02](/images/Screenshot-2026-05-12-at-09.45.02.png)
<Frame>
![Screenshot 2026 05 26 At 23 22 55](/images/Screenshot-2026-05-26-at-23.22.55.png)
</Frame>

## Stack Overview
Expand Down
3 changes: 3 additions & 0 deletions getting-started/general-overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
title: "General Overview"
---
2 changes: 1 addition & 1 deletion getting-started/product-suite.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ By grouping these components under a common execution model, Utexo reduces the n
Atomic stablecoin transfers from EVM networks and Tron to native Bitcoin RGB USDT.
</Card>

<Card title="Swap" icon="arrows-rotate" href="/product-suite/swap">
<Card title="Swap" icon="arrows-rotate" href="product-suite/swap">
Non-custodial BTC ↔ USDT swaps with instant finality and LP functionality.
</Card>
</CardGroup>
Expand Down
6 changes: 0 additions & 6 deletions getting-started/quickstart.mdx
Original file line number Diff line number Diff line change
@@ -1,9 +1,3 @@
---
title: "Quickstart"
sidebarTitle: "Quickstart"
description: "Send your first RGB USDT transfer on Bitcoin in under 15 minutes."
---

## What You Will Build

This guide walks you through the full Utexo SDK integration flow: installing the SDK, generating and initializing a wallet, funding it with testnet BTC, creating UTXOs to anchor RGB state, generating an RGB invoice and completing your first USDT transfer on Bitcoin.
Expand Down
8 changes: 4 additions & 4 deletions product-suite/bridge.mdx → product-suite/mint.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Mint"
sidebarTitle: "Bridge"
description: "Cross-chain stablecoin transfers between Arbitrum, Ethereum, Tron, Solana and the Bitcoin RGB layer."
sidebarTitle: "Mint"
description: "Cross-chain stablecoin transfers between EVM, Tron, Solana, Arch, Concordium and the Bitcoin RGB layer."
---

<Frame>
Expand Down Expand Up @@ -108,7 +108,7 @@ USDT from **Ethereum**, **Tron**, and **Solana** is supported at the user level

| Asset | Source Network | Representation on Bitcoin |
| --- | --- | --- |
| USDT | Ethereum, Tron, Solana (via USDT0) | USDT on Bitcoin |
| USDT | EVM, Tron, Solana (via USDT0) and <br />Arch, Concordium | USDT on Bitcoin |
| USDT0 | Arbitrum | USDT on Bitcoin |

## Fees
Expand Down Expand Up @@ -139,7 +139,7 @@ The Utexo Mint is designed so that assets cannot be stolen even if individual op
Mint USDT between Ethereum and the Bitcoin RGB layer.
</Card>

\
\\

<Card title="Getting Started" icon="arrow-left-to-bracket" href="/product-suite/bridge-getting-started">
Mint USDT between Ethereum and the Bitcoin RGB layer.
Expand Down
18 changes: 9 additions & 9 deletions product-suite/sdk.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'SDK'
description: 'Overview of the Utexo SDK family — Node.js, Web, and React Native client libraries for RGB asset operations and on-chain Bitcoin interactions.'
sidebarTitle: 'Utexo SDK'
title: "General Overview"
description: "Overview of the Utexo SDK family — Node.js, Web, and React Native client libraries for RGB asset operations and on-chain Bitcoin interactions."
sidebarTitle: "General Overview"
---

The Utexo SDK provides programmatic access to the Utexo execution layer, enabling applications to issue, transfer, and receive RGB assets on Bitcoin without operating nodes, managing channels, or handling protocol-level infrastructure.
Expand All @@ -13,7 +13,7 @@ It exposes a clean set of async methods organised around wallet management, RGB
The Utexo SDK is available across three application platforms, all built on a shared core package (`@utexo/rgb-sdk-core`) that ensures consistent behaviour and a unified API surface. A separate Wallet Development Kit (WDK) layer is available for builders who need lower-level wallet abstractions:

| Package | Platform | Use case |
|---|---|---|
| --- | --- | --- |
| `@utexo/rgb-sdk` | Node.js | Server-side integrations, backends, custody services |
| `@utexo/rgb-sdk-web` | Browser / JS/TS | Web apps, embedded wallets, client-side validation via WASM |
| `@utexo/rgb-sdk-rn` | React Native | iOS and Android — full on-device Lightning node via RLN |
Expand Down Expand Up @@ -95,7 +95,7 @@ Key execution properties:
The SDK supports three environments. Pass the identifier in the `network` field of the init config.

| Environment | Identifier | RGB Transport | Bitcoin Indexer |
|---|---|---|---|
| --- | --- | --- | --- |
| Mainnet | `mainnet` | `rpcs://rgb-proxy-mainnet.utexo.com/json-rpc` | `ssl://electrum.iriswallet.com:50003` |
| Testnet | `testnet` | `rpcs://rgb-proxy-testnet3.utexo.com/json-rpc` | `ssl://electrum.iriswallet.com:50013` |
| Utexo (Signet) | `utexo` | `rpcs://rgb-proxy.utexo.com/json-rpc` | `https://esplora-api.utexo.com` |
Expand All @@ -109,13 +109,13 @@ Complete method reference for UTEXOWallet: wallet methods, RGB asset methods, UT
## Further Reading

- [Product Suite](/getting-started/product-suite) — How the SDK fits into the full Utexo product surface.
- [Architecture](/getting-started/architecture) — The Bitcoin + RGB stack the SDK operates on.
- [Architecture](/getting-started/architecture) — The Bitcoin \+ RGB stack the SDK operates on.
- [Quickstart](/getting-started/quickstart) — Step-by-step guide to your first Utexo integration.

## Platform SDKs

| Page | Package | Platform |
|---|---|---|
| --- | --- | --- |
| [Node.js SDK](/sdk/utexo-sdk) | `@utexo/rgb-sdk` | Node.js — server-side integrations and backends |
| [React Native SDK](/sdk/react-native-sdk) | `@utexo/rgb-sdk-rn` | iOS and Android — full on-device Lightning node |
| [Web SDK](/sdk/web-sdk) | `@utexo/rgb-sdk-web` | Browser — WASM, no server required (Lightning coming soon) |
Expand All @@ -125,7 +125,7 @@ Complete method reference for UTEXOWallet: wallet methods, RGB asset methods, UT
The WDK packages expose RGB capabilities through standard wallet abstraction interfaces for builders who already use WDK-compatible account and signing layers.

| Page | Package | Status |
|---|---|---|
| --- | --- | --- |
| [WDK Overview](/sdk/wdk-overview) | — | Shared architecture and `dataDir` coordination |
| [wdk-wallet-rgb](/sdk/wdk-wallet-rgb) | `@utexo/wdk-wallet-rgb` | Stable — RGB asset management |
| [wdk-rgb-lightning](/sdk/wdk-rgb-lightning) | `@utexo/wdk-rgb-lightning` | Alpha — RGB Lightning channels and payments |
| [wdk-rgb-lightning](/sdk/wdk-rgb-lightning) | `@utexo/wdk-rgb-lightning` | Alpha — RGB Lightning channels and payments |