diff --git a/bridge/getting-started.mdx b/bridge/getting-started.mdx index 81df9b8..61be411 100644 --- a/bridge/getting-started.mdx +++ b/bridge/getting-started.mdx @@ -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. - 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. ## Prerequisites @@ -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**. --- @@ -40,12 +40,12 @@ 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 @@ -53,19 +53,19 @@ 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. - 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). --- @@ -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**. @@ -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. - 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). --- @@ -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. @@ -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. - 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). 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. - 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). | 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. | \ No newline at end of file +| **Bitcoin RGB fee** | Small BTC amount deducted from your Utexo SDK Wallet to settle the RGB transaction on-chain. | \ No newline at end of file diff --git a/docs.json b/docs.json index 180bfef..51ba727 100644 --- a/docs.json +++ b/docs.json @@ -92,9 +92,9 @@ ] }, { - "group": "Bridge", + "group": "Mint", "pages": [ - "product-suite/bridge", + "product-suite/mint", "bridge/getting-started" ] }, diff --git a/getting-started/architecture.mdx b/getting-started/architecture.mdx index 0753d4a..152d003 100644 --- a/getting-started/architecture.mdx +++ b/getting-started/architecture.mdx @@ -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. - - ![Screenshot 2026 05 12 At 09 45 02](/images/Screenshot-2026-05-12-at-09.45.02.png) + + ![Screenshot 2026 05 26 At 23 22 55](/images/Screenshot-2026-05-26-at-23.22.55.png) ## Stack Overview diff --git a/getting-started/general-overview.mdx b/getting-started/general-overview.mdx new file mode 100644 index 0000000..4659bff --- /dev/null +++ b/getting-started/general-overview.mdx @@ -0,0 +1,3 @@ +--- +title: "General Overview" +--- \ No newline at end of file diff --git a/getting-started/product-suite.mdx b/getting-started/product-suite.mdx index a75d5a6..afd00ad 100644 --- a/getting-started/product-suite.mdx +++ b/getting-started/product-suite.mdx @@ -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. - + Non-custodial BTC ↔ USDT swaps with instant finality and LP functionality. diff --git a/images/Screenshot-2026-05-28-at-09.34.37.png b/images/Screenshot-2026-05-28-at-09.34.37.png new file mode 100644 index 0000000..33ad16b Binary files /dev/null and b/images/Screenshot-2026-05-28-at-09.34.37.png differ diff --git a/product-suite/bridge.mdx b/product-suite/mint.mdx similarity index 93% rename from product-suite/bridge.mdx rename to product-suite/mint.mdx index f2f38ae..c6af6e3 100644 --- a/product-suite/bridge.mdx +++ b/product-suite/mint.mdx @@ -1,14 +1,16 @@ --- 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." --- - ![Screenshot 2026 05 06 At 23 43 56](/images/Screenshot-2026-05-06-at-23.43.56.png) + ![Screenshot 2026 05 28 At 09 34 37](/images/Screenshot-2026-05-28-at-09.34.37.png) -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. +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. ## How It Works @@ -108,7 +110,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
Arch, Concordium | USDT on Bitcoin | | USDT0 | Arbitrum | USDT on Bitcoin | ## Fees @@ -139,7 +141,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. -\ +\\ Mint USDT between Ethereum and the Bitcoin RGB layer. diff --git a/product-suite/sdk.mdx b/product-suite/sdk.mdx index 83fae0d..578dddf 100644 --- a/product-suite/sdk.mdx +++ b/product-suite/sdk.mdx @@ -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. @@ -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 | @@ -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` | @@ -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) | @@ -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 | \ No newline at end of file