metaboss 0.49.0

The Metaplex NFT-standard Swiss Army Knife tool.
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

mod common;

use anyhow::Result;
use solana_sdk::signature::Keypair;
use solana_sdk::signer::Signer;

use common::{assert_success, decode_onchain_metadata, mint_test_nft, TestContext};

// ---------------------------------------------------------------------------
// Test 1: Mint an NFT and set it as immutable
// ---------------------------------------------------------------------------
#[test]
#[ignore = "requires solana-test-validator (run with --ignored)"]
fn test_set_immutable() -> Result<()> {
    let mut ctx = TestContext::new()?;
    let temp_dir = ctx.create_temp_dir("set-immutable");
    let mint = mint_test_nft(&ctx, &temp_dir)?;

    // Verify is_mutable is true initially.
    let metadata = decode_onchain_metadata(&ctx, &mint)?;
    assert!(
        metadata.is_mutable,
        "NFT should be mutable immediately after minting"
    );

    // Set the NFT as immutable.
    let output = ctx.run_metaboss(&["set", "immutable", "-k", &ctx.keypair_path, "-a", &mint]);
    assert_success(&output);

    // Verify is_mutable is now false.
    let metadata = decode_onchain_metadata(&ctx, &mint)?;
    assert!(
        !metadata.is_mutable,
        "NFT should be immutable after set immutable"
    );

    Ok(())
}

// ---------------------------------------------------------------------------
// Test 2: Mint an NFT and set primary_sale_happened
// ---------------------------------------------------------------------------
#[test]
#[ignore = "requires solana-test-validator (run with --ignored)"]
fn test_set_secondary_sale() -> Result<()> {
    let mut ctx = TestContext::new()?;
    let temp_dir = ctx.create_temp_dir("set-secondary-sale");
    let mint = mint_test_nft(&ctx, &temp_dir)?;

    // Verify primary_sale_happened is false initially.
    let metadata = decode_onchain_metadata(&ctx, &mint)?;
    assert!(
        !metadata.primary_sale_happened,
        "primary_sale_happened should be false after minting"
    );

    // Set secondary sale (primary_sale_happened = true).
    let output = ctx.run_metaboss(&[
        "set",
        "secondary-sale",
        "-k",
        &ctx.keypair_path,
        "-a",
        &mint,
    ]);
    assert_success(&output);

    // Verify primary_sale_happened is now true.
    let metadata = decode_onchain_metadata(&ctx, &mint)?;
    assert!(
        metadata.primary_sale_happened,
        "primary_sale_happened should be true after set secondary-sale"
    );

    Ok(())
}

// ---------------------------------------------------------------------------
// Test 3: Mint an NFT and change its update authority
// ---------------------------------------------------------------------------
#[test]
#[ignore = "requires solana-test-validator (run with --ignored)"]
fn test_set_update_authority() -> Result<()> {
    let mut ctx = TestContext::new()?;
    let temp_dir = ctx.create_temp_dir("set-update-authority");
    let mint = mint_test_nft(&ctx, &temp_dir)?;

    // Verify initial update authority is the test keypair.
    let metadata = decode_onchain_metadata(&ctx, &mint)?;
    assert_eq!(
        metadata.update_authority,
        ctx.keypair.pubkey(),
        "update_authority should be the test keypair initially"
    );

    // Generate a new keypair to become the new update authority.
    let new_authority = Keypair::new();
    let new_authority_pubkey = new_authority.pubkey().to_string();

    // Set the new update authority.
    let output = ctx.run_metaboss(&[
        "set",
        "update-authority",
        "-k",
        &ctx.keypair_path,
        "-a",
        &mint,
        "--new-update-authority",
        &new_authority_pubkey,
    ]);
    assert_success(&output);

    // Verify update authority changed.
    let metadata = decode_onchain_metadata(&ctx, &mint)?;
    assert_eq!(
        metadata.update_authority,
        new_authority.pubkey(),
        "update_authority should be the new authority after set update-authority"
    );

    Ok(())
}

// ---------------------------------------------------------------------------
// Test 4: Set immutable prevents further updates
// ---------------------------------------------------------------------------
#[test]
#[ignore = "requires solana-test-validator (run with --ignored)"]
fn test_set_immutable_prevents_further_updates() -> Result<()> {
    let mut ctx = TestContext::new()?;
    let temp_dir = ctx.create_temp_dir("set-immutable-no-update");
    let mint = mint_test_nft(&ctx, &temp_dir)?;

    // Set the NFT as immutable.
    let output = ctx.run_metaboss(&["set", "immutable", "-k", &ctx.keypair_path, "-a", &mint]);
    assert_success(&output);

    // Try to update the name -- this should fail because the NFT is immutable.
    let output = ctx.run_metaboss(&[
        "update",
        "name",
        "-k",
        &ctx.keypair_path,
        "-a",
        &mint,
        "--new-name",
        "Should Fail",
    ]);
    assert!(
        !output.success,
        "Updating an immutable NFT should fail.\nstdout:\n{}\nstderr:\n{}",
        output.stdout, output.stderr,
    );

    Ok(())
}