Expand description
Dynamic invariant fuzzing for Solana programs.
The Solana counterpart to truent-dynamic-evm. Solana’s execution model
is account-based, not the EVM’s flat-calldata single-caller shape, so this
crate defines its own call model (model), invariant oracles
(invariant), instruction generator (generator), and fuzz/shrink loop
(fuzz) rather than forcing the EVM types onto it. The engine logic is
proven against an in-memory mock program (testing, cfg(test)).
A real execution backend (running compiled BPF bytecode on an in-process Solana VM) is not part of this release: the VM’s dependencies carry unpatched RUSTSEC advisories, and a security tool must not ship known-vulnerable crypto. It is tracked for a later version; the backend source lives in git history at the 0.3.x line.
Re-exports§
pub use backend::SvmBackend;pub use config::parse_plan;pub use config::ConfigError;pub use config::FuzzPlan;pub use config::GenesisAccount;pub use fuzz::format_poc;pub use fuzz::fuzz;pub use fuzz::run_sequence;pub use fuzz::shrink;pub use fuzz::FuzzConfig;pub use fuzz::Step;pub use fuzz::Violation;pub use generator::AccountPool;pub use idl::anchor_discriminator;pub use idl::parse_idl;pub use idl::IdlError;pub use idl::IdlProgram;pub use idl::SkippedInstruction;pub use invariant::AccountOwnerInvariant;pub use invariant::SolanaInvariant;pub use invariant::TokenConservationInvariant;pub use model::AccountMeta;pub use model::AccountRole;pub use model::ArgKind;pub use model::Instruction;pub use model::InstructionSpec;pub use model::IxOutcome;pub use model::Pubkey;
Modules§
- backend
- The Solana execution backend abstraction.
- config
- The fuzz plan: everything an IDL cannot tell us.
- fuzz
- The Solana fuzzing loop: generate instruction sequences, execute each against a fresh backend, check invariants after every instruction, and on a violation shrink the sequence to a minimal reproduction. Same search + delta-debug shape as the EVM engine, expressed over the account model.
- generator
- Random instruction generation from an
InstructionSpecsurface. - idl
- Anchor IDL →
InstructionSpecfront-end. - invariant
- Invariant oracles for the Solana account model.
- model
- The Solana call model.