@symmio/trading-core 3.0.0 → 3.1.0

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

@@ -0,0 +1,50 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { gaslessWalletCallData as t } from "../gasless-wallet-execute/calls.js";
+import { gaslessBatchCallData as n, isGaslessBatchWalletExecute as r } from "../batch/calls.js";
+import { getGaslessBatchFeeQuote as i } from "./get-gasless-batch-fee-quote.js";
+//#region src/gasless/get-gasless-batch-fee-quote/query.ts
+function a(e, t) {
+	try {
+		return t();
+	} catch {
+		return "functionName" in e ? {
+			functionName: e.functionName,
+			args: e.args
+		} : null;
+	}
+}
+function o(e) {
+	return r(e) ? {
+		walletId: e.walletId ?? 0n,
+		walletCalls: e.walletCalls.map((e) => ({
+			target: e.target,
+			value: e.value ?? 0n,
+			data: a(e, () => t(e))
+		}))
+	} : { data: a(e, () => n(e)) };
+}
+function s(t = {}) {
+	return ["getGaslessBatchFeeQuote", e({
+		...t,
+		calls: t.calls?.map(o)
+	})];
+}
+function c(e, t) {
+	return {
+		...t.query,
+		queryKey: s({
+			...t,
+			configKey: e.getChainConfigKey(t.chainId)
+		}),
+		enabled: t.query?.enabled ?? !0,
+		queryFn: () => i(e, {
+			chainId: t.chainId,
+			account: t.account,
+			calls: t.calls
+		})
+	};
+}
+//#endregion
+export { s as getGaslessBatchFeeQuoteQueryKey, c as getGaslessBatchFeeQuoteQueryOptions };
+
+//# sourceMappingURL=query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/gasless/get-gasless-batch-fee-quote/query.ts"],"sourcesContent":["import type { Hex } from \"viem\";\nimport 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  gaslessBatchCallData,\n  isGaslessBatchWalletExecute,\n  type GaslessBatchCall,\n  type GaslessBatchContractCall,\n  type GaslessBatchRawCall,\n} from \"../batch/calls\";\nimport { gaslessWalletCallData, type GaslessWalletCall } from \"../gasless-wallet-execute/calls\";\nimport {\n  getGaslessBatchFeeQuote,\n  type GetGaslessBatchFeeQuoteParameters,\n  type GetGaslessBatchFeeQuoteReturnType,\n} from \"./get-gasless-batch-fee-quote\";\n\n/** Data resolved by the {@link getGaslessBatchFeeQuoteQueryOptions} query. */\nexport type GetGaslessBatchFeeQuoteData = GetGaslessBatchFeeQuoteReturnType;\n\n/**\n * A call's calldata for the query key — or, when an ABI-level call does not\n * encode, its function name and arguments. A key builder runs during render,\n * where a throw would take the component down with it; falling back keeps the\n * key deterministic and leaves the encoding error to the query function, which\n * reports it as the query's error.\n */\nfunction keyedCallData(\n  call: GaslessBatchContractCall | GaslessBatchRawCall | GaslessWalletCall,\n  encode: () => Hex,\n): unknown {\n  try {\n    return encode();\n  } catch {\n    return \"functionName\" in call ? { functionName: call.functionName, args: call.args } : null;\n  }\n}\n\n/**\n * The part of a batch call that decides its price, in a hashable form: encoded\n * calldata in place of the ABI (a full contract ABI would otherwise be walked\n * and hashed on every render), and every default made explicit, so equivalent\n * calls share one cache entry.\n */\nfunction toGaslessBatchCallKey(call: GaslessBatchCall): unknown {\n  if (isGaslessBatchWalletExecute(call)) {\n    return {\n      walletId: call.walletId ?? 0n,\n      walletCalls: call.walletCalls.map((walletCall) => ({\n        target: walletCall.target,\n        value: walletCall.value ?? 0n,\n        data: keyedCallData(walletCall, () => gaslessWalletCallData(walletCall)),\n      })),\n    };\n  }\n  return { data: keyedCallData(call, () => gaslessBatchCallData(call)) };\n}\n\n/**\n * Build the TanStack Query key for {@link getGaslessBatchFeeQuoteQueryOptions}.\n *\n * Each call is keyed by its **encoded calldata**, not its ABI: an\n * `{ abi, functionName, args }` call and the raw `{ data }` it encodes to share\n * one cache entry, and an omitted `walletId` / `value` keys as `0n`.\n *\n * @param options - Partial query parameters.\n * @returns A stable, hashable query key.\n */\nexport function getGaslessBatchFeeQuoteQueryKey(\n  options: Compute<ExactPartial<GetGaslessBatchFeeQuoteParameters> & ConfigKeyParameter> = {},\n) {\n  return [\n    \"getGaslessBatchFeeQuote\",\n    filterQueryOptions({ ...options, calls: options.calls?.map(toGaslessBatchCallKey) }),\n  ] as const;\n}\n\n/** Query-key type produced by {@link getGaslessBatchFeeQuoteQueryKey}. */\nexport type GetGaslessBatchFeeQuoteQueryKey = ReturnType<typeof getGaslessBatchFeeQuoteQueryKey>;\n\n/**\n * Options accepted by {@link getGaslessBatchFeeQuoteQueryOptions}.\n */\nexport type GetGaslessBatchFeeQuoteOptions = Compute<\n  GetGaslessBatchFeeQuoteParameters &\n    QueryParameter<GetGaslessBatchFeeQuoteData, Error, GetGaslessBatchFeeQuoteData, GetGaslessBatchFeeQuoteQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getGaslessBatchFeeQuoteQueryOptions}. */\nexport type GetGaslessBatchFeeQuoteQueryOptions = SymmioQueryOptions<\n  GetGaslessBatchFeeQuoteData,\n  Error,\n  GetGaslessBatchFeeQuoteData,\n  GetGaslessBatchFeeQuoteQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getGaslessBatchFeeQuote}.\n *\n * The key covers the account, the chain and every call's encoded calldata, so\n * changing an argument 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(\n *   getGaslessBatchFeeQuoteQueryOptions(config, {\n *     account: subAccount,\n *     calls: [{ functionName: \"allocate\", args: [amount] }],\n *   }),\n * );\n * ```\n */\nexport function getGaslessBatchFeeQuoteQueryOptions(\n  config: Config,\n  options: GetGaslessBatchFeeQuoteOptions,\n): GetGaslessBatchFeeQuoteQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getGaslessBatchFeeQuoteQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      getGaslessBatchFeeQuote(config, { chainId: options.chainId, account: options.account, calls: options.calls }),\n  };\n}\n"],"mappings":";;;;;AA6BA,SAAS,EACP,GACA,GACS;CACT,IAAI;EACF,OAAO,EAAO;CAChB,QAAQ;EACN,OAAO,kBAAkB,IAAO;GAAE,cAAc,EAAK;GAAc,MAAM,EAAK;EAAK,IAAI;CACzF;AACF;AAQA,SAAS,EAAsB,GAAiC;CAW9D,OAVI,EAA4B,CAAI,IAC3B;EACL,UAAU,EAAK,YAAY;EAC3B,aAAa,EAAK,YAAY,KAAK,OAAgB;GACjD,QAAQ,EAAW;GACnB,OAAO,EAAW,SAAS;GAC3B,MAAM,EAAc,SAAkB,EAAsB,CAAU,CAAC;EACzE,EAAE;CACJ,IAEK,EAAE,MAAM,EAAc,SAAY,EAAqB,CAAI,CAAC,EAAE;AACvE;AAYA,SAAgB,EACd,IAAyF,CAAC,GAC1F;CACA,OAAO,CACL,2BACA,EAAmB;EAAE,GAAG;EAAS,OAAO,EAAQ,OAAO,IAAI,CAAqB;CAAE,CAAC,CACrF;AACF;AAyCA,SAAgB,EACd,GACA,GACqC;CACrC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAAgC;GACxC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EACnC,eACE,EAAwB,GAAQ;GAAE,SAAS,EAAQ;GAAS,SAAS,EAAQ;GAAS,OAAO,EAAQ;EAAM,CAAC;CAChH;AACF"}

