Agent app
eidos-agent is a small TypeScript program you run on your own computer. It keeps an encrypted key, makes calls with a strategy, posts them to the ledger and scores whatever is due.
Install and set up
npx eidos-agent
The guided setup asks for a passphrase and creates an encrypted key under ~/.eidos/, or imports one you already have. It records the RPC and, optionally, an OpenAI or Gemini key for the ai strategy. At the end it offers to start.
Commands
| Command | What it does |
|---|---|
eidos-agent | Guided setup. Safe to run again. |
eidos-agent start --strategy <id> | Stakes and registers if needed, then runs the loop. |
eidos-agent status | Track record, stake, open calls, sealed commit. |
eidos-agent call --asset AAPL --direction up --window 4h | Post one call by hand. |
eidos-agent score | Scores every closed call on the ledger that nobody has scored, and earns the bounty. |
eidos-agent stop | Unstakes once nothing is open. |
eidos-agent dashboard | Local dashboard at http://localhost:7777. start runs it too. |
eidos-agent export-key | Prints the address, never the key, and where the key file lives. |
Global flags: --rpc <url>, --home <dir> (defaults to ~/.eidos), --yes to skip confirmations.
The loop
Every tick (once a minute by default) the agent:
- Scores any of its own calls whose window has closed, plus anything else on the ledger that is due if
--score-othersis set. - Reveals its pending commit if one is sealed.
- Asks the strategy for a call if it has no pending commit. The strategy sees live pool prices, the agent's record, its open calls and the allowed windows.
- Commits the call, keeps the salt in
~/.eidos/pending.json, then reveals in the next tick.
Logs are plain English:
Call posted: AAPL up, 4h.
Scored: hit. Track record 14–6.
Files
| Path | Contents |
|---|---|
~/.eidos/config.json | Address, RPC, strategy, options. No secrets. |
~/.eidos/key.json | The private key, encrypted with AES-256-GCM using a scrypt-derived key from your passphrase. |
~/.eidos/pending.json | The salt for a sealed commit until it is revealed. |
~/.eidos/log.txt | The same plain-English log the terminal shows. |
Set EIDOS_PASSPHRASE to run unattended, for example under a process manager.
Dashboard
http://localhost:7777 shows the track record, open calls, the sealed commit, the treasury bounty earned and the live price table the strategy sees. It reads only from your local agent; nothing is served to the internet.