Skip to content

Bridge to Mint changes #19

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 1 commit into
base: main
Choose a base branch
from
+21 −21
Open

Bridge to Mint changes #19

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
34 changes: 17 additions & 17 deletions bridge/getting-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Getting Started"
description: "Transfer USDT between Ethereum and the Bitcoin RGB layer using the Utexo Bridge."
description: "Transfer USDT between Ethereum and the Bitcoin RGB layer using the Utexo Mint."
---

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.
Expand All @@ -16,14 +16,14 @@ Before initiating a transfer, ensure you have the following ready.
**EVM wallet (browser extension)**

- ETH balance to cover Arbitrum gas fees.
- USDT balance for the amount you want to bridge.
- USDT balance for the amount you want to Mint.

**Utexo SDK** powered Wallets

- BTC balance to cover the RGB transaction fee on the Bitcoin side.
- 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**.
- Open the wallet list in the top-right corner of the Mint page and click the power button next to **RGBWallet**.

---

Expand Down Expand Up @@ -57,7 +57,7 @@ After filling in the form, a **Transaction Preview** appears with:

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**.
1. **Approve token spending** — Authorises the Mint 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
Expand All @@ -76,7 +76,7 @@ This direction burns USDT on the Bitcoin RGB layer and releases the equivalent U

### Step 1 — Enter the transfer details

On [bridge.utexo.com](https://bridge.utexo.com), set:
On [transfer.utexo.com](https://transfer.utexo.com), set:

- **Send:** Blockchain – Bitcoin (RGB), Token – USDT.
- **Receive:** Blockchain – Ethereum (or Tron / Solana), Token – USDT.
Expand All @@ -94,11 +94,11 @@ Click **Transfer**.

### Step 2 — Pay the RGB invoice

The Bridge generates an RGB invoice displayed as a popup with a QR code. Open Utexo SDK Wallet:
The Mint 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.
3. Tap the **QR scanner** icon and scan the QR code from the Mint popup.
4. Review the transfer details and tap **Send** to confirm.

### Step 3 — Monitor the transaction status
Expand All @@ -118,28 +118,28 @@ Refresh your wallet (tap the refresh icon). Once the Bitcoin network picks up th
| 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. |
| **Mint 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 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 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**.
- Your Utexo SDK 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 mint 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 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.

- **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.

1. **Approve token spending** — Authorises the Bridge contract to spend your USDT. Click **Confirm**.
1. **Approve token spending** — Authorises the Mint 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.

<Tip>
Expand All @@ -148,11 +148,11 @@ This direction moves USDT from your EVM wallet to the Bitcoin RGB layer, where y

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 SDK Wallet:
The Mint 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.
3. Tap the **QR scanner** icon and scan the QR code from the Mint popup.
4. Review the transfer details and tap **Send** to confirm.

After sending, the transaction appears in Utexo SDK Wallet with the status **WAITING\_COUNTERPARTY**.
Expand All @@ -166,5 +166,5 @@ Refresh your wallet (tap the refresh icon). Once the Bitcoin network picks up th
| 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. |
| **Mint 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 SDK Wallet to settle the RGB transaction on-chain. |
4 changes: 2 additions & 2 deletions getting-started/architecture.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: "Architecture"
description: "How Bitcoin, the Lightning Network, RGB, the Utexo execution layer, the Bridge, and Swap fit together as a unified stablecoin settlement stack."
description: "How Bitcoin, the Lightning Network, RGB, the Utexo execution layer, the Mint, and Swap fit together as a unified stablecoin settlement stack."
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.
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 Mint 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 28 At 19 41 21](/images/Screenshot-2026-05-28-at-19.41.21.png)
Expand Down
4 changes: 2 additions & 2 deletions product-suite/mint.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ description: "Cross-chain stablecoin transfers between EVM, Tron, Solana, Arch,

The Utexo Mint is a cross-chain minting service that moves USDT between EVM-based networks and the Bitcoin RGB layer. It is built around Arbitrum as the single EVM settlement hub, integrating with the

USDT0 / LayerZero protocol so that USDT arriving from Ethereum, Tron, or Solana is transparently converted to USDT0 on Arbitrum before being locked and minted as native USDT on Bitcoin. Minted USDT is represented on Bitcoin as native USDT on Bitcoin — a real on-chain asset that can be transferred or exchanged against BTC with on-chain settlement guarantees, without relying on centralised exchanges, wrapped assets or custodial intermediaries.
USDT0 / LayerZero protocol so that USDT arriving from Ethereum, Tron, or Solana is transparently converted to USDT0 on Arbitrum before being locked and minted as native USDT on Bitcoin. Minted USDT is represented on Bitcoin as native USDT on Bitcoin — a real on-chain asset that can be transferred or exchanged against BTC with on-chain settlement guarantees, without relying on centralised exchanges, wrapped assets or custodial intermediaries.

## How It Works

Expand Down Expand Up @@ -47,7 +47,7 @@ Key properties:

### Enclave Signer

The Enclave Signer (`utexo-bridge-enclave-signer`) is the base cryptographic microservice from which each Federated Signer Node is derived. It runs inside an **AWS Nitro Enclave** — an isolated compute environment with no persistent storage, no shell access, and network access limited to a vsock proxy allowlisted to an Esplora indexer and the BTC Relay.
The Enclave Signer (`utexo-mint-enclave-signer`) is the base cryptographic microservice from which each Federated Signer Node is derived. It runs inside an **AWS Nitro Enclave** — an isolated compute environment with no persistent storage, no shell access, and network access limited to a vsock proxy allowlisted to an Esplora indexer and the BTC Relay.

### BTC Relay

Expand Down