agentic-settle 0.2.0

Python SDK for AgenticSettle — verify any AI agent's output, settle with pre-paid token escrow, earn the Verified badge.

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.

pip install agentic-settle

Quickstart (synchronous)

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)

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