How tritonvm/triton-vm works
Project type and purpose
• Triton VM is an open-source, multi-crate Rust library implementing a Turing-complete virtual machine with recursive STARK proofs. It provides:
• An Instruction Set Architecture (ISA) and parser (crate: triton-isa)
• Algebraic Intermediate Representation (AIR) generation (crate: triton-air)
• A code-generation pipeline to compile AIR constraints into Rust for maximum runtime speed (crates: triton-constraint-builder and triton-constraint-circuit)
• The VM runtime itself with embedded STARK proof generation & verification (crate: triton-vm), depending on the twenty-first cryptographic library.
• It is not a client-server or UI application; it is a library/toolchain for high-integrity computation.
File structure
• Top-level:
• specification/ – mdBook source for the formal spec (offline docs)
• tips/ – design tips and reference papers
• triton-isa/, triton-air/, triton-constraint-builder/, triton-constraint-circuit/, triton-vm/ – five Rust crates.
• Build scripts & CI configs under .github/workflows.
• Cargo.toml links the workspace; each crate has its own Cargo.toml and README.
• Pattern: a compile-time pipeline (constraint builder + circuit) feeding into a runtime library (tvm).
README
• Describes the VM’s role in generating and recursively verifying STARKs.
• Points to the online spec (mdBook) and examples in triton-vm/examples.
• Emphasizes that the STARK engine is embedded in triton-vm, not in twenty-first.