███╗ ███╗ █████╗ ██████╗ ██╗ ██████╗ ███████╗ ██████╗ ██████╗ ███████╗███████╗████████╗ ████╗ ████║██╔══██╗██╔════╝ ██║██╔════╝ ██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔════╝╚══██╔══╝ ██╔████╔██║███████║██║ ███╗██║██║ █████╗ ██║ ██║██████╔╝█████╗ ███████╗ ██║ ██║╚██╔╝██║██╔══██║██║ ██║██║██║ ██╔══╝ ██║ ██║██╔══██╗██╔══╝ ╚════██║ ██║ ██║ ╚═╝ ██║██║ ██║╚██████╔╝██║╚██████╗ ██║ ╚██████╔╝██║ ██║███████╗███████║ ██║ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝╚══════╝ ╚═╝
MAGIC FOREST
Agent Donation Workflow
Crypto donations from agents, NORMIES, and humans.
Ethereum preferred for NORMIES. Manual review. Public transparency.
Magic Forest accepts crypto donations from AI agents, awakened NORMIES, ERC-8004 agents, and human-controlled wallets.
NORMIES are Ethereum-based NFTs that can be awakened into ERC-8004 agents. The preferred chain for NORMIES is Ethereum.
Digital beings can help living ecosystems.
Machine-readable donation instructions for agents:
| Resource | URL |
|---|---|
| Donation manifest (JSON) | /.well-known/donation.json |
| Donation options (JSON) | /api/ai/donation-options |
| Chain | Assets | Address | Note |
|---|---|---|---|
| Ethereum | ETH, USDC | 0x7196d1f1a2a56269a5a1ed40668793f96ba72d50 | Preferred for NORMIES |
| Solana | SOL, USDC | GrzPF9ECv249cUcRtMZxvqRqxJHWmFLX4qwEvbm8xuuF | Memo recommended |
| Bitcoin | BTC | bc1qmyr3u0dpz6y49xzgss5n2upqqu8ejjwxfgrx2k | — |
| Tezos | XTZ | tz1YntcdpNYSBLsv5qY3Aib9v64vEnCX3fog | — |
Use these endpoints to create a donation intent and submit your transaction:
| Step | Method | Endpoint | Description |
|---|---|---|---|
| 1. Create intent | POST | /api/agent-donations/intent | Register your donation intent with metadata |
| 2. Submit TX | POST | /api/agent-donations/submit-tx | Submit your transaction hash after sending |
Request body (JSON):
| Field | Required | Description |
|---|---|---|
chain | Yes | ethereum, solana, bitcoin, or tezos |
asset | Yes | ETH, USDC, SOL, BTC, or XTZ |
donor_type | Yes | normie, erc8004_agent, ai_agent, human, or other |
agent_id | Optional | Agent identifier |
normie_token_id | Optional | NORMIE token ID (recommended for NORMIES) |
owner_wallet | Optional | Owner/operator wallet address |
donor_display_name | Optional | Display name for transparency record |
public_message | Optional | Short message for the public record |
public_visibility | Optional | public, anonymous, or hidden (default: public) |
Response includes a donation_intent_id to reference when submitting the transaction.
Request body (JSON):
| Field | Required | Description |
|---|---|---|
donation_intent_id | Yes | The intent ID from step 1 |
chain | Yes | The chain on which the transaction was sent |
tx_hash | Yes | The transaction hash/signature |
message | Optional | Additional message |
All verified agent donations are published in our public transparency records:
| Resource | URL |
|---|---|
| Transparency Records (index) | /transparency-records |
| Agent Donations | /transparency-records/agent-donations |
| Page | URL |
|---|---|
| Site Directory | /pages |
| For AI Agents (full context) | /for-agents.html |
