acta-maker-sdk 0.8.0

use serde::{Deserialize, Serialize};

pub use crate::types::VaultLeg;
use crate::ws::types::{MarketInfo, TokenInfo};

/// Public `/api/v1/vaults` row. Integers wider than JSON-safe stay decimal strings.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Vault {
    pub vault_pda: String,
    pub vault_id: String,
    pub governance: String,
    pub fee_recipient: String,
    pub primary_delegate: String,
    pub main_mint: String,
    pub second_mint: String,
    pub share_mint: String,
    pub main_token_program: TokenProgramKind,
    pub second_token_program: TokenProgramKind,
    pub main_decimals: u8,
    pub second_decimals: u8,
    /// `idle`, `active`, `settling` or `processing_capital`.
    pub phase: String,
    /// `normal`, `frozen`, `emergency_unwind`, `withdraw_only` or `closing`.
    pub safety: String,
    pub capabilities: u32,
    pub active_expiry: String,
    pub open_positions: String,
    pub total_shares: String,
    pub share_price: String,
    pub equity: String,
    pub capital_generation: String,
    pub second_leg_generation: String,
    pub accepting_deposits: bool,
    pub equity_computed: bool,
    pub pending_deposit_count: u32,
    pub pending_withdraw_count: u32,
    pub pending_deposit_amount: String,
    pub pending_withdraw_shares: String,
    pub performance_fee_bps: u16,
    pub management_fee_bps: u16,
    pub manager_stake_min_bps: u16,
    pub share_price_hwm: String,
    pub last_hwm_update_ts: String,
    pub last_hwm_reset_ts: String,
    pub last_settlement_ts: String,
    pub capacity: VaultCapacity,
    pub capital_fallback_delay_secs: String,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub deposit_window_set_ts: Option<String>,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub main_balance: Option<String>,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub second_balance: Option<String>,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub balance_updated_at: Option<String>,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub live_share_supply: Option<String>,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub observed_manager_stake_shares: Option<String>,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub balance_chain_slot: Option<String>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub staging: Option<VaultStaging>,
    /// The next stage carries `staged_generation + 1`.
    pub staged_generation: String,
    pub policy: VaultPolicy,
    pub projection: ProjectionCursor,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub created_at: Option<String>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub generation_started_at: Option<String>,
    /// Indicative: booked equity at the main mint's USD price, 1e9 scale.

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub tvl_usd_1e9: Option<String>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub price_time: Option<String>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub premium: Option<Vec<VaultPremium>>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub fees: Option<VaultFees>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub depositors_in_generation: Option<u64>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub performance: Option<VaultPerformance>,
    /// Display only; `governance` is the authority.

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub metadata: Option<VaultMetadata>,
}

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct VaultMetadata {
    pub name: String,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub curator: Option<String>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub strategy: Option<String>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub description: Option<String>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub website: Option<String>,
    /// X handle without `@`.

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub twitter: Option<String>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub logo_url: Option<String>,
}

/// Leg balance moved into a vault ATA of another mint, pending return to a leg.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct VaultStaging {
    pub mint: String,
    pub from_leg: VaultLeg,
    pub amount: String,
    pub staged_at: String,
    /// The open slot's generation; an unstage names it.
    pub generation: String,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum TokenProgramKind {
    #[serde(rename = "legacy_spl")]
    LegacySpl,
    #[serde(rename = "token_2022")]
    Token2022,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub struct VaultPolicy {
    pub max_open_positions: u16,
    pub max_rebalance_drift_bps: u16,
    pub min_main_liquidity_bps: u16,
}

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct ProjectionCursor {
    pub version: String,
    pub slot: String,
    pub transaction_index: u32,
    pub signature: String,
    pub event_index: u32,
}

/// A zero on-chain cap means the vault accepts deposits without a limit.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(tag = "type", rename_all = "snake_case", deny_unknown_fields)]
pub enum VaultCapacity {
    Unlimited {},
    Limited {
        cap_limit: String,
        remaining: String,
    },
}

/// Net premium per quote mint, in quote atoms, for the current cycle and generation.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct VaultPremium {
    pub quote_mint: String,
    pub cycle: PremiumFlow,
    pub generation: PremiumFlow,
}

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct PremiumFlow {
    pub received: String,
    /// `None` when a holder leg's market lacks decimals or its open price.
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub paid: Option<String>,
}

/// Generation totals in main atoms.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct VaultFees {
    pub management_fee_assessed: String,
    pub performance_fee_assessed: String,
    pub realized_fee_value: String,
}

/// Metrics of `capital_generation` as of `computed_at`; all `None` unless `covered`.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct VaultPerformance {
    pub capital_generation: String,
    pub computed_at: String,
    pub covered: bool,

    pub returns: VaultReturns,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub apy_30d: Option<f64>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub apy_90d: Option<f64>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub max_drawdown_pct: Option<f64>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub worst_cycle_return_pct: Option<f64>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub losing_cycles: Option<u64>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub cycles_completed: Option<u64>,
}

#[derive(Debug, Clone, Default, PartialEq, Serialize, Deserialize)]
pub struct VaultReturns {
    #[serde(rename = "7d")]
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub d7: Option<WindowReturn>,
    #[serde(rename = "30d")]
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub d30: Option<WindowReturn>,
    #[serde(rename = "90d")]
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub d90: Option<WindowReturn>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub all: Option<WindowReturn>,
}

