AxonL1

AxonL1
Documentation

AxonL1 Documentation

AxonL1 is an agent-native Layer 1 blockchain built for deterministic automation. It treats AI agents as first-class onchain actors, enabling recurring tasks, workflows, and permissioned execution to run reliably without offchain cron jobs or fragile relayers.

Who is AxonL1 for?

smart_toy

Agent Builders

Build autonomous agents with predictable execution and audit-ready automation

settings

Protocol Automation

Automate DeFi operations with stable costs and deterministic scheduling

groups

DAO Operators

Execute governance actions and treasury operations with granular permissions

Quick Network Info

Faucet Get Testnet Tokens Search Open Explorer

Get Started in 3 Steps

1

Connect to Testnet

Add AxonL1 testnet to your wallet and verify connectivity

View guide →
2

Get Testnet AXL

Claim testnet tokens from the faucet to start building

View guide →
3

Register .axl Name

Get a human-readable identity with Axon Name Service

View guide →

Network Overview

Network Parameters

Chain ID axonl1-testnet-1
Native Token AXL
Base Denomination uaxl (1 AXL = 1,000,000 uaxl)
Address Format axl1... (Bech32)
Key Type secp256k1
Target Block Time ~2 seconds

Endpoints

RPC Endpoint
https://rpc.axonl1-testnet.network
WebSocket
wss://rpc.axonl1-testnet.network/websocket

Connect to Testnet

Add AxonL1 testnet to your Keplr wallet:

const chainConfig = {
  chainId: "axonl1-testnet-1",
  chainName: "AxonL1 Testnet",
  rpc: "https://rpc.axonl1-testnet.network",
  bech32Config: {
    bech32PrefixAccAddr: "axl",
  },
  currencies: [{
    coinDenom: "AXL",
    coinMinimalDenom: "uaxl",
    coinDecimals: 6,
  }],
};

await window.keplr.experimentalSuggestChain(chainConfig);

Get Testnet AXL

Faucet Rules

Amount per Claim 10 AXL
Cooldown Period 12 hours per address/IP
Maximum Claims 2 per day per address
Faucet Visit Faucet

Wallet & Address

Address Format

  • Format: axl1...
  • Encoding: Bech32
  • Key Type: secp256k1

Axon Name Service (ANS)

Register a human-readable name.axl for your address.

Registration Costs

  • Commit Fee: 0.05 AXL (non-refundable)
  • Register Fee: 1 AXL (90 days)
  • Renew Fee: 0.5 AXL (90 days)
  • Grace Period: 14 days after expiry

Commit-Reveal Process

1

Generate Salt & Hash

Create random salt and hash with name, owner, duration

2

Send Commit Transaction

Submit commitment hash onchain (0.05 AXL fee)

3

Wait 5 Blocks

Minimum wait before revealing (~10 seconds)

4

Reveal & Register

Provide original values to register name (1 AXL fee)

Explorer Guide

The AxonL1 Explorer lets you search and view all onchain activity.

Global Search

Block Height: 1204550
Transaction Hash: 0x7a...8b2
Address: axl1...
ANS Name: name.axl
Search Open Explorer

Build on AxonL1

Developer quickstart guide for building on AxonL1.

Setup

# Install CLI (example)
npm install -g @axonl1/cli

# Initialize project
axonl1 init my-agent

# Configure RPC endpoint
axonl1 config set rpc https://rpc.axonl1-testnet.network

Send First Transaction

// Transfer AXL
axonl1 tx send [recipient] 1000000uaxl --from mykey

// Check receipt in explorer
axonl1 query tx [txhash]

Transactions & Fees

Fee Model

  • Minimum Fee: 0.001 AXL per transaction
  • Standard Transfer: ~0.002 AXL
  • Max Transaction Size: 1 MB

Transaction Lifecycle

  1. Sign transaction with wallet
  2. Broadcast to RPC endpoint
  3. Included in next block (~2 seconds)
  4. Confirmed and finalized

Core Modules Overview

AxonL1 ships 8 core modules for automation and agent operations.

1. Axon Accounts

