@gala-chain/launchpad-sdk 3.31.0 → 4.0.0

package/dist/types/galachain-api.types.d.ts

@@ -0,0 +1,206 @@
+/**
+ * GalaChain Gateway and DEX Backend API Type Definitions
+ *
+ * Comprehensive, fully-typed definitions for all API responses from:
+ * - GalaChain Gateway (DEX contract endpoints)
+ * - DEX Backend API
+ *
+ * Zero `any` types, complete type safety across all API operations.
+ */
+import BigNumber from 'bignumber.js';
+/**
+ * GalaChain Gateway response wrapper
+ * All Gateway responses wrap the actual data in this structure
+ */
+export interface GalaChainGatewayResponse<T> {
+    Data: T;
+    Status: number;
+    Message?: string;
+}
+/**
+ * Token class key structure used in API responses
+ */
+export interface TokenClassKey {
+    collection: string;
+    category: string;
+    type: string;
+    additionalKey: string;
+}
+/**
+ * Pool data from GetPoolData endpoint
+ * Complete Uniswap V3 pool state including tick, liquidity, fees
+ */
+export interface GalaChainPoolData {
+    token0: TokenClassKey;
+    token1: TokenClassKey;
+    fee: number;
+    tickSpacing: number;
+    liquidity: string;
+    sqrtPriceX96: string;
+    tick: number;
+    feeGrowthGlobal0X128: string;
+    feeGrowthGlobal1X128: string;
+    maxLiquidityPerTick?: string;
+    observations?: Array<{
+        blockTimestamp: number;
+        tickCumulative: number;
+        secondsPerLiquidityCumulativeX128: string;
+        initialized: boolean;
+    }>;
+    currentPrice?: string;
+    token0Decimals?: number;
+    token1Decimals?: number;
+    initialized?: boolean;
+    poolAddress?: string;
+}
+/**
+ * Individual position data from GetPositions endpoint
+ * Represents a concentrated liquidity position in a pool
+ */
+export interface GalaChainPosition {
+    positionId: string;
+    owner: string;
+    token0: TokenClassKey;
+    token1: TokenClassKey;
+    fee: number;
+    tickLower: number;
+    tickUpper: number;
+    liquidity: string;
+    feeGrowthInside0LastX128: string;
+    feeGrowthInside1LastX128: string;
+    tokensOwed0: string;
+    tokensOwed1: string;
+    amount0?: string;
+    amount1?: string;
+    feeAmount0?: string;
+    feeAmount1?: string;
+    createdAt?: number;
+    updatedAt?: number;
+    operator?: string;
+}
+/**
+ * Response from GetPositions endpoint
+ * Can return multiple positions for a wallet/criteria
+ */
+export interface GalaChainGetPositionsResponse {
+    positions: GalaChainPosition[];
+    count: number;
+    totalLiquidity?: string;
+    totalValue?: string;
+    nextBookMark?: string;
+}
+/**
+ * Estimated amounts when removing liquidity
+ * From GetRemoveLiquidityEstimation endpoint
+ */
+export interface GalaChainRemoveLiquidityEstimation {
+    amount0: string;
+    amount1: string;
+    fee0: string;
+    fee1: string;
+    liquidity: string;
+    tickLower: number;
+    tickUpper: number;
+    currentPrice?: string;
+    token0Symbol?: string;
+    token1Symbol?: string;
+}
+/**
+ * User asset from DEX Backend API
+ * Represents a token in a user's wallet on the DEX
+ */
+export interface DexBackendUserAsset {
+    tokenId: TokenClassKey | string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    balance: string | BigNumber;
+    contractAddress?: string;
+    imageUrl?: string;
+    verified?: boolean;
+    trading?: boolean;
+    walletAddress?: string;
+}
+/**
+ * Response from DEX Backend getUserAssets endpoint
+ * List of all tokens user holds on the DEX
+ */
+export interface DexBackendUserAssetsResponse {
+    tokens: DexBackendUserAsset[];
+    count: number;
+    totalValue?: string;
+}
+/**
+ * Request to GetPoolData endpoint
+ */
+export interface GalaChainGetPoolDataRequest {
+    tokenA: TokenClassKey | string;
+    tokenB: TokenClassKey | string;
+    feeTier: number;
+}
+/**
+ * Request to GetPositions endpoint
+ * Multiple query filters supported
+ */
+export interface GalaChainGetPositionsRequest {
+    owner?: string;
+    tokenA?: TokenClassKey | string;
+    tokenB?: TokenClassKey | string;
+    feeTier?: number;
+    positionId?: string;
+    limit?: number;
+    bookmark?: string;
+}
+/**
+ * Request to GetRemoveLiquidityEstimation endpoint
+ */
+export interface GalaChainGetRemoveLiquidityEstimationRequest {
+    tokenA: TokenClassKey | string;
+    tokenB: TokenClassKey | string;
+    fee: number;
+    tickLower: number;
+    tickUpper: number;
+    liquidity: string;
+}
+/**
+ * Request to DEX Backend getUserAssets endpoint
+ */
+export interface DexBackendGetUserAssetsRequest {
+    walletAddress: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Standard API error response
+ */
+export interface ApiErrorResponse {
+    Status: number;
+    Message: string;
+    Data?: Record<string, unknown>;
+}
+/**
+ * Parsed error with context
+ */
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly message: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(status: number, message: string, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Check if value is a TokenClassKey
+ */
+export declare function isTokenClassKey(value: unknown): value is TokenClassKey;
+/**
+ * Check if value is a GalaChainPoolData response
+ */
+export declare function isGalaChainPoolData(value: unknown): value is GalaChainPoolData;
+/**
+ * Check if value is a GalaChainPosition
+ */
+export declare function isGalaChainPosition(value: unknown): value is GalaChainPosition;
+/**
+ * Check if value is a DexBackendUserAsset
+ */
+export declare function isDexBackendUserAsset(value: unknown): value is DexBackendUserAsset;
+//# sourceMappingURL=galachain-api.types.d.ts.map

package/dist/types/galachain-api.types.d.ts.map

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

package/dist/types/gswap-responses.types.d.ts

@@ -0,0 +1,366 @@
+/**
+ * GSwap SDK Response Types
+ *
+ * Comprehensive type definitions for all responses from @gala-chain/gswap-sdk.
+ * These types eliminate `as any` casts and provide complete type safety for
+ * GSwapService wrapper layer.
+ *
+ * Structure:
+ * - GSwap SDK Request/Response Types
+ * - Quote Response Types
+ * - Swap Result Types
+ * - Asset Types
+ * - Pool Data Types
+ * - Position Types
+ * - Error Types
+ * - Validators and Type Guards
+ */
+import BigNumber from 'bignumber.js';
+/**
+ * GSwap quote response (exact input)
+ * Response from gswap.quoting.quoteExactInput()
+ */
+export interface GSwapQuoteExactInputResponse {
+    outTokenAmount: BigNumber;
+    feeTier: number;
+    priceImpact: BigNumber;
+    executionPrice?: BigNumber;
+    minimumOutputAmount?: BigNumber;
+    path?: string[];
+    pools?: string[];
+}
+/**
+ * GSwap quote response (exact output)
+ * Response from gswap.quoting.quoteExactOutput()
+ */
+export interface GSwapQuoteExactOutputResponse {
+    inTokenAmount: BigNumber;
+    feeTier: number;
+    priceImpact: BigNumber;
+    executionPrice?: BigNumber;
+    maximumInputAmount?: BigNumber;
+    path?: string[];
+    pools?: string[];
+}
+/**
+ * GSwap token/asset from API
+ */
+export interface GSwapTokenAsset {
+    tokenId: string | Record<string, any>;
+    tokenClass?: {
+        collection: string;
+        category: string;
+        type: string;
+        additionalKey: string;
+    };
+    symbol: string;
+    name?: string;
+    decimals: number;
+    balance: string | BigNumber;
+    contractAddress?: string;
+    imageUrl?: string;
+}
+/**
+ * GSwap user assets response
+ * Response from gswap.assets.getUserAssets()
+ */
+export interface GSwapUserAssetsResponse {
+    tokens: GSwapTokenAsset[];
+    count: number;
+    totalValue?: string;
+}
+/**
+ * GSwap pool data (raw from API)
+ * Response from gswap.pools.getPoolData()
+ */
+export interface GSwapPoolDataRaw {
+    tokenA: string | Record<string, any>;
+    tokenB: string | Record<string, any>;
+    feeTier: number;
+    liquidity: string | BigNumber;
+    sqrtPriceX96: string | BigNumber;
+    tick: number;
+    tickSpacing: number;
+    feeGrowthGlobal0X128: string | BigNumber;
+    feeGrowthGlobal1X128: string | BigNumber;
+    currentPrice?: string | BigNumber;
+    token0Decimals?: number;
+    token1Decimals?: number;
+    fee?: number;
+    poolAddress?: string;
+    initialized?: boolean;
+    observations?: any[];
+    maxLiquidityPerTick?: string;
+}
+/**
+ * GSwap pool info
+ * Simplified pool structure
+ */
+export interface GSwapPoolInfo {
+    tokenA: string;
+    tokenB: string;
+    feeTier: number;
+    liquidity: string;
+    currentPrice?: string;
+    tick?: number;
+}
+/**
+ * GSwap position data (from list query)
+ * Individual position from gswap.positions.getUserPositions() response
+ */
+export interface GSwapPositionData {
+    positionId: string;
+    tokenId: string | number;
+    token0: string | Record<string, any>;
+    token1: string | Record<string, any>;
+    fee: number;
+    feeTier?: number;
+    tickLower: number;
+    tickUpper: number;
+    liquidity: string | BigNumber;
+    feeGrowthInside0LastX128?: string | BigNumber;
+    feeGrowthInside1LastX128?: string | BigNumber;
+    tokensOwed0?: string | BigNumber;
+    tokensOwed1?: string | BigNumber;
+    amount0?: string | BigNumber;
+    amount1?: string | BigNumber;
+    feeAmount0?: string | BigNumber;
+    feeAmount1?: string | BigNumber;
+    createdAt?: number;
+    updatedAt?: number;
+    owner?: string;
+    operator?: string;
+}
+/**
+ * GSwap user positions response
+ * Response from gswap.positions.getUserPositions()
+ * Supports both paginated (with nextBookmark) and non-paginated response formats
+ */
+export interface GSwapUserPositionsResponse {
+    positions: GSwapPositionData[];
+    count: number;
+    totalLiquidity?: string | BigNumber;
+    totalValue?: string;
+    /** Bookmark for fetching next page of results (if pagination is supported by API) - API returns nextBookMark with capital M */
+    nextBookMark?: string;
+}
+/**
+ * GSwap get position result
+ * Response from gswap.positions.getPosition()
+ */
+export interface GSwapGetPositionResult {
+    position: GSwapPositionData;
+    owner: string;
+    liquidity: string | BigNumber;
+    feeGrowthOutside0X128: string | BigNumber;
+    feeGrowthOutside1X128: string | BigNumber;
+}
+/**
+ * GSwap get position by ID result
+ * Response from gswap.positions.getPositionById()
+ */
+export interface GSwapGetPositionByIdResult {
+    positionId: string;
+    owner: string;
+    token0: string | Record<string, any>;
+    token1: string | Record<string, any>;
+    fee: number;
+    tickLower: number;
+    tickUpper: number;
+    liquidity: string | BigNumber;
+    feeGrowthInside0LastX128: string | BigNumber;
+    feeGrowthInside1LastX128: string | BigNumber;
+    tokensOwed0: string | BigNumber;
+    tokensOwed1: string | BigNumber;
+}
+/**
+ * GSwap estimate remove liquidity result
+ * Response from gswap.positions.estimateRemoveLiquidity()
+ */
+export interface GSwapEstimateRemoveLiquidityResult {
+    amount0: string | BigNumber;
+    amount1: string | BigNumber;
+    fee0: string | BigNumber;
+    fee1: string | BigNumber;
+    liquidity: string | BigNumber;
+    tickLower: number;
+    tickUpper: number;
+    currentPrice?: string | BigNumber;
+    token0Symbol?: string;
+    token1Symbol?: string;
+}
+/**
+ * GSwap add liquidity result (pending transaction)
+ * Response from gswap.positions.addLiquidityByPrice() or addLiquidityByTicks()
+ */
+export interface GSwapAddLiquidityResult {
+    transactionId: string;
+    txHash?: string;
+    positionId?: string;
+    liquidity?: string | BigNumber;
+    amount0?: string;
+    amount1?: string;
+    feeAmount0?: string;
+    feeAmount1?: string;
+    token0?: string;
+    token1?: string;
+    feeTier?: number;
+    tickLower?: number;
+    tickUpper?: number;
+    status?: string;
+    createdAt?: number;
+}
+/**
+ * GSwap remove liquidity result (pending transaction)
+ * Response from gswap.positions.removeLiquidity()
+ */
+export interface GSwapRemoveLiquidityResult {
+    transactionId: string;
+    txHash?: string;
+    amount0?: string | BigNumber;
+    amount1?: string | BigNumber;
+    status?: string;
+    createdAt?: number;
+}
+/**
+ * GSwap collect fees result (pending transaction)
+ * Response from gswap.positions.collectPositionFees()
+ */
+export interface GSwapCollectFeesResult {
+    transactionId: string;
+    txHash?: string;
+    fee0?: string | BigNumber;
+    fee1?: string | BigNumber;
+    status?: string;
+    createdAt?: number;
+}
+/**
+ * Add liquidity by price parameters (GSwap SDK format)
+ */
+export interface GSwapAddLiquidityByPriceParams {
+    token0: string | Record<string, any>;
+    token1: string | Record<string, any>;
+    fee: number;
+    minPrice: string | BigNumber;
+    maxPrice: string | BigNumber;
+    amount0Desired: string | BigNumber;
+    amount1Desired: string | BigNumber;
+    amount0Min?: string | BigNumber;
+    amount1Min?: string | BigNumber;
+    deadline?: number;
+}
+/**
+ * Add liquidity by ticks parameters (GSwap SDK format)
+ */
+export interface GSwapAddLiquidityByTicksParams {
+    token0: string | Record<string, any>;
+    token1: string | Record<string, any>;
+    fee: number;
+    tickLower: number;
+    tickUpper: number;
+    amount0Desired: string | BigNumber;
+    amount1Desired: string | BigNumber;
+    amount0Min?: string | BigNumber;
+    amount1Min?: string | BigNumber;
+    deadline?: number;
+}
+/**
+ * Remove liquidity parameters (GSwap SDK format)
+ */
+export interface GSwapRemoveLiquidityParams {
+    tokenId: string | number;
+    liquidity: string | BigNumber;
+    amount0Min: string | BigNumber;
+    amount1Min: string | BigNumber;
+    deadline?: number;
+}
+/**
+ * Collect position fees parameters (GSwap SDK format)
+ */
+export interface GSwapCollectFeesParams {
+    tokenId: string | number;
+    amount0Max?: string | BigNumber;
+    amount1Max?: string | BigNumber;
+}
+/**
+ * GSwap SDK error response
+ */
+export interface GSwapErrorResponse {
+    code?: string;
+    message: string;
+    details?: Record<string, any>;
+    txHash?: string;
+    originalError?: any;
+}
+/**
+ * GSwap spot price result
+ * Response from gswap.pricing.getSpotPrice() or similar
+ */
+export interface GSwapSpotPriceResult {
+    tokenA: string;
+    tokenB: string;
+    price: string | BigNumber;
+    invertedPrice?: string | BigNumber;
+    tick?: number;
+    liquidity?: string | BigNumber;
+    timestamp?: number;
+}
+/**
+ * Type guard for GSwapQuoteExactInputResponse
+ */
+export declare function isGSwapQuoteExactInputResponse(value: any): value is GSwapQuoteExactInputResponse;
+/**
+ * Type guard for GSwapQuoteExactOutputResponse
+ */
+export declare function isGSwapQuoteExactOutputResponse(value: any): value is GSwapQuoteExactOutputResponse;
+/**
+ * Type guard for GSwapUserAssetsResponse
+ */
+export declare function isGSwapUserAssetsResponse(value: any): value is GSwapUserAssetsResponse;
+/**
+ * Type guard for GSwapPoolDataRaw
+ */
+export declare function isGSwapPoolDataRaw(value: any): value is GSwapPoolDataRaw;
+/**
+ * Type guard for GSwapUserPositionsResponse
+ */
+export declare function isGSwapUserPositionsResponse(value: any): value is GSwapUserPositionsResponse;
+/**
+ * Type guard for GSwapPositionData
+ */
+export declare function isGSwapPositionData(value: any): value is GSwapPositionData;
+/**
+ * Type guard for GSwapAddLiquidityResult
+ */
+export declare function isGSwapAddLiquidityResult(value: any): value is GSwapAddLiquidityResult;
+/**
+ * Type guard for GSwapRemoveLiquidityResult
+ */
+export declare function isGSwapRemoveLiquidityResult(value: any): value is GSwapRemoveLiquidityResult;
+/**
+ * Type guard for GSwapCollectFeesResult
+ */
+export declare function isGSwapCollectFeesResult(value: any): value is GSwapCollectFeesResult;
+/**
+ * Type guard for transaction result (any pending transaction)
+ */
+export declare function isGSwapTransactionResult(value: any): value is GSwapAddLiquidityResult | GSwapRemoveLiquidityResult | GSwapCollectFeesResult;
+/**
+ * Extract transaction ID from various GSwap result types
+ */
+export declare function extractTransactionId(result: any): string | undefined;
+/**
+ * Validate BigNumber conversion
+ */
+export declare function isBigNumberLike(value: any): value is BigNumber | {
+    toFixed(): string;
+};
+/**
+ * Safely convert value to BigNumber
+ */
+export declare function toBigNumberSafe(value: any): BigNumber;
+/**
+ * Safely convert value to string (handles BigNumber)
+ */
+export declare function toStringSafe(value: any): string;
+//# sourceMappingURL=gswap-responses.types.d.ts.map

package/dist/types/gswap-responses.types.d.ts.map

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

package/dist/types/gswap.dto.d.ts

@@ -22,10 +22,12 @@ export interface TokenClass {
  */
 export interface GSwapServiceConfig {
     privateKey?: string | undefined;
-    walletAddress?: string | undefined;
+    getWalletAddress: () => string | undefined;
     gatewayBaseUrl?: string | undefined;
     bundlerBaseUrl?: string | undefined;
+    galaChainBaseUrl?: string | undefined;
     dexBackendBaseUrl?: string | undefined;
+    dexBackendHttp?: any | undefined;
 }
 /**
  * Parameters for getting swap quotes
@@ -48,6 +50,8 @@ export interface SwapQuoteResult {
     feeTier: number;
     priceImpact: string;
     executionPrice: string;
+    currentSqrtPrice: string;
+    newSqrtPrice: string;
 }
 /**
  * Parameters for executing a swap
@@ -170,8 +174,8 @@ export interface LiquidityPosition {
     amount1: string;
     feeAmount0: string;
     feeAmount1: string;
-    createdAt: Date;
-    updatedAt: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
 }
 /**
  * GSwap position - Type-safe liquidity position from GalaSwap API
@@ -337,4 +341,55 @@ export interface PriceFromTicksResult {
     priceRange: string;
     tickSpread: number;
 }
+/**
+ * Pool slot0 data from GetSlot0 API
+ * Contains current pool state including price and liquidity
+ */
+export interface PoolSlot0Data {
+    sqrtPrice: string;
+    tick: number;
+    liquidity: string;
+    grossPoolLiquidity: string;
+}
+/**
+ * Calculated pool price data
+ * Combines slot0 data with calculated price
+ */
+export interface PoolPriceData {
+    price: string;
+    sqrtPrice: string;
+    tick: number;
+    liquidity: string;
+}
+/**
+ * Options for liquidity position queries with optional pricing
+ * @agent Controls whether to enrich positions with real-time pricing data
+ * @note Concurrency level is controlled by SDK-level pricingConcurrency config (not per-call parameter)
+ */
+export interface GetLiquidityPositionsOptions {
+    withPrices?: boolean;
+}
+/**
+ * Pricing data for a liquidity position pool
+ * @agent Contains current market price and execution estimates for position's token pair
+ */
+export interface PositionPoolPrice {
+    token0: string;
+    token1: string;
+    feeTier: number;
+    currentPrice: string;
+    executionPrice: string;
+    priceImpact: string;
+    estimatedOutput: string;
+    pricedAt: Date;
+}
+/**
+ * Result from fetching liquidity positions with optional pricing
+ * @agent Return type for paginated position queries with optional price enrichment
+ */
+export interface GetLiquidityPositionsResult {
+    items: GSwapPosition[];
+    nextBookmark?: string;
+    prices?: Map<string, PositionPoolPrice>;
+}
 //# sourceMappingURL=gswap.dto.d.ts.map