Struct AccountSharedData 

pub struct AccountSharedData { /* private fields */ }

Shared account data that borrows directly from an aligned external buffer until a write requires promotion to owned heap storage.

Higher layers use mutable() to enforce transaction write permissions.

Implementations

impl AccountSharedData

pub fn cow(&self) -> &CoWAccount

Returns a reference to the inner copy-on-write representation.

pub fn cow_mut(&mut self) -> &mut CoWAccount

Returns mutable access to the inner copy-on-write representation.

pub fn slot(&self) -> Slot

Returns the account’s on-chain slot.

pub fn translate(&mut self)

Copies a clean borrowed image into the shadow buffer before mutation.

pub fn owned(&self) -> OwnedAccount

Returns an owned copy of the current account state.

pub fn mutable(&self) -> bool

Returns whether the current transaction may leave the account modified.

Mutable modes are always accepted. Transient and Closed are accepted only when this transaction performed the corresponding mode transition. This is a transaction-final writeback predicate, not permission for a new program mutation; instruction checks must use AccountMode::mutable.

pub fn mode(&self) -> AccountMode

Returns the account’s exact lifecycle mode.

pub fn is(&self, mode: AccountMode) -> bool

Returns true when the account is in mode.

pub fn flags(&self) -> &StateFlags

Returns the account modifier flags.

pub fn markers(&self) -> &DirtyMarkers

Returns the dirty-field markers.

pub fn is_shared(&self) -> bool

Returns true when the owned buffer has more than one strong reference.

pub fn dirty(&self) -> bool

Returns true if any field has been modified.

pub fn capacity(&self) -> usize

Returns the current data capacity.

pub fn data_clone(&self) -> Arc<Vec<u8>>

Returns a shared owned copy of the current data bytes.

pub fn resize(&mut self, len: usize, val: u8)

Resizes the account data.

pub fn extend_from_slice(&mut self, data: &[u8])

Appends bytes to the account data.

pub fn set_data_from_slice(&mut self, data: &[u8])

Replaces the account data with the provided bytes.

pub fn set_lifecycle( &mut self, mode: AccountMode, slot: Slot, ) -> Result<(), AccountPatchError>

Applies mode and slot as one validated lifecycle transition.

Mode pairs determine whether slots may stay equal or must advance. Authoritative modes cannot be reapplied, even at a newer slot. Validation precedes translation, so an error leaves account state and dirty markers unchanged.

pub fn set_flags(&mut self, flags: StateFlags)

Replaces all state flags and marks them dirty when the value changes.

pub fn new(lamports: u64, space: usize, owner: &Pubkey) -> Self

Creates a new owned shared-data account with zero-filled data.

pub fn new_ref(lamports: u64, space: usize, owner: &Pubkey) -> Rc<RefCell<Self>>

Creates a new shared-data account wrapped in a RefCell.

pub fn new_rent_epoch( lamports: u64, space: usize, owner: &Pubkey, _: Epoch, ) -> Self

Creates a new shared-data account.

rent_epoch is ignored because this type does not store it.

pub fn create_from_existing_shared_data( lamports: u64, data: Arc<Vec<u8>>, owner: Pubkey, executable: bool, _: Epoch, ) -> Self

Creates an owned shared-data account from existing shared bytes.

rent_epoch is ignored because this type does not store it.

Trait Implementations

impl Clone for AccountSharedData

fn clone(&self) -> AccountSharedData

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AccountSharedData

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AccountSharedData

fn default() -> AccountSharedData

Returns the “default value” for a type.

impl Deref for AccountSharedData

type Target = AccountCore

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for AccountSharedData

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Eq for AccountSharedData

impl From<Account> for AccountSharedData

Converts a plain Account into shared data.

fn from(value: Account) -> Self

Converts to this type from the input type.

impl From<AccountSharedData> for Account

fn from(other: AccountSharedData) -> Self

Converts to this type from the input type.

impl From<AccountSharedData> for AccountBuilder

fn from(value: AccountSharedData) -> Self

Converts to this type from the input type.

impl From<BorrowedAccount> for AccountSharedData

Wraps a borrowed account in AccountSharedData.

fn from(value: BorrowedAccount) -> Self

Converts to this type from the input type.

impl From<OwnedAccount> for AccountSharedData

Wraps an owned account in AccountSharedData.

fn from(value: OwnedAccount) -> Self

Converts to this type from the input type.

impl PartialEq for AccountSharedData

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<OwnedAccount> for AccountSharedData

fn eq(&self, other: &OwnedAccount) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl ReadableAccount for AccountSharedData

fn lamports(&self) -> u64

Returns the lamport balance.

fn data(&self) -> &[u8]

Returns the account data.

fn owner(&self) -> &Pubkey

Returns the account owner.

fn executable(&self) -> bool

Returns whether the account is executable.

fn rent_epoch(&self) -> Epoch

Returns the rent epoch view for this account.

impl Sync for AccountSharedData

We only access AccountSharedData via transaction lock in the execution layer or with a SeqLock semantics outside of execution

impl WritableAccount for AccountSharedData

fn set_lamports(&mut self, lamports: u64)

Replaces the lamport balance.

fn data_as_mut_slice(&mut self) -> &mut [u8]

Returns mutable access to the account data.

fn set_owner(&mut self, owner: Pubkey)

Replaces the owner.

fn copy_into_owner_from_slice(&mut self, source: &[u8])

Copies 32 raw bytes into the owner pubkey.

fn set_executable(&mut self, executable: bool)

Sets the executable flag.

fn set_rent_epoch(&mut self, _: Epoch)

Sets the rent epoch view if the implementation stores one.

fn checked_add_lamports(&mut self, lamports: u64) -> Result<(), LamportsError>

Adds lamports or returns an overflow error.

fn checked_sub_lamports(&mut self, lamports: u64) -> Result<(), LamportsError>

Subtracts lamports or returns an underflow error.

fn saturating_add_lamports(&mut self, lamports: u64)

Adds lamports and saturates on overflow.

fn saturating_sub_lamports(&mut self, lamports: u64)

Subtracts lamports and saturates on underflow.