Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
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.
Somnia Mainnet is LIVE. Visit the Network Information Page for Network details.
Developers who are deploying Smart Contracts and need Somnia Test Tokens, STT. Please join the .
Go to the #dev-chat channel, tag the Somnia DevRel, @emma_odiaand request Test Tokens.
You can also email [email protected] with a brief description of what you are building and your GitHub profile.
Somnia is supported by and . 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.
Developers and Non-Developers can purchase SOMI Tokens for interacting on Mainnet from the list of exchanges below:
Quickswap
Developers and Non-Developers can also Bridge their Stablecoins from other Networks to Somnia using LayerZero's STARGATE: Welcome to Somnia Mainnet. Below is a checklist for you to confirm the Migration from Testnet to Mainnet.
Conduct the same checks as non-developers, and in addition, the following.
module.exports = {
// ...
networks: {
somnia: {
url: "https://api.infra.mainnet.somnia.network",
accounts: ["0xPRIVATE_KEY"], // put dev menomonic or PK here,
},
},
// ...
};forge create --rpc-url https://api.infra.mainnet.somnia.network --private-key PRIVATE_KEY src/Example.sol:ExampleThe Somnia Testnet is meant for developers to build and deploy the first versions of their applications, and there may be bugs. Any issues, please: Share your feedback at [email protected]
Or raise them in our Discord
To Proceed with this step, you should connect your wallet with Somnia Testnet
To Request for Somnia Testnet Token, Click on Get STT Tokens button.
Developers who are deploying Smart Contracts and need Somnia Test Tokens, STT. Please join the .
Go to the #dev-chat channel, tag the Somnia DevRel, @emma_odiaand request Test Tokens.
You can also email [email protected] with a brief description of what you are building and your GitHub profile.
Click on "Get STT"
You should have it in your wallet
You can Select Somnia Testnet and See your tokens
Click on Send Tokens
Send STT tokens to your Desired Wallet address or a random address
Check our Activity Section in Metamask
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.
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
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 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
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
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
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
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
Connect wallet to both source and destination networks
Bridge small test amount (e.g., $10-50)
Verify tokens arrive within expected timeframe
Check token balances on both chains
Test bridge interface responsiveness
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.
Somnia Mainnet is LIVE. Visit the for Network details.
Share your feedback at [email protected]
Token: Choose the asset you want to bridge
Amount: Enter the amount to transfer\
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.
Bridge Transaction: Execute the cross-chain transfer
Confirmation: Receive tokens on destination chain
Only applicable if you are bridging to another wallet address.\
Slippage: Set acceptable slippage tolerance (usually 0.1-0.5%)
Bridge Fee: Protocol fee structure
Gas Estimate: Transaction costs
Route: Cross-chain path details
LayerZero Scan: Cross-chain transaction explorer
Destination Explorer: Confirm arrival on target chain
You can create your MetaMask Wallet from here. If you already have a wallet you may skip this step
Developers who are deploying Smart Contracts and need Somnia Test Tokens, STT. Please join the Discord.
Go to the #dev-chat channel, tag the Somnia DevRel, @emma_odiaand request Test Tokens.
You can also email [email protected] with a brief description of what you are building and your GitHub profile.
Visit Chainlist and Click on "Connect Wallet":
First, Connect your Wallet. You may use any desired wallet or Metamask (preferred)
Click on "Add to Metamask" to add Somnia Mainnet to your wallet
The Somnia Mainnet is LIVE
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.
Developers who are deploying Smart Contracts and need Somnia Test Tokens, STT. Please join the . Go to the #dev-chat channel, tag the Somnia DevRel, @emma_odiaand request Test Tokens.
You can also use the Faucet:
You can also email [email protected] with a brief description of what you are building and your GitHub profile.
Add Somnia Mainnet to your wallet through -
Add Somnia Testnet to your wallet through -
Using.
to chat with devs and raise issues
for updates
- Solidity development framework paired with a JavaScript testing framework
- Solidity framework for both development and testing.
MultiCallV3
EntryPoint v0.7
Factory Address
Alternative Testnet Block Explorer
Testnet Faucet
Stakely Mainnet Faucet
Chain ID
5031
50312
Block Explorer
Symbol
SOMI
STT
RPC
Ankr
Public Node
Stakely
Validation Cloud
Google Cloud Faucet
Stakely
Thirdweb Faucet
Somnia provides two distinct environments for developers and users: Mainnet and Testnet (Shannon). Both serve different purposes in the ecosystem, and knowing when to use which is essential for building and deploying applications effectively.
The Mainnet is the official production blockchain of Somnia. All transactions on this chain are final and irreversible and require SOMI tokens as gas.
Real-value environment secured by Somnia’s validator set.
Integrated with wallets, explorers, bridges, and infrastructure providers.
Permanent and immutable transaction history.
Designed for live dApps, end-users, and production-ready deployments.
Deploying audited and tested smart contracts.
Running dApps with real users and assets.
Managing liquidity, staking, governance, or NFT projects.
Partner integrations requiring security and finality.
The Testnet is a sandbox environment that mirrors mainnet behavior but uses STT test tokens with no real-world value. It allows safe experimentation and rapid iteration without financial risk.
Transactions use STT tokens, available via the faucet.
Close-to-mainnet parameters for realistic testing.
Safe for prototyping, debugging, and QA.
Commonly used in workshops, hackathons, and developer onboarding.
Learning how to connect and deploy on Somnia.
Prototyping features or building MVPs.
Debugging smart contracts or dApp flows.
Preparing for audits and production deployment.
Currency
SOMI (real value)
STT (valueless, faucet)
Purpose
Production deployments
Development & testing
Transactions
Permanent and irreversible
Experimental and disposable
Typical Use
Live dApps, DeFi, staking, NFT
Tip: Treat Testnet as your safe playground and Mainnet as your production stage. Every project should pass through Testnet before moving to Mainnet.
Below is a list of all critical Smart Contract addresses for Somnia network.
# Deploying a contract to Somnia Mainnet
npx hardhat run scripts/deploy.js --network somnia_mainnet# Deploying a contract to Somnia Testnet
npx hardhat run scripts/deploy.js --network somnia_testnetPrototyping, QA, education
Risk
Financial impact possible
No financial risk
BNB Chain
OFT
Base
OFT
Ethereum
OFT
Somnia
NativeOFTAdapter
chainKey : somnia
stage : mainnet
EID : 30380
endpointV2 (main entrypoint)
sendUln302
receiveUln302
executor
deadDVN
Oracle
Gas Wallet
USDT
USDC
BTC
ARB
VRFV2PlusWrapper
LINK Token
LINK/NATIVE oracle
MultiCallV3
WSOMI
USDC
WETH
USDT
SOL
WETH
SOMI
