light-token 0.23.0

SDK for Light Tokens
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

//! Error types for light-token SDK.
//!
//! This module re-exports errors from light-compressed-token-sdk and defines
//! additional errors specific to high-level token operations.

// Re-export base errors from compressed-token-sdk
pub use light_compressed_token_sdk::error::{Result, TokenSdkError};
use solana_program_error::ProgramError;
use thiserror::Error;

/// Result type for light-token specific errors
pub type LightTokenResult<T> = std::result::Result<T, LightTokenError>;

/// Errors specific to high-level token operations in light-token.
/// Error codes start at 17500 to avoid conflicts with TokenSdkError (17001-17033).
#[derive(Debug, Error)]
pub enum LightTokenError {
    #[error("SPL interface required for this operation")]
    SplInterfaceRequired,
    #[error("Incomplete SPL interface configuration")]
    IncompleteSplInterface,
    #[error("Use regular SPL transfer for this operation")]
    UseRegularSplTransfer,
    #[error("Cannot determine account type")]
    CannotDetermineAccountType,
    #[error("Missing mint account")]
    MissingMintAccount,
    #[error("Missing SPL token program")]
    MissingSplTokenProgram,
    #[error("Missing SPL interface PDA")]
    MissingSplInterfacePda,
    #[error("Missing SPL interface PDA bump")]
    MissingSplInterfacePdaBump,
    #[error("SPL token program mismatch between source and destination")]
    SplTokenProgramMismatch,
    #[error("Invalid account data")]
    InvalidAccountData,
    #[error("Serialization error")]
    SerializationError,
    #[error("Missing CPI context account")]
    MissingCpiContext,
    #[error("Missing CPI authority account")]
    MissingCpiAuthority,
    #[error("Missing output queue account")]
    MissingOutputQueue,
    #[error("Missing state merkle tree account")]
    MissingStateMerkleTree,
    #[error("Missing address merkle tree account")]
    MissingAddressMerkleTree,
    #[error("Missing light system program")]
    MissingLightSystemProgram,
    #[error("Missing registered program PDA")]
    MissingRegisteredProgramPda,
    #[error("Missing account compression authority")]
    MissingAccountCompressionAuthority,
    #[error("Missing account compression program")]
    MissingAccountCompressionProgram,
    #[error("Missing system program")]
    MissingSystemProgram,
}

impl From<LightTokenError> for ProgramError {
    fn from(e: LightTokenError) -> Self {
        ProgramError::Custom(e.into())
    }
}

impl From<LightTokenError> for u32 {
    fn from(e: LightTokenError) -> Self {
        match e {
            LightTokenError::SplInterfaceRequired => 17500,
            LightTokenError::IncompleteSplInterface => 17501,
            LightTokenError::UseRegularSplTransfer => 17502,
            LightTokenError::CannotDetermineAccountType => 17503,
            LightTokenError::MissingMintAccount => 17504,
            LightTokenError::MissingSplTokenProgram => 17505,
            LightTokenError::MissingSplInterfacePda => 17506,
            LightTokenError::MissingSplInterfacePdaBump => 17507,
            LightTokenError::SplTokenProgramMismatch => 17508,
            LightTokenError::InvalidAccountData => 17509,
            LightTokenError::SerializationError => 17510,
            LightTokenError::MissingCpiContext => 17511,
            LightTokenError::MissingCpiAuthority => 17512,
            LightTokenError::MissingOutputQueue => 17513,
            LightTokenError::MissingStateMerkleTree => 17514,
            LightTokenError::MissingAddressMerkleTree => 17515,
            LightTokenError::MissingLightSystemProgram => 17516,
            LightTokenError::MissingRegisteredProgramPda => 17517,
            LightTokenError::MissingAccountCompressionAuthority => 17518,
            LightTokenError::MissingAccountCompressionProgram => 17519,
            LightTokenError::MissingSystemProgram => 17520,
        }
    }
}