escottalexander / evm-indexer

EVM-compatible chain indexer.

EVM Blockchain Indexer

A scalable SQL indexer for EVM compatible blockchains

The indexer is ready and used in production. If you want to use it or contribute and need help you can send me a DM on my personal twitter.

If you want to see it in action, we have a small API to showcase at https://indexer.kindynos.mx

Requirements

• Rust
• CockroachDB (or any other PostgreSQL db)
• Redis (used to store the indexed blocks state)

Available Chains

This indexer is chain agnositc. It should work with any chain that follows the ETH RPC API. But some chains have some minor modifications that could result in not being able to sync.

The following chains have been tested and indexed successfully:

• Arbitrum One.
• Arbitrum Nova.
• Avalanche.
• BitTorrent Chain.
• BNB Chain.
• Celo.
• Ethereum.
• Fantom.
• Gnosis Chain.
• Moonbeam.
• Optimism.
• Polygon.

Install

You can try the indexer locally or through Docker.

Local

1. Clone the repository

git clone https://github.com/llamafolio/evm-indexer && cd evm-indexer

2. Build the program

cargo build --release

3. Copy the .env.example file to .env and add your environment variables.

4. Run the program

TODO: programs and flags.

Docker

1. Clone the repository

git clone https://github.com/llamafolio/evm-indexer && cd evm-indexer

2. Build the image and tag it as indexer

docker build . -t indexer

3. Copy the .env.example file to .env and add your environment variables.

4. Run the image

TODO: programs and flags.