Tx Explain / aeon skill

Explain a Base transaction in plain English

Decode any Base transaction into a plain-English story - method, token movements, swaps/approvals, counterparties, and suspicious-approval flags. Keyless via Base RPC + Etherscan v2.

CATEGORY BasicsRUNS On demandUPDATED
Skill
Tx Explain tx-explain
Category
Basics
Default schedule
On demand
Last updated

commit ef04cf1
Source
aeonfun/aeon/skills/tx-explain/SKILL.md MIT licensed, one prompt file

What it does

Tx Explain is an aeon skill: Decode any Base transaction into a plain-English story - method, token movements, swaps/approvals, counterparties, and suspicious-approval flags. Keyless via Base RPC + Etherscan v2. Like every aeon skill it is one SKILL.md prompt file that runs unattended on your own GitHub Actions, on a schedule or when you trigger it, and sends what it finds to Telegram, Discord, Slack or email.

Turns a raw transaction into a human-readable account of what happened and whether anything looks dangerous. Runs keyless on public endpoints.

Input: the var setting

Every aeon skill takes one optional text input, var, set in aeon.yml or typed in when you run it by hand. It picks the target or the mode for that run.

Transaction hash (0x..., 66 chars) on Base. Required. If empty, log TX_EXPLAIN_NO_TARGET and exit cleanly (no notify).

What it needs

Besides the model you connected to aeon, Tx Explain uses the following. Add secrets as GitHub Actions secrets on your aeon repo, or in Aeon Connect.

  • ETHERSCAN_API_KEY - optional secret, unlocks more data or features

Install and run it

Easiest: open Aeon Connect, sign in with GitHub and turn on Tx Explain. No clone, no terminal. To add it to an existing aeon repo from a shell, run:

bin/add-skill aeonfun/aeon tx-explain

Then switch it on in aeon.yml (the default schedule is filled in):

skills:
  tx-explain: { enabled: true, schedule: "workflow_dispatch", var: "" }

New to aeon? Read the docs for how skills, schedules and memory fit together, or browse all skills.