Custom Somnia Testnet APIs and analytics

Turn your Somnia Testnet contracts into real-time APIs with HyperIndex, and query historical and live chain data through HyperSync and HyperRPC.

HyperRPC requires an API tokenGet one →
Chain ID
50312
Native token
STT
RPC endpoint
somnia-testnet.rpc.hypersync.xyz
Latest block
Loading
Blocksquare
Midas
Revert Finance
Velodrome
Binance
Gnosis
Aerodrome
Yield Basis
Gauntlet
Chronicle
KPK
Curve
Sablier
Sky
Spark
WLFI
Beefy
Ether.fi
Kleros
Aragon
Caldera
Limitless
Katana
zkPass
Trading Strategy
Ostium
Pimlico
Gnosis App
Rhinestone
Gnosis Pay
Etherspot
0xbow
dRPC
Trusted by industry leaders

Index and query Somnia Testnet

HyperIndex

Index Somnia Testnet contract events into a GraphQL API, with backfill and live events in one pipeline.

  1. Create an indexer

    Run pnpx envio init to scaffold a HyperIndex project. Give it your Envio API token and it saves it to .env, so local runs can read Somnia Testnet from HyperSync. Indexers deployed to Envio Cloud don't need one.

    $ pnpx envio init
  2. Add Somnia Testnet to config.yaml

    List Somnia Testnet under chains with your contract and events. HyperSync is the data source by default, so no RPC URL is needed.

    config.yaml
    name: my-indexer
    contracts:
      - name: MyContract
        events:
          - event: "Transfer(address indexed from, address indexed to, uint256 value)"
    chains:
      - id: 50312 # Somnia Testnet
        hypersync_config:
          url: https://somnia-testnet.hypersync.xyz
        start_block: 0
        contracts:
          - name: MyContract
            address: "0x0000000000000000000000000000000000000000"
  3. Run it

    Start it with pnpm dev, which needs Docker. It opens the local Hasura dashboard with your indexed data.

    $ pnpm dev

HyperSync

Read raw Somnia Testnet logs, transactions and blocks in bulk, selecting only the fields you need.

Every request requires an API token. Get an API token

HyperSync endpoint
https://somnia-testnet.hypersync.xyz
TypeScript (npm install @envio-dev/hypersync-client)
import { HypersyncClient } from "@envio-dev/hypersync-client";

const client = new HypersyncClient({
  url: "https://somnia-testnet.hypersync.xyz",
  apiToken: process.env.ENVIO_API_TOKEN!,
});

// ERC-20 and ERC-721 Transfer events from the last 10 blocks.
const height = await client.getHeight();
const res = await client.get({
  fromBlock: height - 10,
  logs: [{ topics: [["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]] }],
  fieldSelection: { log: ["BlockNumber", "Address", "Topic1", "Topic2"] },
});
console.log(res.data.logs.length, "Transfer events in the last 10 blocks");

HyperRPC

A read-only endpoint for existing RPC code, with the MIP-16 query methods. Add your token to the end of the URL. It cannot send transactions.

Every request requires an API token. Get an API token

HyperRPC endpoint
https://somnia-testnet.rpc.hypersync.xyz
curl
curl https://somnia-testnet.rpc.hypersync.xyz/$ENVIO_API_TOKEN \
  -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'
About

The public testnet for Somnia, an EVM-compatible layer 1, used to deploy and test smart contracts before Somnia mainnet.

Network
Testnet
See Somnia Mainnet
Support
First-class
Official site
somnia.network
Prompt for your AI agent
Build a HyperIndex indexer on Somnia Testnet (chain ID 50312) that indexes [CONTRACT ADDRESS]'s [EVENTS] into a GraphQL API.

Before writing code, read https://envio.dev/chains/somnia-testnet.md and https://envio.dev/llms.txt. If you can add MCP servers, add Envio's docs server at https://docs.envio.dev/mcp.

1. Run pnpx envio init and choose Contract Import with the address above.
2. Put my API token in ENVIO_API_TOKEN in .env (I'll create it at https://envio.dev/app/api-tokens).
3. Shape the entities in schema.graphql and the event handlers, then run pnpm codegen.
4. Start it with pnpm dev (needs Docker) and confirm the entities appear in the local Hasura GraphQL API.
5. Add tests for the handlers and run pnpm test.
FAQs

Somnia Testnet indexing FAQ

Endpoints, chain IDs, data sources and getting started with Somnia Testnet on Envio.

Does Envio support Somnia Testnet?

Yes. Somnia Testnet has first-class support across HyperIndex, HyperSync, and HyperRPC. We run dedicated HyperSync and HyperRPC endpoints for Somnia Testnet so you can stream historical and real-time data straight into a production GraphQL API.

HyperSync supported chains →

What is the mainnet for Somnia Testnet?

Somnia Testnet is a testnet for Somnia Mainnet. Envio supports both, so you can build against Somnia Testnet and point the same indexer at Somnia Mainnet for production.

HyperSync supported chains →
More chains

Other supported chains

Start indexing Somnia Testnet

Build on the free development plan, then deploy a production indexer on Envio Cloud.

Try it free