@symmio/trading-core 3.0.0 → 3.1.0

package/dist/gasless/get-gasless-fee-quote/get-gasless-fee-quote.js

@@ -0,0 +1,53 @@
+import { gaslessLayerAbi as e } from "../../symmio-contracts/abi/v0.8.6/gasless-layer.js";
+import { SymmError as t } from "../../shared/errors/symm-error.js";
+import { resolveGaslessService as n } from "../resolve-gasless.js";
+import { resolveGaslessFeeQuoteError as r } from "./fee-quote-errors.js";
+import { assertGaslessWalletId as i } from "../wallet-id.js";
+import { encodeRelayBatchCallData as a } from "./encode-relay-batch-call-data.js";
+//#region src/gasless/get-gasless-fee-quote/get-gasless-fee-quote.ts
+async function o(o, s) {
+	let { chainId: c, operations: l } = s;
+	if (l.length === 0) throw new t("validation", "GASLESS_EMPTY_BATCH", "Gasless: a fee quote needs at least one operation.");
+	let u = l.map((e, t) => i(e.walletId ?? 0n, `operations[${t}].walletId`)), d = n(o, { chainId: c }), f = o.getClient({ chainId: c }), p = a({
+		operations: l.map((e) => e.operation),
+		walletIds: u
+	}), m;
+	try {
+		m = await f.readContract({
+			address: d.gaslessLayerAddress,
+			abi: e,
+			functionName: "previewFeeQuote",
+			args: [p, 0n]
+		});
+	} catch (e) {
+		throw await r(e, {
+			client: f,
+			gaslessLayerAddress: d.gaslessLayerAddress
+		});
+	}
+	return {
+		collateralToken: m.collateralToken,
+		collateralDecimals: m.collateralDecimals,
+		blockNumber: m.blockNumber,
+		timestamp: m.timestamp,
+		exact: m.exact,
+		payments: m.payments.map((e) => ({
+			account: e.account,
+			payer: e.payer,
+			source: e.source,
+			operationalFee18: e.operationalFee18,
+			depositFee18: e.depositFee18,
+			walletCreationFee18: e.walletCreationFee18,
+			nativeTopUpFee18: e.nativeTopUpFee18,
+			nativeGasCollateral18: e.nativeGasCollateral18
+		})),
+		totalFee18: m.totalFee18,
+		totalDebit18: m.totalDebit18,
+		freeOpsApplied: m.freeOpsApplied,
+		nativeSponsored: m.nativeSponsored
+	};
+}
+//#endregion
+export { o as getGaslessFeeQuote };
+
+//# sourceMappingURL=get-gasless-fee-quote.js.map

package/dist/gasless/get-gasless-fee-quote/get-gasless-fee-quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gasless-fee-quote.js","names":[],"sources":["../../../src/gasless/get-gasless-fee-quote/get-gasless-fee-quote.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport type { SignedOperation } from \"../../solvers/instant-open/shared/types\";\nimport { gaslessLayerAbi } from \"../../symmio-contracts/abi/v0.8.6/gasless-layer\";\nimport { resolveGaslessService } from \"../resolve-gasless\";\nimport type { GaslessFeeQuote, GaslessFeeSource } from \"../types\";\nimport { assertGaslessWalletId } from \"../wallet-id\";\nimport { encodeRelayBatchCallData } from \"./encode-relay-batch-call-data\";\nimport { resolveGaslessFeeQuoteError } from \"./fee-quote-errors\";\n\n/** One operation of a batch to quote, with the GaslessWallet it runs against. */\nexport interface GaslessFeeQuoteOperation {\n  /**\n   * The exact operation about to be relayed — final calldata, signer account\n   * and replay header. No signature is needed: the quote never verifies one.\n   */\n  operation: SignedOperation;\n  /**\n   * The GaslessWallet id the operation is relayed with. Omit (or pass `0n`) for\n   * ordinary InstantLayer operations, delegation grants, and wallet-zero\n   * operations; pass the wallet's id for an operation that executes from a\n   * positive-id wallet. Range `0n` through `2^256 - 1`.\n   */\n  walletId?: bigint;\n}\n\n/**\n * Parameters for {@link getGaslessFeeQuote}.\n */\nexport type GetGaslessFeeQuoteParameters = Compute<\n  ChainIdParameter & {\n    /**\n     * The full batch, in relay order. Quote the whole batch rather than one\n     * operation at a time: free-quota slots and first-use wallet creation fees\n     * are allocated across the batch.\n     */\n    operations: readonly GaslessFeeQuoteOperation[];\n  }\n>;\n\n/** Return type of {@link getGaslessFeeQuote}. */\nexport type GetGaslessFeeQuoteReturnType = GaslessFeeQuote;\n\n/**\n * Quote what the GaslessLayer would charge to relay a batch — **before** asking\n * the user to sign anything.\n *\n * Encodes the batch as the `relayInstantBatch` call the relayer submits (with\n * placeholder signatures) and reads `previewFeeQuote(callData, 0)`. The quote\n * applies selector fees, payer multipliers, the daily free quota, and the\n * one-time creation fee of every undeployed GaslessWallet the batch executes\n * from — any wallet id, wallet `0` included — and prices a wallet operation by\n * its inner call selectors. Every amount is 18-decimal.\n *\n * It is a preview, not a guarantee: `exact` is always `false`, the charge and its\n * payer can change before execution, and the relayer's own simulation is\n * authoritative. The quote does not check that the payer can afford it.\n *\n * Requires a multi-wallet GaslessLayer; a deployment that predates it throws\n * `GASLESS_LAYER_INTERFACE_UNSUPPORTED`. When the quote reverts with empty data,\n * one more read (quoting empty calldata) tells such a deployment apart from a\n * batch the GaslessLayer cannot decode.\n *\n * @param config - The SDK config.\n * @param parameters - The batch to quote and an optional chain id.\n * @returns The fee quote.\n * @throws {SymmError} `GASLESS_EMPTY_BATCH` for an empty batch, or `GASLESS_WALLET_ID_INVALID`\n *   for a wallet id outside the `uint256` range — both before any RPC call.\n * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`.\n * @throws {SymmError} `GASLESS_FREE_QUOTA_EXHAUSTED` when a billing account's daily free\n *   quota is spent and the GaslessLayer refuses paid operations (see\n *   {@link isGaslessFreeQuotaExhaustedError}).\n * @throws {SymmError} `GASLESS_FEE_QUOTE_REVERTED` when the contract rejects the batch\n *   (e.g. a wallet operation whose target is not the wallet of its id) or cannot\n *   decode it (malformed wallet `execute` calldata, which reverts with empty data).\n * @throws {SymmError} `GASLESS_LAYER_INTERFACE_UNSUPPORTED` when the configured address\n *   has no `previewFeeQuote`.\n * @throws Viem transport errors, unchanged — and the original viem revert, unchanged,\n *   when an empty-data revert cannot be classified because the follow-up read failed.\n *\n * @example\n * ```ts\n * const quote = await getGaslessFeeQuote(config, {\n *   operations: [{ operation }, { operation: walletOperation, walletId: 2n }],\n * });\n * const fee = quote.totalFee18; // 18-decimal\n * ```\n */\nexport async function getGaslessFeeQuote(\n  config: Config,\n  parameters: GetGaslessFeeQuoteParameters,\n): Promise<GetGaslessFeeQuoteReturnType> {\n  const { chainId, operations } = parameters;\n\n  if (operations.length === 0) {\n    throw new SymmError(\"validation\", \"GASLESS_EMPTY_BATCH\", \"Gasless: a fee quote needs at least one operation.\");\n  }\n  const walletIds = operations.map((entry, index) =>\n    assertGaslessWalletId(entry.walletId ?? 0n, `operations[${index}].walletId`),\n  );\n\n  const gasless = resolveGaslessService(config, { chainId });\n  const client = config.getClient({ chainId });\n\n  const callData = encodeRelayBatchCallData({ operations: operations.map((entry) => entry.operation), walletIds });\n\n  let quote;\n  try {\n    quote = await client.readContract({\n      address: gasless.gaslessLayerAddress,\n      abi: gaslessLayerAbi,\n      functionName: \"previewFeeQuote\",\n      args: [callData, 0n],\n    });\n  } catch (err) {\n    throw await resolveGaslessFeeQuoteError(err, { client, gaslessLayerAddress: gasless.gaslessLayerAddress });\n  }\n\n  return {\n    collateralToken: quote.collateralToken,\n    collateralDecimals: quote.collateralDecimals,\n    blockNumber: quote.blockNumber,\n    timestamp: quote.timestamp,\n    exact: quote.exact,\n    payments: quote.payments.map((payment) => ({\n      account: payment.account,\n      payer: payment.payer,\n      /** The contract writes `uint8(FeeSource.X)`, so the value is always a member. */\n      source: payment.source as GaslessFeeSource,\n      operationalFee18: payment.operationalFee18,\n      depositFee18: payment.depositFee18,\n      walletCreationFee18: payment.walletCreationFee18,\n      nativeTopUpFee18: payment.nativeTopUpFee18,\n      nativeGasCollateral18: payment.nativeGasCollateral18,\n    })),\n    totalFee18: quote.totalFee18,\n    totalDebit18: quote.totalDebit18,\n    freeOpsApplied: quote.freeOpsApplied,\n    nativeSponsored: quote.nativeSponsored,\n  };\n}\n"],"mappings":";;;;;;;AAyFA,eAAsB,EACpB,GACA,GACuC;CACvC,IAAM,EAAE,YAAS,kBAAe;CAEhC,IAAI,EAAW,WAAW,GACxB,MAAM,IAAI,EAAU,cAAc,uBAAuB,oDAAoD;CAE/G,IAAM,IAAY,EAAW,KAAK,GAAO,MACvC,EAAsB,EAAM,YAAY,IAAI,cAAc,EAAM,WAAW,CAC7E,GAEM,IAAU,EAAsB,GAAQ,EAAE,WAAQ,CAAC,GACnD,IAAS,EAAO,UAAU,EAAE,WAAQ,CAAC,GAErC,IAAW,EAAyB;EAAE,YAAY,EAAW,KAAK,MAAU,EAAM,SAAS;EAAG;CAAU,CAAC,GAE3G;CACJ,IAAI;EACF,IAAQ,MAAM,EAAO,aAAa;GAChC,SAAS,EAAQ;GACjB,KAAK;GACL,cAAc;GACd,MAAM,CAAC,GAAU,EAAE;EACrB,CAAC;CACH,SAAS,GAAK;EACZ,MAAM,MAAM,EAA4B,GAAK;GAAE;GAAQ,qBAAqB,EAAQ;EAAoB,CAAC;CAC3G;CAEA,OAAO;EACL,iBAAiB,EAAM;EACvB,oBAAoB,EAAM;EAC1B,aAAa,EAAM;EACnB,WAAW,EAAM;EACjB,OAAO,EAAM;EACb,UAAU,EAAM,SAAS,KAAK,OAAa;GACzC,SAAS,EAAQ;GACjB,OAAO,EAAQ;GAEf,QAAQ,EAAQ;GAChB,kBAAkB,EAAQ;GAC1B,cAAc,EAAQ;GACtB,qBAAqB,EAAQ;GAC7B,kBAAkB,EAAQ;GAC1B,uBAAuB,EAAQ;EACjC,EAAE;EACF,YAAY,EAAM;EAClB,cAAc,EAAM;EACpB,gBAAgB,EAAM;EACtB,iBAAiB,EAAM;CACzB;AACF"}

