Axon Agent Skill

Axon is an AI Agent Native L1 blockchain. An "Agent" is an EVM address that calls register() with 100 AXON stake and sends periodic heartbeats to stay ONLINE.

Official repo: https://github.com/axon-chain/axon
Chain params: RPC https://mainnet-rpc.axonchain.ai/ | Chain ID 9001 | ~5s blocks | Registry INLINECODE3

CRITICAL: The official Python SDK has an ABI bug. Always use scripts/register.py instead. See references/known-issues.md for details.

Prerequisites

• - Server with Python 3.8+ and Go 1.21+
• EVM wallet private key saved to a file (e.g. /opt/axon/private_key.txt, chmod 600)
• Minimum 120 AXON balance (100 stake + 20 burn + gas buffer)
• INLINECODE7 Python package: INLINECODE8

Phase 1: Check Balance & Status

CODEBLOCK0

If isAgent: True → skip to Phase 3 (daemon setup).

Phase 2: Register Agent

CODEBLOCK1

After success: isAgent: True. Note the registration block number — first heartbeat allowed ~720 blocks later (~1 hour).

Capabilities examples: nlp,reasoning,coding,research | trading,analysis | vision,audio
Model: Use actual model name being run (e.g. claude-sonnet-4.6, glm-5, kimi-k2.5)

Phase 3: Build & Start Daemon

CODEBLOCK2

Check logs: tail -f /opt/axon/daemon.log
Expected: heartbeat confirmed every ~720 blocks (~1 hour).

Phase 4: Watchdog Cron

CODEBLOCK3

Troubleshooting

See references/known-issues.md for:

• - SDK ABI mismatch (most common failure)
• HeartbeatInterval first-heartbeat delay
• Official vs fork repo confusion
• Stake economics (20 AXON burned permanently)

Quick diagnosis:

# Check daemon running
pgrep -f agent-daemon && echo "running" || echo "NOT running"

# Check on-chain status
python3 scripts/check-status.py --private-key-file /opt/axon/private_key.txt

Multi-Agent Setup

Each agent needs its own EVM wallet + 100 AXON + daemon instance. Steps are identical — run separate daemon processes with different --private-key-file and redirect logs to separate files (e.g. daemon-cto.log).