@symmio/trading-react 3.0.0 → 3.1.0

package/dist/quotes/use-quotes-funding.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-quotes-funding.js","names":[],"sources":["../../src/quotes/use-quotes-funding.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getQuoteFundingQueryOptions,\n  type ConfigParameter,\n  type GetQuoteFundingOptions,\n  type QuoteFundingData,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { useMemo } from \"react\";\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/** Minimum quote shape `useQuotesFunding` needs: just the on-chain id. */\nexport interface QuotesFundingInputQuote {\n  /** On-chain quote id. Off-chain (pending) rows pass `undefined` and are skipped. */\n  quoteId?: bigint;\n}\n\n/**\n * Parameters for {@link useQuotesFunding}.\n */\nexport interface UseQuotesFundingParameters extends Omit<GetQuoteFundingOptions, \"quoteIds\">, ConfigParameter {\n  /**\n   * Quotes (or quote-id-bearing rows) to read funding for. Off-chain rows\n   * (`quoteId === undefined`) are silently skipped. The resolved on-chain ids are\n   * de-duplicated and fetched in a single subgraph round-trip, so listing the\n   * same quote twice costs one request and contributes to the sums once.\n   */\n  quotes: readonly QuotesFundingInputQuote[];\n}\n\n/**\n * Return type of {@link useQuotesFunding}.\n */\nexport interface UseQuotesFundingReturnType {\n  /**\n   * Funding row per input quote, aligned 1:1 with `quotes` and in input order —\n   * `rows.length === quotes.length` on every path, including while loading and\n   * when nothing on-chain was requested. An entry is `null` for an off-chain row\n   * (no `quoteId`) or for an id the subgraph has not surfaced yet.\n   */\n  rows: Array<QuoteFundingData | null>;\n  /**\n   * Σ funding paid across the resolved rows (wei). Summed over the **distinct**\n   * on-chain ids, so a quote listed twice contributes once.\n   */\n  paid: bigint;\n  /**\n   * Σ funding received across the resolved rows (wei). Summed over the\n   * **distinct** on-chain ids, so a quote listed twice contributes once.\n   */\n  received: bigint;\n  /**\n   * Σ `received − paid` across the resolved rows (wei). **Positive = the position\n   * earned funding**; negative = it paid for it. A lower bound while\n   * `missingQuoteIds` is non-empty.\n   */\n  netReceived: bigint;\n  /**\n   * Requested on-chain ids that have no funding row yet. While the query is in\n   * flight — and if it fails — this is **every** requested id, since nothing has\n   * resolved; once it settles it is the subset the subgraph did not return\n   * (indexing lag). Always empty when no on-chain ids were requested.\n   */\n  missingQuoteIds: bigint[];\n  /** `true` while the underlying subgraph query is loading. */\n  isLoading: boolean;\n  /** Normalized request error, when one occurred. */\n  error: SymmioRequestError | null;\n}\n\n/**\n * Batch-read funding totals for a list of quotes from the analytics subgraph in\n * a single round-trip and aggregate them into running sums for the group.\n *\n * The hook is the canonical entry point for both single-quote details panels\n * ({@link useQuoteFunding} delegates here with a 1-element list) and grouped\n * quote cards (which want `Σ netReceived`). Off-chain rows are skipped silently,\n * and duplicate ids are fetched — and summed — exactly once.\n *\n * **Sign convention** — `netReceived = received − paid`, the P&L perspective, so\n * a **positive** value means the position **earned** funding. This matches\n * `QuoteFundingData.netReceived` and the uPnL folds, and is the inverse of the\n * cost-positive on-chain `int256`. A \"green = income\" UI renders it directly.\n *\n * **Settled to date only** — the totals cover funding the protocol has already\n * charged and the analytics subgraph has indexed. Funding accrued since a\n * quote's last funding charge is not indexed anywhere and is therefore not\n * included.\n *\n * @param parameters - The quotes to read funding for, plus optional chain/config overrides.\n * @returns Per-quote rows aligned with `quotes`, the aggregate sums, and query state.\n *\n * @example\n * ```tsx\n * const { rows, netReceived, missingQuoteIds, isLoading } = useQuotesFunding({ quotes: group.quotes });\n * // `netReceived > 0n` → the position earned funding across the resolved rows.\n * ```\n */\nexport function useQuotesFunding(parameters: UseQuotesFundingParameters): UseQuotesFundingReturnType {\n  const { quotes, ...rest } = parameters;\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n\n  const onchainQuoteIds = useMemo(() => {\n    const seen = new Set<string>();\n    const ids: bigint[] = [];\n    for (const quote of quotes) {\n      if (quote.quoteId === undefined) continue;\n      const key = quote.quoteId.toString();\n      if (seen.has(key)) continue;\n      seen.add(key);\n      ids.push(quote.quoteId);\n    }\n    return ids;\n  }, [quotes]);\n\n  const options = getQuoteFundingQueryOptions(config, {\n    ...rest,\n    chainId: rest.chainId ?? chainId,\n    quoteIds: onchainQuoteIds,\n  });\n\n  const query = useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseQueryResult<{ rows: QuoteFundingData[]; missingQuoteIds: bigint[] }, SymmioRequestError>;\n\n  return useMemo(() => {\n    /** Nothing on-chain to read: the query is disabled, but `rows` still owes one entry per input quote. */\n    if (onchainQuoteIds.length === 0) {\n      return {\n        rows: quotes.map(() => null),\n        paid: 0n,\n        received: 0n,\n        netReceived: 0n,\n        missingQuoteIds: [],\n        isLoading: false,\n        error: null,\n      };\n    }\n\n    const data = query.data;\n    if (!data) {\n      return {\n        rows: quotes.map(() => null),\n        paid: 0n,\n        received: 0n,\n        netReceived: 0n,\n        /** In flight (or failed): nothing resolved, so every requested id is still outstanding. */\n        missingQuoteIds: [...onchainQuoteIds],\n        isLoading: query.isLoading,\n        error: query.error ?? null,\n      };\n    }\n\n    /** First row wins per id — a repeated row for the same quote must not double-count. */\n    const byQuoteId = new Map<string, QuoteFundingData>();\n    for (const row of data.rows) {\n      const key = row.quoteId.toString();\n      if (!byQuoteId.has(key)) byQuoteId.set(key, row);\n    }\n\n    let paid = 0n;\n    let received = 0n;\n    /** Fold over the de-duped ids, never over `quotes` — the same id listed twice is fetched once and must sum once. */\n    for (const quoteId of onchainQuoteIds) {\n      const row = byQuoteId.get(quoteId.toString());\n      if (row === undefined) continue;\n      paid += row.paid;\n      received += row.received;\n    }\n\n    /** Built by lookup afterwards, so the 1:1 alignment with `quotes` is independent of the fold. */\n    const rows = quotes.map((quote) =>\n      quote.quoteId === undefined ? null : (byQuoteId.get(quote.quoteId.toString()) ?? null),\n    );\n\n    return {\n      rows,\n      paid,\n      received,\n      /** Derived from the sums so the aggregate keeps the row-level `netReceived = received − paid` invariant. */\n      netReceived: received - paid,\n      missingQuoteIds: data.missingQuoteIds,\n      isLoading: query.isLoading,\n      error: query.error ?? null,\n    };\n  }, [onchainQuoteIds, quotes, query.data, query.isLoading, query.error]);\n}\n"],"mappings":";;;;;;;;AAsGA,SAAgB,EAAiB,GAAoE;CACnG,IAAM,EAAE,WAAQ,GAAG,MAAS,GACtB,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAE3B,IAAkB,QAAc;EACpC,IAAM,oBAAO,IAAI,IAAY,GACvB,IAAgB,CAAC;EACvB,KAAK,IAAM,KAAS,GAAQ;GAC1B,IAAI,EAAM,YAAY,KAAA,GAAW;GACjC,IAAM,IAAM,EAAM,QAAQ,SAAS;GAC/B,EAAK,IAAI,CAAG,MAChB,EAAK,IAAI,CAAG,GACZ,EAAI,KAAK,EAAM,OAAO;EACxB;EACA,OAAO;CACT,GAAG,CAAC,CAAM,CAAC,GAEL,IAAU,EAA4B,GAAQ;EAClD,GAAG;EACH,SAAS,EAAK,WAAW;EACzB,UAAU;CACZ,CAAC,GAEK,IAAQ,EAAS;EACrB,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;CAED,OAAO,QAAc;EAEnB,IAAI,EAAgB,WAAW,GAC7B,OAAO;GACL,MAAM,EAAO,UAAU,IAAI;GAC3B,MAAM;GACN,UAAU;GACV,aAAa;GACb,iBAAiB,CAAC;GAClB,WAAW;GACX,OAAO;EACT;EAGF,IAAM,IAAO,EAAM;EACnB,IAAI,CAAC,GACH,OAAO;GACL,MAAM,EAAO,UAAU,IAAI;GAC3B,MAAM;GACN,UAAU;GACV,aAAa;GAEb,iBAAiB,CAAC,GAAG,CAAe;GACpC,WAAW,EAAM;GACjB,OAAO,EAAM,SAAS;EACxB;EAIF,IAAM,oBAAY,IAAI,IAA8B;EACpD,KAAK,IAAM,KAAO,EAAK,MAAM;GAC3B,IAAM,IAAM,EAAI,QAAQ,SAAS;GACjC,AAAK,EAAU,IAAI,CAAG,KAAG,EAAU,IAAI,GAAK,CAAG;EACjD;EAEA,IAAI,IAAO,IACP,IAAW;EAEf,KAAK,IAAM,KAAW,GAAiB;GACrC,IAAM,IAAM,EAAU,IAAI,EAAQ,SAAS,CAAC;GACxC,MAAQ,KAAA,MACZ,KAAQ,EAAI,MACZ,KAAY,EAAI;EAClB;EAOA,OAAO;GACL,MALW,EAAO,KAAK,MACvB,EAAM,YAAY,KAAA,IAAY,OAAQ,EAAU,IAAI,EAAM,QAAQ,SAAS,CAAC,KAAK,IAIjF;GACA;GACA;GAEA,aAAa,IAAW;GACxB,iBAAiB,EAAK;GACtB,WAAW,EAAM;GACjB,OAAO,EAAM,SAAS;EACxB;CACF,GAAG;EAAC;EAAiB;EAAQ,EAAM;EAAM,EAAM;EAAW,EAAM;CAAK,CAAC;AACxE"}
+{"version":3,"file":"use-quotes-funding.js","names":[],"sources":["../../src/quotes/use-quotes-funding.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getQuoteFundingQueryOptions,\n  type ConfigParameter,\n  type GetQuoteFundingOptions,\n  type QuoteFundingData,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { useMemo } from \"react\";\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/** Minimum quote shape `useQuotesFunding` needs: just the on-chain id. */\nexport interface QuotesFundingInputQuote {\n  /** On-chain quote id. Off-chain (pending) rows pass `undefined` and are skipped. */\n  quoteId?: bigint;\n}\n\n/**\n * Parameters for {@link useQuotesFunding}.\n */\nexport interface UseQuotesFundingParameters extends Omit<GetQuoteFundingOptions, \"quoteIds\">, ConfigParameter {\n  /**\n   * Quotes (or quote-id-bearing rows) to read funding for. Off-chain rows\n   * (`quoteId === undefined`) are silently skipped. The resolved on-chain ids are\n   * de-duplicated and fetched in a single subgraph round-trip, so listing the\n   * same quote twice costs one request and contributes to the sums once.\n   */\n  quotes: readonly QuotesFundingInputQuote[];\n}\n\n/**\n * Return type of {@link useQuotesFunding}.\n */\nexport interface UseQuotesFundingReturnType {\n  /**\n   * Funding row per input quote, aligned 1:1 with `quotes` and in input order —\n   * `rows.length === quotes.length` on every path, including while loading and\n   * when nothing on-chain was requested. An entry is `null` for an off-chain row\n   * (no `quoteId`) or for an id the subgraph has not surfaced yet.\n   */\n  rows: Array<QuoteFundingData | null>;\n  /**\n   * Σ funding paid across the resolved rows (wei). Summed over the **distinct**\n   * on-chain ids, so a quote listed twice contributes once.\n   */\n  paid: bigint;\n  /**\n   * Σ funding received across the resolved rows (wei). Summed over the\n   * **distinct** on-chain ids, so a quote listed twice contributes once.\n   */\n  received: bigint;\n  /**\n   * Σ `received − paid` across the resolved rows (wei). **Positive = the position\n   * earned funding**; negative = it paid for it. A lower bound while\n   * `missingQuoteIds` is non-empty.\n   */\n  netReceived: bigint;\n  /**\n   * Requested on-chain ids that have no funding row yet. While the query is in\n   * flight — and if it fails — this is **every** requested id, since nothing has\n   * resolved; once it settles it is the subset the subgraph did not return\n   * (indexing lag). Always empty when no on-chain ids were requested.\n   */\n  missingQuoteIds: bigint[];\n  /** `true` while the underlying subgraph query is loading. */\n  isLoading: boolean;\n  /** Normalized request error, when one occurred. */\n  error: SymmioRequestError | null;\n}\n\n/**\n * Batch-read funding totals for a list of quotes from the analytics subgraph in\n * a single round-trip and aggregate them into running sums for the group.\n *\n * The hook is the canonical entry point for both single-quote details panels\n * ({@link useQuoteFunding} delegates here with a 1-element list) and grouped\n * quote cards (which want `Σ netReceived`). Off-chain rows are skipped silently,\n * and duplicate ids are fetched — and summed — exactly once.\n *\n * **Sign convention** — `netReceived = received − paid`, the P&L perspective, so\n * a **positive** value means the position **earned** funding. This matches\n * `QuoteFundingData.netReceived` and the uPnL folds, and is the inverse of the\n * cost-positive on-chain `int256`. A \"green = income\" UI renders it directly.\n *\n * **Settled to date only** — the totals cover funding the protocol has already\n * charged and the analytics subgraph has indexed. Funding accrued since a\n * quote's last funding charge is not in the subgraph and is therefore not\n * included — read it on-chain with {@link useQuotesPendingFunding}. The two\n * come from different sources at different heights, so do not add them into a\n * lifetime total.\n *\n * @param parameters - The quotes to read funding for, plus optional chain/config overrides.\n * @returns Per-quote rows aligned with `quotes`, the aggregate sums, and query state.\n *\n * @example\n * ```tsx\n * const { rows, netReceived, missingQuoteIds, isLoading } = useQuotesFunding({ quotes: group.quotes });\n * // `netReceived > 0n` → the position earned funding across the resolved rows.\n * ```\n */\nexport function useQuotesFunding(parameters: UseQuotesFundingParameters): UseQuotesFundingReturnType {\n  const { quotes, ...rest } = parameters;\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n\n  const onchainQuoteIds = useMemo(() => {\n    const seen = new Set<string>();\n    const ids: bigint[] = [];\n    for (const quote of quotes) {\n      if (quote.quoteId === undefined) continue;\n      const key = quote.quoteId.toString();\n      if (seen.has(key)) continue;\n      seen.add(key);\n      ids.push(quote.quoteId);\n    }\n    return ids;\n  }, [quotes]);\n\n  const options = getQuoteFundingQueryOptions(config, {\n    ...rest,\n    chainId: rest.chainId ?? chainId,\n    quoteIds: onchainQuoteIds,\n  });\n\n  const query = useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseQueryResult<{ rows: QuoteFundingData[]; missingQuoteIds: bigint[] }, SymmioRequestError>;\n\n  return useMemo(() => {\n    /** Nothing on-chain to read: the query is disabled, but `rows` still owes one entry per input quote. */\n    if (onchainQuoteIds.length === 0) {\n      return {\n        rows: quotes.map(() => null),\n        paid: 0n,\n        received: 0n,\n        netReceived: 0n,\n        missingQuoteIds: [],\n        isLoading: false,\n        error: null,\n      };\n    }\n\n    const data = query.data;\n    if (!data) {\n      return {\n        rows: quotes.map(() => null),\n        paid: 0n,\n        received: 0n,\n        netReceived: 0n,\n        /** In flight (or failed): nothing resolved, so every requested id is still outstanding. */\n        missingQuoteIds: [...onchainQuoteIds],\n        isLoading: query.isLoading,\n        error: query.error ?? null,\n      };\n    }\n\n    /** First row wins per id — a repeated row for the same quote must not double-count. */\n    const byQuoteId = new Map<string, QuoteFundingData>();\n    for (const row of data.rows) {\n      const key = row.quoteId.toString();\n      if (!byQuoteId.has(key)) byQuoteId.set(key, row);\n    }\n\n    let paid = 0n;\n    let received = 0n;\n    /** Fold over the de-duped ids, never over `quotes` — the same id listed twice is fetched once and must sum once. */\n    for (const quoteId of onchainQuoteIds) {\n      const row = byQuoteId.get(quoteId.toString());\n      if (row === undefined) continue;\n      paid += row.paid;\n      received += row.received;\n    }\n\n    /** Built by lookup afterwards, so the 1:1 alignment with `quotes` is independent of the fold. */\n    const rows = quotes.map((quote) =>\n      quote.quoteId === undefined ? null : (byQuoteId.get(quote.quoteId.toString()) ?? null),\n    );\n\n    return {\n      rows,\n      paid,\n      received,\n      /** Derived from the sums so the aggregate keeps the row-level `netReceived = received − paid` invariant. */\n      netReceived: received - paid,\n      missingQuoteIds: data.missingQuoteIds,\n      isLoading: query.isLoading,\n      error: query.error ?? null,\n    };\n  }, [onchainQuoteIds, quotes, query.data, query.isLoading, query.error]);\n}\n"],"mappings":";;;;;;;;AAwGA,SAAgB,EAAiB,GAAoE;CACnG,IAAM,EAAE,WAAQ,GAAG,MAAS,GACtB,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAE3B,IAAkB,QAAc;EACpC,IAAM,oBAAO,IAAI,IAAY,GACvB,IAAgB,CAAC;EACvB,KAAK,IAAM,KAAS,GAAQ;GAC1B,IAAI,EAAM,YAAY,KAAA,GAAW;GACjC,IAAM,IAAM,EAAM,QAAQ,SAAS;GAC/B,EAAK,IAAI,CAAG,MAChB,EAAK,IAAI,CAAG,GACZ,EAAI,KAAK,EAAM,OAAO;EACxB;EACA,OAAO;CACT,GAAG,CAAC,CAAM,CAAC,GAEL,IAAU,EAA4B,GAAQ;EAClD,GAAG;EACH,SAAS,EAAK,WAAW;EACzB,UAAU;CACZ,CAAC,GAEK,IAAQ,EAAS;EACrB,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;CAED,OAAO,QAAc;EAEnB,IAAI,EAAgB,WAAW,GAC7B,OAAO;GACL,MAAM,EAAO,UAAU,IAAI;GAC3B,MAAM;GACN,UAAU;GACV,aAAa;GACb,iBAAiB,CAAC;GAClB,WAAW;GACX,OAAO;EACT;EAGF,IAAM,IAAO,EAAM;EACnB,IAAI,CAAC,GACH,OAAO;GACL,MAAM,EAAO,UAAU,IAAI;GAC3B,MAAM;GACN,UAAU;GACV,aAAa;GAEb,iBAAiB,CAAC,GAAG,CAAe;GACpC,WAAW,EAAM;GACjB,OAAO,EAAM,SAAS;EACxB;EAIF,IAAM,oBAAY,IAAI,IAA8B;EACpD,KAAK,IAAM,KAAO,EAAK,MAAM;GAC3B,IAAM,IAAM,EAAI,QAAQ,SAAS;GACjC,AAAK,EAAU,IAAI,CAAG,KAAG,EAAU,IAAI,GAAK,CAAG;EACjD;EAEA,IAAI,IAAO,IACP,IAAW;EAEf,KAAK,IAAM,KAAW,GAAiB;GACrC,IAAM,IAAM,EAAU,IAAI,EAAQ,SAAS,CAAC;GACxC,MAAQ,KAAA,MACZ,KAAQ,EAAI,MACZ,KAAY,EAAI;EAClB;EAOA,OAAO;GACL,MALW,EAAO,KAAK,MACvB,EAAM,YAAY,KAAA,IAAY,OAAQ,EAAU,IAAI,EAAM,QAAQ,SAAS,CAAC,KAAK,IAIjF;GACA;GACA;GAEA,aAAa,IAAW;GACxB,iBAAiB,EAAK;GACtB,WAAW,EAAM;GACjB,OAAO,EAAM,SAAS;EACxB;CACF,GAAG;EAAC;EAAiB;EAAQ,EAAM;EAAM,EAAM;EAAW,EAAM;CAAK,CAAC;AACxE"}

