@gala-chain/launchpad-sdk 3.7.7 → 3.8.0

package/dist/api/LaunchpadAPI.d.ts

@@ -9,7 +9,7 @@ import { Logger } from '../utils/Logger';
 import { TokenResolverService } from '../services/TokenResolverService';
 import { FetchPoolOptions, PoolsResult, AmountCalculationResult, CheckPoolOptions, GraphDataResult, TokenDistributionResult, LaunchTokenData, TokenBadgesResult, TokenSpotPrice } from '../types/launchpad.dto';
 import { CalculatePreMintData } from '../types/trade.dto';
-import { FetchVolumeDataOptions, CalculateBuyAmountOptions, CalculateSellAmountOptions, HasTokenBadgeOptions, UploadImageByTokenNameOptions } from '../types/options.dto';
+import { FetchVolumeDataOptions, CalculateBuyAmountOptions, CalculateSellAmountOptions, CalculateBuyAmountLocalOptions, CalculateSellAmountLocalOptions, HasTokenBadgeOptions, UploadImageByTokenNameOptions } from '../types/options.dto';
 /**
  * Launchpad API controller for pool creation and management operations
  *
@@ -56,7 +56,13 @@ export declare class LaunchpadAPI {
     private readonly bundleHttp?;
     private readonly galaChainHttp?;
     private readonly dexApiHttp?;
-    constructor(http: HttpClient, tokenResolver: TokenResolverService, logger: Logger, bundleHttp?: HttpClient | undefined, galaChainHttp?: HttpClient | undefined, dexApiHttp?: HttpClient | undefined);
+    private readonly defaultCalculateAmountMode;
+    constructor(http: HttpClient, tokenResolver: TokenResolverService, logger: Logger, bundleHttp?: HttpClient | undefined, galaChainHttp?: HttpClient | undefined, dexApiHttp?: HttpClient | undefined, defaultCalculateAmountMode?: 'local' | 'external');
+    /**
+     * Helper to conditionally add properties to an object (for exactOptionalPropertyTypes compliance)
+     * @private
+     */
+    private addIfDefined;
     /**
      * Uploads an image for a token pool
      *
@@ -207,55 +213,303 @@ export declare class LaunchpadAPI {
     /**
      * Get buy token amount calculation with unified API (replaces getBuyWithNativeAmountByTokenName/getBuyExactTokenAmountByTokenName)
      *
-     * @param tokenName Token name (e.g., "dragnrkti", "rocketri", "unicornri")
-     * @param options Calculation options
-     * @param options.amount Amount to calculate (GALA for 'native', tokens for 'exact')
-     * @param options.type Calculation type: 'native' = GALA input, 'exact' = token output
-     * @returns Promise<AmountCalculationResult> Calculated amount
-     * @throws ValidationError if parameters are invalid or token not found
+     * Supports both local (instant) and external (network-based) calculation modes with a flexible priority chain:
+     * 1. Per-call `options.mode` override (highest priority)
+     * 2. SDK-level `calculateAmountMode` configuration
+     * 3. Hardcoded default ('local')
+     *
+     * Priority chain resolution examples:
+     * - Per-call override: `calculateBuyAmount({ mode: 'external' })` → uses 'external' (regardless of SDK config)
+     * - SDK config: `new SDK({ calculateAmountMode: 'external' })` → uses 'external' (if no per-call override)
+     * - Hardcoded default: `new SDK({})` → uses 'local' (if no config or override)
+     *
+     * @param {CalculateBuyAmountOptions} options - Calculation options
+     * @param {string} options.tokenName - Token name (e.g., "dragnrkti", "rocketri", "unicornri")
+     * @param {string} options.amount - Amount to calculate (GALA for 'native', tokens for 'exact')
+     * @param {'native' | 'exact'} options.type - Calculation type: 'native' = GALA input, 'exact' = token output
+     * @param {'local' | 'external'} [options.mode] - Calculation mode: 'local' = instant client-side, 'external' = network-based (optional, uses SDK default if not provided)
+     * @param {string} [options.currentSupply] - Current token supply for local calculations (optional, auto-fetched if mode is 'local' and not provided)
+     * @returns {Promise<AmountCalculationResult>} Calculated amount
+     * @throws {ValidationError} If parameters are invalid or token not found
      *
      * @example
      * ```typescript
-     * // Calculate tokens received when spending 1 GALA
-     * const result = await sdk.launchpad.getBuyTokenAmount("dragnrkti", {
+     * // Calculate tokens received when spending 1 GALA (uses SDK default mode)
+     * const result = await sdk.launchpad.calculateBuyAmount({
+     *   tokenName: "dragnrkti",
      *   amount: "1", // 1 GALA
      *   type: "native"
      * });
      *
-     * // Calculate GALA cost for buying 100 tokens
-     * const result = await sdk.launchpad.getBuyTokenAmount("dragnrkti", {
+     * // Calculate GALA cost for buying 100 tokens (force external mode)
+     * const result = await sdk.launchpad.calculateBuyAmount({
+     *   tokenName: "dragnrkti",
      *   amount: "100", // 100 tokens
-     *   type: "exact"
+     *   type: "exact",
+     *   mode: "external" // Override: always use network calculation
+     * });
+     *
+     * // Fast local calculation with known supply (instant, no network calls)
+     * const result = await sdk.launchpad.calculateBuyAmount({
+     *   tokenName: "dragnrkti",
+     *   amount: "100",
+     *   type: "exact",
+     *   mode: "local",
+     *   currentSupply: "500000" // Pre-fetched supply eliminates API roundtrip
      * });
      * ```
      */
     calculateBuyAmount(options: CalculateBuyAmountOptions): Promise<AmountCalculationResult>;
