# 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](https://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](https://stargate.finance/)

## Using Relay Bridge

**Access Relay Bridge**

Navigate to [relay.link/bridge](https://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

<figure><img src="https://427512505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44oX5XEgjsIITRWz2fbP%2Fuploads%2FyIjtTD8dvQhEhYEbFPqp%2Fimage.png?alt=media&#x26;token=f2c31757-9ecf-459f-a371-6b063fbbc3b3" alt=""><figcaption></figcaption></figure>

**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.

<figure><img src="https://427512505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44oX5XEgjsIITRWz2fbP%2Fuploads%2FEfq6xft1t9ubbmoPPLuJ%2Fimage.png?alt=media&#x26;token=aa572d53-89ff-4d29-8343-0f316d5d1527" alt=""><figcaption></figcaption></figure>

**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](https://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.)\
  ![](https://427512505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44oX5XEgjsIITRWz2fbP%2Fuploads%2FKvmRGu0fGzpMlWzyPlGN%2Fimage.png?alt=media\&token=66a534cd-1453-4b19-ac43-5076c86b1ec9)

**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.\\

<figure><img src="https://427512505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44oX5XEgjsIITRWz2fbP%2Fuploads%2FIYzm4EewTNtH3zUaNNOp%2Fimage.png?alt=media&#x26;token=625f507b-5583-4a90-bc24-2382ec10c39e" alt=""><figcaption></figcaption></figure>

* 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](https://layerzeroscan.com/)
* 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._

---

Every page is also Markdown: append `.md` to its URL, or ask for `text/markdown`. Found something wrong, missing or confusing in these docs? Tell us: `POST /api/feedback` on this site with JSON `{"message": "…", "context": "what you were doing and what happened", "page": "…"}`, or a plain-text body. `GET /api/feedback` gives the JSON Schema. The team reads every one.
