Configuration Reference

Full reference for ~/.moly/config.json schema and environment.

Config file

All settings live in ~/.moly/config.json. The file is created on first run with permissions chmod 600 (owner read/write only).

~/.moly/config.json schema

{
  "network": "hoodi" | "mainnet",
  "mode": "simulation" | "live",
  "rpc": "https://custom.rpc" | null,
  "privateKey": "0x..." | null,
  "ai": {
    "provider": "anthropic" | "google" | "openrouter" | null,
    "apiKey": "sk-...",
    "model": "claude-sonnet-4-6"
  } | null,
  "setupComplete": true
}

Fields

Field	Type	Description
network	"hoodi" \| "mainnet"	Which chain to connect to
mode	"simulation" \| "live"	Simulation = dry_run default. Live = real transactions.
rpc	string \| null	Custom RPC URL. null = use network default.
privateKey	string \| null	0x-prefixed private key. Required for live write transactions.
ai.provider	string \| null	anthropic, google, or openrouter
ai.apiKey	string	API key for chosen provider
ai.model	string	Model ID (e.g. claude-sonnet-4-6)

Chain addresses

Contract	Hoodi Testnet	Ethereum Mainnet
Chain ID	560048	1
stETH	0x3508A952...176a	0xae7ab965...84
wstETH	0x7E99eE3C...De4	0x7f39C581...a0
Voting	0x49B3512c...01B	0x2e59A20f...8e

⚠

Holesky testnet is deprecated and not supported. Use Hoodi for all testnet operations.

Security model

The private key and AI API keys are stored only in ~/.moly/config.json on your local machine. They are:

Never printed to stdout or stderr
Never sent to any remote server by Moly
Never changeable via the MCP update_settings tool
Only accessible to your OS user (chmod 600)

To rotate your private key or API key, run moly setup and re-enter them.