@symmio/trading-react 3.0.0 → 3.1.0

package/dist/gasless/invalidate-relay-reads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidate-relay-reads.js","names":[],"sources":["../../src/gasless/invalidate-relay-reads.ts"],"sourcesContent":["import {\n  accountLayerAbi,\n  getCollateralAllowanceQueryKey,\n  getCollateralBalanceQueryKey,\n  getDelegationExpiryQueryKey,\n  getGaslessBatchSelectors,\n  getGaslessDepositPolicyQueryKey,\n  getGaslessWalletCreationFeeQueryKey,\n  getGaslessWalletNonceQueryKey,\n  getInstantLayerNonceQueryKey,\n  getIsDelegationActiveQueryKey,\n  getLastWithdrawRequestIdQueryKey,\n  getOperationalFeeAllowanceQueryKey,\n  getPartyAOpenPositionsQueryKey,\n  getPartyAPendingQuotesQueryKey,\n  getPendingQuotesQueryKey,\n  getPendingWithdrawRequestsQueryKey,\n  getQuotePendingFundingQueryKey,\n  getQuoteQueryKey,\n  getSubAccountQueryKey,\n  getSubAccountsCountOfUserQueryKey,\n  getUserSubAccountsAddressesQueryKey,\n  getUserSubAccountsQueryKey,\n  getWithdrawRequestsQueryKey,\n  getWithdrawableTimeQueryKey,\n  instantLayerAbi,\n  symmioAbi,\n  type GaslessBatchCall,\n} from \"@symmio/trading-core\";\nimport type { QueryClient } from \"@tanstack/react-query\";\nimport { isAddress, toFunctionSelector, type Abi, type AbiFunction, type Address, type Hex } from \"viem\";\nimport { invalidateAccountBalances } from \"../utils/invalidate-account-balances\";\nimport { predicateMatch } from \"../utils/predicate-match\";\n\n/** Chain-config fingerprint every invalidation is scoped by. */\ninterface Scope {\n  configKey?: string;\n}\n\n/**\n * The GaslessWallet a relayed action touched, as far as its variables say.\n * Every omitted field matches all of its values — a superset is correct, a\n * silent no-op is not.\n */\ninterface GaslessWalletScope {\n  /** The wallet's owner. */\n  owner?: Address;\n  /**\n   * The wallet's id. `useGaslessWalletExecute` forwards its variables whole, so\n   * its `walletId` narrows the invalidation on its own; the settlement hooks\n   * take theirs from the acceptance receipt, which is the id the service\n   * actually settled. Omitted, every id of the owner matches.\n   */\n  walletId?: bigint;\n}\n\n/**\n * Invalidate what every relayed action changes, whatever the action was.\n *\n * Two facts hold for all of them, because they are properties of the transport\n * rather than of the operation: the GaslessLayer deducts the operational fee\n * from SYMMIO collateral, and it deducts it from an allowance. So balances and\n * the payer's allowance are always stale afterwards.\n *\n * @param queryClient - The active TanStack query client.\n * @param scope - The chain-config fingerprint.\n * @param payer - The sub-account charged, when known; omitted invalidates every payer on the chain.\n *\n * @internal\n */\nfunction invalidateRelayTransportReads(queryClient: QueryClient, scope: Scope, payer?: Address): void {\n  invalidateAccountBalances(queryClient, scope);\n  void queryClient.invalidateQueries({\n    predicate: predicateMatch(getOperationalFeeAllowanceQueryKey, { ...scope, payer }),\n  });\n}\n\n/**\n * Invalidate the reads that change when a GaslessWallet is deployed.\n *\n * A wallet deploys lazily, on the first settlement or wallet operation that\n * uses it, and from then on its creation fee reads `0n` — which also lowers the\n * deposit policy's `settlementMinimum`. Whether this action was the one that\n * deployed it is unknowable from its variables, so both reads are invalidated\n * after every such action.\n *\n * @internal\n */\nfunction invalidateGaslessWalletDeploymentReads(\n  queryClient: QueryClient,\n  scope: Scope,\n  wallet: GaslessWalletScope,\n): void {\n  const match = { ...scope, owner: wallet.owner, walletId: wallet.walletId };\n  void queryClient.invalidateQueries({ predicate: predicateMatch(getGaslessDepositPolicyQueryKey, match) });\n  void queryClient.invalidateQueries({ predicate: predicateMatch(getGaslessWalletCreationFeeQueryKey, match) });\n}\n\n/**\n * Invalidate the reads a relayed InstantLayer batch changed.\n *\n * Only transport-level facts: `operationType` is a free-form label the fee\n * policy ignores, so the SDK cannot know which domain reads a batch touched and\n * must not guess. Callers who know the operation pass their own `onSuccess` to\n * `mutate`, which now runs after confirmation.\n *\n * @internal\n */\nexport function invalidateRelayInstantOperationsReads(\n  queryClient: QueryClient,\n  scope: Scope,\n  signerAccounts: readonly Address[],\n): void {\n  const accounts = [...new Set(signerAccounts)];\n  for (const account of accounts) {\n    void queryClient.invalidateQueries({\n      predicate: predicateMatch(getInstantLayerNonceQueryKey, { ...scope, account }),\n    });\n    void queryClient.invalidateQueries({\n      predicate: predicateMatch(getOperationalFeeAllowanceQueryKey, { ...scope, payer: account }),\n    });\n  }\n  invalidateAccountBalances(queryClient, scope);\n}\n\n/**\n * Invalidate the reads a relayed gasless-wallet `execute` changed.\n *\n * The wallet-operation nonce is keyed by `(owner, walletId, signerAccount)`,\n * and the operation consumed it under its signer account — which defaults to\n * the owner. The wallet's own collateral balance moves, and its address is\n * derived rather than passed, so the collateral read is invalidated chain-wide.\n * The operation may also have deployed the wallet, which zeroes its creation fee.\n *\n * @param wallet - The action's variables, forwarded whole: `owner`, `signerAccount` and `walletId`\n *   scope the invalidation, and each omitted one matches every value.\n *\n * @internal\n */\nexport function invalidateGaslessWalletExecuteReads(\n  queryClient: QueryClient,\n  scope: Scope,\n  wallet: GaslessWalletScope & { signerAccount?: Address },\n): void {\n  void queryClient.invalidateQueries({\n    predicate: predicateMatch(getGaslessWalletNonceQueryKey, {\n      ...scope,\n      owner: wallet.owner,\n      walletId: wallet.walletId,\n      account: wallet.signerAccount ?? wallet.owner,\n    }),\n  });\n  void queryClient.invalidateQueries({ predicate: predicateMatch(getCollateralBalanceQueryKey, scope) });\n  invalidateGaslessWalletDeploymentReads(queryClient, scope, wallet);\n  invalidateRelayTransportReads(queryClient, scope);\n}\n\n/** The selector of the first function named `name` in `abi` — the same derivation the SDK's relayable-writes map uses. */\nfunction selectorOf(abi: Abi, name: string): Hex {\n  const item = abi.find((entry): entry is AbiFunction => entry.type === \"function\" && entry.name === name);\n  if (!item) throw new Error(`invalidate-relay-reads: the shipped ABI has no function \"${name}\".`);\n  return toFunctionSelector(item);\n}\n\n/** Relayable writes that move a withdrawal request along. */\nconst WITHDRAW_WRITES: ReadonlySet<Hex> = new Set([\n  selectorOf(symmioAbi as Abi, \"initiateWithdraw\"),\n  selectorOf(symmioAbi as Abi, \"requestCancelWithdraw\"),\n  selectorOf(symmioAbi as Abi, \"finalizeWithdrawRequest\"),\n]);\n\n/** Relayable writes that change a quote or an open position. */\nconst QUOTE_WRITES: ReadonlySet<Hex> = new Set([\n  selectorOf(symmioAbi as Abi, \"requestToCancelQuote\"),\n  selectorOf(symmioAbi as Abi, \"requestToCancelCloseRequest\"),\n  selectorOf(symmioAbi as Abi, \"forceCancelQuote\"),\n  selectorOf(symmioAbi as Abi, \"forceCancelCloseRequest\"),\n  selectorOf(symmioAbi as Abi, \"forceClosePosition\"),\n]);\n\n/** Relayable writes that change an owner's sub-account list or a sub-account's details. */\nconst SUB_ACCOUNT_WRITES: ReadonlySet<Hex> = new Set([\n  selectorOf(accountLayerAbi as Abi, \"createSubAccounts\"),\n  selectorOf(accountLayerAbi as Abi, \"deleteSubAccount\"),\n  selectorOf(accountLayerAbi as Abi, \"editAccountName\"),\n]);\n\n/** Relayable writes that pull collateral from the signer's own token balance. */\nconst DEPOSIT_WRITES: ReadonlySet<Hex> = new Set([\n  selectorOf(accountLayerAbi as Abi, \"depositForAccount\"),\n  selectorOf(accountLayerAbi as Abi, \"depositAndAllocateForAccount\"),\n]);\n\n/** The one relayable write that grants a delegation. */\nconst GRANT_DELEGATION = selectorOf(instantLayerAbi as Abi, \"grantDelegation\");\n\n/**\n * Invalidate the reads a relayed gasless batch changed.\n *\n * Unlike an opaque `relayInstantOperations` batch, every call of a gasless\n * batch is a known relayable write (the SDK refuses anything else), so its\n * selectors say exactly which domains moved. Each domain's reads are\n * invalidated chain-wide — the calls' own arguments name the rows, but a\n * superset is correct and a silent no-op is not.\n *\n * Always: the account's InstantLayer nonce, fee allowances and balances. Per\n * GaslessWallet entry: that wallet's nonce, collateral and deployment reads.\n *\n * @param batch - The batch's variables: its `account` and `calls`.\n *\n * @internal\n */\nexport function invalidateGaslessBatchReads(\n  queryClient: QueryClient,\n  scope: Scope,\n  batch: { account: Address; calls: readonly GaslessBatchCall[] },\n): void {\n  const selectors = new Set(getGaslessBatchSelectors(batch.calls));\n  const touches = (writes: ReadonlySet<Hex>) => [...writes].some((selector) => selectors.has(selector));\n\n  void queryClient.invalidateQueries({\n    predicate: predicateMatch(getInstantLayerNonceQueryKey, { ...scope, account: batch.account }),\n  });\n  invalidateRelayTransportReads(queryClient, scope);\n\n  for (const call of batch.calls) {\n    if (\"walletCalls\" in call) {\n      invalidateGaslessWalletExecuteReads(queryClient, scope, {\n        walletId: call.walletId ?? 0n,\n        signerAccount: batch.account,\n      });\n    }\n  }\n\n  if (touches(WITHDRAW_WRITES)) {\n    for (const queryKey of [\n      getPendingWithdrawRequestsQueryKey,\n      getLastWithdrawRequestIdQueryKey,\n      getWithdrawableTimeQueryKey,\n      getWithdrawRequestsQueryKey,\n    ]) {\n      void queryClient.invalidateQueries({ predicate: predicateMatch(queryKey, scope) });\n    }\n  }\n  if (touches(QUOTE_WRITES)) {\n    for (const queryKey of [\n      getPartyAPendingQuotesQueryKey,\n      getPendingQuotesQueryKey,\n      getQuoteQueryKey,\n      getPartyAOpenPositionsQueryKey,\n      getQuotePendingFundingQueryKey,\n    ]) {\n      void queryClient.invalidateQueries({ predicate: predicateMatch(queryKey, scope) });\n    }\n  }\n  if (touches(SUB_ACCOUNT_WRITES)) {\n    for (const queryKey of [\n      getUserSubAccountsQueryKey,\n      getUserSubAccountsAddressesQueryKey,\n      getSubAccountsCountOfUserQueryKey,\n      getSubAccountQueryKey,\n    ]) {\n      void queryClient.invalidateQueries({ predicate: predicateMatch(queryKey, scope) });\n    }\n  }\n  if (touches(DEPOSIT_WRITES)) {\n    void queryClient.invalidateQueries({ predicate: predicateMatch(getCollateralBalanceQueryKey, scope) });\n    void queryClient.invalidateQueries({ predicate: predicateMatch(getCollateralAllowanceQueryKey, scope) });\n  }\n  if (selectors.has(GRANT_DELEGATION)) {\n    /** Scoped by config only: one grant covers every selector it lists, for every delegate. */\n    void queryClient.invalidateQueries({ predicate: predicateMatch(getIsDelegationActiveQueryKey, scope) });\n    void queryClient.invalidateQueries({ predicate: predicateMatch(getDelegationExpiryQueryKey, scope) });\n  }\n}\n\n/**\n * Invalidate the reads a deposit settlement changed.\n *\n * The deposit address is swept to zero, so its collateral balance is\n * invalidated precisely when the acceptance receipt carries it. The settlement\n * deploys the wallet on its first use, which zeroes the wallet's creation fee\n * and lowers its deposit policy's `settlementMinimum`, so both are invalidated\n * for the owner's wallet.\n *\n * `depositAddress` arrives as the vendor's raw string, so a value that is not a\n * well-formed address widens to a chain-wide collateral invalidation rather\n * than scoping to nothing — a superset is correct, a silent no-op is not.\n *\n * @param options.owner - The settled wallet's owner.\n * @param options.newAccount - `true` for a new-account settlement, which also\n *   refreshes the owner's sub-account lists; omit for a top-up into an existing account.\n *\n * @internal\n */\nexport function invalidateDepositSettlementReads(\n  queryClient: QueryClient,\n  scope: Scope,\n  options: GaslessWalletScope & { depositAddress?: string; newAccount?: boolean },\n): void {\n  const depositAddress =\n    options.depositAddress && isAddress(options.depositAddress) ? options.depositAddress : undefined;\n  void queryClient.invalidateQueries({\n    predicate: predicateMatch(getCollateralBalanceQueryKey, { ...scope, owner: depositAddress }),\n  });\n  if (options.newAccount && options.owner) {\n    const user = { ...scope, user: options.owner };\n    void queryClient.invalidateQueries({ predicate: predicateMatch(getUserSubAccountsQueryKey, user) });\n    void queryClient.invalidateQueries({ predicate: predicateMatch(getUserSubAccountsAddressesQueryKey, user) });\n    void queryClient.invalidateQueries({ predicate: predicateMatch(getSubAccountsCountOfUserQueryKey, user) });\n  }\n  invalidateGaslessWalletDeploymentReads(queryClient, scope, options);\n  invalidateAccountBalances(queryClient, scope);\n}\n"],"mappings":"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"}

