Skip to main content
The MUSD bridge enables transfers between Mezo and Ethereum networks using Wormhole’s Native Token Transfer (NTT) protocol. This bridge maintains token fungibility while providing secure cross-chain functionality.

​
How It Works

The MUSD bridge uses Wormhole’s Native Token Transfer protocol to facilitate cross-chain transfers:
  • From Mezo to Ethereum: MUSD tokens are locked on Mezo and the equivalent tokens are minted on Ethereum
  • From Ethereum to Mezo: MUSD tokens are burned on Ethereum and equivalent tokens are unlocked on Mezo
This mechanism ensures that the total supply across both chains remains constant while allowing users to move their tokens freely between networks.

​
Using the Portal UI

The easiest way to bridge MUSD tokens is through the Portal UI:
1

Connect Your Wallet

Connect your wallet to the Portal interface. Make sure you have the network you’re bridging from set as your active network.
2

Select Source and Destination Chains

Choose either Mezo → Ethereum or Ethereum → Mezo depending on which direction you want to bridge.
3

Choose MUSD Token

Select MUSD as the token to bridge. The Portal will automatically detect your MUSD balance.
4

Enter Amount

Enter the amount of MUSD you want to bridge. Make sure to leave enough for gas fees on the source chain.
5

Review Transaction Details

Review the transaction details including:
  • Bridge fees
  • Estimated transfer time
  • Destination address
  • Total amount to receive
6

Confirm Transaction

Confirm the transaction in your wallet. You’ll need to approve the MUSD spend first, then confirm the bridge transaction.
7

Wait for Confirmation

Wait for confirmation on both chains. The Portal UI will show you the progress of your transfer. This typically takes a few minutes.
The Portal UI provides a user-friendly interface that handles all the complex interactions with the underlying NTT contracts.

​
Smart Contracts

The MUSD bridge is powered by the following smart contracts:

​
Mezo Network

​
Ethereum Network

Always verify you’re interacting with the correct contract addresses. The addresses above are the official MUSD bridge contracts.

​
Bridge Security

The MUSD bridge leverages Wormhole’s proven security model:
  • Decentralized Guardian Network: 19 guardians validate cross-chain messages
  • Lock and Mint Mechanism: Ensures total supply remains constant
  • Audited Smart Contracts: All contracts have been audited by leading security firms
  • Real-time Monitoring: Bridge activity is monitored 24/7

​
Troubleshooting

Bridge transfers typically take 2-5 minutes. If your tokens haven’t arrived after 10 minutes:
  1. Check the transaction status on the Portal UI
  2. Verify the transaction was confirmed on the source chain
  3. Check if you need to manually claim on the destination chain (rare)
If your bridge transaction failed:
  1. Ensure you have enough gas on the source chain
  2. Check that you approved the MUSD spend
  3. Verify you’re connected to the correct network
  4. Try again with a higher gas price if network is congested
Make sure your wallet is set to:
  • Mezo Mainnet when bridging from Mezo
  • Ethereum Mainnet when bridging from Ethereum
The Portal may prompt you to switch networks automatically.

​
Additional Resources