Agentic Blockchain Indexing with Envio Cloud
- Envio HyperIndex and the
envio-cloudCLI enable end-to-end agentic deployment of blockchain indexers with no manual config. - An AI agent scaffolded, configured, pushed to GitHub, and deployed a wstETH indexer on Monad Mainnet from a single prompt.
- 400,000 events indexed in approximately 20 seconds.
- Every step is CLI-driven and scriptable, with JSON output for downstream agent logic.
Agentic development works best when an AI agent can take a single prompt and run with it, end-to-end, without handing back to a human at every step. For blockchain indexing, that's exactly what we've built at Envio.
With the Envio Cloud CLI (envio-cloud) and HyperIndex, an agent can scaffold a production-ready indexer, configure it for any EVM-compatible chain, push it to GitHub, and deploy it to Envio Cloud, without a human ever touching a config file.
The result: 400,000 events indexed in ~20 seconds
What is HyperIndex?
HyperIndex is Envio's high-performance blockchain indexing framework. It's designed to make indexing fast to build and even faster to run, with support for EVM-compatible networks and a developer experience built around real workflows.
HyperIndex is the default indexing framework for agentic development with the Envio Cloud CLI tool and comprehensive Claude skills. That means when an AI agent needs to spin up a blockchain data pipeline, HyperIndex is the go-to solution.
The Envio Cloud CLI: envio-cloud
The envio-cloud CLI is the command-line interface for Envio Cloud, the managed infrastructure layer that runs your HyperIndex indexers in production.
With it you can:
- Authenticate via GitHub (
envio-cloud login) - Register a new indexer pointing to your GitHub repo (
envio-cloud indexer add) - Monitor sync progress and deployment status in real-time (
envio-cloud deployment status,envio-cloud deployment metrics) - Promote deployments to production (
envio-cloud deployment promote) - Pull JSON output for any command (
-o json), making it fully scriptable and agent-friendly
No dashboard required. Everything that matters is exposed through the CLI.
End-to-End: Agentic deployment of a wstETH indexer on Monad
Here's the full workflow an agent ran to deploy a live ERC20 indexer for wstETH on Monad Mainnet, start to finish.
Step 1: Scaffold the indexer
pnpx envio init template -t erc20 -l typescript -d ./my-indexer
The envio CLI scaffolds a TypeScript ERC20 indexer template. No API token is needed at this stage as authentication is handled through the hosted service at deployment time.
Step 2: Configure for Monad
The agent edits config.yaml to target the wstETH contract on Monad Mainnet (chain ID 143, contract address 0x10Aeaf63194db8d453d4D85a06E5eFE1dd0b5417, start_block: 0).
Then runs codegen and a type check to confirm everything is clean:
pnpm codegen
pnpm tsc --noEmit
Note: the ERC20 template test file references a different contract address and network, so any resulting type errors need to be fixed before the type check passes.
Step 3: Push to GitHub
Create a public repo and push:
gh repo create wsteth-monad-indexer-demo --public
git init && git add . && git commit -m "init"
git push -u origin main
If the push fails because your GitHub token lacks permission to push workflow files (like .github/workflows/test.yaml), refresh auth with workflow scope:
gh auth refresh -s workflow
Envio Cloud deploys from the envio branch by default, so create and push it:
git checkout -b envio && git push -u origin envio
Step 4: Connect the Envio GitHub Bot
The Envio GitHub App must have access to the repo before deployments will trigger. If the repo is not already linked, visit:
https://github.com/apps/envio-deployments/installations/select_target
Then grant the bot access to the wsteth-monad-indexer-demo repository.
Jordyn Laurier