package/dist/gasless/get-gasless-deposit-policy/get-gasless-deposit-policy.d.ts

@@ -0,0 +1,80 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+/**
+ * Parameters for {@link getGaslessDepositPolicy}.
+ */
+export type GetGaslessDepositPolicyParameters = Compute<ChainIdParameter & {
+    /** The owner wallet onboarding through gasless deposit — an owner address, never a GaslessWallet address. */
+    owner: Address;
+    /**
+     * Which of the owner's GaslessWallets receives the deposit. Defaults to
+     * `0n`, the original wallet. Each id has its own address and balance, and
+     * settling one wallet never sweeps another. Range `0n` through `2^256 - 1`.
+     */
+    walletId?: bigint;
+}>;
+/** Return type of {@link getGaslessDepositPolicy}. Every amount is in collateral token units. */
+export interface GetGaslessDepositPolicyReturnType {
+    /** The wallet id the policy was read for — `0n` when the parameter was omitted. */
+    walletId: bigint;
+    /** The deterministic deposit address: the GaslessWallet of `(owner, walletId)`. */
+    depositAddress: Address;
+    /** The only token the settlement sweeps — send nothing else to the address. */
+    collateralTokenAddress: Address;
+    /** The collateral token's ERC-20 `decimals()`, the scale of every amount in this policy. */
+    collateralDecimals: number;
+    /** Flat fee deducted from the observed balance at settlement (collateral token units). */
+    depositFee: bigint;
+    /** Minimum observed balance the service will settle (collateral token units). */
+    minimumDeposit: bigint;
+    /**
+     * One-time fee the settlement also deducts when it deploys this wallet
+     * (collateral token units) — `0n` once the wallet is deployed. See
+     * `getGaslessWalletCreationFee`.
+     */
+    walletCreationFee: bigint;
+    /**
+     * The smallest balance that settles: `max(minimumDeposit, depositFee +
+     * walletCreationFee + 1n)`. The GaslessLayer rejects a settlement unless the
+     * swept balance both reaches `minimumDeposit` and exceeds the deposit fee
+     * plus the creation fee. Gate the settlement UI on the observed balance
+     * reaching this.
+     */
+    settlementMinimum: bigint;
+}
+/**
+ * Read the gasless **deposit policy** for one of an owner's GaslessWallets —
+ * the deterministic deposit address plus the fee and minimum terms — directly
+ * from the GaslessLayer.
+ *
+ * All values are RPC contract reads (the service exposes no read endpoints):
+ * `getGaslessWalletAddress(owner, walletId)`, `collateralToken()` and the
+ * token's `decimals()`, `depositFee()`, `minimumDeposit()` and
+ * `getWalletCreationFee(owner, walletId)`. The deposit address is a pure
+ * `CREATE2` view, so it is safe to display before any transaction; collateral
+ * sent there can only ever reach a sub-account owned by `owner`. Watch the
+ * address's balance with the existing collateral-balance read
+ * (`getCollateralBalance`) and enable settlement once it reaches
+ * `settlementMinimum`.
+ *
+ * The settlement sweeps the wallet's **entire** balance, so keep separate
+ * wallet ids for funding flows that must not be swept together.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Owner wallet, optional wallet id (default `0n`), optional chain id.
+ * @returns The deposit policy.
+ * @throws {SymmError} `GASLESS_WALLET_ID_INVALID` for a wallet id outside the `uint256` range
+ *   (or a JavaScript `number`), before any RPC call.
+ * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION` /
+ *   `GASLESS_WALLET_UNAVAILABLE`.
+ *
+ * @example
+ * ```ts
+ * const policy = await getGaslessDepositPolicy(config, { owner });
+ * showDepositAddress(policy.depositAddress);
+ * const minimum = formatUnits(policy.settlementMinimum, policy.collateralDecimals);
+ * ```
+ */
+export declare function getGaslessDepositPolicy(config: Config, parameters: GetGaslessDepositPolicyParameters): Promise<GetGaslessDepositPolicyReturnType>;
+//# sourceMappingURL=get-gasless-deposit-policy.d.ts.map

package/dist/gasless/get-gasless-deposit-policy/get-gasless-deposit-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gasless-deposit-policy.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-deposit-policy/get-gasless-deposit-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAqB,MAAM,MAAM,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAO/E;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,OAAO,CACrD,gBAAgB,GAAG;IACjB,6GAA6G;IAC7G,KAAK,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CACF,CAAC;AAEF,iGAAiG;AACjG,MAAM,WAAW,iCAAiC;IAChD,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,cAAc,EAAE,OAAO,CAAC;IACxB,+EAA+E;IAC/E,sBAAsB,EAAE,OAAO,CAAC;IAChC,4FAA4F;IAC5F,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0FAA0F;IAC1F,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;;;;OAMG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAyBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,iCAAiC,GAC5C,OAAO,CAAC,iCAAiC,CAAC,CA4B5C"}

package/dist/gasless/get-gasless-deposit-policy/get-gasless-deposit-policy.js

@@ -0,0 +1,61 @@
+import { gaslessLayerAbi as e } from "../../symmio-contracts/abi/v0.8.6/gasless-layer.js";
+import { resolveGaslessService as t } from "../resolve-gasless.js";
+import { assertGaslessWalletId as n } from "../wallet-id.js";
+import { getGaslessWalletAddress as r } from "../get-gasless-wallet-address/get-gasless-wallet-address.js";
+import { getGaslessWalletCreationFee as i } from "../get-gasless-wallet-creation-fee/get-gasless-wallet-creation-fee.js";
+import { erc20Abi as a } from "viem";
+//#region src/gasless/get-gasless-deposit-policy/get-gasless-deposit-policy.ts
+async function o(t, n) {
+	let r = await t.readContract({
+		address: n,
+		abi: e,
+		functionName: "collateralToken"
+	});
+	return {
+		address: r,
+		decimals: await t.readContract({
+			address: r,
+			abi: a,
+			functionName: "decimals"
+		})
+	};
+}
+async function s(a, s) {
+	let { chainId: c, owner: l } = s, u = n(s.walletId ?? 0n), d = t(a, { chainId: c }), f = a.getClient({ chainId: c }), [p, m, h, g, _] = await Promise.all([
+		r(a, {
+			chainId: c,
+			owner: l,
+			walletId: u
+		}),
+		o(f, d.gaslessLayerAddress),
+		f.readContract({
+			address: d.gaslessLayerAddress,
+			abi: e,
+			functionName: "depositFee"
+		}),
+		f.readContract({
+			address: d.gaslessLayerAddress,
+			abi: e,
+			functionName: "minimumDeposit"
+		}),
+		i(a, {
+			chainId: c,
+			owner: l,
+			walletId: u
+		})
+	]), v = h + _ + 1n, y = g > v ? g : v;
+	return {
+		walletId: u,
+		depositAddress: p,
+		collateralTokenAddress: m.address,
+		collateralDecimals: m.decimals,
+		depositFee: h,
+		minimumDeposit: g,
+		walletCreationFee: _,
+		settlementMinimum: y
+	};
+}
+//#endregion
+export { s as getGaslessDepositPolicy };
+
+//# sourceMappingURL=get-gasless-deposit-policy.js.map