package/dist/gasless/use-approve-operational-fee.d.ts

@@ -0,0 +1,38 @@
+import { ApproveOperationalFeeParameters } from '@symmio/trading-core';
+import { UseMutationResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+import { WriteParameters, WriteResult } from '../transactions/write-types.js';
+/** Parameters for {@link useApproveOperationalFee}. */
+export type UseApproveOperationalFeeParameters = WriteParameters;
+/** Mutation variables of {@link useApproveOperationalFee}: the core action's parameters. */
+export type ApproveOperationalFeeVariables = ApproveOperationalFeeParameters;
+/** Result of {@link useApproveOperationalFee}. */
+export type ApproveOperationalFeeResult = WriteResult;
+/** Return type of {@link useApproveOperationalFee}. */
+export type UseApproveOperationalFeeReturnType = UseMutationResult<ApproveOperationalFeeResult, SymmioRequestError, ApproveOperationalFeeVariables>;
+/**
+ * Approve operational-fee allowances for the gasless fee charger, as the
+ * paying sub-account (via the AccountLayer `_call` proxy).
+ *
+ * Grant the allowance **before** relying on gasless execution. This is a
+ * normal on-chain write — pass `gasless: true` in the variables to relay the
+ * approval itself once gasless execution is active. On success the allowance
+ * read is invalidated after the receipt, so `useOperationalFeeAllowance` reads
+ * the new value back.
+ *
+ * `amounts` are **18-decimal Core units**, not the collateral token's decimals,
+ * and each one replaces the current allowance. Approve a bounded budget rather
+ * than `maxUint256`. Approving does not add balance: the fee is still drawn
+ * from the payer's Core balance.
+ *
+ * @example
+ * ```tsx
+ * import { parseUnits } from "viem";
+ *
+ * const approve = useApproveOperationalFee();
+ * // A bounded fee budget of 5 collateral tokens, in 18-decimal Core units.
+ * approve.mutate({ account: subAccount, amounts: [parseUnits("5", 18)] });
+ * ```
+ */
+export declare function useApproveOperationalFee(parameters?: UseApproveOperationalFeeParameters): UseApproveOperationalFeeReturnType;
+//# sourceMappingURL=use-approve-operational-fee.d.ts.map

package/dist/gasless/use-approve-operational-fee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-approve-operational-fee.d.ts","sourceRoot":"","sources":["../../src/gasless/use-approve-operational-fee.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAGhF,uDAAuD;AACvD,MAAM,MAAM,kCAAkC,GAAG,eAAe,CAAC;AAEjE,4FAA4F;AAC5F,MAAM,MAAM,8BAA8B,GAAG,+BAA+B,CAAC;AAE7E,kDAAkD;AAClD,MAAM,MAAM,2BAA2B,GAAG,WAAW,CAAC;AAEtD,uDAAuD;AACvD,MAAM,MAAM,kCAAkC,GAAG,iBAAiB,CAChE,2BAA2B,EAC3B,kBAAkB,EAClB,8BAA8B,CAC/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,GAAE,kCAAuC,GAClD,kCAAkC,CA4BpC"}

package/dist/gasless/use-approve-operational-fee.js

@@ -0,0 +1,37 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { resolveWriteResult as r } from "../transactions/resolve-write-result.js";
+import { predicateMatch as i } from "../utils/predicate-match.js";
+import { approveOperationalFeeMutationOptions as a, getOperationalFeeAllowanceQueryKey as o } from "@symmio/trading-core";
+import { useMutation as s, useQueryClient as c } from "@tanstack/react-query";
+//#region src/gasless/use-approve-operational-fee.ts
+function l(l = {}) {
+	let u = t(l), d = e(), f = c(), p = a(u);
+	return s({
+		mutationKey: p.mutationKey,
+		mutationFn: async (e) => {
+			try {
+				let t = e.chainId ?? d;
+				return r(u, await p.mutationFn({
+					...e,
+					chainId: t
+				}), {
+					chainId: t,
+					waitForReceipt: l.waitForReceipt,
+					confirmations: l.confirmations
+				});
+			} catch (e) {
+				throw n(e);
+			}
+		},
+		onSuccess: (e, t) => {
+			f.invalidateQueries({ predicate: i(o, { payer: t.account }) });
+		}
+	});
+}
+//#endregion
+export { l as useApproveOperationalFee };
+
+//# sourceMappingURL=use-approve-operational-fee.js.map

package/dist/gasless/use-approve-operational-fee.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-approve-operational-fee.js","names":[],"sources":["../../src/gasless/use-approve-operational-fee.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  approveOperationalFeeMutationOptions,\n  getOperationalFeeAllowanceQueryKey,\n  type ApproveOperationalFeeParameters,\n} from \"@symmio/trading-core\";\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { resolveWriteResult } from \"../transactions/resolve-write-result\";\nimport type { WriteParameters, WriteResult } from \"../transactions/write-types\";\nimport { predicateMatch } from \"../utils/predicate-match\";\n\n/** Parameters for {@link useApproveOperationalFee}. */\nexport type UseApproveOperationalFeeParameters = WriteParameters;\n\n/** Mutation variables of {@link useApproveOperationalFee}: the core action's parameters. */\nexport type ApproveOperationalFeeVariables = ApproveOperationalFeeParameters;\n\n/** Result of {@link useApproveOperationalFee}. */\nexport type ApproveOperationalFeeResult = WriteResult;\n\n/** Return type of {@link useApproveOperationalFee}. */\nexport type UseApproveOperationalFeeReturnType = UseMutationResult<\n  ApproveOperationalFeeResult,\n  SymmioRequestError,\n  ApproveOperationalFeeVariables\n>;\n\n/**\n * Approve operational-fee allowances for the gasless fee charger, as the\n * paying sub-account (via the AccountLayer `_call` proxy).\n *\n * Grant the allowance **before** relying on gasless execution. This is a\n * normal on-chain write — pass `gasless: true` in the variables to relay the\n * approval itself once gasless execution is active. On success the allowance\n * read is invalidated after the receipt, so `useOperationalFeeAllowance` reads\n * the new value back.\n *\n * `amounts` are **18-decimal Core units**, not the collateral token's decimals,\n * and each one replaces the current allowance. Approve a bounded budget rather\n * than `maxUint256`. Approving does not add balance: the fee is still drawn\n * from the payer's Core balance.\n *\n * @example\n * ```tsx\n * import { parseUnits } from \"viem\";\n *\n * const approve = useApproveOperationalFee();\n * // A bounded fee budget of 5 collateral tokens, in 18-decimal Core units.\n * approve.mutate({ account: subAccount, amounts: [parseUnits(\"5\", 18)] });\n * ```\n */\nexport function useApproveOperationalFee(\n  parameters: UseApproveOperationalFeeParameters = {},\n): UseApproveOperationalFeeReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = approveOperationalFeeMutationOptions(config);\n\n  return useMutation<ApproveOperationalFeeResult, SymmioRequestError, ApproveOperationalFeeVariables>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const resolvedChainId = variables.chainId ?? chainId;\n        const hash = await base.mutationFn({ ...variables, chainId: resolvedChainId });\n        return resolveWriteResult(config, hash, {\n          chainId: resolvedChainId,\n          waitForReceipt: parameters.waitForReceipt,\n          confirmations: parameters.confirmations,\n        });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n    onSuccess: (_result, variables) => {\n      void queryClient.invalidateQueries({\n        predicate: predicateMatch(getOperationalFeeAllowanceQueryKey, { payer: variables.account }),\n      });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AAwDA,SAAgB,EACd,IAAiD,CAAC,GACd;CACpC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAAqC,CAAM;CAExD,OAAO,EAA6F;EAClG,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,IAAM,IAAkB,EAAU,WAAW;IAE7C,OAAO,EAAmB,GAAQ,MADf,EAAK,WAAW;KAAE,GAAG;KAAW,SAAS;IAAgB,CAAC,GACrC;KACtC,SAAS;KACT,gBAAgB,EAAW;KAC3B,eAAe,EAAW;IAC5B,CAAC;GACH,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,YAAY,GAAS,MAAc;GACjC,EAAiB,kBAAkB,EACjC,WAAW,EAAe,GAAoC,EAAE,OAAO,EAAU,QAAQ,CAAC,EAC5F,CAAC;EACH;CACF,CAAC;AACH"}

