@optionsfi/sdk 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,3315 @@
+import { PublicKey, Transaction, Connection, TransactionInstruction } from '@solana/web3.js';
+import * as anchor from '@coral-xyz/anchor';
+
+/**
+ * RFQ and quote type definitions.
+ */
+/**
+ * Configuration for connecting to the OptionsFi RFQ infrastructure
+ */
+interface RFQConfig {
+    /** Solana RPC URL */
+    rpcUrl: string;
+    /** WebSocket URL for the RFQ router (e.g., wss://rfq.optionsfi.xyz) */
+    rfqRouterUrl: string;
+    /** OptionsFi vault program ID */
+    programId: string;
+    /** Network environment */
+    network?: 'devnet' | 'mainnet-beta';
+    /** Optional timeout for RFQ requests in milliseconds (default: 30000) */
+    rfqTimeoutMs?: number;
+}
+/**
+ * Parameters for creating a new RFQ
+ */
+interface RFQParams {
+    /** Asset identifier (e.g., "NVDAX", "SOL") */
+    asset: string;
+    /** Whether the protocol is buying or selling options */
+    side: 'buy' | 'sell';
+    /** Type of option */
+    optionType: 'call' | 'put';
+    /** Strike price in USD (e.g., 150.00) */
+    strike: number;
+    /** Expiry timestamp (Unix seconds) */
+    expiry: number;
+    /** Notional quantity in base asset tokens (scaled by decimals) */
+    quantity: bigint;
+    /** Vault address making the request */
+    vaultAddress: string;
+    /** Minimum acceptable premium (optional floor) */
+    premiumFloor?: bigint;
+    /** Whether to anonymize vault identity in RFQ broadcast (default: false) */
+    anonymous?: boolean;
+    /** Minimum number of quotes required (default: 1) */
+    minQuotes?: number;
+    /** Maximum time to wait for quotes in milliseconds (default: 30000) */
+    quoteTimeout?: number;
+}
+/**
+ * A quote from a market maker
+ */
+interface Quote {
+    /** Unique quote identifier */
+    id: string;
+    /** RFQ this quote is for */
+    rfqId: string;
+    /** Market maker identifier */
+    marketMaker: string;
+    /** Premium amount in USDC (scaled by decimals, typically 6) */
+    premium: bigint;
+    /** Quote timestamp (Unix milliseconds) */
+    timestamp: number;
+    /** When this quote expires (Unix milliseconds) */
+    expiresAt: number;
+    /** Optional: Quote expiry duration in seconds (for validation) */
+    validUntil?: number;
+}
+/**
+ * RFQ status and state
+ */
+interface RFQ {
+    /** Unique RFQ identifier */
+    id: string;
+    /** Original RFQ parameters */
+    params: RFQParams;
+    /** All quotes received */
+    quotes: Quote[];
+    /** Current status */
+    status: 'open' | 'filled' | 'cancelled' | 'expired';
+    /** Fill details if filled */
+    fill?: {
+        quoteId: string;
+        marketMaker: string;
+        premium: bigint;
+        filledAt: number;
+        transactionSignature?: string;
+    };
+    /** Creation timestamp (Unix milliseconds) */
+    createdAt: number;
+}
+/**
+ * RFQ event types for subscription callbacks
+ */
+type RFQEventType = 'quote_received' | 'rfq_filled' | 'rfq_cancelled' | 'rfq_expired' | 'connection_error';
+/**
+ * RFQ event payload
+ */
+interface RFQEvent {
+    type: RFQEventType;
+    rfqId: string;
+    data: Quote | RFQ | Error;
+    timestamp: number;
+}
+
+/**
+ * Option pricing and position type definitions.
+ */
+/**
+ * Option type (call or put)
+ */
+type OptionType = 'call' | 'put';
+/**
+ * Parameters for Black-Scholes pricing
+ */
+interface BlackScholesParams {
+    /** Current underlying spot price */
+    spot: number;
+    /** Option strike price */
+    strike: number;
+    /** Time to expiry in years (e.g., 0.0833 for 1 month) */
+    timeToExpiry: number;
+    /** Risk-free rate as decimal (e.g., 0.05 for 5%) */
+    riskFreeRate: number;
+    /** Annualized volatility as decimal (e.g., 0.30 for 30%) */
+    volatility: number;
+}
+/**
+ * Option pricing results
+ */
+interface OptionPrices {
+    /** Call option price */
+    call: number;
+    /** Put option price */
+    put: number;
+    /** Delta (rate of change vs underlying) */
+    delta: {
+        call: number;
+        put: number;
+    };
+}
+/**
+ * Parameters for premium calculation
+ */
+interface PremiumParams {
+    /** Current spot price */
+    spot: number;
+    /** Strike as percentage of spot (e.g., 1.05 for 5% OTM call) */
+    strikePercent: number;
+    /** Days until expiry */
+    daysToExpiry: number;
+    /** Annualized volatility as decimal */
+    volatility: number;
+    /** Risk-free rate (default: 0.05) */
+    riskFreeRate?: number;
+}
+/**
+ * Option position details
+ */
+interface OptionPosition {
+    /** Underlying asset */
+    asset: string;
+    /** Call or put */
+    optionType: OptionType;
+    /** Strike price */
+    strike: number;
+    /** Expiry timestamp (Unix seconds) */
+    expiry: number;
+    /** Notional amount in base tokens */
+    notional: bigint;
+    /** Premium paid/received in quote tokens (USDC) */
+    premium: bigint;
+    /** Whether this position is long or short */
+    side: 'long' | 'short';
+}
+/**
+ * Quote validation result
+ */
+interface QuoteValidation {
+    /** Whether the quote is valid */
+    isValid: boolean;
+    /** Reason for invalidity (if any) */
+    reason?: string;
+    /** Calculated fair value for reference */
+    fairValue?: number;
+    /** Deviation from fair value in basis points */
+    deviationBps?: number;
+}
+
+/**
+ * Vault account and instruction parameter types.
+ */
+
+/**
+ * Vault account data (on-chain state)
+ */
+interface VaultData {
+    /** Vault authority (admin) */
+    authority: PublicKey;
+    /** Asset identifier (e.g., "NVDAX") */
+    assetId: string;
+    /** Underlying token mint (e.g., NVDAx) */
+    underlyingMint: PublicKey;
+    /** Share token mint (e.g., vNVDAx) */
+    shareMint: PublicKey;
+    /** Vault's token account for underlying */
+    vaultTokenAccount: PublicKey;
+    /** Premium token mint (typically USDC) */
+    premiumMint: PublicKey;
+    /** Vault's token account for premium */
+    premiumTokenAccount: PublicKey;
+    /** Escrow account for pending share burns */
+    shareEscrow: PublicKey;
+    /** Total underlying assets in vault */
+    totalAssets: bigint;
+    /** Total shares outstanding */
+    totalShares: bigint;
+    /** Virtual offset for share price calculation */
+    virtualOffset: bigint;
+    /** Current epoch number */
+    epoch: bigint;
+    /** Maximum percentage of assets that can be used (basis points) */
+    utilizationCapBps: number;
+    /** Minimum epoch duration in seconds */
+    minEpochDuration: bigint;
+    /** Timestamp of last epoch roll */
+    lastRollTimestamp: bigint;
+    /** Pending withdrawal amount in shares */
+    pendingWithdrawals: bigint;
+    /** Notional exposure for current epoch */
+    epochNotionalExposed: bigint;
+    /** Premium earned in current epoch */
+    epochPremiumEarned: bigint;
+    /** Premium per token for current epoch (basis points) */
+    epochPremiumPerTokenBps: number;
+    /** Whether the vault is paused */
+    isPaused: boolean;
+    /** PDA bump seed */
+    bump: number;
+}
+/**
+ * Parameters for recording notional exposure
+ */
+interface RecordExposureParams {
+    /** Vault public key */
+    vault: PublicKey;
+    /** Vault authority (signer) */
+    authority: PublicKey;
+    /** Notional amount in underlying tokens */
+    notionalTokens: bigint;
+    /** Premium amount in quote tokens (USDC) */
+    premium: bigint;
+}
+/**
+ * Parameters for collecting premium
+ */
+interface CollectPremiumParams {
+    /** Vault public key */
+    vault: PublicKey;
+    /** Authority (signer) */
+    authority: PublicKey;
+    /** Payer's token account for premium */
+    payerTokenAccount: PublicKey;
+    /** Amount to collect */
+    amount: bigint;
+}
+/**
+ * Parameters for paying settlement
+ */
+interface PaySettlementParams {
+    /** Vault public key */
+    vault: PublicKey;
+    /** Authority (signer) */
+    authority: PublicKey;
+    /** Recipient's token account */
+    recipientTokenAccount: PublicKey;
+    /** Recipient public key */
+    recipient: PublicKey;
+    /** Settlement amount */
+    amount: bigint;
+}
+/**
+ * Parameters for advancing epoch
+ */
+interface AdvanceEpochParams {
+    /** Vault public key */
+    vault: PublicKey;
+    /** Authority (signer) */
+    authority: PublicKey;
+    /** Premium earned this epoch (for share price appreciation) */
+    premiumEarned: bigint;
+}
+/**
+ * Withdrawal request account data
+ */
+interface WithdrawalRequest {
+    /** User who requested withdrawal */
+    user: PublicKey;
+    /** Associated vault */
+    vault: PublicKey;
+    /** Epoch when withdrawal was requested */
+    epoch: bigint;
+    /** Number of shares to withdraw */
+    shares: bigint;
+    /** Whether the request has been processed */
+    processed: boolean;
+}
+
+/**
+ * WebSocket client for interacting with the RFQ router.
+ *
+ * @example
+ * ```typescript
+ * import { RFQClient, DEVNET_CONFIG } from '@optionsfi/sdk';
+ *
+ * const client = new RFQClient(DEVNET_CONFIG);
+ * await client.connect();
+ *
+ * const rfqId = await client.createRFQ({
+ *   asset: 'NVDAX',
+ *   side: 'sell',
+ *   optionType: 'call',
+ *   strike: 150,
+ *   expiry: Math.floor(Date.now() / 1000) + 86400 * 7,
+ *   quantity: BigInt(1000 * 1e6),
+ *   vaultAddress: vaultPubkey.toString(),
+ * });
+ *
+ * client.subscribeToQuotes(rfqId, (quote) => {
+ *   console.log('Quote received:', quote);
+ * });
+ * ```
+ */
+
+/**
+ * RFQ Client for interacting with OptionsFi infrastructure
+ */
+declare class RFQClient {
+    private connection;
+    private wsConnection;
+    private config;
+    private quoteCallbacks;
+    private eventCallbacks;
+    private activeRFQs;
+    private isConnected;
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    /**
+     * Create a new RFQ Client
+     *
+     * @param config - Configuration for connecting to OptionsFi
+     */
+    constructor(config: RFQConfig);
+    /**
+     * Connect to the RFQ router WebSocket
+     *
+     * @returns Promise that resolves when connected
+     * @throws Error if connection fails
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the RFQ router
+     */
+    disconnect(): void;
+    /**
+     * Check if the client is connected
+     */
+    get connected(): boolean;
+    /**
+     * Create a new RFQ and broadcast to market makers
+     *
+     * @param params - RFQ parameters
+     * @returns RFQ ID
+     * @throws Error if not connected or params invalid
+     */
+    createRFQ(params: RFQParams): Promise<string>;
+    /**
+     * Subscribe to quotes for a specific RFQ
+     *
+     * @param rfqId - RFQ to subscribe to
+     * @param callback - Called when a quote is received
+     */
+    subscribeToQuotes(rfqId: string, callback: (quote: Quote) => void): void;
+    /**
+     * Unsubscribe from quotes for an RFQ
+     *
+     * @param rfqId - RFQ to unsubscribe from
+     */
+    unsubscribeFromQuotes(rfqId: string): void;
+    /**
+     * Accept a quote and execute the option trade
+     *
+     * @param rfqId - RFQ ID
+     * @param quoteId - Quote to accept
+     * @param wallet - Solana wallet for signing
+     * @returns Transaction signature
+     */
+    executeOption(rfqId: string, quoteId: string, wallet: {
+        signTransaction: (tx: Transaction) => Promise<Transaction>;
+    }): Promise<string>;
+    /**
+     * Cancel an open RFQ
+     *
+     * @param rfqId - RFQ to cancel
+     */
+    cancelRFQ(rfqId: string): Promise<void>;
+    /**
+     * Get an active RFQ by ID
+     *
+     * @param rfqId - RFQ ID
+     * @returns RFQ or undefined
+     */
+    getRFQ(rfqId: string): RFQ | undefined;
+    /**
+     * Get all active RFQs
+     */
+    getAllRFQs(): RFQ[];
+    /**
+     * Subscribe to all RFQ events
+     *
+     * @param callback - Called for each event
+     * @returns Unsubscribe function
+     */
+    onEvent(callback: (event: RFQEvent) => void): () => void;
+    private handleMessage;
+    private emitEvent;
+    private validateRFQParams;
+    private generateRFQId;
+    private buildExecutionTransaction;
+    private attemptReconnect;
+}
+
+/**
+ * Transaction builders for vault program instructions.
+ *
+ * @example
+ * ```typescript
+ * import { VaultInstructions, deriveVaultPda } from '@optionsfi/sdk';
+ * import { Connection, PublicKey } from '@solana/web3.js';
+ *
+ * const connection = new Connection('https://api.devnet.solana.com');
+ * const vaultInstructions = new VaultInstructions(connection);
+ * await vaultInstructions.initialize();
+ *
+ * // Fetch vault data
+ * const vault = await vaultInstructions.fetchVault('NVDAX');
+ * console.log('Total assets:', vault.totalAssets);
+ *
+ * // Build a transaction instruction
+ * const ix = await vaultInstructions.recordNotionalExposure({
+ *   vault: vaultPda,
+ *   authority: walletPublicKey,
+ *   notionalTokens: BigInt(1000 * 1e6),
+ *   premium: BigInt(50 * 1e6),
+ * });
+ * ```
+ */
+
+/**
+ * Client for building vault program instructions
+ */
+declare class VaultInstructions {
+    private connection;
+    private program;
+    private idl;
+    /**
+     * Create a new VaultInstructions client
+     *
+     * @param connection - Solana connection
+     * @param idl - Optional IDL (uses bundled vault IDL by default)
+     */
+    constructor(connection: Connection, idl?: any);
+    /**
+     * Initialize the Anchor program interface
+     *
+     * @param wallet - Optional wallet for signing (not required for instruction building)
+     */
+    initialize(wallet?: anchor.Wallet): Promise<void>;
+    /**
+     * Set the program IDL
+     *
+     * @param idl - Vault program IDL
+     */
+    setIDL(idl: any): void;
+    /**
+     * Check if the client is initialized
+     */
+    get isInitialized(): boolean;
+    /**
+     * Fetch vault account data
+     *
+     * @param assetId - Asset identifier (e.g., "NVDAX")
+     * @returns Vault data or null if not found
+     */
+    fetchVault(assetId: string): Promise<VaultData | null>;
+    /**
+     * Build instruction to record notional exposure after RFQ execution
+     *
+     * @param params - Exposure parameters
+     * @returns TransactionInstruction
+     */
+    recordNotionalExposure(params: RecordExposureParams): Promise<TransactionInstruction>;
+    /**
+     * Build instruction to collect premium from market maker
+     *
+     * @param params - Collection parameters
+     * @returns TransactionInstruction
+     */
+    collectPremium(params: CollectPremiumParams): Promise<TransactionInstruction>;
+    /**
+     * Build instruction to pay settlement to market maker
+     *
+     * @param params - Settlement parameters
+     * @returns TransactionInstruction
+     */
+    paySettlement(params: PaySettlementParams): Promise<TransactionInstruction>;
+    /**
+     * Build instruction to advance epoch
+     *
+     * @param params - Advance epoch parameters
+     * @returns TransactionInstruction
+     */
+    advanceEpoch(params: AdvanceEpochParams): Promise<TransactionInstruction>;
+    /**
+     * Calculate share price from vault data
+     *
+     * @param vault - Vault data
+     * @param decimals - Token decimals (default: 6)
+     * @returns Share price as a number
+     */
+    static calculateSharePrice(vault: VaultData, decimals?: number): number;
+    /**
+     * Calculate utilization percentage from vault data
+     *
+     * @param vault - Vault data
+     * @returns Utilization as decimal (0-1)
+     */
+    static calculateUtilization(vault: VaultData): number;
+    /**
+     * Check if vault can accept more exposure
+     *
+     * @param vault - Vault data
+     * @param additionalNotional - Additional notional to expose
+     * @returns Whether the vault can accept the exposure
+     */
+    static canAcceptExposure(vault: VaultData, additionalNotional: bigint): boolean;
+    /**
+     * Calculate remaining capacity for option writing
+     *
+     * @param vault - Vault data
+     * @returns Remaining notional capacity
+     */
+    static getRemainingCapacity(vault: VaultData): bigint;
+}
+
+/**
+ * Black-Scholes option pricing and volatility calculations.
+ *
+ * @example
+ * ```typescript
+ * import { OptionPricing } from '@optionsfi/sdk';
+ *
+ * const price = OptionPricing.blackScholes({
+ *   spot: 145.50,
+ *   strike: 150,
+ *   timeToExpiry: 7 / 365,
+ *   riskFreeRate: 0.05,
+ *   volatility: 0.45,
+ * });
+ *
+ * console.log('Call price:', price.call);
+ * console.log('Put price:', price.put);
+ * console.log('Call delta:', price.delta.call);
+ * ```
+ */
+
+/**
+ * Option pricing utilities using Black-Scholes model
+ */
+declare class OptionPricing {
+    /**
+     * Calculate option prices using Black-Scholes formula
+     *
+     * @param params - Pricing parameters
+     * @returns Call and put prices with deltas
+     */
+    static blackScholes(params: BlackScholesParams): OptionPrices;
+    /**
+     * Calculate covered call premium
+     *
+     * @param params - Premium calculation parameters
+     * @returns Premium in same units as spot price
+     */
+    static calculateCoveredCallPremium(params: PremiumParams): number;
+    /**
+     * Calculate premium as basis points of notional
+     *
+     * @param premium - Premium amount
+     * @param spot - Spot price
+     * @returns Premium in basis points
+     */
+    static premiumToBps(premium: number, spot: number): number;
+    /**
+     * Convert basis points to premium
+     *
+     * @param bps - Basis points
+     * @param spot - Spot price
+     * @returns Premium amount
+     */
+    static bpsToPremium(bps: number, spot: number): number;
+    /**
+     * Calculate time to expiry in years
+     *
+     * @param expiryTimestamp - Expiry Unix timestamp (seconds)
+     * @returns Time in years
+     */
+    static timeToExpiry(expiryTimestamp: number): number;
+    /**
+     * Suggest a strike price based on delta target
+     *
+     * @param spotPrice - Current spot price
+     * @param deltaBps - Delta in basis points (e.g., 1000 = 10% OTM)
+     * @param optionType - 'call' or 'put'
+     * @returns Suggested strike price
+     */
+    static suggestStrike(spotPrice: number, deltaBps: number, optionType?: 'call' | 'put'): number;
+    /**
+     * Validate a quote against fair value
+     *
+     * @param quotePremium - Premium from quote
+     * @param fairValue - Calculated fair value
+     * @param maxDeviationBps - Maximum acceptable deviation in bps (default: 500)
+     * @returns Validation result
+     */
+    static validateQuote(quotePremium: number, fairValue: number, maxDeviationBps?: number): QuoteValidation;
+    /**
+     * Calculate historical volatility from price data
+     *
+     * @param prices - Array of closing prices (oldest first)
+     * @param tradingDaysPerYear - Trading days for annualization (default: 252)
+     * @returns Annualized volatility
+     */
+    static calculateHistoricalVolatility(prices: number[], tradingDaysPerYear?: number): number;
+    /**
+     * Calculate implied volatility from option price using Newton-Raphson
+     *
+     * @param optionPrice - Market price of option
+     * @param spot - Spot price
+     * @param strike - Strike price
+     * @param timeToExpiry - Time to expiry in years
+     * @param riskFreeRate - Risk-free rate
+     * @param optionType - 'call' or 'put'
+     * @param maxIterations - Maximum iterations (default: 100)
+     * @returns Implied volatility
+     */
+    static calculateImpliedVolatility(optionPrice: number, spot: number, strike: number, timeToExpiry: number, riskFreeRate: number, optionType: 'call' | 'put', maxIterations?: number): number;
+    /**
+     * Standard normal CDF using Abramowitz & Stegun approximation
+     */
+    private static normalCDF;
+    /**
+     * Standard normal PDF
+     */
+    private static normalPDF;
+}
+
+/**
+ * Input validation utilities with type checking.
+ */
+
+/**
+ * Validation error with detailed message
+ */
+declare class ValidationError extends Error {
+    readonly field: string;
+    constructor(field: string, message: string);
+}
+/**
+ * Validate RFQ parameters
+ *
+ * @param params - RFQ parameters to validate
+ * @throws ValidationError if any parameter is invalid
+ */
+declare function validateRFQParams(params: RFQParams): void;
+/**
+ * Validate Black-Scholes parameters
+ *
+ * @param params - Black-Scholes parameters to validate
+ * @throws ValidationError if any parameter is invalid
+ */
+declare function validateBlackScholesParams(params: BlackScholesParams): void;
+/**
+ * Validate a Solana public key string
+ *
+ * @param address - Address string to validate
+ * @param fieldName - Field name for error messages
+ * @throws ValidationError if address is invalid
+ */
+declare function validatePublicKey(address: string, fieldName?: string): void;
+/**
+ * Validate that an amount is a valid token amount
+ *
+ * @param amount - Amount to validate
+ * @param fieldName - Field name for error messages
+ * @param decimals - Token decimals (default: 6)
+ * @throws ValidationError if amount is invalid
+ */
+declare function validateTokenAmount(amount: bigint, fieldName?: string, decimals?: number): void;
+/**
+ * Validate a Unix timestamp
+ *
+ * @param timestamp - Timestamp to validate (seconds)
+ * @param fieldName - Field name for error messages
+ * @param options - Validation options
+ * @throws ValidationError if timestamp is invalid
+ */
+declare function validateTimestamp(timestamp: number, fieldName?: string, options?: {
+    mustBeFuture?: boolean;
+    maxFutureDays?: number;
+}): void;
+
+/**
+ * Token amount and price formatting utilities.
+ */
+/**
+ * Format a token amount from smallest unit to human-readable string
+ *
+ * @param amount - Amount in smallest unit (e.g., lamports)
+ * @param decimals - Token decimals
+ * @param maxDecimals - Maximum decimals to display (default: 2)
+ * @returns Formatted string
+ *
+ * @example
+ * formatTokenAmount(1500000n, 6); // "1.50"
+ * formatTokenAmount(1234567890n, 9); // "1.23"
+ */
+declare function formatTokenAmount(amount: bigint, decimals: number, maxDecimals?: number): string;
+/**
+ * Parse a human-readable token amount to smallest unit
+ *
+ * @param amount - Human-readable amount (e.g., "1.5")
+ * @param decimals - Token decimals
+ * @returns Amount in smallest unit
+ *
+ * @example
+ * parseTokenAmount("1.5", 6); // 1500000n
+ * parseTokenAmount("100", 6); // 100000000n
+ */
+declare function parseTokenAmount(amount: string, decimals: number): bigint;
+/**
+ * Format USDC amount (6 decimals)
+ */
+declare function formatUSDC(amount: bigint, maxDecimals?: number): string;
+/**
+ * Parse USDC amount to smallest unit
+ */
+declare function parseUSDC(amount: string): bigint;
+/**
+ * Format a price in USD with appropriate precision
+ *
+ * @param price - Price as number
+ * @param decimals - Decimal places (default: 2)
+ * @returns Formatted price string
+ */
+declare function formatPrice(price: number, decimals?: number): string;
+/**
+ * Format a percentage
+ *
+ * @param value - Decimal value (e.g., 0.15 for 15%)
+ * @param decimals - Decimal places (default: 2)
+ * @returns Formatted percentage string
+ */
+declare function formatPercent(value: number, decimals?: number): string;
+/**
+ * Format basis points
+ *
+ * @param bps - Basis points value
+ * @returns Formatted string with "bps" suffix
+ */
+declare function formatBps(bps: number): string;
+/**
+ * Convert basis points to percentage
+ */
+declare function bpsToPercent(bps: number): number;
+/**
+ * Convert percentage to basis points
+ */
+declare function percentToBps(percent: number): number;
+/**
+ * Format a Unix timestamp to ISO date string
+ *
+ * @param timestamp - Unix timestamp (seconds)
+ * @returns ISO date string
+ */
+declare function formatTimestamp(timestamp: number): string;
+/**
+ * Format a Unix timestamp to human-readable date
+ *
+ * @param timestamp - Unix timestamp (seconds)
+ * @param options - Intl.DateTimeFormat options
+ * @returns Localized date string
+ */
+declare function formatDate(timestamp: number, options?: Intl.DateTimeFormatOptions): string;
+/**
+ * Format time until expiry
+ *
+ * @param expiryTimestamp - Expiry Unix timestamp (seconds)
+ * @returns Human-readable duration string
+ */
+declare function formatTimeToExpiry(expiryTimestamp: number): string;
+/**
+ * Shorten a public key for display
+ *
+ * @param address - Full public key string
+ * @param chars - Characters to show on each end (default: 4)
+ * @returns Shortened address (e.g., "ABCD...WXYZ")
+ */
+declare function shortenAddress(address: string, chars?: number): string;
+/**
+ * Format an RFQ ID for display
+ *
+ * @param rfqId - Full RFQ ID
+ * @returns Shortened ID
+ */
+declare function formatRFQId(rfqId: string): string;
+
+/**
+ * Program addresses and mint constants.
+ */
+
+/**
+ * OptionsFi Vault Program ID (mainnet/devnet)
+ */
+declare const VAULT_PROGRAM_ID: PublicKey;
+/**
+ * USDC mint address (devnet)
+ *
+ * Note: This is the official Circle USDC devnet mint.
+ * For mainnet, use: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
+ */
+declare const DEVNET_USDC_MINT: PublicKey;
+/**
+ * USDC mint address (mainnet)
+ */
+declare const MAINNET_USDC_MINT: PublicKey;
+/**
+ * Pyth Price Feed IDs (Hermes API)
+ */
+declare const PYTH_PRICE_FEEDS: {
+    /** NVDA/USD price feed */
+    readonly NVDA: "0x4244d07890e4610f46bbde67de8f43a4bf8b569eebe904f136b469f148503b7f";
+    /** SOL/USD price feed */
+    readonly SOL: "0xef0d8b6fda2ceba41da15d4095d1da392a0d2f8ed0c6c7bc0f4cfac8c280b56d";
+    /** BTC/USD price feed */
+    readonly BTC: "0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43";
+    /** ETH/USD price feed */
+    readonly ETH: "0xff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace";
+};
+/**
+ * Pyth Hermes API URL
+ */
+declare const PYTH_HERMES_URL = "https://hermes.pyth.network";
+/**
+ * Derive vault PDA from asset ID
+ */
+declare function deriveVaultPda(assetId: string): [PublicKey, number];
+/**
+ * Derive withdrawal request PDA
+ */
+declare function deriveWithdrawalPda(vault: PublicKey, user: PublicKey, epoch: bigint): [PublicKey, number];
+/**
+ * Derive share escrow PDA
+ */
+declare function deriveShareEscrowPda(vault: PublicKey): [PublicKey, number];
+/**
+ * Derive whitelist PDA
+ */
+declare function deriveWhitelistPda(vault: PublicKey): [PublicKey, number];
+
+/**
+ * Default configuration for devnet and mainnet.
+ */
+
+/**
+ * Default configuration for devnet
+ */
+declare const DEVNET_CONFIG: RFQConfig;
+/**
+ * Default configuration for mainnet
+ */
+declare const MAINNET_CONFIG: RFQConfig;
+/**
+ * Default option pricing parameters
+ */
+declare const DEFAULT_PRICING_PARAMS: {
+    /** Default risk-free rate (5%) */
+    riskFreeRate: number;
+    /** Default volatility lookback period in days */
+    volatilityLookbackDays: number;
+    /** Maximum acceptable deviation from fair value (5%) */
+    maxQuoteDeviationBps: number;
+    /** Trading days per year for volatility annualization */
+    tradingDaysPerYear: number;
+};
+/**
+ * RFQ timing defaults
+ */
+declare const RFQ_DEFAULTS: {
+    /** Default RFQ timeout in milliseconds */
+    timeoutMs: number;
+    /** Minimum quote collection time */
+    minQuoteTimeMs: number;
+    /** Quote expiry buffer (how long before expiry to stop accepting) */
+    quoteExpiryBufferMs: number;
+};
+/**
+ * Token decimals for common tokens.
+ *
+ * Note: NVDAX is shown as an example tokenized stock with 6 decimals.
+ * Add your own token configurations as needed.
+ */
+declare const TOKEN_DECIMALS: {
+    readonly USDC: 6;
+    readonly SOL: 9;
+    readonly NVDAX: 6;
+};
+
+var address = "A4jgqct3bwTwRmHECHdPpbH3a8ksaVb7rny9pMUGFo94";
+var metadata = {
+	name: "vault",
+	version: "0.1.0",
+	spec: "0.1.0",
+	description: "OptionsFi V2 - Covered Call Vault"
+};
+var instructions = [
+	{
+		name: "add_market_maker",
+		docs: [
+			"Add a market maker to the whitelist"
+		],
+		discriminator: [
+			24,
+			255,
+			135,
+			32,
+			193,
+			2,
+			112,
+			44
+		],
+		accounts: [
+			{
+				name: "vault",
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				},
+				relations: [
+					"whitelist"
+				]
+			},
+			{
+				name: "whitelist",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								119,
+								104,
+								105,
+								116,
+								101,
+								108,
+								105,
+								115,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				writable: true,
+				signer: true,
+				relations: [
+					"vault",
+					"whitelist"
+				]
+			}
+		],
+		args: [
+			{
+				name: "market_maker",
+				type: "pubkey"
+			}
+		]
+	},
+	{
+		name: "advance_epoch",
+		docs: [
+			"Advance epoch (called by keeper after settlement)",
+			"Premium earned is credited to total_assets, increasing share value"
+		],
+		discriminator: [
+			93,
+			138,
+			234,
+			218,
+			241,
+			230,
+			132,
+			38
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				signer: true,
+				relations: [
+					"vault"
+				]
+			}
+		],
+		args: [
+			{
+				name: "premium_earned",
+				type: "u64"
+			}
+		]
+	},
+	{
+		name: "cancel_param_change",
+		docs: [
+			"Cancel a queued parameter change"
+		],
+		discriminator: [
+			150,
+			147,
+			92,
+			108,
+			72,
+			160,
+			224,
+			55
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				signer: true,
+				relations: [
+					"vault"
+				]
+			}
+		],
+		args: [
+		]
+	},
+	{
+		name: "close_orphaned_token_account",
+		docs: [
+			"Close an orphaned token account that was owned by a vault PDA",
+			"This is used to clean up old share escrows, vault token accounts, etc.",
+			"after a vault has been force-closed, enabling reuse of asset IDs.",
+			"",
+			"The caller must provide the correct asset_id that was used to derive the vault PDA.",
+			"The vault PDA must NOT exist anymore (force-closed)."
+		],
+		discriminator: [
+			232,
+			127,
+			173,
+			13,
+			92,
+			144,
+			116,
+			98
+		],
+		accounts: [
+			{
+				name: "vault_pda",
+				docs: [
+					"We verify this matches the derived PDA in the instruction"
+				],
+				writable: true
+			},
+			{
+				name: "token_account",
+				docs: [
+					"The token account to close (share escrow, vault token account, etc.)"
+				],
+				writable: true
+			},
+			{
+				name: "authority",
+				docs: [
+					"Authority receiving the lamports"
+				],
+				writable: true,
+				signer: true
+			},
+			{
+				name: "token_program",
+				address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+			}
+		],
+		args: [
+			{
+				name: "asset_id",
+				type: "string"
+			}
+		]
+	},
+	{
+		name: "close_vault",
+		docs: [
+			"Close a vault and recover rent (authority only)",
+			"Vault must be empty (no assets, shares, or pending withdrawals)"
+		],
+		discriminator: [
+			141,
+			103,
+			17,
+			126,
+			72,
+			75,
+			29,
+			29
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				writable: true,
+				signer: true,
+				relations: [
+					"vault"
+				]
+			}
+		],
+		args: [
+		]
+	},
+	{
+		name: "collect_premium",
+		docs: [
+			"Collect premium from market maker (called during epoch roll)",
+			"Transfers USDC from payer to vault's premium account",
+			"SECURITY FIX M-1: Now requires authority signature to prevent front-running"
+		],
+		discriminator: [
+			166,
+			199,
+			123,
+			128,
+			71,
+			141,
+			223,
+			204
+		],
+		accounts: [
+			{
+				name: "vault",
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "vault_premium_account",
+				writable: true
+			},
+			{
+				name: "payer_token_account",
+				writable: true
+			},
+			{
+				name: "payer",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "authority",
+				docs: [
+					"SECURITY FIX M-1: Authority must sign to prevent front-running premium collection"
+				],
+				signer: true,
+				relations: [
+					"vault"
+				]
+			},
+			{
+				name: "token_program",
+				address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+			}
+		],
+		args: [
+			{
+				name: "amount",
+				type: "u64"
+			}
+		]
+	},
+	{
+		name: "create_share_metadata",
+		docs: [
+			"Create metadata for the share token (vNVDAx, etc.)",
+			"Only callable by vault authority since vault PDA is the mint authority"
+		],
+		discriminator: [
+			176,
+			243,
+			233,
+			202,
+			218,
+			168,
+			53,
+			158
+		],
+		accounts: [
+			{
+				name: "vault",
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "share_mint",
+				relations: [
+					"vault"
+				]
+			},
+			{
+				name: "metadata",
+				writable: true
+			},
+			{
+				name: "payer",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "authority",
+				signer: true,
+				relations: [
+					"vault"
+				]
+			},
+			{
+				name: "system_program",
+				address: "11111111111111111111111111111111"
+			},
+			{
+				name: "rent",
+				address: "SysvarRent111111111111111111111111111111111"
+			},
+			{
+				name: "token_metadata_program",
+				address: "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s"
+			}
+		],
+		args: [
+			{
+				name: "name",
+				type: "string"
+			},
+			{
+				name: "symbol",
+				type: "string"
+			},
+			{
+				name: "uri",
+				type: "string"
+			}
+		]
+	},
+	{
+		name: "deposit",
+		docs: [
+			"Deposit underlying tokens and receive vault shares"
+		],
+		discriminator: [
+			242,
+			35,
+			198,
+			137,
+			82,
+			225,
+			242,
+			182
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "share_mint",
+				writable: true
+			},
+			{
+				name: "vault_token_account",
+				writable: true
+			},
+			{
+				name: "user_token_account",
+				writable: true
+			},
+			{
+				name: "user_share_account",
+				writable: true
+			},
+			{
+				name: "share_escrow",
+				writable: true
+			},
+			{
+				name: "user",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "token_program",
+				address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+			}
+		],
+		args: [
+			{
+				name: "amount",
+				type: "u64"
+			}
+		]
+	},
+	{
+		name: "execute_param_change",
+		docs: [
+			"SECURITY FIX M-3: Execute queued parameter changes after timelock"
+		],
+		discriminator: [
+			162,
+			166,
+			56,
+			243,
+			168,
+			135,
+			66,
+			175
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				signer: true,
+				relations: [
+					"vault"
+				]
+			}
+		],
+		args: [
+		]
+	},
+	{
+		name: "force_close_vault",
+		docs: [
+			"Force close a vault account (bypasses deserialization)",
+			"USE WITH CAUTION: Only for recovering from incompatible account structures",
+			"SECURITY FIX C-2: Now verifies caller is the stored vault authority"
+		],
+		discriminator: [
+			229,
+			45,
+			206,
+			4,
+			96,
+			129,
+			140,
+			24
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true
+			},
+			{
+				name: "authority",
+				writable: true,
+				signer: true
+			}
+		],
+		args: [
+			{
+				name: "asset_id",
+				type: "string"
+			}
+		]
+	},
+	{
+		name: "initialize_vault",
+		docs: [
+			"Initialize a new vault for a specific xStock asset"
+		],
+		discriminator: [
+			48,
+			191,
+			163,
+			44,
+			71,
+			129,
+			63,
+			164
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "arg",
+							path: "asset_id"
+						}
+					]
+				}
+			},
+			{
+				name: "underlying_mint"
+			},
+			{
+				name: "premium_mint"
+			},
+			{
+				name: "share_mint",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "vault_token_account",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "premium_token_account",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "share_escrow",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								115,
+								104,
+								97,
+								114,
+								101,
+								95,
+								101,
+								115,
+								99,
+								114,
+								111,
+								119
+							]
+						},
+						{
+							kind: "account",
+							path: "vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "system_program",
+				address: "11111111111111111111111111111111"
+			},
+			{
+				name: "token_program",
+				address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+			},
+			{
+				name: "rent",
+				address: "SysvarRent111111111111111111111111111111111"
+			}
+		],
+		args: [
+			{
+				name: "asset_id",
+				type: "string"
+			},
+			{
+				name: "utilization_cap_bps",
+				type: "u16"
+			},
+			{
+				name: "min_epoch_duration",
+				type: "i64"
+			}
+		]
+	},
+	{
+		name: "initialize_whitelist",
+		docs: [
+			"Initialize the market maker whitelist"
+		],
+		discriminator: [
+			223,
+			228,
+			11,
+			219,
+			112,
+			174,
+			108,
+			18
+		],
+		accounts: [
+			{
+				name: "vault",
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "whitelist",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								119,
+								104,
+								105,
+								116,
+								101,
+								108,
+								105,
+								115,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				writable: true,
+				signer: true,
+				relations: [
+					"vault"
+				]
+			},
+			{
+				name: "system_program",
+				address: "11111111111111111111111111111111"
+			}
+		],
+		args: [
+		]
+	},
+	{
+		name: "pay_settlement",
+		docs: [
+			"Pay out to market maker for ITM settlement",
+			"Only callable by vault authority",
+			"SECURITY: Settlement capped at epoch premium earned"
+		],
+		discriminator: [
+			65,
+			54,
+			44,
+			166,
+			205,
+			55,
+			164,
+			205
+		],
+		accounts: [
+			{
+				name: "vault",
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				},
+				relations: [
+					"whitelist"
+				]
+			},
+			{
+				name: "whitelist",
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								119,
+								104,
+								105,
+								116,
+								101,
+								108,
+								105,
+								115,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault"
+						}
+					]
+				}
+			},
+			{
+				name: "vault_premium_account",
+				writable: true
+			},
+			{
+				name: "recipient_token_account",
+				writable: true
+			},
+			{
+				name: "recipient"
+			},
+			{
+				name: "authority",
+				signer: true,
+				relations: [
+					"vault"
+				]
+			},
+			{
+				name: "token_program",
+				address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+			}
+		],
+		args: [
+			{
+				name: "amount",
+				type: "u64"
+			}
+		]
+	},
+	{
+		name: "process_withdrawal",
+		docs: [
+			"Process withdrawal after epoch settles",
+			"SECURITY FIX H-3: Added min_expected_amount for slippage protection"
+		],
+		discriminator: [
+			51,
+			97,
+			236,
+			17,
+			37,
+			33,
+			196,
+			64
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				},
+				relations: [
+					"withdrawal_request"
+				]
+			},
+			{
+				name: "withdrawal_request",
+				writable: true
+			},
+			{
+				name: "share_mint",
+				writable: true
+			},
+			{
+				name: "vault_token_account",
+				writable: true
+			},
+			{
+				name: "user_token_account",
+				writable: true
+			},
+			{
+				name: "share_escrow",
+				writable: true
+			},
+			{
+				name: "vault_premium_account",
+				writable: true
+			},
+			{
+				name: "user_premium_account",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "account",
+							path: "user"
+						},
+						{
+							kind: "const",
+							value: [
+								6,
+								221,
+								246,
+								225,
+								215,
+								101,
+								161,
+								147,
+								217,
+								203,
+								225,
+								70,
+								206,
+								235,
+								121,
+								172,
+								28,
+								180,
+								133,
+								237,
+								95,
+								91,
+								55,
+								145,
+								58,
+								140,
+								245,
+								133,
+								126,
+								255,
+								0,
+								169
+							]
+						},
+						{
+							kind: "account",
+							path: "premium_mint"
+						}
+					],
+					program: {
+						kind: "const",
+						value: [
+							140,
+							151,
+							37,
+							143,
+							78,
+							36,
+							137,
+							241,
+							187,
+							61,
+							16,
+							41,
+							20,
+							142,
+							13,
+							131,
+							11,
+							90,
+							19,
+							153,
+							218,
+							255,
+							16,
+							132,
+							4,
+							142,
+							123,
+							216,
+							219,
+							233,
+							248,
+							89
+						]
+					}
+				}
+			},
+			{
+				name: "premium_mint"
+			},
+			{
+				name: "user",
+				writable: true,
+				signer: true,
+				relations: [
+					"withdrawal_request"
+				]
+			},
+			{
+				name: "token_program",
+				address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+			},
+			{
+				name: "associated_token_program",
+				address: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
+			},
+			{
+				name: "system_program",
+				address: "11111111111111111111111111111111"
+			}
+		],
+		args: [
+			{
+				name: "min_expected_amount",
+				type: "u64"
+			}
+		]
+	},
+	{
+		name: "queue_param_change",
+		docs: [
+			"SECURITY FIX M-3: Queue a parameter change with timelock",
+			"Changes take effect after TIMELOCK_DURATION (24 hours)"
+		],
+		discriminator: [
+			140,
+			242,
+			124,
+			63,
+			143,
+			237,
+			195,
+			231
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				signer: true,
+				relations: [
+					"vault"
+				]
+			}
+		],
+		args: [
+			{
+				name: "new_min_epoch_duration",
+				type: {
+					option: "i64"
+				}
+			},
+			{
+				name: "new_utilization_cap_bps",
+				type: {
+					option: "u16"
+				}
+			}
+		]
+	},
+	{
+		name: "record_notional_exposure",
+		docs: [
+			"Record notional exposure when an RFQ is filled (fractional options)",
+			"Premium is in premium_mint tokens (USDC)"
+		],
+		discriminator: [
+			26,
+			180,
+			108,
+			160,
+			15,
+			34,
+			179,
+			128
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				signer: true,
+				relations: [
+					"vault"
+				]
+			}
+		],
+		args: [
+			{
+				name: "notional_tokens",
+				type: "u64"
+			},
+			{
+				name: "premium",
+				type: "u64"
+			}
+		]
+	},
+	{
+		name: "remove_market_maker",
+		docs: [
+			"SECURITY FIX M-4: Remove a market maker from the whitelist"
+		],
+		discriminator: [
+			101,
+			241,
+			39,
+			132,
+			210,
+			208,
+			183,
+			254
+		],
+		accounts: [
+			{
+				name: "vault",
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				},
+				relations: [
+					"whitelist"
+				]
+			},
+			{
+				name: "whitelist",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								119,
+								104,
+								105,
+								116,
+								101,
+								108,
+								105,
+								115,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				writable: true,
+				signer: true,
+				relations: [
+					"vault",
+					"whitelist"
+				]
+			}
+		],
+		args: [
+			{
+				name: "market_maker",
+				type: "pubkey"
+			}
+		]
+	},
+	{
+		name: "request_withdrawal",
+		docs: [
+			"Request withdrawal (queued until epoch end)"
+		],
+		discriminator: [
+			251,
+			85,
+			121,
+			205,
+			56,
+			201,
+			12,
+			177
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "withdrawal_request",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								119,
+								105,
+								116,
+								104,
+								100,
+								114,
+								97,
+								119,
+								97,
+								108
+							]
+						},
+						{
+							kind: "account",
+							path: "vault"
+						},
+						{
+							kind: "account",
+							path: "user"
+						},
+						{
+							kind: "account",
+							path: "vault.epoch",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "share_escrow",
+				writable: true
+			},
+			{
+				name: "user_share_account",
+				writable: true
+			},
+			{
+				name: "user",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "system_program",
+				address: "11111111111111111111111111111111"
+			},
+			{
+				name: "token_program",
+				address: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+			}
+		],
+		args: [
+			{
+				name: "shares",
+				type: "u64"
+			}
+		]
+	},
+	{
+		name: "set_min_epoch_duration",
+		docs: [
+			"DEPRECATED: Direct parameter changes now require timelock",
+			"Kept for backwards compatibility but will fail"
+		],
+		discriminator: [
+			172,
+			45,
+			116,
+			18,
+			195,
+			137,
+			80,
+			225
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				signer: true,
+				relations: [
+					"vault"
+				]
+			}
+		],
+		args: [
+			{
+				name: "_duration",
+				type: "i64"
+			}
+		]
+	},
+	{
+		name: "set_pause",
+		docs: [
+			"SECURITY: Pause or unpause the vault (emergency control)",
+			"When paused, deposits and withdrawal requests are blocked"
+		],
+		discriminator: [
+			63,
+			32,
+			154,
+			2,
+			56,
+			103,
+			79,
+			45
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				signer: true,
+				relations: [
+					"vault"
+				]
+			}
+		],
+		args: [
+			{
+				name: "paused",
+				type: "bool"
+			}
+		]
+	},
+	{
+		name: "set_utilization_cap",
+		docs: [
+			"DEPRECATED: Direct parameter changes now require timelock",
+			"Kept for backwards compatibility but will fail"
+		],
+		discriminator: [
+			54,
+			143,
+			110,
+			156,
+			48,
+			172,
+			7,
+			64
+		],
+		accounts: [
+			{
+				name: "vault",
+				writable: true,
+				pda: {
+					seeds: [
+						{
+							kind: "const",
+							value: [
+								118,
+								97,
+								117,
+								108,
+								116
+							]
+						},
+						{
+							kind: "account",
+							path: "vault.asset_id",
+							account: "Vault"
+						}
+					]
+				}
+			},
+			{
+				name: "authority",
+				signer: true,
+				relations: [
+					"vault"
+				]
+			}
+		],
+		args: [
+			{
+				name: "_cap_bps",
+				type: "u16"
+			}
+		]
+	}
+];
+var accounts = [
+	{
+		name: "Vault",
+		discriminator: [
+			211,
+			8,
+			232,
+			43,
+			2,
+			152,
+			117,
+			119
+		]
+	},
+	{
+		name: "VaultWhitelist",
+		discriminator: [
+			82,
+			19,
+			233,
+			96,
+			174,
+			0,
+			57,
+			17
+		]
+	},
+	{
+		name: "WithdrawalRequest",
+		discriminator: [
+			242,
+			88,
+			147,
+			173,
+			182,
+			62,
+			229,
+			193
+		]
+	}
+];
+var events = [
+	{
+		name: "DepositEvent",
+		discriminator: [
+			120,
+			248,
+			61,
+			83,
+			31,
+			142,
+			107,
+			144
+		]
+	},
+	{
+		name: "EpochAdvancedEvent",
+		discriminator: [
+			26,
+			197,
+			195,
+			116,
+			126,
+			48,
+			210,
+			42
+		]
+	},
+	{
+		name: "MarketMakerRemovedEvent",
+		discriminator: [
+			238,
+			48,
+			105,
+			84,
+			228,
+			245,
+			204,
+			75
+		]
+	},
+	{
+		name: "NotionalExposureEvent",
+		discriminator: [
+			220,
+			74,
+			165,
+			136,
+			237,
+			183,
+			23,
+			38
+		]
+	},
+	{
+		name: "ParamChangeExecutedEvent",
+		discriminator: [
+			208,
+			23,
+			211,
+			151,
+			8,
+			56,
+			124,
+			26
+		]
+	},
+	{
+		name: "ParamChangeQueuedEvent",
+		discriminator: [
+			44,
+			143,
+			34,
+			222,
+			153,
+			125,
+			73,
+			23
+		]
+	},
+	{
+		name: "PremiumCollectedEvent",
+		discriminator: [
+			76,
+			52,
+			166,
+			111,
+			182,
+			211,
+			215,
+			144
+		]
+	},
+	{
+		name: "SettlementPaidEvent",
+		discriminator: [
+			97,
+			3,
+			234,
+			177,
+			141,
+			83,
+			59,
+			26
+		]
+	},
+	{
+		name: "VaultPausedEvent",
+		discriminator: [
+			75,
+			189,
+			120,
+			167,
+			117,
+			229,
+			155,
+			60
+		]
+	},
+	{
+		name: "WithdrawalProcessedEvent",
+		discriminator: [
+			23,
+			252,
+			30,
+			4,
+			24,
+			110,
+			166,
+			133
+		]
+	},
+	{
+		name: "WithdrawalRequestedEvent",
+		discriminator: [
+			82,
+			227,
+			155,
+			140,
+			223,
+			124,
+			77,
+			243
+		]
+	}
+];
+var errors = [
+	{
+		code: 6000,
+		name: "ZeroAmount",
+		msg: "Amount must be greater than zero"
+	},
+	{
+		code: 6001,
+		name: "ZeroShares",
+		msg: "Calculated shares must be greater than zero"
+	},
+	{
+		code: 6002,
+		name: "InsufficientShares",
+		msg: "Insufficient shares"
+	},
+	{
+		code: 6003,
+		name: "AlreadyProcessed",
+		msg: "Withdrawal already processed"
+	},
+	{
+		code: 6004,
+		name: "EpochNotSettled",
+		msg: "Epoch has not settled yet"
+	},
+	{
+		code: 6005,
+		name: "Overflow",
+		msg: "Arithmetic overflow"
+	},
+	{
+		code: 6006,
+		name: "ExceedsUtilizationCap",
+		msg: "Exceeds utilization cap"
+	},
+	{
+		code: 6007,
+		name: "NotWhitelisted",
+		msg: "Recipient is not whitelisted"
+	},
+	{
+		code: 6008,
+		name: "WhitelistFull",
+		msg: "Whitelist is full"
+	},
+	{
+		code: 6009,
+		name: "AlreadyWhitelisted",
+		msg: "Market maker already whitelisted"
+	},
+	{
+		code: 6010,
+		name: "InsufficientLiquidity",
+		msg: "Insufficient liquidity for first deposit"
+	},
+	{
+		code: 6011,
+		name: "EpochTooShort",
+		msg: "Epoch duration too short"
+	},
+	{
+		code: 6012,
+		name: "ExcessivePremium",
+		msg: "Premium exceeds safety limits"
+	},
+	{
+		code: 6013,
+		name: "ExcessiveYield",
+		msg: "Implied yield too high"
+	},
+	{
+		code: 6014,
+		name: "ExcessiveSettlement",
+		msg: "Settlement exceeds epoch premium earned"
+	},
+	{
+		code: 6015,
+		name: "InsufficientVaultBalance",
+		msg: "Insufficient vault balance for withdrawal"
+	},
+	{
+		code: 6016,
+		name: "VaultPaused",
+		msg: "Vault is paused"
+	},
+	{
+		code: 6017,
+		name: "VaultNotEmpty",
+		msg: "Vault must be empty to close"
+	},
+	{
+		code: 6018,
+		name: "InvalidVaultPda",
+		msg: "Invalid vault PDA"
+	},
+	{
+		code: 6019,
+		name: "SlippageExceeded",
+		msg: "Withdrawal amount below minimum expected (slippage protection)"
+	},
+	{
+		code: 6020,
+		name: "DivisionByZero",
+		msg: "Division by zero"
+	},
+	{
+		code: 6021,
+		name: "TimelockNotExpired",
+		msg: "Timelock has not expired yet"
+	},
+	{
+		code: 6022,
+		name: "UseTimelockForParamChange",
+		msg: "Direct param changes deprecated - use queue_param_change"
+	},
+	{
+		code: 6023,
+		name: "InvalidParameter",
+		msg: "Invalid parameter value"
+	},
+	{
+		code: 6024,
+		name: "UnauthorizedForceClose",
+		msg: "Caller is not the vault authority"
+	},
+	{
+		code: 6025,
+		name: "VaultStillExists",
+		msg: "Vault still exists - close it first before cleaning up token accounts"
+	}
+];
+var types = [
+	{
+		name: "DepositEvent",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "user",
+					type: "pubkey"
+				},
+				{
+					name: "amount",
+					type: "u64"
+				},
+				{
+					name: "shares_minted",
+					type: "u64"
+				},
+				{
+					name: "epoch",
+					type: "u64"
+				}
+			]
+		}
+	},
+	{
+		name: "EpochAdvancedEvent",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "new_epoch",
+					type: "u64"
+				},
+				{
+					name: "premium_earned",
+					type: "u64"
+				},
+				{
+					name: "notional_exposed",
+					type: "u64"
+				},
+				{
+					name: "avg_premium_bps",
+					type: "u32"
+				},
+				{
+					name: "total_assets",
+					type: "u64"
+				},
+				{
+					name: "total_shares",
+					type: "u64"
+				},
+				{
+					name: "premium_balance_usdc",
+					type: "u64"
+				}
+			]
+		}
+	},
+	{
+		name: "MarketMakerRemovedEvent",
+		docs: [
+			"SECURITY FIX M-4: Event emitted when a market maker is removed"
+		],
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "market_maker",
+					type: "pubkey"
+				}
+			]
+		}
+	},
+	{
+		name: "NotionalExposureEvent",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "epoch",
+					type: "u64"
+				},
+				{
+					name: "notional_tokens",
+					type: "u64"
+				},
+				{
+					name: "premium",
+					type: "u64"
+				},
+				{
+					name: "total_notional_this_epoch",
+					type: "u64"
+				},
+				{
+					name: "total_premium_this_epoch",
+					type: "u64"
+				},
+				{
+					name: "avg_premium_bps",
+					type: "u32"
+				}
+			]
+		}
+	},
+	{
+		name: "ParamChangeExecutedEvent",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "new_min_epoch_duration",
+					type: "i64"
+				},
+				{
+					name: "new_utilization_cap_bps",
+					type: "u16"
+				}
+			]
+		}
+	},
+	{
+		name: "ParamChangeQueuedEvent",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "new_min_epoch_duration",
+					type: {
+						option: "i64"
+					}
+				},
+				{
+					name: "new_utilization_cap_bps",
+					type: {
+						option: "u16"
+					}
+				},
+				{
+					name: "unlock_time",
+					type: "i64"
+				}
+			]
+		}
+	},
+	{
+		name: "PremiumCollectedEvent",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "payer",
+					type: "pubkey"
+				},
+				{
+					name: "amount",
+					type: "u64"
+				},
+				{
+					name: "epoch",
+					type: "u64"
+				}
+			]
+		}
+	},
+	{
+		name: "SettlementPaidEvent",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "recipient",
+					type: "pubkey"
+				},
+				{
+					name: "amount",
+					type: "u64"
+				},
+				{
+					name: "epoch",
+					type: "u64"
+				}
+			]
+		}
+	},
+	{
+		name: "Vault",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "authority",
+					type: "pubkey"
+				},
+				{
+					name: "asset_id",
+					type: "string"
+				},
+				{
+					name: "underlying_mint",
+					type: "pubkey"
+				},
+				{
+					name: "share_mint",
+					type: "pubkey"
+				},
+				{
+					name: "vault_token_account",
+					type: "pubkey"
+				},
+				{
+					name: "premium_mint",
+					type: "pubkey"
+				},
+				{
+					name: "premium_token_account",
+					type: "pubkey"
+				},
+				{
+					name: "share_escrow",
+					type: "pubkey"
+				},
+				{
+					name: "total_assets",
+					type: "u64"
+				},
+				{
+					name: "total_shares",
+					type: "u64"
+				},
+				{
+					name: "virtual_offset",
+					docs: [
+						"Virtual offset for share calculations (prevents first-depositor attacks)",
+						"effective_shares = total_shares + virtual_offset"
+					],
+					type: "u64"
+				},
+				{
+					name: "epoch",
+					type: "u64"
+				},
+				{
+					name: "utilization_cap_bps",
+					type: "u16"
+				},
+				{
+					name: "min_epoch_duration",
+					type: "i64"
+				},
+				{
+					name: "last_roll_timestamp",
+					type: "i64"
+				},
+				{
+					name: "pending_withdrawals",
+					type: "u64"
+				},
+				{
+					name: "epoch_notional_exposed",
+					type: "u64"
+				},
+				{
+					name: "epoch_premium_earned",
+					type: "u64"
+				},
+				{
+					name: "epoch_premium_per_token_bps",
+					type: "u32"
+				},
+				{
+					name: "premium_balance_usdc",
+					docs: [
+						"Accumulated USDC premium balance (separate from underlying TVL)"
+					],
+					type: "u64"
+				},
+				{
+					name: "is_paused",
+					docs: [
+						"SECURITY: Emergency pause flag"
+					],
+					type: "bool"
+				},
+				{
+					name: "pending_min_epoch_duration",
+					docs: [
+						"SECURITY FIX M-3: Timelock for parameter changes"
+					],
+					type: "i64"
+				},
+				{
+					name: "pending_utilization_cap",
+					type: "u16"
+				},
+				{
+					name: "param_change_unlock_time",
+					type: "i64"
+				},
+				{
+					name: "bump",
+					type: "u8"
+				}
+			]
+		}
+	},
+	{
+		name: "VaultPausedEvent",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "paused",
+					type: "bool"
+				},
+				{
+					name: "timestamp",
+					type: "i64"
+				}
+			]
+		}
+	},
+	{
+		name: "VaultWhitelist",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "authority",
+					type: "pubkey"
+				},
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "market_makers",
+					type: {
+						vec: "pubkey"
+					}
+				},
+				{
+					name: "bump",
+					type: "u8"
+				}
+			]
+		}
+	},
+	{
+		name: "WithdrawalProcessedEvent",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "user",
+					type: "pubkey"
+				},
+				{
+					name: "shares",
+					type: "u64"
+				},
+				{
+					name: "amount",
+					type: "u64"
+				},
+				{
+					name: "epoch",
+					type: "u64"
+				}
+			]
+		}
+	},
+	{
+		name: "WithdrawalRequest",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "user",
+					type: "pubkey"
+				},
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "shares",
+					type: "u64"
+				},
+				{
+					name: "request_epoch",
+					type: "u64"
+				},
+				{
+					name: "processed",
+					type: "bool"
+				}
+			]
+		}
+	},
+	{
+		name: "WithdrawalRequestedEvent",
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "vault",
+					type: "pubkey"
+				},
+				{
+					name: "user",
+					type: "pubkey"
+				},
+				{
+					name: "shares",
+					type: "u64"
+				},
+				{
+					name: "epoch",
+					type: "u64"
+				}
+			]
+		}
+	}
+];
+var vault = {
+	address: address,
+	metadata: metadata,
+	instructions: instructions,
+	accounts: accounts,
+	events: events,
+	errors: errors,
+	types: types
+};
+
+export { type AdvanceEpochParams, type BlackScholesParams, type CollectPremiumParams, DEFAULT_PRICING_PARAMS, DEVNET_CONFIG, DEVNET_USDC_MINT, MAINNET_CONFIG, MAINNET_USDC_MINT, type OptionPosition, type OptionPrices, OptionPricing, type OptionType, PYTH_HERMES_URL, PYTH_PRICE_FEEDS, type PaySettlementParams, type PremiumParams, type Quote, type QuoteValidation, type RFQ, RFQClient, type RFQConfig, type RFQEvent, type RFQEventType, type RFQParams, RFQ_DEFAULTS, type RecordExposureParams, TOKEN_DECIMALS, vault as VAULT_IDL, VAULT_PROGRAM_ID, ValidationError, type VaultData, VaultInstructions, type WithdrawalRequest, bpsToPercent, deriveShareEscrowPda, deriveVaultPda, deriveWhitelistPda, deriveWithdrawalPda, formatBps, formatDate, formatPercent, formatPrice, formatRFQId, formatTimeToExpiry, formatTimestamp, formatTokenAmount, formatUSDC, parseTokenAmount, parseUSDC, percentToBps, shortenAddress, validateBlackScholesParams, validatePublicKey, validateRFQParams, validateTimestamp, validateTokenAmount };