@alphafi/alphafi-sdk 0.0.107 → 1.0.1

package/dist/cjs/models/strategyContext.d.ts

@@ -0,0 +1,150 @@
+/**
+ * StrategyContext
+ *
+ * Shared services + lazily-loaded cached on-chain/API data used by strategies.
+ * All data is loaded on-demand with automatic caching and TTL expiration.
+ */
+import { Blockchain } from './blockchain.js';
+import { CoinInfoProvider } from './coinInfoProvider.js';
+import { PoolLabel } from '../strategies/strategy.js';
+import { Decimal } from 'decimal.js';
+import { AlphaFiReceipt, AprData, CoinInfo, DistributorObject, SlushPositionCap } from './types.js';
+import { SuiClient } from '@mysten/sui/client/index.js';
+import { ProtocolPoolIds } from '../utils/poolMap.js';
+export declare class StrategyContext {
+    readonly apiBaseUrl: string;
+    blockchain: Blockchain;
+    coinInfoProvider: CoinInfoProvider;
+    private allPoolLabelsCache;
+    private poolLabelCache;
+    private aprMapCache;
+    private alphalendTvlCache;
+    private naviTvlCache;
+    private bucketTvlCache;
+    private distributorCache;
+    private slushPositionCapsCache;
+    private alphaFiReceiptsCache;
+    private slushPositionsCache;
+    private alphaFiPositionsCache;
+    constructor(network: 'mainnet' | 'testnet' | 'devnet' | 'localnet', suiClient: SuiClient, apiBaseUrl?: string);
+    /**
+     * Get all pool labels. Lazily loaded and cached.
+     * Also populates the per-pool cache for subsequent individual lookups.
+     */
+    getPoolLabels(): Promise<Map<string, PoolLabel>>;
+    /**
+     * Get a specific pool label by ID.
+     * Uses per-pool cache and fetches only the requested pool if not cached.
+     */
+    getPoolLabel(poolId: string): Promise<PoolLabel | undefined>;
+    /**
+     * Get multiple pool labels by IDs.
+     * Efficiently fetches only uncached pools in a single API call.
+     */
+    getPoolLabelsByIds(poolIds: string[]): Promise<Map<string, PoolLabel>>;
+    /**
+     * Fetch pool labels by IDs from the API.
+     * Supports fetching multiple pools in a single request.
+     */
+    private fetchPoolLabelsByIds;
+    /**
+     * Fetch all pool labels from the API.
+     */
+    private fetchAllPoolLabels;
+    /**
+     * Parse a single pool label entry from the API response.
+     */
+    private parsePoolLabelEntry;
+    /**
+     * Get APR map. Lazily loaded and cached.
+     */
+    getAprMap(): Promise<Map<string, AprData>>;
+    /**
+     * Get APR/APY data for a specific pool.
+     */
+    getAprData(poolId: string): Promise<AprData>;
+    private fetchAprData;
+    /**
+     * Get the distributor object for ALPHA mining calculations.
+     */
+    getDistributorObject(): Promise<DistributorObject>;
+    private fetchDistributorObject;
+    private parseDistributorObject;
+    /**
+     * Get AlphaLend TVL map. Lazily loaded and cached.
+     */
+    getAlphaLendTvlMap(): Promise<Map<string, Decimal>>;
+    /**
+     * Get Alphalend TVL for a specific coin type.
+     */
+    getAlphaLendTvl(coinType: string): Promise<Decimal>;
+    private fetchAlphaLendTvl;
+    /**
+     * Get Navi TVL map. Lazily loaded and cached.
+     */
+    getNaviTvlMap(): Promise<Map<string, Decimal>>;
+    /**
+     * Get Navi TVL (USD) by poolId.
+     */
+    getNaviTvlByPoolId(poolId: string): Promise<Decimal>;
+    private fetchNaviTvl;
+    /**
+     * Get Bucket TVL in BUCK units. Lazily loaded and cached.
+     */
+    getBucketTvl(): Promise<Decimal>;
+    private fetchBucketTvl;
+    /**
+     * Get coin decimals (defaults to 9 if unknown).
+     */
+    getCoinDecimals(coinType: string): Promise<number>;
+    /**
+     * Get coin price (USD).
+     */
+    getCoinPrice(coinType: string): Promise<Decimal>;
+    getCoinsBySymbols(symbols: string[]): Promise<CoinInfo[]>;
+    private getCoinTypeBySymbol;
+    /**
+     * Get pool ID by coin symbols and protocol.
+     */
+    getPoolIdBySymbolsAndProtocol(symbolA: string, symbolB: string, protocol: 'cetus' | 'bluefin' | 'mmt'): Promise<string>;
+    /**
+     * Lookup pool IDs by coin symbols (order-agnostic).
+     */
+    getPoolIdsBySymbols(symbolA: string, symbolB: string): Promise<ProtocolPoolIds>;
+    /**
+     * Lookup pool IDs by coin types (order-agnostic).
+     */
+    getPoolIdsByTypes(coinTypeA: string, coinTypeB: string): ProtocolPoolIds;
+    /**
+     * Fetch all slush positions for a user, grouped by poolId.
+     */
+    getAllSlushPositions(userAddress: string): Promise<Map<string, any[]>>;
+    /**
+     * Get slush positions for a user in a specific pool.
+     */
+    getSlushPosition(userAddress: string, poolId: string): Promise<any[]>;
+    /**
+     * Fetch and cache slush position caps for a user.
+     */
+    getSlushPositionCaps(userAddress: string): Promise<SlushPositionCap[]>;
+    private parseSlushPositionCap;
+    /**
+     * Fetch AlphaFi positions for a user, grouped by poolId.
+     */
+    getPositionsFromAlphaFiReceipts(userAddress: string): Promise<Map<string, any[]>>;
+    /**
+     * Get AlphaFi receipts for a user (parsed + cached).
+     */
+    getAlphaFiReceipts(userAddress: string): Promise<AlphaFiReceipt[]>;
+    private parseAlphaFiReceipts;
+    private asciiToString;
+    /**
+     * Clear all caches. Useful for forcing fresh data.
+     */
+    clearAllCaches(): void;
+    /**
+     * Clear user-specific caches for a given address.
+     */
+    clearUserCaches(userAddress: string): void;
+}
+//# sourceMappingURL=strategyContext.d.ts.map

package/dist/cjs/models/strategyContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategyContext.d.ts","sourceRoot":"","sources":["../../../src/models/strategyContext.ts"],"names":[],"mappings":"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"}