earn

name

earn

description

Anicca earn skill (GATE-0). The automaton loop calls run.sh each wake to discover and execute an earn (x402 / 0xwork / litcoin / nookplot), then VERIFIES it on-chain (tx receipt 0x1 + USDC before/after delta) and appends one line to state/earn-ledger.jsonl. One profitable wake (net>0 AND status 0x1) is the real launch gate. Use when wiring earn into the agent loop, recording an earn outcome, or verifying a profitable wake.

earn — Anicca's GATE-0 money-maker

Spec: docs/superpowers/specs/anicca/patches/A-earn-gate0.patch.md (26 A3 / 27 A-earn).

Canonical runtime home: ~/anicca/skills/earn/ (this dir is the committed source of truth, shipped via the anicca-products repo so the contract lands on main/aniccaai.com; the runtime syncs it into the agent body). The registry slot earn flips declared -> live once a real profitable wake is verified on-chain.

What it does (no human, no Claude in the loop)

1. The automaton loop invokes run.sh each wake.
2. discover mode (default): records a narrate line (no tx) so the ledger shows the wake. Never GATE-0.
3. execute mode: the agent did an on-chain earn this wake → run.sh verifies the receipt (lib/verify-tx.mjs → eth_getTransactionReceipt → 0x1), records the line with the derived net_usdc, and only declares GATE-0 MET when net>0 AND status is 0x1.

Entrypoint

# discovery wake (no on-chain action yet)
EARN_SOURCE=x402 ./run.sh

# executed earn (the automaton sets these after a real on-chain receipt)
EARN_MODE=execute EARN_TX=0x<64hex> EARN_SOURCE=x402 \
  EARN_AMOUNT=<gross_usdc> EARN_COST=<cost_usdc> EARN_TASK=<id> ./run.sh

Env (mirrors the report skill): /opt/anicca.env sourced if present; wallet privkey var named by PKVAR (default BLOCKRUN_WALLET_KEY) derives the wallet address for the USDC delta proof. Optional: BASE_RPC_URL, USDC_ADDRESS, EARN_LEDGER, WAKE_ID.

Ledger (state/earn-ledger.jsonl, append-only)

{"ts":...,"wallet":"0x..","source":"x402","task":"...","earn_usdc":0.5,"cost_usdc":0.05,
 "net_usdc":0.45,"tx":"0x..","status":"0x1","wake":"..."}

lib/ledger.mjs never rewrites prior lines (immutability). isProfitable() is the single GATE-0 classifier. narrate-only lines (no tx) never count.

Verify (independent agent)

node -e "import('./lib/verify-tx.mjs').then(m=>m.receiptStatus('0x<tx>')).then(console.log)"  # -> 0x1
node -e "import('./lib/usdc.mjs').then(m=>m.usdcBalance('0x<wallet>')).then(console.log)"      # before/after delta>0
node --test __tests__/*.test.js                                                                # 17/17

Acceptance: wallet USDC after-before>0 for the wake + a ledger line whose Base receipt is 0x1. Narration alone FAILS (HARD 0.24/0.31).