@gala-chain/launchpad-sdk 6.0.0 → 7.0.0-beta.1

package/dist/src/utils/http.d.ts

@@ -1,113 +0,0 @@
-import { SigningType } from '@gala-chain/connect';
-import type { SignatureAuth } from '../auth/SignatureAuth';
-import type { HttpResponseWithMeta, RequestConfig, SDKConfig } from '../types/common';
-import type { EIP712Domain, EIP712Types } from '../types/trade.dto';
-/**
- * HTTP client with optional signature authentication
- *
- * This client automatically adds the `Sign` header to every request
- * using wallet signatures generated by SignatureAuth when a wallet is configured.
- *
- * In read-only mode (no wallet), the client skips authentication headers
- * and allows querying public data endpoints.
- */
-export declare class HttpClient {
-    private readonly axios;
-    private readonly auth;
-    private readonly debug;
-    private readonly logger;
-    private requestInterceptorId;
-    private responseInterceptorId;
-    constructor(auth: SignatureAuth | undefined, config?: SDKConfig);
-    /**
-     * Makes an authenticated HTTP request and returns body only (legacy default).
-     *
-     * @param config Request configuration
-     * @returns Promise<T> Response data
-     */
-    request<T = any>(config: RequestConfig): Promise<T>;
-    /**
-     * Makes an authenticated HTTP request and returns body + response headers.
-     *
-     * Prefer this for GalaChain write endpoints: the gateway puts
-     * `x-transaction-id` and `x-block-number` on headers, not in the JSON body.
-     *
-     * @param config Request configuration
-     * @returns Promise with data, headers (lowercase keys), and status
-     */
-    requestWithMeta<T = any>(config: RequestConfig): Promise<HttpResponseWithMeta<T>>;
-    /**
-     * Makes a GET request
-     */
-    get<T = any>(url: string, params?: Record<string, unknown>, headers?: Record<string, string>): Promise<T>;
-    /**
-     * Makes a POST request (body only)
-     */
-    post<T = any>(url: string, data?: unknown, headers?: Record<string, string>): Promise<T>;
-    /**
-     * Makes a POST request and returns body + response headers.
-     * Use for GalaChain TransferToken / lock / burn writes that emit
-     * `x-transaction-id` and `x-block-number` headers.
-     */
-    postWithMeta<T = any>(url: string, data?: unknown, headers?: Record<string, string>): Promise<HttpResponseWithMeta<T>>;
-    /**
-     * Makes a PUT request
-     */
-    put<T = any>(url: string, data?: unknown, headers?: Record<string, string>): Promise<T>;
-    /**
-     * Makes a DELETE request
-     */
-    delete<T = any>(url: string, params?: Record<string, unknown>, headers?: Record<string, string>): Promise<T>;
-    /**
-     * Makes a PATCH request
-     */
-    patch<T = any>(url: string, data?: unknown, headers?: Record<string, string>): Promise<T>;
-    /**
-     * Gets the authenticated user's address in backend format (eth|address)
-     */
-    getAddress(): string;
-    /**
-     * Gets the authenticated user's Ethereum address (0x prefixed)
-     */
-    getEthereumAddress(): string;
-    /**
-     * Signs a message using the authenticated wallet
-     */
-    signMessage(message: string): Promise<string>;
-    /**
-     * Signs typed data using EIP-712 standard
-     */
-    signTypedData(domain: EIP712Domain, types: EIP712Types, message: Record<string, unknown>): Promise<string>;
-    /**
-     * Signs a custom message (for endpoint-specific authentication)
-     *
-     * @param message The message to sign
-     * @returns Promise<{ signature: string; address: string; ethereumAddress: string }> Signature data
-     * @throws Error If signature generation fails
-     */
-    signCustomMessage(message: string): Promise<{
-        signature: string;
-        address: string;
-        ethereumAddress: string;
-    }>;
-    /**
-     * Signs a DTO using @gala-chain/connect SigningClient
-     * This automatically handles prefix calculation and EIP-712 signing
-     */
-    signWithGalaChain<T extends object>(method: string, dto: T, signingType?: SigningType): Promise<T & {
-        signature: string;
-        prefix?: string;
-        types: EIP712Types;
-        domain: EIP712Domain;
-    }>;
-    /**
-     * Sets up axios interceptors for authentication and error handling
-     */
-    private setupInterceptors;
-    /**
-     * Cleanup method to eject interceptors and prevent memory leaks
-     * Should be called when the HttpClient instance is no longer needed
-     */
-    cleanup(): void;
-}
-//# sourceMappingURL=http.d.ts.map