+    /**
+     * Calculate buy amount using external network calculation (GalaChain)
+     *
+     * Performs network-based calculation via GalaChain gateway. This method bypasses local
+     * bonding curve calculations and queries the blockchain directly for accurate, real-time pricing.
+     *
+     * Use this method when:
+     * - You need guaranteed accuracy from the blockchain source
+     * - You want to ensure calculations match on-chain state exactly
+     * - Network latency is acceptable for your use case
+     *
+     * For instant calculations without network calls, use `calculateBuyAmountLocal()` instead.
+     *
+     * @param options External calculation options
+     * @param options.tokenName Token name (e.g., "dragnrkti", "rocketri", "unicornri")
+     * @param options.amount Amount to calculate (GALA for 'native', tokens for 'exact')
+     * @param options.type Calculation type: 'native' = GALA input, 'exact' = token output
+     * @returns Promise<AmountCalculationResult> Calculated amount from GalaChain
+     * @throws ValidationError if token not found or parameters invalid
+     *
+     * @example Calculate GALA cost for buying 100 tokens
+     * ```typescript
+     * const result = await sdk.launchpad.calculateBuyAmountExternal({
+     *   tokenName: 'mytoken',
+     *   amount: '100',
+     *   type: 'exact'
+     * });
+     * console.log('GALA needed:', result.amount);
+     * ```
+     *
+     * @example Calculate tokens received for 1 GALA
+     * ```typescript
+     * const result = await sdk.launchpad.calculateBuyAmountExternal({
+     *   tokenName: 'mytoken',
+     *   amount: '1',
+     *   type: 'native'
+     * });
+     * console.log('Tokens received:', result.amount);
+     * ```
+     *
+     * @since 3.8.0
+     * @category External Calculations
+     */
+    calculateBuyAmountExternal(options: {
+        tokenName: string;
+        amount: string;
+        type: 'native' | 'exact';
+    }): Promise<AmountCalculationResult>;
     /**
      * Get sell token amount calculation with unified API (replaces getSellExactTokenAmountByTokenName/getSellWithNativeAmountByTokenName)
      *
-     * @param tokenName Token name (e.g., "dragnrkti", "rocketri", "unicornri")
-     * @param options Calculation options
-     * @param options.amount Amount to calculate (tokens for 'exact', GALA for 'native')
-     * @param options.type Calculation type: 'exact' = token input, 'native' = GALA output
-     * @returns Promise<AmountCalculationResult> Calculated amount
-     * @throws ValidationError if parameters are invalid or token not found
+     * Supports both local (instant) and external (network-based) calculation modes with a flexible priority chain:
+     * 1. Per-call `options.mode` override (highest priority)
+     * 2. SDK-level `calculateAmountMode` configuration
+     * 3. Hardcoded default ('local')
+     *
+     * Priority chain resolution examples:
+     * - Per-call override: `calculateSellAmount({ mode: 'external' })` → uses 'external' (regardless of SDK config)
+     * - SDK config: `new SDK({ calculateAmountMode: 'external' })` → uses 'external' (if no per-call override)
+     * - Hardcoded default: `new SDK({})` → uses 'local' (if no config or override)
+     *
+     * @param {CalculateSellAmountOptions} options - Calculation options
+     * @param {string} options.tokenName - Token name (e.g., "dragnrkti", "rocketri", "unicornri")
+     * @param {string} options.amount - Amount to calculate (tokens for 'exact', GALA for 'native')
+     * @param {'exact' | 'native'} options.type - Calculation type: 'exact' = token input, 'native' = GALA output
+     * @param {'local' | 'external'} [options.mode] - Calculation mode: 'local' = instant client-side, 'external' = network-based (optional, uses SDK default if not provided)
+     * @param {string} [options.currentSupply] - Current token supply for local calculations (optional, auto-fetched if mode is 'local' and not provided)
+     * @param {string} [options.maxSupply] - Maximum token supply for local calculations (optional, auto-fetched if mode is 'local' and not provided)
+     * @param {number} [options.reverseBondingCurveMaxFeeFactor] - Max fee factor for local calculations (optional, auto-fetched if mode is 'local' and not provided)
+     * @param {number} [options.reverseBondingCurveMinFeeFactor] - Min fee factor for local calculations (optional, auto-fetched if mode is 'local' and not provided)
+     * @returns {Promise<AmountCalculationResult>} Calculated amount
+     * @throws {ValidationError} If parameters are invalid or token not found
      *
      * @example
      * ```typescript
-     * // Calculate GALA received when selling 50 tokens
-     * const result = await sdk.launchpad.getSellTokenAmount("dragnrkti", {
+     * // Calculate GALA received when selling 50 tokens (uses SDK default mode)
+     * const result = await sdk.launchpad.calculateSellAmount({
+     *   tokenName: "dragnrkti",
      *   amount: "50", // 50 tokens
      *   type: "exact"
      * });
      *
-     * // Calculate tokens needed to receive 0.5 GALA
-     * const result = await sdk.launchpad.getSellTokenAmount("dragnrkti", {
+     * // Calculate tokens needed to receive 0.5 GALA (force external mode)
+     * const result = await sdk.launchpad.calculateSellAmount({
+     *   tokenName: "dragnrkti",
      *   amount: "0.5", // 0.5 GALA
-     *   type: "native"
+     *   type: "native",
+     *   mode: "external" // Override: always use network calculation
+     * });
+     *
+     * // Fast local calculation with all parameters (instant, no network calls)
+     * const result = await sdk.launchpad.calculateSellAmount({
+     *   tokenName: "dragnrkti",
+     *   amount: "50",
+     *   type: "exact",
+     *   mode: "local",
+     *   currentSupply: "500000",
+     *   maxSupply: "10000000",
+     *   reverseBondingCurveMaxFeeFactor: 0.5,
+     *   reverseBondingCurveMinFeeFactor: 0.0  // Pre-fetched params eliminate API roundtrip
      * });
      * ```
      */
     calculateSellAmount(options: CalculateSellAmountOptions): Promise<AmountCalculationResult>;
