@gala-chain/gswap-sdk 2.1.0-beta.3 → 2.1.0-beta.5

package/dist/index.d.cts

@@ -1195,9 +1195,22 @@ export interface DexFeeQuote {
   }>;
   source: 'dry-run' | 'default';
 }
+/**
+ * The backend root a fee quote is built on: `base` without trailing slashes and without a trailing
+ * `/api/v1` (the wallet passes the versioned base, the SDK presets the host root). Idempotent.
+ *
+ * @example
+ * ```typescript
+ * dexBackendRoot('https://swap-backend.stage.defi.ovh.gala.com/api/v1/'); // 'https://swap-backend.stage.defi.ovh.gala.com'
+ * ```
+ */
+export declare function dexBackendRoot(base: string): string;
 /**
  * Reduces an EIP-712 approval `message` to the DTO the chain actually receives: drops the signing
- * envelope (`signature`, `prefix`, `types`, `domain`) and transport metadata (`trace`).
+ * envelope (`signature`, `prefix`, `types`, `domain`), the `dtoOperation` it was signed to call (a
+ * DryRun runs the DTO inside a wrapper signed for `DryRun`; left inside, the chain refuses it:
+ * "signed to call ...:RequestTrade, but the current operation is ...:DryRun") and transport
+ * metadata (`trace`).
  */
 export declare function toChainDto(message: Record<string, unknown>): Record<string, unknown>;
 /**
@@ -1205,12 +1218,18 @@ export declare function toChainDto(message: Record<string, unknown>): Record<str
  * `{ callerPublicKey, method, dto: <inner DTO object>, uniqueKey, signature }`. The inner DTO
  * travels unsigned and as an object; no `signerPublicKey` is sent because the signature already
  * recovers it (the gateway rejects it as REDUNDANT_SIGNER_PUBLIC_KEY). The wrapper carries its own
- * `uniqueKey`, distinct from the DTO's.
+ * `uniqueKey`, distinct from the DTO's, and its own `dtoOperation` (`<Contract>:DryRun`); the inner DTO
+ * carries none of the signing envelope or the `dtoOperation` of the call it simulates (see
+ * {@link toChainDto}), whatever the caller passes, so a signed DTO can be handed in as is.
  */
 export declare function buildDryRunWrapper(signer: GalaChainSigner, callerPublicKey: string, method: string, dto: Record<string, unknown>, uniqueKeyPrefix?: string, contractPath?: ChainContractPath): Promise<Record<string, unknown>>;
 /** The transport and backend a fee quote reads from. */
 export interface DexFeesClient {
-  /** Swap backend origin, e.g. `https://dex-backend-prod1.defi.gala.com`. */
+  /**
+   * Swap backend origin, e.g. `https://dex-backend-prod1.defi.gala.com`. A base that already ends in
+   * `/api/v1` (what the wallet passes) and trailing slashes are accepted: the request goes to the
+   * same URL either way (see {@link dexBackendRoot}).
+   */
   dexBackendBaseUrl: string;
   /** Defaults to the global `fetch`. */
   httpRequestor?: HttpRequestor | undefined;
@@ -1263,7 +1282,10 @@ export declare class DexFees {
    * malformed body): a transport outcome, not a fee. Deciding what to charge when the chain is
    * silent is the backend's job (it serves `source: 'default'`), so the client never substitutes
    * a fee of its own, with ONE exception that mirrors the wallet: a `dex-contract` quote answered
-   * 403 or 404 means the contract has no fee route yet and resolves `{ source: 'default', '0' }`.
+   * 403 means the contract has no fee route yet and resolves `{ source: 'default', '0' }`. A 404 is
+   * a wrong path, not "no fee route": it resolves `null`, never a default. The request always goes
+   * to `<root>/api/v1/wallet/connect/galachain/api/{channel}/{contract}/{method}/fee`, whether the
+   * client's base URL is the host root or already ends in `/api/v1`.
    * Never throws on transport, so a fee lookup cannot block or break a signing screen.
    *
    * @throws GSwapSDKError NO_SIGNER when constructed without a signer; `SIGNING_FAILED` or

package/dist/index.d.ts

@@ -1195,9 +1195,22 @@ export interface DexFeeQuote {
   }>;
   source: 'dry-run' | 'default';
 }