package/dist/gasless/get-gasless-deposit-policy/get-gasless-deposit-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gasless-deposit-policy.js","names":[],"sources":["../../../src/gasless/get-gasless-deposit-policy/get-gasless-deposit-policy.ts"],"sourcesContent":["import { erc20Abi, type Address, type PublicClient } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { gaslessLayerAbi } from \"../../symmio-contracts/abi/v0.8.6/gasless-layer\";\nimport { getGaslessWalletAddress } from \"../get-gasless-wallet-address/get-gasless-wallet-address\";\nimport { getGaslessWalletCreationFee } from \"../get-gasless-wallet-creation-fee/get-gasless-wallet-creation-fee\";\nimport { resolveGaslessService } from \"../resolve-gasless\";\nimport { assertGaslessWalletId } from \"../wallet-id\";\n\n/**\n * Parameters for {@link getGaslessDepositPolicy}.\n */\nexport type GetGaslessDepositPolicyParameters = Compute<\n  ChainIdParameter & {\n    /** The owner wallet onboarding through gasless deposit — an owner address, never a GaslessWallet address. */\n    owner: Address;\n    /**\n     * Which of the owner's GaslessWallets receives the deposit. Defaults to\n     * `0n`, the original wallet. Each id has its own address and balance, and\n     * settling one wallet never sweeps another. Range `0n` through `2^256 - 1`.\n     */\n    walletId?: bigint;\n  }\n>;\n\n/** Return type of {@link getGaslessDepositPolicy}. Every amount is in collateral token units. */\nexport interface GetGaslessDepositPolicyReturnType {\n  /** The wallet id the policy was read for — `0n` when the parameter was omitted. */\n  walletId: bigint;\n  /** The deterministic deposit address: the GaslessWallet of `(owner, walletId)`. */\n  depositAddress: Address;\n  /** The only token the settlement sweeps — send nothing else to the address. */\n  collateralTokenAddress: Address;\n  /** The collateral token's ERC-20 `decimals()`, the scale of every amount in this policy. */\n  collateralDecimals: number;\n  /** Flat fee deducted from the observed balance at settlement (collateral token units). */\n  depositFee: bigint;\n  /** Minimum observed balance the service will settle (collateral token units). */\n  minimumDeposit: bigint;\n  /**\n   * One-time fee the settlement also deducts when it deploys this wallet\n   * (collateral token units) — `0n` once the wallet is deployed. See\n   * `getGaslessWalletCreationFee`.\n   */\n  walletCreationFee: bigint;\n  /**\n   * The smallest balance that settles: `max(minimumDeposit, depositFee +\n   * walletCreationFee + 1n)`. The GaslessLayer rejects a settlement unless the\n   * swept balance both reaches `minimumDeposit` and exceeds the deposit fee\n   * plus the creation fee. Gate the settlement UI on the observed balance\n   * reaching this.\n   */\n  settlementMinimum: bigint;\n}\n\n/**\n * Read the GaslessLayer's collateral token and that token's ERC-20\n * `decimals()`. The decimals read needs the token address, so it starts as soon\n * as the first read resolves, while the policy's other reads are still running.\n *\n * The scale comes from the token the GaslessLayer itself sweeps, not from the\n * chain config's `collateralDecimals`: every amount in this policy is a\n * GaslessLayer value, so a deployment whose gasless collateral differs from the\n * configured one must still format correctly.\n */\nasync function readCollateralToken(\n  client: PublicClient,\n  gaslessLayerAddress: Address,\n): Promise<{ address: Address; decimals: number }> {\n  const address = await client.readContract({\n    address: gaslessLayerAddress,\n    abi: gaslessLayerAbi,\n    functionName: \"collateralToken\",\n  });\n  const decimals = await client.readContract({ address, abi: erc20Abi, functionName: \"decimals\" });\n  return { address, decimals };\n}\n\n/**\n * Read the gasless **deposit policy** for one of an owner's GaslessWallets —\n * the deterministic deposit address plus the fee and minimum terms — directly\n * from the GaslessLayer.\n *\n * All values are RPC contract reads (the service exposes no read endpoints):\n * `getGaslessWalletAddress(owner, walletId)`, `collateralToken()` and the\n * token's `decimals()`, `depositFee()`, `minimumDeposit()` and\n * `getWalletCreationFee(owner, walletId)`. The deposit address is a pure\n * `CREATE2` view, so it is safe to display before any transaction; collateral\n * sent there can only ever reach a sub-account owned by `owner`. Watch the\n * address's balance with the existing collateral-balance read\n * (`getCollateralBalance`) and enable settlement once it reaches\n * `settlementMinimum`.\n *\n * The settlement sweeps the wallet's **entire** balance, so keep separate\n * wallet ids for funding flows that must not be swept together.\n *\n * @param config - The SDK config.\n * @param parameters - Owner wallet, optional wallet id (default `0n`), optional chain id.\n * @returns The deposit policy.\n * @throws {SymmError} `GASLESS_WALLET_ID_INVALID` for a wallet id outside the `uint256` range\n *   (or a JavaScript `number`), before any RPC call.\n * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION` /\n *   `GASLESS_WALLET_UNAVAILABLE`.\n *\n * @example\n * ```ts\n * const policy = await getGaslessDepositPolicy(config, { owner });\n * showDepositAddress(policy.depositAddress);\n * const minimum = formatUnits(policy.settlementMinimum, policy.collateralDecimals);\n * ```\n */\nexport async function getGaslessDepositPolicy(\n  config: Config,\n  parameters: GetGaslessDepositPolicyParameters,\n): Promise<GetGaslessDepositPolicyReturnType> {\n  const { chainId, owner } = parameters;\n  const walletId = assertGaslessWalletId(parameters.walletId ?? 0n);\n  const gasless = resolveGaslessService(config, { chainId });\n  const client = config.getClient({ chainId });\n\n  const [depositAddress, collateral, depositFee, minimumDeposit, walletCreationFee] = await Promise.all([\n    getGaslessWalletAddress(config, { chainId, owner, walletId }),\n    readCollateralToken(client, gasless.gaslessLayerAddress),\n    client.readContract({ address: gasless.gaslessLayerAddress, abi: gaslessLayerAbi, functionName: \"depositFee\" }),\n    client.readContract({ address: gasless.gaslessLayerAddress, abi: gaslessLayerAbi, functionName: \"minimumDeposit\" }),\n    getGaslessWalletCreationFee(config, { chainId, owner, walletId }),\n  ]);\n\n  /** The swept balance must reach the minimum AND exceed every fee the settlement deducts. */\n  const aboveFees = depositFee + walletCreationFee + 1n;\n  const settlementMinimum = minimumDeposit > aboveFees ? minimumDeposit : aboveFees;\n\n  return {\n    walletId,\n    depositAddress,\n    collateralTokenAddress: collateral.address,\n    collateralDecimals: collateral.decimals,\n    depositFee,\n    minimumDeposit,\n    walletCreationFee,\n    settlementMinimum,\n  };\n}\n"],"mappings":";;;;;;;AAiEA,eAAe,EACb,GACA,GACiD;CACjD,IAAM,IAAU,MAAM,EAAO,aAAa;EACxC,SAAS;EACT,KAAK;EACL,cAAc;CAChB,CAAC;CAED,OAAO;EAAE;EAAS,UAAA,MADK,EAAO,aAAa;GAAE;GAAS,KAAK;GAAU,cAAc;EAAW,CAAC;CACpE;AAC7B;AAmCA,eAAsB,EACpB,GACA,GAC4C;CAC5C,IAAM,EAAE,YAAS,aAAU,GACrB,IAAW,EAAsB,EAAW,YAAY,EAAE,GAC1D,IAAU,EAAsB,GAAQ,EAAE,WAAQ,CAAC,GACnD,IAAS,EAAO,UAAU,EAAE,WAAQ,CAAC,GAErC,CAAC,GAAgB,GAAY,GAAY,GAAgB,KAAqB,MAAM,QAAQ,IAAI;EACpG,EAAwB,GAAQ;GAAE;GAAS;GAAO;EAAS,CAAC;EAC5D,EAAoB,GAAQ,EAAQ,mBAAmB;EACvD,EAAO,aAAa;GAAE,SAAS,EAAQ;GAAqB,KAAK;GAAiB,cAAc;EAAa,CAAC;EAC9G,EAAO,aAAa;GAAE,SAAS,EAAQ;GAAqB,KAAK;GAAiB,cAAc;EAAiB,CAAC;EAClH,EAA4B,GAAQ;GAAE;GAAS;GAAO;EAAS,CAAC;CAClE,CAAC,GAGK,IAAY,IAAa,IAAoB,IAC7C,IAAoB,IAAiB,IAAY,IAAiB;CAExE,OAAO;EACL;EACA;EACA,wBAAwB,EAAW;EACnC,oBAAoB,EAAW;EAC/B;EACA;EACA;EACA;CACF;AACF"}