package/dist/src/utils/http.d.ts.map

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

package/dist/src/utils/load-env.d.ts

@@ -1,31 +0,0 @@
-/**
- * Environment variable loader that checks both root and local .env files
- * Useful for demo scripts and CLI tools that need wallet configuration
- */
-/**
- * Load environment variables from root .env and local .env files
- * Root .env is loaded first, then local .env (local overrides root)
- *
- * Usage in demo scripts:
- * ```typescript
- * import { loadEnvWithFallback } from '../src/utils/load-env';
- *
- * loadEnvWithFallback();
- *
- * const privateKey = process.env.WALLET_PRIVATE_KEY;
- * if (!privateKey) {
- *   throw new Error('WALLET_PRIVATE_KEY not set in root or local .env');
- * }
- * ```
- */
-export declare function loadEnvWithFallback(): void;
-/**
- * Get a specific environment variable with detailed error message
- * Checks both root and local .env files
- */
-export declare function getEnvOrThrow(varName: string, context?: string): string;
-/**
- * Get environment variable with optional default
- */
-export declare function getEnv(varName: string, defaultValue?: string): string | undefined;
-//# sourceMappingURL=load-env.d.ts.map

package/dist/src/utils/load-env.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../../src/utils/load-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAY1C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAWvE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjF"}

package/dist/src/utils/multipart-helpers.d.ts

@@ -1,38 +0,0 @@
-/**
- * Multipart Form Data Helpers
- *
- * Shared utilities for handling multipart/form-data file uploads
- * across browser and Node.js environments.
- *
- * @category Utilities
- * @since 3.11.5
- */
-/**
- * Prepare multipart form data for image upload
- *
- * Handles both browser File objects and Node.js Buffer objects,
- * automatically detecting the environment and creating appropriate
- * FormData structure.
- *
- * @param file - Image file as File object (browser) or Buffer (Node.js)
- * @param fieldName - Form field name for the file upload
- * @param filename - Filename to use when uploading Buffer
- * @returns FormData ready for multipart upload
- * @throws Error if file is neither File nor Buffer
- *
- * @example Browser usage
- * ```typescript
- * const fileInput = document.querySelector('#upload') as HTMLInputElement;
- * const file = fileInput.files?.[0];
- * const formData = prepareImageFormData(file, 'image', 'avatar.png');
- * ```
- *
- * @example Node.js usage
- * ```typescript
- * import * as fs from 'fs';
- * const buffer = fs.readFileSync('./image.png');
- * const formData = prepareImageFormData(buffer, 'image', 'token-image.png');
- * ```
- */
-export declare function prepareImageFormData(file: File | Buffer, fieldName: string | undefined, filename: string): FormData;
-//# sourceMappingURL=multipart-helpers.d.ts.map

package/dist/src/utils/multipart-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"multipart-helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/multipart-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,GAAG,MAAM,EACnB,SAAS,EAAE,MAAM,YAAU,EAC3B,QAAQ,EAAE,MAAM,GACf,QAAQ,CAiBV"}

package/dist/src/utils/multipart.d.ts

@@ -1,63 +0,0 @@
-/**
- * Utilities for handling multipart/form-data uploads
- *
- * This module provides cross-platform file upload support for both
- * browser and Node.js environments.
- *
- * MIGRATION NOTE: This file now uses Zod schemas for validation while maintaining
- * backward-compatible API through FileValidationError throwing functions.
- */
-/**
- * Error thrown when file validation fails
- */
-export declare class FileValidationError extends Error {
-    filename?: string | undefined;
-    mimeType?: string | undefined;
-    constructor(message: string, filename?: string | undefined, mimeType?: string | undefined);
-}
-/**
- * Validates a file against upload constraints using Zod schemas
- *
- * @param file File or Buffer to validate
- * @param filename Original filename (required for Buffer validation)
- * @param mimeType MIME type (required for Buffer validation)
- * @throws FileValidationError if validation fails
- */
-export declare function validateFile(file: File | Buffer, filename?: string, mimeType?: string): void;
-/**
- * Gets the file extension from a filename
- *
- * @param filename The filename to extract extension from
- * @returns File extension including the dot (e.g., '.png')
- */
-export declare function getFileExtension(filename: string | null | undefined): string;
-/**
- * Creates FormData for browser environments
- *
- * @param file File object to upload
- * @param data Additional form fields
- * @returns FormData object ready for upload
- */
-export declare function createFormData(file: File, data?: Record<string, unknown>): FormData;
-/**
- * Creates multipart form data for Node.js environments
- *
- * @param buffer Buffer containing file data
- * @param filename Original filename
- * @param mimeType MIME type of the file
- * @param data Additional form fields
- * @returns Object with data buffer and headers
- */
-export declare function createMultipartFormData(buffer: Buffer, filename: string, mimeType: string, data?: Record<string, unknown>): {
-    data: Buffer;
-    headers: Record<string, string>;
-};
-/**
- * Detects if this is a browser environment
- */
-export declare function isBrowserEnvironment(): boolean;
-/**
- * Detects if this is a Node.js environment
- */
-export declare function isNodeEnvironment(): boolean;
-//# sourceMappingURL=multipart.d.ts.map