+    /**
+     * Calculate sell amount using external network calculation (GalaChain)
+     *
+     * Performs network-based calculation via GalaChain gateway. This method bypasses local
+     * bonding curve calculations and queries the blockchain directly for accurate, real-time pricing.
+     *
+     * Use this method when:
+     * - You need guaranteed accuracy from the blockchain source
+     * - You want to ensure calculations match on-chain state exactly
+     * - Network latency is acceptable for your use case
+     *
+     * For instant calculations without network calls, use `calculateSellAmountLocal()` instead.
+     *
+     * @param options External calculation options
+     * @param options.tokenName Token name (e.g., "dragnrkti", "rocketri", "unicornri")
+     * @param options.amount Amount to calculate (tokens for 'exact', GALA for 'native')
+     * @param options.type Calculation type: 'exact' = token input, 'native' = GALA output
+     * @returns Promise<AmountCalculationResult> Calculated amount from GalaChain
+     * @throws ValidationError if token not found or parameters invalid
+     *
+     * @example Calculate GALA received when selling 50 tokens
+     * ```typescript
+     * const result = await sdk.launchpad.calculateSellAmountExternal({
+     *   tokenName: 'mytoken',
+     *   amount: '50',
+     *   type: 'exact'
+     * });
+     * console.log('GALA received:', result.amount);
+     * ```
+     *
+     * @example Calculate tokens needed to sell to receive 0.5 GALA
+     * ```typescript
+     * const result = await sdk.launchpad.calculateSellAmountExternal({
+     *   tokenName: 'mytoken',
+     *   amount: '0.5',
+     *   type: 'native'
+     * });
+     * console.log('Tokens to sell:', result.amount);
+     * ```
+     *
+     * @since 3.8.0
+     * @category External Calculations
+     */
+    calculateSellAmountExternal(options: {
+        tokenName: string;
+        amount: string;
+        type: 'exact' | 'native';
+    }): Promise<AmountCalculationResult>;
+    /**
+     * Calculate buy amount locally using bonding curve formula
+     *
+     * Performs instant client-side calculation without network calls to GalaChain.
+     * Uses exponential bonding curve mathematics to calculate GALA costs or token amounts.
+     *
+     * Benefits:
+     * - Instant calculation (no network latency)
+     * - No API rate limits
+     * - Works offline with known supply
+     * - Perfect for real-time price discovery
+     *
+     * Returns the same AmountCalculationResult structure as calculateBuyAmount for
+     * drop-in compatibility with existing code.
+     *
+     * @param options Local calculation options
+     * @param options.tokenName Token name (optional if currentSupply provided, required for auto-fetching)
+     * @param options.amount Amount to calculate (GALA for 'native', tokens for 'exact')
+     * @param options.type Calculation type: 'native' = GALA input, 'exact' = token output
+     * @param options.currentSupply Current token supply (optional - auto-fetched if missing)
+     * @returns Promise<AmountCalculationResult> Calculated amount and fees
+     * @throws ValidationError if parameters are invalid or tokenName missing when auto-fetching needed
+     *
+     * @example Calculate with auto-fetch (requires tokenName)
+     * ```typescript
+     * const result = await sdk.launchpad.calculateBuyAmountLocal({
+     *   tokenName: 'mytoken',
+     *   amount: '1000',
+     *   type: 'exact'
+     * });
+     * ```
+     *
+     * @example Pure calculation without network calls (tokenName not needed!)
+     * ```typescript
+     * const result = await sdk.launchpad.calculateBuyAmountLocal({
+     *   amount: '1000',
+     *   type: 'exact',
+     *   currentSupply: '500000'
+     * });
+     * console.log('GALA needed:', result.amount);
+     * ```
+     *
+     * @since 3.8.0
+     * @category Local Calculations
+     */
+    calculateBuyAmountLocal(options: CalculateBuyAmountLocalOptions): Promise<AmountCalculationResult>;
+    /**
+     * Calculate sell amount locally using bonding curve formula
+     *
+     * Performs instant client-side calculation without network calls to GalaChain.
+     * Uses exponential bonding curve mathematics to calculate GALA received or tokens needed.
+     *
+     * Benefits:
+     * - Instant calculation (no network latency)
+     * - No API rate limits
+     * - Works offline with known parameters
+     * - Perfect for real-time price discovery
+     *
+     * Returns the same AmountCalculationResult structure as calculateSellAmount for
+     * drop-in compatibility with existing code. Includes reverse bonding curve fee
+     * calculation that scales with supply.
+     *
+     * @param options Local calculation options
+     * @param options.tokenName Token name (optional if all parameters provided, required for auto-fetching)
+     * @param options.amount Amount to calculate (tokens for 'exact', GALA for 'native')
+     * @param options.type Calculation type: 'exact' = token input, 'native' = GALA output
+     * @param options.currentSupply Current token supply (optional - auto-fetched if missing)
+     * @param options.maxSupply Maximum token supply (optional - auto-fetched if missing)
+     * @param options.reverseBondingCurveMaxFeeFactor Max fee factor (optional - auto-fetched if missing)
+     * @param options.reverseBondingCurveMinFeeFactor Min fee factor (optional - auto-fetched if missing)
+     * @returns Promise<AmountCalculationResult> Calculated amount and fees
+     * @throws ValidationError if parameters are invalid or tokenName missing when auto-fetching needed
+     *
+     * @example Calculate with auto-fetch (requires tokenName)
+     * ```typescript
+     * const result = await sdk.launchpad.calculateSellAmountLocal({
+     *   tokenName: 'mytoken',
+     *   amount: '500',
+     *   type: 'exact'
+     * });
+     * ```
+     *
+     * @example Pure calculation without network calls (tokenName not needed!)
+     * ```typescript
+     * const result = await sdk.launchpad.calculateSellAmountLocal({
+     *   amount: '500',
+     *   type: 'exact',
+     *   currentSupply: '500000',
+     *   maxSupply: '10000000',
+     *   reverseBondingCurveMaxFeeFactor: 0.5,
+     *   reverseBondingCurveMinFeeFactor: 0.0
+     * });
+     * ```
+     *
+     * @since 3.8.0
+     * @category Local Calculations
+     */
+    calculateSellAmountLocal(options: CalculateSellAmountLocalOptions): Promise<AmountCalculationResult>;
     /**
      * Calculate buy amount needed to graduate a token pool
      *
@@ -417,6 +671,45 @@ export declare class LaunchpadAPI {
      * ```
      */
     calculateInitialBuyAmount(data: CalculatePreMintData): Promise<AmountCalculationResult>;
