Smart Contracts

1pub struct ProtocolConfig {
2    pub authority: Pubkey,                  // Admin
3    pub treasury: Pubkey,                   // Fee recipient
4    pub fee_bps: u16,                       // Default 200 (2%), cap 1000 (10%)
5    pub min_duration_days: u16,             // Default 30
6    pub max_duration_days: u16,             // Default 365
7    pub base_penalty_bps: u16,              // Default 300 (3%), cap 3000 (30%)
8    pub min_penalty_bps: u16,               // Default 100 (1%), cap 1500 (15%)
9    pub is_paused: bool,                    // Emergency pause
10    pub use_oracle: bool,                   // True on mainnet for LSTs
11    pub deal_counter: u64,                  // Auto-increment ID
12    pub allowed_mints: Vec<Pubkey>,         // Receipt mint whitelist (max 10)
13    pub allowed_payment_mints: Vec<Pubkey>, // Payment mint whitelist (max 10)
14    pub bump: u8,
15}

1pub struct YieldDeal {
2    pub deal_id: u64,
3    pub bump: u8,
4    // Parties
5    pub seller: Pubkey,
6    pub buyer:  Pubkey,                  // Pubkey::default() until filled
7    // Locked collateral
8    pub receipt_token_mint:   Pubkey,
9    pub receipt_token_vault:  Pubkey,
10    pub receipt_tokens_amount: u64,
11    // Pricing snapshot
12    pub principal_value_at_lock: u64,
13    pub expected_yield:          u64,
14    pub selling_price:           u64,
15    pub payment_mint:            Pubkey,
16    pub exchange_rate_at_lock:   u64,    // scaled 1e6, anti-manip anchor
17    // Timing
18    pub duration_days: u16,
19    pub created_at:    i64,
20    pub purchased_at:  i64,              // 0 until filled
21    pub ends_at:       i64,              // 0 until filled
22    // State
23    pub status:          DealStatus,
24    pub source_protocol: SourceProtocol,
25}

1pub struct MeteoraLpDeal {
2    pub deal_id: u64,
3    pub bump: u8,
4    pub seller: Pubkey,
5    pub buyer:  Pubkey,
6    // Position
7    pub position_nft_mint:  Pubkey,
8    pub position_account:   Pubkey,
9    pub position_nft_vault: Pubkey,
10    pub pool:               Pubkey,
11    pub token_a_mint:       Pubkey,
12    pub token_b_mint:       Pubkey,
13    // Snapshots at lock
14    pub fee_a_at_lock: u64,
15    pub fee_b_at_lock: u64,
16    // Projections
17    pub expected_fee_a:          u64,
18    pub expected_fee_b:          u64,
19    pub expected_fee_value_usdc: u64,
20    // Pricing
21    pub selling_price: u64,
22    pub payment_mint:  Pubkey,
23    // Timing
24    pub duration_days: u16,
25    pub created_at:    i64,
26    pub purchased_at:  i64,
27    pub ends_at:       i64,
28    pub status:        DealStatus,
29}

1pub enum DealStatus {
2    Created,    // Listed, waiting for a buyer
3    Active,     // Bought, accruing yield
4    Settled,    // Expired and distributed
5    Cancelled,  // Cancelled by seller before purchase
6    BoughtBack, // Seller exited early via buyback_deal
7}

1pub enum SourceProtocol {
2    // Phase 1 — lending
3    Kamino,    Solend,    Save,
4    // Phase 1 — liquid staking
5    Marinade,  Jito,      Blaze,     Sanctum,
6    // Phase 2 — LP positions
7    RaydiumLp, MeteoraLp, OrcaLp,
8    // Phase 3 — fee streams
9    FeeStream,
10}