From 2665aa4e431f61e9a92af4ea9ad2b09dfb14cede Mon Sep 17 00:00:00 2001 From: 0xlucasliao Date: Wed, 28 May 2025 16:10:58 +0800 Subject: [PATCH 1/8] Create cross-chain-bridge.md --- .../guides/cross-chain-bridge.md | 113 ++++++++++++++++++ 1 file changed, 113 insertions(+) create mode 100644 docs/bnb-smart-chain/guides/cross-chain-bridge.md diff --git a/docs/bnb-smart-chain/guides/cross-chain-bridge.md b/docs/bnb-smart-chain/guides/cross-chain-bridge.md new file mode 100644 index 0000000000..2d0a6e1445 --- /dev/null +++ b/docs/bnb-smart-chain/guides/cross-chain-bridge.md @@ -0,0 +1,113 @@ +--- +title: BNB Chain Bridge – Cross‑Chain Guide +--- + +## 1  Audience + +* **Web3 users** who need a practical walkthrough. +* **dApp developers** integrating Wormhole SDK. +* **Support teams** resolving bridge issues. + +## 2  Key Features & Improvements + +| Feature | Benefit | +| -------------------------------------------- | ------------------------------ | +| \~30 chains supported via Wormhole Guardians | Large surface for liquidity | +| Automatic route discovery & fee quote | UX parity with CEX withdrawals | +| On‑chain proof of lock/mint | Verifiable token accounting | +| Message batching on opBNB | Up to 40% cheaper gas | + +## 3  Supported Routes (May 2025) + +* **EVM chains**: Ethereum, Arbitrum, Optimism, Polygon PoS, Polygon zkEVM, Avalanche C‑Chain, Base, Mantle, Linea, opBNB, BSC. +* **Non‑EVM**: Solana, Sui, Aptos, Cosmos SDK chains via Gateway. +* **Storage targets**: BNB Greenfield buckets (for bridged NFT metadata). + +> **Tip —** Check the live list at [wormhole.com/platform/blockchains](https://wormhole.com/platform/blockchains) before initiating a transfer. + +## 4  Prerequisites + +1. **Wallets** + + * MetaMask ≥ v11 for EVM chains. + * Phantom or Solflare for Solana. +2. **Native gas tokens** on **both** source & destination (e.g. MATIC + BNB). +3. **RPC endpoints** that accept large calldata (Gateway RPC recommended for opBNB). + +## 5  Quick‑Start (Portal UI) + +1. Navigate to [https://portalbridge.com](https://portalbridge.com) and click **Connect Wallet**. +2. In the **From** panel select **Polygon PoS**. In **To** pick **BNB Smart Chain**. +3. Choose a supported token (e.g. **USDC**). Enter the amount. +4. The bridge quotes fees & relayer costs; review and approve ERC‑20 spend. +5. Confirm the **Lock** transaction on Polygon. Wait for the Wormhole **VAA** to be signed (≃ 20 s). +6. Switch network → BSC when prompted and sign the **Mint/Redeem** tx. +7. You now hold **USDC (Portal)** on BSC; swap 1:1 to native USDC via PancakeSwap if needed. + +## 6  Example Walkthrough – Migrate 100 USDC from Polygon → BNB Chain + +```text +Step 1 (Polygon) +• Approve 100 USDC spending by Portal TokenBridge. +• Gas: ≈ 0.0008 MATIC (US$ 0.01) + +Step 2 (Polygon) +• Submit Lock tx. Tx hash: 0xabc…def. +• Wait for 2 block confirmations (≈ 5 s). + +Step 3 (Guardian network) +• 19/19 Guardians sign VAA #0x1234. + +Step 4 (BSC) +• Call `completeTransferWithRelay()` using VAA. +• Mint 100 pUSDC (Portal‑wrapped) to your BSC address. +``` + +Screenshot placeholders: + +* `polygon-lock.png` – UI after approving. +* `vaa-signed.png` – Explorer view. +* `bsc-redeem.png` – Final receipt. + +## 7  Programmatic Integration (TypeScript) + +```ts +import { getSignedVAA, transferFromEth } from "@wormhole-foundation/sdk"; + +// Lock 100 USDC on Polygon +const tx = await transferFromEth({ + signer: polygonSigner, + token: usdcAddress, + amount: "100", + destinationChain: "bsc", + destinationAddress: userAddress, +}); + +// Fetch VAA & redeem on BSC +const { vaaBytes } = await getSignedVAA("polygon", tx.sequence); +await redeemOnBsc({ signer: bscSigner, vaa: vaaBytes }); +``` + +## 8  Troubleshooting & FAQs + +| Symptom | Resolution | +| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | +| **VAA pending > 5 min** | Check [https://wormhole.com/explorer](https://wormhole.com/explorer); if Guardians show 18/19 signatures wait, else open ticket. | +| **“Transfer Limit Exceeded”** | Split into smaller chunks; current Portal cap is \~\$2 M per tx. | +| **pUSDC not recognised by dApp** | Add token address `0xb12b...` manually or swap to native USDC on PancakeSwap. | + +## 9  Security & Risk Notes + +* Wormhole contracts on BSC upgraded to **v3.6** after full audit by **Trail of Bits** (Feb 2025). +* Guardian set multi‑sig threshold is 2⁄3 + 1 (currently 15/19). +* Always verify token addresses at [https://portalbridge.com/#/token-list](https://portalbridge.com/#/token-list). + +## 10  Fees & Limits + +* **Bridge fee:** 0.000012 BNB flat (covers Guardian + relayer). +* **Gas:** Variable; < 0.0005 BNB for redemption on BSC. +* **Daily notional cap:** US\$200 M per user. + +## 11  Changelog + +* **2025‑05‑28** – Initial draft. From 90bc32720b6f67047baf169cba76ba772a39fa40 Mon Sep 17 00:00:00 2001 From: 0xlucasliao Date: Wed, 28 May 2025 16:21:36 +0800 Subject: [PATCH 2/8] Update cross-chain-bridge.md --- .../guides/cross-chain-bridge.md | 105 ++++++++++-------- 1 file changed, 58 insertions(+), 47 deletions(-) diff --git a/docs/bnb-smart-chain/guides/cross-chain-bridge.md b/docs/bnb-smart-chain/guides/cross-chain-bridge.md index 2d0a6e1445..af2ec594c6 100644 --- a/docs/bnb-smart-chain/guides/cross-chain-bridge.md +++ b/docs/bnb-smart-chain/guides/cross-chain-bridge.md @@ -2,81 +2,92 @@ title: BNB Chain Bridge – Cross‑Chain Guide --- -## 1  Audience +# BNB Chain Bridge (Wormhole) – Cross-Chain Guide + +> **Status:** Draft · Last updated: 28 May 2025 +> +> **Purpose** – Provide a single, end-to-end reference for bridging fungible tokens and NFTs **to** and **from** BNB Smart Chain (BSC), opBNB and BNB Greenfield using the **BNB Chain Bridge powered by Wormhole**. The guide fills gaps left by individual L2/L3 docs and adds concrete examples of cross-chain token migration. + +> **Official Resource:** Learn more at the [BNB Chain Bridge Portal](https://www.bnbchain.org/en/bnb-chain-bridge) + +--- + +## 1 Audience * **Web3 users** who need a practical walkthrough. * **dApp developers** integrating Wormhole SDK. * **Support teams** resolving bridge issues. -## 2  Key Features & Improvements +## 2 Key Features & Improvements | Feature | Benefit | | -------------------------------------------- | ------------------------------ | | \~30 chains supported via Wormhole Guardians | Large surface for liquidity | | Automatic route discovery & fee quote | UX parity with CEX withdrawals | -| On‑chain proof of lock/mint | Verifiable token accounting | +| On-chain proof of lock/mint | Verifiable token accounting | | Message batching on opBNB | Up to 40% cheaper gas | -## 3  Supported Routes (May 2025) +## 3 Supported Routes (May 2025) -* **EVM chains**: Ethereum, Arbitrum, Optimism, Polygon PoS, Polygon zkEVM, Avalanche C‑Chain, Base, Mantle, Linea, opBNB, BSC. -* **Non‑EVM**: Solana, Sui, Aptos, Cosmos SDK chains via Gateway. -* **Storage targets**: BNB Greenfield buckets (for bridged NFT metadata). +* **EVM chains**: Ethereum, Arbitrum, Optimism, Polygon PoS, Polygon zkEVM, Avalanche C-Chain, Base, Mantle, Linea, opBNB, BSC. +* **Non-EVM**: Solana, Sui, Aptos, Cosmos SDK chains via Gateway. +* **Storage targets**: BNB Greenfield buckets (for bridged NFT metadata). -> **Tip —** Check the live list at [wormhole.com/platform/blockchains](https://wormhole.com/platform/blockchains) before initiating a transfer. +> **Tip —** Check the live list at [wormhole.com/platform/blockchains](https://wormhole.com/platform/blockchains) before initiating a transfer. -## 4  Prerequisites +## 4 Prerequisites 1. **Wallets** - * MetaMask ≥ v11 for EVM chains. + * MetaMask ≥ v11 for EVM chains. * Phantom or Solflare for Solana. -2. **Native gas tokens** on **both** source & destination (e.g. MATIC + BNB). +2. **Native gas tokens** on **both** source & destination chains (e.g. ETH + BNB, or MATIC + BNB). 3. **RPC endpoints** that accept large calldata (Gateway RPC recommended for opBNB). -## 5  Quick‑Start (Portal UI) +## 5 Quick-Start (BNB Chain Bridge UI) -1. Navigate to [https://portalbridge.com](https://portalbridge.com) and click **Connect Wallet**. -2. In the **From** panel select **Polygon PoS**. In **To** pick **BNB Smart Chain**. -3. Choose a supported token (e.g. **USDC**). Enter the amount. -4. The bridge quotes fees & relayer costs; review and approve ERC‑20 spend. -5. Confirm the **Lock** transaction on Polygon. Wait for the Wormhole **VAA** to be signed (≃ 20 s). -6. Switch network → BSC when prompted and sign the **Mint/Redeem** tx. -7. You now hold **USDC (Portal)** on BSC; swap 1:1 to native USDC via PancakeSwap if needed. +1. Navigate to [BNB Chain Bridge](https://www.bnbchain.org/en/bnb-chain-bridge) and click **Launch App**. +2. In the **From** panel, select your **source chain**. In the **To** panel, select **BNB Smart Chain**, **opBNB**, or **BNB Greenfield** as the destination. +3. Connect your wallet on both chains as prompted. +4. Choose the token you wish to bridge and enter the amount. +5. Approve the token for spending if required. +6. Confirm the **Lock** transaction on the source chain. +7. Wait for the transfer to finalize via Wormhole’s Guardian network (usually \~20 seconds). +8. Switch to the destination chain and confirm the **Redeem** transaction to receive the bridged asset. -## 6  Example Walkthrough – Migrate 100 USDC from Polygon → BNB Chain +## 6 Example Walkthrough – Migrate 100 USDC from Any Chain → BNB Chain ```text -Step 1 (Polygon) -• Approve 100 USDC spending by Portal TokenBridge. -• Gas: ≈ 0.0008 MATIC (US$ 0.01) +Step 1 (Source Chain) +• Approve 100 USDC spending by Wormhole TokenBridge. +• Gas: ≈ native token of source chain -Step 2 (Polygon) -• Submit Lock tx. Tx hash: 0xabc…def. -• Wait for 2 block confirmations (≈ 5 s). +Step 2 (Source Chain) +• Submit Lock tx. Tx hash: 0xabc…def. +• Wait for a few block confirmations. -Step 3 (Guardian network) +Step 3 (Guardian network) • 19/19 Guardians sign VAA #0x1234. -Step 4 (BSC) +Step 4 (BNB Chain) • Call `completeTransferWithRelay()` using VAA. -• Mint 100 pUSDC (Portal‑wrapped) to your BSC address. +• Mint 100 pUSDC (Portal-wrapped) to your BNB Chain address. ``` Screenshot placeholders: -* `polygon-lock.png` – UI after approving. +* `source-lock.png` – UI after approving. * `vaa-signed.png` – Explorer view. -* `bsc-redeem.png` – Final receipt. +* `bnb-redeem.png` – Final receipt. -## 7  Programmatic Integration (TypeScript) +## 7 Programmatic Integration (TypeScript) ```ts import { getSignedVAA, transferFromEth } from "@wormhole-foundation/sdk"; -// Lock 100 USDC on Polygon +// Lock 100 USDC on a source EVM chain const tx = await transferFromEth({ - signer: polygonSigner, + signer: sourceSigner, token: usdcAddress, amount: "100", destinationChain: "bsc", @@ -84,30 +95,30 @@ const tx = await transferFromEth({ }); // Fetch VAA & redeem on BSC -const { vaaBytes } = await getSignedVAA("polygon", tx.sequence); +const { vaaBytes } = await getSignedVAA("sourceChain", tx.sequence); await redeemOnBsc({ signer: bscSigner, vaa: vaaBytes }); ``` -## 8  Troubleshooting & FAQs +## 8 Troubleshooting & FAQs | Symptom | Resolution | | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -| **VAA pending > 5 min** | Check [https://wormhole.com/explorer](https://wormhole.com/explorer); if Guardians show 18/19 signatures wait, else open ticket. | -| **“Transfer Limit Exceeded”** | Split into smaller chunks; current Portal cap is \~\$2 M per tx. | +| **VAA pending > 5 min** | Check [https://wormhole.com/explorer](https://wormhole.com/explorer); if Guardians show 18/19 signatures wait, else open ticket. | +| **“Transfer Limit Exceeded”** | Split into smaller chunks; current Portal cap is \~\$2 M per tx. | | **pUSDC not recognised by dApp** | Add token address `0xb12b...` manually or swap to native USDC on PancakeSwap. | -## 9  Security & Risk Notes +## 9 Security & Risk Notes -* Wormhole contracts on BSC upgraded to **v3.6** after full audit by **Trail of Bits** (Feb 2025). -* Guardian set multi‑sig threshold is 2⁄3 + 1 (currently 15/19). +* Wormhole contracts on BSC upgraded to **v3.6** after full audit by **Trail of Bits** (Feb 2025). +* Guardian set multi-sig threshold is 2⁄3 + 1 (currently 15/19). * Always verify token addresses at [https://portalbridge.com/#/token-list](https://portalbridge.com/#/token-list). -## 10  Fees & Limits +## 10 Fees & Limits -* **Bridge fee:** 0.000012 BNB flat (covers Guardian + relayer). -* **Gas:** Variable; < 0.0005 BNB for redemption on BSC. -* **Daily notional cap:** US\$200 M per user. +* **Bridge fee:** 0.000012 BNB flat (covers Guardian + relayer). +* **Gas:** Variable; < 0.0005 BNB for redemption on BSC. +* **Daily notional cap:** US\$200 M per user. -## 11  Changelog +## 11 Changelog -* **2025‑05‑28** – Initial draft. +* **2025-05-28** – Initial draft with generic cross-chain migration example. From dbb52124021b88580698df8b4d7cffc356f1dc89 Mon Sep 17 00:00:00 2001 From: 0xlucasliao Date: Fri, 30 May 2025 15:39:33 +0800 Subject: [PATCH 3/8] Update cross-chain-bridge.md --- .../guides/cross-chain-bridge.md | 142 +++++++----------- 1 file changed, 56 insertions(+), 86 deletions(-) diff --git a/docs/bnb-smart-chain/guides/cross-chain-bridge.md b/docs/bnb-smart-chain/guides/cross-chain-bridge.md index af2ec594c6..bcafa42a62 100644 --- a/docs/bnb-smart-chain/guides/cross-chain-bridge.md +++ b/docs/bnb-smart-chain/guides/cross-chain-bridge.md @@ -2,123 +2,93 @@ title: BNB Chain Bridge – Cross‑Chain Guide --- -# BNB Chain Bridge (Wormhole) – Cross-Chain Guide +# BNB Chain Cross-Chain Bridge Guide > **Status:** Draft · Last updated: 28 May 2025 > -> **Purpose** – Provide a single, end-to-end reference for bridging fungible tokens and NFTs **to** and **from** BNB Smart Chain (BSC), opBNB and BNB Greenfield using the **BNB Chain Bridge powered by Wormhole**. The guide fills gaps left by individual L2/L3 docs and adds concrete examples of cross-chain token migration. +> **Purpose** – Help users and developers understand and make use of the **BNB Chain Bridge** at [bnbchain.org/en/bnb-chain-bridge](https://www.bnbchain.org/en/bnb-chain-bridge). This guide introduces users to cross-chain transfers and shows developers how to integrate the Canonical Bridge widget. -> **Official Resource:** Learn more at the [BNB Chain Bridge Portal](https://www.bnbchain.org/en/bnb-chain-bridge) +> **Official Resource:** [BNB Chain Bridge](https://www.bnbchain.org/en/bnb-chain-bridge) --- -## 1 Audience +## 1 Who Is This Guide For? -* **Web3 users** who need a practical walkthrough. -* **dApp developers** integrating Wormhole SDK. -* **Support teams** resolving bridge issues. +* 🧑‍💻 **Users** who want to transfer tokens in and out of BNB Chain from other chains like **Ethereum** or **Solana**. +* 🛠️ **Developers** who want to integrate a cross-chain bridge widget on their website using BNB Chain's **Canonical Bridge**. -## 2 Key Features & Improvements +## 2 Why This Guide Matters -| Feature | Benefit | -| -------------------------------------------- | ------------------------------ | -| \~30 chains supported via Wormhole Guardians | Large surface for liquidity | -| Automatic route discovery & fee quote | UX parity with CEX withdrawals | -| On-chain proof of lock/mint | Verifiable token accounting | -| Message batching on opBNB | Up to 40% cheaper gas | +Many users don’t realize that cross-chain transfers are possible or easy. BNB Chain offers a bridge aggregator that shows the **best route** for moving assets between chains using one of our **six route providers**: -## 3 Supported Routes (May 2025) +**Supported Route Providers**: -* **EVM chains**: Ethereum, Arbitrum, Optimism, Polygon PoS, Polygon zkEVM, Avalanche C-Chain, Base, Mantle, Linea, opBNB, BSC. -* **Non-EVM**: Solana, Sui, Aptos, Cosmos SDK chains via Gateway. -* **Storage targets**: BNB Greenfield buckets (for bridged NFT metadata). +* Stargate +* Celer +* deBridge +* Meson +* LayerZero +* Mayan (Wormhole) -> **Tip —** Check the live list at [wormhole.com/platform/blockchains](https://wormhole.com/platform/blockchains) before initiating a transfer. +> ✅ We help users **see available routes** for transferring assets **into or out of BNB Chain**, but we **do not operate the routes or control token availability**. -## 4 Prerequisites +## 3 How to Use the BNB Chain Bridge (User Guide) -1. **Wallets** +### Step-by-Step - * MetaMask ≥ v11 for EVM chains. - * Phantom or Solflare for Solana. -2. **Native gas tokens** on **both** source & destination chains (e.g. ETH + BNB, or MATIC + BNB). -3. **RPC endpoints** that accept large calldata (Gateway RPC recommended for opBNB). +1. Visit [bnbchain.org/en/bnb-chain-bridge](https://www.bnbchain.org/en/bnb-chain-bridge) and click **Launch App**. +2. Choose your **source chain** (e.g. Ethereum) and **destination chain** (e.g. BNB Chain). +3. Connect your wallet for each chain. +4. Choose a token to bridge and enter the amount. +5. The bridge tool will display **available routes** based on your token and chains. +6. Approve and confirm the transfer following the provider’s UI. +7. Wait for the transaction to complete. You’ll receive your tokens on the destination chain. -## 5 Quick-Start (BNB Chain Bridge UI) +## 4 Understanding Bridge Aggregation -1. Navigate to [BNB Chain Bridge](https://www.bnbchain.org/en/bnb-chain-bridge) and click **Launch App**. -2. In the **From** panel, select your **source chain**. In the **To** panel, select **BNB Smart Chain**, **opBNB**, or **BNB Greenfield** as the destination. -3. Connect your wallet on both chains as prompted. -4. Choose the token you wish to bridge and enter the amount. -5. Approve the token for spending if required. -6. Confirm the **Lock** transaction on the source chain. -7. Wait for the transfer to finalize via Wormhole’s Guardian network (usually \~20 seconds). -8. Switch to the destination chain and confirm the **Redeem** transaction to receive the bridged asset. +BNB Chain’s bridge tool is an **aggregator**. It finds available routes from partner bridge providers but: -## 6 Example Walkthrough – Migrate 100 USDC from Any Chain → BNB Chain +* ❌ We do not custody tokens. +* ❌ We cannot add tokens ourselves. +* ✅ We simplify access and offer visibility into supported routes. -```text -Step 1 (Source Chain) -• Approve 100 USDC spending by Wormhole TokenBridge. -• Gas: ≈ native token of source chain +You can use the bridge for **all directions** – not just from BNB Chain to others, but also from Ethereum, Solana, and other supported chains **to BNB Chain**. -Step 2 (Source Chain) -• Submit Lock tx. Tx hash: 0xabc…def. -• Wait for a few block confirmations. +## 5 Developer Guide: Integrate the Canonical Bridge Widget -Step 3 (Guardian network) -• 19/19 Guardians sign VAA #0x1234. +To integrate the same aggregator bridge experience in your own dApp or website: -Step 4 (BNB Chain) -• Call `completeTransferWithRelay()` using VAA. -• Mint 100 pUSDC (Portal-wrapped) to your BNB Chain address. -``` +### 📦 Canonical Bridge Repository -Screenshot placeholders: +GitHub: [github.com/bnb-chain/canonical-bridge](https://github.com/bnb-chain/canonical-bridge) -* `source-lock.png` – UI after approving. -* `vaa-signed.png` – Explorer view. -* `bnb-redeem.png` – Final receipt. +### Features -## 7 Programmatic Integration (TypeScript) +* Embed cross-chain bridging into any website. +* Supports the same 6 route providers. +* React component + config options. -```ts -import { getSignedVAA, transferFromEth } from "@wormhole-foundation/sdk"; +### Use Cases -// Lock 100 USDC on a source EVM chain -const tx = await transferFromEth({ - signer: sourceSigner, - token: usdcAddress, - amount: "100", - destinationChain: "bsc", - destinationAddress: userAddress, -}); +* DeFi dApps +* Wallet UIs +* NFT platforms offering cross-chain support -// Fetch VAA & redeem on BSC -const { vaaBytes } = await getSignedVAA("sourceChain", tx.sequence); -await redeemOnBsc({ signer: bscSigner, vaa: vaaBytes }); -``` +## 6 FAQs -## 8 Troubleshooting & FAQs +| Question | Answer | +| --------------------------------------- | --------------------------------------------------------------------------------------- | +| I don’t see my token listed? | Route providers decide which tokens they support. You can contact them directly. | +| Is this a bridge just for BNB Chain? | No — it supports **all chains** connected via our 6 providers. | +| Can I use this from Solana to Ethereum? | Yes, as long as a route provider supports it. | +| Can I embed this bridge in my dApp? | Yes — use the [Canonical Bridge widget](https://github.com/bnb-chain/canonical-bridge). | -| Symptom | Resolution | -| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -| **VAA pending > 5 min** | Check [https://wormhole.com/explorer](https://wormhole.com/explorer); if Guardians show 18/19 signatures wait, else open ticket. | -| **“Transfer Limit Exceeded”** | Split into smaller chunks; current Portal cap is \~\$2 M per tx. | -| **pUSDC not recognised by dApp** | Add token address `0xb12b...` manually or swap to native USDC on PancakeSwap. | +## 7 Final Notes -## 9 Security & Risk Notes +* Users should always verify token addresses and routes. +* For token support, contact the respective bridge provider. +* BNB Chain simplifies access to existing infrastructure — we aggregate, not operate. -* Wormhole contracts on BSC upgraded to **v3.6** after full audit by **Trail of Bits** (Feb 2025). -* Guardian set multi-sig threshold is 2⁄3 + 1 (currently 15/19). -* Always verify token addresses at [https://portalbridge.com/#/token-list](https://portalbridge.com/#/token-list). +## 8 Changelog -## 10 Fees & Limits - -* **Bridge fee:** 0.000012 BNB flat (covers Guardian + relayer). -* **Gas:** Variable; < 0.0005 BNB for redemption on BSC. -* **Daily notional cap:** US\$200 M per user. - -## 11 Changelog - -* **2025-05-28** – Initial draft with generic cross-chain migration example. +* **2025-05-28** – Initial draft of user + developer combined guide. From 1a430ccd825ebfc421d90edc922043be23d3332b Mon Sep 17 00:00:00 2001 From: 0xlucasliao Date: Fri, 30 May 2025 15:44:05 +0800 Subject: [PATCH 4/8] Rename docs/bnb-smart-chain/guides/cross-chain-bridge.md to docs/bnb-smart-chain/cross-chain-bridge.md --- docs/bnb-smart-chain/{guides => }/cross-chain-bridge.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/bnb-smart-chain/{guides => }/cross-chain-bridge.md (100%) diff --git a/docs/bnb-smart-chain/guides/cross-chain-bridge.md b/docs/bnb-smart-chain/cross-chain-bridge.md similarity index 100% rename from docs/bnb-smart-chain/guides/cross-chain-bridge.md rename to docs/bnb-smart-chain/cross-chain-bridge.md From 57b7d43a33231077c17fdc8398db8b94ca4cad9a Mon Sep 17 00:00:00 2001 From: 0xlucasliao Date: Fri, 30 May 2025 15:45:16 +0800 Subject: [PATCH 5/8] Update mkdocs.yml --- mkdocs.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/mkdocs.yml b/mkdocs.yml index a4b59a9cfe..6e6947e5b5 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -139,6 +139,7 @@ nav: - Overview: ./bnb-smart-chain/slashing/overview.md - Slash Rules: ./bnb-smart-chain/slashing/slash-rules.md - Slash Monitor: ./bnb-smart-chain/slashing/monitor.md + - Cross Chain Bridge: ./bnb-smart-chain/cross-chain-bridge.md - FAQ: ./bnb-smart-chain/faq/index.md - opBNB: - opBNB: ./bnb-opbnb/index.md From e71318f073c0fdeaf28b801ad989aac1d516480b Mon Sep 17 00:00:00 2001 From: 0xlucasliao Date: Fri, 30 May 2025 15:46:02 +0800 Subject: [PATCH 6/8] Update cross-chain-bridge.md --- docs/bnb-smart-chain/cross-chain-bridge.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/docs/bnb-smart-chain/cross-chain-bridge.md b/docs/bnb-smart-chain/cross-chain-bridge.md index bcafa42a62..764b4b779d 100644 --- a/docs/bnb-smart-chain/cross-chain-bridge.md +++ b/docs/bnb-smart-chain/cross-chain-bridge.md @@ -5,11 +5,6 @@ title: BNB Chain Bridge – Cross‑Chain Guide # BNB Chain Cross-Chain Bridge Guide > **Status:** Draft · Last updated: 28 May 2025 -> -> **Purpose** – Help users and developers understand and make use of the **BNB Chain Bridge** at [bnbchain.org/en/bnb-chain-bridge](https://www.bnbchain.org/en/bnb-chain-bridge). This guide introduces users to cross-chain transfers and shows developers how to integrate the Canonical Bridge widget. - -> **Official Resource:** [BNB Chain Bridge](https://www.bnbchain.org/en/bnb-chain-bridge) - --- ## 1 Who Is This Guide For? From aa6137aeb9608a9506bef7bcc99120c1f2f1360a Mon Sep 17 00:00:00 2001 From: 0xlucasliao Date: Wed, 4 Jun 2025 15:00:28 +0800 Subject: [PATCH 7/8] Update cross-chain-bridge.md --- docs/bnb-smart-chain/cross-chain-bridge.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/bnb-smart-chain/cross-chain-bridge.md b/docs/bnb-smart-chain/cross-chain-bridge.md index 764b4b779d..51a40cc178 100644 --- a/docs/bnb-smart-chain/cross-chain-bridge.md +++ b/docs/bnb-smart-chain/cross-chain-bridge.md @@ -4,7 +4,7 @@ title: BNB Chain Bridge – Cross‑Chain Guide # BNB Chain Cross-Chain Bridge Guide -> **Status:** Draft · Last updated: 28 May 2025 +> **Status:** Draft · Last updated: 4 Jun 2025 --- ## 1 Who Is This Guide For? From af52938fa402cc7fce48a9d48e38bd0831fcef8a Mon Sep 17 00:00:00 2001 From: Jimmy-Ma-BNBChain <119401228+Jimmy-Ma-BNBChain@users.noreply.github.com> Date: Wed, 4 Jun 2025 15:38:46 +0800 Subject: [PATCH 8/8] Update cross-chain-bridge.md --- docs/bnb-smart-chain/cross-chain-bridge.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/bnb-smart-chain/cross-chain-bridge.md b/docs/bnb-smart-chain/cross-chain-bridge.md index 51a40cc178..423762598b 100644 --- a/docs/bnb-smart-chain/cross-chain-bridge.md +++ b/docs/bnb-smart-chain/cross-chain-bridge.md @@ -23,7 +23,7 @@ Many users don’t realize that cross-chain transfers are possible or easy. BNB * deBridge * Meson * LayerZero -* Mayan (Wormhole) +* Mayan > ✅ We help users **see available routes** for transferring assets **into or out of BNB Chain**, but we **do not operate the routes or control token availability**. @@ -31,12 +31,12 @@ Many users don’t realize that cross-chain transfers are possible or easy. BNB ### Step-by-Step -1. Visit [bnbchain.org/en/bnb-chain-bridge](https://www.bnbchain.org/en/bnb-chain-bridge) and click **Launch App**. +1. Visit [bnbchain.org/en/bnb-chain-bridge](https://www.bnbchain.org/en/bnb-chain-bridge). 2. Choose your **source chain** (e.g. Ethereum) and **destination chain** (e.g. BNB Chain). -3. Connect your wallet for each chain. +3. Connect your wallet to source chain. 4. Choose a token to bridge and enter the amount. 5. The bridge tool will display **available routes** based on your token and chains. -6. Approve and confirm the transfer following the provider’s UI. +6. Click **Send** (or **Approve** if required). 7. Wait for the transaction to complete. You’ll receive your tokens on the destination chain. ## 4 Understanding Bridge Aggregation @@ -62,6 +62,8 @@ GitHub: [github.com/bnb-chain/canonical-bridge](https://github.com/bnb-chain/can * Embed cross-chain bridging into any website. * Supports the same 6 route providers. * React component + config options. +* Supports custom networks, tokens, style. +* Supports other chain to other chain transfer (e.g. Ethereum to Base) ### Use Cases @@ -74,8 +76,8 @@ GitHub: [github.com/bnb-chain/canonical-bridge](https://github.com/bnb-chain/can | Question | Answer | | --------------------------------------- | --------------------------------------------------------------------------------------- | | I don’t see my token listed? | Route providers decide which tokens they support. You can contact them directly. | -| Is this a bridge just for BNB Chain? | No — it supports **all chains** connected via our 6 providers. | -| Can I use this from Solana to Ethereum? | Yes, as long as a route provider supports it. | +| Is this a bridge just for BNB Chain? | No — it supports **all chains** connected via our 6 providers. | +| Can I use this from Solana to Ethereum? | Yes, as long as a route provider supports it. (Only available in Canonical Bridge Widget) | | Can I embed this bridge in my dApp? | Yes — use the [Canonical Bridge widget](https://github.com/bnb-chain/canonical-bridge). | ## 7 Final Notes