universalsettle-api 0.2.1

X402-inspired settlement program for any token on Solana
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

use steel::*;

#[repr(u8)]
#[derive(Clone, Copy, Debug, Eq, PartialEq, TryFromPrimitive)]
pub enum SettlementInstruction {
    // User (public — no authority required)
    Sweep = 0,       // Indirect/batch settlement sweep
    CreateVault = 1, // Setup SplitVault for a seller
    // 2–99 reserved for future public instructions

    // Admin (require Config authority signer)
    Initialize = 100,
    UpdateAuthority = 101,
    UpdateFeeRate = 102,
    UpdateFeeDestination = 103,
    UpdateMinFeeAmount = 104,
    UpdateMinFeeAmountSol = 105,
    UpdateProvisioningFee = 106,
    UpdateDiscountedFeeRate = 107,
    AcceptAuthority = 108, // Two-step: new authority accepts proposed transfer
    CancelAuthorityProposal = 109, // Two-step: current authority cancels pending proposal
    InitShard = 110,       // Initialize a fee shard
    CollectFromShard = 111, // Collect fees from a shard to the treasury
    UpdateShardConfig = 112, // Update shard flag and count
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct CreateVault {
    pub seller: Pubkey, // 32 bytes - Resource owner wallet address
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct Sweep {
    pub token_mint: Pubkey, // For SOL: Pubkey::default(), For SPL: the mint address
    pub amount: [u8; 8],    // Amount to sweep (0 = all available)
    pub is_sol: [u8; 1],    // 1 for native SOL, 0 for SPL token
    pub _padding: [u8; 7],
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct Initialize {
    pub fee_destination: Pubkey,       // 32
    pub min_fee_amount: [u8; 8],       // 8 (SPL)
    pub min_fee_amount_sol: [u8; 8],   // 8 (SOL)
    pub provisioning_fee_sol: [u8; 8], // 8
    pub provisioning_fee_spl: [u8; 8], // 8
    pub fee_bps: [u8; 2],              // 2
    pub discounted_fee_bps: [u8; 2],   // 2
    pub use_fee_shard: u8,             // 1
    pub shard_count: u8,               // 1
    pub _padding: [u8; 2],             // 2
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct UpdateAuthority {
    pub new_authority: Pubkey,
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct AcceptAuthority {}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct CancelAuthorityProposal {}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct UpdateFeeRate {
    pub new_fee_bps: [u8; 2],
    pub _padding: [u8; 6], // 6 bytes padding
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct UpdateFeeDestination {
    pub new_fee_destination: Pubkey,
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct UpdateMinFeeAmount {
    pub new_min_fee_amount: [u8; 8],
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct UpdateProvisioningFee {
    pub new_provisioning_fee_sol: [u8; 8],
    pub new_provisioning_fee_spl: [u8; 8],
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct UpdateDiscountedFeeRate {
    pub new_discounted_fee_bps: [u8; 2],
    pub _padding: [u8; 6],
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct UpdateMinFeeAmountSol {
    pub new_min_fee_amount_sol: [u8; 8],
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct InitShard {
    pub index: [u8; 8],
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct CollectFromShard {
    pub index: [u8; 8],
    pub amount: [u8; 8],
    pub is_sol: [u8; 1],
    pub _padding: [u8; 7],
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct UpdateShardConfig {
    pub use_fee_shard: u8,
    pub shard_count: u8,
    pub _padding: [u8; 6],
}

instruction!(SettlementInstruction, Sweep);
instruction!(SettlementInstruction, CreateVault);
instruction!(SettlementInstruction, Initialize);
instruction!(SettlementInstruction, UpdateAuthority);
instruction!(SettlementInstruction, UpdateFeeRate);
instruction!(SettlementInstruction, UpdateFeeDestination);
instruction!(SettlementInstruction, UpdateMinFeeAmount);
instruction!(SettlementInstruction, UpdateMinFeeAmountSol);
instruction!(SettlementInstruction, UpdateProvisioningFee);
instruction!(SettlementInstruction, UpdateDiscountedFeeRate);
instruction!(SettlementInstruction, AcceptAuthority);
instruction!(SettlementInstruction, CancelAuthorityProposal);
instruction!(SettlementInstruction, InitShard);
instruction!(SettlementInstruction, CollectFromShard);
instruction!(SettlementInstruction, UpdateShardConfig);