package/dist/gasless/get-gasless-fee-quote/index.d.ts

@@ -0,0 +1,4 @@
+export * from './fee-quote-errors.js';
+export * from './get-gasless-fee-quote.js';
+export * from './query.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/gasless/get-gasless-fee-quote/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-fee-quote/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC"}

package/dist/gasless/get-gasless-fee-quote/query.d.ts

@@ -0,0 +1,41 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter, ExactPartial } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetGaslessFeeQuoteParameters, GetGaslessFeeQuoteReturnType } from './get-gasless-fee-quote.js';
+/** Data resolved by the {@link getGaslessFeeQuoteQueryOptions} query. */
+export type GetGaslessFeeQuoteData = GetGaslessFeeQuoteReturnType;
+/**
+ * Build the TanStack Query key for {@link getGaslessFeeQuoteQueryOptions}.
+ *
+ * An omitted `walletId` keys as `0n`, so `{ operation }` and
+ * `{ operation, walletId: 0n }` share one cache entry — they quote the same call.
+ *
+ * @param options - Partial query parameters.
+ * @returns A stable, hashable query key.
+ */
+export declare function getGaslessFeeQuoteQueryKey(options?: Compute<ExactPartial<GetGaslessFeeQuoteParameters> & ConfigKeyParameter>): readonly ["getGaslessFeeQuote", Record<string, unknown>];
+/** Query-key type produced by {@link getGaslessFeeQuoteQueryKey}. */
+export type GetGaslessFeeQuoteQueryKey = ReturnType<typeof getGaslessFeeQuoteQueryKey>;
+/**
+ * Options accepted by {@link getGaslessFeeQuoteQueryOptions}.
+ */
+export type GetGaslessFeeQuoteOptions = Compute<GetGaslessFeeQuoteParameters & QueryParameter<GetGaslessFeeQuoteData, Error, GetGaslessFeeQuoteData, GetGaslessFeeQuoteQueryKey>>;
+/** TanStack Query options returned by {@link getGaslessFeeQuoteQueryOptions}. */
+export type GetGaslessFeeQuoteQueryOptions = SymmioQueryOptions<GetGaslessFeeQuoteData, Error, GetGaslessFeeQuoteData, GetGaslessFeeQuoteQueryKey>;
+/**
+ * Build TanStack Query options for {@link getGaslessFeeQuote}.
+ *
+ * The key covers every operation field and wallet id, so a changed nonce,
+ * calldata or wallet re-quotes instead of reusing a stale quote.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getGaslessFeeQuoteQueryOptions(config, { operations: [{ operation }] }));
+ * ```
+ */
+export declare function getGaslessFeeQuoteQueryOptions(config: Config, options: GetGaslessFeeQuoteOptions): GetGaslessFeeQuoteQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/gasless/get-gasless-fee-quote/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-fee-quote/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EAClC,MAAM,yBAAyB,CAAC;AAEjC,yEAAyE;AACzE,MAAM,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAElE;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,OAAO,CAAC,YAAY,CAAC,4BAA4B,CAAC,GAAG,kBAAkB,CAAM,4DAIvF;AAED,qEAAqE;AACrE,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAC7C,4BAA4B,GAC1B,cAAc,CAAC,sBAAsB,EAAE,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,CAAC,CACpG,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,8BAA8B,GAAG,kBAAkB,CAC7D,sBAAsB,EACtB,KAAK,EACL,sBAAsB,EACtB,0BAA0B,CAC3B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,yBAAyB,GACjC,8BAA8B,CAUhC"}

package/dist/gasless/get-gasless-fee-quote/query.js