package/dist/src/utils/multipart.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"multipart.d.ts","sourceRoot":"","sources":["../../../src/utils/multipart.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAeH;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAGnC,QAAQ,CAAC,EAAE,MAAM;IACjB,QAAQ,CAAC,EAAE,MAAM;gBAFxB,OAAO,EAAE,MAAM,EACR,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,QAAQ,CAAC,EAAE,MAAM,YAAA;CAK3B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,GAAG,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAoGN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAS5E;AA0BD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,QAAQ,CAiBV;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA0CnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAwB9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C"}

package/dist/src/utils/nft-helpers.d.ts

@@ -1,62 +0,0 @@
-/**
- * NFT Utility Helper Functions
- *
- * Utilities for NFT operations including validation, formatting,
- * and unique key generation for transactions.
- */
-/**
- * Generate unique key for NFT transactions
- * Used for idempotency in GalaChain operations
- *
- * @param prefix - Operation type prefix: 'auth' (authorize), 'create' (token class), 'mint'
- * @returns Unique key in format: {prefix}-{timestamp}-{random}
- */
-export declare function generateNftUniqueKey(prefix: 'auth' | 'create' | 'mint'): string;
-/**
- * Get DTO expiration timestamp
- * GalaChain DTOs expire after 60 seconds
- *
- * @returns Current timestamp + 60 seconds in milliseconds
- */
-export declare function getNftDtoExpiration(): number;
-/**
- * Validate NFT collection name format
- * Rules: alphanumeric (a-z, A-Z, 0-9), 3-50 characters
- *
- * @param name - Collection name to validate
- * @returns True if name is valid format
- */
-export declare function validateCollectionName(name: string): boolean;
-/**
- * Validate token symbol format
- * Rules: letters only (a-z, A-Z), 1-8 characters
- *
- * @param symbol - Token symbol to validate
- * @returns True if symbol is valid format
- */
-export declare function validateTokenSymbol(symbol: string): boolean;
-/**
- * Format number as whole number string for GalaChain
- * Truncates decimals and converts to string
- *
- * @param value - Number or string value to format
- * @returns Whole number as string (e.g., "1000")
- */
-export declare function formatWholeNumber(value: string | number): string;
-/**
- * Check if string is valid hex
- * Used for additionalKey validation
- *
- * @param str - String to check
- * @returns True if string is valid hex
- */
-export declare function isValidHex(str: string): boolean;
-/**
- * Validate GalaChain address format
- * Supports eth|{hex} format
- *
- * @param address - Address to validate
- * @returns True if address is valid format
- */
-export declare function validateGalaChainAddress(address: string): boolean;
-//# sourceMappingURL=nft-helpers.d.ts.map

package/dist/src/utils/nft-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"nft-helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/nft-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAI/E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK5D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQhE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAK/C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAKjE"}

package/dist/src/utils/numeric-patterns.d.ts

