Settings reference

organism.json

All keys are optional; a missing key takes its default. Values outside the limits are refused when the runner starts.

{
  "persona": "quiet",
  "creatorSharePct": 50,
  "creatorAddress": "0x...",
  "batterySharePct": 30,
  "fullUsd": 5,
  "caps": {
    "maxBurnPerDayEth": 0.05,
    "maxOrderPctTreasury": 25,
    "minOrderEth": 0.0005,
    "cooldownMin": 30
  },
  "hooks": {
    "buybackDrip": { "on": true, "dripPct": 10 },
    "dipDefender": { "on": true, "dropPct": 8, "windowMin": 60, "spendPct": 20 },
    "say": { "on": true }
  }
}

Limits

Setting	Range	Default
`creatorSharePct`	0 to 90	0 in the engine, 50 from the launch page
`creatorAddress`	an address, required when the share is above 0	none
`batterySharePct` (of what is left after the dev share)	10 to 60	30
`fullUsd`	0.5 to 50	5
`caps.maxBurnPerDayEth`	0.001 to 5	0.05
`caps.maxOrderPctTreasury`	5 to 50	25
`caps.minOrderEth`	above 0	0.0005
`caps.cooldownMin`	5 or more	30
`hooks.buybackDrip.dripPct`	1 to 50	10
`hooks.dipDefender.dropPct`	2 to 60	8
`hooks.dipDefender.windowMin`	10 to 1440	60
`hooks.dipDefender.spendPct`	1 to 50	20
minimum payout (fixed)		0.0005 ETH
gas reserve (fixed)		0.002 ETH

.env

Key	Meaning
`MODE`	`live` or `paper` (default `paper`)
`COIN`	the Pons coin address (required in live mode)
`TERRARIUM_KEY`	the organism wallet's private key (required in live mode)
`ANTHROPIC_API_KEY`	optional: enables the mind
`ORG_ID`, `NAME`, `TICKER`	identity, used for the data folder and the site
`BEAT_SEC`	seconds between beats, default 600
`PAPER_FEES_ETH`	paper mode only: simulated fees per beat
`PUBLISH_GIT`	`1` to push the public files to the `data` branch of the repository every 10 minutes
`PUBLISH_REPO`, `PUBLISH_BRANCH`, `PUBLISH_EVERY_SEC`	the repository (default: the folder's `origin`), the branch (default `data`), the pace in seconds
`RPC`	the Robinhood Chain RPC URL, if you do not want the public one

Commands

Command	What it does
`node engine/runner.mjs`	runs one organism
`node site/serve.mjs`	serves the site on port 6150 (`PORT` to change)
`node engine/rescue.mjs <to> [--yes]`	claims and sends everything out, see Custody
`node tools/build-docs.mjs`	rebuilds these pages from `docs/*.md`

Fixed addresses (Robinhood Chain, id 4663)

What	Address
Pons factory	`0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7e`
Pons fee escrow	`0xd3AFEB2a57f70eF218Aa82451c51B2fb0416Ac9e`
Burn address	`0x000000000000000000000000000000000000dEaD`
ETH/USD pool (WETH/USDG, 0.01%)	`0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca`
Universal Router	`0x8876789976decbfcbbbe364623c63652db8c0904`
Uniswap v4 PoolManager	`0x8366a39cc670b4001a1121b8f6a443a643e40951`
Pons v4 hook (graduated coins)	`0xe5e702641ea86f4ae6cc3cdaed2b886f976be044`