@@ -0,0 +1,31 @@
+import { getGaslessFeeQuote as e } from "./get-gasless-fee-quote.js";
+import { filterQueryOptions as t } from "../../shared/utils/query.js";
+//#region src/gasless/get-gasless-fee-quote/query.ts
+function n(e = {}) {
+	let n = e.operations?.map((e) => ({
+		...e,
+		walletId: e.walletId ?? 0n
+	}));
+	return ["getGaslessFeeQuote", t({
+		...e,
+		operations: n
+	})];
+}
+function r(t, r) {
+	return {
+		...r.query,
+		queryKey: n({
+			...r,
+			configKey: t.getChainConfigKey(r.chainId)
+		}),
+		enabled: r.query?.enabled ?? !0,
+		queryFn: () => e(t, {
+			chainId: r.chainId,
+			operations: r.operations
+		})
+	};
+}
+//#endregion
+export { n as getGaslessFeeQuoteQueryKey, r as getGaslessFeeQuoteQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/gasless/get-gasless-fee-quote/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/gasless/get-gasless-fee-quote/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter, ExactPartial } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport {\n  getGaslessFeeQuote,\n  type GetGaslessFeeQuoteParameters,\n  type GetGaslessFeeQuoteReturnType,\n} from \"./get-gasless-fee-quote\";\n\n/** Data resolved by the {@link getGaslessFeeQuoteQueryOptions} query. */\nexport type GetGaslessFeeQuoteData = GetGaslessFeeQuoteReturnType;\n\n/**\n * Build the TanStack Query key for {@link getGaslessFeeQuoteQueryOptions}.\n *\n * An omitted `walletId` keys as `0n`, so `{ operation }` and\n * `{ operation, walletId: 0n }` share one cache entry — they quote the same call.\n *\n * @param options - Partial query parameters.\n * @returns A stable, hashable query key.\n */\nexport function getGaslessFeeQuoteQueryKey(\n  options: Compute<ExactPartial<GetGaslessFeeQuoteParameters> & ConfigKeyParameter> = {},\n) {\n  const operations = options.operations?.map((entry) => ({ ...entry, walletId: entry.walletId ?? 0n }));\n  return [\"getGaslessFeeQuote\", filterQueryOptions({ ...options, operations })] as const;\n}\n\n/** Query-key type produced by {@link getGaslessFeeQuoteQueryKey}. */\nexport type GetGaslessFeeQuoteQueryKey = ReturnType<typeof getGaslessFeeQuoteQueryKey>;\n\n/**\n * Options accepted by {@link getGaslessFeeQuoteQueryOptions}.\n */\nexport type GetGaslessFeeQuoteOptions = Compute<\n  GetGaslessFeeQuoteParameters &\n    QueryParameter<GetGaslessFeeQuoteData, Error, GetGaslessFeeQuoteData, GetGaslessFeeQuoteQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getGaslessFeeQuoteQueryOptions}. */\nexport type GetGaslessFeeQuoteQueryOptions = SymmioQueryOptions<\n  GetGaslessFeeQuoteData,\n  Error,\n  GetGaslessFeeQuoteData,\n  GetGaslessFeeQuoteQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getGaslessFeeQuote}.\n *\n * The key covers every operation field and wallet id, so a changed nonce,\n * calldata or wallet re-quotes instead of reusing a stale quote.\n *\n * @param config - The SDK config.\n * @param options - Query parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(getGaslessFeeQuoteQueryOptions(config, { operations: [{ operation }] }));\n * ```\n */\nexport function getGaslessFeeQuoteQueryOptions(\n  config: Config,\n  options: GetGaslessFeeQuoteOptions,\n): GetGaslessFeeQuoteQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getGaslessFeeQuoteQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () => getGaslessFeeQuote(config, { chainId: options.chainId, operations: options.operations }),\n  };\n}\n"],"mappings":";;;AAsBA,SAAgB,EACd,IAAoF,CAAC,GACrF;CACA,IAAM,IAAa,EAAQ,YAAY,KAAK,OAAW;EAAE,GAAG;EAAO,UAAU,EAAM,YAAY;CAAG,EAAE;CACpG,OAAO,CAAC,sBAAsB,EAAmB;EAAE,GAAG;EAAS;CAAW,CAAC,CAAC;AAC9E;AAoCA,SAAgB,EACd,GACA,GACgC;CAChC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA2B;GACnC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EACnC,eAAe,EAAmB,GAAQ;GAAE,SAAS,EAAQ;GAAS,YAAY,EAAQ;EAAW,CAAC;CACxG;AACF"}

package/dist/gasless/get-gasless-request/get-gasless-request.d.ts

@@ -0,0 +1,51 @@
+import { Config } from '../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+import { GaslessRequest, GaslessService } from '../types.js';
+/**
+ * Parameters for {@link getGaslessRequest}.
+ */
+export type GetGaslessRequestParameters = Compute<ChainIdParameter & {
+    /** Stable service tracking id returned by a gasless submit. */
+    requestId: string;
+    /**
+     * Which sub-service stores the request. Operation relays live on
+     * `"operations"` (the default); deposit settlements on `"deposits"`. The
+     * two services are separate databases — a request id polled against the
+     * wrong one is `NOT_FOUND`.
+     */
+    service?: GaslessService;
+    /**
+     * Cancel the read in flight. In React the query factory passes TanStack's
+     * own signal, so an unmounted poll stops spending the deployment's shared
+     * request budget instead of finishing into a discarded result.
+     */
+    signal?: AbortSignal;
+}>;
+/** Return type of {@link getGaslessRequest}. */
+export type GetGaslessRequestReturnType = GaslessRequest;
+/**
+ * Fetch one stored GaslessQ relayer request.
+ *
+ * Fire-and-forget model: a submit returns `202` immediately and this record is
+ * the only source of truth afterwards. Poll it until
+ * `isGaslessRequestTerminal(status)` — via the query factory's
+ * `query.refetchInterval` in React, or {@link waitForGaslessRequest} in plain
+ * code. `submitted` is **not** success; only `succeeded` is.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Request id, optional service and chain id.
+ * @returns The normalized request record.
+ * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`
+ *   when the chain has no usable gasless service.
+ * @throws {SymmApiError} `GASLESS_STATUS_FETCH_FAILED` on HTTP failure —
+ *   including `404` while the record is not yet readable right after a `202`
+ *   (the accept-vs-record race; retry briefly before treating it as unknown).
+ *
+ * @example
+ * ```ts
+ * const request = await getGaslessRequest(config, { requestId });
+ * if (request.status === GaslessRequestStatus.SUBMITTED) watchTx(request.txHash);
+ * ```
+ */
+export declare function getGaslessRequest(config: Config, parameters: GetGaslessRequestParameters): Promise<GetGaslessRequestReturnType>;
+//# sourceMappingURL=get-gasless-request.d.ts.map

package/dist/gasless/get-gasless-request/get-gasless-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gasless-request.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-request/get-gasless-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAG/E,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/D;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAC/C,gBAAgB,GAAG;IACjB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CACF,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,2BAA2B,GAAG,cAAc,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,2BAA2B,GACtC,OAAO,CAAC,2BAA2B,CAAC,CActC"}

package/dist/gasless/get-gasless-request/get-gasless-request.js

@@ -0,0 +1,15 @@
+import { gaslessGet as e, resolveGaslessHttp as t } from "../http.js";
+import { acquireGaslessStatusRead as n } from "../status-read-limiter.js";
+import { toGaslessRequest as r } from "./to-gasless-request.js";
+//#region src/gasless/get-gasless-request/get-gasless-request.ts
+async function i(i, a) {
+	let { chainId: o, requestId: s, service: c = "operations", signal: l } = a, u = t(i, {
+		chainId: o,
+		service: c
+	});
+	return await n(i, u, { signal: l }), r(await e(u, `/${encodeURIComponent(s)}`, "GASLESS_STATUS_FETCH_FAILED", { signal: l }));
+}
+//#endregion
+export { i as getGaslessRequest };
+
+//# sourceMappingURL=get-gasless-request.js.map

