Quickstart

This section covers how to invoke Somnia Agents—calling their methods and receiving results.

How Agent Invocation Works

Agent invocations are asynchronous. When you invoke an agent:

1. Your request is sent to the Somnia network

2. Multiple validator nodes execute the agent independently

3. Validators reach consensus on the result

4. The result is returned (and optionally delivered to a callback)

This decentralized execution ensures that results are trustworthy and auditable.

Network & Tokens

Somnia Agents are live on both Somnia Mainnet and Somnia Testnet. Pick the network that matches your deployment target:

Property	Mainnet	Testnet
Network Name	Somnia Mainnet	Somnia Testnet
Chain ID	5031	50312
RPC URL	https://api.infra.mainnet.somnia.network	https://api.infra.testnet.somnia.network
Currency	SOMI	STT
SomniaAgents Contract	0x5E5205CF39E766118C01636bED000A54D93163E6	0x037Bb9C718F3f7fe5eCBDB0b600D607b52706776

Get testnet STT from the Somnia Faucet. For mainnet, acquire SOMI through the usual channels.

Explore Agents

The easiest way to get started is the Agent Explorer web app:

Network	URL
Testnet	https://agents.testnet.somnia.network
Mainnet	https://agents.somnia.network

Here you can:

• Browse all available agents

• View agent methods and their parameters

• Invoke agents directly from the browser

• View execution receipts

• Generate code snippets for Solidity and JavaScript

Invocation Methods

There are two ways to invoke agents:

Method	Use Case	Guide
Web App	Exploration, testing, one-off calls	This page
Solidity	Smart contract integration, on-chain automation	Invoking from Solidity

All agent invocations go through the Solidity platform contract — including calls made from the web app.

Next Steps

• Invoking from Solidity — Integrate agents into smart contracts

• Receipts — Understand execution receipts

• Gas Fees — Learn about invocation costs