bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 54쪽 중 1쪽
# Introduction
<figure><img src="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2FrzswW4CNfFCzYUPBu56O%2FIntroduction%20main%20image.png?alt=media&token=b7f6a0bb-2972-496d-9038-61063bb4892d" alt=""><figcaption></figcaption></figure>
Somnia is a high-performance, cost-efficient EVM-compatible Layer 1 blockchain capable of processing over 1,000,000 transactions per second (TPS) with sub-second finality. It is suitable for serving millions of users and building real-time mass-consumer applications like games, social applications, metaverses, and more, all fully on-chain.
{% hint style="success" %}
Somnia Mainnet is LIVE. Visit the [Network Information Page](/developer/network-info#network-details) for Network details.
{% endhint %}
{% hint style="success" %}
**Developers who are deploying Smart Contracts and need Somnia Test Tokens (STT):**\
\
Please join the [Discord](https://discord.com/invite/somnia). Go to the `#dev-chat` channel, tag the Somnia DevRel, `@emreyeth` and request Test Tokens.\
\
You can also join the [Somnia Developer Telegram](https://t.me/+s_oRMnGpOyQ3ODQ0) or use [Faucet](https://testnet.somnia.network/).\
\
You can also email `developers@somnia.foundation` with a brief description of what you are building and your GitHub profile.
{% endhint %}
Somnia is supported by [Improbable](https://www.improbable.io/) and [MSquared](https://msquared.io/). Improbable will develop some of the key technical components of Somnia, including the Blockchain, but the project will require a large and active community to fulfill its vision.
<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Learn more about Somnia</td><td></td><td></td><td><a href="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2FzYxxgtta1koXhzTerxK1%2Fimage.png?alt=media&token=0c9a662e-482d-499d-a56a-9f27b5395abf">image.png</a></td><td><a href="/concepts/litepaper/somnia-mission">Somnia-Mission</a></td></tr><tr><td>Start developing on Somnia</td><td></td><td></td><td><a href="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2FrFIUAMKWVc90eYq6GrTY%2Fimage%20(1).png?alt=media&token=1c811da0-640f-4d28-a0c2-77a111dc2e2f">image (1).png</a></td><td><a href="/developer/network-info">Network Info</a></td></tr><tr><td>Connect To Mainnet</td><td></td><td></td><td><a href="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2F0Y2WHxwndjOc5X53tnOy%2Fimage%20(2).png?alt=media&token=be257580-6460-4057-90e5-c3c32398efa8">image (2).png</a></td><td><a href="/get-started/connect-your-wallet-to-mainnet">Connect Your Wallet To Mainnet</a></td></tr></tbody></table>
<br>
# Getting Started for Mainnet
## Get SOMI Tokens
Developers and Non-Developers can purchase SOMI Tokens for interacting on Mainnet from the list of exchanges below:
| [Binance](https://www.binance.com/en/trade/SOMI_USDT) | [Bybit](https://www.bybit.com/en/trade/spot/SOMI/USDT) |
| ----------------------------------------------------- | ----------------------------------------------------------------- |
| [Gate.io](https://www.gate.com/price/somnia-somi) | [BitMart](https://www.bitmart.com/en-US/trade/SOMI_USDT?r=PjkAFy) |
| [Bitget](https://www.bitgetapp.com/price/somnia) | [BingX](https://bingx.com/en/spot/SOMIUSDT?ch=cgk_organic) |
## Bridge to Somnia
To have SOMI directly on the mainnet:\
**Relay:** <https://relay.link/bridge/somnia>\
\
To bridge stablecoins from other Networks to Somnia:\
**LayerZero's STARGATE:** <https://stargate.finance/bridge>\
**Orbiter Finance:** [https://www.orbiter.finance/trade/Somnia](https://www.orbiter.finance/trade/Somnia?from=0x28bec7e30e6faee657a03e19bf1128aad7632a00)\
\
Welcome to Somnia Mainnet. Below is a checklist for you to confirm the migration from Testnet to Mainnet.
## For Non-Developers
* [x] Ensure that you have added the Somnia Mainnet Network to your Wallet. You can use [ChainList](https://chainlist.org/?search=somnia).
* [x] Get/bridge SOMI from a list of Exchanges/Bridges.
## For Developers
Conduct the same checks as non-developers, and in addition, the following.
* [x] Add Somnia to the list of Networks in your configuration files for your Smart Contracts
* [x] Using Hardhat:
```javascript
module.exports = {
// ...
networks: {
somnia: {
url: "https://api.infra.mainnet.somnia.network",
accounts: ["0xPRIVATE_KEY"], // put dev menomonic or PK here,
},
},
// ...
};
```
* [x] Using Forge Deployment:
```bash
forge create --rpc-url https://api.infra.mainnet.somnia.network --private-key PRIVATE_KEY src/Example.sol:Example
```
* [x] See the Page for the list of infrastructure and Dev Tooling available to you on Somnia.
# Connect Your Wallet To Mainnet
{% hint style="success" %}
Somnia Mainnet is LIVE. Visit the [Network Information Page](/developer/network-info#network-details) for Network details.
{% endhint %}
1. You can create your [MetaMask Wallet ](https://support.metamask.io/getting-started/getting-started-with-metamask/)from here. If you already have a wallet you may skip this step
2. Visit [Chainlist](https://chainlist.org/?search=somnia) and Click on "Connect Wallet":
3. You may use any desired wallet or Metamask (preferred)
<div align="left"><figure><img src="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2FPyMkUXPn4SZv1SWBoMe8%2FScreenshot%202024-11-14%20at%204.45.00%E2%80%AFPM.png?alt=media&token=90bda0aa-2e05-4e57-926d-0ffa5bd53fc1" alt="" width="369"><figcaption></figcaption></figure></div>
4. Click on "Add to Metamask" to add Somnia Mainnet to your wallet.<br>
<figure><img src="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2FrjbETkItjKmIW38TNAT0%2Fimage.png?alt=media&token=3a3cba77-057e-459c-a75b-9263f730dac4" alt="" width="375"><figcaption></figcaption></figure>
# 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&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&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.)\
{% 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&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.*
# Removing the Somnia Devnet Network
If you used the Somnia Devnet you may get some issues adding the testnet to your wallet. You will first need to remove the Devnet.
To do this open the networks on metamask:<br>
<figure><img src="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2F0AP6sHSKKPQnXB6PKU7W%2Fimage.png?alt=media&token=407d2f13-d985-48f6-af1f-6a4c96efd640" alt="" width="515"><figcaption><p>Drop down button on the top left of Metamask</p></figcaption></figure>
Then click the three dots next to the network and click delete:
<figure><img src="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2FoO2xHLnUOUyggH1dfryB%2Fimage.png?alt=media&token=8590916a-edcd-423f-b66f-9738bfd06e28" alt=""><figcaption></figcaption></figure>
This will remove the Devnet from you networks. You now should be able to add the Testnet!
# Update the block explorer in metamask
You may find that metamask has defaulted to using an incorrect block explorer. You will notice this when you click on view on block explorer in metamask you get a page like this:<br>
<figure><img src="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2FVS2Cr4UyBSW1IfXANpIy%2Fimage.png?alt=media&token=3cfa8553-c45d-4eef-831d-60fe86211d3f" alt=""><figcaption></figcaption></figure>
To fix this you need to update the block explorer in your metamask config for the Somnia devnet. First open metamask.\ <br>
<figure><img src="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2FIYs3u8yzTzYSduuwasGH%2Fimage.png?alt=media&token=50e12b70-41ee-4db0-bf01-ab9cd4230ca1" alt=""><figcaption></figcaption></figure>
Now click on the network in the top right this will bring down the select network windoScroll to the Somnia Testnet and click the 3 dots to open the config.
<figure><img src="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2FuVwsmj0x9gUVjULJE7fJ%2Fimage.png?alt=media&token=55324afc-b10b-4c9d-8f0f-dc6facc204a2" alt=""><figcaption></figcaption></figure>
Here click on the down arrow on the block explorer URL and click add block explorer URL<br>
<figure><img src="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2Fyy29zENSoEzkYtHOwpJK%2FBlock-Explorer.png?alt=media&token=eb13a7cc-2905-42da-90fb-25e5ee8ff4b5" alt="" width="480"><figcaption></figcaption></figure>
In the URL box type: <https://shannon-explorer.somnia.network/>
It will now default to using the somnia-devnet block explorer. You can check this by viewing a transaction on the block explorer
<figure><img src="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2F4QCNR3WWW6qnaDYmKMt3%2Fimage.png?alt=media&token=06721880-8320-4bf3-bef1-02d58693fc08" alt=""><figcaption></figcaption></figure>
It should look like this:
<figure><img src="https://2122549367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkYErT9t3BJtpPfejLO6I%2Fuploads%2FHLOHsHl0Nn530m23aHMY%2Fimage.png?alt=media&token=35eac1e5-430b-4b27-85d1-3a95e266698c" alt=""><figcaption></figcaption></figure>
Have fun exploring the Testnet!
# Network Info
{% hint style="success" %}
**The Somnia Mainnet is LIVE**
{% endhint %}
{% hint style="info" %}
**Developers who deploy Smart Contracts on Mainnet require Somnia Tokens, SOMI.** It is a real-world utility token that can be purchased on a list of CEXs and DEXs [here](/get-started/getting-started-for-mainnet#get-somi-tokens).
{% endhint %}
{% hint style="success" %}
**Developers who are deploying Smart Contracts and need Somnia Test Tokens (STT):**\
\
Please join the [Discord](https://discord.com/invite/somnia). Go to the `#dev-chat` channel, tag the Somnia DevRel, `@emreyeth` and request Test Tokens.\
\
You can also join the [Somnia Developer Telegram](https://t.me/+s_oRMnGpOyQ3ODQ0) or use [Faucet](https://testnet.somnia.network/).\
\
You can also email `developers@somnia.foundation` with a brief description of what you are building and your GitHub profile.
{% endhint %}
<table><thead><tr><th width="304.841796875">Network</th><th>Mainnet</th><th>Testnet</th></tr></thead><tbody><tr><td>Chain ID</td><td>5031</td><td>50312</td></tr><tr><td>Block Explorer</td><td><a href="https://explorer.so프로젝트로 돌아가기