package/dist/quotes/use-quotes-pending-funding.d.ts

@@ -0,0 +1,92 @@
+import { ConfigParameter, GetQuotePendingFundingOptions, QuotePendingFunding, UnifiedQuote } from '@symmio/trading-core';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/**
+ * Parameters for {@link useQuotesPendingFunding}: the core query options minus
+ * `quoteIds` (derived from `quotes`) — chain id, batch size and TanStack `query`
+ * overrides — plus an optional `config`.
+ */
+export interface UseQuotesPendingFundingParameters extends Omit<GetQuotePendingFundingOptions, "quoteIds">, ConfigParameter {
+    /**
+     * Quotes to read (a `UnifiedQuote[]` fits). Only rows with a `quoteId` and a
+     * known active `quoteStatus` are read (see {@link isActiveQuoteStatus}); every
+     * other row is skipped and gets a `null` entry in `rows`. The readable ids are
+     * de-duplicated, so listing the same quote twice reads it once and sums it once.
+     */
+    quotes: readonly Pick<UnifiedQuote, "quoteId" | "quoteStatus">[];
+}
+/**
+ * Return type of {@link useQuotesPendingFunding}.
+ */
+export interface UseQuotesPendingFundingReturnType {
+    /**
+     * One entry per input quote, aligned by index — `rows.length === quotes.length`
+     * on every path. An entry is `null` for a row that is not read (no `quoteId`, or
+     * a status that is unknown or not an active position) or until the read resolves.
+     */
+    rows: readonly (QuotePendingFunding | null)[];
+    /**
+     * Σ `pendingNetReceived` over the **distinct** ids read, income-positive
+     * (`> 0n` the positions will receive funding, `< 0n` they owe it), 18-decimal
+     * collateral units. `undefined` until the read has resolved every one of those
+     * ids (like `useAccountUpnl`), so a partial sum is never mistaken for the total;
+     * `0n` when no quote is readable.
+     */
+    pendingNetReceived?: bigint;
+    /** `true` while the first read is in flight (no data yet). */
+    isLoading: boolean;
+    /** `true` while any read is in flight, including a background refetch. */
+    isFetching: boolean;
+    /** Normalized request error, when the read failed. */
+    error: SymmioRequestError | null;
+    /** Re-read the pending funding now. */
+    refetch: () => void;
+}
+/**
+ * Read the **pending** (accrued, not yet settled) accumulated funding of a list of
+ * quotes from the SYMMIO core diamond, per quote and as one total.
+ *
+ * Wraps core's `getQuotePendingFunding`, which reads the diamond view
+ * `getQuoteFundingDebts` and negates it, so every amount is **income-positive**
+ * like the rest of the SDK's funding amounts: `pendingNetReceived > 0n` means the
+ * position will receive funding, `< 0n` means it owes it. Each value is what the
+ * contract would settle if the quote were charged in the block the RPC ran the
+ * call against; it moves in whole-epoch steps and also changes when the solver
+ * updates its rates or the quote is charged, partially closed or liquidated. It is
+ * `0n` for pairs whose accumulated funding has not started.
+ *
+ * **Only active positions are read.** A row needs a `quoteId` and a known
+ * `quoteStatus` that is `OPENED`, `CLOSE_PENDING`, `CANCEL_CLOSE_PENDING` or
+ * `LIQUIDATED_PENDING` ({@link isActiveQuoteStatus}); anything else — an off-chain
+ * row, a `LOCKED` or `EXPIRED` quote, a row whose status is not known yet — is
+ * never sent and reads `null`. Readable ids are de-duplicated and read in core's
+ * sequential batches (`batchSize`, default 25); each batch is its own `eth_call`,
+ * so with more than one batch the rows can come from adjacent blocks.
+ *
+ * **No default polling.** The value grows with time even when nothing happens on
+ * the quote, and no event announces that — pass `query.refetchInterval` to keep it
+ * fresh. {@link useManagedQuotes} invalidates it together with its on-chain quote
+ * reads, and {@link useForceClose} after its receipt.
+ *
+ * **Settled vs pending.** Funding already charged is read from the analytics
+ * subgraph with {@link useQuotesFunding}. The two come from different sources at
+ * different heights, so do not add them into a lifetime total. A Muon-signed uPnL
+ * already includes accumulated funding — do not net pending funding against it.
+ *
+ * `chainId` defaults to the connected chain. Errors are normalized to
+ * {@link SymmioRequestError}.
+ *
+ * @param parameters - The quotes to read, plus optional chain id, batch size, TanStack `query` overrides and `config`.
+ * @returns Per-quote rows aligned with `quotes`, the total, and query state.
+ *
+ * @example
+ * ```tsx
+ * const { quotes } = useManagedQuotes({ partyA: subAccount });
+ * const { rows, pendingNetReceived, isLoading } = useQuotesPendingFunding({
+ *   quotes,
+ *   query: { refetchInterval: 60_000 },
+ * });
+ * // `pendingNetReceived > 0n` → the open positions will receive funding when it settles.
+ * ```
+ */
+export declare function useQuotesPendingFunding(parameters: UseQuotesPendingFundingParameters): UseQuotesPendingFundingReturnType;
+//# sourceMappingURL=use-quotes-pending-funding.d.ts.map

