How flamingoponderado/stateless-pancaketh works
stateless-pancaketh is experimental research software implementing an Ethereum stateless guest in Pancake. Its main workflow takes framed execution inputs, runs the guest’s stateless EVM logic, and produces output for Spike or ZisK; EEST tooling runs fixtures against the compiled guest to assess conformance. The tree also exposes transaction, state, trie, and precompile domains, plus cryptographic acceleration. Those source-level stages are represented by their named modules, but their internal call relationships were not sampled, so the graph avoids asserting them. README-documented runtime links are shown explicitly.
Main entry points: main.pnk Guest entry · eest-run.py EEST runner · compare-clients.py Client comparison · spike_run.cc Spike runner
Components 20
Stateless guest
- Guest entry
guest/src/main.pnk - Compiled guest ELF
Execution domains
- EVM execution
guest/src/evm.pnk - Transactions
guest/src/tx.pnk - Block context
guest/src/block.pnk - State access
guest/src/state.pnk - Merkle Patricia trie
guest/src/mpt.pnk
Cryptography
- Precompiles
guest/src/precompiles.pnk - BLS precompiles
guest/src/precompiles_bls.pnk - BN254 precompiles
guest/src/precompiles_bn254.pnk - KZG precompile
guest/src/precompiles_kzg.pnk - P-256 precompile
guest/src/precompiles_p256.pnk - Crypto libraries
guest/src/lib
Runtime and evaluation
- Spike runner
tools/spike/spike_run.cc - ZisK emulator
- EEST runner
tools/eest-run.py - Client comparison
tools/compare-clients.py - Crypto CSR acceleration
tools/spike/zisk_accel.cc
Other components
- Input provider
- EEST fixtures
Connections 7
- Input provider → Guest entry: supplies input
README.md - Guest entry → Compiled guest ELF: compiled as
README.md - Compiled guest ELF → Spike runner: runs under
README.md - Compiled guest ELF → ZisK emulator: runs under
README.md - EEST fixtures → EEST runner: provides cases
README.md - EEST runner → Compiled guest ELF: runs guest
README.md - Client comparison → ZisK emulator: measures costs
tools/compare-clients.py