package/dist/gasless/use-debounced-batch.d.ts

@@ -0,0 +1,22 @@
+import { GaslessBatchCall } from '@symmio/trading-core';
+import { Address } from 'viem';
+/** The part of a batch fee quote that a form changes as the user types. */
+export interface DebouncedBatch {
+    account: Address;
+    calls: readonly GaslessBatchCall[];
+}
+/**
+ * The batch to quote: `account` and `calls` once their **content** has held
+ * still for `delayMs`, the last settled batch until then.
+ *
+ * Content, not identity. A form rebuilds its calls array on every render, so a
+ * debounce keyed on the value itself would restart with every render — and
+ * behind a component that re-renders faster than the delay, it would never
+ * settle at all. The batch is keyed by its query key instead: the encoded
+ * calldata, so a rebuilt but identical array changes nothing. The first batch
+ * settles at once; `delayMs <= 0` passes every change straight through.
+ *
+ * @internal
+ */
+export declare function useDebouncedBatch(batch: DebouncedBatch, delayMs: number): DebouncedBatch;
+//# sourceMappingURL=use-debounced-batch.d.ts.map

package/dist/gasless/use-debounced-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-debounced-batch.d.ts","sourceRoot":"","sources":["../../src/gasless/use-debounced-batch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmC,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAoBxF"}

