@exponent-labs/exponent-fetcher 0.1.7 → 0.1.8

package/build/exponentFetcher.d.ts

@@ -1,14 +1,22 @@
+/// <reference types="node" />
+/// <reference types="node" />
 /// <reference types="bn.js" />
 import { BN, Program, Wallet, web3 } from "@coral-xyz/anchor";
 import Decimal from "decimal.js";
+import { ExponentClmm } from "@exponent-labs/exponent-clmm-idl";
 import { ExponentCore } from "@exponent-labs/exponent-idl";
-import { AnchorizedPNum, AnchorizedPNumJson, CpiAccountIndexes, GenericSyMetaAccount, InterfaceType, JitoRestakingSyMetaAccount, MarginfiSyMeta, PerenaSyMetaAccount, SyEmissionRaw, VaultEmission, VaultEmissionJson } from "@exponent-labs/exponent-types";
+import { ExponentOrderbook } from "@exponent-labs/exponent-orderbook-idl";
+import { AnchorizedPNum, AnchorizedPNumJson, CpiAccountIndexes, ExponentCoreCpiIndexes, GenericSyMetaAccount, InterfaceType, JitoRestakingSyMetaAccount, MarginfiSyMeta, MarketCpiCoreIndexes, PerenaSyMetaAccount, SyEmissionRaw, VaultEmission, VaultEmissionJson } from "@exponent-labs/exponent-types";
+import { OfferNode, PriceTreeNode, UserEscrowNode } from "@exponent-labs/exponent-types";
 import { GenericStandard } from "@exponent-labs/generic-sy-idl";
 import { JitoRestakingStandard } from "@exponent-labs/jito-restaking-sy-idl";
 import { Obligation } from "@exponent-labs/kamino-reserve-deserializer";
 import { KaminoLendStandard } from "@exponent-labs/kamino-sy-idl";
 import { MarginfiStandard } from "@exponent-labs/marginfi-sy-idl";
 import { PerenaStandard } from "@exponent-labs/perena-sy-idl";