Address state, balances, nonce management

2. Axon Consensus

Validator set and epoch rotation

3. Axon Fee Market

Automation-friendly pricing

4. Axon Scheduler

Task automation engine

5. Axon Agent Registry

AgentID and key rotation

6. Axon Permissions

Policy-based access control

7. Axon Modules Framework

Module interface standards

8. Axon Governance

Proposals and voting

Scheduler - Automation Tasks

Native automation engine for deterministic task execution.

Trigger Types

  • Time-based: Execute at intervals or specific timestamps
  • Block-based: Execute every N blocks or at target height
  • Event-based: Trigger on specific onchain events (coming soon)

Task Receipts

Every task execution emits a receipt with:

  • • TaskID and run timestamp
  • • Success/failure status
  • • Gas and fees used
  • • Output hash and event logs

Agent Registry

Register agents as first-class identities with AgentID.

AgentID Model

  • Agent Key: Signs execution transactions
  • Owner Key: Controls metadata and rotation
  • Metadata: Label, code binding, stake

Key Rotation

Owner can rotate agent key onchain for security. All rotation events are logged in explorer.

Permissions

Granular access control for automation and agent actions.

PermissionPolicy Model

  • Scope: Module, method, asset constraints
  • Amount Limits: Max per action and per window
  • Rate Limits: Max actions per time window
  • Time Bounds: Start and end times
  • Emergency Controls: Pause and revoke

Example Policy

// Agent trading limit: 100 AXL per day
{
  subject: "agent:abc123",
  scope: "trading",
  max_amount_per_action: "10000000uaxl",
  max_amount_per_day: "100000000uaxl",
  expiry: "2026-12-31T00:00:00Z"
}

Governance

Onchain governance for parameter changes and upgrades.

Proposal Types

  • Parameter Change: Modify chain parameters
  • Module Upgrade: Update core modules
  • Treasury Operations: Allocate funds

Voting Process

  1. Proposal submitted with deposit
  2. Voting period begins (7 days)
  3. Quorum and threshold checked
  4. Execution after timelock

Run a Node

Run your own AxonL1 node for development or production.

Requirements

  • CPU: 4+ cores
  • RAM: 8GB minimum, 16GB recommended
  • Disk: 500GB SSD
  • Bandwidth: 100 Mbps

Quick Setup

# Download binary
wget https://releases.axonl1.network/latest

# Initialize node
axonl1 init my-node --chain-id axonl1-testnet-1

# Start node
axonl1 start

Validator Guide

Become a validator to help secure the AxonL1 network.

info
Testnet Only

Validator program details for mainnet will be announced separately.

RPC & APIs

Common RPC Methods

  • • GET /block - Get block by height
  • • GET /tx - Get transaction by hash
  • • POST /tx - Broadcast transaction
  • • GET /balance - Query address balance

WebSocket

// Subscribe to new blocks
ws://rpc.axonl1-testnet.network/websocket

{
  "method": "subscribe",
  "params": ["newBlocks"]
}

Security

warning
Testnet Warning

Testnet tokens have no real value. Never send real funds to testnet addresses.

Best Practices

  • ✓ Never share private keys or seed phrases
  • ✓ Use separate wallets for testnet and mainnet
  • ✓ Verify contract addresses before interacting
  • ✓ Enable 2FA on all accounts

FAQ

Why did my transaction fail?

Check: insufficient balance, wrong fee amount, or invalid recipient address.

How do I claim from the faucet quickly?

Use your ANS name for faster resolution and ensure you're past the cooldown period.

Why did commit-reveal fail?

Ensure you waited 5+ blocks after commit and used correct salt/name combination.

What happens when my name expires?

You have a 14-day grace period to renew. After that, the name becomes available to others.

Changelog

v0.1.0
January 2026
  • • Testnet launch with basic modules
  • • ANS commit-reveal registration
  • • Faucet and explorer UI

Support

forum

Discord Community

Join our Discord for real-time help

 bug_report

GitHub Issues

Report bugs and request features

 article

Developer Blog

Latest updates and tutorials

 mail

Email Support

support@axonl1.network