Python SDK

Installation

pip install tauth

Or install directly from the repo:

pip install ./sdk/python

Quick example

from tauth import TauthClient

client = TauthClient(api_key="tauth_sk_live_xxxxxxxxxxxx")

result = client.sign("photo.jpg", creator="Alice Johnson")

print(result["tx_hash"])       # Ethereum transaction hash
print(result["download_url"])  # Link to the signed file

The API key is sent as an X-API-Key header on every request. You can also set it via environment variable:

export TAUTH_API_KEY=tauth_sk_live_xxxxxxxxxxxx

client = TauthClient()  # picks up TAUTH_API_KEY automatically

Custom base URL

client = TauthClient(api_key="...", base_url="https://api.tauth.io")

Sign a file

result = client.sign(
    "photo.jpg",
    creator="Alice Johnson",
    description="Product shot for summer campaign",
)
print(result["asset_id"])
print(result["tx_hash"])

Verify a file

result = client.verify_file("photo.jpg")
print(result["valid"])    # True / False
print(result["manifest"]) # extracted C2PA manifest or None

Verify by URL:

result = client.verify_url("https://example.com/photo.jpg")

Verify by SHA-256 hash:

result = client.verify_hash("e3b0c44298fc1c149afb...")

List assets

assets = client.list_assets()
for asset in assets:
    print(asset["file_name"], asset["tx_hash"])

Batch signing

import glob

client = TauthClient(api_key="tauth_sk_live_xxxxxxxxxxxx")

for path in glob.glob("photos/*.jpg"):
    result = client.sign(path, creator="Alice")
    print(f"{path}: {result['tx_hash']}")

Error handling

from tauth import TauthClient, TauthError

try:
    result = client.sign("photo.jpg", creator="Alice")
except TauthError as e:
    print(f"Error {e.status}: {e}")