sss-token 1.0.2

Solana Stablecoin Standard - Token Program with blacklist, seize, freeze, and GENIUS Act compliance
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

use anchor_lang::prelude::*;

#[error_code]
pub enum SssError {
    // Access control
    #[msg("Unauthorized: caller does not have the required role")]
    Unauthorized,
    #[msg("Invalid authority for this operation")]
    InvalidAuthority,

    // Operational
    #[msg("Program is currently paused")]
    ProgramPaused,
    #[msg("Program is not paused")]
    ProgramNotPaused,

    // Minting
    #[msg("Minter is not active")]
    MinterNotActive,
    #[msg("Mint amount exceeds minter quota")]
    MintQuotaExceeded,
    #[msg("Mint amount must be greater than zero")]
    MintAmountZero,

    // Burn
    #[msg("Burn amount must be greater than zero")]
    BurnAmountZero,
    #[msg("Insufficient balance for burn")]
    InsufficientBalance,

    // Feature gating
    #[msg("Feature not enabled for this stablecoin preset")]
    FeatureNotEnabled,
    #[msg("Blacklist feature requires SSS-2 or higher preset")]
    BlacklistNotEnabled,
    #[msg("Transfer hook feature requires SSS-2 or higher preset")]
    TransferHookNotEnabled,
    #[msg("Confidential transfers require SSS-3 preset")]
    ConfidentialTransfersNotEnabled,
    #[msg("Custom preset requires all four feature flags to be specified")]
    CustomFlagsMissing,

    // Blacklist (SSS-2)
    #[msg("Cannot blacklist the master authority")]
    CannotBlacklistAuthority,
    #[msg("Cannot mint to a blacklisted recipient")]
    RecipientBlacklisted,

    // Validation
    #[msg("Name exceeds maximum length of 32 characters")]
    NameTooLong,
    #[msg("Symbol exceeds maximum length of 10 characters")]
    SymbolTooLong,
    #[msg("URI exceeds maximum length of 200 characters")]
    UriTooLong,
    #[msg("Reason exceeds maximum length of 128 characters")]
    ReasonTooLong,
    #[msg("Allowlist reason exceeds maximum length of 64 characters")]
    AllowlistReasonTooLong,
    #[msg("Details exceeds maximum length of 256 characters")]
    DetailsTooLong,
    #[msg("Invalid decimals value")]
    InvalidDecimals,

    // Authority
    #[msg("Cannot transfer authority to the same address")]
    SameAuthority,
    #[msg("New authority cannot be the zero address")]
    ZeroAuthority,
    #[msg("No pending authority nomination exists")]
    NoPendingAuthority,
    #[msg("Signer is not the pending authority")]
    NotPendingAuthority,

    // Seize
    #[msg("Seize amount must be greater than zero")]
    SeizeAmountZero,
    #[msg("Source and destination accounts must be different")]
    SeizeSameAccount,

    // Reserve attestation
    #[msg("Reserve attestation requires reserves >= outstanding")]
    InsufficientReserves,

    // Transfer hook
    #[msg("Invalid transfer hook program ID")]
    InvalidHookProgram,

    // Allowlist
    #[msg("Allowlist entry already exists")]
    AllowlistEntryExists,
    #[msg("Allowlist entry not found")]
    AllowlistEntryNotFound,

    // Supply cap
    #[msg("Mint would exceed the configured supply cap")]
    SupplyCapExceeded,

    // Arithmetic
    #[msg("Arithmetic overflow")]
    Overflow,
}