package/dist/gasless/get-gasless-deposit-policy/index.d.ts

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

package/dist/gasless/get-gasless-deposit-policy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-deposit-policy/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,SAAS,CAAC"}

package/dist/gasless/get-gasless-deposit-policy/query.d.ts

@@ -0,0 +1,51 @@
+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 { GetGaslessDepositPolicyParameters, GetGaslessDepositPolicyReturnType } from './get-gasless-deposit-policy.js';
+/** Data resolved by the {@link getGaslessDepositPolicyQueryOptions} query. */
+export type GetGaslessDepositPolicyData = GetGaslessDepositPolicyReturnType;
+/**
+ * Build the TanStack Query key for {@link getGaslessDepositPolicyQueryOptions}.
+ *
+ * An omitted `walletId` keys as `0n`, so `{ owner }` and `{ owner, walletId: 0n }`
+ * share one cache entry — they read the same wallet's policy. `predicateMatch`
+ * compares only the fields its partial sets, so
+ * `predicateMatch(getGaslessDepositPolicyQueryKey, { owner })` still matches every
+ * wallet id of the owner.
+ *
+ * @param options - Partial query parameters.
+ * @returns A stable, hashable query key.
+ *
+ * @example
+ * ```ts
+ * getGaslessDepositPolicyQueryKey({ owner });
+ * // → ["getGaslessDepositPolicy", { owner, walletId: "0" }]
+ * ```
+ */
+export declare function getGaslessDepositPolicyQueryKey(options?: Compute<ExactPartial<GetGaslessDepositPolicyParameters> & ConfigKeyParameter>): readonly ["getGaslessDepositPolicy", Record<string, unknown>];
+/** Query-key type produced by {@link getGaslessDepositPolicyQueryKey}. */
+export type GetGaslessDepositPolicyQueryKey = ReturnType<typeof getGaslessDepositPolicyQueryKey>;
+/**
+ * Options accepted by {@link getGaslessDepositPolicyQueryOptions}.
+ */
+export type GetGaslessDepositPolicyOptions = Compute<GetGaslessDepositPolicyParameters & QueryParameter<GetGaslessDepositPolicyData, Error, GetGaslessDepositPolicyData, GetGaslessDepositPolicyQueryKey>>;
+/** TanStack Query options returned by {@link getGaslessDepositPolicyQueryOptions}. */
+export type GetGaslessDepositPolicyQueryOptions = SymmioQueryOptions<GetGaslessDepositPolicyData, Error, GetGaslessDepositPolicyData, GetGaslessDepositPolicyQueryKey>;
+/**
+ * Build TanStack Query options for {@link getGaslessDepositPolicy}.
+ *
+ * The policy carries the wallet's creation fee, which drops to `0n` once any
+ * action deploys the wallet, so invalidate this query after a settlement or
+ * wallet operation — the React relay hooks do.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getGaslessDepositPolicyQueryOptions(config, { owner, walletId: 1n }));
+ * ```
+ */
+export declare function getGaslessDepositPolicyQueryOptions(config: Config, options: GetGaslessDepositPolicyOptions): GetGaslessDepositPolicyQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/gasless/get-gasless-deposit-policy/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-deposit-policy/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,iCAAiC,EACtC,KAAK,iCAAiC,EACvC,MAAM,8BAA8B,CAAC;AAEtC,8EAA8E;AAC9E,MAAM,MAAM,2BAA2B,GAAG,iCAAiC,CAAC;AAE5E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,OAAO,CAAC,YAAY,CAAC,iCAAiC,CAAC,GAAG,kBAAkB,CAAM,iEAG5F;AAED,0EAA0E;AAC1E,MAAM,MAAM,+BAA+B,GAAG,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEjG;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,OAAO,CAClD,iCAAiC,GAC/B,cAAc,CAAC,2BAA2B,EAAE,KAAK,EAAE,2BAA2B,EAAE,+BAA+B,CAAC,CACnH,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,mCAAmC,GAAG,kBAAkB,CAClE,2BAA2B,EAC3B,KAAK,EACL,2BAA2B,EAC3B,+BAA+B,CAChC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,8BAA8B,GACtC,mCAAmC,CAYrC"}

package/dist/gasless/get-gasless-deposit-policy/query.js

@@ -0,0 +1,25 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getGaslessDepositPolicy as t } from "./get-gasless-deposit-policy.js";
+//#region src/gasless/get-gasless-deposit-policy/query.ts
+function n(t = {}) {
+	return ["getGaslessDepositPolicy", e({
+		...t,
+		walletId: t.walletId ?? 0n
+	})];
+}
+function r(e, r) {
+	let { query: i, ...a } = r;
+	return {
+		...i,
+		queryKey: n({
+			...a,
+			configKey: e.getChainConfigKey(a.chainId)
+		}),
+		enabled: i?.enabled ?? !0,
+		queryFn: () => t(e, a)
+	};
+}
+//#endregion
+export { n as getGaslessDepositPolicyQueryKey, r as getGaslessDepositPolicyQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/gasless/get-gasless-deposit-policy/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/gasless/get-gasless-deposit-policy/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  getGaslessDepositPolicy,\n  type GetGaslessDepositPolicyParameters,\n  type GetGaslessDepositPolicyReturnType,\n} from \"./get-gasless-deposit-policy\";\n\n/** Data resolved by the {@link getGaslessDepositPolicyQueryOptions} query. */\nexport type GetGaslessDepositPolicyData = GetGaslessDepositPolicyReturnType;\n\n/**\n * Build the TanStack Query key for {@link getGaslessDepositPolicyQueryOptions}.\n *\n * An omitted `walletId` keys as `0n`, so `{ owner }` and `{ owner, walletId: 0n }`\n * share one cache entry — they read the same wallet's policy. `predicateMatch`\n * compares only the fields its partial sets, so\n * `predicateMatch(getGaslessDepositPolicyQueryKey, { owner })` still matches every\n * wallet id of the owner.\n *\n * @param options - Partial query parameters.\n * @returns A stable, hashable query key.\n *\n * @example\n * ```ts\n * getGaslessDepositPolicyQueryKey({ owner });\n * // → [\"getGaslessDepositPolicy\", { owner, walletId: \"0\" }]\n * ```\n */\nexport function getGaslessDepositPolicyQueryKey(\n  options: Compute<ExactPartial<GetGaslessDepositPolicyParameters> & ConfigKeyParameter> = {},\n) {\n  return [\"getGaslessDepositPolicy\", filterQueryOptions({ ...options, walletId: options.walletId ?? 0n })] as const;\n}\n\n/** Query-key type produced by {@link getGaslessDepositPolicyQueryKey}. */\nexport type GetGaslessDepositPolicyQueryKey = ReturnType<typeof getGaslessDepositPolicyQueryKey>;\n\n/**\n * Options accepted by {@link getGaslessDepositPolicyQueryOptions}.\n */\nexport type GetGaslessDepositPolicyOptions = Compute<\n  GetGaslessDepositPolicyParameters &\n    QueryParameter<GetGaslessDepositPolicyData, Error, GetGaslessDepositPolicyData, GetGaslessDepositPolicyQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getGaslessDepositPolicyQueryOptions}. */\nexport type GetGaslessDepositPolicyQueryOptions = SymmioQueryOptions<\n  GetGaslessDepositPolicyData,\n  Error,\n  GetGaslessDepositPolicyData,\n  GetGaslessDepositPolicyQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getGaslessDepositPolicy}.\n *\n * The policy carries the wallet's creation fee, which drops to `0n` once any\n * action deploys the wallet, so invalidate this query after a settlement or\n * wallet operation — the React relay hooks do.\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(getGaslessDepositPolicyQueryOptions(config, { owner, walletId: 1n }));\n * ```\n */\nexport function getGaslessDepositPolicyQueryOptions(\n  config: Config,\n  options: GetGaslessDepositPolicyOptions,\n): GetGaslessDepositPolicyQueryOptions {\n  /** Every parameter reaches the action: a hand-listed subset would silently drop a new one, such as `walletId`. */\n  const { query, ...parameters } = options;\n  return {\n    ...query,\n    queryKey: getGaslessDepositPolicyQueryKey({\n      ...parameters,\n      configKey: config.getChainConfigKey(parameters.chainId),\n    }),\n    enabled: query?.enabled ?? true,\n    queryFn: () => getGaslessDepositPolicy(config, parameters),\n  };\n}\n"],"mappings":";;;AA+BA,SAAgB,EACd,IAAyF,CAAC,GAC1F;CACA,OAAO,CAAC,2BAA2B,EAAmB;EAAE,GAAG;EAAS,UAAU,EAAQ,YAAY;CAAG,CAAC,CAAC;AACzG;AAqCA,SAAgB,EACd,GACA,GACqC;CAErC,IAAM,EAAE,UAAO,GAAG,MAAe;CACjC,OAAO;EACL,GAAG;EACH,UAAU,EAAgC;GACxC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAW,OAAO;EACxD,CAAC;EACD,SAAS,GAAO,WAAW;EAC3B,eAAe,EAAwB,GAAQ,CAAU;CAC3D;AACF"}

