caelum0x 35563d758d chore: prepare SDK releases at 0.1.0 with a publish workflow (G13)
@settlekit/common, @settlekit/sdk and @settlekit/react move to 0.1.0 with
publish metadata (description, MIT licence, repository, public access,
LICENSE and README in the tarball; verified with npm pack --dry-run).
.github/workflows/release-sdks.yml publishes npm, PyPI (trusted
publishing) and crates.io on an sdk-v* tag or as a manual dry run.
docs/RELEASING-SDKS.md lists the owner-only registry setup. Nothing is
published from here. The Python, Go and Rust webhook verifiers already
accept rotated secrets (G8).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 06:34:16 +03:00
..
2026-06-17 02:09:36 +03:00
2026-06-17 02:09:36 +03:00
2026-06-17 02:09:36 +03:00

settlekit (Python SDK)

The official SettleKit Python SDK — sell software, private repos, SaaS, APIs, and AI tools in USDC, and guard your own paid APIs with x402 pay-per-call.

Works against the SettleKit HTTP API. Python 3.10+.

Install

pip install -e sdks/python          # from this repo
# or, once published:  pip install settlekit

Quick start

from settlekit import SettleKit

sk = SettleKit(api_key="sk_live_...", base_url="http://localhost:8787")
# or rely on env: SETTLEKIT_API_KEY / SETTLEKIT_API_URL

product = sk.products.create(
    merchant_id="mch_1",
    organization_id="org_1",
    name="Pro Repo Access",
    type="github_repo_access",
    delivery_mode="github_invite",
)
sk.prices.create(product["id"], amount="25.00", interval="monthly")

for p in sk.products.list():
    print(p["id"], p["name"])

The client unwraps the { "data": ... } envelope and raises a typed SettleKitError(code, message, status) on any { "error": ... } response.

Async

import asyncio
from settlekit import AsyncSettleKit

async def main():
    async with AsyncSettleKit() as sk:
        listings = await sk.marketplace.search(tag="saas", sort="top")
        print(listings)

asyncio.run(main())

Verifying access

Gate your own app on SettleKit entitlements / keys:

from settlekit import verify_license, verify_api_key, verify_entitlement

if not verify_license(license_key, product_id="prod_cli", machine_id=machine_fp):
    raise SystemExit("Invalid license")

if not verify_api_key(presented_key, required_scopes=["read"]):
    raise PermissionError("Bad API key")

if not verify_entitlement(customer_id="cus_1", feature="ai_export"):
    raise PermissionError("Upgrade required")

Selling a paid API with x402

Charge humans and AI agents per call. require_payment returns HTTP 402 with the payment requirements when no valid X-PAYMENT proof is supplied, and lets the request through once the buyer has paid:

from fastapi import FastAPI, Depends
from settlekit.x402 import require_payment

app = FastAPI()

@app.get("/research")
def research(_payment=Depends(require_payment(price="0.005", network="arc",
                                              pay_to="0xMerchantWallet",
                                              resource="/research"))):
    return {"answer": "Paid research result"}

A runnable example lives in examples/paid_api.py:

pip install -e sdks/python fastapi uvicorn
uvicorn examples.paid_api:app --reload
curl -i localhost:8000/research      # -> 402 Payment Required + requirements

Package layout

settlekit/
  client.py          SettleKit + AsyncSettleKit clients (envelope-aware)
  _transport.py      httpx transport + retries
  errors.py          SettleKitError and subtypes
  verify.py          license / api-key / entitlement verification helpers
  x402.py            FastAPI/Starlette require_payment middleware + 402 flow
  resources/         products, prices, customers, checkout, payments,
                     entitlements, license_keys, api_keys, coupons, invoices,
                     refunds, payouts, agent_services, marketplace
examples/paid_api.py runnable x402-guarded FastAPI app