mpl-bubblegum 3.0.0

Metaplex Bubblegum SDK
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
60
61
62
63
64
65
66
67
68
69

mod tree_manager;
pub use tree_manager::*;

use solana_program::pubkey::Pubkey;
use solana_program_test::{ProgramTest, ProgramTestContext};
use solana_sdk::account::Account;
use std::str::FromStr;

/// Asserts that a given error is a custom instruction error.
#[macro_export]
macro_rules! assert_custom_instruction_error {
    ($ix:expr, $error:expr, $matcher:pat) => {
        match $error {
            solana_program_test::BanksClientError::TransactionError(
                solana_sdk::transaction::TransactionError::InstructionError(
                    $ix,
                    solana_sdk::instruction::InstructionError::Custom(x),
                ),
            ) => match num_traits::FromPrimitive::from_i32(x as i32) {
                Some($matcher) => assert!(true),
                Some(other) => {
                    assert!(
                        false,
                        "Expected another custom instruction error than '{:#?}'",
                        other
                    )
                }
                None => assert!(false, "Expected custom instruction error"),
            },
            err => assert!(
                false,
                "Expected custom instruction error but got '{:#?}'",
                err
            ),
        };
    };
}

/// Setup a program test with the required programs.
pub fn create_program_test() -> ProgramTest {
    let mut program_test = ProgramTest::new("bubblegum", mpl_bubblegum::ID, None);
    // V1: SPL-based programs (hardcoded IDs to avoid pulling in SPL crate dependencies)
    let spl_account_compression_id =
        Pubkey::from_str("cmtDvXumGCrqC1Age74AVPhSRVXJMd8PJS91L8KbNCK").unwrap();
    let spl_noop_id = Pubkey::from_str("noopb9bkMVfRPU8AsbpTUg8AQkHtKwMYZiFUjNRtMmV").unwrap();
    program_test.add_program("spl_account_compression", spl_account_compression_id, None);
    program_test.add_program("spl_noop", spl_noop_id, None);

    // V2: MPL-based programs
    program_test.add_program("mpl_account_compression", mpl_account_compression::ID, None);
    program_test.add_program("mpl_noop", mpl_noop::ID, None);
    program_test.add_program("mpl_core_program", mpl_core::ID, None);
    program_test
}

/// Looks up the account for a given pubkey.
pub async fn find_account(context: &mut ProgramTestContext, pubkey: &Pubkey) -> Option<Account> {
    context.banks_client.get_account(*pubkey).await.unwrap()
}

/// Returns the `Account` for a given pubkey.
pub async fn get_account(context: &mut ProgramTestContext, pubkey: &Pubkey) -> Account {
    context
        .banks_client
        .get_account(*pubkey)
        .await
        .unwrap()
        .expect("account not found")
}