Python SDK

from truthlock import TruthlockClient, Algorithm, Verdict

client = TruthlockClient(api_key="your-api-key")

# Create an issuer
issuer = client.issuers.create(
    name="My Organization",
    legal_name="My Organization Inc.",
)

# Register a key
key = client.keys.register(
    issuer_id=issuer.id,
    kid="key-1",
    alg=Algorithm.ED25519.value,
    public_key_b64url="your-base64url-public-key",
)

# Mint an attestation
attestation = client.attestations.mint(
    issuer_id=issuer.id,
    kid="key-1",
    alg=Algorithm.ED25519.value,
    payload_b64url="base64url-encoded-payload",
)
print(f"Attestation: {attestation.attestation_id}")

# Verify
result = client.verify.verify_online(
    attestation_id=attestation.attestation_id,
)
if result.verdict == Verdict.VALID:
    print("Verified successfully")

from truthlock import TruthlockClient, Verdict

client = TruthlockClient(api_key="tl_live_...")

revoked = client.attestations.revoke(
    "660e8400-e29b-41d4-a716-446655440001",
    reason="Certificate holder no longer employed",
)

print(f"Status: {revoked['status']}")        # "REVOKED"
print(f"Revoked at: {revoked['revoked_at']}")

# Subsequent verifications reflect the revocation
check = client.verify.verify_online(
    attestation_id="660e8400-e29b-41d4-a716-446655440001",
)
print(f"Verdict: {check.verdict}")           # "REVOKED"

import base64
import json
from truthlock import TruthlockClient

client = TruthlockClient(api_key="tl_live_...")

# Supersede an attestation with updated claims
updated_payload = base64.urlsafe_b64encode(
    json.dumps({
        "student_name": "Jane Doe",
        "degree_type": "Master of Science",  # Updated from Bachelor to Master
    }).encode()
).decode().rstrip("=")

result = client.attestations.supersede(
    attestation_id="660e8400-e29b-41d4-a716-446655440001",  # Original attestation ID
    payload_b64url=updated_payload,
)

print(f"Old attestation status: {result['old']['status']}")  # "SUPERSEDED"
print(f"New attestation ID: {result['new']['attestation_id']}")

from truthlock import TruthlockClient

client = TruthlockClient(api_key="tl_live_...")

# Query recent attestation events
events = client.audit.query(
    action="attestation.mint",
    from_date="2026-01-01T00:00:00Z",
    to_date="2026-01-31T23:59:59Z",
    limit=100,
)

for event in events:
    print(f"[{event['timestamp']}] {event['action']} by {event['actor_id']}")

# Export audit logs for compliance
export_job = client.audit.export(
    start_date="2026-01-01",
    end_date="2026-01-31",
    format="csv",
)
print(f"Export started: {export_job['id']} (status: {export_job['status']})")

from truthlock import TruthlockClient

client = TruthlockClient(api_key="tl_live_...")

# Create a governance request to suspend an issuer
req = client.governance.create_request(
    action="suspend",
    issuer_id="issuer-uuid",
    reason="Compliance review pending",
)
print(f"Request created: {req['id']} (status: {req['status']})")

# Another authorized user approves the request
client.governance.approve_request(req["id"])

# Execute the approved request
result = client.governance.execute_request(req["id"])
print(f"Executed: {result['id']} — issuer is now {result['issuer_status']}")

# List all governance requests
requests = client.governance.list_requests()
for r in requests:
    print(f"[{r['status']}] {r['action']} {r['issuer_id']} — {r['reason']}")

from truthlock import TruthlockClient

client = TruthlockClient(api_key="tl_live_...")

# Query recent attestation events
events = client.audit.query(
    action="attestation.mint",
    from_date="2026-06-01T00:00:00Z",
    to_date="2026-06-30T23:59:59Z",
    limit=100,
)
for evt in events["data"]:
    print(f"[{evt['timestamp']}] {evt['action']} by {evt['actor_id']}")

# Start an async export for compliance
export_job = client.audit.export(
    from_date="2026-01-01T00:00:00Z",
    to_date="2026-06-30T23:59:59Z",
    report_type="soc2",  # "soc2", "gdpr", "hipaa", or omit for raw
    format="json",
)
print(f"Export started: {export_job['id']} (status: {export_job['status']})")

from truthlock import TruthlockClient, MintReceiptRequest

client = TruthlockClient(api_key="tl_live_...")

# Mint a payment receipt
receipt = client.receipts.mint(MintReceiptRequest(
    issuer_id="your-issuer-id",
    kid="ed-key-2026",
    alg="Ed25519",
    receipt_type="payment_receipt",
    subject="customer@example.com",
    payload={
        "amount": 5000,
        "currency": "USD",
        "provider": "stripe",
        "provider_reference": "ch_3Px...",
    },
))

# Verify a receipt
result = client.receipts.verify(receipt.receipt_id)
print(f"Verdict: {result['verdict']}")  # "VALID"

# Download a proof bundle for offline verification
bundle = client.receipts.get_proof_bundle(receipt.receipt_id)

# Search receipts
results = client.receipts.search(
    q="stripe",
    receipt_type="payment_receipt",
    from_date="2026-01-01T00:00:00Z",
)

# Export receipts as JSON
export_job = client.receipts.export(
    format="json",
    filters={"receipt_type": "payment_receipt"},
)
# Poll for completion
completed = client.receipts.get_export(export_job["id"])
if completed["status"] == "complete":
    print(f"Download: {completed['download_url']}")

# Redact PII from a receipt (permanent, for GDPR erasure requests)
client.receipts.redact(receipt.receipt_id)