# 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

{% stepper %}
{% step %}
**Access Relay Bridge**

Navigate to [relay.link/bridge](https://relay.link/bridge) in your web browser.
{% endstep %}

{% step %}
**Connect Your Wallet**

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

{% step %}
**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>
{% endstep %}

{% step %}
**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>
{% endstep %}

{% step %}
**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
  {% endstep %}

{% step %}
**Verify Completion**

Check your wallet balance on the destination chain. Relay provides real-time status updates during the bridging process.
{% endstep %}
{% endstepper %}

## Using Stargate Finance

{% stepper %}
{% step %}
**Access Stargate Bridge**

Visit [stargate.finance](https://stargate.finance/) and click "Bridge" or "Transfer".
{% endstep %}

{% step %}
**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)
  {% endstep %}

{% step %}
**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%)
  {% endstep %}

{% step %}
**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
  {% endstep %}

{% step %}
**Execute Transfer**

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

{% step %}
**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
  {% endstep %}
  {% endstepper %}

## Troubleshooting Common Issues

#### Transaction Stuck or Pending

**Symptoms**: Bridge transaction shows "pending" for extended period

{% stepper %}
{% step %}
Check Network Status: Verify source and destination chain health
{% endstep %}

{% step %}
Gas Price Issues: Increase gas price if transaction is stuck
{% endstep %}

{% step %}
Bridge Congestion: Wait for network congestion to clear
{% endstep %}

{% step %}
Contact Support: Reach out to bridge support with transaction hash
{% endstep %}
{% endstepper %}

#### Insufficient Liquidity

**Symptoms**: Bridge shows "insufficient liquidity" error

{% stepper %}
{% step %}
Reduce Amount: Try bridging smaller amounts
{% endstep %}

{% step %}
Wait for Rebalancing: Liquidity pools rebalance automatically
{% endstep %}

{% step %}
Alternative Routes: Use different bridge or route
{% endstep %}

{% step %}
Split Transactions: Break large transfers into smaller ones
{% endstep %}
{% endstepper %}

#### Wrong Network or Address

**Symptoms**: Tokens didn't arrive at expected destination

{% stepper %}
{% step %}
Verify Network: Ensure correct destination network selected
{% endstep %}

{% step %}
Check Address: Confirm recipient address accuracy
{% endstep %}

{% step %}
Network Switch: Switch wallet to destination network
{% endstep %}

{% step %}
Recovery Process: Contact bridge support for recovery options
{% endstep %}
{% endstepper %}

#### High Fees or Slippage

**Symptoms**: Unexpected high costs or poor exchange rates

{% stepper %}
{% step %}
Timing: Bridge during low network congestion periods
{% endstep %}

{% step %}
Route Optimization: Compare different bridge options
{% endstep %}

{% step %}
Amount Adjustment: Larger amounts often have better rates
{% endstep %}

{% step %}
Alternative Bridges: Consider other bridge providers
{% endstep %}
{% endstepper %}

## Verification And Testing

#### Test Bridge Functionality

{% stepper %}
{% step %}
Connect wallet to both source and destination networks
{% endstep %}

{% step %}
Bridge small test amount
{% endstep %}

{% step %}
Verify tokens arrive within expected timeframe
{% endstep %}

{% step %}
Check token balances on both chains
{% endstep %}

{% step %}
Test bridge interface responsiveness
{% endstep %}
{% endstepper %}

#### Confirm Successful Bridge

{% stepper %}
{% step %}
Source Chain: Confirm tokens debited from source wallet
{% endstep %}

{% step %}
Bridge Status: Check bridge interface for completion status
{% endstep %}

{% step %}
Destination Chain: Verify tokens credited to destination wallet
{% endstep %}

{% step %}
Balance Check: Ensure correct amounts received
{% endstep %}
{% endstepper %}

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.somnia.network/get-started/bridging-info.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
