@evaafi/sdk 0.9.0-a → 0.9.1

package/dist/constants/pools/mainnet.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ALL_MAINNET_POOLS = exports.MAINNET_MASTER_USDT_REWARD_CONFIG = exports.MAINNET_MASTER_TON_REWARD_CONFIG = exports.MAINNET_V8_TOB_POOL_CONFIG = exports.MAINNET_V8_TOB_POOL_ASSETS_CONFIG = exports.MAINNET_PYTH_V8_TOB_POOL_CONFIG = exports.MAINNET_PYTH_V8_TOB_POOL_ASSETS_CONFIG = exports.MAINNET_ALTS_POOL_CONFIG = exports.MAINNET_LP_POOL_CONFIG = exports.MAINNET_STABLE_POOL_CONFIG = exports.MAINNET_POOL_CONFIG = exports.MAINNET_POOL_ASSETS_CONFIG = void 0;
 const core_1 = require("@ton/core");
 const feeds_1 = require("../../api/feeds");
-const prices_1 = require("../../prices");
+const oracles_1 = require("../../oracles");
 const assets_1 = require("../assets");
 const general_1 = require("../general");
 // Pool assets configs
@@ -31,15 +31,16 @@ exports.MAINNET_POOL_CONFIG = {
     masterAddress: general_1.EVAA_MASTER_MAINNET,
     masterVersion: general_1.MAINNET_VERSION,
     masterConstants: general_1.MASTER_CONSTANTS,
-    oracles: new prices_1.PythCollector({
-        pythConfig: prices_1.DefaultPythPriceSourcesConfig,
+    collector: new oracles_1.PythCollector({
+        pythConfig: oracles_1.DefaultPythPriceSourcesConfig,
         poolAssetsConfig: exports.MAINNET_POOL_ASSETS_CONFIG,
         pythOracle: {
-            feedsMap: core_1.Dictionary.empty()
-                .set(BigInt(feeds_1.PYTH_TON_PRICE_FEED_ID), (0, feeds_1.packConnectedFeeds)(assets_1.ASSET_ID.TON, 0n))
-                .set(BigInt(feeds_1.PYTH_USDT_PRICE_FEED_ID), (0, feeds_1.packConnectedFeeds)(assets_1.ASSET_ID.USDT, 0n))
-                .set(BigInt(feeds_1.PYTH_TSTON_PRICE_FEED_ID), (0, feeds_1.packConnectedFeeds)(feeds_1.EVAA_TSTON_PRICE_FEED_ID, BigInt(feeds_1.PYTH_TON_PRICE_FEED_ID)))
-                .set(BigInt(feeds_1.PYTH_TSUSDE_PRICE_FEED_ID), (0, feeds_1.packConnectedFeeds)(feeds_1.EVAA_TSUSDE_PRICE_FEED_ID, BigInt(feeds_1.PYTH_USDT_PRICE_FEED_ID))),
+            feedsMap: new Map([
+                [feeds_1.FEED_ID.TON, { assetId: assets_1.ASSET_ID.TON, feedId: '0x0' }],
+                [feeds_1.FEED_ID.USDT, { assetId: assets_1.ASSET_ID.USDT, feedId: '0x0' }],
+                [feeds_1.FEED_ID.tsTON, { assetId: assets_1.ASSET_ID.tsTON, feedId: feeds_1.FEED_ID.TON }],
+                [feeds_1.FEED_ID.tsUSDe, { assetId: assets_1.ASSET_ID.tsUSDe, feedId: feeds_1.FEED_ID.USDT }],
+            ]),
             pythAddress: general_1.PYTH_ORACLE_MAINNET,
             allowedRefTokens: core_1.Dictionary.empty()
                 .set(assets_1.ASSET_ID.jUSDT, assets_1.ASSET_ID.USDT)
@@ -55,7 +56,7 @@ exports.MAINNET_STABLE_POOL_CONFIG = {
     masterAddress: general_1.EVAA_STABLE_MAINNET,
     masterVersion: general_1.STABLE_VERSION,
     masterConstants: general_1.MASTER_CONSTANTS,
-    oracles: new prices_1.PricesCollector({
+    collector: new oracles_1.ClassicCollector({
         poolAssetsConfig: MAINNET_STABLE_POOL_ASSETS_CONFIG,
         minimalOracles: 3,
         evaaOracles: general_1.ORACLES_MAINNET,
@@ -67,7 +68,7 @@ exports.MAINNET_LP_POOL_CONFIG = {
     masterAddress: general_1.EVAA_LP_MAINNET,
     masterVersion: general_1.EVAA_LP_MAINNET_VERSION,
     masterConstants: general_1.MASTER_CONSTANTS,
-    oracles: new prices_1.PricesCollector({
+    collector: new oracles_1.ClassicCollector({
         poolAssetsConfig: MAINNET_LP_POOL_ASSETS_CONFIG,
         minimalOracles: 3,
         evaaOracles: general_1.ORACLES_LP,
@@ -79,7 +80,7 @@ exports.MAINNET_ALTS_POOL_CONFIG = {
     masterAddress: general_1.EVAA_ALTS_MAINNET,
     masterVersion: general_1.EVAA_ALTS_MAINNET_VERSION,
     masterConstants: general_1.MASTER_CONSTANTS,
-    oracles: new prices_1.PricesCollector({
+    collector: new oracles_1.ClassicCollector({
         poolAssetsConfig: MAINNET_ALTS_POOL_ASSETS_CONFIG,
         minimalOracles: 3,
         evaaOracles: general_1.ORACLES_ALTS,
@@ -92,15 +93,16 @@ exports.MAINNET_PYTH_V8_TOB_POOL_CONFIG = {
     masterAddress: general_1.EVAA_PYTH_TOB_MAINNET,
     masterVersion: general_1.EVAA_PYTH_TOB_VERSION,
     masterConstants: general_1.MASTER_CONSTANTS,
-    oracles: new prices_1.PythCollector({
-        pythConfig: prices_1.DefaultPythPriceSourcesConfig,
+    collector: new oracles_1.PythCollector({
+        pythConfig: oracles_1.DefaultPythPriceSourcesConfig,
         poolAssetsConfig: exports.MAINNET_PYTH_V8_TOB_POOL_ASSETS_CONFIG,
         pythOracle: {
-            feedsMap: core_1.Dictionary.empty()
-                .set(BigInt(feeds_1.PYTH_TON_PRICE_FEED_ID), (0, feeds_1.packConnectedFeeds)(assets_1.ASSET_ID.TON, 0n))
-                .set(BigInt(feeds_1.PYTH_USDT_PRICE_FEED_ID), (0, feeds_1.packConnectedFeeds)(assets_1.ASSET_ID.USDT, 0n)),
+            feedsMap: new Map([
+                [feeds_1.FEED_ID.TON, { assetId: assets_1.ASSET_ID.TON, feedId: '0x0' }],
+                [feeds_1.FEED_ID.USDT, { assetId: assets_1.ASSET_ID.USDT, feedId: '0x0' }],
+            ]),
             pythAddress: general_1.PYTH_ORACLE_MAINNET,
-            allowedRefTokens: core_1.Dictionary.empty().set(BigInt(feeds_1.EVAA_JUSDT_PRICE_FEED_ID), BigInt(assets_1.ASSET_ID.USDT)),
+            allowedRefTokens: core_1.Dictionary.empty().set(assets_1.ASSET_ID.jUSDT, assets_1.ASSET_ID.USDT),
         },
     }),
     poolAssetsConfig: exports.MAINNET_PYTH_V8_TOB_POOL_ASSETS_CONFIG,
@@ -111,7 +113,7 @@ exports.MAINNET_V8_TOB_POOL_CONFIG = {
     masterAddress: general_1.EVAA_TOB_MAINNET,
     masterVersion: general_1.EVAA_TOB_VERSION,
     masterConstants: general_1.MASTER_CONSTANTS,
-    oracles: new prices_1.PricesCollector({
+    collector: new oracles_1.ClassicCollector({
         poolAssetsConfig: exports.MAINNET_V8_TOB_POOL_ASSETS_CONFIG,
         minimalOracles: 3,
         evaaOracles: general_1.ORACLES_MAINNET,

package/dist/constants/pools/testnet.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ALL_TESTNET_POOLS = exports.TESTNET_MASTER_EUSDT_REWARD_CONFIG = exports.TESTNET_MASTER_REWARD_CONFIG = exports.TESTNET_CLASSIC_POOL_CONFIG_TOB_AUDITED = exports.TESTNET_PYTH_POOL_CONFIG_TOB_AUDITED = exports.TESTNET_POOL_ASSETS_CONFIG_TOB_AUDITED = exports.TESTNET_POOL_ASSETS_CONFIG = void 0;
 const core_1 = require("@ton/core");
 const feeds_1 = require("../../api/feeds");
-const prices_1 = require("../../prices");
+const oracles_1 = require("../../oracles");
 const assets_1 = require("../assets");
 const general_1 = require("../general");
 exports.TESTNET_POOL_ASSETS_CONFIG = [assets_1.TON_TESTNET, assets_1.JUSDC_TESTNET];
@@ -12,14 +12,22 @@ exports.TESTNET_PYTH_POOL_CONFIG_TOB_AUDITED = {
     masterAddress: general_1.EVAA_MASTER_TESTNET_PYTH_TOB_AUDITED,
     masterVersion: general_1.TESTNET_PYTH_VERSION_TOB_AUDITED,
     masterConstants: general_1.MASTER_CONSTANTS,
-    oracles: new prices_1.PythCollector({
+    collector: new oracles_1.PythCollector({
         poolAssetsConfig: exports.TESTNET_POOL_ASSETS_CONFIG_TOB_AUDITED,
         pythOracle: {
-            feedsMap: feeds_1.TESTNET_FEEDS_MAP,
+            feedsMap: new Map([
+                [
+                    feeds_1.FEED_ID.TON,
+                    {
+                        assetId: assets_1.ASSET_ID.TON,
+                        feedId: '0x0',
+                    },
+                ],
+            ]),
             pythAddress: general_1.PYTH_ORACLE_TESTNET,
-            allowedRefTokens: feeds_1.TESTNET_ALLOWED_REF_TOKENS,
+            allowedRefTokens: core_1.Dictionary.empty().set(assets_1.ASSET_ID.jUSDT, assets_1.ASSET_ID.USDT),
         },
-        pythConfig: prices_1.DefaultPythPriceSourcesConfig,
+        pythConfig: oracles_1.DefaultPythPriceSourcesConfig,
     }),
     poolAssetsConfig: exports.TESTNET_POOL_ASSETS_CONFIG_TOB_AUDITED,
     lendingCode: general_1.LENDING_CODE,
@@ -28,7 +36,7 @@ exports.TESTNET_CLASSIC_POOL_CONFIG_TOB_AUDITED = {
     masterAddress: general_1.EVAA_MASTER_TESTNET_CLASSIC_TOB_AUDITED,
     masterVersion: general_1.TESTNET_CLASSIC_TOB_AUDITED,
     masterConstants: general_1.MASTER_CONSTANTS,
-    oracles: new prices_1.PricesCollector({
+    collector: new oracles_1.ClassicCollector({
         poolAssetsConfig: exports.TESTNET_POOL_ASSETS_CONFIG,
         minimalOracles: 3,
         evaaOracles: general_1.ORACLES_TESTNET,

package/dist/contracts/AbstractMaster.d.ts

@@ -6,151 +6,184 @@ import { ExtendedAssetsConfig, ExtendedAssetsData, PoolAssetConfig, PoolConfig,
 import { ClassicLiquidationOperationParameters, ClassicLiquidationParameters, ClassicSupplyWithdrawParameters, ClassicWithdrawParameters } from './ClassicMaster';
 import { PythLiquidationOperationParameters, PythLiquidationParameters, PythSupplyWithdrawParameters, PythWithdrawParameters } from './PythMaster';
 import { EvaaUser } from './UserContract';
-type JettonParams = {
-    queryID: bigint;
-    amount?: bigint;
-    liquidationAmount?: bigint;
-    supplyAmount?: bigint;
-    responseAddress?: Address;
-    userAddress?: Address;
-    liquidatorAddress?: Address;
-    forwardAmount?: bigint;
-    destinationAddress?: Address;
-};
+export interface JettonParams {
+    readonly queryID: bigint;
+    readonly amount?: bigint;
+    readonly liquidationAmount?: bigint;
+    readonly supplyAmount?: bigint;
+    readonly responseAddress?: Address;
+    readonly userAddress?: Address;
+    readonly liquidatorAddress?: Address;
+    readonly forwardAmount?: bigint;
+    readonly destinationAddress?: Address;
+}
+type RequireAtLeastOne<T, K extends keyof T> = T & {
+    [P in K]: Required<T>[P];
+}[K];
+export type ValidJettonParams = RequireAtLeastOne<JettonParams, 'amount' | 'liquidationAmount' | 'supplyAmount'>;
 /**
- * Parameters for the Evaa contract
- * @property testnet - true for testnet, false for mainnet
- * @property debug - true to enable debug mode (optional)
+ * Parameters for initializing an Evaa contract instance
+ * @interface EvaaParameters
  */
-export type EvaaParameters = {
-    poolConfig: PoolConfig;
-    debug?: boolean;
-};
+export interface EvaaParameters {
+    /** Pool configuration containing contract addresses and settings */
+    readonly poolConfig: PoolConfig;
+    /** Optional debug mode flag for development purposes */
+    readonly debug?: boolean;
+}
 /**
- * Base parameters for supply
- * @property queryID - unique query ID
- * @property includeUserCode - true to include user code for update (needed when user contract code version is outdated)
- * @property amount - amount to supply
- * @property userAddress - user address
- * @property asset
+ * Parameters for supply operations
+ * @interface SupplyParameters
  */
-export type SupplyParameters = {
-    asset: PoolAssetConfig;
-    queryID: bigint;
-    includeUserCode: boolean;
-    amount: bigint;
-    userAddress: Address;
-    responseAddress?: Address;
-    forwardAmount?: bigint;
-    payload: Cell;
-    subaccountId?: number;
-    returnRepayRemainingsFlag?: boolean;
-    customPayloadRecipient?: Address;
-    customPayloadSaturationFlag?: boolean;
-};
+export interface SupplyParameters {
+    /** Asset configuration for the supply operation */
+    readonly asset: PoolAssetConfig;
+    /** Unique identifier for this operation */
+    readonly queryID: bigint;
+    /** Whether to include user contract code update */
+    readonly includeUserCode: boolean;
+    /** Amount to supply (must be positive) */
+    readonly amount: bigint;
+    /** Address of the user performing the supply */
+    readonly userAddress: Address;
+    /** Optional address for operation response */
+    readonly responseAddress?: Address;
+    /** Optional forward amount for transaction fees */
+    readonly forwardAmount?: bigint;
+    /** Operation payload cell */
+    readonly payload: Cell;
+    /** Optional subaccount identifier (0-255) */
+    readonly subaccountId?: number;
+    /** Whether to return repay remainings */
+    readonly returnRepayRemainingsFlag?: boolean;
+    /** Optional custom payload recipient address */
+    readonly customPayloadRecipient?: Address;
+    /** Whether to saturate custom payload */
+    readonly customPayloadSaturationFlag?: boolean;
+}
 /**
- * Parameters for the withdraw message
- * @property queryID - unique query ID
- * @property asset - asset config
- * @property amount - amount to withdraw
- * @property userAddress - user address
- * @property includeUserCode - true to include user code for update (needed when user contract code version is outdated)
+ * Parameters for withdraw operations
+ * @interface WithdrawParameters
  */
-export type WithdrawParameters = {
-    queryID: bigint;
-    amount: bigint;
-    userAddress: Address;
-    includeUserCode: boolean;
-    asset: PoolAssetConfig;
-    payload: Cell;
-    subaccountId?: number;
-    forwardAmount?: bigint;
-    amountToTransfer: bigint;
-    customPayloadSaturationFlag: boolean;
-    returnRepayRemainingsFlag: boolean;
-};
+export interface WithdrawParameters {
+    /** Unique identifier for this operation */
+    readonly queryID: bigint;
+    /** Amount to withdraw (must be positive) */
+    readonly amount: bigint;
+    /** Address of the user performing the withdrawal */
+    readonly userAddress: Address;
+    /** Whether to include user contract code update */
+    readonly includeUserCode: boolean;
+    /** Asset configuration for the withdrawal */
+    readonly asset: PoolAssetConfig;
+    /** Operation payload cell */
+    readonly payload: Cell;
+    /** Optional subaccount identifier (0-255) */
+    readonly subaccountId?: number;
+    /** Optional forward amount for transaction fees */
+    readonly forwardAmount?: bigint;
+    /** Actual amount to transfer after calculations */
+    readonly amountToTransfer: bigint;
+    /** Whether to saturate custom payload */
+    readonly customPayloadSaturationFlag: boolean;
+    /** Whether to return repay remainings */
+    readonly returnRepayRemainingsFlag: boolean;
+}
 /**
  * Parameters for liquidation inner operations
  * @interface LiquidationInnerParameters
  */
-export type LiquidationInnerParameters = {
+export interface LiquidationInnerParameters {
     /** Liquidation operation payload cell */
-    payload: Cell;
-    subaccountId: number;
-    customPayloadRecipient: Address;
-    customPayloadSaturationFlag: boolean;
-};
+    readonly payload: Cell;
+    /** Subaccount identifier for the operation */
+    readonly subaccountId: number;
+    /** Address to receive custom payload */
+    readonly customPayloadRecipient: Address;
+    /** Whether to saturate the custom payload */
+    readonly customPayloadSaturationFlag: boolean;
+}
 /**
- * Base data for liquidation. Can be obtained from the user contract liquidationParameters getter
- * @property loanAsset - loan asset ID
- * @property queryID - unique query ID
- * @property liquidatorAddress - liquidator address, where and collateral will be sent
+ * Base parameters for liquidation operations
+ * @interface LiquidationParameters
+ * @description Can be obtained from the user contract liquidationParameters getter
  */
-export type LiquidationParameters = {
-    loanAsset: bigint;
-    queryID: bigint;
-    liquidatorAddress: Address;
-};
+export interface LiquidationParameters {
+    /** Asset ID of the loan being liquidated */
+    readonly loanAsset: bigint;
+    /** Unique identifier for this operation */
+    readonly queryID: bigint;
+    /** Address where collateral will be sent upon liquidation */
+    readonly liquidatorAddress: Address;
+}
 /**
- * @property asset - asset config
- * @property borrowerAddress - borrower address (user address that is being liquidated)
- * @property collateralAsset - collateral asset ID
- * @property minCollateralAmount - minimal amount to receive from the liquidation
- * @property liquidationAmount - amount to liquidate
- * @property includeUserCode - true to include user code for update (needed when user contract code version is outdated)
+ * Parameters for building liquidation operations
+ * @interface LiquidationOperationBuilderParameters
  */
-export type LiquidationOperationBuilderParameters = {
-    asset: PoolAssetConfig;
-    borrowerAddress: Address;
-    collateralAsset: bigint;
-    minCollateralAmount: bigint;
-    liquidationAmount: bigint;
-    includeUserCode: boolean;
-};
-export type SupplyWithdrawParameters = {
-    queryID: bigint;
-    supplyAmount: bigint;
-    supplyAsset: PoolAssetConfig;
-    withdrawAmount: bigint;
-    withdrawAsset: PoolAssetConfig;
-    withdrawRecipient: Address;
-    includeUserCode: boolean;
-    tonForRepayRemainings?: bigint;
-    payload: Cell;
-    subaccountId?: number;
-    returnRepayRemainingsFlag?: boolean;
-    customPayloadSaturationFlag?: boolean;
-    forwardAmount?: bigint;
-    responseAddress?: Address;
-};
-export type BaseMasterConfig = {
-    ifActive: number;
-    admin: Address;
-    tokenKeys: Cell | null;
-    supervisor: Address | null;
-};
+export interface LiquidationOperationBuilderParameters {
+    /** Asset configuration for the liquidation */
+    readonly asset: PoolAssetConfig;
+    /** Address of the borrower being liquidated */
+    readonly borrowerAddress: Address;
+    /** Asset ID of the collateral to be seized */
+    readonly collateralAsset: bigint;
+    /** Minimum collateral amount expected from liquidation */
+    readonly minCollateralAmount: bigint;
+    /** Amount of debt to liquidate */
+    readonly liquidationAmount: bigint;
+    /** Whether to include user contract code update */
+    readonly includeUserCode: boolean;
+}
+export interface SupplyWithdrawParameters {
+    readonly queryID: bigint;
+    readonly supplyAmount: bigint;
+    readonly supplyAsset: PoolAssetConfig;
+    readonly withdrawAmount: bigint;
+    readonly withdrawAsset: PoolAssetConfig;
+    readonly withdrawRecipient: Address;
+    readonly includeUserCode: boolean;
+    readonly tonForRepayRemainings?: bigint;
+    readonly payload: Cell;
+    readonly subaccountId?: number;
+    readonly returnRepayRemainingsFlag?: boolean;
+    readonly customPayloadSaturationFlag?: boolean;
+    readonly forwardAmount?: bigint;
+    readonly responseAddress?: Address;
+}
+export interface BaseMasterConfig {
+    readonly ifActive: number;
+    readonly admin: Address;
+    readonly tokenKeys: Cell | null;
+    readonly supervisor: Address | null;
+}
 export type OracleInfo = PythOracleInfo | ClassicOracleInfo;
-export type MasterConfig<T extends OracleInfo> = BaseMasterConfig & {
-    oraclesInfo: T;
-};
-export type BaseMasterData = {
-    meta: string;
-    upgradeConfig: UpgradeConfig;
-    assetsConfig: ExtendedAssetsConfig;
-    assetsData: ExtendedAssetsData;
-    assetsReserves: Dictionary<bigint, bigint>;
-    apy: {
-        supply: Dictionary<bigint, number>;
-        borrow: Dictionary<bigint, number>;
+export interface MasterConfig<T extends OracleInfo> extends BaseMasterConfig {
+    readonly oraclesInfo: T;
+}
+export interface BaseMasterData {
+    readonly meta: string;
+    readonly upgradeConfig: UpgradeConfig;
+    readonly assetsConfig: ExtendedAssetsConfig;
+    readonly assetsData: ExtendedAssetsData;
+    readonly assetsReserves: Dictionary<bigint, bigint>;
+    readonly apy: {
+        readonly supply: Dictionary<bigint, number>;
+        readonly borrow: Dictionary<bigint, number>;
     };
-};
-export type MasterData<T extends MasterConfig<OracleInfo>> = BaseMasterData & {
-    masterConfig: T;
-};
+}
+export interface MasterData<T extends MasterConfig<OracleInfo>> extends BaseMasterData {
+    readonly masterConfig: T;
+}
 /**
- * Abstract EVAA Master base that encapsulates shared logic and structure.
- * Concrete implementations (Classic/Pyth) should override message creation for
- * withdraw/liquidation and supply-withdraw wrapping.
+ * Abstract base class for EVAA Master contracts
+ *
+ * This class provides shared functionality for both Classic and Pyth master implementations,
+ * including message creation, validation, and transaction handling. Concrete implementations
+ * must override oracle-specific methods for withdraw/liquidation operations.
+ *
+ * @template T - Master data type extending MasterData with specific oracle configuration
+ * @abstract
+ * @implements {Contract}
  */
 export declare abstract class AbstractEvaaMaster<T extends MasterData<MasterConfig<OracleInfo>>> implements Contract {
     readonly address: Address;
@@ -158,14 +191,79 @@ export declare abstract class AbstractEvaaMaster<T extends MasterData<MasterConf
     protected readonly debug?: boolean;
     protected _data?: T;
     protected lastSync: number;
+    /**
+     * Initialize the abstract master contract
+     * @param parameters - Configuration parameters for the Evaa master
+     */
     constructor(parameters: EvaaParameters);
+    /**
+     * Get the current pool configuration
+     * @returns {PoolConfig} The pool configuration object
+     */
     get poolConfig(): PoolConfig;
+    /**
+     * Get the synchronized master data
+     * @returns {T | undefined} Master data if available, undefined otherwise
+     */
     get data(): T | undefined;
+    /**
+     * Validates jetton parameters ensuring at least one amount field is provided
+     * @private
+     * @static
+     * @param parameters - Jetton parameters to validate
+     * @returns {ValidJettonParams} Validated parameters
+     * @throws {Error} When no amount fields are provided
+     */
+    private static validateJettonParams;
+    /**
+     * Creates a jetton transfer message with the provided parameters
+     * @protected
+     * @param parameters - Jetton transfer parameters
+     * @param defaultFees - Default fee amount for the operation
+     * @param message - Operation message cell to include
+     * @returns {Cell} Complete jetton transfer message cell
+     * @throws {Error} When validation fails or required addresses are missing
+     */
     protected createJettonTransferMessage(parameters: JettonParams, defaultFees: bigint, message: Cell): Cell;
+    /**
+     * Builds general data payload for supply-withdraw operations
+     * @abstract
+     * @param parameters - Supply-withdraw parameters (oracle-specific)
+     * @returns {Cell} General data payload cell
+     */
     abstract buildGeneralDataPayload(parameters: PythSupplyWithdrawParameters | ClassicSupplyWithdrawParameters): Cell;
     protected buildSupplyWithdrawOperationPayload(parameters: PythSupplyWithdrawParameters | ClassicSupplyWithdrawParameters): Cell;
+    /**
+     * Validates supply operation parameters
+     * @private
+     * @static
+     * @param parameters - Supply parameters to validate
+     * @throws {Error} When amount is invalid or subaccount ID is out of range
+     */
+    private static validateSupplyParameters;
+    /**
+     * Creates a supply operation message
+     * @param parameters - Supply operation parameters
+     * @returns {Cell} Complete supply message cell
+     * @throws {Error} When validation fails
+     */
     createSupplyMessage(parameters: SupplyParameters): Cell;
+    /**
+     * Creates a supply-withdraw operation message
+     * @abstract
+     * @param parameters - Oracle-specific supply-withdraw parameters
+     * @returns {Cell} Complete supply-withdraw message cell
+     * @remarks Concrete classes must wrap the operation payload correctly for their oracle
+     */
     abstract createSupplyWithdrawMessage(parameters: ClassicSupplyWithdrawParameters | PythSupplyWithdrawParameters): Cell;
+    /**
+     * Sends a supply operation to the master contract
+     * @param provider - Contract provider instance
+     * @param via - Sender instance
+     * @param value - Transaction value in nanoTON
+     * @param parameters - Supply operation parameters
+     * @throws {Error} When validation fails or transaction fails
+     */
     sendSupply(provider: ContractProvider, via: Sender, value: bigint, parameters: SupplyParameters): Promise<void>;
     sendSupplyWithdraw(provider: ContractProvider, via: Sender, value: bigint, parameters: ClassicSupplyWithdrawParameters | PythSupplyWithdrawParameters): Promise<void>;
     abstract sendWithdraw(provider: ContractProvider, via: Sender, value: bigint, parameters: ClassicWithdrawParameters | PythWithdrawParameters): Promise<void>;
@@ -174,7 +272,21 @@ export declare abstract class AbstractEvaaMaster<T extends MasterData<MasterConf
     protected abstract buildLiquidationOperationPayload(parameters: PythLiquidationOperationParameters | ClassicLiquidationOperationParameters): Cell | Builder;
     protected buildLiquidationOperationPayloadBuilder(parameters: LiquidationOperationBuilderParameters): Builder;
     abstract sendLiquidation(provider: ContractProvider, via: Sender, value: bigint, parameters: ClassicLiquidationParameters | PythLiquidationParameters): Promise<void>;
+    /**
+     * Calculates the user smart contract address for a given user and subaccount
+     * @param userAddress - The user's wallet address
+     * @param lendingCode - The user contract code cell
+     * @param subaccountId - Optional subaccount identifier (default: 0)
+     * @returns {Address} The calculated user contract address
+     * @throws {Error} When subaccount ID is invalid
+     */
     calculateUserSCAddr(userAddress: Address, lendingCode: Cell, subaccountId?: number): Address;
+    /**
+     * Creates a user contract instance for the given address and subaccount
+     * @param userAddress - The user's wallet address
+     * @param subaccountId - Optional subaccount identifier (default: 0)
+     * @returns {EvaaUser} User contract instance
+     */
     openUserContract(userAddress: Address, subaccountId?: number): EvaaUser;
     getOpenedUserContract(provider: ContractProvider, userAddress: Address, subaccountId?: number): OpenedContract<EvaaUser>;
     sendOnchainGetter(provider: ContractProvider, via: Sender, value: bigint, queryID: bigint, forwardPayload: Cell): Promise<void>;