package/dist/gasless/get-gasless-request/get-gasless-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gasless-request.js","names":[],"sources":["../../../src/gasless/get-gasless-request/get-gasless-request.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { gaslessGet, resolveGaslessHttp } from \"../http\";\nimport { acquireGaslessStatusRead } from \"../status-read-limiter\";\nimport type { GaslessRequest, GaslessService } from \"../types\";\nimport type { GaslessWireRequestRecord } from \"../wire-types\";\nimport { toGaslessRequest } from \"./to-gasless-request\";\n\n/**\n * Parameters for {@link getGaslessRequest}.\n */\nexport type GetGaslessRequestParameters = Compute<\n  ChainIdParameter & {\n    /** Stable service tracking id returned by a gasless submit. */\n    requestId: string;\n    /**\n     * Which sub-service stores the request. Operation relays live on\n     * `\"operations\"` (the default); deposit settlements on `\"deposits\"`. The\n     * two services are separate databases — a request id polled against the\n     * wrong one is `NOT_FOUND`.\n     */\n    service?: GaslessService;\n    /**\n     * Cancel the read in flight. In React the query factory passes TanStack's\n     * own signal, so an unmounted poll stops spending the deployment's shared\n     * request budget instead of finishing into a discarded result.\n     */\n    signal?: AbortSignal;\n  }\n>;\n\n/** Return type of {@link getGaslessRequest}. */\nexport type GetGaslessRequestReturnType = GaslessRequest;\n\n/**\n * Fetch one stored GaslessQ relayer request.\n *\n * Fire-and-forget model: a submit returns `202` immediately and this record is\n * the only source of truth afterwards. Poll it until\n * `isGaslessRequestTerminal(status)` — via the query factory's\n * `query.refetchInterval` in React, or {@link waitForGaslessRequest} in plain\n * code. `submitted` is **not** success; only `succeeded` is.\n *\n * @param config - The SDK config.\n * @param parameters - Request id, optional service and chain id.\n * @returns The normalized request record.\n * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`\n *   when the chain has no usable gasless service.\n * @throws {SymmApiError} `GASLESS_STATUS_FETCH_FAILED` on HTTP failure —\n *   including `404` while the record is not yet readable right after a `202`\n *   (the accept-vs-record race; retry briefly before treating it as unknown).\n *\n * @example\n * ```ts\n * const request = await getGaslessRequest(config, { requestId });\n * if (request.status === GaslessRequestStatus.SUBMITTED) watchTx(request.txHash);\n * ```\n */\nexport async function getGaslessRequest(\n  config: Config,\n  parameters: GetGaslessRequestParameters,\n): Promise<GetGaslessRequestReturnType> {\n  const { chainId, requestId, service = \"operations\", signal } = parameters;\n  const context = resolveGaslessHttp(config, { chainId, service });\n\n  /** Status polling is unattended and parallel; pace it inside the shared per-deployment budget. */\n  await acquireGaslessStatusRead(config, context, { signal });\n\n  const raw = await gaslessGet<GaslessWireRequestRecord>(\n    context,\n    `/${encodeURIComponent(requestId)}`,\n    \"GASLESS_STATUS_FETCH_FAILED\",\n    { signal },\n  );\n  return toGaslessRequest(raw);\n}\n"],"mappings":";;;;AA0DA,eAAsB,EACpB,GACA,GACsC;CACtC,IAAM,EAAE,YAAS,cAAW,aAAU,cAAc,cAAW,GACzD,IAAU,EAAmB,GAAQ;EAAE;EAAS;CAAQ,CAAC;CAW/D,OARA,MAAM,EAAyB,GAAQ,GAAS,EAAE,UAAO,CAAC,GAQnD,EAAiB,MANN,EAChB,GACA,IAAI,mBAAmB,CAAS,KAChC,+BACA,EAAE,UAAO,CACX,CAC2B;AAC7B"}

package/dist/gasless/get-gasless-request/index.d.ts

@@ -0,0 +1,4 @@
+export * from './get-gasless-request.js';
+export * from './query.js';
+export * from './to-gasless-request.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/gasless/get-gasless-request/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-request/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC"}

package/dist/gasless/get-gasless-request/query.d.ts

@@ -0,0 +1,64 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter, ExactPartial } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetGaslessRequestParameters, GetGaslessRequestReturnType } from './get-gasless-request.js';
+/** Data resolved by the {@link getGaslessRequestQueryOptions} query. */
+export type GetGaslessRequestData = GetGaslessRequestReturnType;
+/**
+ * Build the TanStack Query key for {@link getGaslessRequestQueryOptions}.
+ *
+ * @param options - Partial query parameters.
+ * @returns A stable, hashable query key.
+ */
+export declare function getGaslessRequestQueryKey(options?: Compute<ExactPartial<GetGaslessRequestParameters> & ConfigKeyParameter>): readonly ["getGaslessRequest", Record<string, unknown>];
+/** Query-key type produced by {@link getGaslessRequestQueryKey}. */
+export type GetGaslessRequestQueryKey = ReturnType<typeof getGaslessRequestQueryKey>;
+/**
+ * Options accepted by {@link getGaslessRequestQueryOptions}: the action's
+ * required read parameters, an optional chain id, and TanStack overrides.
+ */
+export type GetGaslessRequestOptions = Compute<GetGaslessRequestParameters & QueryParameter<GetGaslessRequestData, Error, GetGaslessRequestData, GetGaslessRequestQueryKey>>;
+/**
+ * TanStack Query options returned by {@link getGaslessRequestQueryOptions}.
+ *
+ * Its `queryFn` takes the query context, so TanStack's own `AbortSignal`
+ * reaches the HTTP call: a query that unmounts or is cancelled stops its poll
+ * in flight instead of finishing into a discarded result.
+ */
+export type GetGaslessRequestQueryOptions = Omit<SymmioQueryOptions<GetGaslessRequestData, Error, GetGaslessRequestData, GetGaslessRequestQueryKey>, "queryFn"> & {
+    queryFn: (context?: {
+        signal?: AbortSignal;
+    }) => Promise<GetGaslessRequestData>;
+};
+/**
+ * Build TanStack Query options for {@link getGaslessRequest}.
+ *
+ * **Polls by default.** A relay request is a workflow, not a value: fetching it
+ * once answers `queued` and freezes there, which reads as a stalled UI even
+ * though the relayer finished seconds later. So this factory ships the
+ * service-recommended cadence — a jittered 1–2 s while `queued`, 3–5 s after
+ * `submitted`, and **stop** once terminal, because a terminal record is
+ * immutable and polling one forever bills the service for an answer that cannot
+ * change.
+ *
+ * It also absorbs the two failures that are not answers: the accept-vs-record
+ * `404` right after a `202` (up to three), and transient transport failures —
+ * `429`, `503`, a dropped connection — which are retried with the gateway's
+ * `Retry-After` when it sent one, and a jittered backoff otherwise. A definitive
+ * answer (`401`, `403`, `422`, a service error code) is surfaced immediately.
+ *
+ * Every default is applied only where the caller supplied nothing, so
+ * `query.refetchInterval` / `query.retry` / `query.staleTime` still win.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * // Polls to a terminal status on its own.
+ * const request = useQuery(getGaslessRequestQueryOptions(config, { requestId }));
+ * ```
+ */
+export declare function getGaslessRequestQueryOptions(config: Config, options: GetGaslessRequestOptions): GetGaslessRequestQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/gasless/get-gasless-request/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-request/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAKnF,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EACjC,MAAM,uBAAuB,CAAC;AAE/B,wEAAwE;AACxE,MAAM,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,OAAO,CAAC,YAAY,CAAC,2BAA2B,CAAC,GAAG,kBAAkB,CAAM,2DAGtF;AAED,oEAAoE;AACpE,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAErF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,2BAA2B,GACzB,cAAc,CAAC,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,CAAC,CACjG,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,kBAAkB,CAAC,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,CAAC,EAClG,SAAS,CACV,GAAG;IACF,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACjF,CAAC;AAiCF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,wBAAwB,GAChC,6BAA6B,CAyC/B"}

package/dist/gasless/get-gasless-request/query.js