package/dist/quotes/use-quotes-pending-funding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-quotes-pending-funding.d.ts","sourceRoot":"","sources":["../../src/quotes/use-quotes-pending-funding.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAElC,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE;;;;GAIG;AACH,MAAM,WAAW,iCACf,SAAQ,IAAI,CAAC,6BAA6B,EAAE,UAAU,CAAC,EAAE,eAAe;IACxE;;;;;OAKG;IACH,MAAM,EAAE,SAAS,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,aAAa,CAAC,EAAE,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD;;;;OAIG;IACH,IAAI,EAAE,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,EAAE,CAAC;IAC9C;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACjC,uCAAuC;IACvC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,iCAAiC,GAC5C,iCAAiC,CAyGnC"}

package/dist/quotes/use-quotes-pending-funding.js

@@ -0,0 +1,94 @@
+"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 { getQuotePendingFundingQueryOptions as r, isActiveQuoteStatus as i } from "@symmio/trading-core";
+import { useCallback as a, useMemo as o } from "react";
+import { useQuery as s } from "@tanstack/react-query";
+//#region src/quotes/use-quotes-pending-funding.ts
+function c(e) {
+	if (!(e.quoteId === void 0 || e.quoteStatus === void 0)) return i(e.quoteStatus) ? e.quoteId : void 0;
+}
+function l(i) {
+	let { quotes: l, ...u } = i, d = t(i), f = e(), p = o(() => {
+		let e = /* @__PURE__ */ new Set(), t = [];
+		for (let n of l) {
+			let r = c(n);
+			if (r === void 0) continue;
+			let i = r.toString();
+			e.has(i) || (e.add(i), t.push(r));
+		}
+		return t;
+	}, [l]), m = r(d, {
+		...u,
+		chainId: u.chainId ?? f,
+		quoteIds: p
+	}), h = s({
+		...m,
+		queryFn: async () => {
+			try {
+				return await m.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	}), { refetch: g } = h, _ = a(() => {
+		g();
+	}, [g]);
+	return o(() => {
+		if (p.length === 0) return {
+			rows: l.map(() => null),
+			pendingNetReceived: 0n,
+			isLoading: !1,
+			isFetching: !1,
+			error: null,
+			refetch: _
+		};
+		let e = h.data;
+		if (!e) return {
+			rows: l.map(() => null),
+			pendingNetReceived: void 0,
+			isLoading: h.isLoading,
+			isFetching: h.isFetching,
+			error: h.error ?? null,
+			refetch: _
+		};
+		let t = /* @__PURE__ */ new Map();
+		for (let n of e) {
+			let e = n.quoteId.toString();
+			t.has(e) || t.set(e, n);
+		}
+		let n = 0n, r = !0;
+		for (let e of p) {
+			let i = t.get(e.toString());
+			if (i === void 0) {
+				r = !1;
+				break;
+			}
+			n += i.pendingNetReceived;
+		}
+		return {
+			rows: l.map((e) => {
+				let n = c(e);
+				return n === void 0 ? null : t.get(n.toString()) ?? null;
+			}),
+			pendingNetReceived: r ? n : void 0,
+			isLoading: h.isLoading,
+			isFetching: h.isFetching,
+			error: h.error ?? null,
+			refetch: _
+		};
+	}, [
+		p,
+		l,
+		h.data,
+		h.isLoading,
+		h.isFetching,
+		h.error,
+		_
+	]);
+}
+//#endregion
+export { l as useQuotesPendingFunding };
+
+//# sourceMappingURL=use-quotes-pending-funding.js.map

package/dist/quotes/use-quotes-pending-funding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-quotes-pending-funding.js","names":[],"sources":["../../src/quotes/use-quotes-pending-funding.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getQuotePendingFundingQueryOptions,\n  isActiveQuoteStatus,\n  type ConfigParameter,\n  type GetQuotePendingFundingOptions,\n  type GetQuotePendingFundingReturnType,\n  type QuotePendingFunding,\n  type UnifiedQuote,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { useCallback, useMemo } from \"react\";\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/**\n * Parameters for {@link useQuotesPendingFunding}: the core query options minus\n * `quoteIds` (derived from `quotes`) — chain id, batch size and TanStack `query`\n * overrides — plus an optional `config`.\n */\nexport interface UseQuotesPendingFundingParameters\n  extends Omit<GetQuotePendingFundingOptions, \"quoteIds\">, ConfigParameter {\n  /**\n   * Quotes to read (a `UnifiedQuote[]` fits). Only rows with a `quoteId` and a\n   * known active `quoteStatus` are read (see {@link isActiveQuoteStatus}); every\n   * other row is skipped and gets a `null` entry in `rows`. The readable ids are\n   * de-duplicated, so listing the same quote twice reads it once and sums it once.\n   */\n  quotes: readonly Pick<UnifiedQuote, \"quoteId\" | \"quoteStatus\">[];\n}\n\n/**\n * Return type of {@link useQuotesPendingFunding}.\n */\nexport interface UseQuotesPendingFundingReturnType {\n  /**\n   * One entry per input quote, aligned by index — `rows.length === quotes.length`\n   * on every path. An entry is `null` for a row that is not read (no `quoteId`, or\n   * a status that is unknown or not an active position) or until the read resolves.\n   */\n  rows: readonly (QuotePendingFunding | null)[];\n  /**\n   * Σ `pendingNetReceived` over the **distinct** ids read, income-positive\n   * (`> 0n` the positions will receive funding, `< 0n` they owe it), 18-decimal\n   * collateral units. `undefined` until the read has resolved every one of those\n   * ids (like `useAccountUpnl`), so a partial sum is never mistaken for the total;\n   * `0n` when no quote is readable.\n   */\n  pendingNetReceived?: bigint;\n  /** `true` while the first read is in flight (no data yet). */\n  isLoading: boolean;\n  /** `true` while any read is in flight, including a background refetch. */\n  isFetching: boolean;\n  /** Normalized request error, when the read failed. */\n  error: SymmioRequestError | null;\n  /** Re-read the pending funding now. */\n  refetch: () => void;\n}\n\n/**\n * The quote's on-chain id when its pending funding is meaningful to read — it has\n * an id and a **known, active** on-chain status — else `undefined`. The diamond\n * view does not check status, so a quote a solver locked but never opened would\n * otherwise read as a large, growing and meaningless amount.\n */\nfunction readableQuoteId(quote: Pick<UnifiedQuote, \"quoteId\" | \"quoteStatus\">): bigint | undefined {\n  if (quote.quoteId === undefined || quote.quoteStatus === undefined) return undefined;\n  return isActiveQuoteStatus(quote.quoteStatus) ? quote.quoteId : undefined;\n}\n\n/**\n * Read the **pending** (accrued, not yet settled) accumulated funding of a list of\n * quotes from the SYMMIO core diamond, per quote and as one total.\n *\n * Wraps core's `getQuotePendingFunding`, which reads the diamond view\n * `getQuoteFundingDebts` and negates it, so every amount is **income-positive**\n * like the rest of the SDK's funding amounts: `pendingNetReceived > 0n` means the\n * position will receive funding, `< 0n` means it owes it. Each value is what the\n * contract would settle if the quote were charged in the block the RPC ran the\n * call against; it moves in whole-epoch steps and also changes when the solver\n * updates its rates or the quote is charged, partially closed or liquidated. It is\n * `0n` for pairs whose accumulated funding has not started.\n *\n * **Only active positions are read.** A row needs a `quoteId` and a known\n * `quoteStatus` that is `OPENED`, `CLOSE_PENDING`, `CANCEL_CLOSE_PENDING` or\n * `LIQUIDATED_PENDING` ({@link isActiveQuoteStatus}); anything else — an off-chain\n * row, a `LOCKED` or `EXPIRED` quote, a row whose status is not known yet — is\n * never sent and reads `null`. Readable ids are de-duplicated and read in core's\n * sequential batches (`batchSize`, default 25); each batch is its own `eth_call`,\n * so with more than one batch the rows can come from adjacent blocks.\n *\n * **No default polling.** The value grows with time even when nothing happens on\n * the quote, and no event announces that — pass `query.refetchInterval` to keep it\n * fresh. {@link useManagedQuotes} invalidates it together with its on-chain quote\n * reads, and {@link useForceClose} after its receipt.\n *\n * **Settled vs pending.** Funding already charged is read from the analytics\n * subgraph with {@link useQuotesFunding}. The two come from different sources at\n * different heights, so do not add them into a lifetime total. A Muon-signed uPnL\n * already includes accumulated funding — do not net pending funding against it.\n *\n * `chainId` defaults to the connected chain. Errors are normalized to\n * {@link SymmioRequestError}.\n *\n * @param parameters - The quotes to read, plus optional chain id, batch size, TanStack `query` overrides and `config`.\n * @returns Per-quote rows aligned with `quotes`, the total, and query state.\n *\n * @example\n * ```tsx\n * const { quotes } = useManagedQuotes({ partyA: subAccount });\n * const { rows, pendingNetReceived, isLoading } = useQuotesPendingFunding({\n *   quotes,\n *   query: { refetchInterval: 60_000 },\n * });\n * // `pendingNetReceived > 0n` → the open positions will receive funding when it settles.\n * ```\n */\nexport function useQuotesPendingFunding(\n  parameters: UseQuotesPendingFundingParameters,\n): UseQuotesPendingFundingReturnType {\n  const { quotes, ...rest } = parameters;\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n\n  const readableQuoteIds = useMemo(() => {\n    const seen = new Set<string>();\n    const ids: bigint[] = [];\n    for (const quote of quotes) {\n      const quoteId = readableQuoteId(quote);\n      if (quoteId === undefined) continue;\n      const key = quoteId.toString();\n      if (seen.has(key)) continue;\n      seen.add(key);\n      ids.push(quoteId);\n    }\n    return ids;\n  }, [quotes]);\n\n  const options = getQuotePendingFundingQueryOptions(config, {\n    ...rest,\n    chainId: rest.chainId ?? chainId,\n    quoteIds: readableQuoteIds,\n  });\n\n  const query = useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseQueryResult<GetQuotePendingFundingReturnType, SymmioRequestError>;\n\n  const { refetch: refetchQuery } = query;\n  const refetch = useCallback(() => {\n    void refetchQuery();\n  }, [refetchQuery]);\n\n  return useMemo(() => {\n    /** Nothing readable: the query is disabled, but `rows` still owes one entry per input quote. */\n    if (readableQuoteIds.length === 0) {\n      return {\n        rows: quotes.map(() => null),\n        pendingNetReceived: 0n,\n        isLoading: false,\n        isFetching: false,\n        error: null,\n        refetch,\n      };\n    }\n\n    const data = query.data;\n    if (!data) {\n      return {\n        rows: quotes.map(() => null),\n        pendingNetReceived: undefined,\n        isLoading: query.isLoading,\n        isFetching: query.isFetching,\n        error: query.error ?? null,\n        refetch,\n      };\n    }\n\n    /** First row wins per id — a repeated row for the same quote must not double-count. */\n    const byQuoteId = new Map<string, QuotePendingFunding>();\n    for (const row of data) {\n      const key = row.quoteId.toString();\n      if (!byQuoteId.has(key)) byQuoteId.set(key, row);\n    }\n\n    /**\n     * Fold over the de-duped ids, never over `quotes` — the same id listed twice is\n     * read once and must sum once. An id the data does not cover (caller-supplied\n     * `placeholderData` from another id set, or a view that answered short) leaves the\n     * total unresolved rather than silently partial.\n     */\n    let total = 0n;\n    let complete = true;\n    for (const quoteId of readableQuoteIds) {\n      const row = byQuoteId.get(quoteId.toString());\n      if (row === undefined) {\n        complete = false;\n        break;\n      }\n      total += row.pendingNetReceived;\n    }\n\n    /** Built by lookup afterwards, so the 1:1 alignment with `quotes` is independent of the fold. */\n    const rows = quotes.map((quote) => {\n      const quoteId = readableQuoteId(quote);\n      return quoteId === undefined ? null : (byQuoteId.get(quoteId.toString()) ?? null);\n    });\n\n    return {\n      rows,\n      pendingNetReceived: complete ? total : undefined,\n      isLoading: query.isLoading,\n      isFetching: query.isFetching,\n      error: query.error ?? null,\n      refetch,\n    };\n  }, [readableQuoteIds, quotes, query.data, query.isLoading, query.isFetching, query.error, refetch]);\n}\n"],"mappings":";;;;;;;;AAoEA,SAAS,EAAgB,GAA0E;CAC7F,QAAM,YAAY,KAAA,KAAa,EAAM,gBAAgB,KAAA,IACzD,OAAO,EAAoB,EAAM,WAAW,IAAI,EAAM,UAAU,KAAA;AAClE;AAiDA,SAAgB,EACd,GACmC;CACnC,IAAM,EAAE,WAAQ,GAAG,MAAS,GACtB,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAE3B,IAAmB,QAAc;EACrC,IAAM,oBAAO,IAAI,IAAY,GACvB,IAAgB,CAAC;EACvB,KAAK,IAAM,KAAS,GAAQ;GAC1B,IAAM,IAAU,EAAgB,CAAK;GACrC,IAAI,MAAY,KAAA,GAAW;GAC3B,IAAM,IAAM,EAAQ,SAAS;GACzB,EAAK,IAAI,CAAG,MAChB,EAAK,IAAI,CAAG,GACZ,EAAI,KAAK,CAAO;EAClB;EACA,OAAO;CACT,GAAG,CAAC,CAAM,CAAC,GAEL,IAAU,EAAmC,GAAQ;EACzD,GAAG;EACH,SAAS,EAAK,WAAW;EACzB,UAAU;CACZ,CAAC,GAEK,IAAQ,EAAS;EACrB,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC,GAEK,EAAE,SAAS,MAAiB,GAC5B,IAAU,QAAkB;EAChC,EAAkB;CACpB,GAAG,CAAC,CAAY,CAAC;CAEjB,OAAO,QAAc;EAEnB,IAAI,EAAiB,WAAW,GAC9B,OAAO;GACL,MAAM,EAAO,UAAU,IAAI;GAC3B,oBAAoB;GACpB,WAAW;GACX,YAAY;GACZ,OAAO;GACP;EACF;EAGF,IAAM,IAAO,EAAM;EACnB,IAAI,CAAC,GACH,OAAO;GACL,MAAM,EAAO,UAAU,IAAI;GAC3B,oBAAoB,KAAA;GACpB,WAAW,EAAM;GACjB,YAAY,EAAM;GAClB,OAAO,EAAM,SAAS;GACtB;EACF;EAIF,IAAM,oBAAY,IAAI,IAAiC;EACvD,KAAK,IAAM,KAAO,GAAM;GACtB,IAAM,IAAM,EAAI,QAAQ,SAAS;GACjC,AAAK,EAAU,IAAI,CAAG,KAAG,EAAU,IAAI,GAAK,CAAG;EACjD;EAQA,IAAI,IAAQ,IACR,IAAW;EACf,KAAK,IAAM,KAAW,GAAkB;GACtC,IAAM,IAAM,EAAU,IAAI,EAAQ,SAAS,CAAC;GAC5C,IAAI,MAAQ,KAAA,GAAW;IACrB,IAAW;IACX;GACF;GACA,KAAS,EAAI;EACf;EAQA,OAAO;GACL,MANW,EAAO,KAAK,MAAU;IACjC,IAAM,IAAU,EAAgB,CAAK;IACrC,OAAO,MAAY,KAAA,IAAY,OAAQ,EAAU,IAAI,EAAQ,SAAS,CAAC,KAAK;GAC9E,CAGE;GACA,oBAAoB,IAAW,IAAQ,KAAA;GACvC,WAAW,EAAM;GACjB,YAAY,EAAM;GAClB,OAAO,EAAM,SAAS;GACtB;EACF;CACF,GAAG;EAAC;EAAkB;EAAQ,EAAM;EAAM,EAAM;EAAW,EAAM;EAAY,EAAM;EAAO;CAAO,CAAC;AACpG"}

