Local Indexer Instance Configuration Tool

WHAT IT DOES

Local Indexer Instance Configuration Tool generates environment variable configurations and subgraph definition files for local indexer instances. You provide your chain's RPC URL, chain ID, chain name, starting block, contract addresses with ABIs, and optional database and extra environment settings. The tool generates a complete configuration file with all required environment variables, plus a subgraph.yaml template if you're using The Graph. The configuration includes chain-specific settings, contract addresses, ABI references, database connection details, and indexer feature flags. This saves hours of manually writing configuration files and subgraph manifests for local blockchain indexing, letting you focus on building your application rather than wrestling with indexer infrastructure.

HOW TO USE

Select your indexer type (The Graph Subgraph or Custom Indexer). Enter your chain name, chain ID, RPC URL, and starting block number. Add contracts to index—one per line in the format "name | address | abi" (ABI is optional for custom indexers). Optionally add database configuration variables (key=value per line) and any extra environment variables your indexer requires. Click "Generate Indexer Configuration." The tool builds a complete environment configuration file with all required variables, displays a summary of the generated settings, and shows the configuration file as a preview. For The Graph subgraphs, the tool also generates a subgraph.yaml template with data sources for each contract. Use the copy button to copy the config file to your clipboard.

THE REAL MECHANISM

The tool uses a pure JavaScript template engine that operates entirely client-side. It selects a configuration template based on the indexer type: for The Graph subgraphs, it generates a subgraph.yaml file with data sources for each contract, including the contract address, ABI reference, start block, and a placeholder event handler. For custom indexers, it generates a flat environment variable file with chain configuration and contract addresses. The tool constructs the environment variable map from user input, merges database settings and extra environment variables, and formats the output as a .env file. The subgraph.yaml template includes the required spec version, schema reference, and mapping configuration for each contract. All processing is done in the browser—no data is sent to external servers.

WHAT IT CANNOT SEE

This tool cannot start or stop indexer instances—it only generates configuration files. It cannot detect if the indexer service is actually running or if the database is properly initialized. It cannot validate that the generated configuration will work with the user's specific environment, operating system, or Docker setup. It cannot generate configurations for non-EVM indexers. It cannot deploy the indexer automatically—you must run docker-compose or start the service yourself. It cannot handle database migrations, schema creation, or setup tasks. It cannot sync historical data automatically—you must trigger the indexer to start syncing. The tool does not verify that the RPC URL is reachable or that the contract addresses are valid.

PLEASE NOTE

Local Indexer Instance Configuration Tool works for any EVM-compatible local chain and does not require a blockchain connection to function, though the network selector is provided for context. It is a configuration tool for developers, not an execution tool. It reads data only and does not send any information to external servers. The tool is free to use and does not require authentication. For best results, ensure your local chain is running and accessible before starting the indexer, and have your contract ABIs ready for The Graph subgraphs.