solana-token-toolkit 0.1.0

Token account workflow primitives for Solana applications
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

//! Error types returned by the `solana-token-toolkit` public API.

use solana_pubkey::Pubkey;

/// All errors returned by `solana-token-toolkit` public API.
#[derive(thiserror::Error, Debug)]
#[non_exhaustive]
pub enum TokenError {
    /// An RPC call failed.
    #[error("RPC call failed: {0}")]
    Rpc(#[from] solana_client::client_error::ClientError),

    /// A requested mint account does not exist on chain.
    #[error("mint account not found: {0}")]
    MintNotFound(Pubkey),

    /// Failed to decode a mint account.
    #[error("mint account decode failed: {mint}: {reason}")]
    MintDecodeFailed {
        /// The mint pubkey whose account data could not be decoded.
        mint: Pubkey,
        /// Underlying decode error message.
        reason: String,
    },

    /// Failed to decode a token account (e.g. while reading wSOL balance).
    #[error("token account decode failed: {token_account}: {reason}")]
    TokenAccountDecodeFailed {
        /// The token account pubkey whose data could not be decoded.
        token_account: Pubkey,
        /// Underlying decode error message.
        reason: String,
    },

    /// `assemble_token_account_state` was called with mismatched slice lengths.
    #[error("mints/mint_accounts length mismatch: {mints} vs {mint_accounts}")]
    LengthMismatch {
        /// Length of the `mints` slice.
        mints: usize,
        /// Length of the `mint_accounts` slice.
        mint_accounts: usize,
    },

    /// `reject_transfer_hook_mints` found a hook on a mint.
    #[error("transfer hook detected on mint {mint} (program: {program})")]
    TransferHookDetected {
        /// The mint that has the transfer hook.
        mint: Pubkey,
        /// The hook program ID configured on the mint.
        program: Pubkey,
    },

    /// `MintIntent::WithBalance` was used with a non-SOL mint.
    #[error("WithBalance intent on non-SOL mint {0} is not supported")]
    WithBalanceNotSupported(Pubkey),

    /// `MintIntent::WithBalance` for native SOL was paired with
    /// `WrapSolStrategy::None`.
    #[error(
        "WithBalance intent for native SOL requires WrapSolStrategy::Ata or Keypair, not None"
    )]
    IncoherentWrapStrategy,

    /// An `spl-token-*` instruction builder returned an error.
    #[error("instruction build failed: {0}")]
    InstructionBuild(String),
}