@alphafi/alphafi-sdk 0.0.107 → 1.0.1

package/dist/cjs/core/index.d.ts

@@ -0,0 +1,159 @@
+/**
+ * AlphaFi SDK - A comprehensive DeFi toolkit for the Sui blockchain.
+ * Provides easy access to lending, LP farming, leveraged yield farming, and more.
+ *
+ * All data is lazily loaded on-demand with automatic caching.
+ */
+import { Transaction } from '@mysten/sui/transactions';
+import type { PoolBalance, PoolData, UserPortfolioData } from '../models/types.js';
+import { AlphaFiSDKConfig, CetusSwapOptions, CetusSwapQuoteOptions, ClaimAirdropOptions, ClaimOptions, ClaimWithdrawAlphaOptions, DepositOptions, EstimateLpAmountsOptions, WithdrawOptions } from './types.js';
+import { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';
+import { StrategyType } from '../strategies/strategy.js';
+export type { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';
+/**
+ * Main AlphaFi SDK class - your gateway to DeFi on Sui.
+ * Supports multiple DeFi strategies with lazy-loaded data.
+ *
+ * @example
+ * ```typescript
+ * const sdk = new AlphaFiSDK({ suiClient, network: 'mainnet' });
+ * const pools = await sdk.getPoolsData();
+ * const portfolio = await sdk.getUserPortfolio(userAddress);
+ * ```
+ */
+export declare class AlphaFiSDK {
+    private config;
+    private strategyContext;
+    private protocol;
+    private portfolio;
+    constructor(config: AlphaFiSDKConfig);
+    /**
+     * Get comprehensive data for all available DeFi pools.
+     *
+     * @param strategiesType - Optional array to filter by strategy types (e.g., ['Lending', 'Lp'])
+     * @returns Map of pool ID to pool data (APY, TVL, supported assets, etc.)
+     */
+    getPoolsData(strategiesType?: StrategyType[]): Promise<Map<string, PoolData>>;
+    /**
+     * Get data for a single pool.
+     *
+     * @param poolId - The ID of the pool to get data for
+     * @returns Pool data including APR, TVL, LP breakdown, parent LP breakdown, current LP pool price, and position range
+     */
+    getSinglePoolData(poolId: string): Promise<PoolData>;
+    /**
+     * Get balance for a single pool.
+     *
+     * @param address - The address of the user to get balance for
+     * @param poolId - The ID of the pool to get balance for
+     * @returns Pool balance including token amounts and USD value
+     */
+    getUserSinglePoolBalance(address: string, poolId: string): Promise<PoolBalance>;
+    /**
+     * Get complete portfolio summary for a user address.
+     *
+     * @param address - User's wallet address
+     * @param strategiesType - Optional array to filter by strategy types
+     * @returns Portfolio data including net worth, aggregated APY, alpha rewards, and individual pool balances
+     */
+    getUserPortfolio(address: string, strategiesType?: StrategyType[]): Promise<UserPortfolioData>;
+    /**
+     * Deposit assets into a DeFi pool to start earning yield.
+     *
+     * Supports all pool types:
+     * - Single-asset pools (Lending, Looping, Alpha Vaults): Deposit one token
+     * - LP pools (Lp, AutobalanceLp, FungibleLp): Deposit tokens to provide liquidity
+     * - LYF pools: Deposit SUI for leveraged yield farming
+     *
+     * @param options - Deposit configuration including pool ID, amount, and user address
+     * @returns Transaction object ready for signing and execution
+     */
+    deposit(options: DepositOptions): Promise<Transaction>;
+    /**
+     * Calculate required token amounts for balanced LP deposits.
+     *
+     * Given an amount of one token, calculates how much of the other token
+     * is needed to maintain the pool's balance ratio.
+     *
+     * @param options - Pool ID, input amount, and which token the amount represents
+     * @returns Tuple of [tokenA amount, tokenB amount] required for deposit
+     */
+    estimateLpAmounts(options: EstimateLpAmountsOptions): Promise<[string, string]>;
+    /**
+     * Withdraw assets from a DeFi pool.
+     *
+     * Supports partial or full withdrawals from any pool type.
+     * For leveraged positions (Looping, LYF), automatically handles
+     * deleveraging and debt repayment.
+     *
+     * @param options - Withdrawal configuration including amount or withdrawMax flag
+     * @returns Transaction object ready for signing and execution
+     */
+    withdraw(options: WithdrawOptions): Promise<Transaction>;
+    /**
+     * Initiate ALPHA token withdrawal (creates withdrawal ticket).
+     * ALPHA withdrawals require a 2-step process due to unlock periods.
+     *
+     * @param options - Withdrawal configuration (amount and user address)
+     * @returns Transaction to create withdrawal ticket
+     */
+    initiateWithdrawAlpha(options: WithdrawOptions): Promise<Transaction>;
+    /**
+     * Complete ALPHA token withdrawal using previously created ticket.
+     *
+     * @param options - Withdrawal claim configuration with ticket ID and user address
+     * @returns Transaction to claim the withdrawn ALPHA tokens
+     */
+    claimWithdrawAlpha(options: ClaimWithdrawAlphaOptions): Promise<Transaction>;
+    /**
+     * Claim available airdrop tokens.
+     *
+     * @param options - Airdrop claim configuration with user address and transfer preference
+     * @returns Transaction to claim airdrop rewards
+     */
+    claimAirdrop(options: ClaimAirdropOptions): Promise<Transaction>;
+    /**
+     * Claim accumulated rewards from all pools.
+     *
+     * Collects all available rewards including:
+     * - ALPHA mining rewards
+     * - Pool-specific yield rewards
+     * - Protocol incentives
+     *
+     * @param options - User address and optional pool filter
+     * @returns Transaction to claim all available rewards
+     */
+    claim(options: ClaimOptions): Promise<Transaction>;
+    /**
+     * Vote on a proposal.
+     *
+     * @param voteIndex - The index of the vote to cast
+     * @param proposalId - The ID of the proposal to vote on
+     * @returns Transaction object ready for signing and execution
+     */
+    vote(voteIndex: number, proposalId: string): Promise<Transaction | undefined>;
+    /**
+     * Get quote for token swap via Cetus aggregator.
+     *
+     * @param options - Swap quote configuration with token types and amount
+     * @returns Router data with swap path and expected output, or undefined if no route found
+     */
+    getCetusSwapQuote(options: CetusSwapQuoteOptions): Promise<RouterDataV3 | undefined>;
+    /**
+     * Execute token swap using Cetus aggregator.
+     *
+     * @param options - Swap execution configuration with router data and slippage tolerance
+     * @returns Transaction object ready for signing and execution
+     */
+    cetusSwapTxb(options: CetusSwapOptions): Promise<Transaction>;
+    /**
+     * Clear all cached data. Useful for forcing fresh data.
+     */
+    clearCaches(): void;
+    /**
+     * Clear cached data for a specific user.
+     * Call this after a user completes a transaction to refresh their portfolio.
+     */
+    clearUserCaches(userAddress: string): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAKvD,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,yBAAyB,EACzB,cAAc,EACd,wBAAwB,EACxB,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAY,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKnE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAY;gBAEjB,MAAM,EAAE,gBAAgB;IAOpC;;;;;OAKG;IACG,YAAY,CAAC,cAAc,CAAC,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAInF;;;;;OAKG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAK1D;;;;;;OAMG;IACG,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAKrF;;;;;;OAMG;IACG,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,YAAY,EAAE,GAC9B,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;;;;;;;;;OAUG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAY5D;;;;;;;;OAQG;IACG,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAKrF;;;;;;;;;OASG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAO9D;;;;;;OAMG;IACG,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAU3E;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,WAAW,CAAC;IAUlF;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAUtE;;;;;;;;;;OAUG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA4BxD;;;;;;OAMG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAcnF;;;;;OAKG;IACG,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAU1F;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAKnE;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;;OAGG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;CAG3C"}

package/dist/cjs/core/index.js

@@ -0,0 +1,253 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlphaFiSDK = void 0;
+/**
+ * AlphaFi SDK - A comprehensive DeFi toolkit for the Sui blockchain.
+ * Provides easy access to lending, LP farming, leveraged yield farming, and more.
+ *
+ * All data is lazily loaded on-demand with automatic caching.
+ */
+const transactions_1 = require("@mysten/sui/transactions");
+const protocol_js_1 = require("../models/protocol.js");
+const portfolio_js_1 = require("../models/portfolio.js");
+const strategyContext_js_1 = require("../models/strategyContext.js");
+const swap_js_1 = require("../models/swap.js");
+const constants_js_1 = require("../utils/constants.js");
+/**
+ * Main AlphaFi SDK class - your gateway to DeFi on Sui.
+ * Supports multiple DeFi strategies with lazy-loaded data.
+ *
+ * @example
+ * ```typescript
+ * const sdk = new AlphaFiSDK({ suiClient, network: 'mainnet' });
+ * const pools = await sdk.getPoolsData();
+ * const portfolio = await sdk.getUserPortfolio(userAddress);
+ * ```
+ */
+class AlphaFiSDK {
+    config;
+    strategyContext;
+    protocol;
+    portfolio;
+    constructor(config) {
+        this.config = config;
+        this.strategyContext = new strategyContext_js_1.StrategyContext(config.network, config.suiClient, config.apiBaseUrl);
+        this.protocol = new protocol_js_1.Protocol(this.strategyContext);
+        this.portfolio = new portfolio_js_1.Portfolio(this.protocol, this.strategyContext);
+    }
+    /**
+     * Get comprehensive data for all available DeFi pools.
+     *
+     * @param strategiesType - Optional array to filter by strategy types (e.g., ['Lending', 'Lp'])
+     * @returns Map of pool ID to pool data (APY, TVL, supported assets, etc.)
+     */
+    async getPoolsData(strategiesType) {
+        return this.protocol.getPoolsData(strategiesType);
+    }
+    /**
+     * Get data for a single pool.
+     *
+     * @param poolId - The ID of the pool to get data for
+     * @returns Pool data including APR, TVL, LP breakdown, parent LP breakdown, current LP pool price, and position range
+     */
+    async getSinglePoolData(poolId) {
+        const strategy = await this.protocol.getSinglePoolStrategy(poolId);
+        return strategy.getData();
+    }
+    /**
+     * Get balance for a single pool.
+     *
+     * @param address - The address of the user to get balance for
+     * @param poolId - The ID of the pool to get balance for
+     * @returns Pool balance including token amounts and USD value
+     */
+    async getUserSinglePoolBalance(address, poolId) {
+        const strategy = await this.portfolio.getPoolStrategy(address, poolId);
+        return strategy.getBalance(address);
+    }
+    /**
+     * Get complete portfolio summary for a user address.
+     *
+     * @param address - User's wallet address
+     * @param strategiesType - Optional array to filter by strategy types
+     * @returns Portfolio data including net worth, aggregated APY, alpha rewards, and individual pool balances
+     */
+    async getUserPortfolio(address, strategiesType) {
+        return this.portfolio.getUserPortfolio(address, strategiesType);
+    }
+    /**
+     * Deposit assets into a DeFi pool to start earning yield.
+     *
+     * Supports all pool types:
+     * - Single-asset pools (Lending, Looping, Alpha Vaults): Deposit one token
+     * - LP pools (Lp, AutobalanceLp, FungibleLp): Deposit tokens to provide liquidity
+     * - LYF pools: Deposit SUI for leveraged yield farming
+     *
+     * @param options - Deposit configuration including pool ID, amount, and user address
+     * @returns Transaction object ready for signing and execution
+     */
+    async deposit(options) {
+        const poolLabel = await this.strategyContext.getPoolLabel(options.poolId);
+        if (!poolLabel) {
+            throw new Error(`Pool with ID ${options.poolId} not found`);
+        }
+        const tx = new transactions_1.Transaction();
+        const strategy = await this.portfolio.getPoolStrategy(options.address, options.poolId);
+        await strategy.deposit(tx, options);
+        return tx;
+    }
+    /**
+     * Calculate required token amounts for balanced LP deposits.
+     *
+     * Given an amount of one token, calculates how much of the other token
+     * is needed to maintain the pool's balance ratio.
+     *
+     * @param options - Pool ID, input amount, and which token the amount represents
+     * @returns Tuple of [tokenA amount, tokenB amount] required for deposit
+     */
+    async estimateLpAmounts(options) {
+        const strategy = await this.protocol.getSinglePoolStrategy(options.poolId);
+        return strategy.getOtherAmount(options.amount, options.isAmountA);
+    }
+    /**
+     * Withdraw assets from a DeFi pool.
+     *
+     * Supports partial or full withdrawals from any pool type.
+     * For leveraged positions (Looping, LYF), automatically handles
+     * deleveraging and debt repayment.
+     *
+     * @param options - Withdrawal configuration including amount or withdrawMax flag
+     * @returns Transaction object ready for signing and execution
+     */
+    async withdraw(options) {
+        const tx = new transactions_1.Transaction();
+        const strategy = await this.portfolio.getPoolStrategy(options.address, options.poolId);
+        await strategy.withdraw(tx, options);
+        return tx;
+    }
+    /**
+     * Initiate ALPHA token withdrawal (creates withdrawal ticket).
+     * ALPHA withdrawals require a 2-step process due to unlock periods.
+     *
+     * @param options - Withdrawal configuration (amount and user address)
+     * @returns Transaction to create withdrawal ticket
+     */
+    async initiateWithdrawAlpha(options) {
+        const tx = new transactions_1.Transaction();
+        const strategy = (await this.portfolio.getPoolStrategy(options.address, '0x06a4922346ae433e9a2fff4db900d760e0cbfdef748f48385f430ef4d042a6f8'));
+        await strategy.withdraw(tx, options);
+        return tx;
+    }
+    /**
+     * Complete ALPHA token withdrawal using previously created ticket.
+     *
+     * @param options - Withdrawal claim configuration with ticket ID and user address
+     * @returns Transaction to claim the withdrawn ALPHA tokens
+     */
+    async claimWithdrawAlpha(options) {
+        const tx = new transactions_1.Transaction();
+        const strategy = (await this.portfolio.getPoolStrategy(options.address, '0x06a4922346ae433e9a2fff4db900d760e0cbfdef748f48385f430ef4d042a6f8'));
+        await strategy.claimWithdraw(tx, options.ticketId, options.address);
+        return tx;
+    }
+    /**
+     * Claim available airdrop tokens.
+     *
+     * @param options - Airdrop claim configuration with user address and transfer preference
+     * @returns Transaction to claim airdrop rewards
+     */
+    async claimAirdrop(options) {
+        const tx = new transactions_1.Transaction();
+        const strategy = (await this.portfolio.getPoolStrategy(options.address, '0x06a4922346ae433e9a2fff4db900d760e0cbfdef748f48385f430ef4d042a6f8'));
+        await strategy.claimAirdrop(tx, options.address, options.transferToWallet);
+        return tx;
+    }
+    /**
+     * Claim accumulated rewards from all pools.
+     *
+     * Collects all available rewards including:
+     * - ALPHA mining rewards
+     * - Pool-specific yield rewards
+     * - Protocol incentives
+     *
+     * @param options - User address and optional pool filter
+     * @returns Transaction to claim all available rewards
+     */
+    async claim(options) {
+        const tx = new transactions_1.Transaction();
+        const alphaReceipt = tx.moveCall({
+            target: `0x1::option::none`,
+            typeArguments: [constants_js_1.LEGACY_ALPHA_POOL_RECEIPT],
+            arguments: [],
+        });
+        let strategies = new Map();
+        if (options.poolId) {
+            strategies.set(options.poolId, await this.portfolio.getPoolStrategy(options.address, options.poolId));
+        }
+        else {
+            strategies = await this.portfolio.getAllPoolStrategies(options.address);
+        }
+        strategies.forEach((strategy) => {
+            strategy.claimRewards(tx, alphaReceipt);
+        });
+        tx.moveCall({
+            target: `${constants_js_1.PACKAGE_IDS.ALPHA_LATEST}::alphapool::transfer_receipt_option`,
+            arguments: [tx.object(constants_js_1.VERSIONS.ALPHA_VERSIONS[1]), alphaReceipt],
+        });
+        return tx;
+    }
+    /**
+     * Vote on a proposal.
+     *
+     * @param voteIndex - The index of the vote to cast
+     * @param proposalId - The ID of the proposal to vote on
+     * @returns Transaction object ready for signing and execution
+     */
+    async vote(voteIndex, proposalId) {
+        const tx = new transactions_1.Transaction();
+        if (voteIndex === undefined) {
+            console.error('Vote index is undefined');
+            return undefined;
+        }
+        tx.moveCall({
+            target: `0x79729faced2e6294254e555424184f71c8c043a1dbe3447b88613704a7276710::governance::vote`,
+            arguments: [tx.object(proposalId), tx.pure.u8(voteIndex), tx.object('0x6')],
+        });
+        return tx;
+    }
+    /**
+     * Get quote for token swap via Cetus aggregator.
+     *
+     * @param options - Swap quote configuration with token types and amount
+     * @returns Router data with swap path and expected output, or undefined if no route found
+     */
+    async getCetusSwapQuote(options) {
+        const swap = new swap_js_1.CetusSwap(this.config.network);
+        return await swap.getCetusSwapQuote(options.from, options.target, options.amount, options.byAmountIn);
+    }
+    /**
+     * Execute token swap using Cetus aggregator.
+     *
+     * @param options - Swap execution configuration with router data and slippage tolerance
+     * @returns Transaction object ready for signing and execution
+     */
+    async cetusSwapTxb(options) {
+        const swap = new swap_js_1.CetusSwap(this.config.network);
+        return await swap.cetusSwapTokensTxb(options.router, options.slippage);
+    }
+    /**
+     * Clear all cached data. Useful for forcing fresh data.
+     */
+    clearCaches() {
+        this.strategyContext.clearAllCaches();
+    }
+    /**
+     * Clear cached data for a specific user.
+     * Call this after a user completes a transaction to refresh their portfolio.
+     */
+    clearUserCaches(userAddress) {
+        this.strategyContext.clearUserCaches(userAddress);
+    }
+}
+exports.AlphaFiSDK = AlphaFiSDK;
+//# sourceMappingURL=index.js.map

package/dist/cjs/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * AlphaFi SDK - A comprehensive DeFi toolkit for the Sui blockchain.\n * Provides easy access to lending, LP farming, leveraged yield farming, and more.\n *\n * All data is lazily loaded on-demand with automatic caching.\n */\nimport { Transaction } from '@mysten/sui/transactions';\nimport { Protocol } from '../models/protocol.js';\nimport { Portfolio } from '../models/portfolio.js';\nimport { StrategyContext } from '../models/strategyContext.js';\nimport { CetusSwap } from '../models/swap.js';\nimport type { PoolBalance, PoolData, UserPortfolioData } from '../models/types.js';\nimport {\n  AlphaFiSDKConfig,\n  CetusSwapOptions,\n  CetusSwapQuoteOptions,\n  ClaimAirdropOptions,\n  ClaimOptions,\n  ClaimWithdrawAlphaOptions,\n  DepositOptions,\n  EstimateLpAmountsOptions,\n  WithdrawOptions,\n} from './types.js';\nimport { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';\nimport { Strategy, StrategyType } from '../strategies/strategy.js';\nimport { LEGACY_ALPHA_POOL_RECEIPT, PACKAGE_IDS, VERSIONS } from '../utils/constants.js';\nimport { AlphaVaultStrategy } from '../strategies/alphaVault.js';\n\n// Re-export types for external use\nexport type { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';\n\n/**\n * Main AlphaFi SDK class - your gateway to DeFi on Sui.\n * Supports multiple DeFi strategies with lazy-loaded data.\n *\n * @example\n * ```typescript\n * const sdk = new AlphaFiSDK({ suiClient, network: 'mainnet' });\n * const pools = await sdk.getPoolsData();\n * const portfolio = await sdk.getUserPortfolio(userAddress);\n * ```\n */\nexport class AlphaFiSDK {\n  private config: AlphaFiSDKConfig;\n  private strategyContext: StrategyContext;\n  private protocol: Protocol;\n  private portfolio: Portfolio;\n\n  constructor(config: AlphaFiSDKConfig) {\n    this.config = config;\n    this.strategyContext = new StrategyContext(config.network, config.suiClient, config.apiBaseUrl);\n    this.protocol = new Protocol(this.strategyContext);\n    this.portfolio = new Portfolio(this.protocol, this.strategyContext);\n  }\n\n  /**\n   * Get comprehensive data for all available DeFi pools.\n   *\n   * @param strategiesType - Optional array to filter by strategy types (e.g., ['Lending', 'Lp'])\n   * @returns Map of pool ID to pool data (APY, TVL, supported assets, etc.)\n   */\n  async getPoolsData(strategiesType?: StrategyType[]): Promise<Map<string, PoolData>> {\n    return this.protocol.getPoolsData(strategiesType);\n  }\n\n  /**\n   * Get data for a single pool.\n   *\n   * @param poolId - The ID of the pool to get data for\n   * @returns Pool data including APR, TVL, LP breakdown, parent LP breakdown, current LP pool price, and position range\n   */\n  async getSinglePoolData(poolId: string): Promise<PoolData> {\n    const strategy = await this.protocol.getSinglePoolStrategy(poolId);\n    return strategy.getData();\n  }\n\n  /**\n   * Get balance for a single pool.\n   *\n   * @param address - The address of the user to get balance for\n   * @param poolId - The ID of the pool to get balance for\n   * @returns Pool balance including token amounts and USD value\n   */\n  async getUserSinglePoolBalance(address: string, poolId: string): Promise<PoolBalance> {\n    const strategy = await this.portfolio.getPoolStrategy(address, poolId);\n    return strategy.getBalance(address);\n  }\n\n  /**\n   * Get complete portfolio summary for a user address.\n   *\n   * @param address - User's wallet address\n   * @param strategiesType - Optional array to filter by strategy types\n   * @returns Portfolio data including net worth, aggregated APY, alpha rewards, and individual pool balances\n   */\n  async getUserPortfolio(\n    address: string,\n    strategiesType?: StrategyType[],\n  ): Promise<UserPortfolioData> {\n    return this.portfolio.getUserPortfolio(address, strategiesType);\n  }\n\n  /**\n   * Deposit assets into a DeFi pool to start earning yield.\n   *\n   * Supports all pool types:\n   * - Single-asset pools (Lending, Looping, Alpha Vaults): Deposit one token\n   * - LP pools (Lp, AutobalanceLp, FungibleLp): Deposit tokens to provide liquidity\n   * - LYF pools: Deposit SUI for leveraged yield farming\n   *\n   * @param options - Deposit configuration including pool ID, amount, and user address\n   * @returns Transaction object ready for signing and execution\n   */\n  async deposit(options: DepositOptions): Promise<Transaction> {\n    const poolLabel = await this.strategyContext.getPoolLabel(options.poolId);\n    if (!poolLabel) {\n      throw new Error(`Pool with ID ${options.poolId} not found`);\n    }\n\n    const tx = new Transaction();\n    const strategy = await this.portfolio.getPoolStrategy(options.address, options.poolId);\n    await strategy.deposit(tx, options);\n    return tx;\n  }\n\n  /**\n   * Calculate required token amounts for balanced LP deposits.\n   *\n   * Given an amount of one token, calculates how much of the other token\n   * is needed to maintain the pool's balance ratio.\n   *\n   * @param options - Pool ID, input amount, and which token the amount represents\n   * @returns Tuple of [tokenA amount, tokenB amount] required for deposit\n   */\n  async estimateLpAmounts(options: EstimateLpAmountsOptions): Promise<[string, string]> {\n    const strategy = await this.protocol.getSinglePoolStrategy(options.poolId);\n    return strategy.getOtherAmount(options.amount, options.isAmountA);\n  }\n\n  /**\n   * Withdraw assets from a DeFi pool.\n   *\n   * Supports partial or full withdrawals from any pool type.\n   * For leveraged positions (Looping, LYF), automatically handles\n   * deleveraging and debt repayment.\n   *\n   * @param options - Withdrawal configuration including amount or withdrawMax flag\n   * @returns Transaction object ready for signing and execution\n   */\n  async withdraw(options: WithdrawOptions): Promise<Transaction> {\n    const tx = new Transaction();\n    const strategy = await this.portfolio.getPoolStrategy(options.address, options.poolId);\n    await strategy.withdraw(tx, options);\n    return tx;\n  }\n\n  /**\n   * Initiate ALPHA token withdrawal (creates withdrawal ticket).\n   * ALPHA withdrawals require a 2-step process due to unlock periods.\n   *\n   * @param options - Withdrawal configuration (amount and user address)\n   * @returns Transaction to create withdrawal ticket\n   */\n  async initiateWithdrawAlpha(options: WithdrawOptions): Promise<Transaction> {\n    const tx = new Transaction();\n    const strategy = (await this.portfolio.getPoolStrategy(\n      options.address,\n      '0x06a4922346ae433e9a2fff4db900d760e0cbfdef748f48385f430ef4d042a6f8',\n    )) as AlphaVaultStrategy;\n    await strategy.withdraw(tx, options);\n    return tx;\n  }\n\n  /**\n   * Complete ALPHA token withdrawal using previously created ticket.\n   *\n   * @param options - Withdrawal claim configuration with ticket ID and user address\n   * @returns Transaction to claim the withdrawn ALPHA tokens\n   */\n  async claimWithdrawAlpha(options: ClaimWithdrawAlphaOptions): Promise<Transaction> {\n    const tx = new Transaction();\n    const strategy = (await this.portfolio.getPoolStrategy(\n      options.address,\n      '0x06a4922346ae433e9a2fff4db900d760e0cbfdef748f48385f430ef4d042a6f8',\n    )) as AlphaVaultStrategy;\n    await strategy.claimWithdraw(tx, options.ticketId, options.address);\n    return tx;\n  }\n\n  /**\n   * Claim available airdrop tokens.\n   *\n   * @param options - Airdrop claim configuration with user address and transfer preference\n   * @returns Transaction to claim airdrop rewards\n   */\n  async claimAirdrop(options: ClaimAirdropOptions): Promise<Transaction> {\n    const tx = new Transaction();\n    const strategy = (await this.portfolio.getPoolStrategy(\n      options.address,\n      '0x06a4922346ae433e9a2fff4db900d760e0cbfdef748f48385f430ef4d042a6f8',\n    )) as AlphaVaultStrategy;\n    await strategy.claimAirdrop(tx, options.address, options.transferToWallet);\n    return tx;\n  }\n\n  /**\n   * Claim accumulated rewards from all pools.\n   *\n   * Collects all available rewards including:\n   * - ALPHA mining rewards\n   * - Pool-specific yield rewards\n   * - Protocol incentives\n   *\n   * @param options - User address and optional pool filter\n   * @returns Transaction to claim all available rewards\n   */\n  async claim(options: ClaimOptions): Promise<Transaction> {\n    const tx = new Transaction();\n    const alphaReceipt = tx.moveCall({\n      target: `0x1::option::none`,\n      typeArguments: [LEGACY_ALPHA_POOL_RECEIPT],\n      arguments: [],\n    });\n    let strategies = new Map<string, Strategy>();\n\n    if (options.poolId) {\n      strategies.set(\n        options.poolId,\n        await this.portfolio.getPoolStrategy(options.address, options.poolId),\n      );\n    } else {\n      strategies = await this.portfolio.getAllPoolStrategies(options.address);\n    }\n    strategies.forEach((strategy) => {\n      strategy.claimRewards(tx, alphaReceipt);\n    });\n    tx.moveCall({\n      target: `${PACKAGE_IDS.ALPHA_LATEST}::alphapool::transfer_receipt_option`,\n      arguments: [tx.object(VERSIONS.ALPHA_VERSIONS[1]), alphaReceipt],\n    });\n\n    return tx;\n  }\n\n  /**\n   * Vote on a proposal.\n   *\n   * @param voteIndex - The index of the vote to cast\n   * @param proposalId - The ID of the proposal to vote on\n   * @returns Transaction object ready for signing and execution\n   */\n  async vote(voteIndex: number, proposalId: string): Promise<Transaction | undefined> {\n    const tx = new Transaction();\n    if (voteIndex === undefined) {\n      console.error('Vote index is undefined');\n      return undefined;\n    }\n\n    tx.moveCall({\n      target: `0x79729faced2e6294254e555424184f71c8c043a1dbe3447b88613704a7276710::governance::vote`,\n      arguments: [tx.object(proposalId), tx.pure.u8(voteIndex), tx.object('0x6')],\n    });\n\n    return tx;\n  }\n  /**\n   * Get quote for token swap via Cetus aggregator.\n   *\n   * @param options - Swap quote configuration with token types and amount\n   * @returns Router data with swap path and expected output, or undefined if no route found\n   */\n  async getCetusSwapQuote(options: CetusSwapQuoteOptions): Promise<RouterDataV3 | undefined> {\n    const swap = new CetusSwap(this.config.network);\n    return await swap.getCetusSwapQuote(\n      options.from,\n      options.target,\n      options.amount,\n      options.byAmountIn,\n    );\n  }\n\n  /**\n   * Execute token swap using Cetus aggregator.\n   *\n   * @param options - Swap execution configuration with router data and slippage tolerance\n   * @returns Transaction object ready for signing and execution\n   */\n  async cetusSwapTxb(options: CetusSwapOptions): Promise<Transaction> {\n    const swap = new CetusSwap(this.config.network);\n    return await swap.cetusSwapTokensTxb(options.router, options.slippage);\n  }\n\n  /**\n   * Clear all cached data. Useful for forcing fresh data.\n   */\n  clearCaches(): void {\n    this.strategyContext.clearAllCaches();\n  }\n\n  /**\n   * Clear cached data for a specific user.\n   * Call this after a user completes a transaction to refresh their portfolio.\n   */\n  clearUserCaches(userAddress: string): void {\n    this.strategyContext.clearUserCaches(userAddress);\n  }\n}\n"]}

package/dist/cjs/core/types.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Core types and configuration interfaces for the AlphaFi SDK.
+ * These types define the structure for all SDK operations.
+ */
+import { SuiClient } from '@mysten/sui/client';
+import { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';
+/**
+ * Configuration required to initialize the AlphaFi SDK.
+ */
+export interface AlphaFiSDKConfig {
+    /** Sui blockchain client for network operations */
+    suiClient: SuiClient;
+    /** Target Sui network environment */
+    network: 'mainnet' | 'testnet' | 'devnet' | 'localnet';
+    /** Base URL for the AlphaFi API (defaults to 'https://api.alphafi.xyz') */
+    apiBaseUrl?: string;
+}
+/**
+ * Configuration for depositing assets into DeFi pools.
+ */
+export interface DepositOptions {
+    /** Unique identifier of the target pool */
+    poolId: string;
+    /** User's wallet address */
+    address: string;
+    /** Amount to deposit in the asset's base units */
+    amount: bigint;
+    /** For LP pools: true to deposit token A, false for token B */
+    isAmountA?: boolean;
+}
+/**
+ * Configuration for estimating required amounts for LP deposits.
+ * Used to calculate how much of each token is needed for balanced LP positions.
+ */
+export interface EstimateLpAmountsOptions {
+    /** Unique identifier of the target LP pool */
+    poolId: string;
+    /** Amount of the input token */
+    amount: string;
+    /** True if amount refers to token A, false for token B */
+    isAmountA: boolean;
+}
+/**
+ * Configuration for withdrawing assets from DeFi pools.
+ */
+export interface WithdrawOptions {
+    /** Unique identifier of the target pool */
+    poolId: string;
+    /** User's wallet address */
+    address: string;
+    /** Amount to withdraw (ignored if withdrawMax is true) */
+    amount: string;
+    /** For LP pools: true to specify withdrawal in terms of token A */
+    isAmountA?: boolean;
+    /** If true, withdraw entire position regardless of amount */
+    withdrawMax: boolean;
+}
+/**
+ * Configuration for zap deposits (single-token to LP conversion).
+ * Allows depositing one token and automatically converting to balanced LP position.
+ */
+export interface ZapDepositOptions {
+    /** Unique identifier of the target LP pool */
+    poolId: string;
+    /** Amount of input token in base units */
+    inputCoinAmount: bigint;
+    /** True if input token is token A, false for token B */
+    isInputA: boolean;
+    /** User's wallet address */
+    address: string;
+    /** Maximum acceptable slippage as decimal (e.g., 0.005 = 0.5%) */
+    slippage: number;
+}
+/**
+ * Configuration for getting zap deposit quotes.
+ * Returns expected output amounts before executing the zap deposit.
+ */
+export interface ZapDepositQuoteOptions {
+    /** Unique identifier of the target LP pool */
+    poolId: string;
+    /** Amount of input token in base units */
+    inputCoinAmount: bigint;
+    /** True if input token is token A, false for token B */
+    isInputA: boolean;
+}
+/**
+ * Configuration for claiming rewards from pools.
+ */
+export interface ClaimOptions {
+    /** Optional pool ID (if not specified, claims from all pools) */
+    poolId?: string;
+    /** User's wallet address */
+    address: string;
+}
+/**
+ * Configuration for claiming airdrop rewards.
+ */
+export interface ClaimAirdropOptions {
+    /** User's wallet address */
+    address: string;
+    /** Whether to transfer tokens directly to wallet */
+    transferToWallet: boolean;
+}
+/**
+ * Configuration for claiming ALPHA token withdrawals.
+ */
+export interface ClaimWithdrawAlphaOptions {
+    /** Unique identifier of the withdrawal ticket */
+    ticketId: string;
+    /** User's wallet address */
+    address: string;
+}
+/**
+ * Configuration for getting Cetus swap quotes.
+ */
+export interface CetusSwapQuoteOptions {
+    /** Source token type/address */
+    from: string;
+    /** Destination token type/address */
+    target: string;
+    /** Amount to swap in source token units */
+    amount: string;
+    /** True to fix input amount, false to fix output amount */
+    byAmountIn: boolean;
+}
+/**
+ * Configuration for executing Cetus token swaps.
+ */
+export interface CetusSwapOptions {
+    /** Router data from getCetusSwapQuote containing swap path */
+    router: RouterDataV3;
+    /** Maximum acceptable slippage as decimal (e.g., 0.01 = 1%) */
+    slippage: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,SAAS,EAAE,SAAS,CAAC;IACrB,qCAAqC;IACrC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IACvD,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,EAAE,OAAO,CAAC;IAClB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,MAAM,EAAE,YAAY,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/cjs/core/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Core types and configuration interfaces for the AlphaFi SDK.
+ * These types define the structure for all SDK operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * Core types and configuration interfaces for the AlphaFi SDK.\n * These types define the structure for all SDK operations.\n */\n\nimport { SuiClient } from '@mysten/sui/client';\nimport { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';\n\n/**\n * Configuration required to initialize the AlphaFi SDK.\n */\nexport interface AlphaFiSDKConfig {\n  /** Sui blockchain client for network operations */\n  suiClient: SuiClient;\n  /** Target Sui network environment */\n  network: 'mainnet' | 'testnet' | 'devnet' | 'localnet';\n  /** Base URL for the AlphaFi API (defaults to 'https://api.alphafi.xyz') */\n  apiBaseUrl?: string;\n}\n\n/**\n * Configuration for depositing assets into DeFi pools.\n */\nexport interface DepositOptions {\n  /** Unique identifier of the target pool */\n  poolId: string;\n  /** User's wallet address */\n  address: string;\n  /** Amount to deposit in the asset's base units */\n  amount: bigint;\n  /** For LP pools: true to deposit token A, false for token B */\n  isAmountA?: boolean;\n}\n\n/**\n * Configuration for estimating required amounts for LP deposits.\n * Used to calculate how much of each token is needed for balanced LP positions.\n */\nexport interface EstimateLpAmountsOptions {\n  /** Unique identifier of the target LP pool */\n  poolId: string;\n  /** Amount of the input token */\n  amount: string;\n  /** True if amount refers to token A, false for token B */\n  isAmountA: boolean;\n}\n\n/**\n * Configuration for withdrawing assets from DeFi pools.\n */\nexport interface WithdrawOptions {\n  /** Unique identifier of the target pool */\n  poolId: string;\n  /** User's wallet address */\n  address: string;\n  /** Amount to withdraw (ignored if withdrawMax is true) */\n  amount: string;\n  /** For LP pools: true to specify withdrawal in terms of token A */\n  isAmountA?: boolean;\n  /** If true, withdraw entire position regardless of amount */\n  withdrawMax: boolean;\n}\n\n/**\n * Configuration for zap deposits (single-token to LP conversion).\n * Allows depositing one token and automatically converting to balanced LP position.\n */\nexport interface ZapDepositOptions {\n  /** Unique identifier of the target LP pool */\n  poolId: string;\n  /** Amount of input token in base units */\n  inputCoinAmount: bigint;\n  /** True if input token is token A, false for token B */\n  isInputA: boolean;\n  /** User's wallet address */\n  address: string;\n  /** Maximum acceptable slippage as decimal (e.g., 0.005 = 0.5%) */\n  slippage: number;\n}\n\n/**\n * Configuration for getting zap deposit quotes.\n * Returns expected output amounts before executing the zap deposit.\n */\nexport interface ZapDepositQuoteOptions {\n  /** Unique identifier of the target LP pool */\n  poolId: string;\n  /** Amount of input token in base units */\n  inputCoinAmount: bigint;\n  /** True if input token is token A, false for token B */\n  isInputA: boolean;\n}\n\n/**\n * Configuration for claiming rewards from pools.\n */\nexport interface ClaimOptions {\n  /** Optional pool ID (if not specified, claims from all pools) */\n  poolId?: string;\n  /** User's wallet address */\n  address: string;\n}\n\n/**\n * Configuration for claiming airdrop rewards.\n */\nexport interface ClaimAirdropOptions {\n  /** User's wallet address */\n  address: string;\n  /** Whether to transfer tokens directly to wallet */\n  transferToWallet: boolean;\n}\n\n/**\n * Configuration for claiming ALPHA token withdrawals.\n */\nexport interface ClaimWithdrawAlphaOptions {\n  /** Unique identifier of the withdrawal ticket */\n  ticketId: string;\n  /** User's wallet address */\n  address: string;\n}\n\n/**\n * Configuration for getting Cetus swap quotes.\n */\nexport interface CetusSwapQuoteOptions {\n  /** Source token type/address */\n  from: string;\n  /** Destination token type/address */\n  target: string;\n  /** Amount to swap in source token units */\n  amount: string;\n  /** True to fix input amount, false to fix output amount */\n  byAmountIn: boolean;\n}\n\n/**\n * Configuration for executing Cetus token swaps.\n */\nexport interface CetusSwapOptions {\n  /** Router data from getCetusSwapQuote containing swap path */\n  router: RouterDataV3;\n  /** Maximum acceptable slippage as decimal (e.g., 0.01 = 1%) */\n  slippage: number;\n}\n"]}