MEZO bridge

astro.config.mjs

@@ -183,6 +183,13 @@ export default defineConfig({
                               'docs/users/musd/concepts'
                         ]
                   },
+                  {
+                        label: 'MEZO',
+                        collapsed: true,
+                        items: [
+                              'docs/users/mezo/mezo-bridge'
+                        ]
+                  },
                   {
                         label: 'Mezo Earn',
                         collapsed: true,

src/content/docs/docs/users/mezo/mezo-bridge.mdx

@@ -0,0 +1,112 @@
+---
+title: MEZO Bridge
+description: >-
+  Learn how to bridge MEZO tokens between Mezo and other networks (Ethereum,
+  Base, BSC, Solana) using Wormhole's Native Token Transfer protocol.
+topic: users
+---
+
+import { Steps } from '@astrojs/starlight/components';
+
+The MEZO bridge enables transfers between Mezo and multiple networks including Ethereum, Base, BSC, and Solana using Wormhole's Native Token Transfer (NTT) protocol. This bridge maintains token fungibility while providing secure cross-chain functionality.
+
+## How it Works
+
+The MEZO bridge uses Wormhole's Native Token Transfer protocol to facilitate cross-chain transfers:
+
+- **From Mezo to other chains**: MEZO tokens are locked on Mezo and the equivalent tokens are minted on the destination chain (Ethereum, Base, BSC, or Solana)
+- **From other chains to Mezo**: MEZO tokens are burned on the source chain and equivalent tokens are unlocked on Mezo
+
+This mechanism ensures that the total supply across all chains remains constant while allowing users to move their tokens freely between networks.
+
+## Bridge Options
+
+There are two user interfaces available for bridging MEZO tokens:
+
+### Mezo dApp
+
+The [Mezo dApp](https://mezo.org) provides a native bridging experience for transferring MEZO tokens between Mezo and Ethereum networks only.
+
+**To bridge from Mezo to Ethereum (Withdraw):**
+
+<Steps>
+1. **Connect your wallet** to the Mezo dApp
+
+2. **Click "Withdraw"** to bridge tokens from Mezo
+
+3. **Select MEZO token** and enter the amount to withdraw
+
+4. **Confirm the transaction** in your wallet
+
+5. **Wait for confirmation** on both chains
+</Steps>
+
+**To bridge from Ethereum to Mezo (Deposit):**
+
+<Steps>
+1. **Connect your wallet** to the Mezo dApp
+
+2. **Click "Deposit"** to bridge tokens to Mezo
+
+3. **Select MEZO token** and enter the amount to deposit
+
+4. **Confirm the transaction** in your wallet
+
+5. **Wait for confirmation** on both chains
+</Steps>
+
+### Wormhole Portal Bridge UI
+
+For bridging MEZO tokens to Base, BSC, Solana or Ethereum use the [Portal UI](https://portalbridge.com/):
+
+<Steps>
+1. **Connect your wallet** to the Portal interface
+
+2. **Select source and destination chains** (Mezo ↔ Ethereum, Base, BSC, or Solana)
+
+3. **Choose MEZO** as the token to bridge
+
+4. **Enter the amount** you want to bridge
+
+5. **Review transaction details** including fees and estimated time
+
+6. **Confirm the transaction** in your wallet
+
+7. **Wait for confirmation** on both chains
+</Steps>
+
+Both interfaces provide user-friendly experiences that handle all the complex interactions with the underlying NTT contracts.
+
+## Smart Contracts
+
+The MEZO bridge is powered by the following smart contracts:
+
+### Mezo Network
+- **MEZO Token**: [0x7B7c000000000000000000000000000000000001](https://explorer.mezo.org/token/0x7B7c000000000000000000000000000000000001)
+- **NTT Manager**: [0x5E668D912F69db0762CD0fE00647dA9fa6b29591](https://explorer.mezo.org/address/0x5E668D912F69db0762CD0fE00647dA9fa6b29591)
+- **Wormhole Transceiver**: [0x528edf2dBbC6Ae6978c88E54B260AB86B682D18c](https://explorer.mezo.org/address/0x528edf2dBbC6Ae6978c88E54B260AB86B682D18c)
+
+### Ethereum Network
+- **MEZO Token**: [0x8e4cbBcc33dB6c0a18561fDE1F6bA35906d4848b](https://etherscan.io/address/0x8e4cbBcc33dB6c0a18561fDE1F6bA35906d4848b)
+- **NTT Manager**: [0x13916D0daB357DCBAa1600b594d62C641840686A](https://etherscan.io/address/0x13916D0daB357DCBAa1600b594d62C641840686A)
+- **Wormhole Transceiver**: [0x920871aF2D4106E76d204fEA7122fA129C9283b1](https://etherscan.io/address/0x920871aF2D4106E76d204fEA7122fA129C9283b1)
+
+### Base Network
+- **MEZO Token**: [0x8e4cbBcc33dB6c0a18561fDE1F6bA35906d4848b](https://basescan.org/address/0x8e4cbBcc33dB6c0a18561fDE1F6bA35906d4848b)
+- **NTT Manager**: [0x0c46f496C410465975a427e34a976fc15a2edE4f](https://basescan.org/address/0x0c46f496C410465975a427e34a976fc15a2edE4f)
+- **Wormhole Transceiver**: [0x27321f84704a599aB740281E285cc4463d89A3D5](https://basescan.org/address/0x27321f84704a599aB740281E285cc4463d89A3D5)
+
+### BSC Network
+- **MEZO Token**: [0x8e4cbBcc33dB6c0a18561fDE1F6bA35906d4848b](https://bscscan.com/address/0x8e4cbBcc33dB6c0a18561fDE1F6bA35906d4848b)
+- **NTT Manager**: [0x09959798B95d00a3183d20FaC298E4594E599eab](https://bscscan.com/address/0x09959798B95d00a3183d20FaC298E4594E599eab)
+- **Wormhole Transceiver**: [0xa10aD2570ea7b93d19fDae6Bd7189fF4929Bc747](https://bscscan.com/address/0xa10aD2570ea7b93d19fDae6Bd7189fF4929Bc747)
+
+### Solana Network
+- **MEZO Token**: [8niMFW4yuv3vLoqTtBaC6rchyasmUhgvpgSyPEeeCrw6](https://solscan.io/address/8niMFW4yuv3vLoqTtBaC6rchyasmUhgvpgSyPEeeCrw6)
+- **NTT Manager**: [Ntt4AnEASZ9oLw25PTmXFrwSFD473ufd3rCLWoX5Gg7](https://solscan.io/address/Ntt4AnEASZ9oLw25PTmXFrwSFD473ufd3rCLWoX5Gg7)
+- **Wormhole Transceiver**: [6aVRLvdjgrovCiZa5q5kifUtvD6p2ogaQ2J248MpfCa3](https://solscan.io/address/6aVRLvdjgrovCiZa5q5kifUtvD6p2ogaQ2J248MpfCa3)
+
+## Additional Resources
+
+- [Wormhole NTT Documentation](https://wormhole.com/docs/products/native-token-transfers/overview/) - Learn more about the Native Token Transfer protocol
+- [Portal Bridge](https://portalbridge.com/) - The official UI for bridging tokens

src/content/docs/docs/users/musd/musd-bridge.mdx

@@ -59,4 +59,3 @@ The MUSD bridge is powered by the following smart contracts:
 
 - [Wormhole NTT Documentation](https://wormhole.com/docs/products/native-token-transfers/overview/) - Learn more about the Native Token Transfer protocol
 - [Portal Bridge](https://portalbridge.com/) - The official UI for bridging tokens
-- [Contracts Reference](../../resources/contracts-reference.md) - Complete list of all protocol contracts