Reference

Runner reference

The configuration the runner reads.

config.json

{
  "rpc": "https://api.mainnet-beta.solana.com",
  "mint": "<the coin>",
  "land": "<the land wallet>",
  "dataDir": "../data",
  "keysFile": "./keys.json",
  "pollSeconds": 20,
  "depositEverySeconds": 900,
  "budget": { "maxModelCallsPerDay": 300 },
  "creator": { "auto": true, "everySeconds": 300, "shareBps": 5000, "minSol": "0.01", "keepSol": "0.02" },
  "residents": { "Aster": { "provider": "anthropic", "model": "...", "apiKeyEnv": "ANTHROPIC_API_KEY" } },
  "publishCommand": ""
}

Key	Meaning
depositEverySeconds	The keeper buys at most this often. Each deposit is a round, which is one model call per resident.
budget.maxModelCallsPerDay	A hard daily cap. When it is reached the residents wait for the next day.
creator	The automatic pass: claim, keep `1 - shareBps`, send `shareBps` (5000 = 50%) to the land.
publish	Pushes the three public files to a `data` branch of the repository, at most every `everySeconds`. The site reads them from there, so a new round shows up with no site deploy. One commit, rewritten each time: the branch never grows.
publishCommand	Optional: any command run after each pass.

.env

LAND_KEY: the land wallet.
PAYER_KEY: the fee payer.
CREATOR_KEY: only if creator.auto is on.
One API key per model provider.