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

package/dist/types/content-flag.dto.d.ts

@@ -0,0 +1,337 @@
+/**
+ * Content Flag/Report Types
+ *
+ * Two-tier system: one-click flags for chat/comments, modal reports for streams.
+ *
+ * @module content-flag.dto
+ */
+import type { BasePaginationOptions, InternalApiResponse, ListResult, PageInfo, UserProfileInfo } from './common';
+/**
+ * Content types that can be flagged/reported
+ */
+export declare enum ContentType {
+    CHAT_MESSAGE = "CHAT_MESSAGE",
+    COMMENT = "COMMENT",
+    STREAM = "STREAM",
+    RECORDING = "RECORDING"
+}
+/**
+ * Reasons for flagging content
+ * Required for STREAM reports, optional for chat/comment flags
+ */
+export declare enum FlagReason {
+    INAPPROPRIATE_CONTENT = "INAPPROPRIATE_CONTENT",
+    SPAM = "SPAM",
+    HARASSMENT = "HARASSMENT",
+    SCAM = "SCAM",
+    OTHER = "OTHER"
+}
+/**
+ * Status of the flag/report
+ */
+export declare enum FlagStatus {
+    PENDING = "PENDING",
+    DISMISSED = "DISMISSED",
+    ACTIONED = "ACTIONED"
+}
+/**
+ * Actions that can be taken on flagged content
+ */
+export declare enum FlagAction {
+    DELETE_CONTENT = "DELETE_CONTENT",
+    BAN_USER = "BAN_USER",
+    DELETE_AND_BAN = "DELETE_AND_BAN"
+}
+/**
+ * Summarized AI moderation info included in flag responses.
+ *
+ * This is the abbreviated version returned inline with each flag.
+ * For full analysis details (processingTimeMs, framesAnalyzed, tier info),
+ * use `sdk.getAIModeration({ flagId })` from AIModerationService.
+ *
+ * @since 8.5.0
+ */
+export interface FlagAIModerationInfo {
+    /** Current analysis status */
+    status: 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED';
+    /** AI recommendation for moderation action */
+    recommendation: string | null;
+    /** Confidence score (0.0 - 1.0) */
+    confidence: number | null;
+    /** Human-readable summary of the analysis */
+    summary: string | null;
+    /** Per-category violation detection results */
+    categories: Array<{
+        category: string;
+        confidence: number;
+        detected: boolean;
+    }> | null;
+    /** Detailed reasoning behind the recommendation */
+    reasoning: string | null;
+    /** AI provider used (e.g., 'claude') */
+    provider: string | null;
+    /** When analysis completed (ISO string) */
+    completedAt: string | null;
+    /** Error message if analysis failed */
+    errorMessage: string | null;
+}
+/**
+ * Content flag data returned from API
+ */
+export interface FlagData {
+    id: number;
+    tokenName: string;
+    contentType: ContentType;
+    contentId: string;
+    contentSnapshot: string | null;
+    reporterAddress: string;
+    reportedUserAddress: string;
+    reason: FlagReason | null;
+    details: string | null;
+    status: FlagStatus;
+    reviewedBy: string | null;
+    reviewedAt: string | null;
+    actionTaken: FlagAction | null;
+    createdAt: string;
+    updatedAt: string;
+    reporter?: UserProfileInfo;
+    /**
+     * AI moderation results, if available.
+     * Present when AI moderation is enabled and the flag has been analyzed.
+     * @since 8.5.0
+     */
+    aiModeration?: FlagAIModerationInfo | null;
+}
+/**
+ * Options for creating a content flag/report
+ *
+ * - Chat/Comment: reason and details are optional (one-click flag)
+ * - Stream: reason is required (modal flow)
+ */
+export interface CreateFlagOptions {
+    /** Token name the content belongs to */
+    tokenName: string;
+    /** Type of content being flagged */
+    contentType: ContentType;
+    /** ID of the content (message ID, comment ID, or stream ID) */
+    contentId: string;
+    /** Address of the user who created the flagged content */
+    reportedUserAddress: string;
+    /** Reason for the flag (required for STREAM, optional for others) */
+    reason?: FlagReason;
+    /** Additional details about the flag (max 500 chars) */
+    details?: string;
+}
+/**
+ * Options for listing flags for a specific token
+ *
+ * @since 6.11.0 - Now extends BasePaginationOptions for DRY compliance
+ */
+export interface ListFlagsOptions extends BasePaginationOptions {
+    /** Token name to list flags for */
+    tokenName: string;
+    /** Filter by content type */
+    contentType?: ContentType;
+    /** Filter by status */
+    status?: FlagStatus;
+    /** Filter by reason */
+    reason?: FlagReason;
+    /** Filter by reporter address */
+    reporterAddress?: string;
+    /** Filter by reported user address */
+    reportedUserAddress?: string;
+}
+/**
+ * Options for listing flags globally (across all tokens)
+ * Used by overseers and admins for the CCTV dashboard
+ *
+ * @since 6.11.0 - Now extends BasePaginationOptions for DRY compliance
+ */
+export interface ListGlobalFlagsOptions extends BasePaginationOptions {
+    /** Filter by token name (optional - no token filter shows all) */
+    tokenName?: string;
+    /** Filter by content type */
+    contentType?: ContentType;
+    /** Filter by status */
+    status?: FlagStatus;
+    /** Filter by reason */
+    reason?: FlagReason;
+    /** Filter by reporter address */
+    reporterAddress?: string;
+    /** Filter by reported user address */
+    reportedUserAddress?: string;
+}
+/**
+ * Options for dismissing a flag
+ */
+export interface DismissFlagOptions {
+    /** Flag ID to dismiss */
+    flagId: number;
+}
+/**
+ * Options for taking action on a flag
+ */
+export interface ActionFlagOptions {
+    /** Flag ID to action */
+    flagId: number;
+    /** Action to take */
+    action: FlagAction;
+}
+/**
+ * Result from creating a flag
+ */
+export interface CreateFlagResult {
+    flag: FlagData;
+}
+/**
+ * Result from listing flags
+ *
+ * @since 6.6.0 - Refactored to use generic ListResult<T> pattern
+ *
+ * Note: For backward compatibility, use `result.items` (generic pattern) or
+ * cast to legacy interface with `flags` field if needed.
+ */
+export type FlagListResult = ListResult<FlagData>;
+/**
+ * Result from dismissing a flag
+ */
+export interface DismissFlagResult {
+    flag: FlagData;
+}
+/**
+ * Result from actioning a flag
+ */
+export interface ActionFlagResult {
+    flag: FlagData;
+}
+/**
+ * Internal response data for list flags endpoint
+ * @internal
+ */
+interface InternalListFlagsData {
+    flags: FlagData[];
+    pageInfo: PageInfo;
+}
+/**
+ * Internal response from list flags endpoint
+ * Uses domain-specific field name (flags) instead of generic (items)
+ * @internal
+ * @since 6.13.0 - Refactored to use InternalApiResponse<T> from common.ts
+ */
+export type InternalListFlagsResponse = InternalApiResponse<InternalListFlagsData>;
+/**
+ * Payload sent when content is flagged
+ */
+export interface ContentFlaggedPayload {
+    id: number;
+    tokenName: string;
+    contentType: ContentType;
+    contentId: string;
+    reason: FlagReason | null;
+    reporterAddress: string;
+    reportedUserAddress: string;
+    createdAt: string;
+}
+/**
+ * Payload sent when a flag is resolved
+ */
+export interface FlagResolvedPayload {
+    id: number;
+    tokenName: string;
+    contentType: ContentType;
+    contentId: string;
+    status: FlagStatus;
+    actionTaken: FlagAction | null;
+    reviewedBy: string;
+    reviewedAt: string;
+}
+/**
+ * Flag reason display labels
+ */
+export declare const FLAG_REASON_LABELS: Record<FlagReason, string>;
+/**
+ * Flag status display labels
+ */
+export declare const FLAG_STATUS_LABELS: Record<FlagStatus, string>;
+/**
+ * Flag action display labels
+ */
+export declare const FLAG_ACTION_LABELS: Record<FlagAction, string>;
+/**
+ * Content type display labels
+ */
+export declare const CONTENT_TYPE_LABELS: Record<ContentType, string>;
+/**
+ * Maximum length for flag details
+ */
+export declare const FLAG_DETAILS_MAX_LENGTH = 500;
+/** Check if a value is a valid ContentType */
+export declare const isContentType: (value: unknown) => value is ContentType;
+/** Check if a value is a valid FlagReason */
+export declare const isFlagReason: (value: unknown) => value is FlagReason;
+/** Check if a value is a valid FlagStatus */
+export declare const isFlagStatus: (value: unknown) => value is FlagStatus;
+/** Check if a value is a valid FlagAction */
+export declare const isFlagAction: (value: unknown) => value is FlagAction;
+/**
+ * Check if a value is valid FlagData
+ *
+ * @since 6.12.0 - Refactored to use factory pattern
+ */
+export declare const isFlagData: (obj: unknown) => obj is FlagData;
+/**
+ * Content flag validation constraints
+ *
+ * @deprecated Import individual constraints from './constraints' instead.
+ * This composite object is kept for backward compatibility.
+ */
+export declare const CONTENT_FLAG_CONSTRAINTS: {
+    readonly TOKEN_NAME: import("./constraints").TokenNameConstraint;
+    readonly CONTENT_ID: {
+        readonly MAX_LENGTH: 100;
+    };
+    readonly DETAILS: {
+        readonly MAX_LENGTH: 1000;
+    };
+    readonly PAGINATION: {
+        readonly DEFAULT_LIMIT: 20;
+        readonly MAX_LIMIT: number;
+    };
+};
+/**
+ * Validates CreateFlagOptions
+ *
+ * @param options - Options to validate
+ * @throws {ValidationError} If options are invalid
+ */
+export declare function validateCreateFlagOptions(options: CreateFlagOptions): void;
+/**
+ * Validates ListFlagsOptions
+ *
+ * @param options - Options to validate
+ * @throws {ValidationError} If options are invalid
+ */
+export declare function validateListFlagsOptions(options: ListFlagsOptions): void;
+/**
+ * Validates ListGlobalFlagsOptions
+ *
+ * @param options - Options to validate
+ * @throws {ValidationError} If options are invalid
+ */
+export declare function validateListGlobalFlagsOptions(options: ListGlobalFlagsOptions): void;
+/**
+ * Validates DismissFlagOptions
+ *
+ * @param options - Options to validate
+ * @throws {ValidationError} If options are invalid
+ */
+export declare function validateDismissFlagOptions(options: DismissFlagOptions): void;
+/**
+ * Validates ActionFlagOptions
+ *
+ * @param options - Options to validate
+ * @throws {ValidationError} If options are invalid
+ */
+export declare function validateActionFlagOptions(options: ActionFlagOptions): void;
+export {};
+//# sourceMappingURL=content-flag.dto.d.ts.map