@@ -0,0 +1,42 @@
+import { gaslessPollDelay as e, isGaslessRequestTerminal as t } from "../types.js";
+import { getGaslessRequest as n } from "./get-gasless-request.js";
+import { gaslessTransientReadDelay as r, isTransientGaslessReadError as i } from "../transient-read.js";
+import { filterQueryOptions as a } from "../../shared/utils/query.js";
+import { gaslessQueryPollDelay as o } from "../query-poll-delay.js";
+//#region src/gasless/get-gasless-request/query.ts
+function s(e = {}) {
+	return ["getGaslessRequest", a(e)];
+}
+var c = 3, l = 8;
+function u(e) {
+	return e?.status === 404;
+}
+function d(a, d) {
+	let f = d.query;
+	return {
+		...f,
+		queryKey: s({
+			...d,
+			service: d.service ?? "operations",
+			configKey: a.getChainConfigKey(d.chainId)
+		}),
+		enabled: f?.enabled ?? !0,
+		queryFn: (e) => {
+			let { chainId: t, requestId: r, service: i } = d;
+			return n(a, {
+				chainId: t,
+				requestId: r,
+				service: i,
+				signal: e?.signal ?? d.signal
+			});
+		},
+		refetchInterval: f?.refetchInterval ?? ((e) => o(e.state.data?.status, e.state)),
+		staleTime: f?.staleTime ?? ((e) => e.state.data && t(e.state.data.status) ? Infinity : 0),
+		retry: f?.retry ?? ((e, t) => u(t) ? e < c : i(t) && e < l),
+		retryDelay: f?.retryDelay ?? ((t, n) => u(n) ? e(void 0) : r(t, n))
+	};
+}
+//#endregion
+export { s as getGaslessRequestQueryKey, d as getGaslessRequestQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/gasless/get-gasless-request/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/gasless/get-gasless-request/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter, ExactPartial } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport { gaslessQueryPollDelay } from \"../query-poll-delay\";\nimport { gaslessTransientReadDelay, isTransientGaslessReadError } from \"../transient-read\";\nimport { gaslessPollDelay, isGaslessRequestTerminal } from \"../types\";\nimport {\n  getGaslessRequest,\n  type GetGaslessRequestParameters,\n  type GetGaslessRequestReturnType,\n} from \"./get-gasless-request\";\n\n/** Data resolved by the {@link getGaslessRequestQueryOptions} query. */\nexport type GetGaslessRequestData = GetGaslessRequestReturnType;\n\n/**\n * Build the TanStack Query key for {@link getGaslessRequestQueryOptions}.\n *\n * @param options - Partial query parameters.\n * @returns A stable, hashable query key.\n */\nexport function getGaslessRequestQueryKey(\n  options: Compute<ExactPartial<GetGaslessRequestParameters> & ConfigKeyParameter> = {},\n) {\n  return [\"getGaslessRequest\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getGaslessRequestQueryKey}. */\nexport type GetGaslessRequestQueryKey = ReturnType<typeof getGaslessRequestQueryKey>;\n\n/**\n * Options accepted by {@link getGaslessRequestQueryOptions}: the action's\n * required read parameters, an optional chain id, and TanStack overrides.\n */\nexport type GetGaslessRequestOptions = Compute<\n  GetGaslessRequestParameters &\n    QueryParameter<GetGaslessRequestData, Error, GetGaslessRequestData, GetGaslessRequestQueryKey>\n>;\n\n/**\n * TanStack Query options returned by {@link getGaslessRequestQueryOptions}.\n *\n * Its `queryFn` takes the query context, so TanStack's own `AbortSignal`\n * reaches the HTTP call: a query that unmounts or is cancelled stops its poll\n * in flight instead of finishing into a discarded result.\n */\nexport type GetGaslessRequestQueryOptions = Omit<\n  SymmioQueryOptions<GetGaslessRequestData, Error, GetGaslessRequestData, GetGaslessRequestQueryKey>,\n  \"queryFn\"\n> & {\n  queryFn: (context?: { signal?: AbortSignal }) => Promise<GetGaslessRequestData>;\n};\n\n/**\n * Number of consecutive `404`s tolerated right after a submit: the accepted\n * workflow's record may not be readable immediately (the accept-vs-record\n * race). Mirrors the imperative wait loop's tolerance.\n */\nconst NOT_FOUND_RETRIES = 3;\n\n/**\n * How many consecutive transient transport failures are absorbed before the\n * query surfaces an error.\n *\n * Generous on purpose: a `429`, a `503` or a dropped connection says nothing\n * about the workflow, which keeps running server-side, and a UI that renders\n * \"failed\" because a poll was throttled is what makes a user resubmit a request\n * that is already executing. Each retry waits `max(Retry-After, jittered 1 s →\n * 30 s backoff)`, so the ceiling is minutes of blindness, not a burst.\n */\nconst TRANSIENT_RETRIES = 8;\n\n/**\n * Whether an error is the service's \"record not readable yet\" `404`.\n *\n * Duck-typed on `status` rather than an `instanceof SymmApiError` check: a\n * framework layer may normalize the error before TanStack's `retry` sees it\n * (the React hook wraps `queryFn` and rethrows a `SymmioRequestError`), and an\n * `instanceof` test would silently make this whole tolerance dead code there.\n */\nfunction isNotFound(error: unknown): boolean {\n  return (error as { status?: number } | undefined)?.status === 404;\n}\n\n/**\n * Build TanStack Query options for {@link getGaslessRequest}.\n *\n * **Polls by default.** A relay request is a workflow, not a value: fetching it\n * once answers `queued` and freezes there, which reads as a stalled UI even\n * though the relayer finished seconds later. So this factory ships the\n * service-recommended cadence — a jittered 1–2 s while `queued`, 3–5 s after\n * `submitted`, and **stop** once terminal, because a terminal record is\n * immutable and polling one forever bills the service for an answer that cannot\n * change.\n *\n * It also absorbs the two failures that are not answers: the accept-vs-record\n * `404` right after a `202` (up to three), and transient transport failures —\n * `429`, `503`, a dropped connection — which are retried with the gateway's\n * `Retry-After` when it sent one, and a jittered backoff otherwise. A definitive\n * answer (`401`, `403`, `422`, a service error code) is surfaced immediately.\n *\n * Every default is applied only where the caller supplied nothing, so\n * `query.refetchInterval` / `query.retry` / `query.staleTime` still win.\n *\n * @param config - The SDK config.\n * @param options - Query parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * // Polls to a terminal status on its own.\n * const request = useQuery(getGaslessRequestQueryOptions(config, { requestId }));\n * ```\n */\nexport function getGaslessRequestQueryOptions(\n  config: Config,\n  options: GetGaslessRequestOptions,\n): GetGaslessRequestQueryOptions {\n  const query = options.query;\n\n  return {\n    ...query,\n    /**\n     * `service` is defaulted into the key, not left to the caller: the action\n     * defaults it too, so a key built without it would identify the same\n     * record under a second cache entry that no writer ever seeds.\n     */\n    queryKey: getGaslessRequestQueryKey({\n      ...options,\n      service: options.service ?? \"operations\",\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: query?.enabled ?? true,\n    queryFn: (context) => {\n      const { chainId, requestId, service } = options;\n      return getGaslessRequest(config, { chainId, requestId, service, signal: context?.signal ?? options.signal });\n    },\n    /**\n     * The jitter is seeded from the query's own fetch timestamps rather than\n     * drawn per call: TanStack restarts the countdown whenever a recomputed\n     * `refetchInterval` differs from the running one, and a per-call\n     * `Math.random()` would restart it on every render and never fire.\n     */\n    refetchInterval: query?.refetchInterval ?? ((q) => gaslessQueryPollDelay(q.state.data?.status, q.state)),\n    /** A terminal record never changes, so a remount must not refetch one. */\n    staleTime:\n      query?.staleTime ?? ((q) => (q.state.data && isGaslessRequestTerminal(q.state.data.status) ? Infinity : 0)),\n    retry:\n      query?.retry ??\n      ((failureCount: number, error: Error) =>\n        isNotFound(error)\n          ? failureCount < NOT_FOUND_RETRIES\n          : isTransientGaslessReadError(error) && failureCount < TRANSIENT_RETRIES),\n    retryDelay:\n      query?.retryDelay ??\n      ((failureCount: number, error: Error) =>\n        isNotFound(error) ? (gaslessPollDelay(undefined) as number) : gaslessTransientReadDelay(failureCount, error)),\n  };\n}\n"],"mappings":";;;;;;AAsBA,SAAgB,EACd,IAAmF,CAAC,GACpF;CACA,OAAO,CAAC,qBAAqB,EAAmB,CAAO,CAAC;AAC1D;AAiCA,IAAM,IAAoB,GAYpB,IAAoB;AAU1B,SAAS,EAAW,GAAyB;CAC3C,OAAQ,GAA2C,WAAW;AAChE;AAgCA,SAAgB,EACd,GACA,GAC+B;CAC/B,IAAM,IAAQ,EAAQ;CAEtB,OAAO;EACL,GAAG;EAMH,UAAU,EAA0B;GAClC,GAAG;GACH,SAAS,EAAQ,WAAW;GAC5B,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,GAAO,WAAW;EAC3B,UAAU,MAAY;GACpB,IAAM,EAAE,YAAS,cAAW,eAAY;GACxC,OAAO,EAAkB,GAAQ;IAAE;IAAS;IAAW;IAAS,QAAQ,GAAS,UAAU,EAAQ;GAAO,CAAC;EAC7G;EAOA,iBAAiB,GAAO,qBAAqB,MAAM,EAAsB,EAAE,MAAM,MAAM,QAAQ,EAAE,KAAK;EAEtG,WACE,GAAO,eAAe,MAAO,EAAE,MAAM,QAAQ,EAAyB,EAAE,MAAM,KAAK,MAAM,IAAI,WAAW;EAC1G,OACE,GAAO,WACL,GAAsB,MACtB,EAAW,CAAK,IACZ,IAAe,IACf,EAA4B,CAAK,KAAK,IAAe;EAC7D,YACE,GAAO,gBACL,GAAsB,MACtB,EAAW,CAAK,IAAK,EAAiB,KAAA,CAAS,IAAe,EAA0B,GAAc,CAAK;CACjH;AACF"}

