@gala-chain/launchpad-sdk 8.1.0 → 9.0.0-rc.1

package/dist/utils/errors.d.ts

@@ -121,12 +121,47 @@ export declare class ValidationError extends Error {
 export declare class TokenRestrictedError extends ValidationError {
     constructor(message: string);
 }
+/**
+ * What a server answered a failed request with, as a {@link NetworkError} carries it.
+ *
+ * The launchpad backend (NestJS, `GlobalExceptionFilter`) answers an error with
+ * `{ status, error: true, message }` (an `HttpException`: validation failures, `sendResult`
+ * refusals, guards) or `{ statusCode, message }` (its `CustomError`, an upload over 4 MB, an
+ * unhandled 500). `message` is the text the backend means the user to read.
+ *
+ * @since 9.0.0
+ */
+export interface NetworkErrorServerAnswer {
+    /**
+     * The body's `message`. An array of strings (NestJS class-validator messages) is joined with
+     * `,`, exactly as `String(array)` shows it.
+     */
+    serverMessage?: string | undefined;
+    /**
+     * The body's `error` when it is a string (NestJS's default `"Bad Request"`, another host's error
+     * name). The launchpad backend sends `error: true`, which is no text: then this is absent and
+     * the boolean is in {@link body}.
+     */
+    serverError?: string | undefined;
+    /** The body's `details`, when it has them (the launchpad backend sends none today). */
+    details?: unknown;
+    /** The whole body as received: parsed JSON, or the text of a non-JSON answer (a proxy's HTML). */
+    body?: unknown;
+}
+/** The {@link NetworkErrorServerAnswer} of a response body. */
+export declare function serverAnswerOfBody(body: unknown): NetworkErrorServerAnswer;
 /**
  * Error thrown when network operations fail
  *
  * This error is used for HTTP request failures, API communication errors,
- * and network connectivity issues. It captures the HTTP status code and
- * original error for debugging.
+ * and network connectivity issues. It captures the HTTP status code, the
+ * server's answer ({@link NetworkErrorServerAnswer}: `serverMessage`,
+ * `serverError`, `details`, `body`) and the original error for debugging.
+ *
+ * Wrapping keeps the answer: a NetworkError made from an axios error reads
+ * its response, and one made from another NetworkError (a service adding its
+ * context to the HTTP client's error) takes that error's answer.
+ * `handleNetworkError` (the `withErrorHandling` wrap) also takes its status.
  *
  * @example HTTP request failure
  * ```typescript
@@ -137,32 +172,40 @@ export declare class TokenRestrictedError extends ValidationError {
  * );
  * ```
  *
- * @example Catching network errors
+ * @example Showing the backend's own text
  * ```typescript
  * try {
- *   await api.fetchPools();
+ *   await sdk.updateProfile({ fullName: 'x' });
  * } catch (error) {
  *   if (error instanceof NetworkError) {
- *     if (error.statusCode === 404) {
- *       console.log('Resource not found');
- *     } else if (error.statusCode && error.statusCode >= 500) {
- *       console.log('Server error, retry later');
- *     }
+ *     toast(error.serverMessage ?? 'Something went wrong');
+ *     if (error.statusCode === 404) console.log('Resource not found');
  *   }
  * }
  * ```
  */
 export declare class NetworkError extends Error {
+    /** The HTTP status (404, 500, ...), when known. */
     statusCode?: number | undefined;
+    /** The error this one wraps (an axios error, or the NetworkError of the HTTP client). */
     originalError?: Error | undefined;
+    /** The body's `message` (see {@link NetworkErrorServerAnswer.serverMessage}). @since 9.0.0 */
+    readonly serverMessage?: string | undefined;
+    /** The body's `error` when it is a string. @since 9.0.0 */
+    readonly serverError?: string | undefined;
+    /** The body's `details`. @since 9.0.0 */
+    readonly details?: unknown;
+    /** The whole response body. @since 9.0.0 */
+    readonly body?: unknown;
     /**
      * Creates a new NetworkError
      *
      * @param message - Human-readable error message describing what failed
      * @param statusCode - Optional HTTP status code (404, 500, etc.)
      * @param originalError - Optional original error that caused this failure
+     * @param answer - The server's answer; default the one behind `originalError`
      */
-    constructor(message: string, statusCode?: number | undefined, originalError?: Error | undefined);
+    constructor(message: string, statusCode?: number, originalError?: Error, answer?: NetworkErrorServerAnswer);
 }
 /**
  * Error thrown when SDK configuration is invalid
@@ -242,312 +285,4 @@ export declare class TransactionError extends Error {
      */
     constructor(message: string, transactionId?: string | undefined, code?: string | undefined);
 }