+import { calculateFragmetricSupportedTokenIndex } from "./utils/fragmetric";
+import { calculateJupiterLendIndex, calculateJupiterPerpsIndex } from "./utils/jupiter";
+import { calculateSolsticeRedemptionRate } from "./utils/solstice";
 export declare function serializeAnchorizedPNumFromJson(pnum: AnchorizedPNum): AnchorizedPNumJson;
 export declare function deserializeAnchorizedPNumFromJson(serialized: AnchorizedPNumJson): AnchorizedPNum;
 export declare class MyWallet implements Wallet {
@@ -25,6 +33,8 @@ export declare class ExponentFetcher {
     jitoRestakingSyProgram: Program<JitoRestakingStandard>;
     perenaSyProgram: Program<PerenaStandard>;
     genericStandardProgram: Program<GenericStandard>;
+    exponentClmmProgram: Program<ExponentClmm>;
+    orderbookProgram: Program<ExponentOrderbook>;
     connection: web3.Connection;
     coreProgramId: web3.PublicKey;
     marginfiSyProgramId: web3.PublicKey;
@@ -43,6 +53,8 @@ export declare class ExponentFetcher {
     });
     fetchVault(address: web3.PublicKey): Promise<Vault>;
     fetchMarket(address: web3.PublicKey): Promise<MarketTwo>;
+    fetchOrderbook(address: web3.PublicKey): Promise<Orderbook>;
+    fetchOrderbookCpiAccounts(address: web3.PublicKey): Promise<OrderbookCpiAccountsRaw>;
     fetchMarginfiSyMeta(address: web3.PublicKey): Promise<MarginfiSyMeta>;
     fetchMarginfiSyPosition(address: web3.PublicKey): Promise<SyPosition>;
     fetchKaminoSyPosition(address: web3.PublicKey): Promise<SyPosition>;
@@ -51,19 +63,177 @@ export declare class ExponentFetcher {
     fetchGenericSyPosition(address: web3.PublicKey): Promise<SyPosition>;
     fetchKaminoSyMeta(address: web3.PublicKey): Promise<KaminoSyMeta>;
     fetchLpPosition(address: web3.PublicKey): Promise<LpPosition>;
+    fetchLpPositionCLMM(address: web3.PublicKey): Promise<LpPositionCLMM>;
     fetchYtPosition(address: web3.PublicKey): Promise<YtPosition>;
+    /** Batch fetch multiple YT positions in a single RPC call */
+    fetchYtPositions(addresses: web3.PublicKey[]): Promise<(YtPosition | null)[]>;
     fetchJitoRestakingSyMeta(address: web3.PublicKey): Promise<JitoRestakingSyMetaAccount>;
     fetchPerenaSyMeta(address: web3.PublicKey): Promise<PerenaSyMetaAccount>;
     fetchGenericSyMeta(address: web3.PublicKey): Promise<GenericSyMetaAccount>;
+    fetchAllMarketThree(): Promise<MarketThree[]>;
+    fetchMarketThree(address: web3.PublicKey): Promise<MarketThree>;
+    fetchAllMarketThreeTicks(): Promise<Ticks[]>;
+    fetchMarketThreeTicks(address: web3.PublicKey): Promise<Ticks>;
 }
-export declare function fetchKaminoReserve(address: web3.PublicKey, connection: web3.Connection): Promise<{
+export declare function deserializeMarketThreeTicks(data: Buffer): Ticks;
+export declare function deserializeLpPosition(x: LpPositionRaw): LpPosition;
+export declare function deserializeYtPosition(x: YtPositionRaw): YtPosition;
+export interface KaminoReserveSummary {
     lendingMarket: web3.PublicKey;
     baseMint: web3.PublicKey;
     assetShareValue: Decimal;
-}>;
+    scopePriceFeed?: web3.PublicKey;
+}
+export declare function fetchKaminoReserve(address: web3.PublicKey, connection: web3.Connection): Promise<KaminoReserveSummary>;
 export declare function fetchAllKaminoObligationsByKaminoReserve(reserve: web3.PublicKey, connection: web3.Connection): Promise<Obligation[]>;
 export declare function serializeEmission(emission: VaultEmission): VaultEmissionJson;
 export declare function deserializeEmission(emission: VaultEmissionJson): VaultEmission;
+export interface MarketThree {
+    admin: web3.PublicKey;
+    addressLookupTable: web3.PublicKey;
+    mintPt: web3.PublicKey;
+    mintSy: web3.PublicKey;
+    mintYt: web3.PublicKey;
+    vault: web3.PublicKey;
+    tokenPtEscrow: web3.PublicKey;
+    tokenSyEscrow: web3.PublicKey;
+    tokenYtEscrow: web3.PublicKey;
+    tokenFeeTreasurySy: web3.PublicKey;
+    tokenFeeTreasuryPt: web3.PublicKey;
+    syProgram: web3.PublicKey;
+    exponentCoreProgram: web3.PublicKey;
+    selfAddress: web3.PublicKey;
+    ticks: web3.PublicKey;
+    statusFlags: number;
+    configurationOptions: MarketConfigurationOptions;
+    financials: MarketThreeFinancials;
+    cpiSyAccounts: CpiAccountIndexes;
+    cpiCoreAccounts: MarketCpiCoreIndexes;
+    isCurrentFlashSwap: boolean;
+    lpFarm: LpFarm;
+    emissions: {
+        trackers: {
+            tokenEscrow: web3.PublicKey;
+            lpShareIndex: number;
+            lastSeenStaged: number;
+        }[];
+    };
+    liquidityNetBalanceLimits: LiquidityNetBalanceLimits;
+}
+export interface Ticks {
+    /** Current tick (left boundary of the active interval) */
+    currentTick: number;
+    /** Array of ticks (simplified from RBTree for TypeScript) */
+    ticksTree: Tick[];
+    /** Market address this ticks account belongs to */
+    market: web3.PublicKey;
+    /** Fee growth index global for PT */
+    feeGrowthIndexGlobalPt: bigint;
+    /** Fee growth index global for SY */
+    feeGrowthIndexGlobalSy: bigint;
+    /** Current prefix sum - the active liquidity at the current tick */
+    currentPrefixSum: bigint;
+    /** Current spot price (ln implied rate) */
+    currentSpotPrice: number;
+}
+export interface Tick {
+    liquidityNet: bigint;
+    /** Total liquidity referencing this tick as a boundary */
+    liquidityGross: bigint;
+    /** Fee growth index outside this tick for PT */
+    feeGrowthOutsidePt: bigint;
+    /** Fee growth index outside this tick for SY */
+    feeGrowthOutsideSy: bigint;
+    /** Principal PT accrued in the interval starting at this tick */
+    impliedRate: number;
+    principalPt: bigint;
+    /** Principal SY accrued in the interval starting at this tick */
+    principalSy: bigint;
+    apyBasePoints: number;
+    principalShareSupply: bigint;
+    /** Farm yield trackers (3 trackers) */
+    farms: {
+        lastSeenIndex: number;
+    }[];
+    /** Emission yield trackers (3 trackers) */
+    emissions: {
+        lastSeenIndex: number;
+        lastPositionIndex: number;
+    }[];
+    /** Last split epoch for this tick */
+    lastSplitEpoch: bigint;
+}
+export interface MarketThreeRaw {
+    admin: web3.PublicKey;
+    addressLookupTable: web3.PublicKey;
+    mintPt: web3.PublicKey;
+    mintSy: web3.PublicKey;
+    mintYt: web3.PublicKey;
+    vault: web3.PublicKey;
+    tokenPtEscrow: web3.PublicKey;
+    tokenSyEscrow: web3.PublicKey;
+    tokenYtEscrow: web3.PublicKey;
+    tokenFeeTreasurySy: web3.PublicKey;
+    tokenFeeTreasuryPt: web3.PublicKey;
+    syProgram: web3.PublicKey;
+    exponentCoreProgram: web3.PublicKey;
+    selfAddress: web3.PublicKey;
+    ticks: web3.PublicKey;
+    statusFlags: number;
+    configurationOptions: MarketConfigurationOptionsRaw;
+    financials: MarketThreeFinancialsRaw;
+    cpiSyAccounts: CpiAccountIndexes;
+    cpiCoreAccounts: MarketCpiCoreIndexes;
+    isCurrentFlashSwap: boolean;
+    lpFarm: LpFarm;
+    emissions: MarketEmissions;
+    liquidityNetBalanceLimits: LiquidityNetBalanceLimits;
+    seedId: number[];
+}
+export interface MarketConfigurationOptions {
+    /** ln of fee rate root */
+    lnFeeRateRoot: number;
+    /** Treasury fee in basis points */
+    treasuryFeeBps: number;
+    /** Minimum LP amount per tick */
+    minLpTickAmount: bigint;
+    /** Epsilon clamp for numerical stability */
+    epsilonClamp: number;
+    /** Maximum LP supply */
+    maxLpSupply: bigint;
+    /** Tick space */
+    tickSpace: number;
+}
+export interface MarketThreeFinancials {
+    expirationTs: bigint;
+    ptBalance: bigint;
+    syBalance: bigint;
+    liquidityBalance: bigint;
+}
+export interface MarketConfigurationOptionsRaw {
+    lnFeeRateRoot: number;
+    treasuryFeeBps: number;
+    minLpTickAmount: BN;
+    epsilonClamp: number;
+    maxLpSupply: BN;
+    tickSpace: number;
+}
+export interface OrderbookConfigurationOptionsRaw {
+    thresholdAmount: BN;
+    lnMakerFeeRate: number;
+    lnTakerFeeRate: number;
+    priceDecimals: number;
+}
+export interface MarketThreeFinancialsRaw {
+    /** Expiration timestamp */
+    expirationTs: number;
+    /** PT balance in the market */
+    ptBalance: BN;
+    /** SY balance in the market */
+    syBalance: BN;
+    /** Total liquidity balance */
+    liquidityBalance: BN;
+}
 export interface MarketTwo {
     ptBalance: bigint;
     syBalance: bigint;
@@ -127,6 +297,39 @@ export interface Vault {
     cpiAccounts: CpiAccountIndexes;
     maxPySupply: bigint;
 }
+interface OrderbookFinancials {
+    expirationTs: number;
+    ytBalance: bigint;
+    syBalance: bigint;
+    ptBalance: bigint;
+    ytFeeBalance: bigint;
+    syFeeBalance: bigint;
+    ptFeeBalance: bigint;
+    stagedSy: bigint;
+}
+export interface ConfigurationOptions {
+    priceDecimals: number;
+    thresholdAmount: bigint;
+    lnMakerFeeRate: number;
+    lnTakerFeeRate: number;
+}
+export interface Orderbook {
+    vault: web3.PublicKey;
+    yieldPosition: web3.PublicKey;
+    addressLookupTable: web3.PublicKey;
+    exponentCoreProgram: web3.PublicKey;
+    syProgram: web3.PublicKey;
+    tokenEscrowSy: web3.PublicKey;
+    tokenEscrowYt: web3.PublicKey;
+    tokenEscrowPt: web3.PublicKey;
+    cpiAccountOrderbook: web3.PublicKey;
+    admin: web3.PublicKey;
+    configurationOptions: ConfigurationOptions;
+    financials: OrderbookFinancials;
+    prices: PriceTreeNode[];
+    offers: OfferNode[];
+    userEscrows: UserEscrowNode[];
+}
 export interface KaminoSyMeta {
     kaminoReserve: web3.PublicKey;
     kaminoObligation: web3.PublicKey;
@@ -175,6 +378,48 @@ export interface YieldTokenTracker {
     staged: bigint;
     lastSeenIndex: number;
 }
+export interface LpPositionRaw {
+    owner: web3.PublicKey;
+    market: web3.PublicKey;
+    lpBalance: BN;
+    emissions: {
+        trackers: {
+            staged: BN;
+            lastSeenIndex: AnchorizedPNum;
+        }[];
+    };
+    farms: {
+        trackers: {
+            staged: BN;
+            lastSeenIndex: AnchorizedPNum;
+        }[];
+    };
+}
+export interface LpPositionCLMM {
+    owner: web3.PublicKey;
+    market: web3.PublicKey;
+    feeInsideLastPt: bigint;
+    feeInsideLastSy: bigint;
+    lpBalance: bigint;
+    tokensOwedSy: bigint;
+    tokensOwedPt: bigint;
+    lowerTickIdx: number;
+    upperTickIdx: number;
+    farms: {
+        staged: bigint;
+        lastSeenIndex: number;
+    }[];
+    shareTrackers: {
+        tickIdx: number;
+        rightTickIdx: number;
+        splitEpoch: bigint;
+        lpShare: bigint;
+        emissions: {
+            staged: bigint;
+            lastSeenIndex: number;
+        }[];
+    }[];
+}
 export interface LpFarm {
     lastSeenTimestamp: number;
     farmEmissions: FarmEmissionRaw[];
@@ -195,11 +440,51 @@ export interface LiquidityNetBalanceLimits {
 export interface MarketEmissions {
     trackers: MarketEmission[];
 }
-interface MarketEmission {
+export interface MarketEmission {
     tokenEscrow: web3.PublicKey;
     lpShareIndex: AnchorizedPNum;
     lastSeenStaged: BN;
 }
+export interface YtPositionRaw {
+    owner: web3.PublicKey;
+    vault: web3.PublicKey;
+    ytBalance: BN;
+    interest: YieldTokenTrackerRaw;
+    emissions: YieldTokenTrackerRaw[];
+}
+interface YieldTokenTrackerRaw {
+    staged: BN;
+    lastSeenIndex: AnchorizedPNum;
+}
+export interface OrderbookCpiAccountsRaw {
+    syCpiAccounts: CpiAccountIndexes;
+    exponentCoreCpiAccounts: ExponentCoreCpiIndexes;
+}
+export interface PriceTreeNodeRaw {
+    key: number;
+    firstOffer: number;
+    parent: number;
+    left: number;
+    right: number;
+}
+export interface OfferNodeRaw {
+    register: number;
+    amount: BN;
+    userVaultPointer: number;
+    expiryAt: number;
+    createdAt: number;
+    virtualOffer: boolean;
+    orderTypeFlag: number;
+    fillOrKill: boolean;
+}
+export interface UserEscrowNodeRaw {
+    user: web3.PublicKey;
+    yieldIndex: BN;
+    ptAmount: BN;
+    syAmount: BN;
+    ytAmount: BN;
+    staged: number;
+}
 export declare function fetchSplStakePoolIndex({ connection, stakePool, }: {
     connection: web3.Connection;
     stakePool: web3.PublicKey;
@@ -239,15 +524,7 @@ export declare function fetchJupiterPerpsIndex({ connection, pool, lastFeeUsdRes
     lastAumUsd: BN;
     currentIndex: AnchorizedPNum;
     lastRealizedFeeUsdUpdateUnixTimestamp: number;
-}): Promise<{
-    index: number;
-    newState: {
-        lastAumUsd: BN;
-        lastRealizedFeeUsd: BN;
-        lastFeeUsdResetUnixTimestamp: number;
-        lastRealizedFeeUsdUpdateUnixTimestamp: number;
-    };
-}>;
+}): Promise<ReturnType<typeof calculateJupiterPerpsIndex>>;
 export declare function fetchPyth(connection: web3.Connection): Promise<string>;
 export declare function fetchGenericSyMetaIndex({ connection, genericSyMeta, }: {
     connection: web3.Connection;
@@ -266,12 +543,7 @@ export declare function fetchFragmetricIndex({ connection, fragmetricFund, }: {
 export declare function fetchJupiterLendIndex({ connection, jupiterLendAccount, }: {
     connection: web3.Connection;
     jupiterLendAccount: web3.PublicKey;
-}): Promise<{
-    index: number;
-    baseTokenMint: any;
-    tokenReservesLiquidity: any;
-    lendingSupplyPosition: any;
-    rewardsRateModel: any;
+}): Promise<ReturnType<typeof calculateJupiterLendIndex> & {
     rateModel: web3.PublicKey;
 }>;
 export declare function fetchKaminoVaultIndex({ connection, kaminoVaultAccount, }: {
@@ -289,11 +561,7 @@ export declare function fetchFragmetricSupportedTokenIndex({ connection, fragmet
     connection: web3.Connection;
     fragmetricFund: web3.PublicKey;
     index: number;
-}): Promise<{
-    index: number;
-    receiptTokenMint: web3.PublicKey;
-    wrappedTokenMint: web3.PublicKey;
-}>;
+}): Promise<ReturnType<typeof calculateFragmetricSupportedTokenIndex>>;
 interface AccountsInterface {
     [k: string]: web3.PublicKey;
 }
@@ -325,11 +593,15 @@ export declare function fetchSolsticeRedemptionRate({ connection, yieldPool, ves
     connection: web3.Connection;
     yieldPool: web3.PublicKey;
     vestingSchedule: web3.PublicKey;
-}): Promise<{
-    redemptionRate: number;
-    totalAssets: string;
-    sharesSupply: string;
-    vestingAmount: string;
-    totalVestedAssets: string;
-}>;
+}): Promise<ReturnType<typeof calculateSolsticeRedemptionRate>>;
+export declare function fetchReflectRedemptionRate({ connection, oracle, }: {
+    connection: web3.Connection;
+    oracle: web3.PublicKey;
+}): Promise<number>;
+export declare function fetchOreExchangeRate({ connection, storeMint, stakeAccount, treasury, }: {
+    connection: web3.Connection;
+    storeMint: web3.PublicKey;
+    stakeAccount: web3.PublicKey;
+    treasury: web3.PublicKey;
+}): Promise<number>;
 export {};