package/dist/gasless/get-gasless-request/to-gasless-request.d.ts

@@ -0,0 +1,26 @@
+import { GaslessRequestStatus, GaslessRequest } from '../types.js';
+import { GaslessWireRequestRecord } from '../wire-types.js';
+/**
+ * Parse a wire status string into {@link GaslessRequestStatus}.
+ *
+ * @throws {SymmError} `GASLESS_STATUS_UNKNOWN` for a value outside the
+ *   documented lifecycle — better a loud failure than a silent non-terminal
+ *   status that polls forever.
+ *
+ * @internal
+ */
+export declare function toGaslessRequestStatus(raw: string): GaslessRequestStatus;
+/**
+ * Normalize a stored request record (operations or deposits shape) into the
+ * {@link GaslessRequest} union.
+ *
+ * The two services are separate databases with different columns, so the shape
+ * itself picks the variant: a deposits record carries `deposit_address` and
+ * keys its id `request_id`, while an operations record keys its id `id`.
+ * Optional wire fields normalize to explicit `null` (absent, not zero), and
+ * wallet ids to `bigint`s, with a missing id meaning wallet `0`.
+ *
+ * @internal
+ */
+export declare function toGaslessRequest(raw: GaslessWireRequestRecord): GaslessRequest;
+//# sourceMappingURL=to-gasless-request.d.ts.map

package/dist/gasless/get-gasless-request/to-gasless-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-gasless-request.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-request/to-gasless-request.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EAGpB,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAGlB,OAAO,KAAK,EAAwD,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAIpH;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAKxE;AA2ED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,wBAAwB,GAAG,cAAc,CAI9E"}

package/dist/gasless/get-gasless-request/to-gasless-request.js

@@ -0,0 +1,62 @@
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+import { GaslessRequestStatus as t } from "../types.js";
+import { parseGaslessWalletId as n } from "../wallet-id.js";
+import { toGaslessOptionalAmount as r } from "../wire-parse.js";
+//#region src/gasless/get-gasless-request/to-gasless-request.ts
+var i = new Set(Object.values(t));
+function a(t) {
+	if (!i.has(t)) throw new e("api", "GASLESS_STATUS_UNKNOWN", `Gasless: unknown request status "${t}".`);
+	return t;
+}
+function o(e) {
+	if (Array.isArray(e.wallet_ids)) return e.wallet_ids.map((e, t) => n(e, `payload.wallet_ids[${t}]`));
+	let t = Array.isArray(e.signed_ops) ? e.signed_ops.length : 0;
+	return Array.from({ length: t }, () => 0n);
+}
+function s(e) {
+	return {
+		service: "operations",
+		requestId: e.id,
+		status: a(e.status),
+		txHash: e.tx_hash ?? null,
+		errorCode: e.error_code ?? null,
+		errorMessage: e.error_message ?? null,
+		idempotencyKey: e.idempotency_key ?? null,
+		owner: e.user_address ?? null,
+		walletIds: o(e.payload ?? {}),
+		createdAt: e.created_at ?? null,
+		updatedAt: e.updated_at ?? null,
+		operationType: e.operation_type ?? null,
+		accountId: e.account_id ?? null,
+		feeAmountRaw: r(e.fee_amount_raw)
+	};
+}
+function c(e) {
+	let t = e.payload ?? {}, i = e.wallet_id ?? t.wallet_id, o = i == null ? 0n : n(i, "wallet_id");
+	return {
+		service: "deposits",
+		requestId: e.request_id,
+		status: a(e.status),
+		txHash: e.tx_hash ?? null,
+		errorCode: e.error_code ?? null,
+		errorMessage: e.error_message ?? null,
+		idempotencyKey: e.idempotency_key ?? null,
+		owner: e.wallet_address ?? null,
+		walletIds: [o],
+		createdAt: e.created_at ?? null,
+		updatedAt: e.updated_at ?? null,
+		depositAddress: e.deposit_address ?? null,
+		walletId: o,
+		accountName: e.account_name ?? null,
+		amountRaw: r(e.amount_raw),
+		feeRaw: r(e.fee_raw),
+		creditedRaw: r(e.credited_raw)
+	};
+}
+function l(e) {
+	return "deposit_address" in e ? c(e) : s(e);
+}
+//#endregion
+export { l as toGaslessRequest };
+
+//# sourceMappingURL=to-gasless-request.js.map