+    /**
+     * Fetches pool details from GalaChain optimized for local calculations
+     *
+     * Retrieves essential pool parameters needed for bonding curve calculations:
+     * - Current supply (computed with full precision)
+     * - Reverse bonding curve fee factors (normalized to numbers)
+     * - Net fee factor (max - min, for convenience)
+     * - Remaining tokens available in the pool
+     *
+     * This method is more efficient than `fetchPoolDetails()` as it returns only
+     * the fields needed for calculations, with automatic normalization applied.
+     *
+     * @param tokenName Token name to fetch pool details for
+     * @returns Promise with calculation-optimized pool details
+     * @throws {ValidationError} If token not found or vault address invalid
+     * @throws {ConfigurationError} If GalaChain client not configured
+     * @throws {NetworkError} If API request fails
+     *
+     * @example
+     * ```typescript
+     * const details = await sdk.launchpad.fetchPoolDetailsForCalculation('mytoken');
+     * console.log('Current supply:', details.currentSupply);
+     * console.log('Remaining tokens:', details.remainingTokens);
+     * console.log('Max fee factor:', details.reverseBondingCurveMaxFeeFactor);
+     * console.log('Min fee factor:', details.reverseBondingCurveMinFeeFactor);
+     * console.log('Net fee factor:', details.reverseBondingCurveNetFeeFactor);
+     * ```
+     *
+     * @since 3.8.0
+     * @category Pool Information
+     */
+    fetchPoolDetailsForCalculation(tokenName: string): Promise<{
+        currentSupply: string;
+        remainingTokens: string;
+        maxSupply: string;
+        reverseBondingCurveMaxFeeFactor: number;
+        reverseBondingCurveMinFeeFactor: number;
+        reverseBondingCurveNetFeeFactor: number;
+    }>;
     /**
      * Gets the authenticated user's address in backend format
      *

package/dist/api/LaunchpadAPI.d.ts.map

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

package/dist/constants/bondingCurve.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Bonding Curve Mathematical Constants
+ *
+ * These constants define the pricing model for launchpad tokens using an exponential bonding curve.
+ * The bonding curve ensures that token prices increase as supply increases, creating natural price discovery.
+ *
+ * @category Constants
+ * @since 3.8.0
+ *
+ * @example Using constants directly
+ * ```typescript
+ * import { BondingCurveConstants } from '@gala-chain/launchpad-sdk';
+ *
+ * console.log('Base Price:', BondingCurveConstants.BASE_PRICE);
+ * console.log('Max Supply:', BondingCurveConstants.LAUNCHPAD_TOKEN_MAX_SUPPLY);
+ * ```
+ */
+export declare class BondingCurveConstants {
+    /**
+     * Base price of the first token in the bonding curve
+     *
+     * This determines the initial cost when supply is at its minimum.
+     * The price increases exponentially as more tokens are minted.
+     *
+     * @constant
+     * @default 0.00001650667151
+     */
+    static readonly BASE_PRICE = 0.00001650667151;
+    /**
+     * Scaling factor controlling the rate of price increase
+     *
+     * Higher values cause faster price appreciation as supply grows.
+     * This factor is applied to supply in exponential calculations.
+     *
+     * @constant
+     * @default 0.000001166069
+     */
+    static readonly PRICE_SCALING_FACTOR = 0.000001166069;
+    /**
+     * Trading fee percentage (0.1%)
+     *
+     * Applied to all buy and sell transactions as a transaction fee.
+     * Calculated as: transactionAmount * TRADING_FEE_FACTOR
+     *
+     * @constant
+     * @default 0.001
+     */
+    static readonly TRADING_FEE_FACTOR = 0.001;
+    /**
+     * Static gas fee in GALA
+     *
+     * Fixed fee charged for blockchain transaction execution.
+     * This covers the cost of processing the transaction on GalaChain.
+     *
+     * @constant
+     * @default "1"
+     */
+    static readonly GAS_FEE = "1";
+    /**
+     * Minimum unbonding fee factor (0%)
+     *
+     * Base fee applied when selling tokens back to the bonding curve.
+     * Combined with supply-based dynamic fee for total unbonding cost.
+     *
+     * @constant
+     * @default 0
+     */
+    static readonly MIN_UNBONDING_FEE_FACTOR = 0;
+    /**
+     * Maximum unbonding fee factor (50%)
+     *
+     * Maximum additional fee that can be applied when selling tokens.
+     * Used in combination with current supply to calculate dynamic fees.
+     *
+     * @constant
+     * @default 0.5
+     */
+    static readonly MAX_UNBONDING_FEE_FACTOR = 0.5;
+    /**
+     * Net unbonding fee factor (50%)
+     *
+     * Used to calculate supply-proportional unbonding fees.
+     * Applied as: (currentSupply / maxSupply) * NET_UNBONDING_FEE_FACTOR
+     *
+     * @constant
+     * @default 0.5
+     */
+    static readonly NET_UNBONDING_FEE_FACTOR = 0.5;
+    /**
+     * Default maximum total supply for launchpad tokens
+     *
+     * This is the default value used when a token's specific maxSupply is not provided.
+     * Each token can have its own maxSupply value returned from pool details.
+     * Once this supply is reached, the token "graduates" from the bonding curve
+     * and becomes available for trading on the full DEX.
+     *
+     * @constant
+     * @default 10000000
+     */
+    static readonly DEFAULT_LAUNCHPAD_TOKEN_MAX_SUPPLY = 10000000;
+}
+//# sourceMappingURL=bondingCurve.d.ts.map