package/dist/gasless/use-debounced-batch.js

@@ -0,0 +1,27 @@
+"use client";
+import { getGaslessBatchFeeQuoteQueryKey as e } from "@symmio/trading-core";
+import { useEffect as t, useRef as n, useState as r } from "react";
+import { hashKey as i } from "@tanstack/react-query";
+//#region src/gasless/use-debounced-batch.ts
+function a(a, o) {
+	let s = i(e(a)), [c, l] = r({
+		key: s,
+		batch: a
+	}), u = n(a);
+	return t(() => {
+		u.current = a;
+	}), t(() => {
+		if (o <= 0) return;
+		let e = setTimeout(() => {
+			l((e) => e.key === s ? e : {
+				key: s,
+				batch: u.current
+			});
+		}, o);
+		return () => clearTimeout(e);
+	}, [s, o]), o <= 0 || c.key === s ? a : c.batch;
+}
+//#endregion
+export { a as useDebouncedBatch };
+
+//# sourceMappingURL=use-debounced-batch.js.map

package/dist/gasless/use-debounced-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-debounced-batch.js","names":[],"sources":["../../src/gasless/use-debounced-batch.ts"],"sourcesContent":["\"use client\";\n\nimport { getGaslessBatchFeeQuoteQueryKey, type GaslessBatchCall } from \"@symmio/trading-core\";\nimport { hashKey } from \"@tanstack/react-query\";\nimport { useEffect, useRef, useState } from \"react\";\nimport type { Address } from \"viem\";\n\n/** The part of a batch fee quote that a form changes as the user types. */\nexport interface DebouncedBatch {\n  account: Address;\n  calls: readonly GaslessBatchCall[];\n}\n\n/**\n * The batch to quote: `account` and `calls` once their **content** has held\n * still for `delayMs`, the last settled batch until then.\n *\n * Content, not identity. A form rebuilds its calls array on every render, so a\n * debounce keyed on the value itself would restart with every render — and\n * behind a component that re-renders faster than the delay, it would never\n * settle at all. The batch is keyed by its query key instead: the encoded\n * calldata, so a rebuilt but identical array changes nothing. The first batch\n * settles at once; `delayMs <= 0` passes every change straight through.\n *\n * @internal\n */\nexport function useDebouncedBatch(batch: DebouncedBatch, delayMs: number): DebouncedBatch {\n  const key = hashKey(getGaslessBatchFeeQuoteQueryKey(batch));\n  const [settled, setSettled] = useState({ key, batch });\n\n  /** The newest batch, read when the timer fires — held in a ref so its identity can never restart the wait. */\n  const latest = useRef(batch);\n  useEffect(() => {\n    latest.current = batch;\n  });\n\n  useEffect(() => {\n    if (delayMs <= 0) return;\n    const timer = setTimeout(() => {\n      setSettled((current) => (current.key === key ? current : { key, batch: latest.current }));\n    }, delayMs);\n    return () => clearTimeout(timer);\n  }, [key, delayMs]);\n\n  if (delayMs <= 0 || settled.key === key) return batch;\n  return settled.batch;\n}\n"],"mappings":";;;;;AA0BA,SAAgB,EAAkB,GAAuB,GAAiC;CACxF,IAAM,IAAM,EAAQ,EAAgC,CAAK,CAAC,GACpD,CAAC,GAAS,KAAc,EAAS;EAAE;EAAK;CAAM,CAAC,GAG/C,IAAS,EAAO,CAAK;CAc3B,OAbA,QAAgB;EACd,EAAO,UAAU;CACnB,CAAC,GAED,QAAgB;EACd,IAAI,KAAW,GAAG;EAClB,IAAM,IAAQ,iBAAiB;GAC7B,GAAY,MAAa,EAAQ,QAAQ,IAAM,IAAU;IAAE;IAAK,OAAO,EAAO;GAAQ,CAAE;EAC1F,GAAG,CAAO;EACV,aAAa,aAAa,CAAK;CACjC,GAAG,CAAC,GAAK,CAAO,CAAC,GAEb,KAAW,KAAK,EAAQ,QAAQ,IAAY,IACzC,EAAQ;AACjB"}