package/dist/types/content-flag.dto.d.ts.map

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

package/dist/types/content-reactions.dto.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Content Reactions Types
+ *
+ * Types for content reactions (persistent reactions on chat messages and comments).
+ * Unlike stream reactions (ephemeral emoji bursts), content reactions are stored
+ * and displayed as counts/previews on messages.
+ *
+ * @category Types
+ * @since 5.12.0
+ */
+/**
+ * Allowed content reaction types
+ */
+export declare const CONTENT_REACTION_TYPES: readonly ["heart", "fire", "laugh", "wow", "thumbs_up"];
+/**
+ * Type for content reaction type values
+ */
+export type ContentReactionType = (typeof CONTENT_REACTION_TYPES)[number];
+/**
+ * Emoji mapping for reaction types (for display/reference)
+ */
+export declare const REACTION_EMOJI_MAP: Record<ContentReactionType, string>;
+import type { InternalApiResponse } from './common';
+/**
+ * Options for adding a content reaction
+ */
+export interface AddContentReactionOptions {
+    /** Token name (pool identifier) - optional, resolved from messageId on backend */
+    tokenName?: string;
+    /** Unique message identifier (msg-{timestamp}-{uuid} or legacy chat-{timestamp}-{uuid}) */
+    messageId: string;
+    /** Type of reaction to add */
+    reactionType: ContentReactionType;
+}
+/**
+ * Options for removing a content reaction
+ */
+export interface RemoveContentReactionOptions {
+    /** Token name (pool identifier) - optional, resolved from messageId on backend */
+    tokenName?: string;
+    /** Unique message identifier */
+    messageId: string;
+    /** Type of reaction to remove */
+    reactionType: ContentReactionType;
+}
+/**
+ * User info for reaction display
+ */
+export interface ReactionUserInfo {
+    /** User's wallet address */
+    userAddress: string;
+    /** User's display name */
+    fullName?: string;
+    /** User's profile image URL */
+    profileImage?: string;
+}
+/**
+ * Reaction counts by type
+ */
+export interface ReactionCountsResponse {
+    heart: number;
+    fire: number;
+    laugh: number;
+    wow: number;
+    thumbs_up: number;
+}
+/**
+ * Reactions grouped by type with user info
+ * Supports "Bob, Susy, and 3 others gave heart" display
+ */
+export interface ReactionsByType {
+    /** Reaction type */
+    reactionType: ContentReactionType;
+    /** Total count of this reaction type */
+    count: number;
+    /** First few users who gave this reaction (for preview display) */
+    users: ReactionUserInfo[];
+    /** Whether the current authenticated user gave this reaction */
+    userReacted: boolean;
+}
+/**
+ * Complete reaction data for a piece of content
+ */
+export interface ReactionData {
+    /** Reactions grouped by type, only includes types with count > 0 */
+    reactions: ReactionsByType[];
+    /** Total number of reactions across all types */
+    totalCount: number;
+}
+/**
+ * Result of adding a reaction
+ */
+export interface AddContentReactionResult {
+    /** Updated reaction data for the message */
+    data: ReactionData;
+    /** Whether the reaction was newly created (vs already existed) */
+    created: boolean;
+}
+/**
+ * Result of removing a reaction
+ */
+export interface RemoveContentReactionResult {
+    /** Removal success */
+    success: boolean;
+}
+/**
+ * Internal API response data for adding a reaction
+ * Backend returns ReactionData + explicit `created` flag
+ *
+ * @internal
+ * @since 5.11.0 - Backend now returns explicit created flag (no string parsing needed)
+ */
+export interface InternalAddReactionData extends ReactionData {
+    /**
+     * Whether the reaction was newly created (vs already existed)
+     * Backend explicitly sets this flag - eliminates brittle message parsing
+     */
+    created: boolean;
+}
+/**
+ * Internal API response for adding a reaction
+ * @internal
+ * @since 6.13.0 - Refactored to use InternalApiResponse<T> from common.ts
+ */
+export type InternalAddReactionResponse = InternalApiResponse<InternalAddReactionData>;
+/**
+ * Internal API response for removing a reaction
+ * @internal
+ * @since 6.13.0 - Refactored to use InternalApiResponse<T> from common.ts
+ */
+export type InternalRemoveReactionResponse = InternalApiResponse<null>;
+//# sourceMappingURL=content-reactions.dto.d.ts.map

