Configuration Reference

Environment variables and runtime configuration for HDP

HDP reads runtime configuration from environment variables.
The CLI loads .env automatically.

RPC endpoints

RPC_URL_ETHEREUM_MAINNET=
RPC_URL_ETHEREUM_TESTNET=
RPC_URL_OPTIMISM_MAINNET=
RPC_URL_OPTIMISM_TESTNET=
RPC_URL_STARKNET_MAINNET=
RPC_URL_STARKNET_TESTNET=
RPC_URL_HERODOTUS_INDEXER=https://rs-indexer.api.herodotus.cloud/

RPC_URL_HERODOTUS_INDEXER points to the Herodotus Indexer, used for header commitment proof retrieval.

Injected state

INJECTED_STATE_BASE_URL=http://localhost:3000

Set this explicitly when using injected state.

See injected-state flow details in State management and State Server.

Validate environment for a run

hdp env-check --inputs dry_run_output.json

This checks only the RPC endpoints required by the specific key set in that dry-run output.

Logging

Use either:

• --log-level <LEVEL> / --debug
• RUST_LOG=<LEVEL>

Advanced

• HDP_SOUND_RUN_PATH - override compiled sound-run program path