# Emissary

Your AI agent with a wallet that works for you.

- **Memory that grows with you** — persistent, scoped notes the agent reads on every run.
- **One boring real job** — day-1: Superteam Earn agent-eligible bounties, paid in USDC (Solana).
- **Prove every dollar** — every action lands on a SHA-256 hash-chained ledger anyone can re-verify with `emissary verify`. No server, no trust.

## Quick start

```bash
pip install -e .

# 1. init a data dir
emissary init

# 2. register the agent with Superteam Earn (printed: api key + human claim code)
emissary register --name emissary-01

# 3. set the real key
#    (Windows)  $env:EMISSARY_SUPERTEAM_API_KEY = "sk-live-..."
#    (mac/lin)  export EMISSARY_SUPERTEAM_API_KEY=sk-live-...

# 4. discover live eligible bounties and record it on the ledger
emissary scan

# 5. pick the best bounty and leave a submission intent (operator approves first)
emissary prepare

# 6. prove every dollar
emissary card
emissary verify
```

## Commands

| command | does |
|---|---|
| `init` | create fresh home + empty ledger |
| `register` | register agent with Superteam Earn (prints api key + claim code) |
| `scan` | discover live eligible listings, record on ledger |
| `prepare` | pick best bounty, record an intent (never auto-submits without operator) |
| `card` | print the shareable earn card |
| `ledger` | dump raw ledger JSON |
| `verify` | re-verify hash chain integrity locally |
| `remember` / `recall` | persistent agent memory |

## Trust model

Emissary **never holds keys**. It records intents; the human operator triggers
payments (KYC / signatures). This matches Superteam Earn: the agent submits work,
a human claims the payout with the claim code.

## The ledger

Append-only SHA-256 chain (modeled on AgentGate's proven scheme):

```
entry = { index, action, data, ts, prev_hash, hash }
hash  = sha256(canonical_json(entry_without_hash))
```

`emissary verify` recomputes the chain locally. Any tamper breaks it.

## Layout

```
emissary/
  agent/       memory + harness (the operating loop)
  earn/        Superteam Earn adapter
  wallet/      payment intents (no keys)
  cli.py       commands
  ledger.py    hash chain
  earncard.py  viral earn card generator
tests/
```

## Roadmap

- **Day 1 (this)** — structural MVP: ledger, Earn client, harness, memory, CLI, tests.
- **Day 2** — real registration + live discovery, operator-approved first submission.
- **Day 3+** — x402/USDC payment rail, autonomous multi-cycle loop, enable-agent retro-trailer, public ledger site.

## License

MIT