use crate::hash::Hash; use crate::{clock::Epoch, pubkey::Pubkey}; use std::{cmp, fmt, iter::FromIterator}; /// An Account with data that is stored on chain #[repr(C)] #[derive(Serialize, Deserialize, Clone, Default)] pub struct Account { /// lamports in the account pub lamports: u64, /// data held in this account #[serde(with = "serde_bytes")] pub data: Vec, /// the program that owns this account. If executable, the program that loads this account. pub owner: Pubkey, /// this account's data contains a loaded program (and is now read-only) pub executable: bool, /// the epoch at which this account will next owe rent pub rent_epoch: Epoch, /// Hash of this account's state, skip serializing as to not expose to external api /// Used for keeping the accounts state hash updated. #[serde(skip)] pub hash: Hash, } /// skip comparison of account.hash, since it is only meaningful when the account is loaded in a /// given fork and some tests do not have that. impl PartialEq for Account { fn eq(&self, other: &Self) -> bool { self.lamports == other.lamports && self.data == other.data && self.owner == other.owner && self.executable == other.executable && self.rent_epoch == other.rent_epoch } } impl Eq for Account {} impl fmt::Debug for Account { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { let data_len = cmp::min(64, self.data.len()); let data_str = if data_len > 0 { format!(" data: {}", hex::encode(self.data[..data_len].to_vec())) } else { "".to_string() }; write!( f, "Account {{ lamports: {} data.len: {} owner: {} executable: {} rent_epoch: {}{} hash: {} }}", self.lamports, self.data.len(), self.owner, self.executable, self.rent_epoch, data_str, self.hash, ) } } impl Account { pub fn new(lamports: u64, space: usize, owner: &Pubkey) -> Account { Account { lamports, data: vec![0u8; space], owner: *owner, ..Account::default() } } pub fn new_data( lamports: u64, state: &T, owner: &Pubkey, ) -> Result { let data = bincode::serialize(state)?; Ok(Account { lamports, data, owner: *owner, ..Account::default() }) } pub fn new_data_with_space( lamports: u64, state: &T, space: usize, owner: &Pubkey, ) -> Result { let mut account = Self::new(lamports, space, owner); account.serialize_data(state)?; Ok(account) } pub fn deserialize_data(&self) -> Result { bincode::deserialize(&self.data) } pub fn serialize_data(&mut self, state: &T) -> Result<(), bincode::Error> { if bincode::serialized_size(state)? > self.data.len() as u64 { return Err(Box::new(bincode::ErrorKind::SizeLimit)); } bincode::serialize_into(&mut self.data[..], state) } } #[repr(C)] #[derive(Debug)] pub struct KeyedAccount<'a> { is_signer: bool, // Transaction was signed by this account's key is_writable: bool, key: &'a Pubkey, pub account: &'a mut Account, } impl<'a> KeyedAccount<'a> { pub fn signer_key(&self) -> Option<&Pubkey> { if self.is_signer { Some(self.key) } else { None } } pub fn unsigned_key(&self) -> &Pubkey { self.key } pub fn is_writable(&self) -> bool { self.is_writable } pub fn new(key: &'a Pubkey, is_signer: bool, account: &'a mut Account) -> KeyedAccount<'a> { KeyedAccount { is_signer, is_writable: true, key, account, } } pub fn new_readonly( key: &'a Pubkey, is_signer: bool, account: &'a mut Account, ) -> KeyedAccount<'a> { KeyedAccount { is_signer, is_writable: false, key, account, } } } impl<'a> From<(&'a Pubkey, &'a mut Account)> for KeyedAccount<'a> { fn from((key, account): (&'a Pubkey, &'a mut Account)) -> Self { KeyedAccount { is_signer: false, is_writable: true, key, account, } } } impl<'a> From<&'a mut (Pubkey, Account)> for KeyedAccount<'a> { fn from((key, account): &'a mut (Pubkey, Account)) -> Self { KeyedAccount { is_signer: false, is_writable: true, key, account, } } } pub fn create_keyed_accounts(accounts: &mut [(Pubkey, Account)]) -> Vec { accounts.iter_mut().map(Into::into).collect() } pub fn create_keyed_readonly_accounts(accounts: &mut [(Pubkey, Account)]) -> Vec { accounts .iter_mut() .map(|(key, account)| KeyedAccount { is_signer: false, is_writable: false, key, account, }) .collect() } /// Return all the signers from a set of KeyedAccounts pub fn get_signers(keyed_accounts: &[KeyedAccount]) -> A where A: FromIterator, { keyed_accounts .iter() .filter_map(|keyed_account| keyed_account.signer_key()) .cloned() .collect::() }