@gala-chain/launchpad-sdk 5.0.4-beta.6 → 5.0.4-beta.60

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

@@ -0,0 +1,457 @@
+/**
+ * Trade API Data Transfer Objects and Types
+ *
+ * This module defines all types and interfaces for trade operations including
+ * trade creation and trade listing endpoints.
+ */
+import type { AddressFormat, BasePaginationOptions, ListResult } from './common';
+/**
+ * EIP-712 Types structure for typed data signing
+ */
+export type EIP712Types = Record<string, Array<{
+    name: string;
+    type: string;
+}>>;
+/**
+ * Domain structure for EIP-712
+ */
+export interface EIP712Domain {
+    name: string;
+    chainId: number;
+}
+/**
+ * Pre-mint vault address constant
+ */
+export declare const PRE_MINT_VAULT_ADDRESS = "service|testToken";
+/**
+ * Trade type constants
+ */
+export declare const TRADE_TYPE: {
+    readonly BUY: "buy";
+    readonly SELL: "sell";
+};
+/**
+ * Trade type enumeration - derived from TRADE_TYPE const
+ */
+export type TradeType = (typeof TRADE_TYPE)[keyof typeof TRADE_TYPE];
+/**
+ * Data required for creating a trade
+ */
+export interface CreateTradeData {
+    /** Trade type */
+    tradeType: TradeType;
+    /** Token amount as string (validated as number on backend) */
+    tokenAmount: string;
+    /** Vault address - either eth|0x[40] or service|[alphanumeric] */
+    vaultAddress: string;
+    /** User address in backend format eth|[40-hex-chars] */
+    userAddress: AddressFormat;
+    /** Optional slippage tolerance */
+    slippageTolerance?: string;
+    /** Optional deadline timestamp */
+    deadline?: number;
+}
+/**
+ * Response from trade creation endpoint
+ */
+export interface CreateTradeResponse {
+    /** Success status */
+    success: boolean;
+    /** Created trade information */
+    data?: TradeInfo;
+    /** Error message if creation failed */
+    message?: string;
+}
+/**
+ * Data required for buying tokens with native currency (GALA)
+ */
+export interface BuyTokensData {
+    /** Token symbol (e.g., 'WBB') */
+    tokenSymbol: string;
+    /** Amount of native currency (GALA) to spend */
+    nativeTokenQuantity: string;
+    /** Expected amount of tokens to receive */
+    expectedToken: string;
+    /** Maximum acceptable reverse bonding curve fee for slippage protection (optional, defaults to '0') */
+    maxAcceptableReverseBondingCurveFee?: string;
+}
+/**
+ * Data required for selling tokens for native currency (GALA)
+ */
+export interface SellTokensData {
+    /** Token symbol (e.g., 'WBB') */
+    tokenSymbol: string;
+    /** Amount of tokens to sell */
+    tokenQuantity: string;
+    /** Expected amount of native currency (GALA) to receive */
+    expectedNativeToken: string;
+    /** Maximum acceptable reverse bonding curve fee for slippage protection (optional, defaults to '0') */
+    maxAcceptableReverseBondingCurveFee?: string;
+}
+/**
+ * Signed DTO for buy token operations
+ */
+export interface BuyTokensSignedDto {
+    /** Service vault address for the token */
+    vaultAddress: string;
+    /** Amount of native currency (GALA) to spend */
+    nativeTokenQuantity: string;
+    /** Expected amount of tokens to receive */
+    expectedToken: string;
+    /** Extra fees for slippage protection */
+    extraFees: {
+        maxAcceptableReverseBondingCurveFee: string;
+    };
+    /** Unique operation key */
+    uniqueKey: string;
+    /** Ethereum message prefix */
+    prefix?: string;
+    /** Signature */
+    signature: string;
+    /** EIP-712 types structure */
+    types?: EIP712Types;
+    /** EIP-712 domain */
+    domain?: EIP712Domain;
+}
+/**
+ * Signed DTO for sell token operations
+ */
+export interface SellTokensSignedDto {
+    /** Service vault address for the token */
+    vaultAddress: string;
+    /** Amount of tokens to sell */
+    tokenQuantity: string;
+    /** Expected amount of native currency (GALA) to receive */
+    expectedNativeToken: string;
+    /** Extra fees for slippage protection */
+    extraFees: {
+        maxAcceptableReverseBondingCurveFee: string;
+    };
+    /** Unique operation key */
+    uniqueKey: string;
+    /** Ethereum message prefix */
+    prefix?: string;
+    /** Signature */
+    signature: string;
+    /** EIP-712 types structure */
+    types?: EIP712Types;
+    /** EIP-712 domain */
+    domain?: EIP712Domain;
+}
+/**
+ * Response from token trading operations
+ */
+export interface TokenTradeResponse {
+    /** HTTP status code */
+    status: number;
+    /** Success status */
+    success?: boolean;
+    /** Trade result data */
+    data: Record<string, unknown>;
+    /** Response message */
+    message: string;
+    /** Error message if trade failed */
+    error: string | null;
+}
+/**
+ * Options for fetching trades with filtering
+ */
+export interface GetTradeOptions extends BasePaginationOptions {
+    /** Optional token name filter */
+    tokenName?: string;
+}
+/**
+ * Pagination parameters for tokenName-based trade methods
+ */
+export interface TradeListParams extends BasePaginationOptions {
+}
+/**
+ * Backend format for get trade options (handles type conversion)
+ */
+export interface BackendGetTradeOptions {
+    /** Optional token name filter */
+    tokenName?: string;
+    /** Page number as string (backend quirk) */
+    page: string;
+    /** Limit as string (backend quirk) */
+    limit: string;
+}
+/**
+ * Trade information returned by the API
+ */
+export interface TradeInfo {
+    /** Trade ID */
+    id: string;
+    /** User address involved in the trade */
+    userAddress: AddressFormat;
+    /** Trade type */
+    tradeType: TradeType;
+    /** Token amount */
+    tokenAmount: string;
+    /** Vault address */
+    vaultAddress: string;
+    /** Trade timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Optional slippage tolerance */
+    slippageTolerance?: string;
+    /** Optional deadline */
+    deadline?: number;
+    /** Additional trade metadata */
+    [key: string]: unknown;
+}
+/**
+ * Internal response from get trades endpoint
+ */
+export interface InternalGetTradesResponse {
+    /** Array of trades - direct data or nested in response */
+    data: TradeInfo[] | {
+        /** Nested trades array */
+        trades: TradeInfo[];
+        /** Pagination metadata */
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasNextPage: boolean;
+        hasPrevPage: boolean;
+    };
+    /** Pagination metadata (when data is direct array) */
+    page?: number;
+    limit?: number;
+    total?: number;
+    totalPages?: number;
+    hasNextPage?: boolean;
+    hasPrevPage?: boolean;
+}
+/**
+ * Clean result for fetching trades with pagination
+ *
+ * @since 6.6.0 - Refactored to use generic ListResult<T> pattern
+ */
+export type TradesResult = ListResult<TradeInfo>;
+/**
+ * Type guard to check if an object is valid CreateTradeData
+ */
+export declare const isCreateTradeData: (obj: unknown) => obj is CreateTradeData;
+/**
+ * Type guard to check if an object is valid GetTradeOptions
+ */
+export declare const isGetTradeOptions: (obj: unknown) => obj is GetTradeOptions;
+/**
+ * Type guard to check if an object is valid TradeListParams
+ */
+export declare const isTradeListParams: (obj: unknown) => obj is TradeListParams;
+/**
+ * Type guard to check if a string is a valid TradeType
+ */
+export declare const isTradeType: (value: unknown) => value is "buy" | "sell";
+/**
+ * Validates vault address format (supports both eth and service formats)
+ */
+export declare function isValidVaultAddress(address: string): boolean;
+/**
+ * Validates user address format
+ * Now uses GSwap SDK validator for consistency
+ */
+export declare function isValidUserAddress(address: string): boolean;
+/**
+ * Validates amount string format (positive decimal)
+ * Now uses GSwap SDK validator for consistency
+ */
+export declare function isValidAmountString(amount: string): boolean;
+/**
+ * Type guard to check if an object is valid BuyTokensData
+ */
+export declare const isBuyTokensData: (obj: unknown) => obj is BuyTokensData;
+/**
+ * Type guard to check if an object is valid SellTokensData
+ */
+export declare const isSellTokensData: (obj: unknown) => obj is SellTokensData;
+/**
+ * Validates token symbol format
+ * Now uses GSwap SDK validator for consistency
+ */
+export declare function isValidTokenSymbol(symbol: string): boolean;
+/**
+ * Request data for fetching pool details
+ */
+export interface FetchPoolDetailsData {
+    /** Vault address in service format */
+    vaultAddress: string;
+}
+/**
+ * Token information structure
+ */
+export interface TokenInfo {
+    /** Additional key identifier */
+    additionalKey: string;
+    /** Token category */
+    category: string;
+    /** Token collection */
+    collection: string;
+    /** Token instance */
+    instance: string;
+    /** Token type */
+    type: string;
+}
+/**
+ * Reverse bonding curve configuration
+ */
+export interface ReverseBondingCurveConfiguration {
+    /** Maximum fee portion */
+    maxFeePortion: string;
+    /** Minimum fee portion */
+    minFeePortion: string;
+}
+/**
+ * Pool details data from GalaChain - contains complete bonding curve pool state
+ */
+export interface PoolDetailsData {
+    /** Base price for the token */
+    basePrice: string;
+    /** Euler constant */
+    euler: string;
+    /** Exponent factor for bonding curve */
+    exponentFactor: string;
+    /** Maximum token supply */
+    maxSupply: string;
+    /** Native token information (GALA) */
+    nativeToken: TokenInfo;
+    /** Current native token quantity in the vault */
+    nativeTokenQuantity: string;
+    /** Reverse bonding curve minimum fee portion (flattened, coalesced to "0" if null) */
+    reverseBondingCurveMinFeePortion: string;
+    /** Reverse bonding curve maximum fee portion (flattened, coalesced to "0" if null) */
+    reverseBondingCurveMaxFeePortion: string;
+    /** Reverse bonding curve configuration (nested, as returned by GalaChain FetchSaleDetails) */
+    reverseBondingCurveConfiguration?: ReverseBondingCurveConfiguration;
+    /** Boolean flag indicating if reverse bonding curve fees are non-zero */
+    hasReverseBondingCurveFee: boolean;
+    /** Sale owner address */
+    saleOwner: string;
+    /** Current sale status */
+    saleStatus: string;
+    /** Unix timestamp (seconds) when the sale is scheduled to start (0 or absent if already started) */
+    saleStartTime?: number;
+    /** Boolean flag indicating if the pool has graduated (saleStatus === 'Completed') */
+    isGraduated: boolean;
+    /** Selling token information */
+    sellingToken: TokenInfo;
+    /** Current selling token quantity */
+    sellingTokenQuantity: string;
+    /** Vault address */
+    vaultAddress: string;
+    /** Current supply (computed: maxSupply - sellingTokenQuantity, preserves full precision) */
+    currentSupply?: string;
+    /** Normalized max fee factor as number (0.5 = 50%) - used for sell operations only */
+    reverseBondingCurveMaxFeeFactor?: number;
+    /** Normalized min fee factor as number (0.5 = 50%) - used for sell operations only */
+    reverseBondingCurveMinFeeFactor?: number;
+    /** Normalized net fee factor as number (max - min) - convenience field for calculations */
+    reverseBondingCurveNetFeeFactor?: number;
+}
+/**
+ * Internal response from fetch pool details endpoint (GalaChain)
+ */
+export interface InternalFetchPoolDetailsResponse {
+    /** Status code (1 = success) */
+    Status: number;
+    /** Pool details data */
+    Data: PoolDetailsData;
+}
+/**
+ * Type guard to check if an object is valid FetchPoolDetailsData
+ */
+export declare const isFetchPoolDetailsData: (obj: unknown) => obj is FetchPoolDetailsData;
+/**
+ * Data required for calculating pre-mint token amounts
+ */
+export interface CalculatePreMintData {
+    /** Amount of native currency (GALA) to spend */
+    nativeTokenQuantity: string;
+}
+/**
+ * Response from CallMemeTokenOut endpoint
+ */
+export interface CalculatePreMintResponse {
+    /** Status code (1 = success) */
+    Status: number;
+    /** Calculation result data */
+    Data: {
+        /** Calculated quantity of tokens user will receive */
+        calculatedQuantity: string;
+        /** Extra fees breakdown */
+        extraFees: {
+            /** Reverse bonding curve fee */
+            reverseBondingCurve: string;
+            /** Transaction fees */
+            transactionFees: string;
+        };
+    };
+}
+/**
+ * Trade calculation type enumeration
+ */
+export type TradeCalculationType = 'NATIVE' | 'MEME';
+/**
+ * Trade calculation method enumeration
+ */
+export type TradeCalculationMethod = 'IN' | 'OUT';
+/**
+ * Options for calculating trade amounts
+ */
+export interface GetAmountOptions {
+    /** Type of calculation - determines input currency */
+    type: TradeCalculationType;
+    /** Method - IN or OUT from pool perspective */
+    method: TradeCalculationMethod;
+    /** Vault address for the token */
+    vaultAddress: string;
+    /** Amount to calculate with */
+    amount: string;
+}
+/**
+ * Response from get amount calculation endpoint
+ */
+export interface GetAmountResponse {
+    /** Success status */
+    success: boolean;
+    /** Calculation result data */
+    data?: {
+        /** Calculated amount */
+        amount: string;
+        /** Extra fees breakdown */
+        extraFees?: {
+            /** Reverse bonding curve fee */
+            reverseBondingCurve?: string;
+            /** Transaction fees */
+            transactionFees?: string;
+            /** Total fees */
+            totalFees?: string;
+        };
+        /** Price impact percentage */
+        priceImpact?: string;
+        /** Minimum amount received with slippage protection */
+        minimumReceived?: string;
+    };
+    /** Error message if calculation failed */
+    message?: string;
+}
+/**
+ * Enhanced extra fees interface (IExtraFeesDTO from frontend)
+ */
+export interface IExtraFeesDTO {
+    /** Maximum acceptable reverse bonding curve fee for slippage protection */
+    maxAcceptableReverseBondingCurveFee: string;
+}
+/**
+ * Type guard to check if an object is valid CalculatePreMintData
+ */
+export declare const isCalculatePreMintData: (obj: unknown) => obj is CalculatePreMintData;
+/**
+ * Type guard to check if an object is valid GetAmountOptions
+ */
+export declare function isGetAmountOptions(obj: unknown): obj is GetAmountOptions;
+//# sourceMappingURL=trade.dto.d.ts.map