package/dist/gasless/get-gasless-fee-quote/encode-relay-batch-call-data.d.ts

@@ -0,0 +1,27 @@
+import { Hex } from 'viem';
+import { SignedOperation } from '../../solvers/instant-open/shared/types.js';
+/**
+ * Stand-in for an operation signature: 65 zero bytes, the length of a real
+ * ECDSA signature. `previewFeeQuote` decodes the signatures array but never
+ * verifies it, so a quote needs no signature prompt.
+ */
+export declare const GASLESS_FEE_QUOTE_PLACEHOLDER_SIGNATURE: Hex;
+/** Input of {@link encodeRelayBatchCallData}. */
+export interface EncodeRelayBatchCallDataParameters {
+    /** The operations, in relay order. */
+    operations: readonly SignedOperation[];
+    /** One wallet id per operation, aligned with `operations`. */
+    walletIds: readonly bigint[];
+}
+/**
+ * Encode the `relayInstantBatch(signedOps, signatures, fills, flexFillerSignatures, walletIds)`
+ * calldata a fee quote previews — the same call the relayer submits, with
+ * placeholder signatures and no flex fills, neither of which affects the price.
+ *
+ * @param parameters - Operations and their aligned wallet ids.
+ * @returns ABI-encoded GaslessLayer calldata.
+ *
+ * @internal
+ */
+export declare function encodeRelayBatchCallData(parameters: EncodeRelayBatchCallDataParameters): Hex;
+//# sourceMappingURL=encode-relay-batch-call-data.d.ts.map

package/dist/gasless/get-gasless-fee-quote/encode-relay-batch-call-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-relay-batch-call-data.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-fee-quote/encode-relay-batch-call-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAG/E;;;;GAIG;AACH,eAAO,MAAM,uCAAuC,EAAE,GAA6B,CAAC;AAEpF,iDAAiD;AACjD,MAAM,WAAW,kCAAkC;IACjD,sCAAsC;IACtC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IACvC,8DAA8D;IAC9D,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,kCAAkC,GAAG,GAAG,CAa5F"}

package/dist/gasless/get-gasless-fee-quote/encode-relay-batch-call-data.js

@@ -0,0 +1,22 @@
+import { gaslessLayerAbi as e } from "../../symmio-contracts/abi/v0.8.6/gasless-layer.js";
+import { encodeFunctionData as t, pad as n } from "viem";
+//#region src/gasless/get-gasless-fee-quote/encode-relay-batch-call-data.ts
+var r = n("0x", { size: 65 });
+function i(n) {
+	let { operations: i, walletIds: a } = n;
+	return t({
+		abi: e,
+		functionName: "relayInstantBatch",
+		args: [
+			i,
+			i.map(() => r),
+			i.map(() => []),
+			i.map(() => []),
+			a
+		]
+	});
+}
+//#endregion
+export { i as encodeRelayBatchCallData };
+
+//# sourceMappingURL=encode-relay-batch-call-data.js.map

package/dist/gasless/get-gasless-fee-quote/encode-relay-batch-call-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-relay-batch-call-data.js","names":[],"sources":["../../../src/gasless/get-gasless-fee-quote/encode-relay-batch-call-data.ts"],"sourcesContent":["import { encodeFunctionData, pad, type Hex } from \"viem\";\nimport type { SignedOperation } from \"../../solvers/instant-open/shared/types\";\nimport { gaslessLayerAbi } from \"../../symmio-contracts/abi/v0.8.6/gasless-layer\";\n\n/**\n * Stand-in for an operation signature: 65 zero bytes, the length of a real\n * ECDSA signature. `previewFeeQuote` decodes the signatures array but never\n * verifies it, so a quote needs no signature prompt.\n */\nexport const GASLESS_FEE_QUOTE_PLACEHOLDER_SIGNATURE: Hex = pad(\"0x\", { size: 65 });\n\n/** Input of {@link encodeRelayBatchCallData}. */\nexport interface EncodeRelayBatchCallDataParameters {\n  /** The operations, in relay order. */\n  operations: readonly SignedOperation[];\n  /** One wallet id per operation, aligned with `operations`. */\n  walletIds: readonly bigint[];\n}\n\n/**\n * Encode the `relayInstantBatch(signedOps, signatures, fills, flexFillerSignatures, walletIds)`\n * calldata a fee quote previews — the same call the relayer submits, with\n * placeholder signatures and no flex fills, neither of which affects the price.\n *\n * @param parameters - Operations and their aligned wallet ids.\n * @returns ABI-encoded GaslessLayer calldata.\n *\n * @internal\n */\nexport function encodeRelayBatchCallData(parameters: EncodeRelayBatchCallDataParameters): Hex {\n  const { operations, walletIds } = parameters;\n  return encodeFunctionData({\n    abi: gaslessLayerAbi,\n    functionName: \"relayInstantBatch\",\n    args: [\n      operations,\n      operations.map(() => GASLESS_FEE_QUOTE_PLACEHOLDER_SIGNATURE),\n      operations.map(() => []),\n      operations.map(() => []),\n      walletIds,\n    ],\n  });\n}\n"],"mappings":";;;AASA,IAAa,IAA+C,EAAI,MAAM,EAAE,MAAM,GAAG,CAAC;AAoBlF,SAAgB,EAAyB,GAAqD;CAC5F,IAAM,EAAE,eAAY,iBAAc;CAClC,OAAO,EAAmB;EACxB,KAAK;EACL,cAAc;EACd,MAAM;GACJ;GACA,EAAW,UAAU,CAAuC;GAC5D,EAAW,UAAU,CAAC,CAAC;GACvB,EAAW,UAAU,CAAC,CAAC;GACvB;EACF;CACF,CAAC;AACH"}

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

