magicblock-account 4.3.1

Solana Account type
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

#![allow(clippy::expect_used)]

use {
    crate::{
        AccountBuilder, AccountMode, AccountSharedData, BorrowedAccount, OwnedAccount,
        ReadableAccount, StorageUnit,
    },
    solana_pubkey::Pubkey,
    std::ptr::NonNull,
};

/// Starts a user-mutable test account with explicit balance, data, and owner.
///
/// The mode is delegated; all other fields retain builder defaults. Callers can
/// customize the returned builder and build either owned or shared account data.
pub fn delegated_account(lamports: u64, data: Vec<u8>, owner: Pubkey) -> AccountBuilder {
    AccountBuilder::default()
        .lamports(lamports)
        .data(data)
        .owner(owner)
        .mode(AccountMode::Delegated)
}

/// Builds a borrowed account image backed by serialized owned state.
pub fn borrowed_account_buffer(data: Vec<u8>, owner: Pubkey) -> Vec<StorageUnit> {
    let pubkey = Pubkey::new_unique();
    let owned = AccountBuilder::default()
        .lamports(1)
        .data(data)
        .owner(owner)
        .build::<OwnedAccount>();
    serialize_account_buffer(&owned, &pubkey)
}

/// Serializes an owned account into the borrowed layout used by tests.
pub fn serialize_account_buffer(owned: &OwnedAccount, pubkey: &Pubkey) -> Vec<StorageUnit> {
    let mut buf = vec![Default::default(); owned.units() as usize];
    // SAFETY: `buf` is sized from `units` and allocated with the alignment
    // required by the borrowed account layout.
    unsafe { owned.serialize(&mut buf, pubkey) };
    buf
}

/// Builds a borrowed account view over a test buffer.
pub fn init_borrowed_account(buf: &mut [StorageUnit]) -> BorrowedAccount {
    let ptr = NonNull::from(&mut buf[..]).cast();
    // SAFETY: test buffers are created with the borrowed account layout.
    unsafe { BorrowedAccount::init(ptr) }
}

/// Wraps a borrowed account test buffer in `AccountSharedData`.
pub fn borrowed_shared_data(buf: &mut [StorageUnit]) -> AccountSharedData {
    AccountSharedData::from(init_borrowed_account(buf))
}

/// Reinitializes a borrowed test buffer and returns its active data image.
pub fn active_borrowed_data(buf: &mut [StorageUnit]) -> Vec<u8> {
    borrowed_shared_data(buf).data().to_vec()
}