package/dist/types/trade.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade.dto.d.ts","sourceRoot":"","sources":["../../src/types/trade.dto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAC,UAAU,EAAE,MAAM,UAAU,CAAC;AAKhF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAoDD;;GAEG;AACH,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAM1D;;GAEG;AACH,eAAO,MAAM,UAAU;;;CAGb,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,WAAW,EAAE,aAAa,CAAC;IAC3B,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,uGAAuG;IACvG,mCAAmC,CAAC,EAAE,MAAM,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uGAAuG;IACvG,mCAAmC,CAAC,EAAE,MAAM,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,SAAS,EAAE;QACT,mCAAmC,EAAE,MAAM,CAAC;KAC7C,CAAC;IACF,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,qBAAqB;IACrB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,SAAS,EAAE;QACT,mCAAmC,EAAE,MAAM,CAAC;KAC7C,CAAC;IACF,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,qBAAqB;IACrB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAMD;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,qBAAqB;IAC5D,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,qBAAqB;CAAG;AAEjE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,WAAW,EAAE,aAAa,CAAC;IAC3B,iBAAiB;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,0DAA0D;IAC1D,IAAI,EACA,SAAS,EAAE,GACX;QACE,0BAA0B;QAC1B,MAAM,EAAE,SAAS,EAAE,CAAC;QACpB,0BAA0B;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,OAAO,CAAC;QACrB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;IACN,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;AAMjD;;GAEG;AACH,eAAO,MAAM,iBAAiB,0CAO5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,0CAM5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,0CAK5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,6CAAkC,CAAC;AAE3D;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAS5D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D;AAMD;;GAEG;AACH,eAAO,MAAM,eAAe,wCAK1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,yCAK3B,CAAC;AAEH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,WAAW,EAAE,SAAS,CAAC;IACvB,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sFAAsF;IACtF,gCAAgC,EAAE,MAAM,CAAC;IACzC,sFAAsF;IACtF,gCAAgC,EAAE,MAAM,CAAC;IACzC,8FAA8F;IAC9F,gCAAgC,CAAC,EAAE,gCAAgC,CAAC;IACpE,yEAAyE;IACzE,yBAAyB,EAAE,OAAO,CAAC;IACnC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,WAAW,EAAE,OAAO,CAAC;IACrB,gCAAgC;IAChC,YAAY,EAAE,SAAS,CAAC;IACxB,qCAAqC;IACrC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,sFAAsF;IACtF,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,2FAA2F;IAC3F,+BAA+B,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,IAAI,EAAE,eAAe,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,+CAEjC,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,IAAI,EAAE;QACJ,sDAAsD;QACtD,kBAAkB,EAAE,MAAM,CAAC;QAC3B,2BAA2B;QAC3B,SAAS,EAAE;YACT,gCAAgC;YAChC,mBAAmB,EAAE,MAAM,CAAC;YAC5B,uBAAuB;YACvB,eAAe,EAAE,MAAM,CAAC;SACzB,CAAC;KACH,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,GAAG,KAAK,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,IAAI,EAAE,oBAAoB,CAAC;IAC3B,+CAA+C;IAC/C,MAAM,EAAE,sBAAsB,CAAC;IAC/B,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,IAAI,CAAC,EAAE;QACL,wBAAwB;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,2BAA2B;QAC3B,SAAS,CAAC,EAAE;YACV,gCAAgC;YAChC,mBAAmB,CAAC,EAAE,MAAM,CAAC;YAC7B,uBAAuB;YACvB,eAAe,CAAC,EAAE,MAAM,CAAC;YACzB,iBAAiB;YACjB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,8BAA8B;QAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,uDAAuD;QACvD,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,mCAAmC,EAAE,MAAM,CAAC;CAC7C;AAMD;;GAEG;AACH,eAAO,MAAM,sBAAsB,+CAEjC,CAAC;AAaH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,gBAAgB,CASxE"}

