feat: add monad indexer targets and unify deploy naming

Align network naming and hosted env vars across the monorepo so Celo and Monad deployments use a consistent model. Simplify indexer deployment to a single network-aware command without bypassing git hooks.

Made-with: Cursor

Author: chapati23

.trunk/trunk.yaml

@@ -71,7 +71,7 @@ actions:
     - id: indexer-codegen-pre-push
       display_name: Indexer Schema Codegen (pre-push)
       description: Validates schema.graphql by running envio codegen — catches duplicate fields, bad types, etc. before CI.
-      run: pnpm --filter @mento-protocol/indexer-envio codegen --config config.celo.mainnet.yaml
+      run: pnpm indexer:celo-mainnet:codegen
       triggers:
         - git_hooks: [pre-push]
   enabled:

AGENTS.md

@@ -15,10 +15,16 @@ pnpm monorepo with three packages:
 pnpm install
 
 # Indexer
-pnpm indexer:codegen          # Generate types from schema
-pnpm indexer:dev              # Start indexer (devnet)
-pnpm indexer:sepolia:codegen  # Generate types (sepolia config)
-pnpm indexer:sepolia:dev      # Start indexer (sepolia)
+pnpm indexer:codegen              # Generate types from schema (devnet)
+pnpm indexer:dev                   # Start indexer (devnet)
+pnpm indexer:celo-sepolia:codegen  # Generate types (Celo Sepolia config)
+pnpm indexer:celo-sepolia:dev     # Start indexer (Celo Sepolia)
+pnpm indexer:celo-mainnet:codegen  # Generate types (Celo mainnet)
+pnpm indexer:celo-mainnet:dev      # Start indexer (Celo mainnet)
+pnpm indexer:monad-mainnet:codegen  # Generate types (Monad mainnet)
+pnpm indexer:monad-mainnet:dev      # Start indexer (Monad mainnet)
+pnpm indexer:monad-testnet:codegen  # Generate types (Monad testnet)
+pnpm indexer:monad-testnet:dev      # Start indexer (Monad testnet)
 
 # Dashboard
 pnpm dashboard:dev            # Dev server
@@ -42,7 +48,7 @@ pnpm infra:apply              # Apply infrastructure changes
 
 - **Runtime:** Envio HyperIndex (envio@2.32.3)
 - **Schema:** `schema.graphql` defines indexed entities (FPMM, Swap, Mint, Burn, etc.)
-- **Configs:** `config.celo.devnet.yaml`, `config.celo.mainnet.yaml`, `config.celo.sepolia.yaml`
+- **Configs:** `config.celo.devnet.yaml`, `config.celo.mainnet.yaml`, `config.celo.sepolia.yaml`, `config.monad.mainnet.yaml`, `config.monad.testnet.yaml`
 - **Handlers:** `src/EventHandlers.ts` — processes blockchain events
 - **Contract addresses:** `src/contractAddresses.ts` — resolves addresses from `@mento-protocol/contracts` using the namespace map from `shared-config`
 - **ABIs:** `abis/` — FPMMFactory, FPMM, VirtualPoolFactory (indexer-specific); SortedOracles + token ABIs come from `@mento-protocol/contracts`
@@ -56,7 +62,7 @@ pnpm infra:apply              # Apply infrastructure changes
 - **Charts:** Plotly.js via react-plotly.js
 - **Data:** GraphQL queries to Hasura (via graphql-request + SWR)
 - **Styling:** Tailwind CSS 4
-- **Multi-chain:** Network selector switches between devnet/sepolia/mainnet Hasura endpoints; all networks defined in `src/lib/networks.ts`
+- **Multi-chain:** Network selector switches between celo-mainnet, celo-sepolia, monad-mainnet, monad-testnet Hasura endpoints; all networks defined in `src/lib/networks.ts`
 - **Contract labels:** `src/lib/networks.ts` derives token symbols and address labels from `@mento-protocol/contracts` (no vendored JSON); the active namespace per chain comes from `shared-config`
 - **Address book:** `/address-book` page + inline editing; custom labels stored in Upstash Redis, backed up daily to Vercel Blob; custom labels override/extend the package-derived ones
 - **Deployment:** Vercel (`monitoring-dashboard` project); infra managed by Terraform in `terraform/`
