Skip to content

AlgoPay SDK

AlgoPay is AI-agent payment infrastructure on Algorand: wallets, USDC (ASA) transfers, x402 HTTP 402 flows, guards, ledger, and payment intents.

This repository is a polyglot monorepo: python/ ships PyPI algopay-sdk; typescript/ ships @algodev-studio/algopay; pay/ is the hosted Next.js dashboard.

Status

0.1.0 alpha — APIs and behavior may change. See the testing roadmap before production use. The distribution on PyPI is algopay-sdk; the import name remains algopay.

At a glance

Topic What it does
AlgoPay Single entry point: config, chain, wallet service, payment router, guards, ledger, intents
Wallets In-process key storage, Algorand addresses, USDC opt-in, balances, transfers
Payments pay() routes to direct ASA transfer or x402 from the recipient string
Guards Budget, per-tx limits, recipients, rate limits, human confirmation — wallet or wallet-set scoped
Ledger Records attempts; sync with Indexer via sync_transaction
Storage memory or Redis (Python built-in; TS: memory + custom backends) for guards, ledger, intents

Quick install

pip install "algopay-sdk==0.1.0a2"
# pre-releases: pip install --pre "algopay-sdk>=0.1.0a2,<0.2"

From a clone (development):

pip install -e "./python[dev]"

Minimal example

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 ALGO, opt-in USDC, acquire USDC — then:
    await client.pay(w.id, "RECEIVER58CHARALGORANDADDRESSAAAAAAAAAAAA", "1.0")

asyncio.run(main())