Metadata-Version: 2.4
Name: x402-policy
Version: 0.1.0
Summary: Spending policy engine for AI agent x402 micropayments — session keys, ERC-8004 trust scoring, gasless relay
Author-email: Kannan <kannangod123@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/kannangod123/x402-policy
Project-URL: Documentation, https://github.com/kannangod123/x402-policy#readme
Project-URL: Bug Tracker, https://github.com/kannangod123/x402-policy/issues
Keywords: x402,ai-agents,crypto,payments,erc8004,web3,micropayments,langchain,autonomous-agents
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.6.0
Provides-Extra: full
Requires-Dist: fastapi>=0.110.0; extra == "full"
Requires-Dist: uvicorn>=0.27.0; extra == "full"
Requires-Dist: web3>=6.15.0; extra == "full"
Requires-Dist: aiosqlite>=0.20.0; extra == "full"
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"

# x402-policy

**Spending policy engine for AI agent x402 micropayments.**

Session keys · ERC-8004 trust scoring · Cross-chain TAP resolver · Gasless relay

```bash
pip install x402-policy
```

## Quick Start

```python
from x402_policy import PolicyEngine, SpendingPolicy, X402Client

# Set spending rules once
policy = SpendingPolicy(
    daily_budget_usd=5.0,
    max_per_call_usd=0.10,
    min_trust_score=0.7,
)

# Agent pays autonomously within policy
client = X402Client(policy=policy, check_reputation=True)
result = await client.pay("https://api.example.com/data", amount_usd=0.01)
```

## Features

- **Spending policies** — daily budgets, per-call caps, allowlists, kill-switch
- **Session keys** — sign once, agent pays freely within cap + time window
- **ERC-8004 trust scoring** — query on-chain agent reputation before paying
- **TAP resolver** — aggregate identity across 23+ chains into one score
- **CLI** — `x402-policy trust-score 0xABC...`

## CLI

```bash
x402-policy trust-score 0xABC123...
x402-policy session-create my-bot --budget 5.0
x402-policy check 0xABC123 0.05
```

## Links

- [x402 Protocol](https://x402.org)
- [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004)
- [Agent.market](https://agent.market)
