maat_bytecode

Bytecode format and serialization for the Maat virtual machine.

Role

maat_bytecode defines the complete instruction set for the Maat VM: opcodes, their operand widths, and the encode/decode functions that serialize instructions to a compact byte stream. The Bytecode struct bundles the encoded instructions, a constant pool, a type registry, and a SourceMap into a single artifact that is passed to maat_vm for execution or maat_trace for trace-generating execution.

Usage

use maat_bytecode::{Instructions, Opcode, encode};

// Encode individual instructions
let load_const = encode(Opcode::Constant, &[0, 1]); // load constant at index 1
let add        = encode(Opcode::Add, &[]);

// Combine into an instruction sequence
let mut instructions = Instructions::from(load_const);
instructions.extend(&Instructions::from(add));

// Human-readable disassembly
println!("{instructions}");

Limits

API Docs

docs.rs/maat_bytecode

Repository

github.com/maatlabs/maat. See the project README for an overview of the full compiler pipeline.