+/**
+ * The backend root a fee quote is built on: `base` without trailing slashes and without a trailing
+ * `/api/v1` (the wallet passes the versioned base, the SDK presets the host root). Idempotent.
+ *
+ * @example
+ * ```typescript
+ * dexBackendRoot('https://swap-backend.stage.defi.ovh.gala.com/api/v1/'); // 'https://swap-backend.stage.defi.ovh.gala.com'
+ * ```
+ */
+export declare function dexBackendRoot(base: string): string;
 /**
  * Reduces an EIP-712 approval `message` to the DTO the chain actually receives: drops the signing
- * envelope (`signature`, `prefix`, `types`, `domain`) and transport metadata (`trace`).
+ * envelope (`signature`, `prefix`, `types`, `domain`), the `dtoOperation` it was signed to call (a
+ * DryRun runs the DTO inside a wrapper signed for `DryRun`; left inside, the chain refuses it:
+ * "signed to call ...:RequestTrade, but the current operation is ...:DryRun") and transport
+ * metadata (`trace`).
  */
 export declare function toChainDto(message: Record<string, unknown>): Record<string, unknown>;
 /**
@@ -1205,12 +1218,18 @@ export declare function toChainDto(message: Record<string, unknown>): Record<str
  * `{ callerPublicKey, method, dto: <inner DTO object>, uniqueKey, signature }`. The inner DTO
  * travels unsigned and as an object; no `signerPublicKey` is sent because the signature already
  * recovers it (the gateway rejects it as REDUNDANT_SIGNER_PUBLIC_KEY). The wrapper carries its own
- * `uniqueKey`, distinct from the DTO's.
+ * `uniqueKey`, distinct from the DTO's, and its own `dtoOperation` (`<Contract>:DryRun`); the inner DTO
+ * carries none of the signing envelope or the `dtoOperation` of the call it simulates (see
+ * {@link toChainDto}), whatever the caller passes, so a signed DTO can be handed in as is.
  */
 export declare function buildDryRunWrapper(signer: GalaChainSigner, callerPublicKey: string, method: string, dto: Record<string, unknown>, uniqueKeyPrefix?: string, contractPath?: ChainContractPath): Promise<Record<string, unknown>>;
 /** The transport and backend a fee quote reads from. */
 export interface DexFeesClient {
-  /** Swap backend origin, e.g. `https://dex-backend-prod1.defi.gala.com`. */
+  /**
+   * Swap backend origin, e.g. `https://dex-backend-prod1.defi.gala.com`. A base that already ends in
+   * `/api/v1` (what the wallet passes) and trailing slashes are accepted: the request goes to the
+   * same URL either way (see {@link dexBackendRoot}).
+   */
   dexBackendBaseUrl: string;
   /** Defaults to the global `fetch`. */
   httpRequestor?: HttpRequestor | undefined;
@@ -1263,7 +1282,10 @@ export declare class DexFees {
    * malformed body): a transport outcome, not a fee. Deciding what to charge when the chain is
    * silent is the backend's job (it serves `source: 'default'`), so the client never substitutes
    * a fee of its own, with ONE exception that mirrors the wallet: a `dex-contract` quote answered
-   * 403 or 404 means the contract has no fee route yet and resolves `{ source: 'default', '0' }`.
+   * 403 means the contract has no fee route yet and resolves `{ source: 'default', '0' }`. A 404 is
+   * a wrong path, not "no fee route": it resolves `null`, never a default. The request always goes
+   * to `<root>/api/v1/wallet/connect/galachain/api/{channel}/{contract}/{method}/fee`, whether the
+   * client's base URL is the host root or already ends in `/api/v1`.
    * Never throws on transport, so a fee lookup cannot block or break a signing screen.
    *
    * @throws GSwapSDKError NO_SIGNER when constructed without a signer; `SIGNING_FAILED` or

package/dist/index.mjs

@@ -1700,9 +1700,26 @@ function isDexFeeMethod(method) {
 function isCurrentContractDexMessage(message, method) {
 	return isDexFeeMethod(method) && typeof (message === null || message === void 0 ? void 0 : message["token0"]) === "string" && typeof message["token1"] === "string";
 }
+/** The wallet-connect proxy's fee route, below the backend root (stage, 2026-11-02: only this prefix exists). */
+const FEE_ROUTE_PREFIX = "/api/v1/wallet/connect/galachain/api";
+/**
+* The backend root a fee quote is built on: `base` without trailing slashes and without a trailing
+* `/api/v1` (the wallet passes the versioned base, the SDK presets the host root). Idempotent.
+*
+* @example
+* ```typescript
+* dexBackendRoot('https://swap-backend.stage.defi.ovh.gala.com/api/v1/'); // 'https://swap-backend.stage.defi.ovh.gala.com'
+* ```
+*/
+function dexBackendRoot(base) {
+	return base.replace(/(?:\/+|\/api\/v1(?=\/|$))+$/u, "");
+}
 /**
 * Reduces an EIP-712 approval `message` to the DTO the chain actually receives: drops the signing
-* envelope (`signature`, `prefix`, `types`, `domain`) and transport metadata (`trace`).
+* envelope (`signature`, `prefix`, `types`, `domain`), the `dtoOperation` it was signed to call (a
+* DryRun runs the DTO inside a wrapper signed for `DryRun`; left inside, the chain refuses it:
+* "signed to call ...:RequestTrade, but the current operation is ...:DryRun") and transport
+* metadata (`trace`).
 */
 function toChainDto(message) {
 	const chainDto = { ...message };
@@ -1711,6 +1728,7 @@ function toChainDto(message) {
 		"prefix",
 		"types",
 		"domain",
+		"dtoOperation",
 		"trace"
 	]) delete chainDto[field];
 	return chainDto;
@@ -1720,13 +1738,15 @@ function toChainDto(message) {
 * `{ callerPublicKey, method, dto: <inner DTO object>, uniqueKey, signature }`. The inner DTO
 * travels unsigned and as an object; no `signerPublicKey` is sent because the signature already
 * recovers it (the gateway rejects it as REDUNDANT_SIGNER_PUBLIC_KEY). The wrapper carries its own
-* `uniqueKey`, distinct from the DTO's.
+* `uniqueKey`, distinct from the DTO's, and its own `dtoOperation` (`<Contract>:DryRun`); the inner DTO
+* carries none of the signing envelope or the `dtoOperation` of the call it simulates (see
+* {@link toChainDto}), whatever the caller passes, so a signed DTO can be handed in as is.
 */
 function buildDryRunWrapper(signer, callerPublicKey, method, dto, uniqueKeyPrefix = DRY_RUN_UNIQUE_KEY_PREFIX, contractPath = "asset/dexv3-contract") {
 	return signPreSend(signer, contractPath, DRY_RUN_METHOD, {
 		callerPublicKey,
 		method,
-		dto,
+		dto: toChainDto(dto),
 		uniqueKey: createUniqueKey(uniqueKeyPrefix)
 	});
 }
@@ -1755,7 +1775,7 @@ var DexFees = class {
 	constructor(client, signer) {
 		this.signer = signer;
 		this.requestor = client.httpRequestor ?? fetchRequestor;
-		this.baseUrl = client.dexBackendBaseUrl.replace(/\/$/u, "");
+		this.baseUrl = dexBackendRoot(client.dexBackendBaseUrl);
 		this.requestTimeoutMs = client.requestTimeoutMs ?? 3e4;
 		this.wire = client.wire;
 	}
@@ -1767,7 +1787,10 @@ var DexFees = class {
 	* malformed body): a transport outcome, not a fee. Deciding what to charge when the chain is
 	* silent is the backend's job (it serves `source: 'default'`), so the client never substitutes
 	* a fee of its own, with ONE exception that mirrors the wallet: a `dex-contract` quote answered
-	* 403 or 404 means the contract has no fee route yet and resolves `{ source: 'default', '0' }`.
+	* 403 means the contract has no fee route yet and resolves `{ source: 'default', '0' }`. A 404 is
+	* a wrong path, not "no fee route": it resolves `null`, never a default. The request always goes
+	* to `<root>/api/v1/wallet/connect/galachain/api/{channel}/{contract}/{method}/fee`, whether the
+	* client's base URL is the host root or already ends in `/api/v1`.
 	* Never throws on transport, so a fee lookup cannot block or break a signing screen.
 	*
 	* @throws GSwapSDKError NO_SIGNER when constructed without a signer; `SIGNING_FAILED` or
@@ -1779,7 +1802,7 @@ var DexFees = class {
 		const channel = options.channel ?? "asset";
 		const contract = options.contract ?? "dexv3-contract";
 		const wrapper = await buildDryRunWrapper(this.signer, callerPublicKey, method, toChainDto(message), void 0, `asset/${contract}`);
-		const url = `${this.baseUrl}/wallet/connect/galachain/api/${encodeURIComponent(channel)}/${encodeURIComponent(contract)}/${encodeURIComponent(method)}/fee`;
+		const url = `${this.baseUrl}${FEE_ROUTE_PREFIX}/${encodeURIComponent(channel)}/${encodeURIComponent(contract)}/${encodeURIComponent(method)}/fee`;
 		let status;
 		let ok;
 		let body;
@@ -1799,7 +1822,7 @@ var DexFees = class {
 			return null;
 		}
 		if (!ok) {
-			if (contract === "dex-contract" && (status === 403 || status === 404)) return {
+			if (contract === "dex-contract" && status === 403) return {
 				source: "default",
 				fees: [{ feeInGala: "0" }]
 			};
@@ -6668,5 +6691,5 @@ function classifySubmitEnvelope(envelope) {
 }
 
 //#endregion
-export { ALL_FEE_TIERS, AppliedTradeError, Assets, CanonicalSymbols, ChainGateway, DEX_FEE_METHODS, DRY_RUN_METHOD, DRY_RUN_UNIQUE_KEY_PREFIX, DexFees, FEE_TIER, GC_MAX_TICK, GC_MIN_TICK, GSWAP_ENVIRONMENTS, GSWAP_ERROR_CATALOG, GSWAP_ERROR_PHASE_BY_CODE, GSwap, GSwapSDKError, GdexStreamError, GdexStreamService, Leaderboard, MARKET_PRICE_BATCH_LIMIT, MARKET_PRICE_QUERY_BYTES, Market, NOT_QUEUED_FINAL, ONRAMPER_MODES, Onramper, PENDING_SWAPS_STORAGE_KEY, PENDING_SWAP_EXPIRY_MS, PENDING_SWAP_FATES, PENDING_SWAP_PRUNE_REASONS, PRICE_SERIES_TIMEFRAMES, PendingSwapStore, Pools, Positions, Quoting, SHADOW_FAILURE_KINDS, SHADOW_SUBMIT_CODES, SUBMISSION_OUTCOME_UNKNOWN_REASONS, SubmittedTransaction, Swaps, Symbols, TICK_SPACING_BY_FEE, UPDATE_REQUIRED_STATUS, alignTickDown, alignTickDownOrNaN, alignTickUp, alignTickUpOrNaN, assertCanonicalPair, assertCanonicalV2Dto, assertTickRange, buildAddLiquidityDto, buildCollectPositionFeesDto, buildCreatePoolDto, buildDryRunWrapper, buildRemoveLiquidityDto, buildRequestTradeDto, chainErrorKeyOf, classification, classifyFailure, classifyShadowSubmitError, classifyShadowSubmitStatus, classifySubmitEnvelope, confirmAppliedTrade, confirmationStateOf, createOnramper, frameSlot0, getObjectProperty, getStringProperty, gswapErrorTemplates, isConfirmationAborted, isConfirmationTimeout, isCurrentContractDexMessage, isDexFeeMethod, isGSwapError, isGdexLiquidityEvent, isNoMarket, isPreSendError, isProposableTradingSymbol, isRelayableRefusal, isShadowError, isSqrtPriceInRange, isSubmitExecuted, isSubmitQueued, isSubmitRejected, isTickInRange, isUninterpretedAnswer, isUniqueKeyConsumed, isUnprovenAcknowledgement, mayHaveBeenQueued, notSentClassification, orderSymbols, parseTokenClassKey, pendingSwapFateFor, pendingSwapFateOfOutcome, priceBatches, queryTokenOf, rawTokenOf, readOrderedSymbols, readShadowSubmitOutcome, requireUserRef, sqrtPriceToTick, storageAdapterFromChromeStorage, swapRouteFromQuote, tickFromPrice, tickToPrice, tickToSqrtPrice, toChainDto, tradingSymbolOf, userRef, validateFee, validateNumericAmount, validatePriceValues, validateTickRange, validateTickSpacing, validateTokenDecimals, webStorageAdapter };
+export { ALL_FEE_TIERS, AppliedTradeError, Assets, CanonicalSymbols, ChainGateway, DEX_FEE_METHODS, DRY_RUN_METHOD, DRY_RUN_UNIQUE_KEY_PREFIX, DexFees, FEE_TIER, GC_MAX_TICK, GC_MIN_TICK, GSWAP_ENVIRONMENTS, GSWAP_ERROR_CATALOG, GSWAP_ERROR_PHASE_BY_CODE, GSwap, GSwapSDKError, GdexStreamError, GdexStreamService, Leaderboard, MARKET_PRICE_BATCH_LIMIT, MARKET_PRICE_QUERY_BYTES, Market, NOT_QUEUED_FINAL, ONRAMPER_MODES, Onramper, PENDING_SWAPS_STORAGE_KEY, PENDING_SWAP_EXPIRY_MS, PENDING_SWAP_FATES, PENDING_SWAP_PRUNE_REASONS, PRICE_SERIES_TIMEFRAMES, PendingSwapStore, Pools, Positions, Quoting, SHADOW_FAILURE_KINDS, SHADOW_SUBMIT_CODES, SUBMISSION_OUTCOME_UNKNOWN_REASONS, SubmittedTransaction, Swaps, Symbols, TICK_SPACING_BY_FEE, UPDATE_REQUIRED_STATUS, alignTickDown, alignTickDownOrNaN, alignTickUp, alignTickUpOrNaN, assertCanonicalPair, assertCanonicalV2Dto, assertTickRange, buildAddLiquidityDto, buildCollectPositionFeesDto, buildCreatePoolDto, buildDryRunWrapper, buildRemoveLiquidityDto, buildRequestTradeDto, chainErrorKeyOf, classification, classifyFailure, classifyShadowSubmitError, classifyShadowSubmitStatus, classifySubmitEnvelope, confirmAppliedTrade, confirmationStateOf, createOnramper, dexBackendRoot, frameSlot0, getObjectProperty, getStringProperty, gswapErrorTemplates, isConfirmationAborted, isConfirmationTimeout, isCurrentContractDexMessage, isDexFeeMethod, isGSwapError, isGdexLiquidityEvent, isNoMarket, isPreSendError, isProposableTradingSymbol, isRelayableRefusal, isShadowError, isSqrtPriceInRange, isSubmitExecuted, isSubmitQueued, isSubmitRejected, isTickInRange, isUninterpretedAnswer, isUniqueKeyConsumed, isUnprovenAcknowledgement, mayHaveBeenQueued, notSentClassification, orderSymbols, parseTokenClassKey, pendingSwapFateFor, pendingSwapFateOfOutcome, priceBatches, queryTokenOf, rawTokenOf, readOrderedSymbols, readShadowSubmitOutcome, requireUserRef, sqrtPriceToTick, storageAdapterFromChromeStorage, swapRouteFromQuote, tickFromPrice, tickToPrice, tickToSqrtPrice, toChainDto, tradingSymbolOf, userRef, validateFee, validateNumericAmount, validatePriceValues, validateTickRange, validateTickSpacing, validateTokenDecimals, webStorageAdapter };
 //# sourceMappingURL=index.mjs.map