trustchain-core 0.1.0

Merkle tree and cryptographic proof primitives for the Arkava Trust Chain

trustchain-core

Merkle tree and cryptographic proof primitives for the Arkava® Trust Chain.

trustchain-core provides the foundational cryptographic building blocks for the Arkava Trust Chain — an append-only, cryptographically verifiable accountability substrate. It implements Merkle trees, batch accumulators, inclusion and consistency proofs, Ed25519 signature verification, and canonical JSON encoding for witness manifests.

Installation

pip install trustchain-core

Requires Python 3.11+.

Quick Start

from trustchain_core import MerkleTree, BatchAccumulator, compute_batch_root

# Build a Merkle tree
tree = MerkleTree()
tree.add_leaf(b"event 1")
tree.add_leaf(b"event 2")
root = tree.get_root()

# Verify an inclusion proof
proof = tree.prove_inclusion(0)
assert tree.verify_inclusion_proof(proof)

# Batch accumulator for daily manifests
accumulator = BatchAccumulator()
batch_root = compute_batch_root([b"event 1", b"event 2"])

Features

• Merkle trees — SHA3-512 leaf hashing, RFC 6962-compatible inclusion and consistency proofs
• Batch accumulator — deterministic batch root computation with algorithm ID headers
• Ed25519 verification — signature verification with public key registry
• Canonical encoding — RFC 8785 (JCS) canonical JSON for reproducible manifest hashing
• Witness manifests — daily commit-signed manifest generation and verification
• Algorithm dispatch — extensible crypto algorithm registry with future-compatibility
• Ethereum compatibility — hash encoding compatible with Ethereum smart contracts
• Typed — PEP 561 py.typed marker for type checker support

Documentation

• Architecture: Arkava_TrustChain_Technical_Architecture_v0.2.md
• ADR-0007: Witness anchoring
• ADR-0019: Manifest canonical encoding and v1 field lock

Licence

Apache-2.0. Arkava® Trust Chain is a registered trademark of Arkava Ltd.

© 2026 Arkava® / All rights reserved.