package/dist/types/content-reactions.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-reactions.dto.d.ts","sourceRoot":"","sources":["../../src/types/content-reactions.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;GAEG;AACH,eAAO,MAAM,sBAAsB,yDAA0D,CAAC;AAE9F;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAMzD,CAAC;AAGX,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAOpD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,YAAY,EAAE,mBAAmB,CAAC;IAClC,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,gEAAgE;IAChE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,4CAA4C;IAC5C,IAAI,EAAE,YAAY,CAAC;IACnB,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,mBAAmB,CAAC,uBAAuB,CAAC,CAAC;AAEvF;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC"}

package/dist/types/dex-pool.dto.d.ts

@@ -0,0 +1,214 @@
+/**
+ * DEX Pool Discovery Types
+ *
+ * Types for querying and exploring GalaSwap DEX liquidity pools.
+ * Supports pagination, filtering, and sorting across all available pools.
+ *
+ * @packageDocumentation
+ */
+import type { ListResult } from './common';
+/**
+ * Complete DEX pool data structure (21 fields from backend + optional pricing)
+ *
+ * Represents a single liquidity pool on the GalaSwap DEX with full metrics.
+ * Pricing fields are optional and populated via quote-based enrichment when requested.
+ */
+export interface DexPoolData {
+    /** Pool identifier (e.g., "GALA|Unit|none|none/GUSDC|Unit|none|none/10000") */
+    poolPair: string;
+    /** Unique pool hash identifier */
+    poolHash: string;
+    /** First token symbol (e.g., "GALA") */
+    token0: string;
+    /** Second token symbol (e.g., "GUSDC") */
+    token1: string;
+    /** First token image URL */
+    token0Image: string;
+    /** Second token image URL */
+    token1Image: string;
+    /** Human-readable pool name (e.g., "GALA/GUSDC") */
+    poolName: string;
+    /** Fee tier as percentage string (e.g., "0.3", "1") */
+    fee: string;
+    /** 24-hour fees collected (USD) */
+    fee24h: number;
+    /** First token TVL (in token units) */
+    token0Tvl: number;
+    /** Second token TVL (in token units) */
+    token1Tvl: number;
+    /** First token TVL in USD */
+    token0TvlUsd: number;
+    /** Second token TVL in USD */
+    token1TvlUsd: number;
+    /** Total value locked in pool (USD) */
+    tvl: number;
+    /** 1-day trading volume (USD) */
+    volume1d: number;
+    /** 30-day trading volume (USD) */
+    volume30d: number;
+    /** Volume-to-TVL ratio (volume1d / tvl) */
+    dayPerTvl: number;
+    /** 1-day APR percentage (calculated from fees) */
+    apr1d: number;
+    /**
+     * First token price in USD (optional, quote-based enrichment)
+     *
+     * Derived from `getSwapQuoteExactInput(token0, 'GUSDC', '1')` when `withPrices: true`.
+     * Not populated by default - use withPrices option to enable.
+     *
+     * @optional
+     */
+    token0Price?: string;
+    /**
+     * Second token price in USD (optional, quote-based enrichment)
+     *
+     * Derived from `getSwapQuoteExactInput(token1, 'GUSDC', '1')` when `withPrices: true`.
+     * Not populated by default - use withPrices option to enable.
+     *
+     * @optional
+     */
+    token1Price?: string;
+}
+/**
+ * Backend-validated sort field options
+ *
+ * Only these three fields can be used for sorting. The backend validates
+ * and rejects any other sortBy values.
+ *
+ * @see {@link FetchDexPoolsOptions}
+ */
+export type DexPoolSortBy = 'tvl' | 'volume30d' | 'volume1d';
+/**
+ * Sort order direction
+ *
+ * Lowercase for user-facing SDK (converted to uppercase for backend API)
+ */
+export type DexPoolSortOrder = 'asc' | 'desc';
+/**
+ * Options for fetching DEX pools with pagination and filtering
+ *
+ * Uses page/limit pagination (1-indexed page numbers) for DEX backend.
+ * Note: This is different from Launchpad backend which uses cursor/pageSize.
+ *
+ * @example
+ * ```typescript
+ * // Fetch top 10 pools by volume
+ * const result = await sdk.fetchDexPools({
+ *   sortBy: 'volume1d',
+ *   sortOrder: 'desc',
+ *   limit: 10,
+ *   page: 1
+ * });
+ *
+ * // Search for GALA pools
+ * const galaPools = await sdk.fetchDexPools({
+ *   search: 'GALA',
+ *   limit: 20
+ * });
+ * ```
+ *
+ * @since 3.28.0 - DEX pools discovery with page/limit pagination
+ */
+export interface FetchDexPoolsOptions {
+    /**
+     * Number of results to return per page (default: 20, max: 20)
+     *
+     * @optional
+     */
+    limit?: number;
+    /**
+     * Page number (1-indexed, default: 1)
+     *
+     * @optional
+     */
+    page?: number;
+    /**
+     * Search filter for token symbols in pool pair
+     *
+     * Performs fuzzy search (case-insensitive) across token symbols
+     * and pool names. Example: "GALA", "GUSDC", "GALA/GUSDC"
+     *
+     * @optional
+     */
+    search?: string;
+    /**
+     * Field to sort results by
+     *
+     * Default: 'tvl' (total value locked)
+     * Backend-validated to only allow: 'tvl', 'volume30d', 'volume1d'
+     *
+     * @optional
+     */
+    sortBy?: DexPoolSortBy;
+    /**
+     * Sort order direction
+     *
+     * Default: 'desc' (highest to lowest)
+     *
+     * @optional
+     */
+    sortOrder?: DexPoolSortOrder;
+    /**
+     * Enrich pools with real-time token pricing via quote-based enrichment
+     *
+     * When enabled, each pool is enriched with `token0Price` and `token1Price` fields
+     * derived from `getSwapQuoteExactInput(token, 'GUSDC', '1')` to determine USD prices.
+     *
+     * Pricing is done in parallel with configurable concurrency (default: 5).
+     * Failed pricing requests degrade gracefully - pools without prices still include
+     * all other metrics (TVL, volume, APR).
+     *
+     * Default: false (no pricing enrichment)
+     *
+     * Performance overhead:
+     * - 20 pools: ~200-500ms additional
+     * - 100 pools: ~1-2 seconds additional
+     *
+     * @example
+     * ```typescript
+     * // Fetch pools with pricing
+     * const result = await sdk.fetchDexPools({
+     *   sortBy: 'tvl',
+     *   limit: 20,
+     *   withPrices: true  // Enable quote-based pricing enrichment
+     * });
+     *
+     * result.items.forEach(pool => {
+     *   const token0Price = pool.token0Price || 'N/A';
+     *   const token1Price = pool.token1Price || 'N/A';
+     *   console.log(`${pool.poolName}: ${token0Price} / ${token1Price}`);
+     * });
+     * ```
+     *
+     * @optional
+     */
+    withPrices?: boolean;
+}
+/**
+ * Clean result for paginated DEX pool queries
+ *
+ * Follows SDK standard pagination result structure with 7 metadata fields
+ * matching fetchPools(), fetchTrades(), fetchComments(), etc.
+ *
+ * @example
+ * ```typescript
+ * const result = await sdk.fetchDexPools({ limit: 20 });
+ *
+ * console.log(`Page ${result.page} of ${result.totalPages}`);
+ * console.log(`Total pools: ${result.total}`);
+ * console.log(`Pools in this page: ${result.items.length}`);
+ *
+ * result.items.forEach(pool => {
+ *   console.log(`${pool.poolName}: $${pool.tvl.toFixed(2)} TVL`);
+ * });
+ * ```
+ */
+/**
+ * DEX pool discovery result with page-based pagination
+ *
+ * @since 6.6.0 - Refactored to use generic ListResult<T> pattern
+ * @since 3.29.0 - Changed to page-based pagination (1-indexed pages)
+ */
+export type DexPoolsResult = ListResult<DexPoolData>;
+export type { CalculateDexPoolQuoteOptions, CompositePoolDataResult, DexPoolQuoteResult, FetchCompositePoolDataOptions, GetCompositePoolResponse, } from './composite-pool.dto';
+//# sourceMappingURL=dex-pool.dto.d.ts.map