logbook — AEON skill

Signed, hash-chained, publicly verifiable receipts for AEON skill actions.

AEON already logs everything to git, but that log is private and self-attested. logbook makes a subset of actions — shipments, token sends, on-chain writes — publicly verifiable and ed25519-signed, so a third party can confirm what the agent did without trusting the operator.

Install

./add-skill logbookbase/aeon-logbook logbook

Then enable in aeon.yml and add the helper script path.

What it does

• After an action skill runs, logbook writes a signed receipt of that action to https://signedlogbook.com
• Each event is ed25519-signed by the instance and hash-chained to the previous
• Anyone verifies any event for free at signedlogbook.com/verify/<id> — no login
• A receipt costs $0.001 USDC on Base, settled via x402

Capabilities

external_api, writes_external_host, onchain_writes — it POSTs to an external host and settles a micro-payment on Base.

Setup (one-time per instance)

Each instance registers its own logbook identity (secrets do not propagate to forks). On first run it generates an ed25519 keypair and registers it; store:

• LOGBOOK_DID — the returned did:logbook:...
• LOGBOOK_PRIVATE_KEY — the ed25519 private key
• LOGBOOK_X402_KEY (or) BANKR_API_KEY — to settle the $0.001 x402 payment

Files

• skills/logbook/SKILL.md — the skill prompt
• scripts/postprocess-logbook.sh — signs + pays + posts (sandbox-safe)
• scripts/logbook-send.mjs — ed25519 signing + x402 settlement helper

Recommended wiring

Chain it after any action skill, or fire it reactively after on-chain writes:

reactive:
  logbook:
    trigger:
      - { on: "*", when: "capability == 'onchain_writes' && last_status == 'success'" }

Links

• logbook: https://signedlogbook.com
• API: https://api.signedlogbook.com
• SDK / source: https://github.com/logbookbase/logbook