This repository is a preserved collection of small technical explorations from the 2025 JAM/TRAM implementation work.
It is a scratchpad of focused experiments used to answer practical implementation questions around state storage, fork handling, multiprocessing behavior, and byte-level performance.
TRAM needed concrete answers for database architecture and state-transition mechanics before those choices could be folded into the client design. These scripts capture that investigative layer: small, direct experiments that tested assumptions before they became architecture.
The repository is kept as a technical artifact because it shows the reasoning behind parts of TRAM's storage and state-access design.
rocksdict/rocks-perf.py: load and checkpoint timing experiment for RocksDB throughrocksdict.rocksdict/rocks-checkpoints.py: fork-shaped checkpoint experiment using a tree of derived states.rocksdict/rocks-debug.py: multiprocessing/debugging reproduction for checkpoint behavior in spawned processes.pybytes/comparators.py: little-endian byte-comparison correctness and performance exploration.
- TRAM: JAM client and state-transition implementation.
- TRAM wiki explorations: writeup of the database and fork-handling findings that came out of this work.
- TVM: companion Trustless Virtual Machine assembler/runtime project.
This repository is not currently under active development. It is published as a preserved technical artifact from the 2025 JAM implementation work.
Some scripts create and delete local state/ or tree/ directories when run. They are preserved as experiments rather than maintained tooling.