@@ -86,6 +92,8 @@ monitoring-monorepo/
 │   ├── config.celo.devnet.yaml   # Devnet indexer config
 │   ├── config.celo.mainnet.yaml  # Celo Mainnet config
 │   ├── config.celo.sepolia.yaml  # Celo Sepolia config
+│   ├── config.monad.mainnet.yaml # Monad Mainnet config
+│   ├── config.monad.testnet.yaml # Monad Testnet config
 │   ├── schema.graphql        # Entity definitions
 │   ├── src/
 │   │   ├── EventHandlers.ts  # Event processing logic
@@ -144,7 +152,7 @@ When a new set of contracts has been deployed and a new `@mento-protocol/contrac
 ### Adding a new contract to index
 
 1. Add ABI to `indexer-envio/abis/`
-2. Add contract entry in `config.celo.mainnet.yaml` (and `config.celo.sepolia.yaml` if applicable)
+2. Add contract entry in the relevant config(s): `config.celo.mainnet.yaml`, `config.celo.sepolia.yaml`, `config.monad.mainnet.yaml`, `config.monad.testnet.yaml`
 3. Add entity to `schema.graphql`
 4. Add handler in `src/EventHandlers.ts`
 5. Run `pnpm indexer:codegen` to regenerate types

README.md

@@ -6,11 +6,11 @@ Real-time monitoring infrastructure for Mento v3 on-chain pools — an [Envio Hy
 
 ## Packages
 
-| Package                             | Description                                                                     |
-| ----------------------------------- | ------------------------------------------------------------------------------- |
-| [`indexer-envio`](./indexer-envio/) | Envio HyperIndex indexer for Celo Mainnet + Sepolia (FPMM pools + VirtualPools) |
-| [`ui-dashboard`](./ui-dashboard/)   | Next.js 16 + Plotly.js monitoring dashboard with multi-chain network switching  |
-| [`shared-config`](./shared-config/) | Shared deployment config (chain ID → treb namespace mappings)                   |
+| Package                             | Description                                                                    |
+| ----------------------------------- | ------------------------------------------------------------------------------ |
+| [`indexer-envio`](./indexer-envio/) | Envio HyperIndex indexer for Celo + Monad (FPMM pools + VirtualPools)          |
+| [`ui-dashboard`](./ui-dashboard/)   | Next.js 16 + Plotly.js monitoring dashboard with multi-chain network switching |
+| [`shared-config`](./shared-config/) | Shared deployment config (chain ID → treb namespace mappings)                  |
 
 ## Architecture
 
@@ -51,14 +51,18 @@ The indexer runs on Envio's hosted free tier. Each deploy produces a new GraphQL
 pnpm install
 ```
 
-### Run the Indexer (local — Celo Sepolia)
+### Run the Indexer (local)
 
 ```bash
-# Generate types from schema + config
-pnpm indexer:sepolia:codegen
+# Celo Sepolia
+pnpm indexer:celo-sepolia:codegen && pnpm indexer:celo-sepolia:dev
 
-# Start the indexer (spins up Docker: Postgres + Hasura + indexer)
-pnpm indexer:sepolia:dev
+# Celo Mainnet
+pnpm indexer:celo-mainnet:codegen && pnpm indexer:celo-mainnet:dev
+
+# Monad Testnet / Mainnet
+pnpm indexer:monad-testnet:codegen && pnpm indexer:monad-testnet:dev
+pnpm indexer:monad-mainnet:codegen && pnpm indexer:monad-mainnet:dev
 ```
 
 ### Run the Dashboard
@@ -85,21 +89,19 @@ Create `indexer-envio/.env` from `indexer-envio/.env.example`:
 
 The dashboard supports multiple network targets via `_<NETWORK>` suffix env vars:
 