package/dist/quotes/use-request-to-cancel-close-request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-request-to-cancel-close-request.d.ts","sourceRoot":"","sources":["../../src/quotes/use-request-to-cancel-close-request.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,qCAAqC,EAC3C,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG7F,6DAA6D;AAC7D,MAAM,MAAM,wCAAwC,GAAG,eAAe,CAAC;AAEvE,8EAA8E;AAC9E,MAAM,MAAM,iCAAiC,GAAG,WAAW,CAAC;AAE5D,6DAA6D;AAC7D,MAAM,MAAM,wCAAwC,GAAG,iBAAiB,CACtE,iCAAiC,EACjC,kBAAkB,EAClB,qCAAqC,CACtC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,GAAE,wCAA6C,GACxD,wCAAwC,CAmC1C"}
+{"version":3,"file":"use-request-to-cancel-close-request.d.ts","sourceRoot":"","sources":["../../src/quotes/use-request-to-cancel-close-request.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,qCAAqC,EAC3C,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG7F,6DAA6D;AAC7D,MAAM,MAAM,wCAAwC,GAAG,eAAe,CAAC;AAEvE,8EAA8E;AAC9E,MAAM,MAAM,iCAAiC,GAAG,WAAW,CAAC;AAE5D,6DAA6D;AAC7D,MAAM,MAAM,wCAAwC,GAAG,iBAAiB,CACtE,iCAAiC,EACjC,kBAAkB,EAClB,qCAAqC,CACtC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,GAAE,wCAA6C,GACxD,wCAAwC,CA6B1C"}

package/dist/quotes/use-request-to-cancel-close-request.js

@@ -15,10 +15,7 @@ function l(l = {}) {
 			try {
 				let t = e.chainId ?? d;
 				return r(u, await p.mutationFn({
-					account: e.account,
-					quoteId: e.quoteId,
-					from: e.from,
-					simulateBeforeWrite: e.simulateBeforeWrite,
+					...e,
 					chainId: t
 				}), {
 					chainId: t,

package/dist/quotes/use-request-to-cancel-close-request.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-request-to-cancel-close-request.js","names":[],"sources":["../../src/quotes/use-request-to-cancel-close-request.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getPartyAOpenPositionsQueryKey,\n  requestToCancelCloseRequestMutationOptions,\n  type RequestToCancelCloseRequestParameters,\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, type WriteParameters, type WriteResult } from \"../transactions\";\nimport { predicateMatch } from \"../utils\";\n\n/** Parameters for {@link useRequestToCancelCloseRequest}. */\nexport type UseRequestToCancelCloseRequestParameters = WriteParameters;\n\n/** Result returned by the {@link useRequestToCancelCloseRequest} mutation. */\nexport type RequestToCancelCloseRequestResult = WriteResult;\n\n/** Return type of {@link useRequestToCancelCloseRequest}. */\nexport type UseRequestToCancelCloseRequestReturnType = UseMutationResult<\n  RequestToCancelCloseRequestResult,\n  SymmioRequestError,\n  RequestToCancelCloseRequestParameters\n>;\n\n/**\n * Cancel a pending close (`requestToCancelCloseRequest`, routed through the\n * AccountLayer `_call` proxy) — how a partyA backs out of a resting close (e.g.\n * a limit close) while the quote is `CLOSE_PENDING`. If partyB accepts, the quote\n * returns to `OPENED`; if partyB stalls it enters `CANCEL_CLOSE_PENDING`, which\n * {@link useForceCancelCloseRequest} escalates once the cooldown passes. On\n * success (after the receipt) the subaccount's open-positions read is invalidated\n * so the row's status refreshes.\n *\n * @example\n * ```tsx\n * const { mutate } = useRequestToCancelCloseRequest();\n * mutate({ account: \"0xsub…\", quoteId: 42n });\n * ```\n */\nexport function useRequestToCancelCloseRequest(\n  parameters: UseRequestToCancelCloseRequestParameters = {},\n): UseRequestToCancelCloseRequestReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = requestToCancelCloseRequestMutationOptions(config);\n\n  return useMutation<RequestToCancelCloseRequestResult, SymmioRequestError, RequestToCancelCloseRequestParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const resolvedChainId = variables.chainId ?? chainId;\n        const hash = await base.mutationFn({\n          account: variables.account,\n          quoteId: variables.quoteId,\n          from: variables.from,\n          simulateBeforeWrite: variables.simulateBeforeWrite,\n          chainId: resolvedChainId,\n        });\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      // The close-cancel flips the position out of CLOSE_PENDING — refetch the\n      // owning partyA's open positions so the status updates.\n      const partial = { partyA: variables.account };\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getPartyAOpenPositionsQueryKey, partial) });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AA2CA,SAAgB,EACd,IAAuD,CAAC,GACd;CAC1C,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAA2C,CAAM;CAE9D,OAAO,EAA0G;EAC/G,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,IAAM,IAAkB,EAAU,WAAW;IAQ7C,OAAO,EAAmB,GAAQ,MAPf,EAAK,WAAW;KACjC,SAAS,EAAU;KACnB,SAAS,EAAU;KACnB,MAAM,EAAU;KAChB,qBAAqB,EAAU;KAC/B,SAAS;IACX,CAAC,GACuC;KACtC,SAAS;KACT,gBAAgB,EAAW;KAC3B,eAAe,EAAW;IAC5B,CAAC;GACH,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,YAAY,GAAS,MAAc;GAGjC,IAAM,IAAU,EAAE,QAAQ,EAAU,QAAQ;GAC5C,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAgC,CAAO,EAAE,CAAC;EAC3G;CACF,CAAC;AACH"}
+{"version":3,"file":"use-request-to-cancel-close-request.js","names":[],"sources":["../../src/quotes/use-request-to-cancel-close-request.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getPartyAOpenPositionsQueryKey,\n  requestToCancelCloseRequestMutationOptions,\n  type RequestToCancelCloseRequestParameters,\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, type WriteParameters, type WriteResult } from \"../transactions\";\nimport { predicateMatch } from \"../utils\";\n\n/** Parameters for {@link useRequestToCancelCloseRequest}. */\nexport type UseRequestToCancelCloseRequestParameters = WriteParameters;\n\n/** Result returned by the {@link useRequestToCancelCloseRequest} mutation. */\nexport type RequestToCancelCloseRequestResult = WriteResult;\n\n/** Return type of {@link useRequestToCancelCloseRequest}. */\nexport type UseRequestToCancelCloseRequestReturnType = UseMutationResult<\n  RequestToCancelCloseRequestResult,\n  SymmioRequestError,\n  RequestToCancelCloseRequestParameters\n>;\n\n/**\n * Cancel a pending close (`requestToCancelCloseRequest`, routed through the\n * AccountLayer `_call` proxy) — how a partyA backs out of a resting close (e.g.\n * a limit close) while the quote is `CLOSE_PENDING`. If partyB accepts, the quote\n * returns to `OPENED`; if partyB stalls it enters `CANCEL_CLOSE_PENDING`, which\n * {@link useForceCancelCloseRequest} escalates once the cooldown passes. On\n * success (after the receipt) the subaccount's open-positions read is invalidated\n * so the row's status refreshes.\n *\n * @example\n * ```tsx\n * const { mutate } = useRequestToCancelCloseRequest();\n * mutate({ account: \"0xsub…\", quoteId: 42n });\n * ```\n */\nexport function useRequestToCancelCloseRequest(\n  parameters: UseRequestToCancelCloseRequestParameters = {},\n): UseRequestToCancelCloseRequestReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = requestToCancelCloseRequestMutationOptions(config);\n\n  return useMutation<RequestToCancelCloseRequestResult, SymmioRequestError, RequestToCancelCloseRequestParameters>({\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      // The close-cancel flips the position out of CLOSE_PENDING — refetch the\n      // owning partyA's open positions so the status updates.\n      const partial = { partyA: variables.account };\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getPartyAOpenPositionsQueryKey, partial) });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AA2CA,SAAgB,EACd,IAAuD,CAAC,GACd;CAC1C,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAA2C,CAAM;CAE9D,OAAO,EAA0G;EAC/G,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;GAGjC,IAAM,IAAU,EAAE,QAAQ,EAAU,QAAQ;GAC5C,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAgC,CAAO,EAAE,CAAC;EAC3G;CACF,CAAC;AACH"}

package/dist/quotes/use-request-to-cancel-quote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-request-to-cancel-quote.d.ts","sourceRoot":"","sources":["../../src/quotes/use-request-to-cancel-quote.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,8BAA8B,EACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG7F,sDAAsD;AACtD,MAAM,MAAM,iCAAiC,GAAG,eAAe,CAAC;AAEhE,uEAAuE;AACvE,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAC;AAErD,sDAAsD;AACtD,MAAM,MAAM,iCAAiC,GAAG,iBAAiB,CAC/D,0BAA0B,EAC1B,kBAAkB,EAClB,8BAA8B,CAC/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,GAAE,iCAAsC,GACjD,iCAAiC,CA2DnC"}
+{"version":3,"file":"use-request-to-cancel-quote.d.ts","sourceRoot":"","sources":["../../src/quotes/use-request-to-cancel-quote.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,8BAA8B,EACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG7F,sDAAsD;AACtD,MAAM,MAAM,iCAAiC,GAAG,eAAe,CAAC;AAEhE,uEAAuE;AACvE,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAC;AAErD,sDAAsD;AACtD,MAAM,MAAM,iCAAiC,GAAG,iBAAiB,CAC/D,0BAA0B,EAC1B,kBAAkB,EAClB,8BAA8B,CAC/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,GAAE,iCAAsC,GACjD,iCAAiC,CAqDnC"}

package/dist/quotes/use-request-to-cancel-quote.js

@@ -16,10 +16,7 @@ function f(f = {}) {
 			try {
 				let t = e.chainId ?? m;
 				return r(p, await g.mutationFn({
-					account: e.account,
-					quoteId: e.quoteId,
-					from: e.from,
-					simulateBeforeWrite: e.simulateBeforeWrite,
+					...e,
 					chainId: t
 				}), {
 					chainId: t,

package/dist/quotes/use-request-to-cancel-quote.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-request-to-cancel-quote.js","names":[],"sources":["../../src/quotes/use-request-to-cancel-quote.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getPartyAPendingQuotesQueryKey,\n  getPendingQuotesQueryKey,\n  getQuoteQueryKey,\n  requestToCancelQuoteMutationOptions,\n  type RequestToCancelQuoteParameters,\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, type WriteParameters, type WriteResult } from \"../transactions\";\nimport { invalidateAccountBalances, predicateMatch } from \"../utils\";\n\n/** Parameters for {@link useRequestToCancelQuote}. */\nexport type UseRequestToCancelQuoteParameters = WriteParameters;\n\n/** Result returned by the {@link useRequestToCancelQuote} mutation. */\nexport type RequestToCancelQuoteResult = WriteResult;\n\n/** Return type of {@link useRequestToCancelQuote}. */\nexport type UseRequestToCancelQuoteReturnType = UseMutationResult<\n  RequestToCancelQuoteResult,\n  SymmioRequestError,\n  RequestToCancelQuoteParameters\n>;\n\n/**\n * Cancel a pending quote (`requestToCancelQuote`, routed through the AccountLayer\n * `_call` proxy) — how a partyA cancels a resting **LIMIT order**. On success\n * (after the receipt), the subaccount's pending-quotes reads and the quote's own\n * `getQuote` read are invalidated.\n *\n * The order only leaves the list immediately when it was `PENDING` (unlocked): the\n * contract cancels it outright. A `LOCKED` order instead moves to `CANCEL_PENDING`\n * and **stays** in `partyAPendingQuotes` until the solver calls\n * `acceptCancelRequest` — a transaction this mutation never sees and the\n * notifications stream never announces. `useManagedQuotes` and `useLimitOrders`\n * chase that on-chain, so a list fed by either drops the row on its own; a consumer\n * reading `getPartyAPendingQuotes` directly has to poll.\n *\n * @example\n * ```tsx\n * const { mutate } = useRequestToCancelQuote();\n * mutate({ account: \"0xsub…\", quoteId: 42n });\n * ```\n */\nexport function useRequestToCancelQuote(\n  parameters: UseRequestToCancelQuoteParameters = {},\n): UseRequestToCancelQuoteReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = requestToCancelQuoteMutationOptions(config);\n\n  return useMutation<RequestToCancelQuoteResult, SymmioRequestError, RequestToCancelQuoteParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const resolvedChainId = variables.chainId ?? chainId;\n        const hash = await base.mutationFn({\n          account: variables.account,\n          quoteId: variables.quoteId,\n          from: variables.from,\n          simulateBeforeWrite: variables.simulateBeforeWrite,\n          chainId: resolvedChainId,\n        });\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      /**\n       * Refetch both pending reads (full quotes + ids) for this partyA, plus the\n       * per-id `getQuote` hydration — that is the read carrying `quoteStatus`, so\n       * without it a `useManagedQuotes` consumer keeps rendering the pre-cancel\n       * status even after the id list refreshes.\n       *\n       * This fires on the receipt of the **request**, which only proves the quote\n       * reached `CANCEL_PENDING` when it was `LOCKED`. The transaction that ends the\n       * order is the solver's `acceptCancelRequest`, which is not announced on the\n       * notifications stream; `useManagedQuotes` / `useLimitOrders` chase it from the\n       * cancel notification instead.\n       */\n      const partial = { partyA: variables.account };\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getPendingQuotesQueryKey, partial) });\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getPartyAPendingQuotesQueryKey, partial) });\n      void queryClient.invalidateQueries({\n        predicate: predicateMatch(getQuoteQueryKey, { quoteId: variables.quoteId }),\n      });\n      /**\n       * Cancelling a `PENDING` quote refunds its open trading fee and releases the\n       * margin it had reserved in the same transaction, so every balance read is now\n       * stale. On the `LOCKED` branch nothing moves yet — the refund happens inside\n       * the solver's later `acceptCancelRequest`, which no frame announces; the\n       * cancel-confirm chase in `useManagedQuotes` re-reads the balances for that.\n       */\n      invalidateAccountBalances(queryClient, {\n        configKey: config.getChainConfigKey(variables.chainId ?? chainId),\n      });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;AAkDA,SAAgB,EACd,IAAgD,CAAC,GACd;CACnC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAAoC,CAAM;CAEvD,OAAO,EAA4F;EACjG,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,IAAM,IAAkB,EAAU,WAAW;IAQ7C,OAAO,EAAmB,GAAQ,MAPf,EAAK,WAAW;KACjC,SAAS,EAAU;KACnB,SAAS,EAAU;KACnB,MAAM,EAAU;KAChB,qBAAqB,EAAU;KAC/B,SAAS;IACX,CAAC,GACuC;KACtC,SAAS;KACT,gBAAgB,EAAW;KAC3B,eAAe,EAAW;IAC5B,CAAC;GACH,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;EACA,YAAY,GAAS,MAAc;GAajC,IAAM,IAAU,EAAE,QAAQ,EAAU,QAAQ;GAa5C,AAZA,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA0B,CAAO,EAAE,CAAC,GACnG,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAgC,CAAO,EAAE,CAAC,GACzG,EAAiB,kBAAkB,EACjC,WAAW,EAAe,GAAkB,EAAE,SAAS,EAAU,QAAQ,CAAC,EAC5E,CAAC,GAQD,EAA0B,GAAa,EACrC,WAAW,EAAO,kBAAkB,EAAU,WAAW,CAAO,EAClE,CAAC;EACH;CACF,CAAC;AACH"}
+{"version":3,"file":"use-request-to-cancel-quote.js","names":[],"sources":["../../src/quotes/use-request-to-cancel-quote.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getPartyAPendingQuotesQueryKey,\n  getPendingQuotesQueryKey,\n  getQuoteQueryKey,\n  requestToCancelQuoteMutationOptions,\n  type RequestToCancelQuoteParameters,\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, type WriteParameters, type WriteResult } from \"../transactions\";\nimport { invalidateAccountBalances, predicateMatch } from \"../utils\";\n\n/** Parameters for {@link useRequestToCancelQuote}. */\nexport type UseRequestToCancelQuoteParameters = WriteParameters;\n\n/** Result returned by the {@link useRequestToCancelQuote} mutation. */\nexport type RequestToCancelQuoteResult = WriteResult;\n\n/** Return type of {@link useRequestToCancelQuote}. */\nexport type UseRequestToCancelQuoteReturnType = UseMutationResult<\n  RequestToCancelQuoteResult,\n  SymmioRequestError,\n  RequestToCancelQuoteParameters\n>;\n\n/**\n * Cancel a pending quote (`requestToCancelQuote`, routed through the AccountLayer\n * `_call` proxy) — how a partyA cancels a resting **LIMIT order**. On success\n * (after the receipt), the subaccount's pending-quotes reads and the quote's own\n * `getQuote` read are invalidated.\n *\n * The order only leaves the list immediately when it was `PENDING` (unlocked): the\n * contract cancels it outright. A `LOCKED` order instead moves to `CANCEL_PENDING`\n * and **stays** in `partyAPendingQuotes` until the solver calls\n * `acceptCancelRequest` — a transaction this mutation never sees and the\n * notifications stream never announces. `useManagedQuotes` and `useLimitOrders`\n * chase that on-chain, so a list fed by either drops the row on its own; a consumer\n * reading `getPartyAPendingQuotes` directly has to poll.\n *\n * @example\n * ```tsx\n * const { mutate } = useRequestToCancelQuote();\n * mutate({ account: \"0xsub…\", quoteId: 42n });\n * ```\n */\nexport function useRequestToCancelQuote(\n  parameters: UseRequestToCancelQuoteParameters = {},\n): UseRequestToCancelQuoteReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = requestToCancelQuoteMutationOptions(config);\n\n  return useMutation<RequestToCancelQuoteResult, SymmioRequestError, RequestToCancelQuoteParameters>({\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      /**\n       * Refetch both pending reads (full quotes + ids) for this partyA, plus the\n       * per-id `getQuote` hydration — that is the read carrying `quoteStatus`, so\n       * without it a `useManagedQuotes` consumer keeps rendering the pre-cancel\n       * status even after the id list refreshes.\n       *\n       * This fires on the receipt of the **request**, which only proves the quote\n       * reached `CANCEL_PENDING` when it was `LOCKED`. The transaction that ends the\n       * order is the solver's `acceptCancelRequest`, which is not announced on the\n       * notifications stream; `useManagedQuotes` / `useLimitOrders` chase it from the\n       * cancel notification instead.\n       */\n      const partial = { partyA: variables.account };\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getPendingQuotesQueryKey, partial) });\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getPartyAPendingQuotesQueryKey, partial) });\n      void queryClient.invalidateQueries({\n        predicate: predicateMatch(getQuoteQueryKey, { quoteId: variables.quoteId }),\n      });\n      /**\n       * Cancelling a `PENDING` quote refunds its open trading fee and releases the\n       * margin it had reserved in the same transaction, so every balance read is now\n       * stale. On the `LOCKED` branch nothing moves yet — the refund happens inside\n       * the solver's later `acceptCancelRequest`, which no frame announces; the\n       * cancel-confirm chase in `useManagedQuotes` re-reads the balances for that.\n       */\n      invalidateAccountBalances(queryClient, {\n        configKey: config.getChainConfigKey(variables.chainId ?? chainId),\n      });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;AAkDA,SAAgB,EACd,IAAgD,CAAC,GACd;CACnC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAAoC,CAAM;CAEvD,OAAO,EAA4F;EACjG,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;GAajC,IAAM,IAAU,EAAE,QAAQ,EAAU,QAAQ;GAa5C,AAZA,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAA0B,CAAO,EAAE,CAAC,GACnG,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAgC,CAAO,EAAE,CAAC,GACzG,EAAiB,kBAAkB,EACjC,WAAW,EAAe,GAAkB,EAAE,SAAS,EAAU,QAAQ,CAAC,EAC5E,CAAC,GAQD,EAA0B,GAAa,EACrC,WAAW,EAAO,kBAAkB,EAAU,WAAW,CAAO,EAClE,CAAC;EACH;CACF,CAAC;AACH"}

package/dist/transactions/index.js

@@ -1,3 +1,3 @@
-import { resolveWriteResult as e } from "./resolve-write-result.js";
-import { useTransactionsStore as t } from "./use-transactions-store.js";
-export { e as resolveWriteResult, t as useTransactionsStore };
+import { TransactionRevertedError as e, resolveWriteResult as t } from "./resolve-write-result.js";
+import { useTransactionsStore as n } from "./use-transactions-store.js";
+export { e as TransactionRevertedError, t as resolveWriteResult, n as useTransactionsStore };

package/dist/transactions/resolve-write-result.d.ts

@@ -1,5 +1,6 @@
 import { Config } from '@symmio/trading-core';
-import { Hash } from 'viem';
+import { Hash, TransactionReceipt } from 'viem';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
 import { WriteResult } from './write-types.js';
 /**
  * Options for {@link resolveWriteResult}.
@@ -18,16 +19,66 @@ interface ResolveWriteResultOptions {
     /** Confirmations to wait for when `waitForReceipt` is true. Defaults to `1`. */
     confirmations?: number;
 }
+/**
+ * The error every write hook throws when its transaction was mined but reverted
+ * on-chain.
+ *
+ * A subclass of {@link SymmioRequestError} with `kind: "contract-revert"`, so
+ * existing consumer branches (`error.kind === "contract-revert"`) keep working
+ * unchanged and {@link normalizeSymmError} passes it through untouched. It adds
+ * the `hash` and the mined `receipt` on top, so a UI can link the failure to a
+ * block explorer and read `gasUsed` / `blockNumber` without unwrapping `cause`.
+ *
+ * @example
+ * ```ts
+ * const { error } = useAllocate();
+ * if (error instanceof TransactionRevertedError) {
+ *   return <a href={`${explorer}/tx/${error.hash}`}>Transaction reverted</a>;
+ * }
+ * ```
+ */
+export declare class TransactionRevertedError extends SymmioRequestError {
+    /** The reverted transaction's hash. */
+    readonly hash: Hash;
+    /** The mined receipt whose `status` is `"reverted"`. */
+    readonly receipt: TransactionReceipt;
+    /**
+     * @param options - The submitted hash and the mined receipt that reported the revert.
+     */
+    constructor(options: {
+        hash: Hash;
+        receipt: TransactionReceipt;
+    });
+}
 /**
  * Shared tail of every write hook's `mutationFn`. Given a submitted transaction
  * `hash`, either return it immediately (`waitForReceipt: false`) or poll for the
  * mined receipt and return both. Applies the package-wide write defaults
  * (`waitForReceipt: true`, `confirmations: 1`).
  *
+ * A mined-but-reverted transaction is a **failure**, not a result: it throws
+ * {@link TransactionRevertedError} instead of returning, so the hook's
+ * `onSuccess` (and its cache invalidation) never runs for a write that applied
+ * nothing.
+ *
+ * **A relayed write waits on its request, not on its first hash.** When the
+ * dispatcher relayed the write, the hash it returned is only the relayer's
+ * first broadcast: a gas bump or a stuck nonce makes the service replace it,
+ * and waiting on a replaced hash waits forever. So a relayed write is followed
+ * through `confirmGaslessRequest`, which resolves on the terminal record, and
+ * the result reports that record's hash plus `gasless: { requestId,
+ * broadcastHash }`. A relay that ends `reverted` / `failed` / `rejected` throws
+ * the typed gasless error carrying the record, instead of
+ * {@link TransactionRevertedError}, because the relayer's verdict names the
+ * cause and a receipt for the replaced hash may not exist at all.
+ *
  * @param config - The SDK config (its `getClient` resolves the polling client).
  * @param hash - The submitted transaction hash.
  * @param options - Chain id and receipt-wait behavior.
- * @returns The hash, plus the receipt when `waitForReceipt` is enabled.
+ * @returns The hash, plus the receipt when `waitForReceipt` is enabled, plus `gasless` for a relayed write.
+ * @throws {TransactionRevertedError} when the mined receipt's `status` is `"reverted"`.
+ * @throws {SymmApiError} `GASLESS_RELAY_REVERTED` / `GASLESS_RELAY_FAILED` /
+ *   `GASLESS_RELAY_REJECTED` when a relayed write's request ends non-succeeded.
  *
  * @example
  * ```ts

package/dist/transactions/resolve-write-result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-write-result.d.ts","sourceRoot":"","sources":["../../src/transactions/resolve-write-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,UAAU,yBAAyB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,WAAW,CAAC,CAKtB"}
+{"version":3,"file":"resolve-write-result.d.ts","sourceRoot":"","sources":["../../src/transactions/resolve-write-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,MAAM,EAEZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,UAAU,yBAAyB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,wBAAyB,SAAQ,kBAAkB;IAC9D,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAErC;;OAEG;gBACS,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,kBAAkB,CAAA;KAAE;CASjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,WAAW,CAAC,CAmBtB"}

package/dist/transactions/resolve-write-result.js

@@ -1,15 +1,58 @@
+import { SymmioRequestError as e } from "../errors/symmio-request-error.js";
+import { confirmGaslessRequest as t, getGaslessWriteRequest as n } from "@symmio/trading-core";
 //#region src/transactions/resolve-write-result.ts
-async function e(e, t, n = {}) {
-	let { chainId: r, waitForReceipt: i = !0, confirmations: a = 1 } = n;
-	return i ? {
-		hash: t,
-		receipt: await e.getClient({ chainId: r }).waitForTransactionReceipt({
-			hash: t,
-			confirmations: a
-		})
+var r = class extends e {
+	hash;
+	receipt;
+	constructor(e) {
+		super({
+			kind: "contract-revert",
+			code: "TRANSACTION_REVERTED",
+			message: `Transaction ${e.hash} was mined but reverted on-chain — no state change was applied.`
+		}), this.hash = e.hash, this.receipt = e.receipt;
+	}
+};
+async function i(e, t, i = {}) {
+	let { chainId: s, waitForReceipt: c = !0, confirmations: l = 1 } = i, u = n(e, { hash: t });
+	if (!c) return u ? {
+		hash: t,
+		gasless: a(u)
 	} : { hash: t };
+	if (u) return o(e, u, l);
+	let d = await e.getClient({ chainId: s }).waitForTransactionReceipt({
+		hash: t,
+		confirmations: l
+	});
+	if (d?.status === "reverted") throw new r({
+		hash: t,
+		receipt: d
+	});
+	return {
+		hash: t,
+		receipt: d
+	};
+}
+function a(e) {
+	return {
+		requestId: e.requestId,
+		broadcastHash: e.broadcastHash
+	};
+}
+async function o(e, n, r) {
+	let i = await t(e, {
+		chainId: n.chainId,
+		requestId: n.requestId,
+		service: n.service,
+		until: "receipt",
+		receiptConfirmations: r
+	});
+	return {
+		hash: i.txHash,
+		receipt: i.receipt,
+		gasless: a(n)
+	};
 }
 //#endregion
-export { e as resolveWriteResult };
+export { r as TransactionRevertedError, i as resolveWriteResult };
 
 //# sourceMappingURL=resolve-write-result.js.map

package/dist/transactions/resolve-write-result.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-write-result.js","names":[],"sources":["../../src/transactions/resolve-write-result.ts"],"sourcesContent":["import type { Config } from \"@symmio/trading-core\";\nimport type { Hash } from \"viem\";\nimport type { WriteResult } from \"./write-types\";\n\n/**\n * Options for {@link resolveWriteResult}.\n */\ninterface ResolveWriteResultOptions {\n  /**\n   * Chain the transaction was submitted on. Resolves the public client that\n   * polls for the receipt; omit to use the config's default chain.\n   */\n  chainId?: number;\n  /**\n   * Resolve only after the receipt is mined (default `true`). When `false`,\n   * resolve immediately with just the hash.\n   */\n  waitForReceipt?: boolean;\n  /** Confirmations to wait for when `waitForReceipt` is true. Defaults to `1`. */\n  confirmations?: number;\n}\n\n/**\n * Shared tail of every write hook's `mutationFn`. Given a submitted transaction\n * `hash`, either return it immediately (`waitForReceipt: false`) or poll for the\n * mined receipt and return both. Applies the package-wide write defaults\n * (`waitForReceipt: true`, `confirmations: 1`).\n *\n * @param config - The SDK config (its `getClient` resolves the polling client).\n * @param hash - The submitted transaction hash.\n * @param options - Chain id and receipt-wait behavior.\n * @returns The hash, plus the receipt when `waitForReceipt` is enabled.\n *\n * @example\n * ```ts\n * const hash = await base.mutationFn({ ...variables, chainId });\n * return resolveWriteResult(config, hash, { chainId, waitForReceipt, confirmations });\n * ```\n */\nexport async function resolveWriteResult(\n  config: Config,\n  hash: Hash,\n  options: ResolveWriteResultOptions = {},\n): Promise<WriteResult> {\n  const { chainId, waitForReceipt = true, confirmations = 1 } = options;\n  if (!waitForReceipt) return { hash };\n  const receipt = await config.getClient({ chainId }).waitForTransactionReceipt({ hash, confirmations });\n  return { hash, receipt };\n}\n"],"mappings":";AAuCA,eAAsB,EACpB,GACA,GACA,IAAqC,CAAC,GAChB;CACtB,IAAM,EAAE,YAAS,oBAAiB,IAAM,mBAAgB,MAAM;CAG9D,OAFK,IAEE;EAAE;EAAM,SAAA,MADO,EAAO,UAAU,EAAE,WAAQ,CAAC,EAAE,0BAA0B;GAAE;GAAM;EAAc,CAAC;CAC9E,IAFK,EAAE,QAAK;AAGrC"}
+{"version":3,"file":"resolve-write-result.js","names":[],"sources":["../../src/transactions/resolve-write-result.ts"],"sourcesContent":["import {\n  confirmGaslessRequest,\n  getGaslessWriteRequest,\n  type Config,\n  type GaslessWriteRequest,\n} from \"@symmio/trading-core\";\nimport type { Hash, TransactionReceipt } from \"viem\";\nimport { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport type { WriteResult } from \"./write-types\";\n\n/**\n * Options for {@link resolveWriteResult}.\n */\ninterface ResolveWriteResultOptions {\n  /**\n   * Chain the transaction was submitted on. Resolves the public client that\n   * polls for the receipt; omit to use the config's default chain.\n   */\n  chainId?: number;\n  /**\n   * Resolve only after the receipt is mined (default `true`). When `false`,\n   * resolve immediately with just the hash.\n   */\n  waitForReceipt?: boolean;\n  /** Confirmations to wait for when `waitForReceipt` is true. Defaults to `1`. */\n  confirmations?: number;\n}\n\n/**\n * The error every write hook throws when its transaction was mined but reverted\n * on-chain.\n *\n * A subclass of {@link SymmioRequestError} with `kind: \"contract-revert\"`, so\n * existing consumer branches (`error.kind === \"contract-revert\"`) keep working\n * unchanged and {@link normalizeSymmError} passes it through untouched. It adds\n * the `hash` and the mined `receipt` on top, so a UI can link the failure to a\n * block explorer and read `gasUsed` / `blockNumber` without unwrapping `cause`.\n *\n * @example\n * ```ts\n * const { error } = useAllocate();\n * if (error instanceof TransactionRevertedError) {\n *   return <a href={`${explorer}/tx/${error.hash}`}>Transaction reverted</a>;\n * }\n * ```\n */\nexport class TransactionRevertedError extends SymmioRequestError {\n  /** The reverted transaction's hash. */\n  readonly hash: Hash;\n  /** The mined receipt whose `status` is `\"reverted\"`. */\n  readonly receipt: TransactionReceipt;\n\n  /**\n   * @param options - The submitted hash and the mined receipt that reported the revert.\n   */\n  constructor(options: { hash: Hash; receipt: TransactionReceipt }) {\n    super({\n      kind: \"contract-revert\",\n      code: \"TRANSACTION_REVERTED\",\n      message: `Transaction ${options.hash} was mined but reverted on-chain — no state change was applied.`,\n    });\n    this.hash = options.hash;\n    this.receipt = options.receipt;\n  }\n}\n\n/**\n * Shared tail of every write hook's `mutationFn`. Given a submitted transaction\n * `hash`, either return it immediately (`waitForReceipt: false`) or poll for the\n * mined receipt and return both. Applies the package-wide write defaults\n * (`waitForReceipt: true`, `confirmations: 1`).\n *\n * A mined-but-reverted transaction is a **failure**, not a result: it throws\n * {@link TransactionRevertedError} instead of returning, so the hook's\n * `onSuccess` (and its cache invalidation) never runs for a write that applied\n * nothing.\n *\n * **A relayed write waits on its request, not on its first hash.** When the\n * dispatcher relayed the write, the hash it returned is only the relayer's\n * first broadcast: a gas bump or a stuck nonce makes the service replace it,\n * and waiting on a replaced hash waits forever. So a relayed write is followed\n * through `confirmGaslessRequest`, which resolves on the terminal record, and\n * the result reports that record's hash plus `gasless: { requestId,\n * broadcastHash }`. A relay that ends `reverted` / `failed` / `rejected` throws\n * the typed gasless error carrying the record, instead of\n * {@link TransactionRevertedError}, because the relayer's verdict names the\n * cause and a receipt for the replaced hash may not exist at all.\n *\n * @param config - The SDK config (its `getClient` resolves the polling client).\n * @param hash - The submitted transaction hash.\n * @param options - Chain id and receipt-wait behavior.\n * @returns The hash, plus the receipt when `waitForReceipt` is enabled, plus `gasless` for a relayed write.\n * @throws {TransactionRevertedError} when the mined receipt's `status` is `\"reverted\"`.\n * @throws {SymmApiError} `GASLESS_RELAY_REVERTED` / `GASLESS_RELAY_FAILED` /\n *   `GASLESS_RELAY_REJECTED` when a relayed write's request ends non-succeeded.\n *\n * @example\n * ```ts\n * const hash = await base.mutationFn({ ...variables, chainId });\n * return resolveWriteResult(config, hash, { chainId, waitForReceipt, confirmations });\n * ```\n */\nexport async function resolveWriteResult(\n  config: Config,\n  hash: Hash,\n  options: ResolveWriteResultOptions = {},\n): Promise<WriteResult> {\n  const { chainId, waitForReceipt = true, confirmations = 1 } = options;\n  const relayed = getGaslessWriteRequest(config, { hash });\n\n  if (!waitForReceipt) {\n    return relayed ? { hash, gasless: relayedHandle(relayed) } : { hash };\n  }\n  if (relayed) return resolveRelayedWriteResult(config, relayed, confirmations);\n  const receipt = await config.getClient({ chainId }).waitForTransactionReceipt({ hash, confirmations });\n  /**\n   * Load-bearing, do not \"simplify\" away: viem does **not** throw for a reverted\n   * transaction. `waitForTransactionReceipt` resolves normally and reports the\n   * failure only through `receipt.status === \"reverted\"`. Without this explicit\n   * check the shared write tail returns a success result for a transaction that\n   * changed nothing, and every write hook — gasless and wallet alike — fires\n   * `onSuccess`, invalidates its caches, and renders the write as applied.\n   */\n  if (receipt?.status === \"reverted\") throw new TransactionRevertedError({ hash, receipt });\n  return { hash, receipt };\n}\n\n/** The part of a relay a write result carries: the durable id, and the hash that was shown. */\nfunction relayedHandle(relayed: GaslessWriteRequest): NonNullable<WriteResult[\"gasless\"]> {\n  return { requestId: relayed.requestId, broadcastHash: relayed.broadcastHash };\n}\n\n/**\n * Follow a relayed write to its terminal record and report the hash that\n * actually mined. The receipt comes from *this config's* client, so the\n * invalidation that follows re-reads a node that has seen the block.\n */\nasync function resolveRelayedWriteResult(\n  config: Config,\n  relayed: GaslessWriteRequest,\n  confirmations: number,\n): Promise<WriteResult> {\n  const confirmed = await confirmGaslessRequest(config, {\n    chainId: relayed.chainId,\n    requestId: relayed.requestId,\n    service: relayed.service,\n    until: \"receipt\",\n    receiptConfirmations: confirmations,\n  });\n  return { hash: confirmed.txHash, receipt: confirmed.receipt, gasless: relayedHandle(relayed) };\n}\n"],"mappings":";;;AA8CA,IAAa,IAAb,cAA8C,EAAmB;CAE/D;CAEA;CAKA,YAAY,GAAsD;EAOhE,AANA,MAAM;GACJ,MAAM;GACN,MAAM;GACN,SAAS,eAAe,EAAQ,KAAK;EACvC,CAAC,GACD,KAAK,OAAO,EAAQ,MACpB,KAAK,UAAU,EAAQ;CACzB;AACF;AAsCA,eAAsB,EACpB,GACA,GACA,IAAqC,CAAC,GAChB;CACtB,IAAM,EAAE,YAAS,oBAAiB,IAAM,mBAAgB,MAAM,GACxD,IAAU,EAAuB,GAAQ,EAAE,QAAK,CAAC;CAEvD,IAAI,CAAC,GACH,OAAO,IAAU;EAAE;EAAM,SAAS,EAAc,CAAO;CAAE,IAAI,EAAE,QAAK;CAEtE,IAAI,GAAS,OAAO,EAA0B,GAAQ,GAAS,CAAa;CAC5E,IAAM,IAAU,MAAM,EAAO,UAAU,EAAE,WAAQ,CAAC,EAAE,0BAA0B;EAAE;EAAM;CAAc,CAAC;CASrG,IAAI,GAAS,WAAW,YAAY,MAAM,IAAI,EAAyB;EAAE;EAAM;CAAQ,CAAC;CACxF,OAAO;EAAE;EAAM;CAAQ;AACzB;AAGA,SAAS,EAAc,GAAmE;CACxF,OAAO;EAAE,WAAW,EAAQ;EAAW,eAAe,EAAQ;CAAc;AAC9E;AAOA,eAAe,EACb,GACA,GACA,GACsB;CACtB,IAAM,IAAY,MAAM,EAAsB,GAAQ;EACpD,SAAS,EAAQ;EACjB,WAAW,EAAQ;EACnB,SAAS,EAAQ;EACjB,OAAO;EACP,sBAAsB;CACxB,CAAC;CACD,OAAO;EAAE,MAAM,EAAU;EAAQ,SAAS,EAAU;EAAS,SAAS,EAAc,CAAO;CAAE;AAC/F"}

package/dist/transactions/write-types.d.ts

@@ -20,9 +20,27 @@ export interface WriteParameters extends ConfigParameter {
  * mined receipt when `waitForReceipt` is enabled.
  */
 export interface WriteResult {
-    /** The submitted transaction hash. */
+    /**
+     * The transaction hash the write landed on. For a relayed (gasless) write
+     * this is the **terminal** hash the request actually mined, which is not
+     * necessarily the relayer's first broadcast — see
+     * {@link WriteResult.gasless}.
+     */
     hash: Hash;
     /** The mined receipt, present when `waitForReceipt` is enabled. */
     receipt?: TransactionReceipt;
+    /**
+     * Present only when the write was relayed through GaslessQ instead of the
+     * wallet. The `requestId` is the workflow's stable handle — persist it, it is
+     * what survives a replaced transaction and a reload — while `broadcastHash`
+     * is the relayer's first attempt, kept so a UI that already showed it can
+     * reconcile.
+     */
+    gasless?: {
+        /** Stable service tracking id of the relay request. */
+        requestId: string;
+        /** The relayer's first broadcast hash, which `hash` may supersede. */
+        broadcastHash: Hash;
+    };
 }
 //# sourceMappingURL=write-types.d.ts.map

package/dist/transactions/write-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-types.d.ts","sourceRoot":"","sources":["../../src/transactions/write-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,IAAI,EAAE,IAAI,CAAC;IACX,mEAAmE;IACnE,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B"}
+{"version":3,"file":"write-types.d.ts","sourceRoot":"","sources":["../../src/transactions/write-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,EAAE,IAAI,CAAC;IACX,mEAAmE;IACnE,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE;QACR,uDAAuD;QACvD,SAAS,EAAE,MAAM,CAAC;QAClB,sEAAsE;QACtE,aAAa,EAAE,IAAI,CAAC;KACrB,CAAC;CACH"}

package/dist/utils/predicate-match.d.ts

@@ -5,13 +5,16 @@ import { Query, QueryKey } from '@tanstack/react-query';
  *
  * A cache entry matches when:
  * 1. its key's leading tag equals the factory's tag (the key's first segment), and
- * 2. for every field in the partial, the key's trailing options object has an
- *    equal value. Omitted fields match anything.
+ * 2. for every field the partial sets, the key's trailing options object has an
+ *    equal value. Omitted (or `undefined`) fields match anything.
  *
  * Both the partial and the stored keys are run through the same factory, so
  * `bigint` values are compared in the decimal-string form the factory emits.
- * This enables "invalidate every subaccount query for `user`, regardless of
- * pagination or chain" — which TanStack's leading-prefix matching can't express.
+ * A default the factory fills in for an omitted field (an omitted gasless
+ * `walletId` keys as `0n`) is not compared, so leaving that field out still
+ * matches every value of it. This enables "invalidate every subaccount query for
+ * `user`, regardless of pagination or chain" — which TanStack's leading-prefix
+ * matching can't express.
  *
  * @param keyFn - A core query-key factory, e.g. `getUserSubAccountsQueryKey`.
  * @param partial - Fields to match on. Omit to match every entry from `keyFn`.

package/dist/utils/predicate-match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"predicate-match.d.ts","sourceRoot":"","sources":["../../src/utils/predicate-match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,MAAM,EACnD,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,SAAS,OAAO,EAAE,EAChD,OAAO,CAAC,EAAE,OAAO,GAChB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,OAAO,CAoB9D"}
+{"version":3,"file":"predicate-match.d.ts","sourceRoot":"","sources":["../../src/utils/predicate-match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,MAAM,EACnD,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,SAAS,OAAO,EAAE,EAChD,OAAO,CAAC,EAAE,OAAO,GAChB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,OAAO,CAuB9D"}