RPC Defaults

Curated PublicNode endpoints shipped for QTG quickstart evaluation.

RPC Defaults

QTG ships a curated PublicNode-based default RPC endpoint table so a fresh quickstart can talk to the EVM lanes without operator setup. Per-chain entries in MG_EVM_RPC_ENDPOINTS_JSON always win; defaults fill the gaps.

Knobs

Variable	Default	Purpose
MG_EVM_RPC_USE_DEFAULTS	true	When false, the default table is ignored entirely. Set this in air-gapped or regulated environments.
MG_EVM_RPC_ENDPOINTS_JSON	{}	Per-chain override. Keys are decimal-string chain ids. Values are URLs or list-of-URLs.

Override patterns

Override a single chain (Alchemy mainnet) while keeping defaults for the rest:

MG_EVM_RPC_ENDPOINTS_JSON='{"1":"https://eth-mainnet.g.alchemy.com/v2/<key>"}'

Failover via list:

MG_EVM_RPC_ENDPOINTS_JSON='{"1":["https://primary","https://fallback"]}'

Disable all defaults:

MG_EVM_RPC_USE_DEFAULTS=false
MG_EVM_RPC_ENDPOINTS_JSON='{"1":"https://your-rpc"}'

Empty / null entries

{"8453": []} and {"8453": null} are treated as unregistered — the default URL fills the gap. There is no per-chain “no endpoint” sentinel. To block defaults for one chain, use the global MG_EVM_RPC_USE_DEFAULTS=false switch and provide only the chains you want.

CCIP path is excluded

CCIP uses chain_selector (a CCIP-specific identifier) as its primary key, not chain_id. The shipped default table is keyed by chain_id, so CCIP lanes do not benefit. CCIP operators must explicitly populate MG_CCIP_EVM_RPC_ENDPOINTS_JSON with chain_selector keys.

Live broadcast tools

Live preflight / drill / e2e CLI tools (gateway_live_preflight, gateway_live_e2e, cctp_live_preflight, agent_wallet_topup_preflight, agent_wallet_topup_stage3_live, run_stargate_send_drill) force use_defaults=False internally. They never use PublicNode defaults, even if MG_EVM_RPC_USE_DEFAULTS=true. The operator must provide explicit, production- grade RPC URLs before running these tools — PublicNode rate-limits could break a live broadcast mid-flight.

Shipped chains

The authoritative list lives in src/qtg/infrastructure/rpc/defaults.py. Mainnet and testnet entries are intermixed; the file docstring documents provenance and maintainer instructions.

Reliability boundary

PublicNode endpoints are rate-limited and free. They are intended for evaluation. Production deployments should switch to a paid provider per chain (Alchemy, Infura, QuickNode, or self-hosted) before sending live transfers.