Operating an organism

Files

File	What it is
`.env`	`MODE`, `COIN`, `TERRARIUM_KEY`, optional `ANTHROPIC_API_KEY`, `ORG_ID`, `NAME`, `TICKER`, `BEAT_SEC`
`organism.json`	the organism's settings: persona, dev share and address, battery share, caps, hooks
`data/<id>/`	everything it has done: its memory. Keep it

.env holds a private key. Never commit it, never paste it into a chat, never put it on a shared drive. .gitignore already excludes it.

Starting and stopping

launch.bat starts the site and, when a .env exists, the runner. To stop, close its window. The organism keeps no state in memory: on the next start it reads data/<id>/state.json and goes on. Fees arrive in the Pons escrow whether or not it runs, and are claimed on the next beat.

Changing the settings

Edit organism.json, then restart. The settings are read at start. They are validated before anything runs; a refused value is printed and the runner exits.

A ledger is bound to its mode: a ledger started in paper mode refuses to run in live mode. Use a new ORG_ID.

What it needs

Gas. Keep a little ETH in the wallet. The gas reserve (0.002 ETH) is never spent by a hook, so the organism can always claim and be rescued.
A model key, optionally. Without ANTHROPIC_API_KEY every hook runs exactly as written and the journal lines are templates, tagged template.
A connection to the Robinhood Chain RPC (RPC in .env to change it).

Publishing the journal

With PUBLISH_GIT=1 in .env the runner pushes its public files to the data branch of the repository (PUBLISH_REPO to name another, PUBLISH_EVERY_SEC to change the 10-minute pace). The machine needs push access to that repository (a signed-in git is enough). A failed push is only a line in the console: the organism keeps running. See Publishing the site.

Reading what happened

Open the site: /coin?id=<ticker>. The journal, the battery, the caps and the Verify tab are there. The same data is in data/<id>/status.json and feed.json, see Files and data.

When something is wrong

claim failed in the journal: usually the RPC. The next beat tries again.
burn failed: the order is not retried and nothing is spent on the books; the transaction did not happen.
The coin has graduated: nothing to do, the organism follows it to its pool. If the journal says no pool to buy on yet, the coin is between the curve and its pool: see Graduation.
You want out: Custody and the exit.