Skip to main content

Crate truent_dynamic_solana

Crate truent_dynamic_solana 

Source
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 InstructionSpec surface.
idl
Anchor IDL → InstructionSpec front-end.
invariant
Invariant oracles for the Solana account model.
model
The Solana call model.