Skip to main content

Tessera

JAM Full Node Client in Python

Tessera is an independent, clean‑room Python implementation of a JAM (Join‑Accumulate Machine) full node. This guide documents the design choices, core components, and integration points required to run a functional JAM node, from block production and finality to PVM and peer‑to‑peer networking.

DocumentationGet Started

1. Block

Block handling including import validation, production mechanics, fork management, and GRANDPA finality integration.

→ Block import & validation
→ Block production & authoring

2. State Transitions

All state transition functions following the Gray Paper: SAFROLE, assurances, authorization, accumulation, reports, disputes, and more.

→ SAFROLE consensus
→ Assurances & authorization
→ Accumulation & reports

3. PVM

Polkadot Virtual Machine integration, host call implementations, instruction sets, and recompilation strategies.

→ Host calls
→ Instructions & recompilation

4. Storage

Data sharding, chunk distribution, and network storage patterns for exported data following the Gray Paper model.

→ Sharding & chunk distribution
→ Network storage patterns

5. Networking

JAM Simple Networking Protocol (JAMNP-S), QUIC modifications for P2P, and Python implementation details.

→ Protocol specification
→ QUIC for P2P networking

6. Auditing

Off-chain validation, judgment system, tranche management, and audit engine implementation.

→ Audit engine
→ Judgments & tranches