package/dist/gasless/use-gasless-batch-fee-quote.d.ts

@@ -0,0 +1,48 @@
+import { ConfigParameter, GetGaslessBatchFeeQuoteOptions, GetGaslessBatchFeeQuoteReturnType } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/** Parameters for {@link useGaslessBatchFeeQuote}. */
+export type UseGaslessBatchFeeQuoteParameters = GetGaslessBatchFeeQuoteOptions & ConfigParameter & {
+    /**
+     * Quiet period (ms) before a changed `account` or `calls` is re-quoted, so
+     * a form that rebuilds its calls on every keystroke reads the GaslessLayer
+     * once the user pauses — not once per keystroke. Until then the quote of
+     * the last settled batch stays in place. Changes are detected by content,
+     * so rebuilding an identical array on every render never restarts the wait.
+     * The first batch is quoted at once. Defaults to 500; `0` quotes every
+     * change immediately.
+     */
+    debounceMs?: number;
+};
+/** Return type of {@link useGaslessBatchFeeQuote}. */
+export type UseGaslessBatchFeeQuoteReturnType = UseQueryResult<GetGaslessBatchFeeQuoteReturnType, SymmioRequestError>;
+/**
+ * Preview what relaying a gasless batch would cost — the same `account` and
+ * `calls` you would hand to {@link useRelayGaslessBatch}, priced by the
+ * GaslessLayer's `previewFeeQuote` before any signature prompt.
+ *
+ * The result depends only on the account and the calls (their nonces,
+ * deadlines and signatures are never priced), so it caches per batch, and a
+ * call given by `functionName`, by `abi` or as raw `data` shares one cache
+ * entry. Amounts are 18-decimal; `totalFee18` is the batch total and
+ * `payments` has one row per call. An exhausted daily free quota surfaces as
+ * an error with code `GASLESS_FREE_QUOTA_EXHAUSTED`.
+ *
+ * Pass the form's live inputs straight in: a changed batch is **debounced
+ * internally** (`debounceMs`, default 500), so typing an amount reads the
+ * GaslessLayer once the user settles.
+ *
+ * @param parameters - The account, the calls, optional chain id, debounce, config and query overrides.
+ * @returns The TanStack query result, with failures normalized to {@link SymmioRequestError}.
+ *
+ * @example
+ * ```tsx
+ * const quote = useGaslessBatchFeeQuote({
+ *   account: subAccount,
+ *   calls: [{ functionName: "allocate", args: [amount] }],
+ * });
+ * const fee = quote.data ? formatUnits(quote.data.totalFee18, 18) : undefined;
+ * ```
+ */
+export declare function useGaslessBatchFeeQuote(parameters: UseGaslessBatchFeeQuoteParameters): UseGaslessBatchFeeQuoteReturnType;
+//# sourceMappingURL=use-gasless-batch-fee-quote.d.ts.map

package/dist/gasless/use-gasless-batch-fee-quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-gasless-batch-fee-quote.d.ts","sourceRoot":"","sources":["../../src/gasless/use-gasless-batch-fee-quote.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,8BAA8B,EACnC,KAAK,iCAAiC,EACvC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAQzE,sDAAsD;AACtD,MAAM,MAAM,iCAAiC,GAAG,8BAA8B,GAC5E,eAAe,GAAG;IAChB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEJ,sDAAsD;AACtD,MAAM,MAAM,iCAAiC,GAAG,cAAc,CAAC,iCAAiC,EAAE,kBAAkB,CAAC,CAAC;AAEtH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,iCAAiC,GAC5C,iCAAiC,CA2BnC"}

package/dist/gasless/use-gasless-batch-fee-quote.js

