@exponent-labs/exponent-fetcher 0.0.3

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [0.0.3](https://github.com/exponent-finance/exponent-core/compare/@exponent-labs/exponent-fetcher@0.0.2...@exponent-labs/exponent-fetcher@0.0.3) (2025-03-03)
+
+**Note:** Version bump only for package @exponent-labs/exponent-fetcher
+
+
+
+
+
+## [0.0.2](https://github.com/exponent-finance/exponent-core/compare/@exponent-labs/exponent-fetcher@0.0.1...@exponent-labs/exponent-fetcher@0.0.2) (2025-03-03)
+
+**Note:** Version bump only for package @exponent-labs/exponent-fetcher

package/build/exponentFetcher.d.ts

@@ -0,0 +1,242 @@
+/// <reference types="bn.js" />
+import { BN, Program, Wallet, web3 } from "@coral-xyz/anchor";
+import { ExponentCore } from "@exponent-labs/exponent-idl";
+import { KaminoLendStandard } from "@exponent-labs/kamino-sy-idl";
+import { MarginfiStandard } from "@exponent-labs/marginfi-sy-idl";
+import { JitoRestakingStandard } from "@exponent-labs/jito-restaking-sy-idl";
+import { AnchorizedPNum, AnchorizedPNumJson, MarginfiSyMeta, VaultEmission, VaultEmissionJson, CpiAccountIndexes, JitoRestakingSyMetaAccount, InterfaceType, SyEmissionRaw, GenericSyMetaAccount, PerenaSyMetaAccount } from "@exponent-labs/exponent-types";
+import Decimal from "decimal.js";
+import { PerenaStandard } from "@exponent-labs/perena-sy-idl";
+import { GenericStandard } from "@exponent-labs/generic-sy-idl";
+export declare function serializeAnchorizedPNumFromJson(pnum: AnchorizedPNum): AnchorizedPNumJson;
+export declare function deserializeAnchorizedPNumFromJson(serialized: AnchorizedPNumJson): AnchorizedPNum;
+export declare class MyWallet implements Wallet {
+    readonly payer: web3.Keypair;
+    constructor(payer: web3.Keypair);
+    signTransaction<T extends web3.Transaction | web3.VersionedTransaction>(tx: T): Promise<T>;
+    signAllTransactions<T extends web3.Transaction | web3.VersionedTransaction>(txs: T[]): Promise<T[]>;
+    get publicKey(): web3.PublicKey;
+}
+export declare class ExponentFetcher {
+    program: Program<ExponentCore>;
+    marginfiSyProgram: Program<MarginfiStandard>;
+    kaminoSyProgram: Program<KaminoLendStandard>;
+    jitoRestakingSyProgram: Program<JitoRestakingStandard>;
+    perenaSyProgram: Program<PerenaStandard>;
+    genericStandardProgram: Program<GenericStandard>;
+    connection: web3.Connection;
+    coreProgramId: web3.PublicKey;
+    marginfiSyProgramId: web3.PublicKey;
+    kaminoSyProgramId: web3.PublicKey;
+    jitoRestakingSyProgramId: web3.PublicKey;
+    perenaSyProgramId: web3.PublicKey;
+    genericStandardProgramId: web3.PublicKey;
+    constructor({ connection, coreProgramId, marginfiSyProgramId, kaminoSyProgramId, jitoRestakingSyProgramId, perenaSyProgramId, genericStandardProgramId, }: {
+        connection: web3.Connection;
+        coreProgramId?: web3.PublicKey;
+        marginfiSyProgramId?: web3.PublicKey;
+        kaminoSyProgramId?: web3.PublicKey;
+        jitoRestakingSyProgramId?: web3.PublicKey;
+        perenaSyProgramId?: web3.PublicKey;
+        genericStandardProgramId?: web3.PublicKey;
+    });
+    fetchVault(address: web3.PublicKey): Promise<Vault>;
+    fetchMarket(address: web3.PublicKey): Promise<MarketTwo>;
+    fetchMarginfiSyMeta(address: web3.PublicKey): Promise<MarginfiSyMeta>;
+    fetchMarginfiSyPosition(address: web3.PublicKey): Promise<SyPosition>;
+    fetchKaminoSyPosition(address: web3.PublicKey): Promise<SyPosition>;
+    fetchJitoRestakingSyPosition(address: web3.PublicKey): Promise<SyPosition>;
+    fetchPerenaSyPosition(address: web3.PublicKey): Promise<SyPosition>;
+    fetchGenericSyPosition(address: web3.PublicKey): Promise<SyPosition>;
+    fetchKaminoSyMeta(address: web3.PublicKey): Promise<KaminoSyMeta>;
+    fetchLpPosition(address: web3.PublicKey): Promise<LpPosition>;
+    fetchYtPosition(address: web3.PublicKey): Promise<YtPosition>;
+    fetchJitoRestakingSyMeta(address: web3.PublicKey): Promise<JitoRestakingSyMetaAccount>;
+    fetchPerenaSyMeta(address: web3.PublicKey): Promise<PerenaSyMetaAccount>;
+    fetchGenericSyMeta(address: web3.PublicKey): Promise<GenericSyMetaAccount>;
+}
+export declare function fetchKaminoReserve(address: web3.PublicKey, connection: web3.Connection): Promise<{
+    lendingMarket: web3.PublicKey;
+    baseMint: web3.PublicKey;
+    assetShareValue: Decimal;
+}>;
+export declare function serializeEmission(emission: VaultEmission): VaultEmissionJson;
+export declare function deserializeEmission(emission: VaultEmissionJson): VaultEmission;
+export interface MarketTwo {
+    ptBalance: bigint;
+    syBalance: bigint;
+    rateScalarRoot: number;
+    lnFeeRateRoot: number;
+    lastLnImpliedRate: number;
+    expirationTs: number;
+    addressLookupTable: web3.PublicKey;
+    mintSy: web3.PublicKey;
+    mintPt: web3.PublicKey;
+    mintLp: web3.PublicKey;
+    vault: web3.PublicKey;
+    tokenPtEscrow: web3.PublicKey;
+    tokenSyEscrow: web3.PublicKey;
+    tokenLpEscrow: web3.PublicKey;
+    tokenFeeTreasurySy: web3.PublicKey;
+    syProgram: web3.PublicKey;
+    selfAddress: web3.PublicKey;
+    statusFlags: number;
+    lpEscrowAmount: bigint;
+    maxLpSupply: bigint;
+    cpiAccounts: CpiAccountIndexes;
+    feeTreasurySyBps: number;
+    isCurrentFlashSwap: boolean;
+    lpFarm: LpFarm;
+    emissions: {
+        trackers: {
+            tokenEscrow: web3.PublicKey;
+            lpShareIndex: number;
+            lastSeenStaged: number;
+        }[];
+    };
+    liquidityNetBalanceLimits: LiquidityNetBalanceLimits;
+}
+export interface Vault {
+    syProgram: web3.PublicKey;
+    mintSy: web3.PublicKey;
+    mintYt: web3.PublicKey;
+    mintPt: web3.PublicKey;
+    escrowSy: web3.PublicKey;
+    startTs: number;
+    duration: number;
+    authority: web3.PublicKey;
+    lastSeenSyExchangeRate: number;
+    allTimeHighSyExchangeRate: number;
+    finalSyExchangeRate: number;
+    addressLookupTable: web3.PublicKey;
+    totalSyInEscrow: bigint;
+    ptSupply: bigint;
+    syForPt: bigint;
+    yieldPosition: web3.PublicKey;
+    escrowYt: web3.PublicKey;
+    treasurySy: BN;
+    treasurySyTokenAccount: web3.PublicKey;
+    interestBpsFee: number;
+    emissions: VaultEmission[];
+    status: number;
+    minOpSizeStrip: bigint;
+    minOpSizeMerge: bigint;
+    cpiAccounts: CpiAccountIndexes;
+    maxPySupply: bigint;
+}
+export interface KaminoSyMeta {
+    kaminoReserve: web3.PublicKey;
+    kaminoObligation: web3.PublicKey;
+    kaminoFarm: web3.PublicKey;
+    kaminoUserMetadata: web3.PublicKey;
+    mintSy: web3.PublicKey;
+    /** Where the SY tokens get deposited */
+    tokenSyEscrow: web3.PublicKey;
+    minMintSize: BN;
+    minRedeemSize: BN;
+    emissions: SyEmissionRaw[];
+}
+export interface SyPosition {
+    balanceSy: bigint;
+    owner: web3.PublicKey;
+    emissions: {
+        /** Last seen index for SY-to-emission exchange rate */
+        lastSeenIndex: number;
+        /** mint of emission token */
+        mint: web3.PublicKey;
+        /** How many emissions are staged to claim */
+        staged: bigint;
+    }[];
+}
+export interface LpPosition {
+    owner: web3.PublicKey;
+    market: web3.PublicKey;
+    lpBalance: bigint;
+    emissions: {
+        staged: bigint;
+        lastSeenIndex: number;
+    }[];
+    farms: {
+        staged: bigint;
+        lastSeenIndex: number;
+    }[];
+}
+export interface YtPosition {
+    owner: web3.PublicKey;
+    vault: web3.PublicKey;
+    ytBalance: bigint;
+    interest: YieldTokenTracker;
+    emissions: YieldTokenTracker[];
+}
+export interface YieldTokenTracker {
+    staged: bigint;
+    lastSeenIndex: number;
+}
+export interface LpFarm {
+    lastSeenTimestamp: number;
+    farmEmissions: FarmEmissionRaw[];
+}
+interface FarmEmissionRaw {
+    mint: web3.PublicKey;
+    tokenRate: BN;
+    expiryTimestamp: number;
+    index: AnchorizedPNum;
+}
+export interface LiquidityNetBalanceLimits {
+    windowStartTimestamp: number;
+    windowStartNetBalance: BN;
+    maxNetBalanceChangeNegativePercentage: number;
+    maxNetBalanceChangePositivePercentage: number;
+    windowDurationSeconds: number;
+}
+export interface MarketEmissions {
+    trackers: MarketEmission[];
+}
+interface MarketEmission {
+    tokenEscrow: web3.PublicKey;
+    lpShareIndex: AnchorizedPNum;
+    lastSeenStaged: BN;
+}
+export declare function fetchPerenaStablePoolData({ connection, perenaStablePool, }: {
+    connection: web3.Connection;
+    perenaStablePool: web3.PublicKey;
+}): Promise<{
+    lpSupply: bigint;
+    invT: bigint;
+    exchangeRate: string;
+    lpMint: web3.PublicKey;
+}>;
+/**
+ * Fetch the exchange rate of a JitoRestaking vault
+ * @param connection
+ * @param accounts "remaining accounts"
+ * @param vaultAddress "address of the Jito Restaking vault"
+ * @param interfaceType "interface type of the Jito Restaking interface program that Exponent manages"
+ * @returns
+ */
+export declare function fetchJitoRestaking(connection: web3.Connection, accounts: web3.PublicKey[], interfaceType: InterfaceType, vaultAddress: web3.PublicKey): Promise<{
+    mintBase: web3.PublicKey;
+    exchangeRateUnderlying: number;
+    exchangeRate: string;
+}>;
+export declare function fetchPyth(connection: web3.Connection): Promise<string>;
+export declare function fetchGenericSyMetaIndex({ connection, genericSyMeta, }: {
+    connection: web3.Connection;
+    genericSyMeta: web3.PublicKey;
+}): Promise<{
+    index: number;
+}>;
+export declare function fetchFragmetricIndex({ connection, fragmetricFund, }: {
+    connection: web3.Connection;
+    fragmetricFund: web3.PublicKey;
+}): Promise<{
+    index: number;
+    receiptTokenMint: web3.PublicKey;
+    wrappedTokenMint: web3.PublicKey;
+}>;
+export declare function fetchMeteoraUsdcUsdtIndex({ connection, accounts, onChainTime, }: {
+    connection: web3.Connection;
+    accounts: any;
+    onChainTime: number;
+}): Promise<number>;
+export {};