# Somnia

<a href="https://somnia.chain.love/" class="button primary" data-icon="arrow-up-right">Open Toolbox</a> <a href="https://somnia.chain.love/configurations" class="button primary" data-icon="arrow-up-right">Open Performance</a> <a href="https://somnia.chain.love/rpc" class="button primary" data-icon="arrow-up-right">Open API Management (Subgraphs)</a>

{% hint style="info" %} <img src="https://img.shields.io/badge/Toolbox-Enabled-green" alt="" data-size="original"> <img src="https://img.shields.io/badge/Performance_module-Enabled-green" alt="" data-size="original"> <img src="https://img.shields.io/badge/RPC-not%20supported-lightgrey" alt="" data-size="original"> <img src="https://img.shields.io/badge/Subgraphs-FREE-brightgreen" alt="" data-size="original">
{% endhint %}

Chain.Love on Somnia is a **set of modules** that help you **discover** providers, **monitor** them, and (optionally) **access** RPC/Subgraphs through an API gateway.

## Recommended workflows

* **Discover providers (start here)**: open the [Toolbox](https://somnia.chain.love/) → browse categories (RPC, Indexing, Bridges, Oracles, Wallets, etc.) → shortlist and compare offers.
* **Harden production access**: open [Performance](https://somnia.chain.love/configurations) → set monitoring/notifications → configure routing and failover.
* **Need an RPC/Subgraphs right now**: open [API Management](https://somnia.chain.love/rpc) → use RPC/Subgraphs endpoints (details below).

## Modules on Somnia

### Toolbox (Discovery & comparison)

* **What it is**: a chain-specific marketplace/registry of Web3 services.
* **Key features**:
  * [Discover](https://app.gitbook.com/s/UtEmB9ZJDyz0H0sE6dNG/features/discover): browse categories and filter offers
  * [Compare](https://app.gitbook.com/s/UtEmB9ZJDyz0H0sE6dNG/features/compare): side-by-side comparison
  * [AI search](https://app.gitbook.com/s/UtEmB9ZJDyz0H0sE6dNG/features/ai-search): search across the database (including cross-ecosystem queries)
  * [Widget for docs](https://app.gitbook.com/s/UtEmB9ZJDyz0H0sE6dNG/features/widget-for-docs): embed a compact Toolbox view into documentation
  * [Contributing](https://app.gitbook.com/s/UtEmB9ZJDyz0H0sE6dNG/contributing): improve the open-source database
* **Open**: `https://somnia.chain.love/`

### Performance (Monitoring & routing)

* **What it is**: a module to manage providers' performance.
* **Key areas**:
  * [Monitoring](https://github.com/Chain-Love/chain.love-docs/blob/main/modules/performance/monitoring/getting-started.md)
  * [Notifications](https://github.com/Chain-Love/chain.love-docs/blob/main/modules/performance/monitoring/notifications.md)
  * [Load balancer](https://github.com/Chain-Love/chain.love-docs/blob/main/modules/performance/load-balancer/getting-started.md)
  * [Performance agreements](https://github.com/Chain-Love/chain.love-docs/blob/main/modules/performance/performance-agreements/getting-started.md)
* **Open**: `https://somnia.chain.love/configurations`

### API Management (Subgraphs)

This module is for **accessing** APIs (Subgraphs). If you’re evaluating providers or comparing options, start with the **Toolbox** section above.

#### Subgraphs (Indexing)

Chain.Love Indexing on Somnia supports both testnet and mainnet networks.

Currently, you can query your subgraphs **by name only**: `https://proxy.somnia.chain.love/subgraphs/name/<SUBGRAPH_NAME>`.

```bash
# Assuming the subgraph name is `somnia-testnet/PrayDotFun`
curl -X POST \
 -H "Content-Type: application/json" \
 -d '{"query":"query MyQuery {\r\n  userScores(first: 10) {\r\n    id\r\n  }\r\n}","variables":{}}' \
 "https://proxy.somnia.chain.love/subgraphs/name/somnia-testnet/PrayDotFun"
```

{% hint style="info" %}
Note that the HTTP path of the query URL is `/subgraphs/name/<SUBGRAPH_NAME>`, different from the format used on Astar.
{% endhint %}