Merge pull request #120 from bitlayer-org/feature/2025-05-28-update-mainnet-guides

Feature/2025 05 28 update mainnet guides

Author: web3baseai

docs/BitVMBridge/UserGuides/HowtoBridgeInTestnet.md

@@ -4,66 +4,99 @@ sidebar_position: 52
 
 # Bridge User Guide (Testnet)
 
-This guide will walk you through how to use **[Bridge function](https://bitvmbridge.bitlayer.org/testnet/bridge#header)**, including:
+This guide walks you through using the **[BitVM Bridge](https://bitvmbridge.bitlayer.org/testnet/bridge#header)** on testnet, including:
 
-- Bridging vBTC from **BitVMNet** to **Monad Testnet and Ethereum Sepolia** to Mint YBTC
-- Bridging YBTC **back to BitVMNet**
+- Bridging **vBTC** from **BitVMNet** to **Monad Testnet** or **Ethereum Sepolia** to mint **YBTC**
+- Bridging **YBTC** back to **BitVMNet**
 
 ---
 
+## Step 1: Configure Xverse Wallet for BitVMNet
 
-## Step1: Configure Xverse wallet for BitVMNet
-**Important:** Please make sure to manually set the **Signet BTC URL(`https://esplora.bitvmnet.org`)** in **Xverse**.
+> ✅ **Important:** Manually set the **Signet BTC URL** in Xverse to:  
+> `https://esplora.bitvmnet.org`
 
-<img src="/img/BitvmBridge/tutorial/bridge/xverse.png" style={{ maxWidth: '100%', height: 'auto' }}  />
+<img src="/img/BitvmBridge/tutorial/bridge/xverse.png" style={{ maxWidth: '100%', height: 'auto' }} />
 
-## Step2: Switch to Native SegWit in Xverse wallet
+---
+
+## Step 2: Switch to Native SegWit Format in Xverse
+
+In the Xverse wallet, ensure your address format is set to **Native SegWit**.
+
+<img src="/img/BitvmBridge/tutorial/bridge/xverse-native-segwit.png" style={{ maxWidth: '100%', height: 'auto' }} />
+
+---
 
-<img src="/img/BitvmBridge/tutorial/bridge/xverse-native-segwit.png" style={{ maxWidth: '100%', height: 'auto' }}  />
+## Step 3: Get BitVMNet BTC (vBTC) from [TheFaucet](https://www.thefaucet.org/Bitcoin/BitVMNet)
 
+[BitVMNet](https://www.bitvmnet.org/) is an open Bitcoin Signet network supported by Bitlayer, designed for BitVM application development and testing.  
+BTC on BitVMNet is referred to as **vBTC**.
 
-## **Step3: Get BitVMNet BTC (vBTC) > [TheFaucet](https://www.thefaucet.org/Bitcoin/BitVMNet)**
-[BitVMNet](https://www.bitvmnet.org/) is an open Bitcoin Signet network sponsored by Bitlayer, designed to facilitate the development and implementation of BitVM-based applications. As a collaborative platform, it empowers developers within the BitVM ecosystem, driving the advancement and adoption of BitVM technology.
-BTC on BitVMNet is called **vBTC**
+To get vBTC:
+
+- Visit [TheFaucet](https://www.thefaucet.org/Bitcoin/BitVMNet)
+- Enter a Bitcoin testnet address starting with `tb1q` or `tb1p`
+- Wait ~20 minutes for the faucet to send your vBTC
+
+Once received, you can view your vBTC balance in Xverse.
 
-On the [Thefaucet](https://www.thefaucet.org/Bitcoin/BitVMNet), you can enter an address starting with `tb1q` or `tb1p` to claim **vBTC**.
-You need to wait about **20 minutes** for Thefaucet to send you the **vBTC**. Once received, you can view your **vBTC** balance in Xverse.
 <img src="/img/BitvmBridge/tutorial/bridge/thefaucet.png" style={{ maxWidth: '90%', height: 'auto' }} />
 
+---
 
-## Step4: Confirm you have configured BitVMNet in Xverse wallet
+## Step 4: Verify BitVMNet Configuration in Xverse
+
+Make sure your Xverse wallet is still using the correct Signet BTC URL:  
+`https://esplora.bitvmnet.org`
 
-Make sure the Signet network in Xverse is configured with the correct BTC URL: https://esplora.bitvmnet.org
 <img src="/img/BitvmBridge/tutorial/bridge/makesurerightbtcurl.png" style={{ maxWidth: '50%', height: 'auto' }} />
 
-## **Step5: Connect your OKX wallet** 
+---
+
+## Step 5: Connect Your OKX Wallet
+
+Connect your OKX Wallet to use Ethereum Sepolia or Monad Testnet as your destination network.
+
 <img src="/img/BitvmBridge/tutorial/bridge/okxwallet.png" style={{ maxWidth: '50%', height: 'auto' }} />
 
+---
+
+## Step 6: Select Target Network
 
-## **Step6: Select your target network** 
- Ethereum Sepolia or Monad Testnet
+Choose either **Ethereum Sepolia** or **Monad Testnet** as your target network.
+
+---
+
+## Step 7: Input Amount and Target Address
+
+- Enter the amount of vBTC to bridge  
+- Confirm your EVM-compatible address  
+- Proceed to mint **YBTC** on the selected chain
 
-## **Step7: Input the amount and Target Address** 
- Confirm to Bridge YBTC on the target chain
 <img src="/img/BitvmBridge/tutorial/bridge/bridge-out-confirm.png" style={{ maxWidth: '50%', height: 'auto' }} />
 
 ---
 
-## Bridge YBTC Back to BitVMNet
+## Bridging YBTC Back to BitVMNet
+
+### Step 1: Switch Target Chain to BitVMNet
 
-**Step1: Switch your target Chain to BitVMNet**
 <img src="/img/BitvmBridge/tutorial/bridge/bridge-in-confirm.png" style={{ maxWidth: '50%', height: 'auto' }} />
 
-**Step2: Approve and Confirm**
+### Step 2: Approve and Confirm
+
+- Approve the transaction in your wallet  
+- Confirm to bridge your YBTC back to **vBTC** on BitVMNet
 
 ---
 
 ## Quick Links
 
-| Feature                 | Link                                                                              |
-| ----------------------- | --------------------------------------------------------------------------------- |
-| Get BitVMNet BTC (vBTC) | [TheFaucet](https://www.thefaucet.org/Bitcoin/BitVMNet)                           |
-| Xverse Wallet Setup     | [Setup Guide](https://docs.bitlayer.org/docs/BitVMBridge/UserGuides/XverseBTCUrl) |
-| BitVM Bridge            | [BitVM Bridge ](https://bitvmbridge.bitlayer.org/testnet/bridge#header)           |
+| Feature                   | Link                                                                                 |
+|---------------------------|--------------------------------------------------------------------------------------|
+| Get BitVMNet BTC (vBTC)   | [TheFaucet](https://www.thefaucet.org/Bitcoin/BitVMNet)                              |
+| Xverse Wallet Setup Guide | [Setup Guide](https://docs.bitlayer.org/docs/BitVMBridge/UserGuides/XverseBTCUrl)   |
+| BitVM Bridge Interface     | [BitVM Bridge](https://bitvmbridge.bitlayer.org/testnet/bridge#header)              |
 
 ---

docs/BitVMBridge/UserGuides/HowtoBridgeOnMainet.md

@@ -0,0 +1,41 @@
+---
+sidebar_position: 42
+---
+# Howto Bridge on Mainet
+
+## Bridge User Guide (Mainnet)
+
+This guide will walk you through how to use the **[Bridge](https://bitvmbridge.bitlayer.org/bridge#header)** feature, including:
+
+- Bridging BTC from **Bitcoin** to **Ethereum** to mint YBTC  
+- Bridging YBTC **back to Bitcoin**
+
+---
+
+### **Step 1: Connect Your Wallet**
+
+Connect your Bitcoin wallet to begin.
+
+<img src="/img/BitvmBridge/tutorial/mainnet-bridge/connect-wallet.png" style={{ maxWidth: '100%', height: 'auto' }} />
+
+---
+
+### **Step 2: Enter Amount and Target Address**
+
+Enter the BTC amount you wish to bridge and provide your Ethereum address.  
+If you have already connected an EVM wallet, your receiving address will be auto-filled.
+
+You can [add YBTC](https://etherscan.io/token/0xd9e3719f53b61047d5bbbe9e3fb18ea1e07b1b02) to your wallet with a single click.
+
+<img src="/img/BitvmBridge/tutorial/mainnet-bridge/bridge-out-confirm.png" style={{ maxWidth: '100%', height: 'auto' }} />
+
+---
+
+## Bridge YBTC Back to Bitcoin
+
+### **Approve and Confirm**
+
+To bridge YBTC back to Bitcoin, enter the amount and your Bitcoin address.  
+If a Bitcoin wallet is connected, the address will be auto-filled.
+
+<img src="/img/BitvmBridge/tutorial/mainnet-bridge/bridge-in-confirm.png" style={{ maxWidth: '100%', height: 'auto' }} />

docs/BitVMBridge/UserGuides/HowtoMint.md

@@ -6,47 +6,71 @@ sidebar_position: 53
 
 ## Prerequisites
 
-To get started, ensure you have wallets supporting BTC and EVM-compatible addresses, you can get test tokens from the [links](./GetTestToken.md).
+To get started, make sure you have wallets that support both BTC and EVM-compatible addresses.  
+You can get test tokens from the following [test token faucet links](./GetTestToken.md).
 
-- Bitcoin BitVMNet
-  - Wallet: [Xverse](https://www.xverse.app/)
-- Ethereum Sepolia Testnet
-  - Wallet: [MetaMask](https://metamask.io/), [OKX Web3](https://www.okx.com/web3), [Coinbase Wallet
-    ](https://www.coinbase.com/wallet)
+- **Bitcoin BitVMNet**
+  - Recommended Wallet: [Xverse](https://www.xverse.app/)
+- **Ethereum Sepolia Testnet**
+  - Supported Wallets: [MetaMask](https://metamask.io/), [OKX Web3](https://www.okx.com/web3), [Coinbase Wallet](https://www.coinbase.com/wallet)
 
-## 1. Connect Bitcoin Wallet
+---
+
+## 1. Connect Your Bitcoin Wallet
+
+### 1.1 Open [BitVM Bridge](https://bitvmbridge.bitlayer.org/), connect to **Bitcoin BitVMNet**, and sign in.
+
+<img src="/img/BitvmBridge/tutorial/mint/connect-wallet-1.png" style={{ maxWidth: '50%', height: 'auto' }} />
+
+---
+
+### 1.2 Configure Signet Mode in Xverse
+
+Set the BTC node URL in your Xverse wallet to enable Signet mode.  
+Follow this [setup guide](https://docs.bitlayer.org/docs/BitVMBridge/UserGuides/XverseBTCUrl/).
+
+<img src="/img/BitvmBridge/tutorial/mint/xverse-btc-url.png" style={{ maxWidth: '50%', height: 'auto' }} />
+
+---
+
+### 1.3 Confirm Address and Amount
+
+Enter an amount between **0.0002 and 0.0006 BTC**, and input your **Sepolia address**.  
+If your EVM wallet is connected, the receiving address will be auto-filled.
+
+<img src="/img/BitvmBridge/tutorial/mint/confirm-address-amount-2.png" style={{ maxWidth: '50%', height: 'auto' }} />
+
+---
 
-#### 1.1 Visit [BitVM Bridge](https://bitvmbridge.bitlayer.org/), Connect Bitcoin BitVMNet, and Sign in.
+## 2. Select Funding UTXOs
 
-<img src="/img/BitvmBridge/tutorial/mint/connect-wallet-1.png"  style={{ maxWidth: '50%', height: 'auto' }}  />
+Choose UTXOs that are **not associated with derivative assets** (e.g., BRC-20).  
+If your selected UTXOs contain more BTC than the requested mint amount, the excess will be automatically returned to your Bitcoin address.
 
+<img src="/img/BitvmBridge/tutorial/mint/pick-your-funding-utxo-1.png" style={{ maxWidth: '50%', height: 'auto' }} />
 
-#### 1.2 Set the BTC URL for Signet mode in your Xverse wallet, [Setup Guide](https://docs.bitlayer.org/docs/BitVMBridge/UserGuides/XverseBTCUrl/)
-<img src="/img/BitvmBridge/tutorial/mint/xverse-btc-url.png" style={{ maxWidth: '50%', height: 'auto' }}  />
+---
 
-#### 1.3 Confirm address and amount
+## 3. Generate Deposit Address
 
-Enter amount within 0.0001~0.001, and input your Sepolia address(If you have connected an EVM wallet, your EVM receiving address will be automatically filled in.).
-<img src="/img/BitvmBridge/tutorial/mint/confirm-address-amount-2.png" style={{ maxWidth: '50%', height: 'auto' }}  />
-## 2. Pick your funding UTXOs
+A unique smart contract will be generated to receive your BTC based on your peg-in request.  
+You can preview the contract logic through a visualized diagram.
 
-Please ensure the selected UTXOs are not associated with derivative assets like BRC20.
-If UTXOs you choosed containes more BTC than you mint, extra BTC will back to your BTC address
+<img src="/img/BitvmBridge/tutorial/mint/generate-address-for-deposit-1.png" style={{ maxWidth: '50%', height: 'auto' }} />
 
-<img src="/img/BitvmBridge/tutorial/mint/pick-your-funding-utxo-1.png" style={{ maxWidth: '50%', height: 'auto' }}  />
-## 3. Generate address for Deposit
+---
 
-The BitVM Bridge Network will generate a smart contract which will accept you BTC according to your peg-in request.
-You can view the logic rules of this smart contract through a visualized diagram.
-<img src="/img/BitvmBridge/tutorial/mint/generate-address-for-deposit-1.png" style={{ maxWidth: '50%', height: 'auto' }}  />
+## 4. Make Your BTC Deposit
 
-## 4. Make your BTC Deposit
+Carefully review all transaction details and send your BTC to the generated address.
 
-Confirm all information and transfer your BTC.
-<img src="/img/BitvmBridge/tutorial/mint/make-your-btc-deposit.png" style={{ maxWidth: '50%', height: 'auto' }}  />
+<img src="/img/BitvmBridge/tutorial/mint/make-your-btc-deposit.png" style={{ maxWidth: '50%', height: 'auto' }} />
+
+---
 
-## 5. Mint your YBTC on Ethereum
+## 5. Mint YBTC on Ethereum
 
-This operation will cost 20-30Mins, it is safe to close the window. Minting process will continue as a background process and will not be interrupted.
+The minting process takes approximately **20–30 minutes**.  
+It’s safe to close the window — the process will continue in the background and will not be interrupted.
 
-<img src="/img/BitvmBridge/tutorial/mint/mint-your-btc-on-ethereum.png" style={{ maxWidth: '50%', height: 'auto' }}  />
+<img src="/img/BitvmBridge/tutorial/mint/mint-your-btc-on-ethereum.png" style={{ maxWidth: '50%', height: 'auto' }} />

docs/BitVMBridge/UserGuides/HowtoMintOnMainnet.md

@@ -0,0 +1,71 @@
+---
+sidebar_position: 43
+---
+
+# How to Mint on Mainnet?
+
+## Prerequisites
+
+Before you begin, please ensure you have:
+
+- A Bitcoin wallet with available UTXOs (not linked to BRC-20 or other derivative assets).
+- An EVM-compatible wallet (e.g., MetaMask) to receive YBTC.
+
+---
+
+## 1. Connect Your Bitcoin Wallet
+
+#### 1.1 Visit [BitVM Bridge](https://bitvmbridge.bitlayer.org/bridge-pro/mint) and connect your Bitcoin wallet.
+
+<img src="/img/BitvmBridge/tutorial/mainnet-mint/connect-btc-wallet.png"  style={{ maxWidth: '100%', height: 'auto' }}  />
+
+---
+
+#### 1.2 Confirm Amount and Ethereum Address
+
+Enter the amount you want to mint (up to 5 BTC), and provide your Ethereum wallet address.  
+If an EVM wallet is already connected, the receiving address will be auto-filled.
+
+You can add [YBTC](https://etherscan.io/token/0xd9e3719f53b61047d5bbbe9e3fb18ea1e07b1b02) to your wallet with a single click.
+
+<img src="/img/BitvmBridge/tutorial/mainnet-mint/confirm-address-amount.png" style={{ maxWidth: '100%', height: 'auto' }}  />
+
+---
+
+## 2. Select Funding UTXOs
+
+Choose UTXOs that are not associated with assets such as BRC-20.  
+If the selected UTXOs contain more BTC than required, the excess will be automatically returned to your Bitcoin address.
+
+<img src="/img/BitvmBridge/tutorial/mainnet-mint/pick-your-funding-utxo.png" style={{ maxWidth: '100%', height: 'auto' }}  />
+
+---
+
+## 3. Generate Deposit Address
+
+The BitVM Bridge Network will generate a custom smart contract address to receive your BTC.  
+This contract is created based on your peg-in request.
+
+<img src="/img/BitvmBridge/tutorial/mainnet-mint/generate-address-for-deposit.png" style={{ maxWidth: '100%', height: 'auto' }}  />
+
+---
+
+## 4. Deposit BTC
+
+Carefully review the deposit details, then send your BTC to the generated address.  
+The confirmation process typically takes 60–100 minutes. You may safely close the window — the minting will continue in the background.
+
+<img src="/img/BitvmBridge/tutorial/mainnet-mint/make-your-btc-deposit.png" style={{ maxWidth: '100%', height: 'auto' }}  />
+
+---
+
+## 5. Check YBTC in Your Wallet
+
+Once the minting process is complete, YBTC will appear in your EVM wallet.  
+The official contract address for YBTC is:
+
+**[0xd9E3719F53b61047D5Bbbe9E3FB18eA1E07B1B02](https://etherscan.io/token/0xd9e3719f53b61047d5bbbe9e3fb18ea1e07b1b02)**
+
+<img src="/img/BitvmBridge/tutorial/mainnet-mint/ybtc-in-wallet.png" style={{ maxWidth: '50%', height: 'auto' }}  />
+
+