-/**
- * Error thrown when GSwap SDK quote operations fail
- *
- * This error is thrown during quote generation (exact input or exact output).
- * It preserves the original GSwap SDK error for detailed diagnostics.
- *
- * @example Quote generation failure
- * ```typescript
- * throw new GSwapQuoteError(
- *   'Failed to get quote for GALA to GUSDC swap',
- *   originalGSwapError,
- *   'POOL_NOT_FOUND'
- * );
- * ```
- *
- * @example Catching quote errors
- * ```typescript
- * try {
- *   const quote = await sdk.dex.quoting.quoteExactInput('GALA', 'GUSDC', '100');
- * } catch (error) {
- *   if (error instanceof GSwapQuoteError) {
- *     console.log(`Quote failed: ${error.message}`);
- *     console.log(`GSwap error: ${error.code}`);
- *     // Implement user notification
- *   }
- * }
- * ```
- */
-export declare class GSwapQuoteError extends Error {
-    originalError: unknown;
-    code?: string | undefined;
-    /**
-     * Creates a new GSwapQuoteError
-     *
-     * @param message - Human-readable error message describing what failed
-     * @param originalError - The original error from GSwap SDK
-     * @param code - Optional error code from GSwap SDK for programmatic handling
-     */
-    constructor(message: string, originalError: unknown, code?: string | undefined);
-}
-/**
- * Error thrown when GSwap SDK swap execution fails
- *
- * This error is thrown during token swap execution (buy/sell operations).
- * It preserves the original GSwap SDK error and transaction details.
- *
- * @example Swap execution failure
- * ```typescript
- * throw new GSwapSwapError(
- *   'Token swap failed: insufficient balance',
- *   originalGSwapError,
- *   'txHash123',
- *   'INSUFFICIENT_BALANCE'
- * );
- * ```
- *
- * @example Catching swap errors
- * ```typescript
- * try {
- *   const submitted = await sdk.dex.swaps.swap(tokenIn, tokenOut, fee, swapAmount);
- *   const result = await submitted.confirm();
- * } catch (error) {
- *   if (error instanceof GSwapSwapError) {
- *     console.log(`Swap failed: ${error.message}`);
- *     if (error.transactionHash) {
- *       console.log(`TX: ${error.transactionHash}`);
- *     }
- *   }
- * }
- * ```
- */
-export declare class GSwapSwapError extends Error {
-    originalError: unknown;
-    transactionHash?: string | undefined;
-    code?: string | undefined;
-    /**
-     * Creates a new GSwapSwapError
-     *
-     * @param message - Human-readable error message describing what failed
-     * @param originalError - The original error from GSwap SDK
-     * @param transactionHash - Optional transaction hash for transaction tracking
-     * @param code - Optional error code from GSwap SDK for programmatic handling
-     */
-    constructor(message: string, originalError: unknown, transactionHash?: string | undefined, code?: string | undefined);
-}
-/**
- * Error thrown when GSwap SDK pool operations fail
- *
- * This error is thrown when pool-related queries fail, including:
- * - Pool information retrieval
- * - Available token swaps querying
- * - Pool data access errors
- *
- * @example Pool query failure
- * ```typescript
- * throw new GSwapPoolError(
- *   'Pool not found for GALA/GUSDC pair',
- *   originalGSwapError,
- *   'GALA',
- *   'GUSDC',
- *   'POOL_NOT_FOUND'
- * );
- * ```
- *
- * @example Catching pool errors
- * ```typescript
- * try {
- *   const poolInfo = await service.getPoolInfo('GALA', 'GUSDC');
- * } catch (error) {
- *   if (error instanceof GSwapPoolError) {
- *     console.log(`Pool error: ${error.message}`);
- *     if (error.code === 'POOL_NOT_FOUND') {
- *       console.log(`No pool for ${error.tokenA}/${error.tokenB}`);
- *     }
- *   }
- * }
- * ```
- */
-export declare class GSwapPoolError extends Error {
-    originalError: unknown;
-    tokenA?: string | undefined;
-    tokenB?: string | undefined;
-    code?: string | undefined;
-    /**
-     * Creates a new GSwapPoolError
-     *
-     * @param message - Human-readable error message describing what failed
-     * @param originalError - The original error from GSwap SDK
-     * @param tokenA - Optional token A symbol in the pool pair
-     * @param tokenB - Optional token B symbol in the pool pair
-     * @param code - Optional error code from GSwap SDK for programmatic handling
-     */
-    constructor(message: string, originalError: unknown, tokenA?: string | undefined, tokenB?: string | undefined, code?: string | undefined);
-}
-/**
- * Error thrown when GSwap SDK asset/balance operations fail
- *
- * This error is thrown when asset-related queries fail, including:
- * - User asset/balance retrieval
- * - Portfolio data access errors
- * - Asset validation failures
- *
- * @example Asset query failure
- * ```typescript
- * throw new GSwapAssetError(
- *   'Failed to fetch user assets',
- *   originalGSwapError,
- *   'userAddress123',
- *   'NETWORK_ERROR'
- * );
- * ```
- *
- * @example Catching asset errors
- * ```typescript
- * try {
- *   const assets = await service.getUserAssets(walletAddress);
- * } catch (error) {
- *   if (error instanceof GSwapAssetError) {
- *     console.log(`Asset query failed: ${error.message}`);
- *     console.log(`Wallet: ${error.walletAddress}`);
- *   }
- * }
- * ```
- */
-export declare class GSwapAssetError extends Error {
-    originalError: unknown;
-    walletAddress?: string | undefined;
-    code?: string | undefined;
-    /**
-     * Creates a new GSwapAssetError
-     *
-     * @param message - Human-readable error message describing what failed
-     * @param originalError - The original error from GSwap SDK
-     * @param walletAddress - Optional wallet address being queried
-     * @param code - Optional error code from GSwap SDK for programmatic handling
-     */
-    constructor(message: string, originalError: unknown, walletAddress?: string | undefined, code?: string | undefined);
-}
-/**
- * Error thrown when GSwap SDK liquidity position operations fail
- *
- * This error is thrown when position management operations fail, including:
- * - Position queries (getUserPositions, getPosition, getPositionById)
- * - Liquidity addition (addLiquidityByPrice, addLiquidityByTicks)
- * - Liquidity removal (removeLiquidity)
- * - Fee collection (collectPositionFees)
- * - Position estimation (estimateRemoveLiquidity)
- *
- * @example Position operation failure
- * ```typescript
- * throw new GSwapPositionError(
- *   'Failed to add liquidity to GALA/GUSDC pool',
- *   originalGSwapError,
- *   'INSUFFICIENT_BALANCE'
- * );
- * ```
- *
- * @example Catching position errors
- * ```typescript
- * try {
- *   const result = await service.addLiquidityByPrice({ token0: 'GALA', token1: 'GUSDC', ... });
- * } catch (error) {
- *   if (error instanceof GSwapPositionError) {
- *     console.log(`Position operation failed: ${error.message}`);
- *     console.log(`Error code: ${error.code}`);
- *     // Implement user notification or recovery logic
- *   }
- * }
- * ```
- */
-export declare class GSwapPositionError extends Error {
-    originalError: unknown;
-    code?: string | undefined;
-    /**
-     * Creates a new GSwapPositionError
-     *
-     * @param message - Human-readable error message describing what failed
-     * @param originalError - The original error from GSwap SDK
-     * @param code - Optional error code from GSwap SDK for programmatic handling
-     */
-    constructor(message: string, originalError: unknown, code?: string | undefined);
-}
-/**
- * Error thrown when DEX quote operations fail
- *
- * This error is thrown during DEX quote calculations (local and external),
- * composite pool data fetching, and related operations. It captures the
- * operation context for debugging and recovery.
- *
- * @example Quote calculation failure
- * ```typescript
- * throw new DexQuoteError(
- *   'Failed to calculate quote for GALA/BENE swap',
- *   {
- *     fromToken: 'GALA|Unit|none|none',
- *     toToken: 'Token|Unit|BENE|client:123',
- *     amount: '1000'
- *   }
- * );
- * ```
- *
- * @example Catching quote errors
- * ```typescript
- * try {
- *   const quote = await sdk.calculateDexPoolQuoteExactAmountLocal({
- *     compositePoolData: composite,
- *     fromToken: 'GALA|Unit|none|none',
- *     toToken: 'Token|Unit|BENE|client:123',
- *     amount: '1000'
- *   });
- * } catch (error) {
- *   if (error instanceof DexQuoteError) {
- *     console.log(`Quote failed: ${error.message}`);
- *     if (error.context) {
- *       console.log(`Tokens: ${error.context.fromToken} → ${error.context.toToken}`);
- *     }
- *   }
- * }
- * ```
- */
-export declare class DexQuoteError extends ValidationError {
-    context?: unknown | undefined;
-    /**
-     * Creates a new DexQuoteError
-     *
-     * @param message - Human-readable error message describing what failed
-     * @param context - Optional context object with operation details (tokens, amounts, etc.)
-     */
-    constructor(message: string, context?: unknown | undefined);
-}
-/**
- * Error thrown when a DEX pool is not found
- *
- * This error is thrown when attempting to access or fetch data for a DEX pool
- * that does not exist, typically during composite pool data retrieval or pool
- * discovery operations.
- *
- * @example Pool not found
- * ```typescript
- * throw new DexPoolNotFoundError(
- *   'Pool not found: GALA/BENE with fee 3000'
- * );
- * ```
- *
- * @example Catching pool not found errors
- * ```typescript
- * try {
- *   const composite = await sdk.dex.pools.getCompositePool(
- *     'GALA|Unit|none|none',
- *     'Token|Unit|BENE|client:123',
- *     3000
- *   );
- * } catch (error) {
- *   if (error instanceof DexPoolNotFoundError) {
- *     console.log('Pool does not exist. Create it first with liquidity.');
- *     // Implement pool creation or alternative routing
- *   }
- * }
- * ```
- */
-export declare class DexPoolNotFoundError extends ValidationError {
-    /**
-     * Creates a new DexPoolNotFoundError
-     *
-     * @param message - Human-readable error message describing which pool was not found
-     */
-    constructor(message: string);
-}
 //# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW;IACtB,2CAA2C;;IAE3C,+DAA+D;;IAE/D,qDAAqD;;IAErD,mDAAmD;;IAEnD,oCAAoC;;IAEpC,mCAAmC;;IAEnC,oCAAoC;;IAEpC,qCAAqC;;IAErC,0CAA0C;;IAE1C,mCAAmC;;IAEnC,2CAA2C;;IAE3C,uDAAuD;;IAEvD,+CAA+C;;IAE/C,0CAA0C;;IAE1C,0CAA0C;;IAE1C,gDAAgD;;IAEhD,+CAA+C;;CAEvC,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAU/B,KAAK,CAAC,EAAE,MAAM;IACd,IAAI,CAAC,EAAE,MAAM;IAVtB;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED,kFAAkF;AAClF,qBAAa,oBAAqB,SAAQ,eAAe;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kGAAkG;IAClG,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAMD,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,wBAAwB,CAkB1E;AA0BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,mDAAmD;IAC5C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,yFAAyF;IAClF,aAAa,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACzC,8FAA8F;IAC9F,SAAgB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnD,2DAA2D;IAC3D,SAAgB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,yCAAyC;IACzC,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClC,4CAA4C;IAC5C,SAAgB,IAAI,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;;;;OAOG;gBAED,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,KAAK,EACrB,MAAM,GAAE,wBAAwD;CAWnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IASlC,KAAK,CAAC,EAAE,MAAM;IARvB;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,MAAM,YAAA;CAKxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAUhC,aAAa,CAAC,EAAE,MAAM;IACtB,IAAI,CAAC,EAAE,MAAM;IAVtB;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACR,aAAa,CAAC,EAAE,MAAM,YAAA,EACtB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB"}

