libveritas 0.0.0.dev20260325015035

Stateless verification for Bitcoin handles using the Spaces protocol

libveritas

Python bindings for libveritas — stateless verification for Bitcoin handles using the Spaces protocol.

Installation

pip install libveritas

Usage

from libveritas import Anchors, Veritas, QueryContext, Message

# Load trust anchors
anchors = Anchors.from_json(anchors_json_string)
veritas = Veritas(anchors)

print(f"Anchors: {veritas.oldest_anchor()} .. {veritas.newest_anchor()}")

# Build query context (empty = verify all handles)
ctx = QueryContext()

# Verify a message
msg = Message(message_bytes)
result = veritas.verify_message(ctx, msg)

# Inspect verified zones
for zone in result.zones():
    print(f"{zone.handle()} -> {zone.sovereignty()}")

# Get certificates
for cert in result.certificates():
    print(f"{cert.subject} [{cert.cert_type}]")

Building from source

Requires Rust and maturin:

pip install maturin
cd python
maturin develop