@0dotxyz/p0-ts-sdk 2.3.3 → 2.4.0

package/dist/dto-rate-model.types-DWB7J91n.d.cts

@@ -0,0 +1,860 @@
+import { PublicKey } from '@solana/web3.js';
+import BN from 'bn.js';
+
+/**
+ * Curated Kamino Reserve used throughout the codebase.
+ *
+ * Contains only the fields the SDK reads: market/farm addresses, the
+ * liquidity and collateral state needed for cToken exchange rates and
+ * deposit/withdraw instructions, and the config subset used for interest
+ * rates and oracle refreshes.
+ */
+interface KaminoReserve {
+    /** Lending market address */
+    lendingMarket: PublicKey;
+    farmCollateral: PublicKey;
+    /** Reserve liquidity */
+    liquidity: KaminoReserveLiquidity;
+    /** Reserve collateral */
+    collateral: KaminoReserveCollateral;
+    /** Reserve configuration values */
+    config: KaminoReserveConfig;
+}
+interface KaminoReserveLiquidity {
+    /** Reserve liquidity mint address */
+    mintPubkey: PublicKey;
+    /** Reserve liquidity supply address */
+    supplyVault: PublicKey;
+    /** Reserve liquidity mint decimals */
+    mintDecimals: BN;
+    /** Reserve liquidity available */
+    availableAmount: BN;
+    /** Reserve liquidity borrowed (scaled fraction) */
+    borrowedAmountSf: BN;
+    /** Reserve cumulative protocol fees (scaled fraction) */
+    accumulatedProtocolFeesSf: BN;
+    /** Reserve cumulative referrer fees (scaled fraction) */
+    accumulatedReferrerFeesSf: BN;
+    /** Reserve pending referrer fees, to be claimed in refresh_obligation by referrer or protocol (scaled fraction) */
+    pendingReferrerFeesSf: BN;
+}
+interface KaminoReserveCollateral {
+    /** Reserve collateral mint address */
+    mintPubkey: PublicKey;
+    /** Reserve collateral mint supply, used for exchange rate */
+    mintTotalSupply: BN;
+    /** Reserve collateral supply address */
+    supplyVault: PublicKey;
+}
+interface KaminoReserveConfig {
+    /** Protocol take rate is the amount borrowed interest protocol receives, as a percentage */
+    protocolTakeRatePct: number;
+    /** Flat rate that goes to the host */
+    hostFixedInterestRateBps: number;
+    /** Borrow rate curve based on utilization */
+    borrowRateCurve: KaminoBorrowRateCurve;
+    /** Oracle configurations */
+    tokenInfo: KaminoReserveTokenInfo;
+}
+interface KaminoBorrowRateCurve {
+    points: Array<KaminoBorrowRateCurvePoint>;
+}
+interface KaminoBorrowRateCurvePoint {
+    utilizationRateBps: number;
+    borrowRateBps: number;
+}
+interface KaminoReserveTokenInfo {
+    /** Scope price configuration */
+    scopeConfiguration: KaminoScopeConfiguration;
+    /** Switchboard configuration */
+    switchboardConfiguration: KaminoSwitchboardConfiguration;
+    /** Pyth configuration */
+    pythConfiguration: KaminoPythConfiguration;
+}
+interface KaminoScopeConfiguration {
+    /** Pubkey of the scope price feed (disabled if `null` or `default`) */
+    priceFeed: PublicKey;
+}
+interface KaminoSwitchboardConfiguration {
+    /** Pubkey of the base price feed (disabled if `null` or `default`) */
+    priceAggregator: PublicKey;
+    twapAggregator: PublicKey;
+}
+interface KaminoPythConfiguration {
+    /** Pubkey of the base price feed (disabled if `null` or `default`) */
+    price: PublicKey;
+}
+
+/**
+ * JSON-serializable DTOs for the curated Kamino Reserve.
+ * PublicKey → string, BN → string.
+ */
+interface KaminoReserveJSON {
+    lendingMarket: string;
+    farmCollateral: string;
+    liquidity: KaminoReserveLiquidityJSON;
+    collateral: KaminoReserveCollateralJSON;
+    config: KaminoReserveConfigJSON;
+}
+interface KaminoReserveLiquidityJSON {
+    mintPubkey: string;
+    supplyVault: string;
+    mintDecimals: string;
+    availableAmount: string;
+    borrowedAmountSf: string;
+    accumulatedProtocolFeesSf: string;
+    accumulatedReferrerFeesSf: string;
+    pendingReferrerFeesSf: string;
+}
+interface KaminoReserveCollateralJSON {
+    mintPubkey: string;
+    mintTotalSupply: string;
+    supplyVault: string;
+}
+interface KaminoReserveConfigJSON {
+    protocolTakeRatePct: number;
+    hostFixedInterestRateBps: number;
+    borrowRateCurve: KaminoBorrowRateCurveJSON;
+    tokenInfo: KaminoReserveTokenInfoJSON;
+}
+interface KaminoBorrowRateCurveJSON {
+    points: Array<KaminoBorrowRateCurvePointJSON>;
+}
+interface KaminoBorrowRateCurvePointJSON {
+    utilizationRateBps: number;
+    borrowRateBps: number;
+}
+interface KaminoReserveTokenInfoJSON {
+    scopeConfiguration: KaminoScopeConfigurationJSON;
+    switchboardConfiguration: KaminoSwitchboardConfigurationJSON;
+    pythConfiguration: KaminoPythConfigurationJSON;
+}
+interface KaminoScopeConfigurationJSON {
+    priceFeed: string;
+}
+interface KaminoSwitchboardConfigurationJSON {
+    priceAggregator: string;
+    twapAggregator: string;
+}
+interface KaminoPythConfigurationJSON {
+    price: string;
+}
+
+/**
+ * Curated Kamino Obligation used throughout the codebase.
+ *
+ * Keeps only the position data: owner, market, and the deposit/borrow
+ * slots (fixed-size arrays on-chain, mapped 1:1 without filtering).
+ */
+interface KaminoObligation {
+    /** Lending market address */
+    lendingMarket: PublicKey;
+    /** Owner authority which can borrow liquidity */
+    owner: PublicKey;
+    /** Deposited collateral for the obligation, unique by deposit reserve address */
+    deposits: Array<KaminoObligationCollateral>;
+    /** Borrowed liquidity for the obligation, unique by borrow reserve address */
+    borrows: Array<KaminoObligationLiquidity>;
+}
+interface KaminoObligationCollateral {
+    /** Reserve collateral is deposited to */
+    depositReserve: PublicKey;
+    /** Amount of collateral deposited */
+    depositedAmount: BN;
+    /** Collateral market value in quote currency (scaled fraction) */
+    marketValueSf: BN;
+}
+interface KaminoObligationLiquidity {
+    /** Reserve liquidity is borrowed from */
+    borrowReserve: PublicKey;
+    /** Amount of liquidity borrowed plus interest (scaled fraction) */
+    borrowedAmountSf: BN;
+    /** Liquidity market value in quote currency (scaled fraction) */
+    marketValueSf: BN;
+}
+
+/**
+ * JSON-serializable DTOs for the curated Kamino Obligation.
+ * PublicKey → string, BN → string.
+ */
+interface KaminoObligationJSON {
+    lendingMarket: string;
+    owner: string;
+    deposits: Array<KaminoObligationCollateralJSON>;
+    borrows: Array<KaminoObligationLiquidityJSON>;
+}
+interface KaminoObligationCollateralJSON {
+    depositReserve: string;
+    depositedAmount: string;
+    marketValueSf: string;
+}
+interface KaminoObligationLiquidityJSON {
+    borrowReserve: string;
+    borrowedAmountSf: string;
+    marketValueSf: string;
+}
+
+/**
+ * Curated Kamino FarmState used throughout the codebase.
+ *
+ * Keeps only the staked token identity and the reward schedule data
+ * needed to compute reward APYs.
+ */
+interface KaminoFarmState {
+    token: KaminoFarmTokenInfo;
+    rewardInfos: Array<KaminoFarmRewardInfo>;
+}
+interface KaminoFarmTokenInfo {
+    mint: PublicKey;
+    decimals: BN;
+}
+interface KaminoFarmRewardInfo {
+    token: KaminoFarmTokenInfo;
+    rewardsPerSecondDecimals: number;
+    rewardScheduleCurve: KaminoRewardScheduleCurve;
+}
+interface KaminoRewardScheduleCurve {
+    /**
+     * This is a stepwise function, meaning that each point represents
+     * how many rewards are issued per time unit since the beginning
+     * of that point until the beginning of the next point.
+     */
+    points: Array<KaminoRewardCurvePoint>;
+}
+interface KaminoRewardCurvePoint {
+    tsStart: BN;
+    rewardPerTimeUnit: BN;
+}
+
+/**
+ * JSON-serializable DTOs for the curated Kamino FarmState.
+ * PublicKey → string, BN → string.
+ */
+interface KaminoFarmStateJSON {
+    token: KaminoFarmTokenInfoJSON;
+    rewardInfos: Array<KaminoFarmRewardInfoJSON>;
+}
+interface KaminoFarmTokenInfoJSON {
+    mint: string;
+    decimals: string;
+}
+interface KaminoFarmRewardInfoJSON {
+    token: KaminoFarmTokenInfoJSON;
+    rewardsPerSecondDecimals: number;
+    rewardScheduleCurve: KaminoRewardScheduleCurveJSON;
+}
+interface KaminoRewardScheduleCurveJSON {
+    points: Array<KaminoRewardCurvePointJSON>;
+}
+interface KaminoRewardCurvePointJSON {
+    tsStart: string;
+    rewardPerTimeUnit: string;
+}
+
+interface DriftUserStatsJSON {
+    /** The authority for all of a users sub accounts */
+    authority: string;
+    /** The address that referred this user */
+    referrer: string;
+    /** Stats on the fees paid by the user */
+    fees: UserFeesJSON;
+    /**
+     * The timestamp of the next epoch
+     * Epoch is used to limit referrer rewards earned in single epoch
+     */
+    nextEpochTs: string;
+    /**
+     * Rolling 30day maker volume for user
+     * precision: QUOTE_PRECISION
+     */
+    makerVolume30d: string;
+    /**
+     * Rolling 30day taker volume for user
+     * precision: QUOTE_PRECISION
+     */
+    takerVolume30d: string;
+    /**
+     * Rolling 30day filler volume for user
+     * precision: QUOTE_PRECISION
+     */
+    fillerVolume30d: string;
+    /** last time the maker volume was updated */
+    lastMakerVolume30dTs: string;
+    /** last time the taker volume was updated */
+    lastTakerVolume30dTs: string;
+    /** last time the filler volume was updated */
+    lastFillerVolume30dTs: string;
+    /** The amount of tokens staked in the quote spot markets if */
+    ifStakedQuoteAssetAmount: string;
+    /** The current number of sub accounts */
+    numberOfSubAccounts: number;
+    /**
+     * The number of sub accounts created. Can be greater than the number of sub accounts if user
+     * has deleted sub accounts
+     */
+    numberOfSubAccountsCreated: number;
+    /**
+     * Flags for referrer status:
+     * First bit (LSB): 1 if user is a referrer, 0 otherwise
+     * Second bit: 1 if user was referred, 0 otherwise
+     */
+    referrerStatus: number;
+    disableUpdatePerpBidAskTwap: boolean;
+    padding1: Array<number>;
+    /** whether the user has a FuelOverflow account */
+    fuelOverflowStatus: number;
+    /** accumulated fuel for token amounts of insurance */
+    fuelInsurance: number;
+    /** accumulated fuel for notional of deposits */
+    fuelDeposits: number;
+    /** accumulate fuel bonus for notional of borrows */
+    fuelBorrows: number;
+    /** accumulated fuel for perp open interest */
+    fuelPositions: number;
+    /** accumulate fuel bonus for taker volume */
+    fuelTaker: number;
+    /** accumulate fuel bonus for maker volume */
+    fuelMaker: number;
+    /** The amount of tokens staked in the governance spot markets if */
+    ifStakedGovTokenAmount: string;
+    /**
+     * last unix ts user stats data was used to update if fuel (u32 to save space)
+     */
+    lastFuelIfBonusUpdateTs: number;
+    padding: Array<number>;
+}
+interface UserFeesJSON {
+    /**
+     * Total taker fee paid
+     * precision: QUOTE_PRECISION
+     */
+    totalFeePaid: string;
+    /**
+     * Total maker fee rebate
+     * precision: QUOTE_PRECISION
+     */
+    totalFeeRebate: string;
+    /**
+     * Total discount from holding token
+     * precision: QUOTE_PRECISION
+     */
+    totalTokenDiscount: string;
+    /**
+     * Total discount from being referred
+     * precision: QUOTE_PRECISION
+     */
+    totalRefereeDiscount: string;
+    /**
+     * Total reward to referrer
+     * precision: QUOTE_PRECISION
+     */
+    totalReferrerReward: string;
+    /**
+     * Total reward to referrer this epoch
+     * precision: QUOTE_PRECISION
+     */
+    currentEpochReferrerReward: string;
+}
+
+interface DriftUserStats {
+    authority: PublicKey;
+    referrer: PublicKey;
+    fees: UserFeesFields;
+    nextEpochTs: BN;
+    makerVolume30d: BN;
+    takerVolume30d: BN;
+    fillerVolume30d: BN;
+    lastMakerVolume30dTs: BN;
+    lastTakerVolume30dTs: BN;
+    lastFillerVolume30dTs: BN;
+    ifStakedQuoteAssetAmount: BN;
+    numberOfSubAccounts: number;
+    numberOfSubAccountsCreated: number;
+    referrerStatus: number;
+    disableUpdatePerpBidAskTwap: boolean;
+    padding1: Array<number>;
+    fuelOverflowStatus: number;
+    fuelInsurance: number;
+    fuelDeposits: number;
+    fuelBorrows: number;
+    fuelPositions: number;
+    fuelTaker: number;
+    fuelMaker: number;
+    ifStakedGovTokenAmount: BN;
+    lastFuelIfBonusUpdateTs: number;
+    padding: Array<number>;
+}
+interface UserFeesFields {
+    totalFeePaid: BN;
+    totalFeeRebate: BN;
+    totalTokenDiscount: BN;
+    totalRefereeDiscount: BN;
+    totalReferrerReward: BN;
+    currentEpochReferrerReward: BN;
+}
+
+interface DriftSpotMarketJSON {
+    pubkey: string;
+    oracle: string;
+    mint: string;
+    decimals: number;
+    cumulativeDepositInterest: string;
+    marketIndex: number;
+    depositBalance: string;
+    borrowBalance: string;
+    cumulativeBorrowInterest: string;
+    optimalUtilization: number;
+    optimalBorrowRate: number;
+    maxBorrowRate: number;
+    minBorrowRate: number;
+    insuranceFund: {
+        totalFactor: number;
+    };
+    poolId: number;
+}
+
+interface FeeStructure {
+    feeTiers: Array<FeeTier>;
+    fillerRewardStructure: OrderFillerRewardStructure;
+    referrerRewardEpochUpperBound: BN;
+    flatFillerFee: BN;
+}
+interface FeeStructureJSON {
+    feeTiers: Array<FeeTierJSON>;
+    fillerRewardStructure: OrderFillerRewardStructureJSON;
+    referrerRewardEpochUpperBound: string;
+    flatFillerFee: string;
+}
+interface FeeTier {
+    feeNumerator: number;
+    feeDenominator: number;
+    makerRebateNumerator: number;
+    makerRebateDenominator: number;
+    referrerRewardNumerator: number;
+    referrerRewardDenominator: number;
+    refereeFeeNumerator: number;
+    refereeFeeDenominator: number;
+}
+interface FeeTierJSON {
+    feeNumerator: number;
+    feeDenominator: number;
+    makerRebateNumerator: number;
+    makerRebateDenominator: number;
+    referrerRewardNumerator: number;
+    referrerRewardDenominator: number;
+    refereeFeeNumerator: number;
+    refereeFeeDenominator: number;
+}
+interface OrderFillerRewardStructure {
+    rewardNumerator: number;
+    rewardDenominator: number;
+    timeBasedRewardLowerBound: BN;
+}
+interface OrderFillerRewardStructureJSON {
+    rewardNumerator: number;
+    rewardDenominator: number;
+    timeBasedRewardLowerBound: string;
+}
+interface OracleGuardRails {
+    priceDivergence: PriceDivergenceGuardRails;
+    validity: ValidityGuardRails;
+}
+interface OracleGuardRailsJSON {
+    priceDivergence: PriceDivergenceGuardRailsJSON;
+    validity: ValidityGuardRailsJSON;
+}
+interface PriceDivergenceGuardRails {
+    markOraclePercentDivergence: BN;
+    oracleTwap5minPercentDivergence: BN;
+}
+interface PriceDivergenceGuardRailsJSON {
+    markOraclePercentDivergence: string;
+    oracleTwap5minPercentDivergence: string;
+}
+interface ValidityGuardRails {
+    slotsBeforeStaleForAmm: BN;
+    slotsBeforeStaleForMargin: BN;
+    confidenceIntervalMaxSize: BN;
+    tooVolatileRatio: BN;
+}
+interface ValidityGuardRailsJSON {
+    slotsBeforeStaleForAmm: string;
+    slotsBeforeStaleForMargin: string;
+    confidenceIntervalMaxSize: string;
+    tooVolatileRatio: string;
+}
+interface HistoricalOracleData {
+    /** precision: PRICE_PRECISION */
+    lastOraclePrice: BN;
+    /** precision: PRICE_PRECISION */
+    lastOracleConf: BN;
+    /** number of slots since last update */
+    lastOracleDelay: BN;
+    /** precision: PRICE_PRECISION */
+    lastOraclePriceTwap: BN;
+    /** precision: PRICE_PRECISION */
+    lastOraclePriceTwap5min: BN;
+    /** unix_timestamp of last snapshot */
+    lastOraclePriceTwapTs: BN;
+}
+interface HistoricalOracleDataJSON {
+    /** precision: PRICE_PRECISION */
+    lastOraclePrice: string;
+    /** precision: PRICE_PRECISION */
+    lastOracleConf: string;
+    /** number of slots since last update */
+    lastOracleDelay: string;
+    /** precision: PRICE_PRECISION */
+    lastOraclePriceTwap: string;
+    /** precision: PRICE_PRECISION */
+    lastOraclePriceTwap5min: string;
+    /** unix_timestamp of last snapshot */
+    lastOraclePriceTwapTs: string;
+}
+interface HistoricalIndexData {
+    /** precision: PRICE_PRECISION */
+    lastIndexBidPrice: BN;
+    /** precision: PRICE_PRECISION */
+    lastIndexAskPrice: BN;
+    /** precision: PRICE_PRECISION */
+    lastIndexPriceTwap: BN;
+    /** precision: PRICE_PRECISION */
+    lastIndexPriceTwap5min: BN;
+    /** unix_timestamp of last snapshot */
+    lastIndexPriceTwapTs: BN;
+}
+interface HistoricalIndexDataJSON {
+    /** precision: PRICE_PRECISION */
+    lastIndexBidPrice: string;
+    /** precision: PRICE_PRECISION */
+    lastIndexAskPrice: string;
+    /** precision: PRICE_PRECISION */
+    lastIndexPriceTwap: string;
+    /** precision: PRICE_PRECISION */
+    lastIndexPriceTwap5min: string;
+    /** unix_timestamp of last snapshot */
+    lastIndexPriceTwapTs: string;
+}
+interface PoolBalance {
+    /**
+     * To get the pool's token amount, you must multiply the scaled balance by the market's cumulative
+     * deposit interest
+     * precision: SPOT_BALANCE_PRECISION
+     */
+    scaledBalance: BN;
+    /** The spot market the pool is for */
+    marketIndex: number;
+    padding: Array<number>;
+}
+interface PoolBalanceJSON {
+    /**
+     * To get the pool's token amount, you must multiply the scaled balance by the market's cumulative
+     * deposit interest
+     * precision: SPOT_BALANCE_PRECISION
+     */
+    scaledBalance: string;
+    /** The spot market the pool is for */
+    marketIndex: number;
+    padding: Array<number>;
+}
+interface InsuranceFund {
+    vault: PublicKey;
+    totalShares: BN;
+    userShares: BN;
+    sharesBase: BN;
+    unstakingPeriod: BN;
+    lastRevenueSettleTs: BN;
+    revenueSettlePeriod: BN;
+    totalFactor: number;
+    userFactor: number;
+}
+interface InsuranceFundJSON {
+    vault: string;
+    totalShares: string;
+    userShares: string;
+    sharesBase: string;
+    unstakingPeriod: string;
+    lastRevenueSettleTs: string;
+    revenueSettlePeriod: string;
+    totalFactor: number;
+    userFactor: number;
+}
+declare enum SpotBalanceType {
+    Deposit = "Deposit",
+    Borrow = "Borrow"
+}
+interface SpotPosition {
+    /**
+     * The scaled balance of the position. To get the token amount, multiply by the cumulative deposit/borrow
+     * interest of corresponding market.
+     * precision: SPOT_BALANCE_PRECISION
+     */
+    scaledBalance: BN;
+    /**
+     * How many spot bids the user has open
+     * precision: token mint precision
+     */
+    openBids: BN;
+    /**
+     * How many spot asks the user has open
+     * precision: token mint precision
+     */
+    openAsks: BN;
+    /**
+     * The cumulative deposits/borrows a user has made into a market
+     * precision: token mint precision
+     */
+    cumulativeDeposits: BN;
+    /** The market index of the corresponding spot market */
+    marketIndex: number;
+    /** Whether the position is deposit or borrow */
+    balanceType: SpotBalanceType;
+    /** Number of open orders */
+    openOrders: number;
+    padding: Array<number>;
+}
+interface SpotPositionJSON {
+    /**
+     * The scaled balance of the position. To get the token amount, multiply by the cumulative deposit/borrow
+     * interest of corresponding market.
+     * precision: SPOT_BALANCE_PRECISION
+     */
+    scaledBalance: string;
+    /**
+     * How many spot bids the user has open
+     * precision: token mint precision
+     */
+    openBids: string;
+    /**
+     * How many spot asks the user has open
+     * precision: token mint precision
+     */
+    openAsks: string;
+    /**
+     * The cumulative deposits/borrows a user has made into a market
+     * precision: token mint precision
+     */
+    cumulativeDeposits: string;
+    /** The market index of the corresponding spot market */
+    marketIndex: number;
+    /** Whether the position is deposit or borrow */
+    balanceType: SpotBalanceType;
+    /** Number of open orders */
+    openOrders: number;
+    padding: Array<number>;
+}
+
+interface DriftSpotMarket {
+    pubkey: PublicKey;
+    oracle: PublicKey;
+    mint: PublicKey;
+    decimals: number;
+    cumulativeDepositInterest: BN;
+    marketIndex: number;
+    depositBalance: BN;
+    borrowBalance: BN;
+    cumulativeBorrowInterest: BN;
+    optimalUtilization: number;
+    optimalBorrowRate: number;
+    maxBorrowRate: number;
+    minBorrowRate: number;
+    insuranceFund: {
+        totalFactor: number;
+    };
+    poolId: number;
+}
+declare enum DriftSpotBalanceType {
+    DEPOSIT = "deposit",
+    BORROW = "borrow"
+}
+declare function isSpotBalanceTypeVariant(value: DriftSpotBalanceType, variant: "deposit" | "borrow"): boolean;
+
+interface DriftUserJSON {
+    authority: string;
+    spotPositions: Array<SpotPositionJSON>;
+}
+
+interface DriftUser {
+    authority: PublicKey;
+    spotPositions: Array<SpotPosition>;
+}
+
+type DriftRewards = {
+    oracle: PublicKey;
+    marketIndex: number;
+    spotMarket: PublicKey;
+    mint: PublicKey;
+    spotPosition: SpotPosition;
+};
+type DriftRewardsJSON = {
+    oracle: string;
+    marketIndex: number;
+    spotMarket: string;
+    mint: string;
+    spotPosition: SpotPositionJSON;
+};
+
+/**
+ * JSON-serializable DTO for the Lending account.
+ * PublicKey → string, BN → string.
+ */
+interface JupLendingStateJSON {
+    pubkey: string;
+    mint: string;
+    fTokenMint: string;
+    lendingId: number;
+    decimals: number;
+    rewardsRateModel: string;
+    liquidityExchangePrice: string;
+    tokenExchangePrice: string;
+    lastUpdateTimestamp: string;
+    tokenReservesLiquidity: string;
+    supplyPositionOnLiquidity: string;
+    bump?: number;
+}
+
+/**
+ * Curated Lending State used throughout the codebase.
+ *
+ * integration_acc_1 – holds cToken/fToken exchange rates.
+ * Analogous to a Kamino Reserve or Drift SpotMarket.
+ */
+interface JupLendingState {
+    pubkey: PublicKey;
+    mint: PublicKey;
+    fTokenMint: PublicKey;
+    lendingId: number;
+    decimals: number;
+    rewardsRateModel: PublicKey;
+    /** Exchange price for the underlying asset in the liquidity protocol (without rewards) */
+    liquidityExchangePrice: BN;
+    /** Exchange price between fToken and the underlying asset (with rewards) */
+    tokenExchangePrice: BN;
+    lastUpdateTimestamp: BN;
+    tokenReservesLiquidity: PublicKey;
+    supplyPositionOnLiquidity: PublicKey;
+}
+
+/**
+ * Curated TokenReserve used throughout the codebase.
+ *
+ * Liquidity-layer reserve account for a mint. Contains supply/borrow
+ * exchange prices, utilization, and totals.
+ */
+interface JupTokenReserve {
+    pubkey: PublicKey;
+    mint: PublicKey;
+    vault: PublicKey;
+    borrowRate: number;
+    feeOnInterest: number;
+    lastUtilization: number;
+    lastUpdateTimestamp: BN;
+    supplyExchangePrice: BN;
+    borrowExchangePrice: BN;
+    maxUtilization: number;
+    totalSupplyWithInterest: BN;
+    totalSupplyInterestFree: BN;
+    totalBorrowWithInterest: BN;
+    totalBorrowInterestFree: BN;
+    totalClaimAmount: BN;
+    interactingProtocol: PublicKey;
+    interactingTimestamp: BN;
+    interactingBalance: BN;
+}
+
+/**
+ * JSON-serializable DTO for the TokenReserve account.
+ * PublicKey → string, BN → string.
+ */
+interface JupTokenReserveJSON {
+    pubkey: string;
+    mint: string;
+    vault: string;
+    borrowRate: number;
+    feeOnInterest: number;
+    lastUtilization: number;
+    lastUpdateTimestamp: string;
+    supplyExchangePrice: string;
+    borrowExchangePrice: string;
+    maxUtilization: number;
+    totalSupplyWithInterest: string;
+    totalSupplyInterestFree: string;
+    totalBorrowWithInterest: string;
+    totalBorrowInterestFree: string;
+    totalClaimAmount: string;
+    interactingProtocol: string;
+    interactingTimestamp: string;
+    interactingBalance: string;
+}
+
+/**
+ * Curated LendingRewardsRateModel used throughout the codebase.
+ *
+ * Controls the rewards distribution parameters for a jup-lend market.
+ */
+interface JupLendingRewardsRateModel {
+    pubkey: PublicKey;
+    /** Mint address */
+    mint: PublicKey;
+    /** TVL below which rewards rate is 0 */
+    startTvl: BN;
+    /** Duration for which current rewards should run */
+    duration: BN;
+    /** Timestamp when current rewards got started */
+    startTime: BN;
+    /** Annualized reward based on input params (duration, rewardAmount) */
+    yearlyReward: BN;
+    /** Duration for the next rewards phase */
+    nextDuration: BN;
+    /** Amount of rewards for the next phase */
+    nextRewardAmount: BN;
+}
+
+/**
+ * JSON-serializable DTO for the LendingRewardsRateModel account.
+ * PublicKey → string, BN → string.
+ */
+interface JupLendingRewardsRateModelJSON {
+    pubkey: string;
+    mint: string;
+    startTvl: string;
+    duration: string;
+    startTime: string;
+    yearlyReward: string;
+    nextDuration: string;
+    nextRewardAmount: string;
+    bump?: number;
+}
+
+/**
+ * Curated RateModel — identical to raw since all fields are primitives + PublicKey.
+ */
+interface JupRateModel {
+    pubkey: PublicKey;
+    mint: PublicKey;
+    version: number;
+    rateAtZero: number;
+    kink1Utilization: number;
+    rateAtKink1: number;
+    rateAtMax: number;
+    kink2Utilization: number;
+    rateAtKink2: number;
+}
+
+/**
+ * JSON-serializable DTO for the RateModel account.
+ * PublicKey → string.
+ */
+interface JupRateModelJSON {
+    pubkey: string;
+    mint: string;
+    version: number;
+    rateAtZero: number;
+    kink1Utilization: number;
+    rateAtKink1: number;
+    rateAtMax: number;
+    kink2Utilization: number;
+    rateAtKink2: number;
+}
+
+export { type KaminoObligationCollateralJSON as $, type KaminoReserveCollateral as A, type KaminoReserveConfig as B, type KaminoBorrowRateCurve as C, type DriftSpotMarket as D, type KaminoReserveTokenInfo as E, type FeeStructureJSON as F, type KaminoScopeConfiguration as G, type HistoricalOracleData as H, type InsuranceFund as I, type JupLendingState as J, type KaminoReserve as K, type KaminoSwitchboardConfiguration as L, type KaminoPythConfiguration as M, type KaminoReserveLiquidityJSON as N, type OracleGuardRailsJSON as O, type PoolBalance as P, type KaminoReserveCollateralJSON as Q, type KaminoReserveConfigJSON as R, type SpotPosition as S, type KaminoBorrowRateCurveJSON as T, type KaminoBorrowRateCurvePointJSON as U, type KaminoReserveTokenInfoJSON as V, type KaminoScopeConfigurationJSON as W, type KaminoSwitchboardConfigurationJSON as X, type KaminoPythConfigurationJSON as Y, type KaminoObligationCollateral as Z, type KaminoObligationLiquidity as _, type KaminoObligation as a, type KaminoObligationLiquidityJSON as a0, type KaminoFarmTokenInfo as a1, type KaminoRewardScheduleCurve as a2, type KaminoRewardCurvePoint as a3, type KaminoFarmTokenInfoJSON as a4, type KaminoFarmRewardInfoJSON as a5, type KaminoRewardScheduleCurveJSON as a6, type KaminoRewardCurvePointJSON as a7, type UserFeesJSON as a8, type UserFeesFields as a9, isSpotBalanceTypeVariant as aa, type FeeTier as ab, type FeeTierJSON as ac, type OrderFillerRewardStructure as ad, type OrderFillerRewardStructureJSON as ae, type PriceDivergenceGuardRails as af, type PriceDivergenceGuardRailsJSON as ag, type ValidityGuardRails as ah, type ValidityGuardRailsJSON as ai, type HistoricalOracleDataJSON as aj, type HistoricalIndexDataJSON as ak, type PoolBalanceJSON as al, type InsuranceFundJSON as am, SpotBalanceType as an, type SpotPositionJSON as ao, type KaminoFarmState as b, type DriftUser as c, type DriftRewards as d, type DriftUserStats as e, type JupTokenReserve as f, type JupLendingRewardsRateModel as g, type JupRateModel as h, type KaminoReserveJSON as i, type KaminoObligationJSON as j, type KaminoFarmStateJSON as k, type DriftSpotMarketJSON as l, type DriftUserJSON as m, type DriftRewardsJSON as n, type DriftUserStatsJSON as o, type JupLendingStateJSON as p, type JupTokenReserveJSON as q, type JupLendingRewardsRateModelJSON as r, type JupRateModelJSON as s, type KaminoBorrowRateCurvePoint as t, type KaminoFarmRewardInfo as u, type HistoricalIndexData as v, type FeeStructure as w, type OracleGuardRails as x, DriftSpotBalanceType as y, type KaminoReserveLiquidity as z };