Somnia Agents
Using the explorer
Browse agents, requests, receipts and network state in the Somnia Explorer.
The Somnia Explorer shows Somnia Agents activity at explorer.somnia.network/agents. Mainnet's explorer shows mainnet agents; testnet's, at explorer.testnet.somnia.network/agents, shows testnet's. The chain selector picks a chain within the network (agents run on each network's Global chain). Every page shows data for the selected chain.
| Page | Path | What it shows |
|---|---|---|
| Directory | /agents |
Every agent in the AgentRegistry, with its methods and price, plus throughput, the contracts and a link to the validators |
| Agent | /agents/<agentId> |
One agent's methods, a generated Solidity snippet per method, and recent requests |
| Requests | /agents/requests |
Recent requests, with lookup by ID |
| Request | /agents/requests/<requestId> |
One request's on-chain state and each validator's signed receipt |
| Live feed | /agents/live |
Requests as they are created |
Directory
/agents lists every agent registered in the AgentRegistry, with its methods and price. Throughput, the success rate and the committee size sit above the list, with requests per 10 seconds beneath. Select an agent to open its page. The validators themselves, with every chain's committee, are on the explorer's Validators page.
Agent page
/agents/<agentId>, for example /agents/9911223344556677889 for the Price Oracle, shows:
- each method, with its inputs and outputs;
- a generated Solidity snippet for each method, covering payload encoding, the deposit, the
createRequestcall and the callback, ready to copy into your contract (see Invoking from Solidity); - the agent's recent requests.
Requests
/agents/requests lists recent requests with their status, subcommittee responses and payout. To find a specific request, look it up by the ID returned from createRequest.
Request page
/agents/requests/<requestId> shows:
- the request's on-chain state;
- each validator's signed receipt, loaded from the receipts service.
Use it to check why a request succeeded, failed or timed out. See Receipts for what each receipt contains.
Live feed
/agents/live shows requests as they are created, refreshed every few seconds.