package/dist/gasless/get-gasless-request/to-gasless-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-gasless-request.js","names":[],"sources":["../../../src/gasless/get-gasless-request/to-gasless-request.ts"],"sourcesContent":["import type { Address, Hash } from \"viem\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport {\n  GaslessRequestStatus,\n  type GaslessDepositRequest,\n  type GaslessOperationRequest,\n  type GaslessRequest,\n} from \"../types\";\nimport { parseGaslessWalletId } from \"../wallet-id\";\nimport { toGaslessOptionalAmount } from \"../wire-parse\";\nimport type { GaslessWireDepositRecord, GaslessWireOperationRecord, GaslessWireRequestRecord } from \"../wire-types\";\n\nconst STATUS_VALUES = new Set<string>(Object.values(GaslessRequestStatus));\n\n/**\n * Parse a wire status string into {@link GaslessRequestStatus}.\n *\n * @throws {SymmError} `GASLESS_STATUS_UNKNOWN` for a value outside the\n *   documented lifecycle — better a loud failure than a silent non-terminal\n *   status that polls forever.\n *\n * @internal\n */\nexport function toGaslessRequestStatus(raw: string): GaslessRequestStatus {\n  if (!STATUS_VALUES.has(raw)) {\n    throw new SymmError(\"api\", \"GASLESS_STATUS_UNKNOWN\", `Gasless: unknown request status \"${raw}\".`);\n  }\n  return raw as GaslessRequestStatus;\n}\n\n/** The stored JSON payload of a record, as far as wallet ids are concerned. */\ninterface WalletIdPayload {\n  wallet_ids?: unknown;\n  wallet_id?: unknown;\n  signed_ops?: unknown;\n}\n\n/**\n * The wallet ids a stored operation record selected.\n *\n * Records written before multiple wallets existed carry no ids at all, and an\n * omitted id means wallet `0` — so they normalize to one zero per stored\n * operation rather than to an empty array, which would read as \"no wallets\".\n *\n * @internal\n */\nfunction toOperationWalletIds(payload: WalletIdPayload): bigint[] {\n  if (Array.isArray(payload.wallet_ids)) {\n    return payload.wallet_ids.map((value, index) => parseGaslessWalletId(value, `payload.wallet_ids[${index}]`));\n  }\n  const operationCount = Array.isArray(payload.signed_ops) ? payload.signed_ops.length : 0;\n  return Array.from({ length: operationCount }, () => 0n);\n}\n\n/** Normalize a stored operations record. @internal */\nfunction toGaslessOperationRequest(raw: GaslessWireOperationRecord): GaslessOperationRequest {\n  return {\n    service: \"operations\",\n    requestId: raw.id,\n    status: toGaslessRequestStatus(raw.status),\n    txHash: (raw.tx_hash as Hash | undefined) ?? null,\n    errorCode: raw.error_code ?? null,\n    errorMessage: raw.error_message ?? null,\n    idempotencyKey: raw.idempotency_key ?? null,\n    owner: (raw.user_address as Address | undefined) ?? null,\n    walletIds: toOperationWalletIds((raw.payload ?? {}) as WalletIdPayload),\n    createdAt: raw.created_at ?? null,\n    updatedAt: raw.updated_at ?? null,\n    operationType: raw.operation_type ?? null,\n    accountId: raw.account_id ?? null,\n    feeAmountRaw: toGaslessOptionalAmount(raw.fee_amount_raw),\n  };\n}\n\n/** Normalize a stored deposits record. @internal */\nfunction toGaslessDepositRequest(raw: GaslessWireDepositRecord): GaslessDepositRequest {\n  const payload = (raw.payload ?? {}) as WalletIdPayload;\n  const storedWalletId = raw.wallet_id ?? payload.wallet_id;\n  const walletId =\n    storedWalletId === undefined || storedWalletId === null ? 0n : parseGaslessWalletId(storedWalletId, \"wallet_id\");\n\n  return {\n    service: \"deposits\",\n    requestId: raw.request_id,\n    status: toGaslessRequestStatus(raw.status),\n    txHash: (raw.tx_hash as Hash | undefined) ?? null,\n    errorCode: raw.error_code ?? null,\n    errorMessage: raw.error_message ?? null,\n    idempotencyKey: raw.idempotency_key ?? null,\n    /** `wallet_address` is the owner address, not a GaslessWallet address. */\n    owner: (raw.wallet_address as Address | undefined) ?? null,\n    walletIds: [walletId],\n    createdAt: raw.created_at ?? null,\n    updatedAt: raw.updated_at ?? null,\n    depositAddress: (raw.deposit_address as Address | undefined) ?? null,\n    walletId,\n    accountName: raw.account_name ?? null,\n    amountRaw: toGaslessOptionalAmount(raw.amount_raw),\n    feeRaw: toGaslessOptionalAmount(raw.fee_raw),\n    creditedRaw: toGaslessOptionalAmount(raw.credited_raw),\n  };\n}\n\n/**\n * Normalize a stored request record (operations or deposits shape) into the\n * {@link GaslessRequest} union.\n *\n * The two services are separate databases with different columns, so the shape\n * itself picks the variant: a deposits record carries `deposit_address` and\n * keys its id `request_id`, while an operations record keys its id `id`.\n * Optional wire fields normalize to explicit `null` (absent, not zero), and\n * wallet ids to `bigint`s, with a missing id meaning wallet `0`.\n *\n * @internal\n */\nexport function toGaslessRequest(raw: GaslessWireRequestRecord): GaslessRequest {\n  return \"deposit_address\" in raw\n    ? toGaslessDepositRequest(raw as GaslessWireDepositRecord)\n    : toGaslessOperationRequest(raw as GaslessWireOperationRecord);\n}\n"],"mappings":";;;;;AAYA,IAAM,IAAgB,IAAI,IAAY,OAAO,OAAO,CAAoB,CAAC;AAWzE,SAAgB,EAAuB,GAAmC;CACxE,IAAI,CAAC,EAAc,IAAI,CAAG,GACxB,MAAM,IAAI,EAAU,OAAO,0BAA0B,oCAAoC,EAAI,GAAG;CAElG,OAAO;AACT;AAkBA,SAAS,EAAqB,GAAoC;CAChE,IAAI,MAAM,QAAQ,EAAQ,UAAU,GAClC,OAAO,EAAQ,WAAW,KAAK,GAAO,MAAU,EAAqB,GAAO,sBAAsB,EAAM,EAAE,CAAC;CAE7G,IAAM,IAAiB,MAAM,QAAQ,EAAQ,UAAU,IAAI,EAAQ,WAAW,SAAS;CACvF,OAAO,MAAM,KAAK,EAAE,QAAQ,EAAe,SAAS,EAAE;AACxD;AAGA,SAAS,EAA0B,GAA0D;CAC3F,OAAO;EACL,SAAS;EACT,WAAW,EAAI;EACf,QAAQ,EAAuB,EAAI,MAAM;EACzC,QAAS,EAAI,WAAgC;EAC7C,WAAW,EAAI,cAAc;EAC7B,cAAc,EAAI,iBAAiB;EACnC,gBAAgB,EAAI,mBAAmB;EACvC,OAAQ,EAAI,gBAAwC;EACpD,WAAW,EAAsB,EAAI,WAAW,CAAC,CAAqB;EACtE,WAAW,EAAI,cAAc;EAC7B,WAAW,EAAI,cAAc;EAC7B,eAAe,EAAI,kBAAkB;EACrC,WAAW,EAAI,cAAc;EAC7B,cAAc,EAAwB,EAAI,cAAc;CAC1D;AACF;AAGA,SAAS,EAAwB,GAAsD;CACrF,IAAM,IAAW,EAAI,WAAW,CAAC,GAC3B,IAAiB,EAAI,aAAa,EAAQ,WAC1C,IACJ,KAAmD,OAAO,KAAK,EAAqB,GAAgB,WAAW;CAEjH,OAAO;EACL,SAAS;EACT,WAAW,EAAI;EACf,QAAQ,EAAuB,EAAI,MAAM;EACzC,QAAS,EAAI,WAAgC;EAC7C,WAAW,EAAI,cAAc;EAC7B,cAAc,EAAI,iBAAiB;EACnC,gBAAgB,EAAI,mBAAmB;EAEvC,OAAQ,EAAI,kBAA0C;EACtD,WAAW,CAAC,CAAQ;EACpB,WAAW,EAAI,cAAc;EAC7B,WAAW,EAAI,cAAc;EAC7B,gBAAiB,EAAI,mBAA2C;EAChE;EACA,aAAa,EAAI,gBAAgB;EACjC,WAAW,EAAwB,EAAI,UAAU;EACjD,QAAQ,EAAwB,EAAI,OAAO;EAC3C,aAAa,EAAwB,EAAI,YAAY;CACvD;AACF;AAcA,SAAgB,EAAiB,GAA+C;CAC9E,OAAO,qBAAqB,IACxB,EAAwB,CAA+B,IACvD,EAA0B,CAAiC;AACjE"}

