Metadata-Version: 2.5
Name: awlpay
Version: 0.1.0
Summary: The 5-minute stablecoin wallet for AI agents. Testnet by default, spend caps built in.
Project-URL: Homepage, https://awlpay.fly.dev
Project-URL: Repository, https://github.com/ceedot-rock/awlpay
Project-URL: Documentation, https://github.com/ceedot-rock/awlpay/blob/main/QUICKSTART.md
Author: Slid Phi Labs
License: Apache-2.0
License-File: LICENSE
Keywords: USDC,agent-payments,crypto-wallet,stablecoin,x402
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Requires-Dist: cryptography>=42
Requires-Dist: eth-account>=0.11
Requires-Dist: solders>=0.21
Requires-Dist: web3>=7
Provides-Extra: test
Requires-Dist: pytest>=8; extra == 'test'
Description-Content-Type: text/markdown

# awlpay (Python)

The 5-minute stablecoin wallet for AI agents. **Testnet by default.**
No seed phrases, no gas math, no rail selection.

```python
from awlpay import AgentWallet

w = AgentWallet(password="correct horse battery staple")
print(w.deposit_address("base"))  # fund with Base Sepolia USDC
print(w.balances())               # {"base": 0.0, "solana": 0.0}
receipt = w.pay("0xRecipient...", 1.00)  # auto-picks cheapest funded rail
print(receipt["tx_hash"])
```

Full walkthrough (install → fund → pay $1 → read the receipt):
[`../QUICKSTART.md`](../QUICKSTART.md)

## Safety model

- Wallet file at `~/.awlpay/wallets.enc`, AES-256-GCM, key from your
  password via PBKDF2-HMAC-SHA256 (600k iterations). Password never hits disk.
- Testnet default. Mainnet needs `network="mainnet"` **and**
  `confirm_mainnet="I UNDERSTAND"` (literal string).
- Lifetime spend cap (`max_spend_usd=100` default) + optional per-call
  `max_usd` on `pay()`. Caps are enforced before anything is signed.
- Plain transfers go straight to chain RPC — the AwLPay server is not involved.

## Install

```bash
pip install awlpay
```

## Develop

```bash
python -m venv .venv && .venv/bin/pip install -e ".[test]"
.venv/bin/pytest
```

## License

Apache-2.0 — Slid Phi Labs.