@@ -0,0 +1,61 @@
+import { Address, PublicClient } from 'viem';
+/** Input of {@link resolveGaslessFeeQuoteError}. @internal */
+export interface ResolveGaslessFeeQuoteErrorParameters {
+    /** The public client the failed quote was read with. */
+    client: PublicClient;
+    /** The quoted GaslessLayer. */
+    gaslessLayerAddress: Address;
+}
+/**
+ * Map a failed `previewFeeQuote` read onto the SDK's typed errors.
+ *
+ * - A `DailyFreeOpsLimitExceeded` revert → `GASLESS_FREE_QUOTA_EXHAUSTED`.
+ * - Any other revert that carries data → `GASLESS_FEE_QUOTE_REVERTED`: the
+ *   contract refused the batch itself (a mismatched wallet target, an empty or
+ *   misaligned batch), so re-signing the same input cannot help.
+ * - A call that returned nothing → `GASLESS_LAYER_INTERFACE_UNSUPPORTED`: no
+ *   code at the configured address answers `previewFeeQuote`.
+ * - A revert with **empty** data is ambiguous. A GaslessLayer proxy that
+ *   predates the multi-wallet interface answers every `previewFeeQuote` this
+ *   way, but the multi-wallet GaslessLayer does too when it cannot ABI-decode
+ *   the batch (malformed wallet `execute` calldata, for example). One more read
+ *   quotes empty calldata to tell them apart (see
+ *   `implementsPreviewFeeQuote`): revert data there means the interface exists
+ *   and the batch is at fault → `GASLESS_FEE_QUOTE_REVERTED`; empty data or no
+ *   data again → `GASLESS_LAYER_INTERFACE_UNSUPPORTED`. When that check is
+ *   inconclusive, `err` is returned unchanged.
+ * - Anything else (transport, rate limit, node error without revert data) is
+ *   returned unchanged — it says nothing about the batch.
+ *
+ * @param err - The error `readContract` threw.
+ * @param parameters - The client for the empty-revert check, and the quoted GaslessLayer.
+ * @returns The typed error to throw, or `err` itself.
+ *
+ * @internal
+ */
+export declare function resolveGaslessFeeQuoteError(err: unknown, parameters: ResolveGaslessFeeQuoteErrorParameters): Promise<unknown>;
+/**
+ * Whether an error means the billing account's **daily free-operations quota is
+ * exhausted** and the GaslessLayer refuses paid operations until the UTC reset.
+ *
+ * Matches the `GASLESS_FREE_QUOTA_EXHAUSTED` error {@link getGaslessFeeQuote}
+ * throws (also after a framework layer re-wraps it, e.g. React's
+ * `SymmioRequestError`), and a raw viem revert carrying `DailyFreeOpsLimitExceeded`
+ * from a direct GaslessLayer call. For the relay service's own HTTP rejections,
+ * use `isConfirmedGaslessFeeLimitError`.
+ *
+ * @param err - Anything caught from a fee quote or a GaslessLayer call.
+ * @returns `true` when the free quota blocks the batch.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await getGaslessFeeQuote(config, { operations });
+ * } catch (err) {
+ *   if (isGaslessFreeQuotaExhaustedError(err)) showQuotaResetNotice();
+ *   else throw err;
+ * }
+ * ```
+ */
+export declare function isGaslessFreeQuotaExhaustedError(err: unknown): boolean;
+//# sourceMappingURL=fee-quote-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fee-quote-errors.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-fee-quote/fee-quote-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,OAAO,EAGZ,KAAK,YAAY,EAClB,MAAM,MAAM,CAAC;AA6Ed,8DAA8D;AAC9D,MAAM,WAAW,qCAAqC;IACpD,wDAAwD;IACxD,MAAM,EAAE,YAAY,CAAC;IACrB,+BAA+B;IAC/B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,qCAAqC,GAChD,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAItE"}

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