-| Variable                                   | Description                                     |
-| ------------------------------------------ | ----------------------------------------------- |
-| `NEXT_PUBLIC_HASURA_URL_MAINNET_HOSTED`    | Hasura/GraphQL endpoint — Celo Mainnet (hosted) |
-| `NEXT_PUBLIC_HASURA_SECRET_MAINNET_HOSTED` | Hasura admin secret — Celo Mainnet hosted       |
-| `NEXT_PUBLIC_HASURA_URL_SEPOLIA_HOSTED`    | Hasura/GraphQL endpoint — Celo Sepolia (hosted) |
-| `NEXT_PUBLIC_HASURA_SECRET_SEPOLIA_HOSTED` | Hasura admin secret — Celo Sepolia hosted       |
-| `NEXT_PUBLIC_HASURA_URL_MAINNET`           | Hasura endpoint — Celo Mainnet (local)          |
-| `NEXT_PUBLIC_HASURA_SECRET_MAINNET`        | Hasura admin secret — Celo Mainnet (local)      |
-| `NEXT_PUBLIC_HASURA_URL_SEPOLIA`           | Hasura endpoint — Celo Sepolia (local)          |
-| `NEXT_PUBLIC_HASURA_SECRET_SEPOLIA`        | Hasura admin secret — Celo Sepolia (local)      |
-| `NEXT_PUBLIC_EXPLORER_URL_MAINNET`         | Block explorer — Celo Mainnet                   |
-| `NEXT_PUBLIC_EXPLORER_URL_SEPOLIA`         | Block explorer — Celo Sepolia                   |
-| `UPSTASH_REDIS_REST_URL`                   | Address labels storage (Upstash Redis)          |
-| `UPSTASH_REDIS_REST_TOKEN`                 | Address labels Redis auth token                 |
-| `BLOB_READ_WRITE_TOKEN`                    | Vercel Blob token for daily label backups       |
+| Variable                                      | Description                                      |
+| --------------------------------------------- | ------------------------------------------------ |
+| `NEXT_PUBLIC_HASURA_URL_CELO_MAINNET_HOSTED`  | Hasura/GraphQL endpoint — Celo Mainnet (hosted)  |
+| `NEXT_PUBLIC_HASURA_URL_MONAD_MAINNET_HOSTED` | Hasura/GraphQL endpoint — Monad Mainnet (hosted) |
+| `NEXT_PUBLIC_HASURA_URL_MONAD_TESTNET_HOSTED` | Hasura/GraphQL endpoint — Monad Testnet (hosted) |
+| `NEXT_PUBLIC_HASURA_URL_CELO_SEPOLIA_HOSTED`  | Hasura/GraphQL endpoint — Celo Sepolia (hosted)  |
+| `NEXT_PUBLIC_HASURA_URL_CELO_MAINNET`         | Hasura endpoint — Celo Mainnet (local)           |
+| `NEXT_PUBLIC_HASURA_URL_CELO_SEPOLIA`         | Hasura endpoint — Celo Sepolia (local)           |
+| `NEXT_PUBLIC_EXPLORER_URL_CELO_MAINNET`       | Block explorer — Celo Mainnet                    |
+| `NEXT_PUBLIC_EXPLORER_URL_CELO_SEPOLIA`       | Block explorer — Celo Sepolia                    |
+| `UPSTASH_REDIS_REST_URL`                      | Address labels storage (Upstash Redis)           |
+| `UPSTASH_REDIS_REST_TOKEN`                    | Address labels Redis auth token                  |
+| `BLOB_READ_WRITE_TOKEN`                       | Vercel Blob token for daily label backups        |
 
 Production env vars are managed by Terraform — do not edit them in the Vercel dashboard. See [`terraform/`](./terraform/) and [`docs/deployment.md`](./docs/deployment.md).
 