package/dist/types/trades-query.dto.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Trades Query Types (v6.2.0+)
+ *
+ * Types for the v1/trades endpoint with flexible query params.
+ * Supports filtering by tokenName, userAddress, or both.
+ *
+ * @category Types
+ * @since 6.2.0
+ */
+import type { BasePaginationOptions, ListResult, PageInfo } from './common';
+/**
+ * Options for querying trades via GET /v1/trades
+ *
+ * At least one of tokenName or userAddress must be provided.
+ *
+ * @example
+ * ```typescript
+ * // Query by token
+ * const result = await sdk.getTrades({ tokenName: 'anime' });
+ *
+ * // Query by user
+ * const result = await sdk.getTrades({ userAddress: 'eth|123...' });
+ *
+ * // Query by both with filters
+ * const result = await sdk.getTrades({
+ *   tokenName: 'anime',
+ *   userAddress: 'eth|123...',
+ *   txnType: 'BUY',
+ *   startDate: '2024-01-01',
+ *   endDate: '2024-12-31',
+ *   minAmount: 100,
+ *   maxAmount: 10000
+ * });
+ * ```
+ *
+ * @since 6.11.0 - Now extends BasePaginationOptions for DRY compliance
+ */
+export interface GetTradesOptions extends BasePaginationOptions {
+    /**
+     * Filter by token name (e.g., "anime")
+     */
+    tokenName?: string;
+    /**
+     * Filter by user wallet address (eth|... or 0x... format)
+     */
+    userAddress?: string;
+    /**
+     * Fuzzy search by token name (LIKE %search%).
+     * Ignored when tokenName is provided (exact match takes precedence).
+     * Must be alphanumeric, max 256 characters.
+     */
+    search?: string;
+    /**
+     * Filter by transaction type (BUY or SELL)
+     */
+    txnType?: 'BUY' | 'SELL';
+    /**
+     * Filter by date range start (ISO 8601 date string)
+     * Example: "2024-01-01" or "2024-01-01T00:00:00Z"
+     */
+    startDate?: string;
+    /**
+     * Filter by date range end (ISO 8601 date string)
+     * Example: "2024-12-31" or "2024-12-31T23:59:59Z"
+     */
+    endDate?: string;
+    /**
+     * Filter by minimum trade amount (applies to inputAmount for BUY, outputAmount for SELL)
+     */
+    minAmount?: number;
+    /**
+     * Filter by maximum trade amount (applies to inputAmount for BUY, outputAmount for SELL)
+     */
+    maxAmount?: number;
+}
+/**
+ * Trade item from the unified trades query
+ */
+export interface TradeQueryItem {
+    /** Transaction ID */
+    txnId: string;
+    /** Pool/token name */
+    tokenName: string;
+    /** Pool/token image URL */
+    tokenImage: string | null;
+    /** Trader's wallet address */
+    userAddress: string;
+    /** Trade type: BUY or SELL */
+    txnType: 'BUY' | 'SELL';
+    /** Input amount (GALA for buys, tokens for sells) */
+    inputAmount: number;
+    /** Output amount (tokens for buys, GALA for sells) */
+    outputAmount: number;
+    /** When trade occurred (ISO 8601) */
+    createdAt: string;
+}
+/**
+ * Paginated trades response using ListResult pattern
+ *
+ * @since 6.11.0 - Added for consistency with other list results (BanListResult, FlagListResult, etc.)
+ */
+export type TradesListResult = ListResult<TradeQueryItem>;
+/**
+ * Paginated trades response from GET /v1/trades
+ *
+ * @deprecated Use TradesListResult for consistent pattern with other SDK list methods.
+ * This interface uses domain-specific field names (trades, meta) while TradesListResult
+ * uses the standardized pattern (items, meta).
+ */
+export interface TradesQueryResult {
+    trades: TradeQueryItem[];
+    pageInfo: PageInfo;
+}
+/**
+ * Trades query validation constraints
+ *
+ * @deprecated Import individual constraints from './constraints' instead.
+ * This composite object is kept for backward compatibility.
+ */
+export declare const TRADES_QUERY_CONSTRAINTS: {
+    readonly PAGINATION: import("./constraints").QueryPaginationConstraint;
+    readonly TOKEN_NAME: {
+        readonly MIN_LENGTH: 1;
+        readonly MAX_LENGTH: 50;
+    };
+    readonly USER_ADDRESS: import("./constraints").AddressLengthConstraint;
+};
+/**
+ * Validates GetTradesOptions
+ * @throws ValidationError if options are invalid
+ */
+export declare function validateGetTradesOptions(options: GetTradesOptions): void;
+//# sourceMappingURL=trades-query.dto.d.ts.map

package/dist/types/trades-query.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trades-query.dto.d.ts","sourceRoot":"","sources":["../../src/types/trades-query.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,OAAO,KAAK,EAAE,qBAAqB,EAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAW3E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,gBAAiB,SAAQ,qBAAqB;IAC7D;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,OAAO,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAMD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;;CAI3B,CAAC;AAMX;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAwFxE"}