Struct AddressStorage 

pub struct AddressStorage { /* private fields */ }

A storage container for managing and tracking public key addresses

AddressStorage provides a convenient way to store and retrieve addresses during fuzz testing. It can generate random addresses or derive PDAs, and allows you to randomly select from stored addresses.

Implementations

impl AddressStorage

pub fn insert( &mut self, trident: &mut Trident, seeds: Option<PdaSeeds<'_>>, ) -> Pubkey

Inserts a new address into storage

Generates a new address (either a PDA or random keypair) and stores it. If PDA seeds are provided, attempts to derive a PDA. If derivation fails or no seeds are provided, generates a random keypair address.

Arguments

• trident - The Trident instance for random number generation
• seeds - Optional PDA seeds for deriving a program-derived address

Returns

The newly created and stored address

pub fn insert_with_address(&mut self, address: Pubkey)

Inserts an existing address into storage

Stores a pre-existing address without generating a new one. Useful when you need to track addresses created elsewhere.

Arguments

• address - The address to store

pub fn get(&self, trident: &mut Trident) -> Option<Pubkey>

Retrieves a random address from storage

Randomly selects one of the stored addresses using Trident’s RNG. This is useful for fuzzing operations that need to work with previously created accounts.

Arguments

• trident - The Trident instance for random number generation

Returns

• Some(Pubkey) - A randomly selected address from storage
• None - If the storage is empty

pub fn get_except( &self, trident: &mut Trident, except_addresses: &[Pubkey], ) -> Option<Pubkey>

Retrieves a random address from storage, excluding specified addresses

Randomly selects one of the stored addresses using Trident’s RNG, ensuring the selected address is not in the exclusion list. This is useful for fuzzing operations that need distinct accounts (e.g., sender and receiver must be different).

Arguments

• trident - The Trident instance for random number generation
• except_addresses - Slice of addresses to exclude from selection

Returns

• Some(Pubkey) - A randomly selected address that is not in the exclusion list
• None - If storage is empty or all addresses are in the exclusion list

Examples

let sender = storage.get(&mut trident)?;
// Get a different address for receiver
let receiver = storage.get_except(&mut trident, &[sender])?;

pub fn is_empty(&self) -> bool

Checks if the storage is empty

Returns

true if no addresses are stored, false otherwise

pub fn len(&self) -> usize

Returns the number of stored addresses

Returns

The count of addresses currently in storage

Trait Implementations

impl Default for AddressStorage

fn default() -> Self

Returns the “default value” for a type.