7. Implementation Details

Data Structures

StakingPool

#[account]
pub struct StakingPool {
    pub path_mint: Pubkey,
    pub staking_vault: Pubkey,
    pub total_staked: u64,
    pub total_locked: u64,
    pub total_rewards_distributed: u64,
    pub reward_per_token: u128,
    pub bump: u8,
    pub staking_vault_bump: u8,
    pub total_proposals: u64,              // For voter tracking
}

StakerAccount

#[account]
pub struct StakerAccount {
    pub owner: Pubkey,
    pub staked_amount: u64,
    pub staked_at: i64,
    pub reward_debt: u128,
    pub unclaimed_rewards: u64,
    pub bump: u8,
    
    // Locking fields
    pub lock_type: LockType,
    pub lock_schedule: Option<LockSchedule>,
    pub locked_amount: u64,
    pub unlocked_amount: u64,
    pub reward_multiplier_bps: u16,         // Lock-based multiplier
    
    // Voting fields
    pub voter_account: Option<Pubkey>,
    pub voter_bonus_multiplier_bps: u16,    // Voter bonus (0-2000 = 0-20%)
    pub is_platform_stake: bool,
}

LockSchedule

pub struct LockSchedule {
    pub lock_start_time: i64,
    pub lock_duration: i64,           // Lock period in seconds
    pub unlock_mode: UnlockMode,      // Fixed or Linear
    pub unlock_duration: Option<i64>, // None for Fixed, Some(lock_duration) for Linear (same period)
    pub total_duration: i64,           // For Fixed: lock_duration, For Linear: lock_duration (same)
    pub reward_multiplier_bps: u16,   // Basis points (11000 = 1.1x)
}

PlatformLockSchedule

pub struct PlatformLockSchedule {
    pub lock_start_time: i64,
    pub lock_duration: i64,           // 5 years = 1,825 days = 157,680,000 seconds
    pub unlock_mode: UnlockMode,      // Always Linear for platforms
    pub unlock_duration: i64,         // Same as lock_duration (linear unlock during period)
    pub total_duration: i64,           // 5 years (same as lock_duration)
    pub reward_multiplier_bps: u16,   // 10000 (1.0x - platforms earn fees instead)
}

VoterAccount

#[account]
pub struct VoterAccount {
    pub owner: Pubkey,
    pub total_proposals: u64,
    pub votes_cast: u64,
    pub participation_rate_bps: u16,
    pub last_vote_time: Option<i64>,
    pub consecutive_votes: u16,
    pub voter_tier: VoterTier,
    pub total_voter_bonus_earned: u64,
    pub bump: u8,
}

Key Functions

Stake

pub fn stake(
    ctx: Context<Stake>,
    amount: u64,
    lock_type: LockType,
) -> Result<()> {
    // 1. Validate amount
    // 2. Transfer tokens to staking vault
    // 3. Create lock schedule (if not flexible)
    // 4. Update staker account
    // 5. Update pool totals
    // 6. Initialize voter account (if first stake)
}

Unstake

pub fn unstake(
    ctx: Context<Unstake>,
    amount: u64,
) -> Result<()> {
    // 1. Check lock restrictions
    // 2. Calculate unlockable amount
    // 3. Validate unstake amount
    // 4. Transfer tokens back to user
    // 5. Update accounts and pool totals
}

Claim Rewards

pub fn claim_rewards(
    ctx: Context<ClaimRewards>,
) -> Result<()> {
    // 1. Accrue rewards with multipliers
    // 2. Transfer rewards to user
    // 3. Update reward tracking
}

Record Vote

pub fn record_vote(
    ctx: Context<RecordVote>,
    proposal_id: u64,
) -> Result<()> {
    // 1. Increment votes cast
    // 2. Update participation rate
    // 3. Update voter tier
    // 4. Update staker voter bonus multiplier
    // 5. Recalculate rewards
}

Error Codes

#[error_code]
pub enum ErrorCode {
    #[msg("Invalid stake amount (must be > 0)")]
    InvalidStakeAmount,
    #[msg("Insufficient staked amount")]
    InsufficientStakedAmount,
    #[msg("Insufficient unlockable amount")]
    InsufficientUnlockableAmount,
    #[msg("No stakers in the pool")]
    NoStakers,
    #[msg("Unauthorized")]
    Unauthorized,
    #[msg("Math overflow")]
    MathOverflow,
    #[msg("No rewards to claim")]
    NoRewardsToClaim,
    #[msg("Reward accumulation overflow")]
    RewardOverflow,
    #[msg("Invalid staking vault")]
    InvalidStakingVault,
    #[msg("Lock type mismatch")]
    LockTypeMismatch,
    #[msg("Still locked")]
    StillLocked,
    #[msg("Invalid unlock schedule")]
    InvalidUnlockSchedule,
}