/// Net-of-fee booked share price return between two checkpoint times.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct WindowReturn {
    pub return_pct: f64,
    pub from_time: String,
    pub to_time: String,
}

/// Public `/api/v1/vaults/{pda}/positions` row.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct VaultPosition {
    pub vault: String,
    pub position: String,
    pub order_id: String,
    pub role: VaultPositionRole,
    pub market: String,
    pub position_type: VaultPositionType,
    /// The lower strike for spreads.
    pub strike: String,
    pub product: VaultPositionProduct,
    pub quantity: String,
    pub net_premium: String,
    pub counterparty: String,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub funded_amount: Option<String>,
    pub status: VaultPositionStatus,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub is_otm: Option<bool>,
    pub created_at: String,
    pub acquired_at: String,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub settled_at: Option<String>,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub transaction_signature: Option<String>,
}

/// Physical CC/CSP, or a cash spread with its upper strike and the quote atoms it reserves.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(tag = "kind", rename_all = "snake_case")]
pub enum VaultPositionProduct {
    Physical,
    Spread {
        upper_strike: String,
        collateral: String,
    },
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum VaultPositionRole {
    Writer,
    Holder,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum VaultPositionType {
    CoveredCall,
    CashSecuredPut,
    CallSpread,
    PutSpread,
    CashPut,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum VaultPositionStatus {
    Open,
    Funded,
    Liquidated,
    Settled,
}

/// Public `/api/v1/vaults/{pda}/exposure`: outstanding positions at the indicative spot.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct VaultExposure {
    #[serde(deserialize_with = "crate::ws::types::deserialize_required_nullable")]
    pub next_cursor: Option<String>,
    pub vault_pda: String,
    /// Unix seconds the positions were read; never older than 15 s.
    pub as_of: String,
    pub positions: Vec<VaultExposurePosition>,
    pub totals: Vec<VaultExposureTotal>,
}

/// `intrinsic` is in quote atoms: positive for holder legs, negative for writer legs.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct VaultExposurePosition {
    pub position: String,
    pub market: String,
    pub position_type: VaultPositionType,
    pub role: VaultPositionRole,
    pub status: VaultPositionStatus,
    pub strike: String,
    pub quantity: String,
    pub expiry: String,
    pub underlying_mint: String,
    pub quote_mint: String,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub underlying_decimals: Option<u8>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub quote_decimals: Option<u8>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub spot: Option<String>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub spot_time: Option<String>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub distance_pct: Option<f64>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub itm: Option<bool>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub intrinsic: Option<String>,
}

/// `None` when any position of the quote mint lacks the value.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct VaultExposureTotal {
    pub quote_mint: String,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub notional_at_strike: Option<String>,

    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub outstanding_intrinsic: Option<String>,
}

/// Public `/api/v1/vaults/{pda}/cycles` row.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct VaultCycle {
    pub cycle_number: String,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub capital_generation: Option<String>,
    pub expiry: String,
    pub started_at: String,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub finished_at: Option<String>,
    pub share_price_start: String,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub share_price_end: Option<String>,
    pub equity_start: String,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub equity_end: Option<String>,
    pub positions_opened: u32,
    pub positions_settled: u32,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub return_pct: Option<f64>,
    pub performance_fee_assessed: String,
    pub management_fee_assessed: String,
}

/// Public `/api/v1/vaults/{pda}/deposit-requests` row.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct VaultDepositRequest {
    pub wallet: String,
    pub amount: String,
    pub created_at: String,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub transaction_signature: Option<String>,
}

/// Public `/api/v1/vaults/{pda}/withdraw-requests` row.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct VaultWithdrawRequest {
    pub wallet: String,
    pub shares: String,
    pub created_at: String,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub transaction_signature: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub(super) struct VaultCyclesResponse {
    pub(super) cycles: Vec<VaultCycle>,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub(super) next_cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub(super) struct VaultRequestsResponse<T> {
    pub(super) requests: Vec<T>,
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub(super) next_cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub(super) struct VaultPositionsResponse {
    pub(super) positions: Vec<VaultPosition>,
    pub(super) next_cursor: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub(super) struct VaultsResponse {
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub next_cursor: Option<String>,
    pub(super) vaults: Vec<Vault>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub(super) struct MarketsResponse {
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub next_cursor: Option<String>,
    pub(super) markets: Vec<MarketInfo>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub(super) struct TokensResponse {
    #[serde(deserialize_with = "crate::wire::deserialize_required_option")]
    pub next_cursor: Option<String>,
    pub(super) tokens: Vec<TokenInfo>,
}

/// A configured count bound.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(tag = "type", rename_all = "snake_case", deny_unknown_fields)]
pub enum CountLimit {
    Unlimited {},
    Limited { value: u64 },
}

/// Public `/api/v1/venue`: limits the server validates against.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct Venue {
    pub protocol_fee_bps_premium: u16,
    pub protocol_fee_bps_volume: u16,
    pub program_id: crate::Address32,
    pub min_quote_validity_seconds: u32,
    pub settlement_buffer_seconds: u32,
    pub quote_refresh_lead_seconds: u32,
    pub min_rfq_timeout_seconds: u32,
    pub max_rfq_timeout_seconds: u32,
    pub signature_timeout_seconds: u64,
    pub max_quotes_per_rfq: CountLimit,
    pub max_active_rfqs_per_taker: CountLimit,
    pub pre_expiry_cutoff_seconds: u64,
}