@@ -127,20 +129,24 @@ Contract addresses and ABIs are sourced from the published [`@mento-protocol/con
 
 Each network has a dedicated deploy branch Envio watches:
 
-| Network      | Deploy Branch         |
-| ------------ | --------------------- |
-| Celo Mainnet | `deploy/celo-mainnet` |
-| Celo Sepolia | `deploy/celo-sepolia` |
+| Network       | Deploy Branch          |
+| ------------- | ---------------------- |
+| Celo Mainnet  | `deploy/celo-mainnet`  |
+| Celo Sepolia  | `deploy/celo-sepolia`  |
+| Monad Mainnet | `deploy/monad-mainnet` |
+| Monad Testnet | `deploy/monad-testnet` |
 
 Push to trigger a redeploy:
 
 ```bash
-pnpm deploy:indexer:mainnet
-# or
+pnpm deploy:indexer celo-mainnet
+# or run without args to be prompted:
+pnpm deploy:indexer
+# or push directly:
 git push origin main:deploy/celo-mainnet
 ```
 
-> ⚠️ **Sepolia endpoint changes on each Envio redeploy.** After redeploying the Sepolia indexer, update `hasura_url_sepolia_hosted` in `terraform/terraform.tfvars` and run `pnpm infra:apply`.
+> ⚠️ **Celo Sepolia endpoint changes on each Envio redeploy.** After redeploying the Celo Sepolia indexer, update `hasura_url_celo_sepolia_hosted` in `terraform/terraform.tfvars` and run `pnpm infra:apply`.
 
 ### Dashboard → Vercel
 
@@ -172,8 +178,9 @@ GitHub Actions runs on every PR:
 | Indexer schema                 | `indexer-envio/schema.graphql`               |
 | Event handlers                 | `indexer-envio/src/EventHandlers.ts`         |
 | Contract address resolution    | `indexer-envio/src/contractAddresses.ts`     |
-| Mainnet config                 | `indexer-envio/config.celo.mainnet.yaml`     |
-| Sepolia config                 | `indexer-envio/config.celo.sepolia.yaml`     |
+| Celo mainnet config            | `indexer-envio/config.celo.mainnet.yaml`     |
+| Celo Sepolia config            | `indexer-envio/config.celo.sepolia.yaml`     |
+| Monad mainnet/testnet configs  | `indexer-envio/config.monad.*.yaml`          |
 | Dashboard app                  | `ui-dashboard/src/app/`                      |
 | Address book page              | `ui-dashboard/src/app/address-book/page.tsx` |
 | Address labels API             | `ui-dashboard/src/app/api/address-labels/`   |

SPEC.md

@@ -390,14 +390,14 @@ The dashboard supports multiple network targets via a network switcher. Each net
 - A Hasura admin secret
 - A block explorer base URL
 
-| Target           | Description                 |
-| ---------------- | --------------------------- |
-| `MAINNET_HOSTED` | Celo Mainnet (Envio hosted) |
-| `SEPOLIA_HOSTED` | Celo Sepolia (Envio hosted) |
-| `MAINNET`        | Celo Mainnet (local dev)    |
-| `SEPOLIA`        | Celo Sepolia (local dev)    |
+| Target                | Description                 |
+| --------------------- | --------------------------- |
+| `CELO_MAINNET_HOSTED` | Celo Mainnet (Envio hosted) |
+| `CELO_SEPOLIA_HOSTED` | Celo Sepolia (Envio hosted) |
+| `CELO_MAINNET`        | Celo Mainnet (local dev)    |
+| `CELO_SEPOLIA`        | Celo Sepolia (local dev)    |
 
-The live dashboard (monitoring.mento.org) uses `MAINNET_HOSTED` by default.
+The live dashboard (monitoring.mento.org) uses `CELO_MAINNET_HOSTED` by default.
 
 ---
 
@@ -406,7 +406,7 @@ The live dashboard (monitoring.mento.org) uses `MAINNET_HOSTED` by default.
 | Limitation                           | Details                                                                      |
 | ------------------------------------ | ---------------------------------------------------------------------------- |
 | Endpoint hash changes on each deploy | Envio free tier generates new URL per deploy; requires Vercel env var update |
-| No authentication on dashboard       | Google Auth deferred to last; Hasura secret exposed in client bundle         |
+| No authentication on dashboard       | Google Auth deferred; Envio endpoints are public (no admin secret)           |
 | Cannot run two indexers locally      | Port 9898 hardcoded in Envio                                                 |
 | SortedOracles on Sepolia             | Contracts return zero address; oracle indexing mainnet-only                  |
 | Gap-fill not yet implemented         | PoolSnapshot charts may show gaps for periods with no activity               |

docs/BACKLOG.md

@@ -87,7 +87,7 @@ Indexer schema is complete. These are dashboard-only items.
 
 - [x] Monorepo extraction from devnet repo
 - [x] CI: ESLint 10 + Vitest (53 tests) + typecheck + Codecov
-- [x] `pnpm deploy:indexer:*` scripts
+- [x] `pnpm deploy:indexer [network]` (prompts if no network passed)
 - [x] `pnpm update-endpoint:mainnet` — Vercel env var update after indexer redeploy
 - [x] Discord notification on deploy branch push (`notify-envio-deploy.yml`) — PR #17
 - [x] `AGENTS.md` files for indexer + dashboard

docs/PLAN-celo-mainnet-indexer.md

@@ -88,7 +88,7 @@ The existing schema works for v3 FPMM pools. For v2 BiPoolManager:
 
 1. **Test locally:**
    ```bash
-   pnpm indexer:mainnet:dev
+   pnpm indexer:celo-mainnet:dev
    ```
 2. **Deploy to Envio hosted:**
    - Create `mento-v3-celo-mainnet` on envio.dev (Philip — manual step)
@@ -102,7 +102,7 @@ The existing schema works for v3 FPMM pools. For v2 BiPoolManager:
 
 1. **Set `ACTIVE_DEPLOYMENT["celo-mainnet"]`** in networks.ts
 2. **Add mainnet tokens to contracts.json** (queried on-chain)
-3. **Add Vercel env var:** `NEXT_PUBLIC_HASURA_URL_MAINNET_HOSTED`
+3. **Add Vercel env var:** `NEXT_PUBLIC_HASURA_URL_CELO_MAINNET_HOSTED`
 4. **Set DEFAULT_NETWORK** to `celo-mainnet-hosted`
 5. **Verify network switcher** shows mainnet data
 
@@ -119,7 +119,7 @@ The existing schema works for v3 FPMM pools. For v2 BiPoolManager:
    - Plan: Development (Free)
 2. **Copy the GraphQL endpoint** from Envio dashboard after deployment
 
-3. **Add Vercel env var:** `NEXT_PUBLIC_HASURA_URL_MAINNET_HOSTED=<endpoint>`
+3. **Add Vercel env var:** `NEXT_PUBLIC_HASURA_URL_CELO_MAINNET_HOSTED=<endpoint>`
 
 4. No credentials needed from Philip — Celo mainnet RPC is public (`https://forno.celo.org`), HyperSync is available for chain 42220.
 

docs/PLAN-oracle-health-state-DOD.md

@@ -37,7 +37,7 @@
 
 ### Verification
 
-- [ ] Codegen passes for mainnet config (`pnpm indexer:mainnet:codegen`)
+- [ ] Codegen passes for mainnet config (`pnpm indexer:celo-mainnet:codegen`)
 - [ ] Dashboard builds with zero errors (`pnpm --filter ui-dashboard build`)
 - [ ] All existing tests pass + 15 new tests for health status computation (`pnpm --filter ui-dashboard test`)
 

docs/ROADMAP.md

@@ -39,7 +39,7 @@ Last updated: 2026-03-05
 ### Infrastructure / DX
 
 - [x] CI pipeline — ESLint 10 + Vitest (53 tests) + typecheck + Codecov
-- [x] `pnpm deploy:indexer:*` scripts
+- [x] `pnpm deploy:indexer [network]` (prompts if no network passed)
 - [x] `pnpm update-endpoint:mainnet` — updates Vercel env var via API after indexer redeploy
 - [x] **Discord notification on deploy branch push** (`notify-envio-deploy.yml`)
 - [x] `AGENTS.md` files for indexer + dashboard