@@ -1,289 +0,0 @@
-/**
- * Numeric Calculation Patterns
- *
- * High-level numeric patterns for bonding curve fees, Uniswap V3 tick management,
- * percentile calculations, and safe division with thresholds.
- *
- * Consolidates 20+ occurrences of repeated mathematical patterns across trading,
- * liquidity, and portfolio services.
- *
- * @category Utilities
- * @since 5.17.0
- */
-import BigNumber from 'bignumber.js';
-/**
- * Calculate linearly interpolated fee between min and max based on progress
- *
- * Maps a progress value (0 to 1) to a fee between minFee and maxFee using linear interpolation.
- * This is the core pattern used in bonding curve calculations where fees scale from
- * minFeePortion to maxFeePortion based on token supply progress (supply / maxSupply).
- *
- * Formula: minFee + (maxFee - minFee) * progress
- *
- * Consolidates 4 occurrences in bondingCurveCalculations and related services.
- *
- * @param progress - Progress ratio from 0 to 1 (e.g., currentSupply / maxSupply)
- * @param minFee - Minimum fee value (as decimal, e.g., 0.1 for 10%)
- * @param maxFee - Maximum fee value (as decimal, e.g., 0.5 for 50%)
- * @returns Interpolated fee amount as BigNumber
- *
- * @throws Error if progress is outside [0, 1] or if maxFee < minFee
- *
- * @example
- * ```typescript
- * // Fee scales from 10% to 50% as supply increases
- * const progress = toBigNumber('500000').dividedBy('10000000'); // 0.05 = 5%
- * const fee = calculateLinearFeeInterpolation(progress, 0.1, 0.5);
- * // Returns: 0.1 + (0.5 - 0.1) * 0.05 = 0.12 (12%)
- *
- * // At max supply (100%), fee reaches 50%
- * const fee = calculateLinearFeeInterpolation(1, 0.1, 0.5);
- * // Returns: 0.5
- *
- * // At zero supply (0%), fee is minimum
- * const fee = calculateLinearFeeInterpolation(0, 0.1, 0.5);
- * // Returns: 0.1
- * ```
- */
-export declare function calculateLinearFeeInterpolation(progress: number | BigNumber, minFee: number, maxFee: number): BigNumber;
-/**
- * Round tick boundaries to valid Uniswap V3 spacing multiples
- *
- * Uniswap V3 ticks must be multiples of tickSpacing (1, 10, 60, 200, etc.).
- * This utility rounds tickLower down and tickUpper up to valid boundaries.
- *
- * Consolidates 5 occurrences of inline Math.floor/Math.ceil logic in GSwap services.
- *
- * @param tickLower - Lower tick boundary (before rounding)
- * @param tickUpper - Upper tick boundary (before rounding)
- * @param tickSpacing - Tick spacing requirement (e.g., 60 for 0.3% fee tier)
- * @returns Object with rounded tickLower (floor) and tickUpper (ceil)
- *
- * @throws Error if tickLower >= tickUpper or if tickSpacing <= 0
- *
- * @example
- * ```typescript
- * // Round to nearest 60-tick multiples
- * const rounded = roundTickBoundaries(1234, 5678, 60);
- * // Returns: { tickLower: 1200, tickUpper: 5700 }
- * // (1234 rounds down to 1200, 5678 rounds up to 5700)
- *
- * // Handle negative ticks (below price 1.0)
- * const rounded = roundTickBoundaries(-1234, -1000, 10);
- * // Returns: { tickLower: -1240, tickUpper: -1000 }
- *
- * // Ticks already valid (multiples of spacing)
- * const rounded = roundTickBoundaries(0, 60, 60);
- * // Returns: { tickLower: 0, tickUpper: 60 }
- * ```
- */
-export declare function roundTickBoundaries(tickLower: number, tickUpper: number, tickSpacing: number): {
-    tickLower: number;
-    tickUpper: number;
-};
-/**
- * Map price range to tick range and return both computed ticks and actual prices
- *
- * Converts a human-readable price range to Uniswap V3 ticks, then converts back
- * to compute the actual prices those ticks represent (due to rounding effects).
- *
- * This bidirectional mapping is essential for liquidity position validation where
- * users specify a price range but the actual executable range differs due to
- * tick quantization.
- *
- * Consolidates 3 occurrences of price-tick conversion with validation logic.
- *
- * @param minPrice - Minimum price (human-readable, e.g., "0.95")
- * @param maxPrice - Maximum price (human-readable, e.g., "1.05")
- * @param tickSpacing - Tick spacing requirement (default: 60)
- * @returns Object with computed ticks and the actual prices they represent
- *
- * @throws Error if minPrice >= maxPrice or if prices are non-positive
- *
- * @example
- * ```typescript
- * // Map price range [0.95, 1.05] to ticks with 60-tick spacing
- * const mapping = priceTickRangeMapping('0.95', '1.05', 60);
- * // Returns: {
- * //   minTick: -2700,
- * //   maxTick: 1320,
- * //   actualMinPrice: BigNumber('0.949...'),  // Slightly lower due to rounding
- * //   actualMaxPrice: BigNumber('1.050...')   // Slightly higher due to rounding
- * // }
- *
- * // Confirms to user: "You requested [0.95, 1.05] but will get [0.949..., 1.050...]"
- * ```
- */
-export declare function priceTickRangeMapping(minPrice: string | number | BigNumber, maxPrice: string | number | BigNumber, tickSpacing?: number): {
-    minTick: number;
-    maxTick: number;
-    actualMinPrice: BigNumber;
-    actualMaxPrice: BigNumber;
-};
-/**
- * Calculate percentile index in a sorted array
- *
- * Computes the array index corresponding to a given percentile (0-100).
- * Uses linear interpolation for fractional positions.
- *
- * Consolidates 3 occurrences of percentile calculations in monitoring metrics.
- *
- * @param sortedArray - Array of numbers, must be sorted in ascending order
- * @param percentile - Percentile value from 0 to 100 (e.g., 95 for 95th percentile)
- * @returns The array index, or -1 if array is empty
- *
- * @throws Error if percentile is outside [0, 100] or array is not sorted
- *
- * @example
- * ```typescript
- * // Get 95th percentile from latency measurements
- * const latencies = [10, 25, 50, 75, 100, 150, 200];
- * const p95Index = percentileIndexCalculation(latencies, 95);
- * // Returns index 6 (value 200, or interpolated between 150-200)
- *
- * // Median (50th percentile)
- * const medianIndex = percentileIndexCalculation(latencies, 50);
- * // Returns index 3 (value 75)
- *
- * // Min/Max
- * const minIndex = percentileIndexCalculation(latencies, 0);   // 0
- * const maxIndex = percentileIndexCalculation(latencies, 100); // 6
- * ```
- */
-export declare function percentileIndexCalculation(sortedArray: number[], percentile: number): number;
-/**
- * Round decimal up to specified precision (ceiling rounding)
- *
- * Always rounds UP to the specified decimal places. This ensures system accuracy
- * and prevents shortchanging calculations (e.g., fee calculations always round up
- * to protect the fee recipient).
- *
- * Consolidates 3 occurrences of Math.ceil with decimal precision patterns.
- *
- * @param value - Value to round (string, number, or BigNumber)
- * @param decimals - Number of decimal places to preserve
- * @returns Rounded value as BigNumber
- *
- * @throws Error if decimals is negative
- *
- * @example
- * ```typescript
- * // Fee calculations that always round up
- * const fee = decimalRoundingUp('1.234', 2);  // 1.24 (rounds up from 1.23)
- *
- * // Preserve more decimals
- * const precise = decimalRoundingUp('1.23456', 4);  // 1.2346
- *
- * // Integer rounding
- * const integer = decimalRoundingUp('1.1', 0);  // 2 (rounds up to next integer)
- *
- * // Very small values
- * const tiny = decimalRoundingUp('0.00001', 4);  // 0.0001
- * ```
- */
-export declare function decimalRoundingUp(value: string | number | BigNumber, decimals: number): BigNumber;
-/**
- * Divide with zero fallback AND minimum threshold check
- *
- * Performs safe division with two layers of protection:
- * 1. Returns fallback if denominator is zero
- * 2. Returns minimum threshold if computed result is less than minimum
- *
- * This prevents calculations from producing unrealistic micro-values (e.g., APR
- * calculations that shouldn't return 0.0000001%).
- *
- * Consolidates 3 partial occurrences across APR and portfolio calculations.
- *
- * @param numerator - Dividend
- * @param denominator - Divisor
- * @param minimum - Minimum threshold (default: "0", meaning no minimum)
- * @param fallback - Value to return if denominator is zero (default: "0")
- * @returns The quotient, minimum threshold if result is too small, or fallback if denominator is zero
- *
- * @throws Error if minimum is negative or minimum > maximum representable value
- *
- * @example
- * ```typescript
- * // Safe division with zero fallback
- * const ratio = safeDivideWithMinimum('100', '0', undefined, '0');
- * // Returns: "0" (denominator is zero)
- *
- * // Enforce minimum APR (never report less than 0.01%)
- * const apr = safeDivideWithMinimum(
- *   feeAmount,
- *   liquidityValue,
- *   '0.0001'  // Minimum 0.01% APR
- * );
- *
- * // Threshold prevents micro-values
- * const tiny = safeDivideWithMinimum('1', '1000000', '0.001');
- * // Result 0.000001 is < minimum 0.001, so returns 0.001
- *
- * // Normal division (result meets threshold)
- * const normal = safeDivideWithMinimum('100', '10', '0.001');
- * // Result 10 > minimum 0.001, so returns 10
- * ```
- */
-export declare function safeDivideWithMinimum(numerator: string | number | BigNumber, denominator: string | number | BigNumber, minimum?: string | number | BigNumber, fallback?: string | number | BigNumber): BigNumber;
-/**
- * Round a Uniswap V3 tick to a valid spacing multiple
- *
- * Uniswap V3 ticks must be multiples of tickSpacing (e.g., 1, 10, 60, 200).
- * This utility rounds down to the nearest valid tick spacing using integer arithmetic.
- *
- * Formula: `Math.floor(tick / tickSpacing) * tickSpacing`
- *
- * Consolidates 4 occurrences of inline tick rounding logic in GSwap services.
- *
- * @param tick - The tick value to round (can be negative for prices below 1.0)
- * @param tickSpacing - The tick spacing requirement (e.g., 1, 10, 60, 200)
- * @returns The rounded tick (multiple of tickSpacing)
- *
- * @throws Error if tickSpacing <= 0
- *
- * @example
- * ```typescript
- * // Round tick 1055 to nearest tick spacing of 10
- * const rounded = roundTickToSpacing(1055, 10);  // 1050
- *
- * // Round tick 101 to spacing 60
- * const rounded = roundTickToSpacing(101, 60);   // 60
- *
- * // Negative ticks are also supported (for prices below 1.0)
- * const rounded = roundTickToSpacing(-1055, 10); // -1060
- * ```
- */
-export declare function roundTickToSpacing(tick: number, tickSpacing: number): number;
-/**
- * Calculate reverse bonding curve fee amount with precision handling
- *
- * Consolidates the pattern of applying a fee factor to a base amount with
- * integer rounding (down). Used extensively in bonding curve calculations
- * for reverse fee computation and scaled amount operations.
- *
- * Formula: `new BigNumber(baseAmount).multipliedBy(feeFactor).integerValue(BigNumber.ROUND_DOWN)`
- *
- * Consolidates 3 occurrences of fee scaling patterns in trading services.
- *
- * @param baseAmount - The base amount to apply fee factor to (string, number, or BigNumber)
- * @param feeFactor - The fee factor as decimal (e.g., 0.1 for 10%, 0.005 for 0.5%)
- * @returns The scaled fee amount (rounded down to integer)
- *
- * @throws Error if feeFactor is negative
- *
- * @example
- * ```typescript
- * // Calculate 1% fee on 1000 GALA
- * const baseAmount = new BigNumber('1000');
- * const fee = calculateScaledFeeAmount(baseAmount, 0.01);  // BigNumber(10)
- *
- * // Calculate 0.5% reverse bonding curve fee
- * const feeAmount = calculateScaledFeeAmount('5000', 0.005);  // BigNumber(25)
- *
- * // Fee factor from pool: reverseBondingCurveFee = 0.123456
- * const reversed = calculateScaledFeeAmount(amount, reverseBondingCurveFee);
- * // Returns: rounded-down result of amount * 0.123456
- * ```
- */
-export declare function calculateScaledFeeAmount(baseAmount: string | number | BigNumber, feeFactor: number): BigNumber;
-//# sourceMappingURL=numeric-patterns.d.ts.map

package/dist/src/utils/numeric-patterns.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"numeric-patterns.d.ts","sourceRoot":"","sources":["../../../src/utils/numeric-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,SAAS,MAAM,cAAc,CAAC;AAIrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,SAAS,CAiBX;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAmB1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACrC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACrC,WAAW,GAAE,MAAW,GACvB;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,SAAS,CAAC;IAC1B,cAAc,EAAE,SAAS,CAAC;CAC3B,CAiCA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,EAAE,MAAM,GACjB,MAAM,CAeR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,GACf,SAAS,CAUX;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACtC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACxC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACrC,QAAQ,GAAE,MAAM,GAAG,MAAM,GAAG,SAAe,GAC1C,SAAS,CA0BX;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACvC,SAAS,EAAE,MAAM,GAChB,SAAS,CAMX"}