Struct AdvancePlan 

pub struct AdvancePlan { /* private fields */ }

Fully assembled but unsigned Advance instruction plan.

A plan owns the encoded CPI payload and passthrough account order, so callers cannot accidentally sign one account order and submit another.

Implementations

impl AdvancePlan

pub fn new( wallet_pda: &Address, new_root: &[u8; 32], inner_instructions: &[Instruction], ) -> Result<Self, Error>

Build an Advance plan from inner CPI instructions.

pub fn wallet_pda(&self) -> &Address

Wallet PDA this plan targets.

pub fn withdraw( wallet_pda: &Address, receiver: &Address, lamports: u64, new_root: &[u8; 32], ) -> Result<Self, Error>

Build a plan for the built-in lamport withdraw CPI.

pub fn close( wallet_pda: &Address, receiver: &Address, new_root: &[u8; 32], ) -> Result<Self, Error>

Build a plan for the built-in close CPI, sweeping all lamports from the wallet PDA to receiver and tearing the account down.

pub fn payload(&self) -> &[u8]

The raw Advance payload committed by the signature.

pub fn passthrough_accounts(&self) -> &[AccountMeta]

Passthrough accounts in the exact order expected by the on-chain handler.

pub fn account_addresses(&self) -> &[[u8; 32]]

Account addresses included in the Advance preimage.

pub fn new_root(&self) -> &[u8; 32]

New root stored by the Advance instruction.

pub fn preimage<'a>( &'a self, wallet_id: &'a [u8; 32], current_root: &'a [u8; 32], ) -> Vec<&'a [u8]>

Build the preimage parts to sign for this plan.

pub fn instruction(&self, signature_bytes: &[u8; 768]) -> Instruction

Convert the plan into a signed Advance instruction.

pub fn estimate_transaction_size( &self, payer: &Address, signature_bytes: &[u8; 768], ) -> Result<usize, Error>

Estimate the legacy transaction size with default Advance compute budget.

pub fn validate_transaction_size( &self, payer: &Address, signature_bytes: &[u8; 768], ) -> Result<usize, Error>

Validate that the planned Advance fits in a legacy transaction.