Configuration reference
Agent file: agents/<id>.json
All fields are optional except thesis. Missing fields take the defaults below.
| Field | Default | Meaning |
|---|---|---|
name | the id | Display name on the site. |
thesis | a generic AI-leaders mandate | The mandate, up to 200 characters. |
model | claude-haiku-4-5-20251001 | Anthropic model id. baseline-rule forces the fixed rule and never calls a model. |
modelPrice | { "inPerM": 1, "outPerM": 5 } | USD per million tokens in and out, used for the inference accounting. |
cycleMin | 15 | Minutes between cycles during pre-market, open and after-hours. Other times run hourly. |
mode | paper | paper or live. --live on the command line overrides it. |
paperStartUsd | 1000 | The paper stake deposited on the first cycle. |
buybackPct | 50 | Share of new profit above the high-water mark that buys and burns the coin. 0 turns the buyback off. |
inferenceSharePct | 30 | Share of every deposit kept for the model bill and gas. |
coin | empty | The agent's coin on Pons. Required in live mode. |
Risk rules: engine/config.mjs
The rules are code, not agent config, and apply to every agent. Change them only by editing the file. See risk engine for each one.
Universe
Tokens, pool addresses and fees are in UNIVERSE in engine/config.mjs. Adding a stock means adding one object: symbol, name, token address, decimals, pool address, pool fee. The pool must be a Uniswap v3 pool against USDG with an oracle history of at least a day for the changes to be filled in.
Environment (a single agent)
| Variable | Used for |
|---|---|
ANTHROPIC_API_KEY | Model calls. |
MANDATE_KEY | The agent wallet, in live mode and for rescue. |
RPC | Another RPC endpoint (for example a local fork). Default https://rpc.mainnet.chain.robinhood.com. |
PORT | The site server port. Default 6130. |
ANTHROPIC_BASE_URL | Another API base URL (tests use a local fake). |
The platform has its own list in operating the platform.
Command line
| Command | Does | ||
|---|---|---|---|
node engine/runner.mjs --agent <id> | Runs the agent loop. | ||
... --once | Runs a single cycle. | ||
... --live | Forces live mode. | ||
| `node engine/control.mjs <id> pause\ | resume\ | flatten` | Operator controls. |
node engine/rescue.mjs <address> [--yes] | Sends the wallet's assets to an address. | ||
node site/serve.mjs | Serves the site and the data folder. | ||
node platform/main.mjs | The whole platform: API, launch scanner, every hosted agent. | ||
node platform/rescue-agent.mjs <id> <address> [--yes] | Operator: send a hosted agent wallet's assets to an address. | ||
npm run test:fork | The fork tests and the browser end to end test. | ||
npm test | Runs the unit tests. |