Struct solana_runtime::bank::Bank
source · pub struct Bank {Show 16 fields
pub rc: BankRc,
pub status_cache: Arc<RwLock<BankStatusCache>>,
pub ancestors: Ancestors,
pub ns_per_slot: u128,
pub rewards: RwLock<Vec<(Pubkey, RewardInfo)>>,
pub cluster_type: Option<ClusterType>,
pub lazy_rent_collection: AtomicBool,
pub rewards_pool_pubkeys: Arc<HashSet<Pubkey>>,
pub transaction_log_collector_config: Arc<RwLock<TransactionLogCollectorConfig>>,
pub transaction_log_collector: Arc<RwLock<TransactionLogCollector>>,
pub feature_set: Arc<FeatureSet>,
pub drop_callback: RwLock<OptionalDropCallback>,
pub freeze_started: AtomicBool,
pub rewrites_skipped_this_slot: Rewrites,
pub fee_structure: FeeStructure,
pub incremental_snapshot_persistence: Option<BankIncrementalSnapshotPersistence>,
/* private fields */
}
Expand description
Manager for the state of all accounts and programs after processing its entries. AbiExample is needed even without Serialize/Deserialize; actual (de-)serialization are implemented elsewhere for versioning
Fields§
§rc: BankRc
References to accounts, parent and signature status
status_cache: Arc<RwLock<BankStatusCache>>
A cache of signature statuses
ancestors: Ancestors
The set of parents including this bank
ns_per_slot: u128
length of a slot in ns
rewards: RwLock<Vec<(Pubkey, RewardInfo)>>
Protocol-level rewards that were distributed by this bank
cluster_type: Option<ClusterType>
§lazy_rent_collection: AtomicBool
§rewards_pool_pubkeys: Arc<HashSet<Pubkey>>
§transaction_log_collector_config: Arc<RwLock<TransactionLogCollectorConfig>>
§transaction_log_collector: Arc<RwLock<TransactionLogCollector>>
§feature_set: Arc<FeatureSet>
§drop_callback: RwLock<OptionalDropCallback>
callback function only to be called when dropping and should only be called once
freeze_started: AtomicBool
§rewrites_skipped_this_slot: Rewrites
(Pubkey, account Hash) for each account that would have been rewritten in rent collection for this slot
fee_structure: FeeStructure
Transaction fee structure
incremental_snapshot_persistence: Option<BankIncrementalSnapshotPersistence>
Implementations§
source§impl Bank
impl Bank
pub fn get_sysvar_cache_for_tests(&self) -> SysvarCache
source§impl Bank
impl Bank
pub fn default_for_tests() -> Self
pub fn new_for_benches(genesis_config: &GenesisConfig) -> Self
pub fn new_for_tests(genesis_config: &GenesisConfig) -> Self
pub fn new_no_wallclock_throttle_for_tests( genesis_config: &GenesisConfig ) -> Self
pub fn new_with_paths_for_tests( genesis_config: &GenesisConfig, paths: Vec<PathBuf>, debug_keys: Option<Arc<HashSet<Pubkey>>>, additional_builtins: Option<&Builtins>, account_indexes: AccountSecondaryIndexes, accounts_db_caching_enabled: bool, shrink_ratio: AccountShrinkThreshold, debug_do_not_add_builtins: bool, accounts_db_config: Option<AccountsDbConfig> ) -> Self
pub fn new_with_paths_for_benches( genesis_config: &GenesisConfig, paths: Vec<PathBuf>, debug_keys: Option<Arc<HashSet<Pubkey>>>, additional_builtins: Option<&Builtins>, account_indexes: AccountSecondaryIndexes, accounts_db_caching_enabled: bool, shrink_ratio: AccountShrinkThreshold, debug_do_not_add_builtins: bool ) -> Self
pub fn new_with_paths( genesis_config: &GenesisConfig, paths: Vec<PathBuf>, debug_keys: Option<Arc<HashSet<Pubkey>>>, additional_builtins: Option<&Builtins>, account_indexes: AccountSecondaryIndexes, accounts_db_caching_enabled: bool, shrink_ratio: AccountShrinkThreshold, debug_do_not_add_builtins: bool, accounts_db_config: Option<AccountsDbConfig>, accounts_update_notifier: Option<AccountsUpdateNotifier> ) -> Self
sourcepub fn new_from_parent(
parent: &Arc<Bank>,
collector_id: &Pubkey,
slot: Slot
) -> Self
pub fn new_from_parent( parent: &Arc<Bank>, collector_id: &Pubkey, slot: Slot ) -> Self
Create a new bank that points to an immutable checkpoint of another bank.
pub fn new_from_parent_with_options( parent: &Arc<Bank>, collector_id: &Pubkey, slot: Slot, new_bank_options: NewBankOptions ) -> Self
pub fn new_from_parent_with_tracer( parent: &Arc<Bank>, collector_id: &Pubkey, slot: Slot, reward_calc_tracer: impl Fn(&RewardCalculationEvent<'_, '_>) + Send + Sync ) -> Self
pub fn byte_limit_for_scans(&self) -> Option<usize>
pub fn proper_ancestors_set(&self) -> HashSet<Slot>
pub fn set_callback(&self, callback: Option<Box<dyn DropCallback + Send + Sync>>)
pub fn vote_only_bank(&self) -> bool
sourcepub fn warp_from_parent(
parent: &Arc<Bank>,
collector_id: &Pubkey,
slot: Slot
) -> Self
pub fn warp_from_parent( parent: &Arc<Bank>, collector_id: &Pubkey, slot: Slot ) -> Self
Like new_from_parent
but additionally:
- Doesn’t assume that the parent is anywhere near
slot
, parent could be millions of slots in the past - Adjusts the new bank’s tick height to avoid having to run PoH for millions of slots
- Freezes the new bank, assuming that the user will
Bank::new_from_parent
from this bank
pub fn collector_id(&self) -> &Pubkey
pub fn genesis_creation_time(&self) -> UnixTimestamp
pub fn slot(&self) -> Slot
pub fn bank_id(&self) -> BankId
pub fn epoch(&self) -> Epoch
pub fn first_normal_epoch(&self) -> Epoch
pub fn freeze_lock(&self) -> RwLockReadGuard<'_, Hash>
pub fn hash(&self) -> Hash
pub fn is_frozen(&self) -> bool
pub fn freeze_started(&self) -> bool
pub fn status_cache_ancestors(&self) -> Vec<u64> ⓘ
sourcepub fn unix_timestamp_from_genesis(&self) -> i64
pub fn unix_timestamp_from_genesis(&self) -> i64
computed unix_timestamp at this slot height
pub fn clock(&self) -> Clock
pub fn set_sysvar_for_tests<T>(&self, sysvar: &T)where T: Sysvar + SysvarId,
pub fn get_slot_history(&self) -> SlotHistory
pub fn epoch_duration_in_years(&self, prev_epoch: Epoch) -> f64
pub fn slot_in_year_for_inflation(&self) -> f64
pub fn update_recent_blockhashes(&self)
pub fn rehash(&self)
pub fn freeze(&self)
pub fn unfreeze_for_ledger_tool(&self)
pub fn epoch_schedule(&self) -> &EpochSchedule
sourcepub fn squash(&self) -> SquashTiming
pub fn squash(&self) -> SquashTiming
squash the parent’s state up into this Bank, this Bank becomes a root
sourcepub fn parent(&self) -> Option<Arc<Bank>>
pub fn parent(&self) -> Option<Arc<Bank>>
Return the more recent checkpoint of this bank instance.
pub fn parent_slot(&self) -> Slot
pub fn parent_hash(&self) -> Hash
sourcepub fn add_builtin_account(
&self,
name: &str,
program_id: &Pubkey,
must_replace: bool
)
pub fn add_builtin_account( &self, name: &str, program_id: &Pubkey, must_replace: bool )
Add a builtin program account
sourcepub fn add_precompiled_account(&self, program_id: &Pubkey)
pub fn add_precompiled_account(&self, program_id: &Pubkey)
Add a precompiled program account
pub fn set_rent_burn_percentage(&mut self, burn_percent: u8)
pub fn set_hashes_per_tick(&mut self, hashes_per_tick: Option<u64>)
sourcepub fn last_blockhash(&self) -> Hash
pub fn last_blockhash(&self) -> Hash
Return the last block hash registered.
pub fn last_blockhash_and_lamports_per_signature(&self) -> (Hash, u64)
pub fn is_blockhash_valid(&self, hash: &Hash) -> bool
pub fn get_minimum_balance_for_rent_exemption(&self, data_len: usize) -> u64
pub fn get_lamports_per_signature(&self) -> u64
pub fn get_lamports_per_signature_for_blockhash( &self, hash: &Hash ) -> Option<u64>
pub fn get_fee_rate_governor(&self) -> &FeeRateGovernor
get_fee_for_message
insteadpub fn get_fee_for_message(&self, message: &SanitizedMessage) -> Option<u64>
pub fn get_startup_verification_complete(&self) -> &Arc<AtomicBool>
pub fn is_startup_verification_complete(&self) -> bool
sourcepub fn set_startup_verification_complete(&self)
pub fn set_startup_verification_complete(&self)
This can occur because it completed in the background or if the verification was run in the foreground.
pub fn get_fee_for_message_with_lamports_per_signature( &self, message: &SanitizedMessage, lamports_per_signature: u64 ) -> u64
pub fn get_blockhash_last_valid_slot(&self, blockhash: &Hash) -> Option<Slot>
get_blockhash_last_valid_block_height
pub fn get_blockhash_last_valid_block_height( &self, blockhash: &Hash ) -> Option<Slot>
pub fn confirmed_last_blockhash(&self) -> Hash
sourcepub fn clear_signatures(&self)
pub fn clear_signatures(&self)
Forget all signatures. Useful for benchmarking.
pub fn clear_slot_signatures(&self, slot: Slot)
sourcepub fn register_recent_blockhash(&self, blockhash: &Hash)
pub fn register_recent_blockhash(&self, blockhash: &Hash)
Register a new recent blockhash in the bank’s recent blockhash queue. Called when a bank reaches its max tick height. Can be called by tests to get new blockhashes for transaction processing without advancing to a new bank slot.
sourcepub fn register_tick(&self, hash: &Hash)
pub fn register_tick(&self, hash: &Hash)
Tell the bank which Entry IDs exist on the ledger. This function assumes subsequent calls
correspond to later entries, and will boot the oldest ones once its internal cache is full.
Once boot, the bank will reject transactions using that hash
.
This is NOT thread safe because if tick height is updated by two different threads, the block boundary condition could be missed.
pub fn is_complete(&self) -> bool
pub fn is_block_boundary(&self, tick_height: u64) -> bool
sourcepub fn get_transaction_account_lock_limit(&self) -> usize
pub fn get_transaction_account_lock_limit(&self) -> usize
Get the max number of accounts that a transaction may lock in this block
sourcepub fn prepare_batch_for_tests(
&self,
txs: Vec<Transaction>
) -> TransactionBatch<'_, '_>
pub fn prepare_batch_for_tests( &self, txs: Vec<Transaction> ) -> TransactionBatch<'_, '_>
Prepare a transaction batch from a list of legacy transactions. Used for tests only.
sourcepub fn prepare_entry_batch(
&self,
txs: Vec<VersionedTransaction>
) -> Result<TransactionBatch<'_, '_>>
pub fn prepare_entry_batch( &self, txs: Vec<VersionedTransaction> ) -> Result<TransactionBatch<'_, '_>>
Prepare a transaction batch from a list of versioned transactions from an entry. Used for tests only.
sourcepub fn prepare_sanitized_batch<'a, 'b>(
&'a self,
txs: &'b [SanitizedTransaction]
) -> TransactionBatch<'a, 'b>
pub fn prepare_sanitized_batch<'a, 'b>( &'a self, txs: &'b [SanitizedTransaction] ) -> TransactionBatch<'a, 'b>
Prepare a locked transaction batch from a list of sanitized transactions.
sourcepub fn prepare_sanitized_batch_with_results<'a, 'b>(
&'a self,
transactions: &'b [SanitizedTransaction],
transaction_results: impl Iterator<Item = &'b Result<()>>
) -> TransactionBatch<'a, 'b>
pub fn prepare_sanitized_batch_with_results<'a, 'b>( &'a self, transactions: &'b [SanitizedTransaction], transaction_results: impl Iterator<Item = &'b Result<()>> ) -> TransactionBatch<'a, 'b>
Prepare a locked transaction batch from a list of sanitized transactions, and their cost limited packing status
sourcepub fn simulate_transaction(
&self,
transaction: SanitizedTransaction
) -> TransactionSimulationResult
pub fn simulate_transaction( &self, transaction: SanitizedTransaction ) -> TransactionSimulationResult
Run transactions against a frozen bank without committing the results
sourcepub fn simulate_transaction_unchecked(
&self,
transaction: SanitizedTransaction
) -> TransactionSimulationResult
pub fn simulate_transaction_unchecked( &self, transaction: SanitizedTransaction ) -> TransactionSimulationResult
Run transactions against a bank without committing the results; does not check if the bank is frozen, enabling use in single-Bank test frameworks
pub fn unlock_accounts(&self, batch: &mut TransactionBatch<'_, '_>)
pub fn remove_unrooted_slots(&self, slots: &[(Slot, BankId)])
pub fn set_shrink_paths(&self, paths: Vec<PathBuf>)
pub fn get_hash_age(&self, hash: &Hash) -> Option<u64>
pub fn is_hash_valid_for_age(&self, hash: &Hash, max_age: usize) -> bool
pub fn check_transactions( &self, sanitized_txs: &[SanitizedTransaction], lock_results: &[Result<()>], max_age: usize, error_counters: &mut TransactionErrorMetrics ) -> Vec<TransactionCheckResult> ⓘ
pub fn collect_balances( &self, batch: &TransactionBatch<'_, '_> ) -> TransactionBalances
pub fn clear_executors(&self)
pub fn load_and_execute_transactions( &self, batch: &TransactionBatch<'_, '_>, max_age: usize, enable_cpi_recording: bool, enable_log_recording: bool, enable_return_data_recording: bool, timings: &mut ExecuteTimings, account_overrides: Option<&AccountOverrides>, log_messages_bytes_limit: Option<usize> ) -> LoadAndExecuteTransactionsOutput
sourcepub fn accounts_data_size_limit(&self) -> u64
pub fn accounts_data_size_limit(&self) -> u64
The maximum allowed size, in bytes, of the accounts data
sourcepub fn load_accounts_data_size(&self) -> u64
pub fn load_accounts_data_size(&self) -> u64
Load the accounts data size, in bytes
sourcepub fn load_accounts_data_size_delta(&self) -> i64
pub fn load_accounts_data_size_delta(&self) -> i64
Load the change in accounts data size in this Bank, in bytes
sourcepub fn load_accounts_data_size_delta_on_chain(&self) -> i64
pub fn load_accounts_data_size_delta_on_chain(&self) -> i64
Load the change in accounts data size in this Bank, in bytes, from on-chain events i.e. transactions
sourcepub fn load_accounts_data_size_delta_off_chain(&self) -> i64
pub fn load_accounts_data_size_delta_off_chain(&self) -> i64
Load the change in accounts data size in this Bank, in bytes, from off-chain events i.e. rent collection
sourcepub fn set_accounts_data_size_initial_for_tests(&mut self, amount: u64)
pub fn set_accounts_data_size_initial_for_tests(&mut self, amount: u64)
Set the initial accounts data size NOTE: This fn is ONLY FOR TESTS
sourcepub fn update_accounts_data_size_delta_off_chain_for_tests(&self, amount: i64)
pub fn update_accounts_data_size_delta_off_chain_for_tests(&self, amount: i64)
Update the accounts data size off-chain delta NOTE: This fn is ONLY FOR TESTS
sourcepub fn calculate_fee(
message: &SanitizedMessage,
lamports_per_signature: u64,
fee_structure: &FeeStructure,
support_set_compute_unit_price_ix: bool,
use_default_units_per_instruction: bool,
enable_request_heap_frame_ix: bool
) -> u64
pub fn calculate_fee( message: &SanitizedMessage, lamports_per_signature: u64, fee_structure: &FeeStructure, support_set_compute_unit_price_ix: bool, use_default_units_per_instruction: bool, enable_request_heap_frame_ix: bool ) -> u64
Calculate fee for SanitizedMessage
sourcepub fn commit_transactions(
&self,
sanitized_txs: &[SanitizedTransaction],
loaded_txs: &mut [TransactionLoadResult],
execution_results: Vec<TransactionExecutionResult>,
last_blockhash: Hash,
lamports_per_signature: u64,
counts: CommitTransactionCounts,
timings: &mut ExecuteTimings
) -> TransactionResults
pub fn commit_transactions( &self, sanitized_txs: &[SanitizedTransaction], loaded_txs: &mut [TransactionLoadResult], execution_results: Vec<TransactionExecutionResult>, last_blockhash: Hash, lamports_per_signature: u64, counts: CommitTransactionCounts, timings: &mut ExecuteTimings ) -> TransactionResults
committed_transactions_count
is the number of transactions out of sanitized_txs
that was executed. Of those, committed_transactions_count
,
committed_with_failure_result_count
is the number of executed transactions that returned
a failure result.
sourcepub fn prepare_rewrites_for_hash(&self)
pub fn prepare_rewrites_for_hash(&self)
after deserialize, populate rewrites with accounts that would normally have had their data rewritten in this slot due to rent collection (but didn’t)
sourcepub fn partition_from_pubkey(
pubkey: &Pubkey,
partition_count: PartitionsPerCycle
) -> u64
pub fn partition_from_pubkey( pubkey: &Pubkey, partition_count: PartitionsPerCycle ) -> u64
This is the inverse of pubkey_range_from_partition. return the lowest end_index which would contain this pubkey
pub fn pubkey_range_from_partition( (start_index, end_index, partition_count): (u64, u64, PartitionsPerCycle) ) -> RangeInclusive<Pubkey>
pub fn get_partitions( slot: Slot, parent_slot: Slot, slot_count_in_two_day: SlotCount ) -> Vec<(u64, u64, PartitionsPerCycle)> ⓘ
sourcepub fn variable_cycle_partition_from_previous_slot(
epoch_schedule: &EpochSchedule,
slot: Slot
) -> (u64, u64, PartitionsPerCycle)
pub fn variable_cycle_partition_from_previous_slot( epoch_schedule: &EpochSchedule, slot: Slot ) -> (u64, u64, PartitionsPerCycle)
used only by filler accounts in debug path previous means slot - 1, not parent
pub fn slot_count_in_two_day_helper(ticks_per_slot: SlotCount) -> SlotCount
pub fn cluster_type(&self) -> ClusterType
sourcepub fn load_execute_and_commit_transactions(
&self,
batch: &TransactionBatch<'_, '_>,
max_age: usize,
collect_balances: bool,
enable_cpi_recording: bool,
enable_log_recording: bool,
enable_return_data_recording: bool,
timings: &mut ExecuteTimings,
log_messages_bytes_limit: Option<usize>
) -> (TransactionResults, TransactionBalancesSet)
pub fn load_execute_and_commit_transactions( &self, batch: &TransactionBatch<'_, '_>, max_age: usize, collect_balances: bool, enable_cpi_recording: bool, enable_log_recording: bool, enable_return_data_recording: bool, timings: &mut ExecuteTimings, log_messages_bytes_limit: Option<usize> ) -> (TransactionResults, TransactionBalancesSet)
Process a batch of transactions.
sourcepub fn process_transaction(&self, tx: &Transaction) -> Result<()>
pub fn process_transaction(&self, tx: &Transaction) -> Result<()>
Process a Transaction. This is used for unit tests and simply calls the vector Bank::process_transactions method.
sourcepub fn process_transaction_with_logs(&self, tx: &Transaction) -> Result<()>
pub fn process_transaction_with_logs(&self, tx: &Transaction) -> Result<()>
Process a Transaction and store program log data. This is used for unit tests, and simply
replicates the vector Bank::process_transactions method with enable_cpi_recording: true
sourcepub fn process_transactions<'a>(
&self,
txs: impl Iterator<Item = &'a Transaction>
) -> Vec<Result<()>> ⓘ
pub fn process_transactions<'a>( &self, txs: impl Iterator<Item = &'a Transaction> ) -> Vec<Result<()>> ⓘ
Process multiple transaction in a single batch. This is used for benches and unit tests.
Panics
Panics if any of the transactions do not pass sanitization checks.
sourcepub fn try_process_transactions<'a>(
&self,
txs: impl Iterator<Item = &'a Transaction>
) -> Result<Vec<Result<()>>>
pub fn try_process_transactions<'a>( &self, txs: impl Iterator<Item = &'a Transaction> ) -> Result<Vec<Result<()>>>
Process multiple transaction in a single batch. This is used for benches and unit tests. Short circuits if any of the transactions do not pass sanitization checks.
sourcepub fn process_entry_transactions(
&self,
txs: Vec<VersionedTransaction>
) -> Vec<Result<()>> ⓘ
pub fn process_entry_transactions( &self, txs: Vec<VersionedTransaction> ) -> Vec<Result<()>> ⓘ
Process entry transactions in a single batch. This is used for benches and unit tests.
Panics
Panics if any of the transactions do not pass sanitization checks.
sourcepub fn try_process_entry_transactions(
&self,
txs: Vec<VersionedTransaction>
) -> Result<Vec<Result<()>>>
pub fn try_process_entry_transactions( &self, txs: Vec<VersionedTransaction> ) -> Result<Vec<Result<()>>>
Process multiple transaction in a single batch. This is used for benches and unit tests. Short circuits if any of the transactions do not pass sanitization checks.
sourcepub fn transfer(&self, n: u64, keypair: &Keypair, to: &Pubkey) -> Result<Signature>
pub fn transfer(&self, n: u64, keypair: &Keypair, to: &Pubkey) -> Result<Signature>
Create, sign, and process a Transaction from keypair
to to
of
n
lamports where blockhash
is the last Entry ID observed by the client.
pub fn read_balance(account: &AccountSharedData) -> u64
sourcepub fn get_balance(&self, pubkey: &Pubkey) -> u64
pub fn get_balance(&self, pubkey: &Pubkey) -> u64
Each program would need to be able to introspect its own state this is hard-coded to the Budget language
sourcepub fn parents_inclusive(self: Arc<Self>) -> Vec<Arc<Bank>> ⓘ
pub fn parents_inclusive(self: Arc<Self>) -> Vec<Arc<Bank>> ⓘ
Compute all the parents of the bank including this bank itself
pub fn store_account<T: ReadableAccount + Sync + ZeroLamport>( &self, pubkey: &Pubkey, account: &T )
pub fn store_accounts<'a, T: ReadableAccount + Sync + ZeroLamport>( &self, accounts: impl StorableAccounts<'a, T> )
pub fn force_flush_accounts_cache(&self)
pub fn flush_accounts_cache_if_needed(&self)
pub fn expire_old_recycle_stores(&self)
pub fn deposit( &self, pubkey: &Pubkey, lamports: u64 ) -> Result<u64, LamportsError>
pub fn accounts(&self) -> Arc<Accounts>
pub fn set_inflation(&self, inflation: Inflation)
pub fn set_compute_budget(&mut self, compute_budget: Option<ComputeBudget>)
pub fn hard_forks(&self) -> Arc<RwLock<HardForks>>
pub fn get_account(&self, pubkey: &Pubkey) -> Option<AccountSharedData>
pub fn get_account_with_fixed_root( &self, pubkey: &Pubkey ) -> Option<AccountSharedData>
pub fn get_account_modified_slot( &self, pubkey: &Pubkey ) -> Option<(AccountSharedData, Slot)>
pub fn get_program_accounts( &self, program_id: &Pubkey, config: &ScanConfig ) -> ScanResult<Vec<TransactionAccount>>
pub fn get_filtered_program_accounts<F: Fn(&AccountSharedData) -> bool>( &self, program_id: &Pubkey, filter: F, config: &ScanConfig ) -> ScanResult<Vec<TransactionAccount>>
pub fn get_filtered_indexed_accounts<F: Fn(&AccountSharedData) -> bool>( &self, index_key: &IndexKey, filter: F, config: &ScanConfig, byte_limit_for_scan: Option<usize> ) -> ScanResult<Vec<TransactionAccount>>
pub fn account_indexes_include_key(&self, key: &Pubkey) -> bool
pub fn get_all_accounts_with_modified_slots( &self ) -> ScanResult<Vec<PubkeyAccountSlot>>
pub fn get_program_accounts_modified_since_parent( &self, program_id: &Pubkey ) -> Vec<TransactionAccount> ⓘ
pub fn get_transaction_logs( &self, address: Option<&Pubkey> ) -> Option<Vec<TransactionLogInfo>>
pub fn get_all_accounts_modified_since_parent(&self) -> Vec<TransactionAccount> ⓘ
pub fn get_largest_accounts( &self, num: usize, filter_by_address: &HashSet<Pubkey>, filter: AccountAddressFilter ) -> ScanResult<Vec<(Pubkey, u64)>>
pub fn transaction_count(&self) -> u64
pub fn transaction_error_count(&self) -> u64
pub fn transaction_entries_count(&self) -> u64
pub fn transactions_per_entry_max(&self) -> u64
pub fn signature_count(&self) -> u64
pub fn get_signature_status_processed_since_parent( &self, signature: &Signature ) -> Option<Result<()>>
pub fn get_signature_status_with_blockhash( &self, signature: &Signature, blockhash: &Hash ) -> Option<Result<()>>
pub fn get_signature_status_slot( &self, signature: &Signature ) -> Option<(Slot, Result<()>)>
pub fn get_signature_status(&self, signature: &Signature) -> Option<Result<()>>
pub fn has_signature(&self, signature: &Signature) -> bool
sourcepub fn verify_bank_hash(&self, config: VerifyBankHash) -> bool
pub fn verify_bank_hash(&self, config: VerifyBankHash) -> bool
Recalculate the hash_internal_state from the account stores. Would be used to verify a snapshot. return true if all is good Only called from startup or test code.
sourcepub fn set_initial_accounts_hash_verification_completed(&self)
pub fn set_initial_accounts_hash_verification_completed(&self)
Specify that initial verification has completed. Called internally when verification runs in the foreground thread. Also has to be called by some tests which don’t do verification on startup.
sourcepub fn has_initial_accounts_hash_verification_completed(&self) -> bool
pub fn has_initial_accounts_hash_verification_completed(&self) -> bool
return true if bg hash verification is complete return false if bg hash verification has not completed yet if hash verification failed, a panic will occur
pub fn get_snapshot_storages(&self, base_slot: Option<Slot>) -> SnapshotStorages
pub fn verify_transaction( &self, tx: VersionedTransaction, verification_mode: TransactionVerificationMode ) -> Result<SanitizedTransaction>
sourcepub fn calculate_and_verify_capitalization(&self, debug_verify: bool) -> bool
pub fn calculate_and_verify_capitalization(&self, debug_verify: bool) -> bool
only called at startup vs steady-state runtime
sourcepub fn set_capitalization(&self) -> u64
pub fn set_capitalization(&self) -> u64
Forcibly overwrites current capitalization by actually recalculating accounts’ balances. This should only be used for developing purposes.
pub fn get_accounts_hash(&self) -> Hash
pub fn get_thread_pool(&self) -> &ThreadPool
pub fn load_account_into_read_cache(&self, key: &Pubkey)
pub fn update_accounts_hash_with_index_option( &self, use_index: bool, debug_verify: bool, is_startup: bool ) -> Hash
pub fn update_accounts_hash(&self) -> Hash
sourcepub fn verify_snapshot_bank(
&self,
test_hash_calculation: bool,
accounts_db_skip_shrink: bool,
last_full_snapshot_slot: Option<Slot>
) -> bool
pub fn verify_snapshot_bank( &self, test_hash_calculation: bool, accounts_db_skip_shrink: bool, last_full_snapshot_slot: Option<Slot> ) -> bool
A snapshot bank should be purged of 0 lamport accounts which are not part of the hash calculation and could shield other real accounts.
sourcepub fn hashes_per_tick(&self) -> &Option<u64>
pub fn hashes_per_tick(&self) -> &Option<u64>
Return the number of hashes per tick
sourcepub fn ticks_per_slot(&self) -> u64
pub fn ticks_per_slot(&self) -> u64
Return the number of ticks per slot
sourcepub fn slots_per_year(&self) -> f64
pub fn slots_per_year(&self) -> f64
Return the number of slots per year
sourcepub fn tick_height(&self) -> u64
pub fn tick_height(&self) -> u64
Return the number of ticks since genesis.
pub fn rent_collector(&self) -> &RentCollector
sourcepub fn capitalization(&self) -> u64
pub fn capitalization(&self) -> u64
Return the total capitalization of the Bank
sourcepub fn max_tick_height(&self) -> u64
pub fn max_tick_height(&self) -> u64
Return this bank’s max_tick_height
sourcepub fn block_height(&self) -> u64
pub fn block_height(&self) -> u64
Return the block_height of this bank
sourcepub fn get_slots_in_epoch(&self, epoch: Epoch) -> u64
pub fn get_slots_in_epoch(&self, epoch: Epoch) -> u64
Return the number of slots per epoch for the given epoch
sourcepub fn get_leader_schedule_epoch(&self, slot: Slot) -> Epoch
pub fn get_leader_schedule_epoch(&self, slot: Slot) -> Epoch
returns the epoch for which this bank’s leader_schedule_slot_offset and slot would need to cache leader_schedule
pub fn staked_nodes(&self) -> Arc<HashMap<Pubkey, u64>>
sourcepub fn vote_accounts(&self) -> Arc<VoteAccountsHashMap>
pub fn vote_accounts(&self) -> Arc<VoteAccountsHashMap>
current vote accounts for this bank along with the stake attributed to each account
sourcepub fn get_vote_account(&self, vote_account: &Pubkey) -> Option<VoteAccount>
pub fn get_vote_account(&self, vote_account: &Pubkey) -> Option<VoteAccount>
Vote account for the given vote account pubkey.
sourcepub fn epoch_stakes(&self, epoch: Epoch) -> Option<&EpochStakes>
pub fn epoch_stakes(&self, epoch: Epoch) -> Option<&EpochStakes>
Get the EpochStakes for a given epoch
pub fn epoch_stakes_map(&self) -> &HashMap<Epoch, EpochStakes>
pub fn epoch_staked_nodes( &self, epoch: Epoch ) -> Option<Arc<HashMap<Pubkey, u64>>>
sourcepub fn epoch_vote_accounts(&self, epoch: Epoch) -> Option<&VoteAccountsHashMap>
pub fn epoch_vote_accounts(&self, epoch: Epoch) -> Option<&VoteAccountsHashMap>
vote accounts for the specific epoch along with the stake attributed to each account
Get the fixed authorized voter for the given vote account for the current epoch
sourcepub fn epoch_vote_accounts_for_node_id(
&self,
node_id: &Pubkey
) -> Option<&NodeVoteAccounts>
pub fn epoch_vote_accounts_for_node_id( &self, node_id: &Pubkey ) -> Option<&NodeVoteAccounts>
Get the fixed set of vote accounts for the given node id for the current epoch
sourcepub fn total_epoch_stake(&self) -> u64
pub fn total_epoch_stake(&self) -> u64
Get the fixed total stake of all vote accounts for current epoch
sourcepub fn epoch_vote_account_stake(&self, vote_account: &Pubkey) -> u64
pub fn epoch_vote_account_stake(&self, vote_account: &Pubkey) -> u64
Get the fixed stake of the given vote account for the current epoch
sourcepub fn get_epoch_and_slot_index(&self, slot: Slot) -> (Epoch, SlotIndex)
pub fn get_epoch_and_slot_index(&self, slot: Slot) -> (Epoch, SlotIndex)
given a slot, return the epoch and offset into the epoch this slot falls e.g. with a fixed number for slots_per_epoch, the calculation is simply:
( slot/slots_per_epoch, slot % slots_per_epoch )
pub fn get_epoch_info(&self) -> EpochInfo
pub fn is_empty(&self) -> bool
sourcepub fn add_builtin(
&mut self,
name: &str,
program_id: &Pubkey,
process_instruction: ProcessInstructionWithContext
)
pub fn add_builtin( &mut self, name: &str, program_id: &Pubkey, process_instruction: ProcessInstructionWithContext )
Add an instruction processor to intercept instructions before the dynamic loader.
sourcepub fn remove_builtin(&mut self, program_id: &Pubkey)
pub fn remove_builtin(&mut self, program_id: &Pubkey)
Remove a builtin instruction processor if it already exists
pub fn add_precompile(&mut self, program_id: &Pubkey)
pub fn clean_accounts( &self, skip_last: bool, is_startup: bool, last_full_snapshot_slot: Option<Slot> )
pub fn shrink_all_slots( &self, is_startup: bool, last_full_snapshot_slot: Option<Slot> )
pub fn print_accounts_stats(&self)
pub fn process_stale_slot_with_budget( &self, consumed_budget: usize, budget_recovery_delta: usize ) -> usize
pub fn bank_tranaction_count_fix_enabled(&self) -> bool
pub fn shrink_candidate_slots(&self) -> usize
pub fn no_overflow_rent_distribution_enabled(&self) -> bool
pub fn versioned_tx_message_enabled(&self) -> bool
pub fn credits_auto_rewind(&self) -> bool
pub fn send_to_tpu_vote_port_enabled(&self) -> bool
pub fn concurrent_replay_of_forks(&self) -> bool
pub fn read_cost_tracker(&self) -> LockResult<RwLockReadGuard<'_, CostTracker>>
pub fn write_cost_tracker( &self ) -> LockResult<RwLockWriteGuard<'_, CostTracker>>
pub fn should_bank_still_be_processing_txs( bank_creation_time: &Instant, max_tx_ingestion_nanos: u128 ) -> bool
pub fn deactivate_feature(&mut self, id: &Pubkey)
pub fn activate_feature(&mut self, id: &Pubkey)
pub fn fill_bank_with_ticks_for_tests(&self)
sourcepub fn get_total_accounts_stats(&self) -> ScanResult<TotalAccountsStats>
pub fn get_total_accounts_stats(&self) -> ScanResult<TotalAccountsStats>
Get all the accounts for this bank and calculate stats
sourcepub fn calculate_total_accounts_stats<'a>(
&self,
accounts: impl Iterator<Item = (&'a Pubkey, &'a AccountSharedData)>
) -> TotalAccountsStats
pub fn calculate_total_accounts_stats<'a>( &self, accounts: impl Iterator<Item = (&'a Pubkey, &'a AccountSharedData)> ) -> TotalAccountsStats
Given all the accounts for a bank, calculate stats