package/dist/gasless/get-gasless-request-transactions/get-gasless-request-transactions.d.ts

@@ -0,0 +1,40 @@
+import { Config } from '../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+import { GaslessRequestTransaction, GaslessService } from '../types.js';
+/**
+ * Parameters for {@link getGaslessRequestTransactions}.
+ */
+export type GetGaslessRequestTransactionsParameters = Compute<ChainIdParameter & {
+    /** Stable service tracking id returned by a gasless submit. */
+    requestId: string;
+    /** Which sub-service stores the request. Defaults to `"operations"`. */
+    service?: GaslessService;
+    /** Cancel the read in flight — the React hook passes TanStack's query signal. */
+    signal?: AbortSignal;
+}>;
+/** Return type of {@link getGaslessRequestTransactions}. */
+export type GetGaslessRequestTransactionsReturnType = readonly GaslessRequestTransaction[];
+/**
+ * List the EVM broadcast attempts stored for one gasless request.
+ *
+ * A transaction hash is mutable across replacement attempts — the request id
+ * is the stable identifier, and this endpoint shows every attempt with its
+ * receipt outcome. Fetch it when a `txHash` appears or when a request reaches
+ * a terminal status, to show explorer links or diagnose a `failed` request.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Request id, optional service and chain id.
+ * @returns The stored attempts, oldest first as the service returns them.
+ * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`.
+ * @throws {SymmApiError} `GASLESS_TRANSACTIONS_FETCH_FAILED` on HTTP failure.
+ * @throws {SymmError} `GASLESS_ATTEMPT_STATUS_UNKNOWN` when the service reports
+ *   an attempt status outside {@link GaslessTransactionAttemptStatus}.
+ *
+ * @example
+ * ```ts
+ * const attempts = await getGaslessRequestTransactions(config, { requestId });
+ * const latest = attempts.at(-1);
+ * ```
+ */
+export declare function getGaslessRequestTransactions(config: Config, parameters: GetGaslessRequestTransactionsParameters): Promise<GetGaslessRequestTransactionsReturnType>;
+//# sourceMappingURL=get-gasless-request-transactions.d.ts.map

package/dist/gasless/get-gasless-request-transactions/get-gasless-request-transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gasless-request-transactions.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-request-transactions/get-gasless-request-transactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAG/E,OAAO,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI1E;;GAEG;AACH,MAAM,MAAM,uCAAuC,GAAG,OAAO,CAC3D,gBAAgB,GAAG;IACjB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,iFAAiF;IACjF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CACF,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,uCAAuC,GAAG,SAAS,yBAAyB,EAAE,CAAC;AAE3F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,uCAAuC,GAClD,OAAO,CAAC,uCAAuC,CAAC,CAclD"}

package/dist/gasless/get-gasless-request-transactions/get-gasless-request-transactions.js

@@ -0,0 +1,15 @@
+import { gaslessGet as e, resolveGaslessHttp as t } from "../http.js";
+import { acquireGaslessStatusRead as n } from "../status-read-limiter.js";
+import { toGaslessRequestTransaction as r } from "./to-gasless-request-transaction.js";
+//#region src/gasless/get-gasless-request-transactions/get-gasless-request-transactions.ts
+async function i(i, a) {
+	let { chainId: o, requestId: s, service: c = "operations", signal: l } = a, u = t(i, {
+		chainId: o,
+		service: c
+	});
+	return await n(i, u, { signal: l }), (await e(u, `/${encodeURIComponent(s)}/transactions`, "GASLESS_TRANSACTIONS_FETCH_FAILED", { signal: l })).map(r);
+}
+//#endregion
+export { i as getGaslessRequestTransactions };
+
+//# sourceMappingURL=get-gasless-request-transactions.js.map

package/dist/gasless/get-gasless-request-transactions/get-gasless-request-transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gasless-request-transactions.js","names":[],"sources":["../../../src/gasless/get-gasless-request-transactions/get-gasless-request-transactions.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { gaslessGet, resolveGaslessHttp } from \"../http\";\nimport { acquireGaslessStatusRead } from \"../status-read-limiter\";\nimport type { GaslessRequestTransaction, GaslessService } from \"../types\";\nimport type { GaslessWireTransactionAttempt } from \"../wire-types\";\nimport { toGaslessRequestTransaction } from \"./to-gasless-request-transaction\";\n\n/**\n * Parameters for {@link getGaslessRequestTransactions}.\n */\nexport type GetGaslessRequestTransactionsParameters = Compute<\n  ChainIdParameter & {\n    /** Stable service tracking id returned by a gasless submit. */\n    requestId: string;\n    /** Which sub-service stores the request. Defaults to `\"operations\"`. */\n    service?: GaslessService;\n    /** Cancel the read in flight — the React hook passes TanStack's query signal. */\n    signal?: AbortSignal;\n  }\n>;\n\n/** Return type of {@link getGaslessRequestTransactions}. */\nexport type GetGaslessRequestTransactionsReturnType = readonly GaslessRequestTransaction[];\n\n/**\n * List the EVM broadcast attempts stored for one gasless request.\n *\n * A transaction hash is mutable across replacement attempts — the request id\n * is the stable identifier, and this endpoint shows every attempt with its\n * receipt outcome. Fetch it when a `txHash` appears or when a request reaches\n * a terminal status, to show explorer links or diagnose a `failed` request.\n *\n * @param config - The SDK config.\n * @param parameters - Request id, optional service and chain id.\n * @returns The stored attempts, oldest first as the service returns them.\n * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`.\n * @throws {SymmApiError} `GASLESS_TRANSACTIONS_FETCH_FAILED` on HTTP failure.\n * @throws {SymmError} `GASLESS_ATTEMPT_STATUS_UNKNOWN` when the service reports\n *   an attempt status outside {@link GaslessTransactionAttemptStatus}.\n *\n * @example\n * ```ts\n * const attempts = await getGaslessRequestTransactions(config, { requestId });\n * const latest = attempts.at(-1);\n * ```\n */\nexport async function getGaslessRequestTransactions(\n  config: Config,\n  parameters: GetGaslessRequestTransactionsParameters,\n): Promise<GetGaslessRequestTransactionsReturnType> {\n  const { chainId, requestId, service = \"operations\", signal } = parameters;\n  const context = resolveGaslessHttp(config, { chainId, service });\n\n  /** Shares the status-read budget: the attempts list is polled beside the record it belongs to. */\n  await acquireGaslessStatusRead(config, context, { signal });\n\n  const raw = await gaslessGet<GaslessWireTransactionAttempt[]>(\n    context,\n    `/${encodeURIComponent(requestId)}/transactions`,\n    \"GASLESS_TRANSACTIONS_FETCH_FAILED\",\n    { signal },\n  );\n  return raw.map(toGaslessRequestTransaction);\n}\n"],"mappings":";;;;AA+CA,eAAsB,EACpB,GACA,GACkD;CAClD,IAAM,EAAE,YAAS,cAAW,aAAU,cAAc,cAAW,GACzD,IAAU,EAAmB,GAAQ;EAAE;EAAS;CAAQ,CAAC;CAW/D,OARA,MAAM,EAAyB,GAAQ,GAAS,EAAE,UAAO,CAAC,IAQnD,MANW,EAChB,GACA,IAAI,mBAAmB,CAAS,EAAE,gBAClC,qCACA,EAAE,UAAO,CACX,GACW,IAAI,CAA2B;AAC5C"}

package/dist/gasless/get-gasless-request-transactions/index.d.ts

@@ -0,0 +1,4 @@
+export * from './get-gasless-request-transactions.js';
+export * from './query.js';
+export * from './to-gasless-request-transaction.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/gasless/get-gasless-request-transactions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-request-transactions/index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,SAAS,CAAC;AACxB,cAAc,kCAAkC,CAAC"}