@@ -0,0 +1,59 @@
+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 { BaseError as n, ContractFunctionRevertedError as r, ContractFunctionZeroDataError as i } from "viem";
+//#region src/gasless/get-gasless-fee-quote/fee-quote-errors.ts
+var a = "DailyFreeOpsLimitExceeded", o = "GASLESS_FREE_QUOTA_EXHAUSTED";
+function s(e) {
+	return typeof e == "bigint" ? e.toString() : String(e);
+}
+function c(e) {
+	if (!(e instanceof n)) return { type: "inconclusive" };
+	if (e.walk((e) => e instanceof i)) return { type: "no-data" };
+	let t = e.walk((e) => e instanceof r);
+	return !(t instanceof r) || t.raw === void 0 ? { type: "inconclusive" } : {
+		type: "revert",
+		revert: t,
+		data: t.raw
+	};
+}
+async function l(t, n) {
+	try {
+		await t.readContract({
+			address: n,
+			abi: e,
+			functionName: "previewFeeQuote",
+			args: ["0x", 0n]
+		});
+	} catch (e) {
+		let t = c(e);
+		if (t.type === "no-data") return !1;
+		if (t.type === "revert") return t.data !== "0x";
+	}
+}
+function u(e, n) {
+	return new t("config", "GASLESS_LAYER_INTERFACE_UNSUPPORTED", `Gasless: the GaslessLayer at ${n} does not implement previewFeeQuote — it predates the multi-wallet interface this SDK targets, or is not a GaslessLayer. Point gaslessLayerAddress at an upgraded deployment.`, { cause: e });
+}
+async function d(e, n) {
+	let { client: r, gaslessLayerAddress: i } = n, d = c(e);
+	if (d.type === "inconclusive") return e;
+	if (d.type === "no-data") return u(e, i);
+	if (d.data === "0x") {
+		let n = await l(r, i);
+		return n === void 0 ? e : n ? new t("validation", "GASLESS_FEE_QUOTE_REVERTED", `Gasless: the GaslessLayer fee quote reverted with empty revert data. The GaslessLayer at ${i} implements previewFeeQuote, so it could not process this batch — typically calldata it cannot ABI-decode, such as malformed wallet execute arguments. The relay would revert the same way.`, { cause: e }) : u(e, i);
+	}
+	let { revert: f } = d, p = f.data?.errorName;
+	if (p === a) {
+		let [n, r] = f.data?.args ?? [];
+		return new t("api", o, `Gasless: billing account ${s(n)} has used its daily free-operations quota (${s(r)}), and this GaslessLayer refuses paid operations once it is spent. Retry after the UTC reset or use the wallet path.`, { cause: e });
+	}
+	return new t("validation", "GASLESS_FEE_QUOTE_REVERTED", `Gasless: the GaslessLayer fee quote reverted with ${p ? `${p}(${(f.data?.args ?? []).map(s).join(", ")})` : `unknown error ${f.signature ?? d.data.slice(0, 10)}`}. The batch itself is invalid — the relay would revert the same way.`, { cause: e });
+}
+function f(e) {
+	if (typeof e == "object" && e && "code" in e && e.code === o) return !0;
+	let t = c(e);
+	return t.type === "revert" && t.revert.data?.errorName === a;
+}
+//#endregion
+export { f as isGaslessFreeQuotaExhaustedError, d as resolveGaslessFeeQuoteError };
+
+//# sourceMappingURL=fee-quote-errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fee-quote-errors.js","names":[],"sources":["../../../src/gasless/get-gasless-fee-quote/fee-quote-errors.ts"],"sourcesContent":["import {\n  BaseError,\n  ContractFunctionRevertedError,\n  ContractFunctionZeroDataError,\n  type Address,\n  type ContractErrorName,\n  type Hex,\n  type PublicClient,\n} from \"viem\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport { gaslessLayerAbi } from \"../../symmio-contracts/abi/v0.8.6/gasless-layer\";\n\n/** The custom error the GaslessLayer reverts with once a billing account's daily free quota is spent. */\nconst FREE_QUOTA_EXHAUSTED_ERROR = \"DailyFreeOpsLimitExceeded\" satisfies ContractErrorName<typeof gaslessLayerAbi>;\n\n/** Error code of a quote refused because the daily free-operations quota is exhausted. */\nconst FREE_QUOTA_EXHAUSTED_CODE = \"GASLESS_FREE_QUOTA_EXHAUSTED\";\n\n/** What reached the client when a contract read failed. */\ntype ReadFailure =\n  | { type: \"no-data\" }\n  | { type: \"revert\"; revert: ContractFunctionRevertedError; data: Hex }\n  | { type: \"inconclusive\" };\n\nfunction formatRevertArgument(value: unknown): string {\n  return typeof value === \"bigint\" ? value.toString() : String(value);\n}\n\n/**\n * Classify a failed contract read by what reached the client.\n *\n * - `no-data`: the call returned nothing, so no code answers the function (an\n *   address without code, for example).\n * - `revert`: the call reverted; `data` is the revert data, `\"0x\"` when empty.\n * - `inconclusive`: no revert data arrived at all (a transport failure, a rate\n *   limit, a node error), which says nothing about the contract.\n */\nfunction classifyReadFailure(err: unknown): ReadFailure {\n  if (!(err instanceof BaseError)) return { type: \"inconclusive\" };\n  if (err.walk((cause) => cause instanceof ContractFunctionZeroDataError)) return { type: \"no-data\" };\n  const revert = err.walk((cause) => cause instanceof ContractFunctionRevertedError);\n  if (!(revert instanceof ContractFunctionRevertedError) || revert.raw === undefined) return { type: \"inconclusive\" };\n  return { type: \"revert\", revert, data: revert.raw };\n}\n\n/**\n * Whether the GaslessLayer at `gaslessLayerAddress` implements `previewFeeQuote`,\n * decided by quoting empty calldata. The multi-wallet GaslessLayer checks the\n * selector before anything else and rejects it with revert data\n * (`UnsupportedFeeQuoteCall(0x00000000)`). A proxy whose implementation predates\n * the function reverts with empty data again, and an address without code\n * returns nothing.\n *\n * @returns `true` or `false` on that evidence, or `undefined` when the check is\n *   inconclusive: it failed for transport reasons, or it answered calldata every\n *   GaslessLayer rejects.\n */\nasync function implementsPreviewFeeQuote(\n  client: PublicClient,\n  gaslessLayerAddress: Address,\n): Promise<boolean | undefined> {\n  try {\n    await client.readContract({\n      address: gaslessLayerAddress,\n      abi: gaslessLayerAbi,\n      functionName: \"previewFeeQuote\",\n      args: [\"0x\", 0n],\n    });\n  } catch (err) {\n    const failure = classifyReadFailure(err);\n    if (failure.type === \"no-data\") return false;\n    if (failure.type === \"revert\") return failure.data !== \"0x\";\n  }\n  return undefined;\n}\n\nfunction interfaceUnsupportedError(err: unknown, gaslessLayerAddress: Address): SymmError {\n  return new SymmError(\n    \"config\",\n    \"GASLESS_LAYER_INTERFACE_UNSUPPORTED\",\n    `Gasless: the GaslessLayer at ${gaslessLayerAddress} does not implement previewFeeQuote — it predates the multi-wallet interface this SDK targets, or is not a GaslessLayer. Point gaslessLayerAddress at an upgraded deployment.`,\n    { cause: err },\n  );\n}\n\n/** Input of {@link resolveGaslessFeeQuoteError}. @internal */\nexport interface ResolveGaslessFeeQuoteErrorParameters {\n  /** The public client the failed quote was read with. */\n  client: PublicClient;\n  /** The quoted GaslessLayer. */\n  gaslessLayerAddress: Address;\n}\n\n/**\n * Map a failed `previewFeeQuote` read onto the SDK's typed errors.\n *\n * - A `DailyFreeOpsLimitExceeded` revert → `GASLESS_FREE_QUOTA_EXHAUSTED`.\n * - Any other revert that carries data → `GASLESS_FEE_QUOTE_REVERTED`: the\n *   contract refused the batch itself (a mismatched wallet target, an empty or\n *   misaligned batch), so re-signing the same input cannot help.\n * - A call that returned nothing → `GASLESS_LAYER_INTERFACE_UNSUPPORTED`: no\n *   code at the configured address answers `previewFeeQuote`.\n * - A revert with **empty** data is ambiguous. A GaslessLayer proxy that\n *   predates the multi-wallet interface answers every `previewFeeQuote` this\n *   way, but the multi-wallet GaslessLayer does too when it cannot ABI-decode\n *   the batch (malformed wallet `execute` calldata, for example). One more read\n *   quotes empty calldata to tell them apart (see\n *   `implementsPreviewFeeQuote`): revert data there means the interface exists\n *   and the batch is at fault → `GASLESS_FEE_QUOTE_REVERTED`; empty data or no\n *   data again → `GASLESS_LAYER_INTERFACE_UNSUPPORTED`. When that check is\n *   inconclusive, `err` is returned unchanged.\n * - Anything else (transport, rate limit, node error without revert data) is\n *   returned unchanged — it says nothing about the batch.\n *\n * @param err - The error `readContract` threw.\n * @param parameters - The client for the empty-revert check, and the quoted GaslessLayer.\n * @returns The typed error to throw, or `err` itself.\n *\n * @internal\n */\nexport async function resolveGaslessFeeQuoteError(\n  err: unknown,\n  parameters: ResolveGaslessFeeQuoteErrorParameters,\n): Promise<unknown> {\n  const { client, gaslessLayerAddress } = parameters;\n  const failure = classifyReadFailure(err);\n  if (failure.type === \"inconclusive\") return err;\n  if (failure.type === \"no-data\") return interfaceUnsupportedError(err, gaslessLayerAddress);\n\n  if (failure.data === \"0x\") {\n    const implemented = await implementsPreviewFeeQuote(client, gaslessLayerAddress);\n    if (implemented === undefined) return err;\n    if (!implemented) return interfaceUnsupportedError(err, gaslessLayerAddress);\n    return new SymmError(\n      \"validation\",\n      \"GASLESS_FEE_QUOTE_REVERTED\",\n      `Gasless: the GaslessLayer fee quote reverted with empty revert data. The GaslessLayer at ${gaslessLayerAddress} implements previewFeeQuote, so it could not process this batch — typically calldata it cannot ABI-decode, such as malformed wallet execute arguments. The relay would revert the same way.`,\n      { cause: err },\n    );\n  }\n\n  const { revert } = failure;\n  const errorName = revert.data?.errorName;\n  if (errorName === FREE_QUOTA_EXHAUSTED_ERROR) {\n    const [account, limit] = revert.data?.args ?? [];\n    return new SymmError(\n      \"api\",\n      FREE_QUOTA_EXHAUSTED_CODE,\n      `Gasless: billing account ${formatRevertArgument(account)} has used its daily free-operations quota (${formatRevertArgument(limit)}), and this GaslessLayer refuses paid operations once it is spent. Retry after the UTC reset or use the wallet path.`,\n      { cause: err },\n    );\n  }\n\n  const described = errorName\n    ? `${errorName}(${(revert.data?.args ?? []).map(formatRevertArgument).join(\", \")})`\n    : `unknown error ${revert.signature ?? failure.data.slice(0, 10)}`;\n  return new SymmError(\n    \"validation\",\n    \"GASLESS_FEE_QUOTE_REVERTED\",\n    `Gasless: the GaslessLayer fee quote reverted with ${described}. The batch itself is invalid — the relay would revert the same way.`,\n    { cause: err },\n  );\n}\n\n/**\n * Whether an error means the billing account's **daily free-operations quota is\n * exhausted** and the GaslessLayer refuses paid operations until the UTC reset.\n *\n * Matches the `GASLESS_FREE_QUOTA_EXHAUSTED` error {@link getGaslessFeeQuote}\n * throws (also after a framework layer re-wraps it, e.g. React's\n * `SymmioRequestError`), and a raw viem revert carrying `DailyFreeOpsLimitExceeded`\n * from a direct GaslessLayer call. For the relay service's own HTTP rejections,\n * use `isConfirmedGaslessFeeLimitError`.\n *\n * @param err - Anything caught from a fee quote or a GaslessLayer call.\n * @returns `true` when the free quota blocks the batch.\n *\n * @example\n * ```ts\n * try {\n *   await getGaslessFeeQuote(config, { operations });\n * } catch (err) {\n *   if (isGaslessFreeQuotaExhaustedError(err)) showQuotaResetNotice();\n *   else throw err;\n * }\n * ```\n */\nexport function isGaslessFreeQuotaExhaustedError(err: unknown): boolean {\n  if (typeof err === \"object\" && err !== null && \"code\" in err && err.code === FREE_QUOTA_EXHAUSTED_CODE) return true;\n  const failure = classifyReadFailure(err);\n  return failure.type === \"revert\" && failure.revert.data?.errorName === FREE_QUOTA_EXHAUSTED_ERROR;\n}\n"],"mappings":";;;;AAaA,IAAM,IAA6B,6BAG7B,IAA4B;AAQlC,SAAS,EAAqB,GAAwB;CACpD,OAAO,OAAO,KAAU,WAAW,EAAM,SAAS,IAAI,OAAO,CAAK;AACpE;AAWA,SAAS,EAAoB,GAA2B;CACtD,IAAI,EAAE,aAAe,IAAY,OAAO,EAAE,MAAM,eAAe;CAC/D,IAAI,EAAI,MAAM,MAAU,aAAiB,CAA6B,GAAG,OAAO,EAAE,MAAM,UAAU;CAClG,IAAM,IAAS,EAAI,MAAM,MAAU,aAAiB,CAA6B;CAEjF,OADI,EAAE,aAAkB,MAAkC,EAAO,QAAQ,KAAA,IAAkB,EAAE,MAAM,eAAe,IAC3G;EAAE,MAAM;EAAU;EAAQ,MAAM,EAAO;CAAI;AACpD;AAcA,eAAe,EACb,GACA,GAC8B;CAC9B,IAAI;EACF,MAAM,EAAO,aAAa;GACxB,SAAS;GACT,KAAK;GACL,cAAc;GACd,MAAM,CAAC,MAAM,EAAE;EACjB,CAAC;CACH,SAAS,GAAK;EACZ,IAAM,IAAU,EAAoB,CAAG;EACvC,IAAI,EAAQ,SAAS,WAAW,OAAO;EACvC,IAAI,EAAQ,SAAS,UAAU,OAAO,EAAQ,SAAS;CACzD;AAEF;AAEA,SAAS,EAA0B,GAAc,GAAyC;CACxF,OAAO,IAAI,EACT,UACA,uCACA,gCAAgC,EAAoB,gLACpD,EAAE,OAAO,EAAI,CACf;AACF;AAqCA,eAAsB,EACpB,GACA,GACkB;CAClB,IAAM,EAAE,WAAQ,2BAAwB,GAClC,IAAU,EAAoB,CAAG;CACvC,IAAI,EAAQ,SAAS,gBAAgB,OAAO;CAC5C,IAAI,EAAQ,SAAS,WAAW,OAAO,EAA0B,GAAK,CAAmB;CAEzF,IAAI,EAAQ,SAAS,MAAM;EACzB,IAAM,IAAc,MAAM,EAA0B,GAAQ,CAAmB;EAG/E,OAFI,MAAgB,KAAA,IAAkB,IACjC,IACE,IAAI,EACT,cACA,8BACA,4FAA4F,EAAoB,8LAChH,EAAE,OAAO,EAAI,CACf,IANyB,EAA0B,GAAK,CAAmB;CAO7E;CAEA,IAAM,EAAE,cAAW,GACb,IAAY,EAAO,MAAM;CAC/B,IAAI,MAAc,GAA4B;EAC5C,IAAM,CAAC,GAAS,KAAS,EAAO,MAAM,QAAQ,CAAC;EAC/C,OAAO,IAAI,EACT,OACA,GACA,4BAA4B,EAAqB,CAAO,EAAE,6CAA6C,EAAqB,CAAK,EAAE,uHACnI,EAAE,OAAO,EAAI,CACf;CACF;CAKA,OAAO,IAAI,EACT,cACA,8BACA,qDANgB,IACd,GAAG,EAAU,IAAI,EAAO,MAAM,QAAQ,CAAC,GAAG,IAAI,CAAoB,EAAE,KAAK,IAAI,EAAE,KAC/E,iBAAiB,EAAO,aAAa,EAAQ,KAAK,MAAM,GAAG,EAAE,IAIA,uEAC/D,EAAE,OAAO,EAAI,CACf;AACF;AAyBA,SAAgB,EAAiC,GAAuB;CACtE,IAAI,OAAO,KAAQ,YAAY,KAAgB,UAAU,KAAO,EAAI,SAAS,GAA2B,OAAO;CAC/G,IAAM,IAAU,EAAoB,CAAG;CACvC,OAAO,EAAQ,SAAS,YAAY,EAAQ,OAAO,MAAM,cAAc;AACzE"}

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