@@ -0,0 +1,33 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { useDebouncedBatch as r } from "./use-debounced-batch.js";
+import { getGaslessBatchFeeQuoteQueryOptions as i } from "@symmio/trading-core";
+import { useQuery as a } from "@tanstack/react-query";
+//#region src/gasless/use-gasless-batch-fee-quote.ts
+var o = 500;
+function s(s) {
+	let c = t(s), l = e(), { debounceMs: u, ...d } = s, f = r({
+		account: s.account,
+		calls: s.calls
+	}, u ?? o), p = i(c, {
+		...d,
+		...f,
+		chainId: s.chainId ?? l
+	});
+	return a({
+		...p,
+		queryFn: async () => {
+			try {
+				return await p.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { s as useGaslessBatchFeeQuote };
+
+//# sourceMappingURL=use-gasless-batch-fee-quote.js.map

package/dist/gasless/use-gasless-batch-fee-quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-gasless-batch-fee-quote.js","names":[],"sources":["../../src/gasless/use-gasless-batch-fee-quote.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getGaslessBatchFeeQuoteQueryOptions,\n  type ConfigParameter,\n  type GetGaslessBatchFeeQuoteOptions,\n  type GetGaslessBatchFeeQuoteReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { useDebouncedBatch } from \"./use-debounced-batch\";\n\n/** Default quiet period (ms) before a changed batch is re-quoted. */\nconst DEFAULT_DEBOUNCE_MS = 500;\n\n/** Parameters for {@link useGaslessBatchFeeQuote}. */\nexport type UseGaslessBatchFeeQuoteParameters = GetGaslessBatchFeeQuoteOptions &\n  ConfigParameter & {\n    /**\n     * Quiet period (ms) before a changed `account` or `calls` is re-quoted, so\n     * a form that rebuilds its calls on every keystroke reads the GaslessLayer\n     * once the user pauses — not once per keystroke. Until then the quote of\n     * the last settled batch stays in place. Changes are detected by content,\n     * so rebuilding an identical array on every render never restarts the wait.\n     * The first batch is quoted at once. Defaults to 500; `0` quotes every\n     * change immediately.\n     */\n    debounceMs?: number;\n  };\n\n/** Return type of {@link useGaslessBatchFeeQuote}. */\nexport type UseGaslessBatchFeeQuoteReturnType = UseQueryResult<GetGaslessBatchFeeQuoteReturnType, SymmioRequestError>;\n\n/**\n * Preview what relaying a gasless batch would cost — the same `account` and\n * `calls` you would hand to {@link useRelayGaslessBatch}, priced by the\n * GaslessLayer's `previewFeeQuote` before any signature prompt.\n *\n * The result depends only on the account and the calls (their nonces,\n * deadlines and signatures are never priced), so it caches per batch, and a\n * call given by `functionName`, by `abi` or as raw `data` shares one cache\n * entry. Amounts are 18-decimal; `totalFee18` is the batch total and\n * `payments` has one row per call. An exhausted daily free quota surfaces as\n * an error with code `GASLESS_FREE_QUOTA_EXHAUSTED`.\n *\n * Pass the form's live inputs straight in: a changed batch is **debounced\n * internally** (`debounceMs`, default 500), so typing an amount reads the\n * GaslessLayer once the user settles.\n *\n * @param parameters - The account, the calls, optional chain id, debounce, config and query overrides.\n * @returns The TanStack query result, with failures normalized to {@link SymmioRequestError}.\n *\n * @example\n * ```tsx\n * const quote = useGaslessBatchFeeQuote({\n *   account: subAccount,\n *   calls: [{ functionName: \"allocate\", args: [amount] }],\n * });\n * const fee = quote.data ? formatUnits(quote.data.totalFee18, 18) : undefined;\n * ```\n */\nexport function useGaslessBatchFeeQuote(\n  parameters: UseGaslessBatchFeeQuoteParameters,\n): UseGaslessBatchFeeQuoteReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n\n  /** `debounceMs` is pulled out so it never reaches the query options or the cache key. */\n  const { debounceMs, ...queryParameters } = parameters;\n  const batch = useDebouncedBatch(\n    { account: parameters.account, calls: parameters.calls },\n    debounceMs ?? DEFAULT_DEBOUNCE_MS,\n  );\n\n  const options = getGaslessBatchFeeQuoteQueryOptions(config, {\n    ...queryParameters,\n    ...batch,\n    chainId: parameters.chainId ?? chainId,\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseGaslessBatchFeeQuoteReturnType;\n}\n"],"mappings":";;;;;;;;AAgBA,IAAM,IAAsB;AAgD5B,SAAgB,EACd,GACmC;CACnC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAG3B,EAAE,eAAY,GAAG,MAAoB,GACrC,IAAQ,EACZ;EAAE,SAAS,EAAW;EAAS,OAAO,EAAW;CAAM,GACvD,KAAc,CAChB,GAEM,IAAU,EAAoC,GAAQ;EAC1D,GAAG;EACH,GAAG;EACH,SAAS,EAAW,WAAW;CACjC,CAAC;CAED,OAAO,EAAS;EACd,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}

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

@@ -0,0 +1,28 @@
+import { ConfigParameter, GetGaslessDepositPolicyOptions, GetGaslessDepositPolicyReturnType } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/** Parameters for {@link useGaslessDepositPolicy}. */
+export type UseGaslessDepositPolicyParameters = GetGaslessDepositPolicyOptions & ConfigParameter;
+/** Return type of {@link useGaslessDepositPolicy}. */
+export type UseGaslessDepositPolicyReturnType = UseQueryResult<GetGaslessDepositPolicyReturnType, SymmioRequestError>;
+/**
+ * Read the gasless deposit policy for one of an owner's GaslessWallets - the
+ * deterministic deposit address, the collateral token and its decimals, and
+ * the deposit fee, minimum and wallet creation fee - via RPC contract reads on
+ * the GaslessLayer. `walletId` defaults to `0n`. Gate the settlement UI on the
+ * observed balance reaching `settlementMinimum`, which already covers the
+ * creation fee.
+ *
+ * The settlement hooks and `useGaslessWalletExecute` invalidate it, since
+ * either may deploy the wallet and zero its creation fee.
+ *
+ * @param parameters - Owner, optional `walletId` (default `0n`), optional chain id, config and query overrides.
+ * @returns The TanStack query result, with failures normalized to {@link SymmioRequestError}.
+ *
+ * @example
+ * ```tsx
+ * const query = useGaslessDepositPolicy({ owner });
+ * ```
+ */
+export declare function useGaslessDepositPolicy(parameters: UseGaslessDepositPolicyParameters): UseGaslessDepositPolicyReturnType;
+//# sourceMappingURL=use-gasless-deposit-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-gasless-deposit-policy.d.ts","sourceRoot":"","sources":["../../src/gasless/use-gasless-deposit-policy.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,8BAA8B,EACnC,KAAK,iCAAiC,EACvC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE,sDAAsD;AACtD,MAAM,MAAM,iCAAiC,GAAG,8BAA8B,GAAG,eAAe,CAAC;AAEjG,sDAAsD;AACtD,MAAM,MAAM,iCAAiC,GAAG,cAAc,CAAC,iCAAiC,EAAE,kBAAkB,CAAC,CAAC;AAEtH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,iCAAiC,GAC5C,iCAAiC,CAmBnC"}

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

@@ -0,0 +1,27 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { getGaslessDepositPolicyQueryOptions as r } from "@symmio/trading-core";
+import { useQuery as i } from "@tanstack/react-query";
+//#region src/gasless/use-gasless-deposit-policy.ts
+function a(a) {
+	let o = t(a), s = e(), c = r(o, {
+		...a,
+		chainId: a.chainId ?? s
+	});
+	return i({
+		...c,
+		queryFn: async () => {
+			try {
+				return await c.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { a as useGaslessDepositPolicy };
+
+//# sourceMappingURL=use-gasless-deposit-policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-gasless-deposit-policy.js","names":[],"sources":["../../src/gasless/use-gasless-deposit-policy.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getGaslessDepositPolicyQueryOptions,\n  type ConfigParameter,\n  type GetGaslessDepositPolicyOptions,\n  type GetGaslessDepositPolicyReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/** Parameters for {@link useGaslessDepositPolicy}. */\nexport type UseGaslessDepositPolicyParameters = GetGaslessDepositPolicyOptions & ConfigParameter;\n\n/** Return type of {@link useGaslessDepositPolicy}. */\nexport type UseGaslessDepositPolicyReturnType = UseQueryResult<GetGaslessDepositPolicyReturnType, SymmioRequestError>;\n\n/**\n * Read the gasless deposit policy for one of an owner's GaslessWallets - the\n * deterministic deposit address, the collateral token and its decimals, and\n * the deposit fee, minimum and wallet creation fee - via RPC contract reads on\n * the GaslessLayer. `walletId` defaults to `0n`. Gate the settlement UI on the\n * observed balance reaching `settlementMinimum`, which already covers the\n * creation fee.\n *\n * The settlement hooks and `useGaslessWalletExecute` invalidate it, since\n * either may deploy the wallet and zero its creation fee.\n *\n * @param parameters - Owner, optional `walletId` (default `0n`), optional chain id, config and query overrides.\n * @returns The TanStack query result, with failures normalized to {@link SymmioRequestError}.\n *\n * @example\n * ```tsx\n * const query = useGaslessDepositPolicy({ owner });\n * ```\n */\nexport function useGaslessDepositPolicy(\n  parameters: UseGaslessDepositPolicyParameters,\n): UseGaslessDepositPolicyReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n\n  const options = getGaslessDepositPolicyQueryOptions(config, {\n    ...parameters,\n    chainId: parameters.chainId ?? chainId,\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseGaslessDepositPolicyReturnType;\n}\n"],"mappings":";;;;;;;AAuCA,SAAgB,EACd,GACmC;CACnC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAE3B,IAAU,EAAoC,GAAQ;EAC1D,GAAG;EACH,SAAS,EAAW,WAAW;CACjC,CAAC;CAED,OAAO,EAAS;EACd,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}

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

@@ -0,0 +1,25 @@
+import { ConfigParameter, GetGaslessFeeQuoteOptions, GetGaslessFeeQuoteReturnType } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/** Parameters for {@link useGaslessFeeQuote}. */
+export type UseGaslessFeeQuoteParameters = GetGaslessFeeQuoteOptions & ConfigParameter;
+/** Return type of {@link useGaslessFeeQuote}. */
+export type UseGaslessFeeQuoteReturnType = UseQueryResult<GetGaslessFeeQuoteReturnType, SymmioRequestError>;
+/**
+ * Quote what the GaslessLayer would charge to relay a batch (`previewFeeQuote`)
+ * before prompting the user to sign. Amounts are 18-decimal and the quote is a
+ * preview (`exact` is always `false`). An exhausted daily free quota surfaces as
+ * an error with code `GASLESS_FREE_QUOTA_EXHAUSTED` — check it with
+ * `isGaslessFreeQuotaExhaustedError`.
+ *
+ * @param parameters - The batch (`operations`, each with an optional `walletId`), optional chain id, config and query overrides.
+ * @returns The TanStack query result, with failures normalized to {@link SymmioRequestError}.
+ *
+ * @example
+ * ```tsx
+ * const quote = useGaslessFeeQuote({ operations: [{ operation }] });
+ * const fee18 = quote.data?.totalFee18;
+ * ```
+ */
+export declare function useGaslessFeeQuote(parameters: UseGaslessFeeQuoteParameters): UseGaslessFeeQuoteReturnType;
+//# sourceMappingURL=use-gasless-fee-quote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-gasless-fee-quote.d.ts","sourceRoot":"","sources":["../../src/gasless/use-gasless-fee-quote.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG,yBAAyB,GAAG,eAAe,CAAC;AAEvF,iDAAiD;AACjD,MAAM,MAAM,4BAA4B,GAAG,cAAc,CAAC,4BAA4B,EAAE,kBAAkB,CAAC,CAAC;AAE5G;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,4BAA4B,GAAG,4BAA4B,CAmBzG"}

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

@@ -0,0 +1,27 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { getGaslessFeeQuoteQueryOptions as r } from "@symmio/trading-core";
+import { useQuery as i } from "@tanstack/react-query";
+//#region src/gasless/use-gasless-fee-quote.ts
+function a(a) {
+	let o = t(a), s = e(), c = r(o, {
+		...a,
+		chainId: a.chainId ?? s
+	});
+	return i({
+		...c,
+		queryFn: async () => {
+			try {
+				return await c.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { a as useGaslessFeeQuote };
+
+//# sourceMappingURL=use-gasless-fee-quote.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-gasless-fee-quote.js","names":[],"sources":["../../src/gasless/use-gasless-fee-quote.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getGaslessFeeQuoteQueryOptions,\n  type ConfigParameter,\n  type GetGaslessFeeQuoteOptions,\n  type GetGaslessFeeQuoteReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/** Parameters for {@link useGaslessFeeQuote}. */\nexport type UseGaslessFeeQuoteParameters = GetGaslessFeeQuoteOptions & ConfigParameter;\n\n/** Return type of {@link useGaslessFeeQuote}. */\nexport type UseGaslessFeeQuoteReturnType = UseQueryResult<GetGaslessFeeQuoteReturnType, SymmioRequestError>;\n\n/**\n * Quote what the GaslessLayer would charge to relay a batch (`previewFeeQuote`)\n * before prompting the user to sign. Amounts are 18-decimal and the quote is a\n * preview (`exact` is always `false`). An exhausted daily free quota surfaces as\n * an error with code `GASLESS_FREE_QUOTA_EXHAUSTED` — check it with\n * `isGaslessFreeQuotaExhaustedError`.\n *\n * @param parameters - The batch (`operations`, each with an optional `walletId`), optional chain id, config and query overrides.\n * @returns The TanStack query result, with failures normalized to {@link SymmioRequestError}.\n *\n * @example\n * ```tsx\n * const quote = useGaslessFeeQuote({ operations: [{ operation }] });\n * const fee18 = quote.data?.totalFee18;\n * ```\n */\nexport function useGaslessFeeQuote(parameters: UseGaslessFeeQuoteParameters): UseGaslessFeeQuoteReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n\n  const options = getGaslessFeeQuoteQueryOptions(config, {\n    ...parameters,\n    chainId: parameters.chainId ?? chainId,\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseGaslessFeeQuoteReturnType;\n}\n"],"mappings":";;;;;;;AAoCA,SAAgB,EAAmB,GAAwE;CACzG,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAE3B,IAAU,EAA+B,GAAQ;EACrD,GAAG;EACH,SAAS,EAAW,WAAW;CACjC,CAAC;CAED,OAAO,EAAS;EACd,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}

package/dist/gasless/use-gasless-relay-confirmation.d.ts

@@ -0,0 +1,72 @@
+import { Config, GaslessConfirmedRequest, GaslessService } from '@symmio/trading-core';
+import { QueryClient } from '@tanstack/react-query';
+import { Address } from 'viem';
+import { GaslessRelayParameters, GaslessRelayProgress } from './gasless-relay-types.js';
+/**
+ * The acceptance fields a confirmation needs. Every gasless submit receipt
+ * satisfies it: an operations receipt carries `walletIds`, a deposit settlement
+ * carries the single `walletId` it settled.
+ *
+ * @internal
+ */
+export interface GaslessRelayAcceptance {
+    requestId: string;
+    idempotencyKey: string;
+    protocolInstance: string | null;
+    owner: Address;
+    walletIds?: readonly bigint[];
+    walletId?: bigint;
+}
+/** What the relay hook tells the confirmation about the request it just submitted. @internal */
+export interface GaslessRelayConfirmOptions {
+    /** The chain the relay was accepted on. */
+    chainId: number;
+    /** Which sub-service stores the request. Defaults to `"operations"`. */
+    service?: GaslessService;
+    /** The workflow label the submit carried, for the persisted row. */
+    operationType?: string;
+    /** Invalidate the reads a `succeeded` relay changed. */
+    invalidate: (queryClient: QueryClient) => void;
+}
+/** What {@link useGaslessRelayConfirmation} hands back to a relay hook. */
+export interface GaslessRelayConfirmationController {
+    /** Current progress, to merge onto the mutation result as `relay`. */
+    progress: GaslessRelayProgress;
+    /** Reset progress and abort any in-flight wait. Call from the hook's `reset`. */
+    reset: () => void;
+    /**
+     * Run the submit half of a relay through the progress state.
+     *
+     * Publishes `submitting` for the window between the user's click and the
+     * service's `202` — signing and the POST — which is the one stretch
+     * {@link confirm} cannot see, and publishes `error` if that window fails.
+     * Nothing is accepted yet, so neither phase carries a request id.
+     */
+    submit: <result>(send: () => Promise<result>) => Promise<result>;
+    /**
+     * Follow an accepted request to the configured depth.
+     *
+     * Returns the confirmation, or `undefined` for `confirmation: "none"`.
+     * `invalidate` runs whenever a `succeeded` terminal was observed — including
+     * when the wait was later aborted — because the point of waiting is the
+     * invalidation, and the query client outlives the component.
+     */
+    confirm: (accepted: GaslessRelayAcceptance, options: GaslessRelayConfirmOptions) => Promise<GaslessConfirmedRequest | undefined>;
+}
+/**
+ * The confirmation half of every explicit relay hook.
+ *
+ * Owns the four things a relay mutation needs and a plain `useMutation` cannot
+ * give it: an `AbortController` tied to the component's life, progress state
+ * that survives a 120-second wait, the `onAccepted` hand-off that lets a
+ * consumer persist the request id before anything can go wrong, and the
+ * guarantee that a `succeeded` relay invalidates its reads even if nobody is
+ * left watching.
+ *
+ * @param parameters - The hook's confirmation options.
+ * @param config - The SDK config, for the confirm call and the cache seed.
+ *
+ * @internal
+ */
+export declare function useGaslessRelayConfirmation(parameters: GaslessRelayParameters, config: Config): GaslessRelayConfirmationController;
+//# sourceMappingURL=use-gasless-relay-confirmation.d.ts.map

package/dist/gasless/use-gasless-relay-confirmation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-gasless-relay-confirmation.d.ts","sourceRoot":"","sources":["../../src/gasless/use-gasless-relay-confirmation.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,MAAM,EAEX,KAAK,uBAAuB,EAE5B,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,EAAuB,KAAK,sBAAsB,EAAE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEpH;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gGAAgG;AAChG,MAAM,WAAW,0BAA0B;IACzC,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,UAAU,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;CAChD;AAED,2EAA2E;AAC3E,MAAM,WAAW,kCAAkC;IACjD,sEAAsE;IACtE,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,iFAAiF;IACjF,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;;;;;OAOG;IACH,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE;;;;;;;OAOG;IACH,OAAO,EAAE,CACP,QAAQ,EAAE,sBAAsB,EAChC,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAC;CACnD;AAWD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,sBAAsB,EAClC,MAAM,EAAE,MAAM,GACb,kCAAkC,CA8MpC"}