# Somnia Docs ## Documentation - [Introduction](https://docs.somnia.network/readme.md) - [Getting Started for Mainnet](https://docs.somnia.network/get-started/getting-started-for-mainnet.md) - [Connect Your Wallet To Mainnet](https://docs.somnia.network/get-started/connect-your-wallet-to-mainnet.md) - [Bridging Info](https://docs.somnia.network/get-started/bridging-info.md) - [Removing the Somnia Devnet Network](https://docs.somnia.network/get-started/removing-the-somnia-devnet-network.md) - [Update the block explorer in metamask](https://docs.somnia.network/get-started/update-the-block-explorer-in-metamask.md) - [Network Info](https://docs.somnia.network/developer/network-info.md) - [Network Overview (Mainnet / Testnet)](https://docs.somnia.network/developer/network-info/network-overview-mainnet-testnet.md) - [SOMI coin](https://docs.somnia.network/developer/network-info/somi-coin.md) - [Somnia Mainnet Releases](https://docs.somnia.network/developer/network-info/somnia-mainnet-releases.md) - [JSON-RPC API](https://docs.somnia.network/developer/json-rpc-api.md) - [Somnia Reactivity](https://docs.somnia.network/developer/reactivity.md) - [On-chain Reactivity](https://docs.somnia.network/developer/reactivity/reactivity-onchain.md) - [Off-chain Reactivity](https://docs.somnia.network/developer/reactivity/reactivity-offchain.md) - [Tutorials](https://docs.somnia.network/developer/reactivity/tutorials.md) - [Wildcard Off-Chain Reactivity Tutorial](https://docs.somnia.network/developer/reactivity/tutorials/wildcard-off-chain-reactivity-tutorial.md): Subscribe to all new logs over WebSocket and receive optional read-only call results with each event - [Off-Chain Reactivity: Filtered Subscriptions tutorial](https://docs.somnia.network/developer/reactivity/tutorials/off-chain-reactivity-filtered-subscriptions-tutorial.md) - [Solidity on-chain Reactivity Tutorial](https://docs.somnia.network/developer/reactivity/tutorials/solidity-on-chain-reactivity-tutorial.md): Create a contract-owned on-chain subscription that reacts to ERC-20 Transfer events - [Cron subscriptions via SDK](https://docs.somnia.network/developer/reactivity/tutorials/cron-subscriptions-via-sdk.md): Create block-tick and scheduled subscriptions using SDK - [Somnia Data Streams](https://docs.somnia.network/developer/data-streams.md) - [What is Somnia Data Streams?](https://docs.somnia.network/developer/data-streams/what-is-somnia-data-streams.md) - [Quickstart](https://docs.somnia.network/developer/data-streams/quickstart.md): Example pseudo code for publishing data associated with a schema (public or private) - [Concepts](https://docs.somnia.network/developer/data-streams/concepts.md) - [Understanding Schemas, Schema IDs, Data IDs, and Publisher](https://docs.somnia.network/developer/data-streams/concepts/understanding-schemas-schema-ids-data-ids-and-publisher.md) - [Extending and composing data schemas](https://docs.somnia.network/developer/data-streams/concepts/extending-and-composing-data-schemas.md): The best blockchain primitives are composable and schemas are no exception. Promoting re-use is a priority - [Somnia Data vs Event Streams](https://docs.somnia.network/developer/data-streams/concepts/somnia-data-vs-event-streams.md): Serving different purposes, data and event streams can be used independently or together - [Intersection with Somnia Reactivity](https://docs.somnia.network/developer/data-streams/concepts/intersection-with-somnia-reactivity.md): How to build applications that react to data being streamed to the Somnia chain by creating subscriptions - [Data Provenance and Verification in Streams](https://docs.somnia.network/developer/data-streams/concepts/data-provenance-and-verification-in-streams.md) - [SDK Methods Guide](https://docs.somnia.network/developer/data-streams/sdk-methods-guide.md): Detailed SDK interface handbook for interacting with the Somnia Data Streams protocol via the typescript SDK - [Tutorials](https://docs.somnia.network/developer/data-streams/tutorials.md) - [“Hello World” App](https://docs.somnia.network/developer/data-streams/tutorials/hello-world-app.md): Build a Hello World program to understand Somnia Data Streams. - [Build Your First Schema](https://docs.somnia.network/developer/data-streams/tutorials/build-your-first-schema.md) - [Streams Case Study: Formula 1](https://docs.somnia.network/developer/data-streams/tutorials/streams-case-study-formula-1.md): Streaming data from OpenF1 on-chain and building reactive applications - [READ Stream Data from a UI (Next.js Example)](https://docs.somnia.network/developer/data-streams/tutorials/read-stream-data-from-a-ui-next.js-example.md) - [Integrate Chainlink Oracles](https://docs.somnia.network/developer/data-streams/tutorials/integrate-chainlink-oracles.md) - [Working with Multiple Publishers in a Shared Stream](https://docs.somnia.network/developer/data-streams/tutorials/working-with-multiple-publishers-in-a-shared-stream.md) - [The DApp Publisher Proxy Pattern](https://docs.somnia.network/developer/data-streams/tutorials/the-dapp-publisher-proxy-pattern.md) - [Build a Minimal On-Chain Chat App](https://docs.somnia.network/developer/data-streams/tutorials/build-a-minimal-on-chain-chat-app.md) - [Build a Realtime On-Chain Game](https://docs.somnia.network/developer/data-streams/tutorials/build-a-realtime-on-chain-game.md): Build a Tap-to-Play Onchain Game - [Smart Contracts](https://docs.somnia.network/developer/smart-contracts.md): List of critical Smart Contract addresses for Somnia network. - [Development Frameworks](https://docs.somnia.network/developer/development-frameworks.md) - [Local Testing and Forking](https://docs.somnia.network/developer/development-frameworks/local-testing-and-forking.md) - [Deploy with RemixIDE](https://docs.somnia.network/developer/development-frameworks/deploy-with-remixide.md) - [Deploy with Thirdweb](https://docs.somnia.network/developer/development-frameworks/deploy-with-thirdweb.md) - [Deploy with Foundry](https://docs.somnia.network/developer/development-frameworks/deploy-with-foundry.md) - [Deploy with Hardhat](https://docs.somnia.network/developer/development-frameworks/deploy-with-hardhat.md) - [Using the Viem Library](https://docs.somnia.network/developer/development-frameworks/using-the-viem-library.md) - [Verifying via Explorer](https://docs.somnia.network/developer/development-frameworks/verifying-via-explorer.md) - [Debug Playbook](https://docs.somnia.network/developer/development-frameworks/debug-playbook.md) - [Deploying Smart Contracts](https://docs.somnia.network/developer/development-frameworks/deploying-smart-contracts.md) - [Building DApps](https://docs.somnia.network/developer/building-dapps.md) - [Tokens and NFTs](https://docs.somnia.network/developer/building-dapps/tokens-and-nfts.md) - [Create ERC20 Tokens](https://docs.somnia.network/developer/building-dapps/tokens-and-nfts/create-erc20-tokens.md) - [Create ERC721 NFT Collections](https://docs.somnia.network/developer/building-dapps/tokens-and-nfts/create-erc721-nft-collections.md) - [Managing NFT Metadata with IPFS](https://docs.somnia.network/developer/building-dapps/tokens-and-nfts/managing-nft-metadata-with-ipfs.md) - [Using Native Coin (SOMI/STT)](https://docs.somnia.network/developer/building-dapps/tokens-and-nfts/using-native-somi-stt.md) - [Wallet Integration and Auth](https://docs.somnia.network/developer/building-dapps/wallet-integration-and-auth.md) - [Authenticating with MetaMask](https://docs.somnia.network/developer/building-dapps/wallet-integration-and-auth/authenticating-with-metamask.md) - [Authenticating with ConnectKit](https://docs.somnia.network/developer/building-dapps/wallet-integration-and-auth/authenticating-with-connectkit.md) - [Authenticating with Privy](https://docs.somnia.network/developer/building-dapps/wallet-integration-and-auth/authenticating-with-privy.md) - [Authenticating with RainbowKit](https://docs.somnia.network/developer/building-dapps/wallet-integration-and-auth/authenticating-with-rainbowkit.md) - [OnRamps](https://docs.somnia.network/developer/building-dapps/onramps.md) - [Buy SOMI Using Banxa Checkout](https://docs.somnia.network/developer/building-dapps/onramps/buy-somi-using-banxa-checkout.md) - [Cross-chain Swaps and Bridging](https://docs.somnia.network/developer/building-dapps/cross-chain-swaps-and-bridging.md) - [Integrating the LI.FI SDK](https://docs.somnia.network/developer/building-dapps/cross-chain-swaps-and-bridging/integrating-the-li.fi-sdk.md) - [Account Abstraction](https://docs.somnia.network/developer/building-dapps/account-abstraction.md) - [Gasless Transactions with Thirdweb](https://docs.somnia.network/developer/building-dapps/account-abstraction/gasless-transactions-with-thirdw.md) - [Smart Wallet App with Thirdweb](https://docs.somnia.network/developer/building-dapps/account-abstraction/smart-wallet-app-with-thirdweb.md) - [Data Indexing and Querying](https://docs.somnia.network/developer/building-dapps/data-indexing-and-querying.md) - [Ormi Subgraph](https://docs.somnia.network/developer/building-dapps/data-indexing-and-querying/ormi-subgraph.md) - [Protofire Subgraph](https://docs.somnia.network/developer/building-dapps/data-indexing-and-querying/protofire-subgraph.md) - [Building Subgraph UIs (NextJS/Fetch)](https://docs.somnia.network/developer/building-dapps/data-indexing-and-querying/building-subgraph-uis-nextjs-fetch.md) - [Building Subgraph UIs (Apollo Client)](https://docs.somnia.network/developer/building-dapps/data-indexing-and-querying/building-subgraph-uis-apollo-client.md) - [Using Data APIs (Ormi)](https://docs.somnia.network/developer/building-dapps/data-indexing-and-querying/using-data-apis-ormi.md) - [Listening to Blockchain Events (WebSocket)](https://docs.somnia.network/developer/building-dapps/data-indexing-and-querying/listening-to-blockchain-events-websocket.md) - [Oracles](https://docs.somnia.network/developer/building-dapps/oracles.md) - [DIA Price Feeds](https://docs.somnia.network/developer/building-dapps/oracles/dia-price-feeds.md) - [Protofire Price Feeds](https://docs.somnia.network/developer/building-dapps/oracles/protofire-price-feeds.md) - [Using Verifiable Randomness (VRF)](https://docs.somnia.network/developer/building-dapps/oracles/using-verifiable-randomness-vrf.md) - [Example Applications](https://docs.somnia.network/developer/building-dapps/example-applications.md) - [DAO Smart Contract](https://docs.somnia.network/developer/building-dapps/example-applications/dao-smart-contract.md) - [DAO UI Tutorial p1](https://docs.somnia.network/developer/building-dapps/example-applications/dao-ui-tutorial-p1.md) - [DAO UI Tutorial p2](https://docs.somnia.network/developer/building-dapps/example-applications/dao-ui-tutorial-p2.md) - [DAO UI Tutorial p3](https://docs.somnia.network/developer/building-dapps/example-applications/dao-ui-tutorial-p3.md) - [Building a Simple DEX on Somnia](https://docs.somnia.network/developer/building-dapps/example-applications/building-a-simple-dex-on-somnia.md) - [Security](https://docs.somnia.network/developer/security.md) - [Smart Contract Security 101](https://docs.somnia.network/developer/security/smart-contract-security-101.md) - [Audit Checklist](https://docs.somnia.network/developer/security/audit-checklist.md) - [Node/Infra Security](https://docs.somnia.network/developer/security/node-infra-security.md) - [Responsible Disclosure Policy](https://docs.somnia.network/developer/security/responsible-disclosure-policy.md) - [Deployment and Production](https://docs.somnia.network/developer/deployment-and-production.md) - [Go-Live Checklist](https://docs.somnia.network/developer/deployment-and-production/go-live-checklist.md) - [Explorer API Health and Monitoring](https://docs.somnia.network/developer/deployment-and-production/explorer-api-health-and-monitoring.md) - [Somnia Gas Differences To Ethereum](https://docs.somnia.network/developer/deployment-and-production/somnia-gas-differences-to-ethereum.md) - [Ecosystem](https://docs.somnia.network/developer/deployment-and-production/ecosystem.md) - [Ecosystem Showcase](https://docs.somnia.network/developer/deployment-and-production/ecosystem/ecosystem-showcase.md) - [Ecosystem Tools](https://docs.somnia.network/developer/deployment-and-production/ecosystem/ecosystem-tools.md) - [RPC](https://docs.somnia.network/developer/deployment-and-production/ecosystem/ecosystem-tools/rpc.md) - [Oracles](https://docs.somnia.network/developer/deployment-and-production/ecosystem/ecosystem-tools/oracles.md) - [Subgraphs](https://docs.somnia.network/developer/deployment-and-production/ecosystem/ecosystem-tools/subgraphs.md) - [Wallet Providers](https://docs.somnia.network/developer/deployment-and-production/ecosystem/ecosystem-tools/wallet-providers.md) - [Safe](https://docs.somnia.network/developer/deployment-and-production/ecosystem/ecosystem-tools/safes.md) - [Explorers](https://docs.somnia.network/developer/deployment-and-production/ecosystem/ecosystem-tools/explorers.md) - [SDKs](https://docs.somnia.network/developer/deployment-and-production/ecosystem/ecosystem-tools/sdks.md) - [On Ramps](https://docs.somnia.network/developer/deployment-and-production/ecosystem/ecosystem-tools/on-ramps.md) - [Account Abstraction](https://docs.somnia.network/developer/deployment-and-production/ecosystem/ecosystem-tools/account-abstraction.md) - [APIs](https://docs.somnia.network/developer/deployment-and-production/ecosystem/ecosystem-tools/apis.md) - [Support and Community](https://docs.somnia.network/developer/deployment-and-production/support-and-community.md) - [General FAQs](https://docs.somnia.network/developer/deployment-and-production/support-and-community/general-faqs.md) - [Developer FAQs](https://docs.somnia.network/developer/deployment-and-production/support-and-community/developer-faqs.md) - [How To Guides](https://docs.somnia.network/developer/how-to-guides.md) - [Mission](https://docs.somnia.network/somnia-litepaper/mission.md) - [Problem](https://docs.somnia.network/somnia-litepaper/problem.md) - [Somnia-Mission](https://docs.somnia.network/litepaper/somnia-mission.md) - [Problem](https://docs.somnia.network/litepaper/problem.md) - [Protocols](https://docs.somnia.network/ecosystem/protocols.md) - [SOM0](https://docs.somnia.network/ecosystem/protocols/som0.md) - [SOM1](https://docs.somnia.network/ecosystem/protocols/som1.md) - [Experiences](https://docs.somnia.network/ecosystem/experiences.md) - [Metaverse Browser](https://docs.somnia.network/ecosystem/experiences/metaverse-browser.md) - [Somnia Playground](https://docs.somnia.network/ecosystem/experiences/somnia-playground.md) - [Content Creation](https://docs.somnia.network/ecosystem/content-creation.md) - [Conclusion](https://docs.somnia.network/conclusion.md) ## Concepts - [Introduction](https://docs.somnia.network/concepts/introduction.md) - [Somnia-Mission](https://docs.somnia.network/concepts/litepaper/somnia-mission.md) - [Problem](https://docs.somnia.network/concepts/litepaper/problem.md) - [Overview](https://docs.somnia.network/concepts/somnia-blockchain/overview.md) - [MultiStream Consensus](https://docs.somnia.network/concepts/somnia-blockchain/multistream-consensus.md) - [Accelerated Sequential Execution](https://docs.somnia.network/concepts/somnia-blockchain/accelerated-sequential-execution.md) - [Somnia's IceDB](https://docs.somnia.network/concepts/somnia-blockchain/somnias-icedb.md) - [Advanced Compression Techniques](https://docs.somnia.network/concepts/somnia-blockchain/advanced-compression-techniques.md) - [Security](https://docs.somnia.network/concepts/somnia-blockchain/security.md) - [Use Cases](https://docs.somnia.network/concepts/somnia-blockchain/use-cases.md) - [On-Chain Reactivity](https://docs.somnia.network/concepts/somnia-blockchain/on-chain-reactivity.md) - [Overview](https://docs.somnia.network/concepts/tokenomics/overview.md) - [Token Staking and Delegation](https://docs.somnia.network/concepts/tokenomics/token-staking-and-delegation.md) - [Gas Fees](https://docs.somnia.network/concepts/tokenomics/gas-fees.md) - [Allocation and unlocks](https://docs.somnia.network/concepts/tokenomics/allocation-and-unlocks.md) - [Tokens Governance](https://docs.somnia.network/concepts/tokenomics/tokens-governance.md) - [Conclusion](https://docs.somnia.network/concepts/conclusion.md) - [LEGAL](https://docs.somnia.network/concepts/miscellaneous/legal.md) - [LEGAL DISCLAIMER](https://docs.somnia.network/concepts/miscellaneous/legal/legal-disclaimer.md) - [AML Compliance](https://docs.somnia.network/concepts/miscellaneous/legal/aml-compliance.md): Anti-Money Laundering (AML) Policy - [Airdrop Policy](https://docs.somnia.network/concepts/miscellaneous/legal/airdrop-policy.md) - [Governance](https://docs.somnia.network/concepts/miscellaneous/legal/governance.md): This section outlines our current centralized governance framework, which will transition to a decentralized governance model as the network evolves. - [MiCAR Whitepaper](https://docs.somnia.network/concepts/miscellaneous/legal/micar-whitepaper.md) - [Audits](https://docs.somnia.network/concepts/miscellaneous/audits.md) ## Agents - [Overview](https://docs.somnia.network/agents/readme.md) - [Quickstart](https://docs.somnia.network/agents/invoking-agents/quickstart.md) - [Invoking from Solidity](https://docs.somnia.network/agents/invoking-agents/from-solidity.md) - [Receipts](https://docs.somnia.network/agents/invoking-agents/receipts.md) - [(Advanced) Custom Consensus](https://docs.somnia.network/agents/invoking-agents/custom-consensus.md) - [Gas Fees](https://docs.somnia.network/agents/invoking-agents/gas-fees.md) - [JSON API Request](https://docs.somnia.network/agents/base-agents/json-api-request.md) - [LLM Inference](https://docs.somnia.network/agents/base-agents/llm-inference.md) - [LLM Parse Website](https://docs.somnia.network/agents/base-agents/llm-parse-website.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://docs.somnia.network/readme.md?ask= ``` 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.