How To Guides

Welcome to the How-To Guides — your one-stop resource for building on the Somnia Network.

This section is designed to help developers of all experience levels onboard quickly, understand the tools available to them, and start shipping powerful dApps on Somnia.

Somnia offers a high-performance Layer 1 blockchain with blazing-fast finality, high throughput, and robust developer tooling. Whether you're deploying your first smart contract, building out a full-stack decentralized application, or integrating advanced tooling like oracles, subgraphs, and SDKs — you're in the right place.

Our guides are practical, up-to-date, and hands-on, focused on real implementations that will help you go from zero to deployed faster than ever.

Tip

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, @emreyeth and request Test Tokens.

You can also join the Somnia Developer Telegram or use Faucet.

You can also email developers@somnia.foundation with a brief description of what you are building and your GitHub profile.

---

The guides are grouped by theme and difficulty, so you can explore what’s most relevant to your project or level of expertise:

Basics

Learn how to:

• Deploy smart contracts on Somnia using RemixIDE, Hardhat, or Foundry
• Verify your contracts on Somnia
• Create ERC20 Tokens on Somnia

Intermediate

Move beyond the basics by building full-stack applications.

• Learn how to connect Web UI with Smart Contracts using Viem
• How to Set Up MetaMask for use with Somnia
• How to Use Native Somnia Tokens: SOMI (STT - Testnet)

Advanced

Build Complete dApp experiences

• Create a DAO: Smart Contract Guide
• Set Up the Web UI for DAO Smart Contract
• Set Up READ Operations for DAO Smart Contract
• Set Up WRITE Operations for DAO Smart Contract
• Build a Subgraph UI using Apollo Client
• Build a DEX on Somnia
• Somnia WebSockets

Oracles

Bring off-chain data on-chain with:

• How to integrate DIA price feeds on Somnia
• How to implement Protofire Price Feeds
• How to implement Verifiable Randomness (VRF) via Protofire + Chainlink

Subgraphs

Efficiently query and index onchain data.

• How to create and deploy subgraphs on Somnia using ORMI
• How to build with Protofire’s subgraph infrastructure
• Frontend integrations for building responsive UIs from your subgraph data

Thirdweb

A seamless wallet experience is key to user adoption. Somnia integrates with modern wallet providers to help you build dApps that feel intuitive and onboarding-friendly.

This section covers:

• How to deploy Smart Contracts using Thirdweb on Somnia
• Using Thirdweb Wallet SDK for seamless Web3 UX
• How to enable gasless transactions via Account Abstraction

Wallets

Accelerate development with partner SDKs.

• Integrate Privy for embedded, Web2-friendly wallet flows
• Use RainbowKit to offer a beautiful, customizable wallet connection UI
• Leverage ConnectKit for flexible and extensible wallet integrations

APIs

Use available APIs to enhance your application:

• How to use ORMI’s Data API to query blockchain state

---

Somnia’s developer ecosystem is growing rapidly — and with that, so is the tooling. These guides are updated frequently to reflect new partnerships, infra improvements, and best practices.

If you're a developer who wants to build fast, scalable, and secure dApps, Somnia is your playground. And these guides are your map.