sla-escrow-api 0.2.6

SLA-Escrow: Service Level Agreement Enforcer for AI Agents
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

use solana_program::pubkey::Pubkey;
use steel::*;

#[repr(u8)]
#[derive(Clone, Copy, Debug, Eq, PartialEq, TryFromPrimitive)]
pub enum EscrowInstruction {
    // Public Instructions (No Authority Required)
    FundPayment = 0, // Creates payment account and funds it atomically (SOL or SPL)
    ReleasePayment = 1, // Release tokens to seller (SOL or SPL)
    RefundPayment = 2, // Refund tokens to buyer (SOL or SPL)
    ClosePayment = 3, // Close payment account
    ExtendPaymentTTL = 4, // Extend payment expiration
    SubmitDelivery = 5, // Seller submits delivery payload hash
    ConfirmOracle = 6, // Oracle confirms fulfillment

    // Admin Instructions (Require Authority) — continuous range 100–107
    Initialize = 100,
    UpdateAuthority = 101,
    UpdateConfig = 102,
    OpenEscrow = 103,
    PauseEscrow = 104,
    UpdateEscrowSettings = 105,
    CloseEscrow = 106,
    WithdrawFees = 107, // Withdraw accumulated protocol fees (SOL or SPL)
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct Initialize {
    pub fee_bps: [u8; 2],  // Use byte array to avoid endianness issues
    pub _padding: [u8; 6], // Pad to 8 bytes for alignment
}

#[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 FundPayment {
    pub seller: Pubkey,           // 32 bytes
    pub mint: Pubkey,             // 32 bytes
    pub oracle_authority: Pubkey, // 32 bytes
    pub payment_uid: [u8; 32],    // 32 bytes
    pub sla_hash: [u8; 32],       // 32 bytes
    pub amount: [u8; 8],          // 8 bytes
    pub ttl_seconds: [u8; 8],     // 8 bytes
}

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

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

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct SubmitDelivery {
    pub delivery_hash: [u8; 32], // 32 bytes - hashed AI delivery payload
}

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

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct WithdrawFees {
    pub amount: [u8; 8], // 8 bytes - amount to withdraw (0 = withdraw all)
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct ExtendPaymentTTL {
    pub additional_seconds: [u8; 8], // Additional TTL in seconds
}

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

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct UpdateEscrowSettings {
    pub min_payment_amount: [u8; 8], // 8 bytes
    pub max_payment_amount: [u8; 8], // 8 bytes
    pub min_fee_amount: [u8; 8],     // 8 bytes
    pub new_fee_bps: [u8; 2],        // 2 bytes
    pub new_oracle_fee_bps: [u8; 2], // 2 bytes - u16::MAX means unchanged
    pub _padding: [u8; 4],           // 4 bytes padding
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct PauseEscrow {
    pub pause: u8, // 0=Unpause, 1=Pause
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct UpdateConfig {
    pub closure_delay_seconds: [u8; 8], // 8 bytes - Closure delay for all final states
    pub refund_cooldown_seconds: [u8; 8], // 8 bytes - Refund cooldown for buyer-initiated refunds
                                        // Total: 8+8 = 16 bytes (already aligned)
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct OpenEscrow {
    pub min_payment_amount: [u8; 8], // 8 bytes
    pub max_payment_amount: [u8; 8], // 8 bytes
    pub min_fee_amount: [u8; 8],     // 8 bytes
    pub fee_bps: [u8; 2],            // 2 bytes - u16::MAX (65535) means use Bank's default fee
    pub oracle_fee_bps: [u8; 2],     // 2 bytes - oracle tip bps (0 = disabled)
    pub _padding: [u8; 4],           // 4 bytes padding
}

#[repr(C)]
#[derive(Clone, Copy, Debug, Pod, Zeroable)]
pub struct ConfirmOracle {
    pub delivery_hash: [u8; 32], // 32 bytes

    pub resolution_state: u8, // 1 byte - 1: Approved/Completed, 2: Rejected/Refundable
    pub _padding: [u8; 7],    // 7 bytes margin
}

instruction!(EscrowInstruction, FundPayment);
instruction!(EscrowInstruction, ReleasePayment);
instruction!(EscrowInstruction, RefundPayment);
instruction!(EscrowInstruction, ClosePayment);
instruction!(EscrowInstruction, ExtendPaymentTTL);
instruction!(EscrowInstruction, SubmitDelivery);
instruction!(EscrowInstruction, ConfirmOracle);

instruction!(EscrowInstruction, Initialize);
instruction!(EscrowInstruction, OpenEscrow);
instruction!(EscrowInstruction, UpdateAuthority);
instruction!(EscrowInstruction, WithdrawFees);
instruction!(EscrowInstruction, CloseEscrow);
instruction!(EscrowInstruction, UpdateEscrowSettings);
instruction!(EscrowInstruction, PauseEscrow);
instruction!(EscrowInstruction, UpdateConfig);