@@ -0,0 +1,79 @@
+import { Config } from '../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+import { SignedOperation } from '../../solvers/instant-open/shared/types.js';
+import { GaslessFeeQuote } from '../types.js';
+/** One operation of a batch to quote, with the GaslessWallet it runs against. */
+export interface GaslessFeeQuoteOperation {
+    /**
+     * The exact operation about to be relayed — final calldata, signer account
+     * and replay header. No signature is needed: the quote never verifies one.
+     */
+    operation: SignedOperation;
+    /**
+     * The GaslessWallet id the operation is relayed with. Omit (or pass `0n`) for
+     * ordinary InstantLayer operations, delegation grants, and wallet-zero
+     * operations; pass the wallet's id for an operation that executes from a
+     * positive-id wallet. Range `0n` through `2^256 - 1`.
+     */
+    walletId?: bigint;
+}
+/**
+ * Parameters for {@link getGaslessFeeQuote}.
+ */
+export type GetGaslessFeeQuoteParameters = Compute<ChainIdParameter & {
+    /**
+     * The full batch, in relay order. Quote the whole batch rather than one
+     * operation at a time: free-quota slots and first-use wallet creation fees
+     * are allocated across the batch.
+     */
+    operations: readonly GaslessFeeQuoteOperation[];
+}>;
+/** Return type of {@link getGaslessFeeQuote}. */
+export type GetGaslessFeeQuoteReturnType = GaslessFeeQuote;
+/**
+ * Quote what the GaslessLayer would charge to relay a batch — **before** asking
+ * the user to sign anything.
+ *
+ * Encodes the batch as the `relayInstantBatch` call the relayer submits (with
+ * placeholder signatures) and reads `previewFeeQuote(callData, 0)`. The quote
+ * applies selector fees, payer multipliers, the daily free quota, and the
+ * one-time creation fee of every undeployed GaslessWallet the batch executes
+ * from — any wallet id, wallet `0` included — and prices a wallet operation by
+ * its inner call selectors. Every amount is 18-decimal.
+ *
+ * It is a preview, not a guarantee: `exact` is always `false`, the charge and its
+ * payer can change before execution, and the relayer's own simulation is
+ * authoritative. The quote does not check that the payer can afford it.
+ *
+ * Requires a multi-wallet GaslessLayer; a deployment that predates it throws
+ * `GASLESS_LAYER_INTERFACE_UNSUPPORTED`. When the quote reverts with empty data,
+ * one more read (quoting empty calldata) tells such a deployment apart from a
+ * batch the GaslessLayer cannot decode.
+ *
+ * @param config - The SDK config.
+ * @param parameters - The batch to quote and an optional chain id.
+ * @returns The fee quote.
+ * @throws {SymmError} `GASLESS_EMPTY_BATCH` for an empty batch, or `GASLESS_WALLET_ID_INVALID`
+ *   for a wallet id outside the `uint256` range — both before any RPC call.
+ * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`.
+ * @throws {SymmError} `GASLESS_FREE_QUOTA_EXHAUSTED` when a billing account's daily free
+ *   quota is spent and the GaslessLayer refuses paid operations (see
+ *   {@link isGaslessFreeQuotaExhaustedError}).
+ * @throws {SymmError} `GASLESS_FEE_QUOTE_REVERTED` when the contract rejects the batch
+ *   (e.g. a wallet operation whose target is not the wallet of its id) or cannot
+ *   decode it (malformed wallet `execute` calldata, which reverts with empty data).
+ * @throws {SymmError} `GASLESS_LAYER_INTERFACE_UNSUPPORTED` when the configured address
+ *   has no `previewFeeQuote`.
+ * @throws Viem transport errors, unchanged — and the original viem revert, unchanged,
+ *   when an empty-data revert cannot be classified because the follow-up read failed.
+ *
+ * @example
+ * ```ts
+ * const quote = await getGaslessFeeQuote(config, {
+ *   operations: [{ operation }, { operation: walletOperation, walletId: 2n }],
+ * });
+ * const fee = quote.totalFee18; // 18-decimal
+ * ```
+ */
+export declare function getGaslessFeeQuote(config: Config, parameters: GetGaslessFeeQuoteParameters): Promise<GetGaslessFeeQuoteReturnType>;
+//# sourceMappingURL=get-gasless-fee-quote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-gasless-fee-quote.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-fee-quote/get-gasless-fee-quote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAG/E,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,UAAU,CAAC;AAKlE,iFAAiF;AACjF,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,SAAS,EAAE,eAAe,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAChD,gBAAgB,GAAG;IACjB;;;;OAIG;IACH,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACjD,CACF,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG,eAAe,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,4BAA4B,GACvC,OAAO,CAAC,4BAA4B,CAAC,CAiDvC"}