Build custom blockchain APIs and analytics. Real-time, with enterprise SLAs.
Documentation · Envio Cloud · Benchmark · Build with AI · Discord · Contact sales
HyperIndex is Envio's blockchain indexing framework. Choose the contracts and events to track, write TypeScript handlers that shape the data, and HyperIndex keeps it up to date across EVM chains, Solana and Fuel, handles chain reorgs, and serves the result as a GraphQL API or direct Postgres/ClickHouse SQL.
It reads chain data through HyperSync, Envio's blockchain data API, which is up to 2,000x faster than JSON-RPC. Run it yourself with Docker, or deploy to Envio Cloud. Cloud starts with a free development plan and scales with your project up to Dedicated infrastructure with a 99.99% uptime SLA.
Most blockchain indexers are bottlenecked by RPC. HyperIndex isn't. HyperSync, the data engine underneath, is a purpose-built, Rust-based query layer that retrieves multiple blocks per round trip, cuts out the overhead, and makes historical backfills genuinely fast.
The open indexer benchmark tracks current speed results across scenarios, and HyperIndex passes every reliability check. Every number there comes from code in the repository, so you can run it yourself.
HyperIndex and HyperSync are the data layer for DeFi dashboards, protocol analytics, block explorers, stablecoin monitors, liquidation trackers, oracle comparisons, NFT explorers, and any application that needs fast, structured onchain data.
A few apps built with them, from the showcase:
- v4.xyz: the hub for Uniswap V4 data and analytics, indexed in real time across chains
- Stable Volume: real-time stablecoin transaction monitoring across chains
- Stable Radar: real-time USDC transaction dashboard across multiple chains
- Liqo: multichain liquidation tracking for DeFi lending protocols
- Oracle Wars: real-time oracle price comparison across multiple oracles
- Chain Density: transaction and event density analysis for any address across chains
- LogTUI: terminal UI for monitoring blockchain events in real-time
Performance
- Historical backfills at 100,000+ events per second (benchmarking)
- Up to 2,000x faster than JSON-RPC via HyperSync (on by default, no config required)
- Fallback RPC support for reliability without touching your indexer code
Multichain indexing
- Index EVM, SVM, and Fuel blockchains from a single indexer
- Every chain on the HyperSync network list, plus any EVM chain via RPC
- Real-time indexing with reorg handling built in
Developer experience
- Auto-generate an indexer directly from a smart contract address or ABI, no manual setup required
- Write handlers in TypeScript or ReScript, and plain JavaScript handler files load too
- Full local development environment with Docker
- GraphQL API generated automatically from your schema
- Wildcard topic indexing: index by event signatures across any contract, not just specified addresses
- Factory contract support for dynamically registered contracts
- Onchain and off-chain data integration
- External API actions triggered by blockchain events
- Detailed logging and error reporting
Deployment
- Envio Cloud, managed hosting with static endpoints and built-in alerts, from a free development plan up to Dedicated deployments with an SLA of up to 99.99% uptime
- Self-hosted via Docker
- No vendor lock-in. Switch between HyperSync and RPC at any time
Agentic development
- Build and deploy with an AI agent using the Envio Cloud CLI (
envio-cloud) and the HyperIndex skills thatenvio initadds to every project - An agent can scaffold, configure, and deploy a production-ready indexer without touching a config file. 400,000 events indexed in ~20 seconds
- Powerful built-in testing framework purpose-built for AI-driven development. Agents can write, run, and iterate on handler tests in a tight feedback loop, catching regressions before deploy
Requirements: Node.js 22.15 or newer, and Docker for local development. pnpm is recommended.
pnpx envio initThis scaffolds your entire indexer project, config, schema, and handler functions, in seconds. You can generate from a contract address, choose from templates, or start from an existing example.
From there, three files define your indexer:
config.yaml: networks, contracts, events, and indexing behaviourschema.graphql: the shape of your indexed datasrc/handlers: your handler logic in TypeScript, JavaScript, or ReScript
HyperSync is the data engine that makes HyperIndex fast. It's active by default for all supported networks, no configuration needed.
Instead of making individual RPC calls per block, HyperSync retrieves multiple data points per round trip with advanced filtering. The result is sync speeds up to 2,000x faster than JSON-RPC, lower infrastructure costs, and no rate limits to work around on supported networks.
HyperSync can also be used directly for custom data pipelines in Python, Rust, Node.js, and Go, independent of HyperIndex.
HyperIndex supports any EVM-compatible L1, L2, or L3, plus Fuel and Solana. Chains on the HyperSync network list get first-class HyperSync support. For any EVM chain not on the HyperSync list, RPC-based indexing works out of the box. Solana indexing runs on HyperSync for Solana, with instruction-level handlers and IDL-aware decoding.
The migration guides cover config conversion, schema mapping and query differences, and you can migrate with an AI agent. If you run subgraphs, Envio can also migrate and host them for you with Subgraph Hosting, while your applications keep querying a subgraph-compatible endpoint. For hands-on help, see services or ask on Discord.
Full documentation lives at docs.envio.dev.
Key sections:
- Getting Started
- Contract Import / Auto-generation
- Multichain Indexing
- Wildcard Indexing
- Reorg Support
- Envio Cloud
- HyperSync as Data Source
- Migration Guide
HyperIndex works with Claude Code, Cursor, Codex and other coding agents.
- Docs for agents. Point your agent at llms.txt, or the full text at llms-full.txt.
- Docs MCP server. Add
https://docs.envio.dev/mcpto your agent fordocs_searchanddocs_fetch. See the MCP server guide. - Skills.
pnpx envio initadds the HyperIndex skills to every new project. After upgradingenvio, runpnpm envio skills updateto refresh them. - Quickstart. Follow Quickstart with AI to go from a contract address to a deployed GraphQL API.
- Follow us on X
- Join the Discord or Telegram, the fastest ways to get help
- Open an issue on GitHub
- Browse common issues for quick troubleshooting
If HyperIndex is useful to you, a ⭐ on this repo goes a long way.