Distribute Tokens / aeon skill

Agent that pays contributors in tokens

Two-phase contributor rewards - plan builds a tier-priced payout from the repo's merged-PR ranking; send executes it on-chain via Bankr Wallet API with per-recipient idempotency and dry-run.

CATEGORY Crypto & MarketsRUNS On demandUPDATED
Skill
Distribute Tokens distribute-tokens
Default schedule
On demand
Last updated

commit e1d9284
Source
aeonfun/aeon/skills/distribute-tokens/SKILL.md MIT licensed, one prompt file

What it does

Distribute Tokens is an aeon skill: Two-phase contributor rewards - plan builds a tier-priced payout from the repo's merged-PR ranking; send executes it on-chain via Bankr Wallet API with per-recipient idempotency and dry-run. 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.

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.

Phase + target selector. Grammar: [plan:|all:][dry-run:]<target>

  • ` (empty) / <label> / dry-run:<label> → **send** phase: distribute a list from memory/distributions.yml` (empty = first list). [default - no prefix]
  • plan: / plan:<week> / plan:dry-run / plan:dry-run:<week> → plan phase only: compute rewards from the repo's merged PRs and write the list into memory/distributions.yml.
  • all: / all:<week> / all:dry-run / all:dry-run:<week> → plan then send in one run.

<label> is a distribution-list label (e.g. contributors-2026-W17). <week> is an ISO week (2026-W17); empty <week> = most recent completed ISO week. dry-run: previews without side effects (no yml/state writes in plan; no transfers in send).

What it needs

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

  • BANKR_API_KEY - optional secret, unlocks more data or features

Install and run it

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

bin/add-skill aeonfun/aeon distribute-tokens

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

skills:
  distribute-tokens: { enabled: true, schedule: "workflow_dispatch", var: "" }

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