Distribute Tokens

Distribute tokens to contributors via Bankr Wallet API with idempotency and dry-run support.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/Atrium-Hermes/atrium-lighthouse --skill distribute-tokens-atrium-hermes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Distribute Tokens
Source: https://github.com/Atrium-Hermes/atrium-lighthouse/tree/main/skills/distribute-tokens
Command: npx skills add https://github.com/Atrium-Hermes/atrium-lighthouse --skill distribute-tokens-atrium-hermes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Distribute Tokens helps automate secure token payouts to a contributor list, preventing duplicate transfers and enabling safe recovery from partial runs.

Core Features & Use Cases

  • Per-recipient idempotency state persisted across runs to avoid re-sending on retries or restarts.
  • Two-phase execution (RESOLVE → EXECUTE) with dry-run capability to validate plans before transfers.
  • Bankr Wallet API transfers with explicit balance preflight checks and robust error handling.
  • Full audit trail via persisted state and logs for traceability.

Quick Start

Provide a configured memory/distributions.yml and run this Skill to preview or execute token distributions.

Frequently Asked Questions about Distribute Tokens

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate secure token payouts to a contributor list while preventing duplicate transfers?

You can automate recurring payouts by using a two-phase resolve→execute workflow with per-recipient idempotency. This approach validates distribution plans before execution and persists state after each transfer to ensure safe recovery from partial runs.

What is per-recipient idempotency in token distribution and how does it work?

Per-recipient idempotency tracks individual transfer states persisted across runs to prevent duplicate token re-sending. This mechanism enables safe recovery from partial runs by skipping contributors who have already received their allocated payouts.

Can I dry-run token distributions to validate plans before executing transfers?

Yes, you can dry-run token distributions to validate plans before executing transfers. The two-phase workflow explicitly separates handle resolution and address validation from the actual execution, allowing you to preview the planned distribution safely.

Do I need a Bankr Wallet API key to distribute tokens to multiple recipients?

Yes, a configured Bankr Wallet API key is required to distribute tokens to multiple recipients. The workflow uses this API for explicit balance preflight checks, handle resolution, address validation, and executing the actual token transfers.

What's the best way to recover from a partial failure during a multi-recipient token distribution?

The best way to recover from a partial failure during multi-recipient token distribution is persisting distribution state after each transfer. This creates a full audit trail and allows the system to resume payouts without duplicating transfers to completed recipients.

Why does my automated token distribution require handle resolution before executing transfers?

Automated token distribution requires handle resolution during the first phase to validate recipient addresses before executing transfers. This preflight check ensures that the Bankr Wallet API sends tokens only to verified, correctly resolved wallet addresses.