modexiaagentpay 0.1.0

Modexia AgentPay — Python SDK for agent wallets & payments (USDC)

Modexia Python SDK

Lightweight Python client for interacting with the Modexia AgentPay API.

Features

• Simple programmatic access to agent wallets and payments
• Reliable retry/backoff for HTTP calls
• Small surface area: ModexiaClient with transfer + retrieve_balance helpers

Installation

# install locally (editable)
pip install -e packages/SDKs/pythonSdk

Quick start

from modexia import ModexiaClient

client = ModexiaClient(api_key="mx_test_...")

# read balance
print(client.retrieve_balance())

# make a transfer (wait=True polls for on-chain confirmation)
receipt = client.transfer(recipient="0xabc...", amount=5.0, wait=True)
print(receipt)

API (short)

• ModexiaClient(api_key: str, timeout: int = 15)
  • retrieve_balance() -> str
  • transfer(recipient: str, amount: float, idempotency_key: Optional[str] = None, wait: bool = True) -> dict
  • smart_fetch(url, ...) -> requests.Response

Errors / Exceptions

• ModexiaAuthError — authentication problems
• ModexiaPaymentError — payment/server errors
• ModexiaNetworkError — network/connection failures

Testing

Run the unit tests with pytest from the repository root:

pytest -q packages/SDKs/pythonSdk

Contributing

Open a PR against the develop branch. Keep API names stable — this package uses ModexiaClient and transfer(...) as the canonical surface.

Install (PyPI)

pip install modexiaagentpay

If you prefer to try the local copy while iterating:

pip install -e packages/SDKs/pythonSdk