蔵kagura-vault

1#[account]2#[derive(InitSpace, Debug)]3pub struct Vault {4    pub authority: Pubkey,5    pub usdc_mint: Pubkey,6    pub share_mint: Pubkey,7    pub principal_account: Pubkey,8    pub treasury_account: Pubkey,9    pub kagura_protocol: Pubkey,10    pub funding_rate_bps: u32,11    pub last_tick_unix_ms: i64,12    pub total_ticks: u64,13    pub total_accrued_lifetime: u64,14    pub paused: bool,15    pub bump: u8,16    pub principal_auth_bump: u8,17    pub treasury_auth_bump: u8,18    pub share_mint_bump: u8,19}

1vault             ←  [b"kagura-vault",   authority.key()]2share_mint        ←  [b"share-mint",     vault.key()]3principal_authority  ←  [b"principal-auth", vault.key()]4treasury_authority   ←  [b"treasury-auth",  vault.key()]5principal_account ←  [b"principal",      vault.key()]    (token account)6treasury_account  ←  [b"treasury",       vault.key()]    (token account)

1pub fn initialize_vault(2    ctx: Context<InitializeVault>,3    funding_rate_bps: u32,4) -> Result<()>5 6// validation:7//   funding_rate_bps <= MAX_FUNDING_RATE_BPS (30_000 = 300% APR)

1pub fn set_funding_rate(ctx: Context<SetFundingRate>, new_rate_bps: u32) -> Result<()>

1pub fn set_paused(ctx: Context<SetVaultPaused>, paused: bool) -> Result<()>

1pub fn top_up_treasury(ctx: Context<TopUpTreasury>, amount: u64) -> Result<()>

1pub fn deposit(ctx: Context<Deposit>, amount: u64) -> Result<()>2 3// math:4//   shares_to_mint = amount × total_shares / vault_balance5//   (or amount, on first deposit)

1pub fn withdraw(ctx: Context<Withdraw>, shares: u64) -> Result<()>2 3// math:4//   assets_out = shares × vault_balance / total_shares

1pub fn tick_funding(ctx: Context<TickFunding>) -> Result<()>2 3// math:4//   tick      = kagura_core::record_tick(...)5//   accrued   = principal × rate_bps × elapsed_ms / (10_000 × 31_536_000_000)6//   transfer  = min(accrued, treasury_balance)7//   total_accrued_lifetime += transfer

1#[event] pub struct FundingTicked {2    pub vault: Pubkey, pub tick_number: u64, pub elapsed_ms: u32,3    pub principal_before: u64, pub accrued: u64,4    pub treasury_remaining: u64, pub now_unix_ms: i64,5}6 7#[event] pub struct Deposited {8    pub vault: Pubkey, pub user: Pubkey, pub amount: u64,9    pub shares_minted: u64, pub principal_after: u64, pub total_shares_after: u64,10}11 12#[event] pub struct Withdrawn {13    pub vault: Pubkey, pub user: Pubkey, pub shares_burned: u64,14    pub amount: u64, pub principal_after: u64, pub total_shares_after: u64,15}

1pub const VAULT_SEED:          &[u8] = b"kagura-vault";2pub const PRINCIPAL_AUTH_SEED: &[u8] = b"principal-auth";3pub const TREASURY_AUTH_SEED:  &[u8] = b"treasury-auth";4pub const SHARE_MINT_SEED:     &[u8] = b"share-mint";5pub const MAX_FUNDING_RATE_BPS: u32 = 30_000;       // 300% APR ceiling