algopay-sdk 0.1.0a1

AlgoPay SDK — payment infrastructure for AI agents on Algorand (x402, USDC/ASA, guards)

AlgoPay SDK

Python package (PyPI: algopay-sdk) for AI agent payments on Algorand: local wallets, USDC (ASA) transfers, x402 HTTP 402 flows, guards, ledger, and payment intents.

Status: 0.1.0 alpha (0.1.0a1 on PyPI when published) — APIs and behavior may change. Test coverage is still expanding; see Testing roadmap → 1.0 before relying on this in production.
Source: github.com/Algodev-Studio/algopay-sdk

Install

From PyPI (alpha — pin the version or use --pre):

On PyPI the distribution is algopay-sdk; you still import algopay in code.

pip install "algopay-sdk==0.1.0a1"
# or: pip install --pre "algopay-sdk>=0.1.0a1,<0.2"

From a clone (development):

pip install -e ".[dev]"

Requirements

• Python 3.10+

Environment variables: see docs/ENVIRONMENT.md for a full table (ALGOPAY_NETWORK, Algod/Indexer URLs, USDC ASA ID, Redis, logging, and example-only vars).

Short version:

• ALGOPAY_NETWORK — algorand-mainnet or algorand-testnet (default: testnet)
• Optional: ALGOD_URL / ALGOPAY_ALGOD_URL, INDEXER_URL / ALGOPAY_INDEXER_URL, ALGOPAY_USDC_ASA_ID
• Redis: ALGOPAY_STORAGE_BACKEND=redis, ALGOPAY_REDIS_URL

Quick start

import asyncio
from algopay import AlgoPay
from algopay.core.types import Network

async def main():
    client = AlgoPay(network=Network.ALGORAND_TESTNET)
    ws = client.wallet.create_wallet_set("my-agent")
    w = client.wallet.create_wallet(ws.id)
    # Fund the address with test ALGO + opt-in to USDC, then:
    # client.wallet.opt_in_usdc(w.id)
    # ... acquire USDC ...
    await client.pay(w.id, "RECEIVER58CHARALGORANDADDRESSAAAAAAAAAAAA", "1.0")

asyncio.run(main())

Documentation

• Environment variables
• Publishing (alpha → PyPI)
• Testing roadmap & enterprise readiness
• Legacy OmniAgentPay / arc-merchant reference
• examples/ and the Algorand x402 scheme

License

MIT