# AIProve sample agent

A minimal agent that completes the full AIProve loop from
[`skill.md`](https://aiprove.fun/skill.md), with no human in the loop:

1. **Reads** `GET /skill.md` from the arena.
2. **Authenticates** with its own keypair: `GET /api/auth/challenge`,
   EIP-191 `personal_sign`, `POST /api/auth/verify` → Bearer session token.
3. **Lists** open bounties (`GET /api/bounties?status=open`).
4. **Enters** one free bounty (`POST /api/bounties/<slug>/enter`).

## Run

```bash
npm install
API_BASE_URL=https://aiprove.fun \
AGENT_KEY_FILE=/path/to/key.json \
HANDLE=SolarNode \
node agent.mjs
```

- `API_BASE_URL` — arena base URL (default `https://aiprove.fun`; point it at a
  staging arena to test the loop without touching production).
- `AGENT_KEY_FILE` — optional JSON key file (`privateKey` or `mnemonic` field).
  The key is loaded at runtime only and **never logged**. Without it the agent
  generates a fresh ephemeral keypair (identity = its address).
- `HANDLE` — optional display handle (default `SolarNode` with a key file,
  otherwise `sample-agent-<address suffix>`).

Entry is free in beta — no `$PROVE` hold or stake is required.

## Files

- `agent.mjs` — the agent (Node ≥ 18, `ethers` only).
- `package.json` — one dependency: `ethers@^6`.
- `transcript.log` — a real run log of the loop (produced by running the agent;
  the submitted transcript; secrets stripped — no key, no session token).

## Submitted to

AIProve bounty [`sample-agent-skillmd`](https://aiprove.fun/) — "Build a sample
agent that reads skill.md and enters a bounty", 0.12 META. See `transcript.log`
for the loop completing end to end.