package/dist/utils/http.d.ts

@@ -1,23 +1,46 @@
+import type { LaunchpadSession } from '../auth/session';
 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.
+ * This client adds the `Sign` header to every request using wallet signatures generated by
+ * SignatureAuth when a wallet is configured and `signRequests` is on (the default). Clients for
+ * hosts other than the launchpad backend turn it off.
  *
  * In read-only mode (no wallet), the client skips authentication headers
  * and allows querying public data endpoints.
  */
+/** Options of an {@link HttpClient} beyond its base URL, timeout and headers. */
+export interface HttpClientOptions {
+    /** Add the wallet-signed `Sign` header to every request (the launchpad backend only). */
+    readonly signRequests: boolean;
+    /**
+     * The app's launchpad-backend session: the bearer of every request, the handler of a 401 (one
+     * retry with the token it returns) and, unless it says `credentials: 'omit'`, credentialed requests.
+     */
+    readonly session?: LaunchpadSession | undefined;
+}
 export declare class HttpClient {
     private readonly axios;
     private readonly auth;
+    private readonly signRequests;
+    private readonly session;
     private readonly debug;
     private readonly logger;
     private requestInterceptorId;
     private responseInterceptorId;
-    constructor(auth: SignatureAuth | undefined, config?: SDKConfig);
+    /**
+     * @param auth Signature auth: the request signer for the launchpad backend, and the wallet identity
+     *   (`getAddress`, `signTypedData`) other services read from this client
+     * @param config Base URL, timeout and headers
+     * @param options `signRequests: false` keeps the `Sign` header off every request. Only the launchpad
+     *   backend authenticates with it; the GalaChain gateway, dex-api, the swap backend and the bundler
+     *   ignore it, and signing each request costs a wallet signature (a prompt for browser wallets).
+     *   `session` (launchpad backend only) makes the app's session the source of every bearer.
+     */
+    constructor(auth: SignatureAuth | undefined, config?: SDKConfig, options?: HttpClientOptions);
     /**
      * Makes an authenticated HTTP request and returns body only (legacy default).
      *
@@ -35,6 +58,16 @@ export declare class HttpClient {
      * @returns Promise with data, headers (lowercase keys), and status
      */
     requestWithMeta<T = unknown>(config: RequestConfig): Promise<HttpResponseWithMeta<T>>;
+    /**
+     * The axios request of `config`, with `bearer` (the app session's token) as its Authorization.
+     * Built afresh for a retry, so the retry carries the same body, params and headers.
+     */
+    private toAxiosConfig;
+    /**
+     * Send `axiosConfig`; when it went out under the app session and was answered 401, hand the 401
+     * to the session and retry once with the token it returns (none: the 401 stands).
+     */
+    private sendWithSession;
     /**
      * Makes a GET request
      */

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

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

package/dist/utils/message-validators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-validators.d.ts","sourceRoot":"","sources":["../../src/utils/message-validators.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAqB3G"}
+{"version":3,"file":"message-validators.d.ts","sourceRoot":"","sources":["../../src/utils/message-validators.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgB3G"}

package/dist/utils/pagination-helpers.d.ts

@@ -7,6 +7,7 @@
  * @category Utilities
  * @since 6.5.0
  */
+import type { PageInfo } from '../types/common';
 /**
  * Pagination query parameters
  *
@@ -158,4 +159,20 @@ export declare function calculateTotalPages(total: number, limit: number): numbe
  * @since 6.5.0
  */
 export declare function hasMorePages(currentOffset: number, limit: number, total: number): boolean;
+/**
+ * The {@link PageInfo} of a launchpad-backend list answer's `data.pageInfo`
+ * (`{ hasNextPage, endCursor, hasPreviousPage, startCursor }`), keys kept as the backend names
+ * them. A missing or malformed `pageInfo` is a last page (`hasNextPage: false`); a field of the
+ * wrong type is left out rather than passed on.
+ *
+ * @since 9.0.0
+ */
+export declare function pageInfoOf(backendPageInfo: unknown): PageInfo;
+/**
+ * The cursor of the page after `pageInfo`, or `undefined` when there is none: no next page, no
+ * `endCursor`, or (a malformed answer) the cursor that was just used, which would repeat forever.
+ *
+ * @since 9.0.0
+ */
+export declare function nextCursorOf(pageInfo: PageInfo, usedCursor: string | undefined): string | undefined;
 //# sourceMappingURL=pagination-helpers.d.ts.map

package/dist/utils/pagination-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/pagination-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAA0C,GAChD,eAAe,CAUjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI,CASN;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,GAAE,MAAU,EACpB,QAAQ,GAAE,MAAkD,GAC3D,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAuBxE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAST"}
+{"version":3,"file":"pagination-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/pagination-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAA0C,GAChD,eAAe,CAUjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI,CASN;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,GAAE,MAAU,EACpB,QAAQ,GAAE,MAAkD,GAC3D,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAuBxE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAST;AAMD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,eAAe,EAAE,OAAO,GAAG,QAAQ,CAY7D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAInG"}

package/dist/utils/pagination-validation.d.ts

@@ -76,10 +76,10 @@ export declare function mergeSafePaginationOptions(base: Partial<BasePaginationO
  * ```typescript
  * const nextPageOptions = addCursorToPagination(
  *   { pageSize: 50 },
- *   pageInfo.nextCursor
+ *   pageInfo.endCursor ?? undefined
  * );
  * // Result: { pageSize: 50, cursor: 'abc123' } or { pageSize: 50 }
- * // depending on whether nextCursor is defined
+ * // depending on whether endCursor is set
  * ```
  *
  * @since 8.0.0

package/dist/utils/response-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-handlers.d.ts","sourceRoot":"","sources":["../../src/utils/response-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;GAEG;AACH,UAAU,eAAe,CAAC,CAAC,GAAG,OAAO;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED;;;GAGG;AACH,UAAU,OAAO,CAAC,CAAC,GAAG,OAAO;IAC3B,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EACzC,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,CAOxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,OAAO,EAC/C,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,EAC5B,mBAAmB,EAAE,MAAM,EAC3B,WAAW,GAAE,OAAe,GAC3B,IAAI,CAmBN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAC7C,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GACtC,CAAC,GAAG,SAAS,CAKf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAChD,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EACvC,YAAY,GAAE,MAAoC,GACjD,CAAC,CAYH"}
+{"version":3,"file":"response-handlers.d.ts","sourceRoot":"","sources":["../../src/utils/response-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH;;GAEG;AACH,UAAU,eAAe,CAAC,CAAC,GAAG,OAAO;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED;;;GAGG;AACH,UAAU,OAAO,CAAC,CAAC,GAAG,OAAO;IAC3B,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EACzC,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,CAOxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,OAAO,EAC/C,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,EAC5B,mBAAmB,EAAE,MAAM,EAC3B,WAAW,GAAE,OAAe,GAC3B,IAAI,CAsBN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAC7C,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GACtC,CAAC,GAAG,SAAS,CAKf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAChD,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EACvC,YAAY,GAAE,MAAoC,GACjD,CAAC,CAYH"}

package/dist/utils/service-validators.d.ts

@@ -115,22 +115,22 @@ export declare function validateOptionalNumber(value: unknown, field: string, mi
 /**
  * Validates token name with constraints (required field)
  *
- * Consolidates duplicate token name validation across multiple services.
- * Validates token name is 3-20 alphanumeric characters by default.
+ * Validates a token name against the rule of the route it is sent to (no default: the caller names
+ * the route's constraint, see `types/constraints`).
  *
  * @param value Value to validate
- * @param field Field name for error messages (default: 'tokenName')
- * @param constraint Token name constraint (default: LAUNCHPAD_TOKEN_NAME_CONSTRAINT)
+ * @param field Field name for error messages
+ * @param constraint The route's token name constraint
  * @throws {ValidationError} If token name is invalid
  *
  * @example
  * ```typescript
- * validateTokenNameWithConstraints(options.tokenName, 'tokenName');
+ * validateTokenNameWithConstraints(options.tokenName, 'tokenName', TOKEN_NAME_DTO_CONSTRAINT);
  * ```
  *
  * @since 6.18.0
  */
-export declare function validateTokenNameWithConstraints(value: unknown, field?: string, constraint?: TokenNameConstraint): asserts value is string;
+export declare function validateTokenNameWithConstraints(value: unknown, field: string, constraint: TokenNameConstraint): asserts value is string;
 /**
  * Validates a status filter value (optional)
  *

package/dist/utils/service-validators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-validators.d.ts","sourceRoot":"","sources":["../../src/utils/service-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAWhE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAO7F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAmB9F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAE9F;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACX,IAAI,CAeN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,OAAO,EACd,KAAK,GAAE,MAAoB,EAC3B,UAAU,GAAE,mBAAqD,GAChE,OAAO,CAAC,KAAK,IAAI,MAAM,CAgCzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,IAAI,CAmBN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,EAAE,CAW/F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAmB1F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,IAAI,MAAM,GAAG,SAAS,GAAG,IAAI,CAM5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,IAAI,MAAM,CAIzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,GAAG,MAAM,GAAG,MAAM,CAO3G;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,IAAI,MAAM,CAQzB"}
+{"version":3,"file":"service-validators.d.ts","sourceRoot":"","sources":["../../src/utils/service-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAUhE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAO7F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAmB9F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAE9F;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACX,IAAI,CAeN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAAC,KAAK,IAAI,MAAM,CAgCzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,IAAI,CAmBN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,EAAE,CAW/F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAmB1F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,IAAI,MAAM,GAAG,SAAS,GAAG,IAAI,CAM5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,IAAI,MAAM,CAIzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,GAAG,MAAM,GAAG,MAAM,CAO3G;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,IAAI,MAAM,CAQzB"}

package/dist/utils/token-format-converter.d.ts

@@ -3,7 +3,7 @@
  *
  * These convert FORMATS ONLY. A token class key carries no symbol and a symbol carries no class
  * key, so nothing here infers one from the other: a bare symbol is never expanded into a key.
- * For symbol/metadata use GalaChainService.fetchTokenClassFromChain() or DexService.fetchTokenDetails().
+ * For symbol/metadata use GalaChainService.fetchTokenClassFromChain() or GalaChainService.fetchTokenDetails().
  *
  * @packageDocumentation
  */