Bridging Info

Somnia supports cross-chain asset transfers through two official bridge partners: Relay and Stargate Finance. These bridges enable you to move tokens between Somnia and other blockchain networks while maintaining security and minimizing fees. Whether you're bridging stablecoins, ETH, or other supported assets, this guide will walk you through the complete process.

Prerequisites

• Wallet Setup: MetaMask, WalletConnect-compatible wallet, or hardware wallet
• Network Configuration: Somnia network added to your wallet
• Funded Wallet: Source chain tokens to cover bridge fees and gas costs
• Basic Understanding: Familiarity with blockchain transactions and gas fees

Supported Bridges

Relay Bridge

Relay is a multichain payments network that has served 5M+ users and processed $5B+ in volume across 85+ networks. It offers instant cross-chain transactions with 99.9% uptime and payments-grade reliability.

Key Features:

• Instant Execution: Cross-chain transfers in 1-10 seconds
• 75+ Networks: Extensive blockchain support including Somnia
• Predictable Fees: Transparent fee structure with no hidden costs
• Enterprise Grade: 99.9% uptime with automatic redundancy systems

Supported Assets: ETH, USDC, USDT, and other major tokens
Website: relay.link/bridge

Stargate Finance

Stargate is a fully composable cross-chain bridge built on LayerZero that connects 50+ blockchains. It's the first bridge to solve the "bridging trilemma" by providing instant guaranteed finality, native assets, and unified liquidity.

Key Features:

• Native Assets: Transfer native tokens without wrapped intermediates
• Instant Finality: Guaranteed transaction completion
• Unified Liquidity: Shared liquidity pools across all chains
• LayerZero Powered: Built on robust omnichain infrastructure

Supported Assets: USDC, USDT, ETH, BTC, and LayerZero OFTs
Website: stargate.finance

Using Relay Bridge

Access Relay Bridge

Navigate to relay.link/bridge in your web browser.

Connect Your Wallet

Click "Connect Wallet" and select your preferred wallet provider. Approve the connection when prompted.

Configure Bridge Transaction

• Source Chain: Select the blockchain you're bridging FROM
• Destination Chain: Select Somnia (or your target chain)
• Token: Choose the asset you want to bridge
• Amount: Enter the amount to transfer

Review Transaction Details

Carefully review:

• Bridge Fee: Relay's service fee
• Gas Fee: Network transaction cost
• Estimated Time: Usually 1-10 seconds
• Recipient Address: Verify destination address(Your address or if you want to bridge to a different wallet.

Execute Bridge Transaction

Click "Bridge" and confirm the transaction in your wallet. The process typically involves:

• Approval Transaction: Authorize Relay to spend your tokens (if required)
• Bridge Transaction: Execute the cross-chain transfer
• Confirmation: Receive tokens on destination chain

Verify Completion

Check your wallet balance on the destination chain. Relay provides real-time status updates during the bridging process.

Using Stargate Finance

Access Stargate Bridge

Visit stargate.finance and click "Bridge" or "Transfer".

Connect Wallet & Select Networks

Connect your wallet and configure:

• From: Source blockchain
• To: Somnia (or destination chain)
• Asset: Select supported token (USDC, USDT, ETH, etc.)
  

Enter Transfer Details

• Amount: Specify transfer amount
• Recipient: Destination wallet address (defaults to your connected wallet)

Only applicable if you are bridging to another wallet address.\

• Slippage: Set acceptable slippage tolerance (usually 0.1-0.5%)

Review Pool Information

Stargate displays:

• Available Liquidity: Pool depth on destination chain
• Bridge Fee: Protocol fee structure
• Gas Estimate: Transaction costs
• Route: Cross-chain path details

Execute Transfer

Confirm transaction details and sign with your wallet. 3 Stargate's ΔBridge technology ensures native asset delivery without wrapped tokens.

Monitor Transaction

Track your transfer through:

• Stargate Interface: Real-time status updates
• LayerZero Scan: Cross-chain transaction explorer
• Destination Explorer: Confirm arrival on target chain

Troubleshooting Common Issues

Transaction Stuck or Pending

Symptoms: Bridge transaction shows "pending" for extended period

Check Network Status: Verify source and destination chain health

Gas Price Issues: Increase gas price if transaction is stuck

Bridge Congestion: Wait for network congestion to clear

Contact Support: Reach out to bridge support with transaction hash

Insufficient Liquidity

Symptoms: Bridge shows "insufficient liquidity" error

Reduce Amount: Try bridging smaller amounts

Wait for Rebalancing: Liquidity pools rebalance automatically

Alternative Routes: Use different bridge or route

Split Transactions: Break large transfers into smaller ones

Wrong Network or Address

Symptoms: Tokens didn't arrive at expected destination

Verify Network: Ensure correct destination network selected

Check Address: Confirm recipient address accuracy

Network Switch: Switch wallet to destination network

Recovery Process: Contact bridge support for recovery options

High Fees or Slippage

Symptoms: Unexpected high costs or poor exchange rates

Timing: Bridge during low network congestion periods

Route Optimization: Compare different bridge options

Amount Adjustment: Larger amounts often have better rates

Alternative Bridges: Consider other bridge providers

Verification And Testing

Test Bridge Functionality

Connect wallet to both source and destination networks

Bridge small test amount

Verify tokens arrive within expected timeframe

Check token balances on both chains

Test bridge interface responsiveness

Confirm Successful Bridge

Source Chain: Confirm tokens debited from source wallet

Bridge Status: Check bridge interface for completion status

Destination Chain: Verify tokens credited to destination wallet

Balance Check: Ensure correct amounts received

You've successfully learned how to bridge assets to and from Somnia using both Relay and Stargate Finance. These official bridge partners provide secure, fast, and reliable cross-chain transfers with different strengths:

• Relay: Best for fast payments and swaps across 75+ networks
• Stargate: Ideal for DeFi composability with native asset transfers

Both bridges support Somnia's high-performance infrastructure, enabling seamless integration with the broader multi-chain ecosystem.

For technical support, contact the respective bridge providers or Somnia community channels.