axonfi 0.1.0

Python SDK for Axon — treasury and payment infrastructure for autonomous AI agents

axonfi

Python SDK for Axon — treasury and payment infrastructure for autonomous AI agents.

Axon lets bot operators deploy non-custodial vaults, register bot public keys, define spending policies, and let their bots make gasless payments — without bots ever touching private keys or gas.

Installation

pip install axonfi

Quick Start

from axonfi import AxonClient

client = AxonClient(
    vault_address="0x...",
    chain_id=84532,           # Base Sepolia
    bot_private_key="0x...",
)

# Pay 5 USDC — SDK handles decimals automatically
result = await client.pay(
    to="0x...recipient...",
    token="USDC",
    amount=5,
    memo="API call #1234 — weather data",
)

print(result.status, result.tx_hash)

Synchronous Usage (LangChain, CrewAI)

from axonfi import AxonClientSync

client = AxonClientSync(
    vault_address="0x...",
    chain_id=84532,
    bot_private_key="0x...",
)

result = client.pay(to="0x...", token="USDC", amount=5)

Features

• EIP-712 signing for all intent types (payment, execute, swap)
• Async + sync clients — use AxonClient (async) or AxonClientSync
• Human-friendly amounts — pass 5 or "5.2" instead of 5000000
• Token registry — use "USDC" or Token.USDC instead of addresses
• Full relayer API — pay, execute DeFi protocols, swap, poll, check balances

API Reference

AxonClient / AxonClientSync

Method	Description
pay(to, token, amount, ...)	Create, sign, and submit a payment
execute(protocol, call_data, token, amount, ...)	DeFi protocol interaction
swap(to_token, min_to_amount, ...)	In-vault token swap
get_balance(token)	Vault balance for a token
get_balances(tokens)	Multiple balances in one call
is_active()	Whether this bot is active
is_paused()	Whether the vault is paused
get_vault_info()	Owner, operator, paused, version
can_pay_to(destination)	Destination whitelist/blacklist check
poll(request_id)	Poll async payment status

Signing Utilities

from axonfi import sign_payment, encode_ref, PaymentIntent

ref = encode_ref("my memo")
intent = PaymentIntent(bot="0x...", to="0x...", token="0x...", amount=1000000, deadline=1700000000, ref=ref)
signature = sign_payment(private_key, vault_address, chain_id, intent)

Constants

from axonfi import Chain, USDC, Token, KNOWN_TOKENS

chain_id = Chain.BaseSepolia       # 84532
usdc_addr = USDC[chain_id]        # 0x036CbD...
decimals = KNOWN_TOKENS["USDC"].decimals  # 6

Supported Chains

Chain	ID	Status
Base	8453	Mainnet
Base Sepolia	84532	Testnet
Arbitrum One	42161	Mainnet
Arbitrum Sepolia	421614	Testnet

Links

• Documentation
• TypeScript SDK
• GitHub