package/dist/constants/bondingCurve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bondingCurve.d.ts","sourceRoot":"","sources":["../../src/constants/bondingCurve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,qBAAqB;IAChC;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,oBAAoB;IAE9C;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,oBAAoB,kBAAkB;IAEtD;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,kBAAkB,SAAS;IAE3C;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,OAAO;IAE9B;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,wBAAwB,KAAK;IAE7C;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,wBAAwB,OAAO;IAE/C;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,wBAAwB,OAAO;IAE/C;;;;;;;;;;OAUG;IACH,MAAM,CAAC,QAAQ,CAAC,kCAAkC,YAAY;CAC/D"}

package/dist/constants/enums.d.ts

@@ -32,4 +32,34 @@ export declare const POOL_TYPES: {
     readonly RECENT: "recent";
     readonly POPULAR: "popular";
 };
+/**
+ * Calculation mode constants for amount calculations
+ *
+ * @example
+ * ```typescript
+ * import { CALCULATION_MODES } from '@gala-chain/launchpad-sdk';
+ *
+ * // Use local mode for instant calculations
+ * await sdk.calculateBuyAmount({
+ *   tokenName: 'anime',
+ *   amount: '100',
+ *   type: 'exact',
+ *   mode: CALCULATION_MODES.LOCAL
+ * });
+ *
+ * // Use external mode for network-based calculations
+ * await sdk.calculateBuyAmount({
+ *   tokenName: 'anime',
+ *   amount: '100',
+ *   type: 'exact',
+ *   mode: CALCULATION_MODES.EXTERNAL
+ * });
+ * ```
+ */
+export declare const CALCULATION_MODES: {
+    /** Client-side bonding curve calculation (instant, no network calls) */
+    readonly LOCAL: "local";
+    /** Network-based calculation via GalaChain (slower, always fresh) */
+    readonly EXTERNAL: "external";
+};
 //# sourceMappingURL=enums.d.ts.map

package/dist/constants/enums.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/constants/enums.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU;;;CAGb,CAAC"}
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/constants/enums.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU;;;CAGb,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,iBAAiB;IAC5B,wEAAwE;;IAExE,qEAAqE;;CAE7D,CAAC"}