#[cfg(feature = "dev-context-only-utils")]
use qualifier_attr::field_qualifiers;
use {
crate::{
account_overrides::AccountOverrides,
nonce_info::NonceInfo,
rollback_accounts::RollbackAccounts,
transaction_error_metrics::TransactionErrorMetrics,
transaction_execution_result::ExecutedTransaction,
transaction_processing_callback::{AccountState, TransactionProcessingCallback},
},
ahash::{AHashMap, AHashSet},
clone_agave_feature_set::{self as feature_set, FeatureSet},
clone_solana_account::{
Account, AccountSharedData, ReadableAccount, WritableAccount, PROGRAM_OWNERS,
},
clone_solana_compute_budget::compute_budget_limits::ComputeBudgetLimits,
clone_solana_fee_structure::FeeDetails,
clone_solana_instruction::{BorrowedAccountMeta, BorrowedInstruction},
clone_solana_instructions_sysvar::construct_instructions_data,
clone_solana_nonce::state::State as NonceState,
clone_solana_nonce_account::{get_system_account_kind, SystemAccountKind},
clone_solana_pubkey::Pubkey,
clone_solana_rent::RentDue,
clone_solana_rent_debits::RentDebits,
clone_solana_sdk::rent_collector::{CollectedInfo, RENT_EXEMPT_RENT_EPOCH},
clone_solana_sdk_ids::{
native_loader,
sysvar::{self, slot_history},
},
clone_solana_svm_rent_collector::svm_rent_collector::SVMRentCollector,
clone_solana_svm_transaction::svm_message::SVMMessage,
clone_solana_transaction_context::{IndexOfAccount, TransactionAccount},
clone_solana_transaction_error::{TransactionError, TransactionResult as Result},
std::{
num::{NonZeroU32, Saturating},
sync::Arc,
},
};
pub(crate) type TransactionRent = u64;
pub(crate) type TransactionProgramIndices = Vec<Vec<IndexOfAccount>>;
pub type TransactionCheckResult = Result<CheckedTransactionDetails>;
type TransactionValidationResult = Result<ValidatedTransactionDetails>;
#[derive(PartialEq, Eq, Debug)]
pub(crate) enum TransactionLoadResult {
Loaded(LoadedTransaction),
FeesOnly(FeesOnlyTransaction),
NotLoaded(TransactionError),
}
#[derive(PartialEq, Eq, Debug, Clone)]
#[cfg_attr(feature = "dev-context-only-utils", derive(Default))]
pub struct CheckedTransactionDetails {
pub(crate) nonce: Option<NonceInfo>,
pub(crate) lamports_per_signature: u64,
}
impl CheckedTransactionDetails {
pub fn new(nonce: Option<NonceInfo>, lamports_per_signature: u64) -> Self {
Self {
nonce,
lamports_per_signature,
}
}
}
#[derive(PartialEq, Eq, Debug, Clone)]
#[cfg_attr(feature = "dev-context-only-utils", derive(Default))]
pub(crate) struct ValidatedTransactionDetails {
pub(crate) rollback_accounts: RollbackAccounts,
pub(crate) compute_budget_limits: ComputeBudgetLimits,
pub(crate) fee_details: FeeDetails,
pub(crate) loaded_fee_payer_account: LoadedTransactionAccount,
}
#[derive(PartialEq, Eq, Debug, Clone)]
#[cfg_attr(feature = "dev-context-only-utils", derive(Default))]
pub(crate) struct LoadedTransactionAccount {
pub(crate) account: AccountSharedData,
pub(crate) loaded_size: usize,
pub(crate) rent_collected: u64,
}
#[derive(PartialEq, Eq, Debug, Clone)]
#[cfg_attr(feature = "dev-context-only-utils", derive(Default))]
#[cfg_attr(
feature = "dev-context-only-utils",
field_qualifiers(
program_indices(pub),
compute_budget_limits(pub),
loaded_accounts_data_size(pub)
)
)]
pub struct LoadedTransaction {
pub accounts: Vec<TransactionAccount>,
pub(crate) program_indices: TransactionProgramIndices,
pub fee_details: FeeDetails,
pub rollback_accounts: RollbackAccounts,
pub(crate) compute_budget_limits: ComputeBudgetLimits,
pub rent: TransactionRent,
pub rent_debits: RentDebits,
pub(crate) loaded_accounts_data_size: u32,
}
#[derive(PartialEq, Eq, Debug, Clone)]
pub struct FeesOnlyTransaction {
pub load_error: TransactionError,
pub rollback_accounts: RollbackAccounts,
pub fee_details: FeeDetails,
}
#[cfg_attr(feature = "dev-context-only-utils", derive(Clone))]
pub(crate) struct AccountLoader<'a, CB: TransactionProcessingCallback> {
account_cache: AHashMap<Pubkey, AccountSharedData>,
callbacks: &'a CB,
pub(crate) feature_set: Arc<FeatureSet>,
}
impl<'a, CB: TransactionProcessingCallback> AccountLoader<'a, CB> {
pub(crate) fn new_with_account_cache_capacity(
account_overrides: Option<&'a AccountOverrides>,
callbacks: &'a CB,
feature_set: Arc<FeatureSet>,
capacity: usize,
) -> AccountLoader<'a, CB> {
let mut account_cache = AHashMap::with_capacity(capacity);
if let Some(slot_history) =
account_overrides.and_then(|overrides| overrides.get(&slot_history::id()))
{
account_cache.insert(slot_history::id(), slot_history.clone());
}
Self {
account_cache,
callbacks,
feature_set,
}
}
pub(crate) fn load_account(
&mut self,
account_key: &Pubkey,
is_writable: bool,
) -> Option<LoadedTransactionAccount> {
let account = if let Some(account) = self.account_cache.get(account_key) {
if account.lamports() == 0 {
None
} else {
Some(account.clone())
}
} else if let Some(account) = self.callbacks.get_account_shared_data(account_key) {
self.account_cache.insert(*account_key, account.clone());
Some(account)
} else {
None
};
self.callbacks.inspect_account(
account_key,
if let Some(ref account) = account {
AccountState::Alive(account)
} else {
AccountState::Dead
},
is_writable,
);
account.map(|account| LoadedTransactionAccount {
loaded_size: account.data().len(),
account,
rent_collected: 0,
})
}
pub(crate) fn update_accounts_for_executed_tx(
&mut self,
message: &impl SVMMessage,
executed_transaction: &ExecutedTransaction,
) {
if executed_transaction.was_successful() {
self.update_accounts_for_successful_tx(
message,
&executed_transaction.loaded_transaction.accounts,
);
} else {
self.update_accounts_for_failed_tx(
message,
&executed_transaction.loaded_transaction.rollback_accounts,
);
}
}
pub(crate) fn update_accounts_for_failed_tx(
&mut self,
message: &impl SVMMessage,
rollback_accounts: &RollbackAccounts,
) {
let fee_payer_address = message.fee_payer();
match rollback_accounts {
RollbackAccounts::FeePayerOnly { fee_payer_account } => {
self.account_cache
.insert(*fee_payer_address, fee_payer_account.clone());
}
RollbackAccounts::SameNonceAndFeePayer { nonce } => {
self.account_cache
.insert(*nonce.address(), nonce.account().clone());
}
RollbackAccounts::SeparateNonceAndFeePayer {
nonce,
fee_payer_account,
} => {
self.account_cache
.insert(*nonce.address(), nonce.account().clone());
self.account_cache
.insert(*fee_payer_address, fee_payer_account.clone());
}
}
}
fn update_accounts_for_successful_tx(
&mut self,
message: &impl SVMMessage,
transaction_accounts: &[TransactionAccount],
) {
for (i, (address, account)) in (0..message.account_keys().len()).zip(transaction_accounts) {
if !message.is_writable(i) {
continue;
}
if message.is_invoked(i) && !message.is_instruction_account(i) {
continue;
}
self.account_cache.insert(*address, account.clone());
}
}
}
pub fn collect_rent_from_account(
feature_set: &FeatureSet,
rent_collector: &dyn SVMRentCollector,
address: &Pubkey,
account: &mut AccountSharedData,
) -> CollectedInfo {
if !feature_set.is_active(&feature_set::disable_rent_fees_collection::id()) {
rent_collector.collect_rent(address, account)
} else {
if account.rent_epoch() != RENT_EXEMPT_RENT_EPOCH
&& rent_collector.get_rent_due(
account.lamports(),
account.data().len(),
account.rent_epoch(),
) == RentDue::Exempt
{
account.set_rent_epoch(RENT_EXEMPT_RENT_EPOCH);
}
CollectedInfo::default()
}
}
pub fn validate_fee_payer(
payer_address: &Pubkey,
payer_account: &mut AccountSharedData,
payer_index: IndexOfAccount,
error_metrics: &mut TransactionErrorMetrics,
rent_collector: &dyn SVMRentCollector,
fee: u64,
) -> Result<()> {
if payer_account.lamports() == 0 {
error_metrics.account_not_found += 1;
return Err(TransactionError::AccountNotFound);
}
let system_account_kind = get_system_account_kind(payer_account).ok_or_else(|| {
error_metrics.invalid_account_for_fee += 1;
TransactionError::InvalidAccountForFee
})?;
let min_balance = match system_account_kind {
SystemAccountKind::System => 0,
SystemAccountKind::Nonce => {
rent_collector
.get_rent()
.minimum_balance(NonceState::size())
}
};
payer_account
.lamports()
.checked_sub(min_balance)
.and_then(|v| v.checked_sub(fee))
.ok_or_else(|| {
error_metrics.insufficient_funds += 1;
TransactionError::InsufficientFundsForFee
})?;
let payer_pre_rent_state = rent_collector.get_account_rent_state(payer_account);
payer_account
.checked_sub_lamports(fee)
.map_err(|_| TransactionError::InsufficientFundsForFee)?;
let payer_post_rent_state = rent_collector.get_account_rent_state(payer_account);
rent_collector.check_rent_state_with_account(
&payer_pre_rent_state,
&payer_post_rent_state,
payer_address,
payer_account,
payer_index,
)
}
pub(crate) fn load_transaction<CB: TransactionProcessingCallback>(
account_loader: &mut AccountLoader<CB>,
message: &impl SVMMessage,
validation_result: TransactionValidationResult,
error_metrics: &mut TransactionErrorMetrics,
rent_collector: &dyn SVMRentCollector,
) -> TransactionLoadResult {
match validation_result {
Err(e) => TransactionLoadResult::NotLoaded(e),
Ok(tx_details) => {
let load_result = load_transaction_accounts(
account_loader,
message,
tx_details.loaded_fee_payer_account,
&tx_details.compute_budget_limits,
error_metrics,
rent_collector,
);
match load_result {
Ok(loaded_tx_accounts) => TransactionLoadResult::Loaded(LoadedTransaction {
accounts: loaded_tx_accounts.accounts,
program_indices: loaded_tx_accounts.program_indices,
fee_details: tx_details.fee_details,
rent: loaded_tx_accounts.rent,
rent_debits: loaded_tx_accounts.rent_debits,
rollback_accounts: tx_details.rollback_accounts,
compute_budget_limits: tx_details.compute_budget_limits,
loaded_accounts_data_size: loaded_tx_accounts.loaded_accounts_data_size,
}),
Err(err) => TransactionLoadResult::FeesOnly(FeesOnlyTransaction {
load_error: err,
fee_details: tx_details.fee_details,
rollback_accounts: tx_details.rollback_accounts,
}),
}
}
}
}
#[derive(PartialEq, Eq, Debug, Clone)]
struct LoadedTransactionAccounts {
pub(crate) accounts: Vec<TransactionAccount>,
pub(crate) program_indices: TransactionProgramIndices,
pub(crate) rent: TransactionRent,
pub(crate) rent_debits: RentDebits,
pub(crate) loaded_accounts_data_size: u32,
}
fn load_transaction_accounts<CB: TransactionProcessingCallback>(
account_loader: &mut AccountLoader<CB>,
message: &impl SVMMessage,
loaded_fee_payer_account: LoadedTransactionAccount,
compute_budget_limits: &ComputeBudgetLimits,
error_metrics: &mut TransactionErrorMetrics,
rent_collector: &dyn SVMRentCollector,
) -> Result<LoadedTransactionAccounts> {
let mut tx_rent: TransactionRent = 0;
let account_keys = message.account_keys();
let mut accounts = Vec::with_capacity(account_keys.len());
let mut validated_loaders = AHashSet::with_capacity(PROGRAM_OWNERS.len());
let mut rent_debits = RentDebits::default();
let mut accumulated_accounts_data_size: Saturating<u32> = Saturating(0);
let mut collect_loaded_account = |key, loaded_account| -> Result<()> {
let LoadedTransactionAccount {
account,
loaded_size,
rent_collected,
} = loaded_account;
accumulate_and_check_loaded_account_data_size(
&mut accumulated_accounts_data_size,
loaded_size,
compute_budget_limits.loaded_accounts_bytes,
error_metrics,
)?;
tx_rent += rent_collected;
rent_debits.insert(key, rent_collected, account.lamports());
accounts.push((*key, account));
Ok(())
};
collect_loaded_account(message.fee_payer(), loaded_fee_payer_account)?;
for (account_index, account_key) in account_keys.iter().enumerate().skip(1) {
let loaded_account = load_transaction_account(
account_loader,
message,
account_key,
account_index,
rent_collector,
);
collect_loaded_account(account_key, loaded_account)?;
}
let program_indices = message
.program_instructions_iter()
.map(|(program_id, instruction)| {
let mut account_indices = Vec::with_capacity(2);
if native_loader::check_id(program_id) {
return Ok(account_indices);
}
let program_index = instruction.program_id_index as usize;
let Some(LoadedTransactionAccount {
account: program_account,
..
}) = account_loader.load_account(program_id, false)
else {
error_metrics.account_not_found += 1;
return Err(TransactionError::ProgramAccountNotFound);
};
if !account_loader
.feature_set
.is_active(&feature_set::remove_accounts_executable_flag_checks::id())
&& !program_account.executable()
{
error_metrics.invalid_program_for_execution += 1;
return Err(TransactionError::InvalidProgramForExecution);
}
account_indices.insert(0, program_index as IndexOfAccount);
let owner_id = program_account.owner();
if native_loader::check_id(owner_id) {
return Ok(account_indices);
}
if !validated_loaders.contains(owner_id) {
if let Some(LoadedTransactionAccount {
account: owner_account,
loaded_size: owner_size,
..
}) = account_loader.load_account(owner_id, false)
{
if !native_loader::check_id(owner_account.owner())
|| (!account_loader
.feature_set
.is_active(&feature_set::remove_accounts_executable_flag_checks::id())
&& !owner_account.executable())
{
error_metrics.invalid_program_for_execution += 1;
return Err(TransactionError::InvalidProgramForExecution);
}
accumulate_and_check_loaded_account_data_size(
&mut accumulated_accounts_data_size,
owner_size,
compute_budget_limits.loaded_accounts_bytes,
error_metrics,
)?;
validated_loaders.insert(*owner_id);
} else {
error_metrics.account_not_found += 1;
return Err(TransactionError::ProgramAccountNotFound);
}
}
Ok(account_indices)
})
.collect::<Result<Vec<Vec<IndexOfAccount>>>>()?;
Ok(LoadedTransactionAccounts {
accounts,
program_indices,
rent: tx_rent,
rent_debits,
loaded_accounts_data_size: accumulated_accounts_data_size.0,
})
}
fn load_transaction_account<CB: TransactionProcessingCallback>(
account_loader: &mut AccountLoader<CB>,
message: &impl SVMMessage,
account_key: &Pubkey,
account_index: usize,
rent_collector: &dyn SVMRentCollector,
) -> LoadedTransactionAccount {
let is_writable = message.is_writable(account_index);
let loaded_account = if clone_solana_sdk_ids::sysvar::instructions::check_id(account_key) {
LoadedTransactionAccount {
loaded_size: 0,
account: construct_instructions_account(message),
rent_collected: 0,
}
} else if let Some(mut loaded_account) = account_loader.load_account(account_key, is_writable) {
loaded_account.rent_collected = if is_writable {
collect_rent_from_account(
&account_loader.feature_set,
rent_collector,
account_key,
&mut loaded_account.account,
)
.rent_amount
} else {
0
};
loaded_account
} else {
let mut default_account = AccountSharedData::default();
default_account.set_rent_epoch(RENT_EXEMPT_RENT_EPOCH);
LoadedTransactionAccount {
loaded_size: default_account.data().len(),
account: default_account,
rent_collected: 0,
}
};
loaded_account
}
fn accumulate_and_check_loaded_account_data_size(
accumulated_loaded_accounts_data_size: &mut Saturating<u32>,
account_data_size: usize,
requested_loaded_accounts_data_size_limit: NonZeroU32,
error_metrics: &mut TransactionErrorMetrics,
) -> Result<()> {
let Ok(account_data_size) = u32::try_from(account_data_size) else {
error_metrics.max_loaded_accounts_data_size_exceeded += 1;
return Err(TransactionError::MaxLoadedAccountsDataSizeExceeded);
};
*accumulated_loaded_accounts_data_size += account_data_size;
if accumulated_loaded_accounts_data_size.0 > requested_loaded_accounts_data_size_limit.get() {
error_metrics.max_loaded_accounts_data_size_exceeded += 1;
Err(TransactionError::MaxLoadedAccountsDataSizeExceeded)
} else {
Ok(())
}
}
fn construct_instructions_account(message: &impl SVMMessage) -> AccountSharedData {
let account_keys = message.account_keys();
let mut decompiled_instructions = Vec::with_capacity(message.num_instructions());
for (program_id, instruction) in message.program_instructions_iter() {
let accounts = instruction
.accounts
.iter()
.map(|account_index| {
let account_index = usize::from(*account_index);
BorrowedAccountMeta {
is_signer: message.is_signer(account_index),
is_writable: message.is_writable(account_index),
pubkey: account_keys.get(account_index).unwrap(),
}
})
.collect();
decompiled_instructions.push(BorrowedInstruction {
accounts,
data: instruction.data,
program_id,
});
}
AccountSharedData::from(Account {
data: construct_instructions_data(&decompiled_instructions),
owner: sysvar::id(),
..Account::default()
})
}
#[cfg(test)]
mod tests {
use {
super::*,
crate::{
transaction_account_state_info::TransactionAccountStateInfo,
transaction_processing_callback::TransactionProcessingCallback,
},
clone_agave_feature_set::FeatureSet,
clone_agave_reserved_account_keys::ReservedAccountKeys,
clone_solana_account::{Account, AccountSharedData, ReadableAccount, WritableAccount},
clone_solana_compute_budget::{compute_budget::ComputeBudget, compute_budget_limits},
clone_solana_epoch_schedule::EpochSchedule,
clone_solana_hash::Hash,
clone_solana_instruction::{AccountMeta, Instruction},
clone_solana_keypair::Keypair,
clone_solana_message::{
compiled_instruction::CompiledInstruction,
v0::{LoadedAddresses, LoadedMessage},
LegacyMessage, Message, MessageHeader, SanitizedMessage,
},
clone_solana_native_token::{sol_to_lamports, LAMPORTS_PER_SOL},
clone_solana_nonce::{self as nonce, versions::Versions as NonceVersions},
clone_solana_program::bpf_loader_upgradeable::UpgradeableLoaderState,
clone_solana_pubkey::Pubkey,
clone_solana_rent::Rent,
clone_solana_rent_debits::RentDebits,
clone_solana_sdk::rent_collector::{RentCollector, RENT_EXEMPT_RENT_EPOCH},
clone_solana_sdk_ids::{
bpf_loader, bpf_loader_upgradeable, native_loader, system_program, sysvar,
},
clone_solana_signature::Signature,
clone_solana_signer::Signer,
clone_solana_system_transaction::transfer,
clone_solana_transaction::{sanitized::SanitizedTransaction, Transaction},
clone_solana_transaction_context::{TransactionAccount, TransactionContext},
clone_solana_transaction_error::{TransactionError, TransactionResult as Result},
std::{borrow::Cow, cell::RefCell, collections::HashMap, fs::File, io::Read, sync::Arc},
};
#[derive(Clone, Default)]
struct TestCallbacks {
accounts_map: HashMap<Pubkey, AccountSharedData>,
#[allow(clippy::type_complexity)]
inspected_accounts:
RefCell<HashMap<Pubkey, Vec<(Option<AccountSharedData>, /* is_writable */ bool)>>>,
}
impl TransactionProcessingCallback for TestCallbacks {
fn account_matches_owners(&self, _account: &Pubkey, _owners: &[Pubkey]) -> Option<usize> {
None
}
fn get_account_shared_data(&self, pubkey: &Pubkey) -> Option<AccountSharedData> {
self.accounts_map.get(pubkey).cloned()
}
fn inspect_account(
&self,
address: &Pubkey,
account_state: AccountState,
is_writable: bool,
) {
let account = match account_state {
AccountState::Dead => None,
AccountState::Alive(account) => Some(account.clone()),
};
self.inspected_accounts
.borrow_mut()
.entry(*address)
.or_default()
.push((account, is_writable));
}
}
impl<'a> From<&'a TestCallbacks> for AccountLoader<'a, TestCallbacks> {
fn from(callbacks: &'a TestCallbacks) -> AccountLoader<'a, TestCallbacks> {
AccountLoader::new_with_account_cache_capacity(
None,
callbacks,
Arc::<FeatureSet>::default(),
0,
)
}
}
fn load_accounts_with_features_and_rent(
tx: Transaction,
accounts: &[TransactionAccount],
rent_collector: &RentCollector,
error_metrics: &mut TransactionErrorMetrics,
feature_set: &mut FeatureSet,
) -> TransactionLoadResult {
feature_set.deactivate(&feature_set::disable_rent_fees_collection::id());
let sanitized_tx = SanitizedTransaction::from_transaction_for_tests(tx);
let fee_payer_account = accounts[0].1.clone();
let mut accounts_map = HashMap::new();
for (pubkey, account) in accounts {
accounts_map.insert(*pubkey, account.clone());
}
let callbacks = TestCallbacks {
accounts_map,
..Default::default()
};
let mut account_loader: AccountLoader<TestCallbacks> = (&callbacks).into();
account_loader.feature_set = Arc::new(feature_set.clone());
load_transaction(
&mut account_loader,
&sanitized_tx,
Ok(ValidatedTransactionDetails {
loaded_fee_payer_account: LoadedTransactionAccount {
account: fee_payer_account,
..LoadedTransactionAccount::default()
},
..ValidatedTransactionDetails::default()
}),
error_metrics,
rent_collector,
)
}
fn all_features_except(exclude: Option<&[Pubkey]>) -> FeatureSet {
let mut features = FeatureSet::all_enabled();
if let Some(exclude) = exclude {
features.active_mut().retain(|k, _v| !exclude.contains(k));
}
features
}
fn new_unchecked_sanitized_message(message: Message) -> SanitizedMessage {
SanitizedMessage::Legacy(LegacyMessage::new(
message,
&ReservedAccountKeys::empty_key_set(),
))
}
fn load_accounts_aux_test(
tx: Transaction,
accounts: &[TransactionAccount],
error_metrics: &mut TransactionErrorMetrics,
) -> TransactionLoadResult {
load_accounts_with_features_and_rent(
tx,
accounts,
&RentCollector::default(),
error_metrics,
&mut FeatureSet::all_enabled(),
)
}
fn load_accounts_with_excluded_features(
tx: Transaction,
accounts: &[TransactionAccount],
error_metrics: &mut TransactionErrorMetrics,
exclude_features: Option<&[Pubkey]>,
) -> TransactionLoadResult {
load_accounts_with_features_and_rent(
tx,
accounts,
&RentCollector::default(),
error_metrics,
&mut all_features_except(exclude_features),
)
}
#[test]
fn test_load_accounts_unknown_program_id() {
let mut accounts: Vec<TransactionAccount> = Vec::new();
let mut error_metrics = TransactionErrorMetrics::default();
let keypair = Keypair::new();
let key0 = keypair.pubkey();
let key1 = Pubkey::from([5u8; 32]);
let account = AccountSharedData::new(1, 0, &Pubkey::default());
accounts.push((key0, account));
let account = AccountSharedData::new(2, 1, &Pubkey::default());
accounts.push((key1, account));
let instructions = vec![CompiledInstruction::new(1, &(), vec![0])];
let tx = Transaction::new_with_compiled_instructions(
&[&keypair],
&[],
Hash::default(),
vec![Pubkey::default()],
instructions,
);
let load_results = load_accounts_aux_test(tx, &accounts, &mut error_metrics);
assert_eq!(error_metrics.account_not_found.0, 1);
assert!(matches!(
load_results,
TransactionLoadResult::FeesOnly(FeesOnlyTransaction {
load_error: TransactionError::ProgramAccountNotFound,
..
}),
));
}
#[test]
fn test_load_accounts_no_loaders() {
let mut accounts: Vec<TransactionAccount> = Vec::new();
let mut error_metrics = TransactionErrorMetrics::default();
let keypair = Keypair::new();
let key0 = keypair.pubkey();
let key1 = Pubkey::from([5u8; 32]);
let mut account = AccountSharedData::new(1, 0, &Pubkey::default());
account.set_rent_epoch(1);
accounts.push((key0, account));
let mut account = AccountSharedData::new(2, 1, &Pubkey::default());
account.set_rent_epoch(1);
accounts.push((key1, account));
let instructions = vec![CompiledInstruction::new(2, &(), vec![0, 1])];
let tx = Transaction::new_with_compiled_instructions(
&[&keypair],
&[key1],
Hash::default(),
vec![native_loader::id()],
instructions,
);
let loaded_accounts =
load_accounts_with_excluded_features(tx, &accounts, &mut error_metrics, None);
assert_eq!(error_metrics.account_not_found.0, 0);
match &loaded_accounts {
TransactionLoadResult::Loaded(loaded_transaction) => {
assert_eq!(loaded_transaction.accounts.len(), 3);
assert_eq!(loaded_transaction.accounts[0].1, accounts[0].1);
assert_eq!(loaded_transaction.program_indices.len(), 1);
assert_eq!(loaded_transaction.program_indices[0].len(), 0);
}
TransactionLoadResult::FeesOnly(fees_only_tx) => panic!("{}", fees_only_tx.load_error),
TransactionLoadResult::NotLoaded(e) => panic!("{e}"),
}
}
#[test]
fn test_load_accounts_bad_owner() {
let mut accounts: Vec<TransactionAccount> = Vec::new();
let mut error_metrics = TransactionErrorMetrics::default();
let keypair = Keypair::new();
let key0 = keypair.pubkey();
let key1 = Pubkey::from([5u8; 32]);
let account = AccountSharedData::new(1, 0, &Pubkey::default());
accounts.push((key0, account));
let mut account = AccountSharedData::new(40, 1, &Pubkey::default());
account.set_owner(bpf_loader_upgradeable::id());
account.set_executable(true);
accounts.push((key1, account));
let instructions = vec![CompiledInstruction::new(1, &(), vec![0])];
let tx = Transaction::new_with_compiled_instructions(
&[&keypair],
&[],
Hash::default(),
vec![key1],
instructions,
);
let load_results = load_accounts_aux_test(tx, &accounts, &mut error_metrics);
assert_eq!(error_metrics.account_not_found.0, 1);
assert!(matches!(
load_results,
TransactionLoadResult::FeesOnly(FeesOnlyTransaction {
load_error: TransactionError::ProgramAccountNotFound,
..
}),
));
}
#[test]
fn test_load_accounts_not_executable() {
let mut accounts: Vec<TransactionAccount> = Vec::new();
let mut error_metrics = TransactionErrorMetrics::default();
let keypair = Keypair::new();
let key0 = keypair.pubkey();
let key1 = Pubkey::from([5u8; 32]);
let account = AccountSharedData::new(1, 0, &Pubkey::default());
accounts.push((key0, account));
let account = AccountSharedData::new(40, 0, &native_loader::id());
accounts.push((key1, account));
let instructions = vec![CompiledInstruction::new(1, &(), vec![0])];
let tx = Transaction::new_with_compiled_instructions(
&[&keypair],
&[],
Hash::default(),
vec![key1],
instructions,
);
let mut feature_set = FeatureSet::all_enabled();
feature_set.deactivate(&feature_set::remove_accounts_executable_flag_checks::id());
let load_results = load_accounts_with_features_and_rent(
tx,
&accounts,
&RentCollector::default(),
&mut error_metrics,
&mut feature_set,
);
assert_eq!(error_metrics.invalid_program_for_execution.0, 1);
assert!(matches!(
load_results,
TransactionLoadResult::FeesOnly(FeesOnlyTransaction {
load_error: TransactionError::InvalidProgramForExecution,
..
}),
));
}
#[test]
fn test_load_accounts_multiple_loaders() {
let mut accounts: Vec<TransactionAccount> = Vec::new();
let mut error_metrics = TransactionErrorMetrics::default();
let keypair = Keypair::new();
let key0 = keypair.pubkey();
let key1 = bpf_loader_upgradeable::id();
let key2 = Pubkey::from([6u8; 32]);
let mut account = AccountSharedData::new(1, 0, &Pubkey::default());
account.set_rent_epoch(1);
accounts.push((key0, account));
let mut account = AccountSharedData::new(40, 1, &Pubkey::default());
account.set_executable(true);
account.set_rent_epoch(1);
account.set_owner(native_loader::id());
accounts.push((key1, account));
let mut account = AccountSharedData::new(41, 1, &Pubkey::default());
account.set_executable(true);
account.set_rent_epoch(1);
account.set_owner(key1);
accounts.push((key2, account));
let instructions = vec![
CompiledInstruction::new(1, &(), vec![0]),
CompiledInstruction::new(2, &(), vec![0]),
];
let tx = Transaction::new_with_compiled_instructions(
&[&keypair],
&[],
Hash::default(),
vec![key1, key2],
instructions,
);
let loaded_accounts =
load_accounts_with_excluded_features(tx, &accounts, &mut error_metrics, None);
assert_eq!(error_metrics.account_not_found.0, 0);
match &loaded_accounts {
TransactionLoadResult::Loaded(loaded_transaction) => {
assert_eq!(loaded_transaction.accounts.len(), 3);
assert_eq!(loaded_transaction.accounts[0].1, accounts[0].1);
assert_eq!(loaded_transaction.program_indices.len(), 2);
assert_eq!(loaded_transaction.program_indices[0], &[1]);
assert_eq!(loaded_transaction.program_indices[1], &[2]);
}
TransactionLoadResult::FeesOnly(fees_only_tx) => panic!("{}", fees_only_tx.load_error),
TransactionLoadResult::NotLoaded(e) => panic!("{e}"),
}
}
fn load_accounts_no_store(
accounts: &[TransactionAccount],
tx: Transaction,
account_overrides: Option<&AccountOverrides>,
) -> TransactionLoadResult {
let tx = SanitizedTransaction::from_transaction_for_tests(tx);
let mut error_metrics = TransactionErrorMetrics::default();
let mut accounts_map = HashMap::new();
for (pubkey, account) in accounts {
accounts_map.insert(*pubkey, account.clone());
}
let callbacks = TestCallbacks {
accounts_map,
..Default::default()
};
let mut account_loader = AccountLoader::new_with_account_cache_capacity(
account_overrides,
&callbacks,
Arc::new(FeatureSet::all_enabled()),
0,
);
load_transaction(
&mut account_loader,
&tx,
Ok(ValidatedTransactionDetails::default()),
&mut error_metrics,
&RentCollector::default(),
)
}
#[test]
fn test_instructions() {
clone_solana_logger::setup();
let instructions_key = clone_solana_sdk_ids::sysvar::instructions::id();
let keypair = Keypair::new();
let instructions = vec![CompiledInstruction::new(1, &(), vec![0, 1])];
let tx = Transaction::new_with_compiled_instructions(
&[&keypair],
&[clone_solana_pubkey::new_rand(), instructions_key],
Hash::default(),
vec![native_loader::id()],
instructions,
);
let load_results = load_accounts_no_store(&[], tx, None);
assert!(matches!(
load_results,
TransactionLoadResult::FeesOnly(FeesOnlyTransaction {
load_error: TransactionError::ProgramAccountNotFound,
..
}),
));
}
#[test]
fn test_overrides() {
clone_solana_logger::setup();
let mut account_overrides = AccountOverrides::default();
let slot_history_id = sysvar::slot_history::id();
let account = AccountSharedData::new(42, 0, &Pubkey::default());
account_overrides.set_slot_history(Some(account));
let keypair = Keypair::new();
let account = AccountSharedData::new(1_000_000, 0, &Pubkey::default());
let instructions = vec![CompiledInstruction::new(2, &(), vec![0])];
let tx = Transaction::new_with_compiled_instructions(
&[&keypair],
&[slot_history_id],
Hash::default(),
vec![native_loader::id()],
instructions,
);
let loaded_accounts =
load_accounts_no_store(&[(keypair.pubkey(), account)], tx, Some(&account_overrides));
match &loaded_accounts {
TransactionLoadResult::Loaded(loaded_transaction) => {
assert_eq!(loaded_transaction.accounts[0].0, keypair.pubkey());
assert_eq!(loaded_transaction.accounts[1].0, slot_history_id);
assert_eq!(loaded_transaction.accounts[1].1.lamports(), 42);
}
TransactionLoadResult::FeesOnly(fees_only_tx) => panic!("{}", fees_only_tx.load_error),
TransactionLoadResult::NotLoaded(e) => panic!("{e}"),
}
}
#[test]
fn test_accumulate_and_check_loaded_account_data_size() {
let mut error_metrics = TransactionErrorMetrics::default();
let mut accumulated_data_size: Saturating<u32> = Saturating(0);
let data_size: usize = 123;
let requested_data_size_limit = NonZeroU32::new(data_size as u32).unwrap();
assert!(accumulate_and_check_loaded_account_data_size(
&mut accumulated_data_size,
data_size,
requested_data_size_limit,
&mut error_metrics
)
.is_ok());
assert_eq!(data_size as u32, accumulated_data_size.0);
let another_byte: usize = 1;
assert_eq!(
accumulate_and_check_loaded_account_data_size(
&mut accumulated_data_size,
another_byte,
requested_data_size_limit,
&mut error_metrics
),
Err(TransactionError::MaxLoadedAccountsDataSizeExceeded)
);
}
struct ValidateFeePayerTestParameter {
is_nonce: bool,
payer_init_balance: u64,
fee: u64,
expected_result: Result<()>,
payer_post_balance: u64,
}
fn validate_fee_payer_account(
test_parameter: ValidateFeePayerTestParameter,
rent_collector: &RentCollector,
) {
let payer_account_keys = Keypair::new();
let mut account = if test_parameter.is_nonce {
AccountSharedData::new_data(
test_parameter.payer_init_balance,
&NonceVersions::new(NonceState::Initialized(nonce::state::Data::default())),
&system_program::id(),
)
.unwrap()
} else {
AccountSharedData::new(test_parameter.payer_init_balance, 0, &system_program::id())
};
let result = validate_fee_payer(
&payer_account_keys.pubkey(),
&mut account,
0,
&mut TransactionErrorMetrics::default(),
rent_collector,
test_parameter.fee,
);
assert_eq!(result, test_parameter.expected_result);
assert_eq!(account.lamports(), test_parameter.payer_post_balance);
}
#[test]
fn test_validate_fee_payer() {
let rent_collector = RentCollector::new(
0,
EpochSchedule::default(),
500_000.0,
Rent {
lamports_per_byte_year: 1,
..Rent::default()
},
);
let min_balance = rent_collector.rent.minimum_balance(NonceState::size());
let fee = 5_000;
{
for (is_nonce, min_balance) in [(true, min_balance), (false, 0)] {
validate_fee_payer_account(
ValidateFeePayerTestParameter {
is_nonce,
payer_init_balance: min_balance + fee,
fee,
expected_result: Ok(()),
payer_post_balance: min_balance,
},
&rent_collector,
);
}
}
{
for is_nonce in [true, false] {
validate_fee_payer_account(
ValidateFeePayerTestParameter {
is_nonce,
payer_init_balance: 0,
fee,
expected_result: Err(TransactionError::AccountNotFound),
payer_post_balance: 0,
},
&rent_collector,
);
}
}
{
for (is_nonce, min_balance) in [(true, min_balance), (false, 0)] {
validate_fee_payer_account(
ValidateFeePayerTestParameter {
is_nonce,
payer_init_balance: min_balance + fee - 1,
fee,
expected_result: Err(TransactionError::InsufficientFundsForFee),
payer_post_balance: min_balance + fee - 1,
},
&rent_collector,
);
}
}
{
validate_fee_payer_account(
ValidateFeePayerTestParameter {
is_nonce: false,
payer_init_balance: u64::MAX,
fee: u64::MAX,
expected_result: Ok(()),
payer_post_balance: 0,
},
&rent_collector,
);
}
}
#[test]
fn test_validate_nonce_fee_payer_with_checked_arithmetic() {
let rent_collector = RentCollector::new(
0,
EpochSchedule::default(),
500_000.0,
Rent {
lamports_per_byte_year: 1,
..Rent::default()
},
);
validate_fee_payer_account(
ValidateFeePayerTestParameter {
is_nonce: true,
payer_init_balance: u64::MAX,
fee: u64::MAX,
expected_result: Err(TransactionError::InsufficientFundsForFee),
payer_post_balance: u64::MAX,
},
&rent_collector,
);
}
#[test]
fn test_construct_instructions_account() {
let loaded_message = LoadedMessage {
message: Cow::Owned(clone_solana_message::v0::Message::default()),
loaded_addresses: Cow::Owned(LoadedAddresses::default()),
is_writable_account_cache: vec![false],
};
let message = SanitizedMessage::V0(loaded_message);
let shared_data = construct_instructions_account(&message);
let expected = AccountSharedData::from(Account {
data: construct_instructions_data(&message.decompile_instructions()),
owner: sysvar::id(),
..Account::default()
});
assert_eq!(shared_data, expected);
}
#[test]
fn test_load_transaction_accounts_fee_payer() {
let fee_payer_address = Pubkey::new_unique();
let message = Message {
account_keys: vec![fee_payer_address],
header: MessageHeader::default(),
instructions: vec![],
recent_blockhash: Hash::default(),
};
let sanitized_message = new_unchecked_sanitized_message(message);
let mut mock_bank = TestCallbacks::default();
let fee_payer_balance = 200;
let mut fee_payer_account = AccountSharedData::default();
fee_payer_account.set_lamports(fee_payer_balance);
mock_bank
.accounts_map
.insert(fee_payer_address, fee_payer_account.clone());
let mut account_loader = (&mock_bank).into();
let fee_payer_rent_debit = 42;
let mut error_metrics = TransactionErrorMetrics::default();
let sanitized_transaction = SanitizedTransaction::new_for_tests(
sanitized_message,
vec![Signature::new_unique()],
false,
);
let result = load_transaction_accounts(
&mut account_loader,
sanitized_transaction.message(),
LoadedTransactionAccount {
loaded_size: fee_payer_account.data().len(),
account: fee_payer_account.clone(),
rent_collected: fee_payer_rent_debit,
},
&ComputeBudgetLimits::default(),
&mut error_metrics,
&RentCollector::default(),
);
let expected_rent_debits = {
let mut rent_debits = RentDebits::default();
rent_debits.insert(&fee_payer_address, fee_payer_rent_debit, fee_payer_balance);
rent_debits
};
assert_eq!(
result.unwrap(),
LoadedTransactionAccounts {
accounts: vec![(fee_payer_address, fee_payer_account)],
program_indices: vec![],
rent: fee_payer_rent_debit,
rent_debits: expected_rent_debits,
loaded_accounts_data_size: 0,
}
);
}
#[test]
fn test_load_transaction_accounts_native_loader() {
let key1 = Keypair::new();
let message = Message {
account_keys: vec![key1.pubkey(), native_loader::id()],
header: MessageHeader::default(),
instructions: vec![CompiledInstruction {
program_id_index: 1,
accounts: vec![0],
data: vec![],
}],
recent_blockhash: Hash::default(),
};
let sanitized_message = new_unchecked_sanitized_message(message);
let mut mock_bank = TestCallbacks::default();
mock_bank
.accounts_map
.insert(native_loader::id(), AccountSharedData::default());
let mut fee_payer_account = AccountSharedData::default();
fee_payer_account.set_lamports(200);
mock_bank
.accounts_map
.insert(key1.pubkey(), fee_payer_account.clone());
let mut account_loader = (&mock_bank).into();
let mut error_metrics = TransactionErrorMetrics::default();
let sanitized_transaction = SanitizedTransaction::new_for_tests(
sanitized_message,
vec![Signature::new_unique()],
false,
);
let result = load_transaction_accounts(
&mut account_loader,
sanitized_transaction.message(),
LoadedTransactionAccount {
account: fee_payer_account.clone(),
..LoadedTransactionAccount::default()
},
&ComputeBudgetLimits::default(),
&mut error_metrics,
&RentCollector::default(),
);
assert_eq!(
result.unwrap(),
LoadedTransactionAccounts {
accounts: vec![
(key1.pubkey(), fee_payer_account),
(
native_loader::id(),
mock_bank.accounts_map[&native_loader::id()].clone()
)
],
program_indices: vec![vec![]],
rent: 0,
rent_debits: RentDebits::default(),
loaded_accounts_data_size: 0,
}
);
}
#[test]
fn test_load_transaction_accounts_program_account_no_data() {
let key1 = Keypair::new();
let key2 = Keypair::new();
let message = Message {
account_keys: vec![key1.pubkey(), key2.pubkey()],
header: MessageHeader::default(),
instructions: vec![CompiledInstruction {
program_id_index: 1,
accounts: vec![0, 1],
data: vec![],
}],
recent_blockhash: Hash::default(),
};
let sanitized_message = new_unchecked_sanitized_message(message);
let mut mock_bank = TestCallbacks::default();
let mut account_data = AccountSharedData::default();
account_data.set_lamports(200);
mock_bank.accounts_map.insert(key1.pubkey(), account_data);
let mut account_loader = (&mock_bank).into();
let mut error_metrics = TransactionErrorMetrics::default();
let sanitized_transaction = SanitizedTransaction::new_for_tests(
sanitized_message,
vec![Signature::new_unique()],
false,
);
let result = load_transaction_accounts(
&mut account_loader,
sanitized_transaction.message(),
LoadedTransactionAccount::default(),
&ComputeBudgetLimits::default(),
&mut error_metrics,
&RentCollector::default(),
);
assert_eq!(result.err(), Some(TransactionError::ProgramAccountNotFound));
}
#[test]
fn test_load_transaction_accounts_invalid_program_for_execution() {
let key1 = Keypair::new();
let key2 = Keypair::new();
let message = Message {
account_keys: vec![key1.pubkey(), key2.pubkey()],
header: MessageHeader::default(),
instructions: vec![CompiledInstruction {
program_id_index: 0,
accounts: vec![0, 1],
data: vec![],
}],
recent_blockhash: Hash::default(),
};
let sanitized_message = new_unchecked_sanitized_message(message);
let mut mock_bank = TestCallbacks::default();
let mut account_data = AccountSharedData::default();
account_data.set_lamports(200);
mock_bank.accounts_map.insert(key1.pubkey(), account_data);
let mut account_loader = (&mock_bank).into();
let mut error_metrics = TransactionErrorMetrics::default();
let sanitized_transaction = SanitizedTransaction::new_for_tests(
sanitized_message,
vec![Signature::new_unique()],
false,
);
let result = load_transaction_accounts(
&mut account_loader,
sanitized_transaction.message(),
LoadedTransactionAccount::default(),
&ComputeBudgetLimits::default(),
&mut error_metrics,
&RentCollector::default(),
);
assert_eq!(
result.err(),
Some(TransactionError::InvalidProgramForExecution)
);
}
#[test]
fn test_load_transaction_accounts_native_loader_owner() {
let key1 = Keypair::new();
let key2 = Keypair::new();
let message = Message {
account_keys: vec![key2.pubkey(), key1.pubkey()],
header: MessageHeader::default(),
instructions: vec![CompiledInstruction {
program_id_index: 1,
accounts: vec![0],
data: vec![],
}],
recent_blockhash: Hash::default(),
};
let sanitized_message = new_unchecked_sanitized_message(message);
let mut mock_bank = TestCallbacks::default();
let mut account_data = AccountSharedData::default();
account_data.set_owner(native_loader::id());
account_data.set_lamports(1);
account_data.set_executable(true);
mock_bank.accounts_map.insert(key1.pubkey(), account_data);
let mut fee_payer_account = AccountSharedData::default();
fee_payer_account.set_lamports(200);
mock_bank
.accounts_map
.insert(key2.pubkey(), fee_payer_account.clone());
let mut account_loader = (&mock_bank).into();
let mut error_metrics = TransactionErrorMetrics::default();
let sanitized_transaction = SanitizedTransaction::new_for_tests(
sanitized_message,
vec![Signature::new_unique()],
false,
);
let result = load_transaction_accounts(
&mut account_loader,
sanitized_transaction.message(),
LoadedTransactionAccount {
account: fee_payer_account.clone(),
..LoadedTransactionAccount::default()
},
&ComputeBudgetLimits::default(),
&mut error_metrics,
&RentCollector::default(),
);
assert_eq!(
result.unwrap(),
LoadedTransactionAccounts {
accounts: vec![
(key2.pubkey(), fee_payer_account),
(
key1.pubkey(),
mock_bank.accounts_map[&key1.pubkey()].clone()
),
],
program_indices: vec![vec![1]],
rent: 0,
rent_debits: RentDebits::default(),
loaded_accounts_data_size: 0,
}
);
}
#[test]
fn test_load_transaction_accounts_program_account_not_found_after_all_checks() {
let key1 = Keypair::new();
let key2 = Keypair::new();
let message = Message {
account_keys: vec![key2.pubkey(), key1.pubkey()],
header: MessageHeader::default(),
instructions: vec![CompiledInstruction {
program_id_index: 1,
accounts: vec![0],
data: vec![],
}],
recent_blockhash: Hash::default(),
};
let sanitized_message = new_unchecked_sanitized_message(message);
let mut mock_bank = TestCallbacks::default();
let mut account_data = AccountSharedData::default();
account_data.set_executable(true);
mock_bank.accounts_map.insert(key1.pubkey(), account_data);
let mut account_data = AccountSharedData::default();
account_data.set_lamports(200);
mock_bank.accounts_map.insert(key2.pubkey(), account_data);
let mut account_loader = (&mock_bank).into();
let mut error_metrics = TransactionErrorMetrics::default();
let sanitized_transaction = SanitizedTransaction::new_for_tests(
sanitized_message,
vec![Signature::new_unique()],
false,
);
let result = load_transaction_accounts(
&mut account_loader,
sanitized_transaction.message(),
LoadedTransactionAccount::default(),
&ComputeBudgetLimits::default(),
&mut error_metrics,
&RentCollector::default(),
);
assert_eq!(result.err(), Some(TransactionError::ProgramAccountNotFound));
}
#[test]
fn test_load_transaction_accounts_program_account_invalid_program_for_execution_last_check() {
let key1 = Keypair::new();
let key2 = Keypair::new();
let key3 = Keypair::new();
let message = Message {
account_keys: vec![key2.pubkey(), key1.pubkey()],
header: MessageHeader::default(),
instructions: vec![CompiledInstruction {
program_id_index: 1,
accounts: vec![0],
data: vec![],
}],
recent_blockhash: Hash::default(),
};
let sanitized_message = new_unchecked_sanitized_message(message);
let mut mock_bank = TestCallbacks::default();
let mut account_data = AccountSharedData::default();
account_data.set_lamports(1);
account_data.set_executable(true);
account_data.set_owner(key3.pubkey());
mock_bank.accounts_map.insert(key1.pubkey(), account_data);
let mut account_data = AccountSharedData::default();
account_data.set_lamports(200);
mock_bank.accounts_map.insert(key2.pubkey(), account_data);
mock_bank
.accounts_map
.insert(key3.pubkey(), AccountSharedData::default());
let mut account_loader = (&mock_bank).into();
let mut error_metrics = TransactionErrorMetrics::default();
let sanitized_transaction = SanitizedTransaction::new_for_tests(
sanitized_message,
vec![Signature::new_unique()],
false,
);
let result = load_transaction_accounts(
&mut account_loader,
sanitized_transaction.message(),
LoadedTransactionAccount::default(),
&ComputeBudgetLimits::default(),
&mut error_metrics,
&RentCollector::default(),
);
assert_eq!(
result.err(),
Some(TransactionError::InvalidProgramForExecution)
);
}
#[test]
fn test_load_transaction_accounts_program_success_complete() {
let key1 = Keypair::new();
let key2 = Keypair::new();
let key3 = Keypair::new();
let message = Message {
account_keys: vec![key2.pubkey(), key1.pubkey()],
header: MessageHeader::default(),
instructions: vec![CompiledInstruction {
program_id_index: 1,
accounts: vec![0],
data: vec![],
}],
recent_blockhash: Hash::default(),
};
let sanitized_message = new_unchecked_sanitized_message(message);
let mut mock_bank = TestCallbacks::default();
let mut account_data = AccountSharedData::default();
account_data.set_lamports(1);
account_data.set_executable(true);
account_data.set_owner(key3.pubkey());
mock_bank.accounts_map.insert(key1.pubkey(), account_data);
let mut fee_payer_account = AccountSharedData::default();
fee_payer_account.set_lamports(200);
mock_bank
.accounts_map
.insert(key2.pubkey(), fee_payer_account.clone());
let mut account_data = AccountSharedData::default();
account_data.set_lamports(1);
account_data.set_executable(true);
account_data.set_owner(native_loader::id());
mock_bank.accounts_map.insert(key3.pubkey(), account_data);
let mut account_loader = (&mock_bank).into();
let mut error_metrics = TransactionErrorMetrics::default();
let sanitized_transaction = SanitizedTransaction::new_for_tests(
sanitized_message,
vec![Signature::new_unique()],
false,
);
let result = load_transaction_accounts(
&mut account_loader,
sanitized_transaction.message(),
LoadedTransactionAccount {
account: fee_payer_account.clone(),
..LoadedTransactionAccount::default()
},
&ComputeBudgetLimits::default(),
&mut error_metrics,
&RentCollector::default(),
);
assert_eq!(
result.unwrap(),
LoadedTransactionAccounts {
accounts: vec![
(key2.pubkey(), fee_payer_account),
(
key1.pubkey(),
mock_bank.accounts_map[&key1.pubkey()].clone()
),
],
program_indices: vec![vec![1]],
rent: 0,
rent_debits: RentDebits::default(),
loaded_accounts_data_size: 0,
}
);
}
#[test]
fn test_load_transaction_accounts_program_builtin_saturating_add() {
let key1 = Keypair::new();
let key2 = Keypair::new();
let key3 = Keypair::new();
let key4 = Keypair::new();
let message = Message {
account_keys: vec![key2.pubkey(), key1.pubkey(), key4.pubkey()],
header: MessageHeader::default(),
instructions: vec![
CompiledInstruction {
program_id_index: 1,
accounts: vec![0],
data: vec![],
},
CompiledInstruction {
program_id_index: 1,
accounts: vec![2],
data: vec![],
},
],
recent_blockhash: Hash::default(),
};
let sanitized_message = new_unchecked_sanitized_message(message);
let mut mock_bank = TestCallbacks::default();
let mut account_data = AccountSharedData::default();
account_data.set_lamports(1);
account_data.set_executable(true);
account_data.set_owner(key3.pubkey());
mock_bank.accounts_map.insert(key1.pubkey(), account_data);
let mut fee_payer_account = AccountSharedData::default();
fee_payer_account.set_lamports(200);
mock_bank
.accounts_map
.insert(key2.pubkey(), fee_payer_account.clone());
let mut account_data = AccountSharedData::default();
account_data.set_lamports(1);
account_data.set_executable(true);
account_data.set_owner(native_loader::id());
mock_bank.accounts_map.insert(key3.pubkey(), account_data);
let mut account_loader = (&mock_bank).into();
let mut error_metrics = TransactionErrorMetrics::default();
let sanitized_transaction = SanitizedTransaction::new_for_tests(
sanitized_message,
vec![Signature::new_unique()],
false,
);
let result = load_transaction_accounts(
&mut account_loader,
sanitized_transaction.message(),
LoadedTransactionAccount {
account: fee_payer_account.clone(),
..LoadedTransactionAccount::default()
},
&ComputeBudgetLimits::default(),
&mut error_metrics,
&RentCollector::default(),
);
let mut account_data = AccountSharedData::default();
account_data.set_rent_epoch(RENT_EXEMPT_RENT_EPOCH);
assert_eq!(
result.unwrap(),
LoadedTransactionAccounts {
accounts: vec![
(key2.pubkey(), fee_payer_account),
(
key1.pubkey(),
mock_bank.accounts_map[&key1.pubkey()].clone()
),
(key4.pubkey(), account_data),
],
program_indices: vec![vec![1], vec![1]],
rent: 0,
rent_debits: RentDebits::default(),
loaded_accounts_data_size: 0,
}
);
}
#[test]
fn test_rent_state_list_len() {
let mint_keypair = Keypair::new();
let mut bank = TestCallbacks::default();
let recipient = Pubkey::new_unique();
let last_block_hash = Hash::new_unique();
let mut system_data = AccountSharedData::default();
system_data.set_lamports(1);
system_data.set_executable(true);
system_data.set_owner(native_loader::id());
bank.accounts_map
.insert(Pubkey::new_from_array([0u8; 32]), system_data);
let mut mint_data = AccountSharedData::default();
mint_data.set_lamports(2);
bank.accounts_map.insert(mint_keypair.pubkey(), mint_data);
bank.accounts_map
.insert(recipient, AccountSharedData::default());
let mut account_loader = (&bank).into();
let tx = transfer(
&mint_keypair,
&recipient,
sol_to_lamports(1.),
last_block_hash,
);
let num_accounts = tx.message().account_keys.len();
let sanitized_tx = SanitizedTransaction::from_transaction_for_tests(tx);
let mut error_metrics = TransactionErrorMetrics::default();
let load_result = load_transaction(
&mut account_loader,
&sanitized_tx.clone(),
Ok(ValidatedTransactionDetails::default()),
&mut error_metrics,
&RentCollector::default(),
);
let TransactionLoadResult::Loaded(loaded_transaction) = load_result else {
panic!("transaction loading failed");
};
let compute_budget = ComputeBudget::new(u64::from(
compute_budget_limits::DEFAULT_INSTRUCTION_COMPUTE_UNIT_LIMIT,
));
let rent_collector = RentCollector::default();
let transaction_context = TransactionContext::new(
loaded_transaction.accounts,
rent_collector.get_rent().clone(),
compute_budget.max_instruction_stack_depth,
compute_budget.max_instruction_trace_length,
);
assert_eq!(
TransactionAccountStateInfo::new(
&transaction_context,
sanitized_tx.message(),
&rent_collector,
)
.len(),
num_accounts,
);
}
#[test]
fn test_load_accounts_success() {
let key1 = Keypair::new();
let key2 = Keypair::new();
let key3 = Keypair::new();
let key4 = Keypair::new();
let message = Message {
account_keys: vec![key2.pubkey(), key1.pubkey(), key4.pubkey()],
header: MessageHeader::default(),
instructions: vec![
CompiledInstruction {
program_id_index: 1,
accounts: vec![0],
data: vec![],
},
CompiledInstruction {
program_id_index: 1,
accounts: vec![2],
data: vec![],
},
],
recent_blockhash: Hash::default(),
};
let sanitized_message = new_unchecked_sanitized_message(message);
let mut mock_bank = TestCallbacks::default();
let mut account_data = AccountSharedData::default();
account_data.set_lamports(1);
account_data.set_executable(true);
account_data.set_owner(key3.pubkey());
mock_bank.accounts_map.insert(key1.pubkey(), account_data);
let mut fee_payer_account = AccountSharedData::default();
fee_payer_account.set_lamports(200);
mock_bank
.accounts_map
.insert(key2.pubkey(), fee_payer_account.clone());
let mut account_data = AccountSharedData::default();
account_data.set_lamports(1);
account_data.set_executable(true);
account_data.set_owner(native_loader::id());
mock_bank.accounts_map.insert(key3.pubkey(), account_data);
let mut account_loader = (&mock_bank).into();
let mut error_metrics = TransactionErrorMetrics::default();
let sanitized_transaction = SanitizedTransaction::new_for_tests(
sanitized_message,
vec![Signature::new_unique()],
false,
);
let validation_result = Ok(ValidatedTransactionDetails {
loaded_fee_payer_account: LoadedTransactionAccount {
account: fee_payer_account,
..LoadedTransactionAccount::default()
},
..ValidatedTransactionDetails::default()
});
let load_result = load_transaction(
&mut account_loader,
&sanitized_transaction,
validation_result,
&mut error_metrics,
&RentCollector::default(),
);
let mut account_data = AccountSharedData::default();
account_data.set_rent_epoch(RENT_EXEMPT_RENT_EPOCH);
let TransactionLoadResult::Loaded(loaded_transaction) = load_result else {
panic!("transaction loading failed");
};
assert_eq!(
loaded_transaction,
LoadedTransaction {
accounts: vec![
(
key2.pubkey(),
mock_bank.accounts_map[&key2.pubkey()].clone()
),
(
key1.pubkey(),
mock_bank.accounts_map[&key1.pubkey()].clone()
),
(key4.pubkey(), account_data),
],
program_indices: vec![vec![1], vec![1]],
fee_details: FeeDetails::default(),
rollback_accounts: RollbackAccounts::default(),
compute_budget_limits: ComputeBudgetLimits::default(),
rent: 0,
rent_debits: RentDebits::default(),
loaded_accounts_data_size: 0,
}
);
}
#[test]
fn test_load_accounts_error() {
let mock_bank = TestCallbacks::default();
let mut account_loader = (&mock_bank).into();
let rent_collector = RentCollector::default();
let message = Message {
account_keys: vec![Pubkey::new_from_array([0; 32])],
header: MessageHeader::default(),
instructions: vec![CompiledInstruction {
program_id_index: 0,
accounts: vec![],
data: vec![],
}],
recent_blockhash: Hash::default(),
};
let sanitized_message = new_unchecked_sanitized_message(message);
let sanitized_transaction = SanitizedTransaction::new_for_tests(
sanitized_message,
vec![Signature::new_unique()],
false,
);
let validation_result = Ok(ValidatedTransactionDetails::default());
let load_result = load_transaction(
&mut account_loader,
&sanitized_transaction,
validation_result.clone(),
&mut TransactionErrorMetrics::default(),
&rent_collector,
);
assert!(matches!(
load_result,
TransactionLoadResult::FeesOnly(FeesOnlyTransaction {
load_error: TransactionError::ProgramAccountNotFound,
..
}),
));
let validation_result = Err(TransactionError::InvalidWritableAccount);
let load_result = load_transaction(
&mut account_loader,
&sanitized_transaction,
validation_result,
&mut TransactionErrorMetrics::default(),
&rent_collector,
);
assert!(matches!(
load_result,
TransactionLoadResult::NotLoaded(TransactionError::InvalidWritableAccount),
));
}
#[test]
fn test_collect_rent_from_account() {
let feature_set = FeatureSet::all_enabled();
let rent_collector = RentCollector {
epoch: 1,
..RentCollector::default()
};
let address = Pubkey::new_unique();
let min_exempt_balance = rent_collector.rent.minimum_balance(0);
let mut account = AccountSharedData::from(Account {
lamports: min_exempt_balance,
..Account::default()
});
assert_eq!(
collect_rent_from_account(&feature_set, &rent_collector, &address, &mut account),
CollectedInfo::default()
);
assert_eq!(account.rent_epoch(), RENT_EXEMPT_RENT_EPOCH);
}
#[test]
fn test_collect_rent_from_account_rent_paying() {
let feature_set = FeatureSet::all_enabled();
let rent_collector = RentCollector {
epoch: 1,
..RentCollector::default()
};
let address = Pubkey::new_unique();
let mut account = AccountSharedData::from(Account {
lamports: 1,
..Account::default()
});
assert_eq!(
collect_rent_from_account(&feature_set, &rent_collector, &address, &mut account),
CollectedInfo::default()
);
assert_eq!(account.rent_epoch(), 0);
assert_eq!(account.lamports(), 1);
}
#[test]
fn test_collect_rent_from_account_rent_enabled() {
let feature_set =
all_features_except(Some(&[feature_set::disable_rent_fees_collection::id()]));
let rent_collector = RentCollector {
epoch: 1,
..RentCollector::default()
};
let address = Pubkey::new_unique();
let mut account = AccountSharedData::from(Account {
lamports: 1,
data: vec![0],
..Account::default()
});
assert_eq!(
collect_rent_from_account(&feature_set, &rent_collector, &address, &mut account),
CollectedInfo {
rent_amount: 1,
account_data_len_reclaimed: 1
}
);
assert_eq!(account.rent_epoch(), 0);
assert_eq!(account.lamports(), 0);
}
#[test]
fn test_inspect_account_non_fee_payer() {
let mut mock_bank = TestCallbacks::default();
let address0 = Pubkey::new_unique(); let address1 = Pubkey::new_unique(); let address2 = Pubkey::new_unique(); let address3 = Pubkey::new_unique();
let mut account0 = AccountSharedData::default();
account0.set_lamports(1_000_000_000);
mock_bank.accounts_map.insert(address0, account0.clone());
let mut account1 = AccountSharedData::default();
account1.set_lamports(2_000_000_000);
mock_bank.accounts_map.insert(address1, account1.clone());
let mut account3 = AccountSharedData::default();
account3.set_lamports(4_000_000_000);
account3.set_executable(true);
account3.set_owner(bpf_loader::id());
mock_bank.accounts_map.insert(address3, account3.clone());
let mut account_loader = (&mock_bank).into();
let message = Message {
account_keys: vec![address0, address1, address2, address3],
header: MessageHeader::default(),
instructions: vec![
CompiledInstruction {
program_id_index: 3,
accounts: vec![0],
data: vec![],
},
CompiledInstruction {
program_id_index: 3,
accounts: vec![1, 2],
data: vec![],
},
CompiledInstruction {
program_id_index: 3,
accounts: vec![1],
data: vec![],
},
],
recent_blockhash: Hash::new_unique(),
};
let sanitized_message = new_unchecked_sanitized_message(message);
let sanitized_transaction = SanitizedTransaction::new_for_tests(
sanitized_message,
vec![Signature::new_unique()],
false,
);
let validation_result = Ok(ValidatedTransactionDetails {
loaded_fee_payer_account: LoadedTransactionAccount {
account: account0.clone(),
..LoadedTransactionAccount::default()
},
..ValidatedTransactionDetails::default()
});
let _load_results = load_transaction(
&mut account_loader,
&sanitized_transaction,
validation_result,
&mut TransactionErrorMetrics::default(),
&RentCollector::default(),
);
let mut actual_inspected_accounts: Vec<_> = mock_bank
.inspected_accounts
.borrow()
.iter()
.map(|(k, v)| (*k, v.clone()))
.collect();
actual_inspected_accounts.sort_unstable_by(|a, b| a.0.cmp(&b.0));
let mut expected_inspected_accounts = vec![
(address1, vec![(Some(account1), true)]),
(address2, vec![(None, true)]),
(
address3,
vec![(Some(account3.clone()), false), (Some(account3), false)],
),
(bpf_loader::id(), vec![(None, false)]),
];
expected_inspected_accounts.sort_unstable_by(|a, b| a.0.cmp(&b.0));
assert_eq!(actual_inspected_accounts, expected_inspected_accounts,);
}
#[test]
fn test_load_transaction_accounts_data_sizes() {
let mut mock_bank = TestCallbacks::default();
let loader_v2 = bpf_loader::id();
let loader_v3 = bpf_loader_upgradeable::id();
let program1_keypair = Keypair::new();
let program1 = program1_keypair.pubkey();
let program2 = Pubkey::new_unique();
let programdata2 = Pubkey::new_unique();
use clone_solana_account::state_traits::StateMut;
let program2_size = std::mem::size_of::<UpgradeableLoaderState>() as u32;
let mut program2_account = AccountSharedData::default();
program2_account.set_owner(loader_v3);
program2_account.set_lamports(LAMPORTS_PER_SOL);
program2_account.set_executable(true);
program2_account.set_data(vec![0; program2_size as usize]);
program2_account
.set_state(&UpgradeableLoaderState::Program {
programdata_address: programdata2,
})
.unwrap();
mock_bank.accounts_map.insert(program2, program2_account);
let mut programdata2_account = AccountSharedData::default();
programdata2_account.set_owner(loader_v3);
programdata2_account.set_lamports(LAMPORTS_PER_SOL);
programdata2_account.set_data(vec![0; program2_size as usize]);
programdata2_account
.set_state(&UpgradeableLoaderState::ProgramData {
slot: 0,
upgrade_authority_address: None,
})
.unwrap();
let mut programdata = programdata2_account.data().to_vec();
let mut file =
File::open("tests/example-programs/hello-solana/hello_clone_solana_program.so")
.unwrap();
file.read_to_end(&mut programdata).unwrap();
let programdata2_size = programdata.len() as u32;
programdata2_account.set_data(programdata);
mock_bank
.accounts_map
.insert(programdata2, programdata2_account);
let mut next_size = 1;
let mut make_account = |pubkey, owner, executable| {
let size = next_size;
let account = AccountSharedData::create(
LAMPORTS_PER_SOL,
vec![0; size],
owner,
executable,
u64::MAX,
);
mock_bank.accounts_map.insert(pubkey, account.clone());
next_size *= 4;
(size as u32, account)
};
let fee_payer_keypair = Keypair::new();
let fee_payer = fee_payer_keypair.pubkey();
let (fee_payer_size, fee_payer_account) =
make_account(fee_payer, system_program::id(), false);
let account1 = Pubkey::new_unique();
let (account1_size, _) = make_account(account1, program1, false);
let account2 = Pubkey::new_unique();
let (account2_size, _) = make_account(account2, program2, false);
let (native_loader_size, _) = make_account(native_loader::id(), native_loader::id(), true);
let (bpf_loader_size, _) = make_account(loader_v2, native_loader::id(), true);
let (upgradeable_loader_size, _) = make_account(loader_v3, native_loader::id(), true);
let (program1_size, _) = make_account(program1, loader_v2, true);
let mut program_accounts = HashMap::new();
program_accounts.insert(program1, (&loader_v2, 0));
program_accounts.insert(program2, (&loader_v3, 0));
let test_transaction_data_size = |transaction, expected_size| {
let mut account_loader = AccountLoader::new_with_account_cache_capacity(
None,
&mock_bank,
Arc::<FeatureSet>::default(),
0,
);
let loaded_transaction_accounts = load_transaction_accounts(
&mut account_loader,
&transaction,
LoadedTransactionAccount {
account: fee_payer_account.clone(),
loaded_size: fee_payer_size as usize,
rent_collected: 0,
},
&ComputeBudgetLimits::default(),
&mut TransactionErrorMetrics::default(),
&RentCollector::default(),
)
.unwrap();
assert_eq!(
loaded_transaction_accounts.loaded_accounts_data_size,
expected_size
);
};
let test_data_size = |instructions: Vec<_>, expected_size| {
let transaction = SanitizedTransaction::from_transaction_for_tests(
Transaction::new_signed_with_payer(
&instructions,
Some(&fee_payer),
&[&fee_payer_keypair],
Hash::default(),
),
);
test_transaction_data_size(transaction, expected_size)
};
for account_meta in [AccountMeta::new, AccountMeta::new_readonly] {
let ixns = vec![Instruction::new_with_bytes(program1, &[], vec![])];
test_data_size(ixns, program1_size + bpf_loader_size + fee_payer_size);
let ixns = vec![
Instruction::new_with_bytes(program1, &[], vec![account_meta(account1, false)]),
Instruction::new_with_bytes(program2, &[], vec![account_meta(account2, false)]),
];
test_data_size(
ixns,
account1_size
+ account2_size
+ program1_size
+ program2_size
+ bpf_loader_size
+ upgradeable_loader_size
+ fee_payer_size,
);
let ixns = vec![
Instruction::new_with_bytes(program2, &[], vec![]),
Instruction::new_with_bytes(program2, &[], vec![]),
];
test_data_size(
ixns,
program2_size + upgradeable_loader_size + fee_payer_size,
);
let ixns = vec![Instruction::new_with_bytes(bpf_loader::id(), &[], vec![])];
test_data_size(ixns, bpf_loader_size + fee_payer_size);
let ixns = vec![Instruction::new_with_bytes(
bpf_loader::id(),
&[],
vec![account_meta(native_loader::id(), false)],
)];
test_data_size(ixns, bpf_loader_size + native_loader_size + fee_payer_size);
let ixns = vec![Instruction::new_with_bytes(
native_loader::id(),
&[],
vec![],
)];
test_data_size(ixns, native_loader_size + fee_payer_size);
let ixns = vec![Instruction::new_with_bytes(
native_loader::id(),
&[],
vec![account_meta(native_loader::id(), false)],
)];
test_data_size(ixns, native_loader_size + fee_payer_size);
let ixns = vec![Instruction::new_with_bytes(
program2,
&[],
vec![account_meta(bpf_loader_upgradeable::id(), false)],
)];
test_data_size(
ixns,
upgradeable_loader_size * 2 + program2_size + fee_payer_size,
);
let ixns = vec![
Instruction::new_with_bytes(bpf_loader_upgradeable::id(), &[], vec![]),
Instruction::new_with_bytes(program2, &[], vec![]),
];
test_data_size(
ixns,
upgradeable_loader_size * 2 + program2_size + fee_payer_size,
);
let ixns = vec![
Instruction::new_with_bytes(
program1,
&[],
vec![
account_meta(bpf_loader::id(), false),
account_meta(bpf_loader_upgradeable::id(), false),
],
),
Instruction::new_with_bytes(program2, &[], vec![account_meta(account1, false)]),
Instruction::new_with_bytes(
bpf_loader_upgradeable::id(),
&[],
vec![account_meta(account1, false)],
),
];
test_data_size(
ixns,
account1_size
+ program1_size
+ program2_size
+ bpf_loader_size * 2
+ upgradeable_loader_size * 2
+ fee_payer_size,
);
let ixns = vec![Instruction::new_with_bytes(
program1,
&[],
vec![account_meta(fee_payer, false)],
)];
test_data_size(ixns, program1_size + bpf_loader_size + fee_payer_size);
let ixns = vec![Instruction::new_with_bytes(
program2,
&[],
vec![account_meta(programdata2, false)],
)];
test_data_size(
ixns,
program2_size + programdata2_size + upgradeable_loader_size + fee_payer_size,
);
let ixns = vec![Instruction::new_with_bytes(
program2,
&[],
vec![
account_meta(program2, false),
account_meta(programdata2, false),
],
)];
test_data_size(
ixns,
program2_size + programdata2_size + upgradeable_loader_size + fee_payer_size,
);
}
}
}