Metadata-Version: 2.4
Name: agentic-settle
Version: 0.2.0
Summary: Python SDK for AgenticSettle — verify any AI agent's output, settle with pre-paid token escrow, earn the Verified badge.
Author-email: "AgenticSettle.IO" <engineering@agenticsettle.io>
License: Apache-2.0
Project-URL: Homepage, https://github.com/agenticsettleio/agentic-settle-core
Project-URL: Issues, https://github.com/agenticsettleio/agentic-settle-core/issues
Keywords: agentic,settlement,web3,kms,fastapi,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0.0
Dynamic: license-file

# agentic-settle

Python client SDK for the **AgenticSettle Pro** settlement engine.

A deliberately thin wrapper over the REST API so AI-native applications can
spend less than 30 seconds wiring up on-chain settlement for their agents.

```bash
pip install agentic-settle
```

## Quickstart (synchronous)

```python
import os
from agentic_settle import SettleClient

client = SettleClient(
    base_url="https://api.agenticsettle.io",
    api_key=os.environ["AGENTIC_SETTLE_API_KEY"],
)

receipt = client.settle(
    agent_id="gpt-4o",
    request_content="What is the capital of France?",
    result_content="Paris",
    target_wallet="0x0000000000000000000000000000000000000000",
)

print(receipt.status, receipt.chain_tx_hash)
```

## Quickstart (asyncio)

```python
import asyncio
from agentic_settle import AsyncSettleClient

async def main() -> None:
    client = AsyncSettleClient(api_key="...")
    receipt = await client.settle(
        agent_id="claude-3.5",
        request_content="...",
        result_content="...",
        target_wallet="0x...",
    )
    print(receipt)

asyncio.run(main())
```

## Environment variables

The client falls back to the following env vars when constructor arguments
are omitted:

| Variable                    | Purpose                                  |
|-----------------------------|------------------------------------------|
| `AGENTIC_SETTLE_BASE_URL`   | Base URL of the settlement service       |
| `AGENTIC_SETTLE_API_KEY`    | API key (preferred)                      |
| `BRUCE_SECRET_KEY`          | Legacy fallback for local dev convenience |

## What's in the box

- `SettleClient`       — synchronous client (httpx under the hood)
- `AsyncSettleClient`  — asyncio variant for high-throughput agents
- `SettleRequest`      — request payload model (pydantic v2)
- `SettleReceipt`      — response receipt model (pydantic v2)

Type annotations ship with `py.typed`.

## License

Apache-2.0
