@symmio/trading-react 3.0.0 → 3.1.0

package/dist/account-layer/use-request-to-register-affiliate.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-request-to-register-affiliate.js","names":[],"sources":["../../src/account-layer/use-request-to-register-affiliate.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getAffiliateStateQueryKey,\n  requestToRegisterAffiliateMutationOptions,\n  type RequestToRegisterAffiliateParameters,\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/**\n * Parameters for {@link useRequestToRegisterAffiliate}.\n */\nexport type UseRequestToRegisterAffiliateParameters = WriteParameters;\n\n/**\n * Result returned by the {@link useRequestToRegisterAffiliate} mutation.\n */\nexport type RequestToRegisterAffiliateResult = WriteResult;\n\n/** Return type of {@link useRequestToRegisterAffiliate}. */\nexport type UseRequestToRegisterAffiliateReturnType = UseMutationResult<\n  RequestToRegisterAffiliateResult,\n  SymmioRequestError,\n  RequestToRegisterAffiliateParameters\n>;\n\n/**\n * Submit a `requestToRegisterAffiliate` transaction — the permissionless\n * on-chain request that creates a `PENDING` affiliate awaiting approval. On\n * success, every `getAffiliateState` query is invalidated so any mounted status\n * poll refetches.\n *\n * The registration is faithful to the contract tuple: `stakeholders` shares plus\n * `symmioShare` must sum to `1e18`. Derive the resulting affiliate address with\n * `useGeneratedAccountManagerAddress` (a write cannot return it).\n *\n * @example\n * ```tsx\n * const { mutate, status, error } = useRequestToRegisterAffiliate();\n * mutate({\n *   registration: {\n *     name: \"Acme\",\n *     brandColor: \"#ff5c39\",\n *     admin,\n *     stakeholders: [{ receiver: admin, share: 900000000000000000n }],\n *     symmioShare: 100000000000000000n,\n *     metadata: \"0x\",\n *     legacyMultiAccounts: [],\n *     symmioCores: [core],\n *   },\n * });\n * ```\n */\nexport function useRequestToRegisterAffiliate(\n  parameters: UseRequestToRegisterAffiliateParameters = {},\n): UseRequestToRegisterAffiliateReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = requestToRegisterAffiliateMutationOptions(config);\n\n  return useMutation<RequestToRegisterAffiliateResult, SymmioRequestError, RequestToRegisterAffiliateParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const resolvedChainId = variables.chainId ?? chainId;\n        const hash = await base.mutationFn({\n          registration: variables.registration,\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: () => {\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getAffiliateStateQueryKey) });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AA2DA,SAAgB,EACd,IAAsD,CAAC,GACd;CACzC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAA0C,CAAM;CAE7D,OAAO,EAAwG;EAC7G,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,IAAM,IAAkB,EAAU,WAAW;IAM7C,OAAO,EAAmB,GAAQ,MALf,EAAK,WAAW;KACjC,cAAc,EAAU;KACxB,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,iBAAiB;GACf,EAAiB,kBAAkB,EAAE,WAAW,EAAe,CAAyB,EAAE,CAAC;EAC7F;CACF,CAAC;AACH"}
+{"version":3,"file":"use-request-to-register-affiliate.js","names":[],"sources":["../../src/account-layer/use-request-to-register-affiliate.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getAffiliateStateQueryKey,\n  requestToRegisterAffiliateMutationOptions,\n  type RequestToRegisterAffiliateParameters,\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/**\n * Parameters for {@link useRequestToRegisterAffiliate}.\n */\nexport type UseRequestToRegisterAffiliateParameters = WriteParameters;\n\n/**\n * Result returned by the {@link useRequestToRegisterAffiliate} mutation.\n */\nexport type RequestToRegisterAffiliateResult = WriteResult;\n\n/** Return type of {@link useRequestToRegisterAffiliate}. */\nexport type UseRequestToRegisterAffiliateReturnType = UseMutationResult<\n  RequestToRegisterAffiliateResult,\n  SymmioRequestError,\n  RequestToRegisterAffiliateParameters\n>;\n\n/**\n * Submit a `requestToRegisterAffiliate` transaction — the permissionless\n * on-chain request that creates a `PENDING` affiliate awaiting approval. On\n * success, every `getAffiliateState` query is invalidated so any mounted status\n * poll refetches.\n *\n * The registration is faithful to the contract tuple: `stakeholders` shares plus\n * `symmioShare` must sum to `1e18`. Derive the resulting affiliate address with\n * `useGeneratedAccountManagerAddress` (a write cannot return it).\n *\n * @example\n * ```tsx\n * const { mutate, status, error } = useRequestToRegisterAffiliate();\n * mutate({\n *   registration: {\n *     name: \"Acme\",\n *     brandColor: \"#ff5c39\",\n *     admin,\n *     stakeholders: [{ receiver: admin, share: 900000000000000000n }],\n *     symmioShare: 100000000000000000n,\n *     metadata: \"0x\",\n *     legacyMultiAccounts: [],\n *     symmioCores: [core],\n *   },\n * });\n * ```\n */\nexport function useRequestToRegisterAffiliate(\n  parameters: UseRequestToRegisterAffiliateParameters = {},\n): UseRequestToRegisterAffiliateReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const queryClient = useQueryClient();\n\n  const base = requestToRegisterAffiliateMutationOptions(config);\n\n  return useMutation<RequestToRegisterAffiliateResult, SymmioRequestError, RequestToRegisterAffiliateParameters>({\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: () => {\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getAffiliateStateQueryKey) });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AA2DA,SAAgB,EACd,IAAsD,CAAC,GACd;CACzC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAc,EAAe,GAE7B,IAAO,EAA0C,CAAM;CAE7D,OAAO,EAAwG;EAC7G,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,iBAAiB;GACf,EAAiB,kBAAkB,EAAE,WAAW,EAAe,CAAyB,EAAE,CAAC;EAC7F;CACF,CAAC;AACH"}

package/dist/collateral/use-approve-collateral.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-approve-collateral.d.ts","sourceRoot":"","sources":["../../src/collateral/use-approve-collateral.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG7F;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,eAAe,CAAC;AAE7D,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC;AAElD,mDAAmD;AACnD,MAAM,MAAM,8BAA8B,GAAG,iBAAiB,CAC5D,uBAAuB,EACvB,kBAAkB,EAClB,2BAA2B,CAC5B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,GAAE,8BAAmC,GAAG,8BAA8B,CAgCpH"}
+{"version":3,"file":"use-approve-collateral.d.ts","sourceRoot":"","sources":["../../src/collateral/use-approve-collateral.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG7F;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,eAAe,CAAC;AAE7D,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC;AAElD,mDAAmD;AACnD,MAAM,MAAM,8BAA8B,GAAG,iBAAiB,CAC5D,uBAAuB,EACvB,kBAAkB,EAClB,2BAA2B,CAC5B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,GAAE,8BAAmC,GAAG,8BAA8B,CA4BpH"}

package/dist/collateral/use-approve-collateral.js

@@ -16,8 +16,7 @@ function u(u = {}) {
 			try {
 				let t = e.chainId ?? f;
 				return r(d, await h.mutationFn({
-					amount: e.amount,
-					simulateBeforeWrite: e.simulateBeforeWrite,
+					...e,
 					chainId: t
 				}), {
 					chainId: t,

package/dist/collateral/use-approve-collateral.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-approve-collateral.js","names":[],"sources":["../../src/collateral/use-approve-collateral.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  approveCollateralMutationOptions,\n  getCollateralAllowanceQueryKey,\n  type ApproveCollateralParameters,\n} from \"@symmio/trading-core\";\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\nimport { useConnection } from \"wagmi\";\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/**\n * Parameters for {@link useApproveCollateral}.\n */\nexport type UseApproveCollateralParameters = WriteParameters;\n\n/** Result returned by the {@link useApproveCollateral} mutation. */\nexport type ApproveCollateralResult = WriteResult;\n\n/** Return type of {@link useApproveCollateral}. */\nexport type UseApproveCollateralReturnType = UseMutationResult<\n  ApproveCollateralResult,\n  SymmioRequestError,\n  ApproveCollateralParameters\n>;\n\n/**\n * Submit an ERC20 `approve` of the collateral token to the SYMMIO core — the\n * prerequisite for `useDeposit` / `useDepositAndAllocate`. On success, the\n * connected wallet's collateral allowance query is invalidated so a gating\n * \"needs approval\" check refetches.\n *\n * @example\n * ```tsx\n * import { maxUint256 } from \"viem\";\n * const { mutate, status, error } = useApproveCollateral();\n * mutate({ amount: maxUint256 });\n * ```\n */\nexport function useApproveCollateral(parameters: UseApproveCollateralParameters = {}): UseApproveCollateralReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const { address } = useConnection();\n  const queryClient = useQueryClient();\n\n  const base = approveCollateralMutationOptions(config);\n\n  return useMutation<ApproveCollateralResult, SymmioRequestError, ApproveCollateralParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        const resolvedChainId = variables.chainId ?? chainId;\n        const hash = await base.mutationFn({\n          amount: variables.amount,\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: () => {\n      const partial = address ? { owner: address } : undefined;\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getCollateralAllowanceQueryKey, partial) });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;AA4CA,SAAgB,EAAqB,IAA6C,CAAC,GAAmC;CACpH,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,EAAE,eAAY,EAAc,GAC5B,IAAc,EAAe,GAE7B,IAAO,EAAiC,CAAM;CAEpD,OAAO,EAAsF;EAC3F,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,IAAM,IAAkB,EAAU,WAAW;IAM7C,OAAO,EAAmB,GAAQ,MALf,EAAK,WAAW;KACjC,QAAQ,EAAU;KAClB,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,iBAAiB;GACf,IAAM,IAAU,IAAU,EAAE,OAAO,EAAQ,IAAI,KAAA;GAC/C,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAgC,CAAO,EAAE,CAAC;EAC3G;CACF,CAAC;AACH"}
+{"version":3,"file":"use-approve-collateral.js","names":[],"sources":["../../src/collateral/use-approve-collateral.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  approveCollateralMutationOptions,\n  getCollateralAllowanceQueryKey,\n  type ApproveCollateralParameters,\n} from \"@symmio/trading-core\";\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\nimport { useConnection } from \"wagmi\";\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/**\n * Parameters for {@link useApproveCollateral}.\n */\nexport type UseApproveCollateralParameters = WriteParameters;\n\n/** Result returned by the {@link useApproveCollateral} mutation. */\nexport type ApproveCollateralResult = WriteResult;\n\n/** Return type of {@link useApproveCollateral}. */\nexport type UseApproveCollateralReturnType = UseMutationResult<\n  ApproveCollateralResult,\n  SymmioRequestError,\n  ApproveCollateralParameters\n>;\n\n/**\n * Submit an ERC20 `approve` of the collateral token to the SYMMIO core — the\n * prerequisite for `useDeposit` / `useDepositAndAllocate`. On success, the\n * connected wallet's collateral allowance query is invalidated so a gating\n * \"needs approval\" check refetches.\n *\n * @example\n * ```tsx\n * import { maxUint256 } from \"viem\";\n * const { mutate, status, error } = useApproveCollateral();\n * mutate({ amount: maxUint256 });\n * ```\n */\nexport function useApproveCollateral(parameters: UseApproveCollateralParameters = {}): UseApproveCollateralReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const { address } = useConnection();\n  const queryClient = useQueryClient();\n\n  const base = approveCollateralMutationOptions(config);\n\n  return useMutation<ApproveCollateralResult, SymmioRequestError, ApproveCollateralParameters>({\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: () => {\n      const partial = address ? { owner: address } : undefined;\n      void queryClient.invalidateQueries({ predicate: predicateMatch(getCollateralAllowanceQueryKey, partial) });\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;AA4CA,SAAgB,EAAqB,IAA6C,CAAC,GAAmC;CACpH,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,EAAE,eAAY,EAAc,GAC5B,IAAc,EAAe,GAE7B,IAAO,EAAiC,CAAM;CAEpD,OAAO,EAAsF;EAC3F,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,iBAAiB;GACf,IAAM,IAAU,IAAU,EAAE,OAAO,EAAQ,IAAI,KAAA;GAC/C,EAAiB,kBAAkB,EAAE,WAAW,EAAe,GAAgC,CAAO,EAAE,CAAC;EAC3G;CACF,CAAC;AACH"}

package/dist/errors/normalize-symm-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-symm-error.d.ts","sourceRoot":"","sources":["../../src/errors/normalize-symm-error.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAsFnE"}
+{"version":3,"file":"normalize-symm-error.d.ts","sourceRoot":"","sources":["../../src/errors/normalize-symm-error.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAuFnE"}

package/dist/errors/normalize-symm-error.js

@@ -10,6 +10,7 @@ function d(r) {
 		code: r.code,
 		status: r.status,
 		responseData: r.responseData,
+		retryAfterMs: r.retryAfterMs,
 		cause: r
 	});
 	if (r instanceof n) return new e({

package/dist/errors/normalize-symm-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-symm-error.js","names":[],"sources":["../../src/errors/normalize-symm-error.ts"],"sourcesContent":["import { SymmApiError, SymmError } from \"@symmio/trading-core\";\nimport {\n  BaseError,\n  ContractFunctionRevertedError,\n  EstimateGasExecutionError,\n  HttpRequestError,\n  InsufficientFundsError,\n  TimeoutError,\n  TransactionExecutionError,\n  UserRejectedRequestError,\n} from \"viem\";\nimport { SymmioRequestError } from \"./symmio-request-error\";\n\n/**\n * Classify any thrown value into a {@link SymmioRequestError}. Hooks call this\n * inside their `queryFn` / `mutationFn` so consumers always see the same\n * discriminated shape, regardless of which viem error type fired underneath.\n *\n * The order of `walk` matters: a wallet-popup dismissal nests inside a\n * `TransactionExecutionError`, so the rejection check has to consider every\n * level of the cause chain, not just the topmost throw.\n *\n * @param err - The thrown value (typed `unknown` because Promises can reject with anything).\n */\nexport function normalizeSymmError(err: unknown): SymmioRequestError {\n  if (err instanceof SymmioRequestError) return err;\n\n  if (err instanceof SymmApiError) {\n    return new SymmioRequestError({\n      kind: \"api\",\n      message: err.message,\n      code: err.code,\n      status: err.status,\n      responseData: err.responseData,\n      cause: err,\n    });\n  }\n\n  if (err instanceof SymmError) {\n    return new SymmioRequestError({\n      kind: \"sdk\",\n      message: err.message,\n      code: err.code,\n      cause: err,\n    });\n  }\n\n  const viemErr = findViemError(err);\n\n  if (viemErr) {\n    const userRejected = findInCauseChain(viemErr, UserRejectedRequestError);\n    if (userRejected) {\n      return new SymmioRequestError({\n        kind: \"user-rejected\",\n        message: userRejected.shortMessage || \"Wallet request was rejected.\",\n        cause: err,\n      });\n    }\n\n    const revert = findInCauseChain(viemErr, ContractFunctionRevertedError);\n    if (revert) {\n      const reason = revert.reason ?? revert.data?.errorName;\n      return new SymmioRequestError({\n        kind: \"contract-revert\",\n        message: revert.shortMessage || `Contract reverted${reason ? `: ${reason}` : \".\"}`,\n        reason,\n        cause: err,\n      });\n    }\n\n    const insufficient = findInCauseChain(viemErr, InsufficientFundsError);\n    if (insufficient) {\n      return new SymmioRequestError({\n        kind: \"insufficient-funds\",\n        message: insufficient.shortMessage || \"Insufficient funds for gas.\",\n        cause: err,\n      });\n    }\n\n    const transport =\n      findInCauseChain(viemErr, HttpRequestError) ||\n      findInCauseChain(viemErr, TimeoutError) ||\n      findInCauseChain(viemErr, EstimateGasExecutionError) ||\n      findInCauseChain(viemErr, TransactionExecutionError);\n    if (transport) {\n      return new SymmioRequestError({\n        kind: \"rpc\",\n        message: transport.shortMessage || transport.message,\n        shortMessage: transport.shortMessage,\n        cause: err,\n      });\n    }\n\n    return new SymmioRequestError({\n      kind: \"rpc\",\n      message: viemErr.shortMessage || viemErr.message,\n      shortMessage: viemErr.shortMessage,\n      cause: err,\n    });\n  }\n\n  if (err instanceof Error) {\n    return new SymmioRequestError({ kind: \"unknown\", message: err.message, cause: err });\n  }\n\n  return new SymmioRequestError({\n    kind: \"unknown\",\n    message: typeof err === \"string\" ? err : \"An unknown error occurred.\",\n    cause: err,\n  });\n}\n\n/**\n * Walk an error and its `cause` chain looking for a viem `BaseError`. Returns\n * the first one found, or `undefined`.\n *\n * @internal\n */\nfunction findViemError(err: unknown): BaseError | undefined {\n  let current: unknown = err;\n  let depth = 0;\n  while (current && depth < 16) {\n    if (current instanceof BaseError) return current;\n    if (current instanceof Error && current.cause) {\n      current = current.cause;\n      depth += 1;\n      continue;\n    }\n    return undefined;\n  }\n  return undefined;\n}\n\n/**\n * Walk a viem `BaseError`'s `walk()` chain looking for a specific subclass.\n *\n * @internal\n */\nfunction findInCauseChain<T extends BaseError>(err: BaseError, ctor: new (...args: never[]) => T): T | undefined {\n  const found = err.walk((candidate) => candidate instanceof ctor);\n  return found instanceof ctor ? (found as T) : undefined;\n}\n"],"mappings":";;;;AAwBA,SAAgB,EAAmB,GAAkC;CACnE,IAAI,aAAe,GAAoB,OAAO;CAE9C,IAAI,aAAe,GACjB,OAAO,IAAI,EAAmB;EAC5B,MAAM;EACN,SAAS,EAAI;EACb,MAAM,EAAI;EACV,QAAQ,EAAI;EACZ,cAAc,EAAI;EAClB,OAAO;CACT,CAAC;CAGH,IAAI,aAAe,GACjB,OAAO,IAAI,EAAmB;EAC5B,MAAM;EACN,SAAS,EAAI;EACb,MAAM,EAAI;EACV,OAAO;CACT,CAAC;CAGH,IAAM,IAAU,EAAc,CAAG;CAEjC,IAAI,GAAS;EACX,IAAM,IAAe,EAAiB,GAAS,CAAwB;EACvE,IAAI,GACF,OAAO,IAAI,EAAmB;GAC5B,MAAM;GACN,SAAS,EAAa,gBAAgB;GACtC,OAAO;EACT,CAAC;EAGH,IAAM,IAAS,EAAiB,GAAS,CAA6B;EACtE,IAAI,GAAQ;GACV,IAAM,IAAS,EAAO,UAAU,EAAO,MAAM;GAC7C,OAAO,IAAI,EAAmB;IAC5B,MAAM;IACN,SAAS,EAAO,gBAAgB,oBAAoB,IAAS,KAAK,MAAW;IAC7E;IACA,OAAO;GACT,CAAC;EACH;EAEA,IAAM,IAAe,EAAiB,GAAS,CAAsB;EACrE,IAAI,GACF,OAAO,IAAI,EAAmB;GAC5B,MAAM;GACN,SAAS,EAAa,gBAAgB;GACtC,OAAO;EACT,CAAC;EAGH,IAAM,IACJ,EAAiB,GAAS,CAAgB,KAC1C,EAAiB,GAAS,CAAY,KACtC,EAAiB,GAAS,CAAyB,KACnD,EAAiB,GAAS,CAAyB;EAUrD,OATI,IACK,IAAI,EAAmB;GAC5B,MAAM;GACN,SAAS,EAAU,gBAAgB,EAAU;GAC7C,cAAc,EAAU;GACxB,OAAO;EACT,CAAC,IAGI,IAAI,EAAmB;GAC5B,MAAM;GACN,SAAS,EAAQ,gBAAgB,EAAQ;GACzC,cAAc,EAAQ;GACtB,OAAO;EACT,CAAC;CACH;CAMA,OAJI,aAAe,QACV,IAAI,EAAmB;EAAE,MAAM;EAAW,SAAS,EAAI;EAAS,OAAO;CAAI,CAAC,IAG9E,IAAI,EAAmB;EAC5B,MAAM;EACN,SAAS,OAAO,KAAQ,WAAW,IAAM;EACzC,OAAO;CACT,CAAC;AACH;AAQA,SAAS,EAAc,GAAqC;CAC1D,IAAI,IAAmB,GACnB,IAAQ;CACZ,OAAO,KAAW,IAAQ,KAAI;EAC5B,IAAI,aAAmB,GAAW,OAAO;EACzC,IAAI,aAAmB,SAAS,EAAQ,OAAO;GAE7C,AADA,IAAU,EAAQ,OAClB,KAAS;GACT;EACF;EACA;CACF;AAEF;AAOA,SAAS,EAAsC,GAAgB,GAAkD;CAC/G,IAAM,IAAQ,EAAI,MAAM,MAAc,aAAqB,CAAI;CAC/D,OAAO,aAAiB,IAAQ,IAAc,KAAA;AAChD"}
+{"version":3,"file":"normalize-symm-error.js","names":[],"sources":["../../src/errors/normalize-symm-error.ts"],"sourcesContent":["import { SymmApiError, SymmError } from \"@symmio/trading-core\";\nimport {\n  BaseError,\n  ContractFunctionRevertedError,\n  EstimateGasExecutionError,\n  HttpRequestError,\n  InsufficientFundsError,\n  TimeoutError,\n  TransactionExecutionError,\n  UserRejectedRequestError,\n} from \"viem\";\nimport { SymmioRequestError } from \"./symmio-request-error\";\n\n/**\n * Classify any thrown value into a {@link SymmioRequestError}. Hooks call this\n * inside their `queryFn` / `mutationFn` so consumers always see the same\n * discriminated shape, regardless of which viem error type fired underneath.\n *\n * The order of `walk` matters: a wallet-popup dismissal nests inside a\n * `TransactionExecutionError`, so the rejection check has to consider every\n * level of the cause chain, not just the topmost throw.\n *\n * @param err - The thrown value (typed `unknown` because Promises can reject with anything).\n */\nexport function normalizeSymmError(err: unknown): SymmioRequestError {\n  if (err instanceof SymmioRequestError) return err;\n\n  if (err instanceof SymmApiError) {\n    return new SymmioRequestError({\n      kind: \"api\",\n      message: err.message,\n      code: err.code,\n      status: err.status,\n      responseData: err.responseData,\n      retryAfterMs: err.retryAfterMs,\n      cause: err,\n    });\n  }\n\n  if (err instanceof SymmError) {\n    return new SymmioRequestError({\n      kind: \"sdk\",\n      message: err.message,\n      code: err.code,\n      cause: err,\n    });\n  }\n\n  const viemErr = findViemError(err);\n\n  if (viemErr) {\n    const userRejected = findInCauseChain(viemErr, UserRejectedRequestError);\n    if (userRejected) {\n      return new SymmioRequestError({\n        kind: \"user-rejected\",\n        message: userRejected.shortMessage || \"Wallet request was rejected.\",\n        cause: err,\n      });\n    }\n\n    const revert = findInCauseChain(viemErr, ContractFunctionRevertedError);\n    if (revert) {\n      const reason = revert.reason ?? revert.data?.errorName;\n      return new SymmioRequestError({\n        kind: \"contract-revert\",\n        message: revert.shortMessage || `Contract reverted${reason ? `: ${reason}` : \".\"}`,\n        reason,\n        cause: err,\n      });\n    }\n\n    const insufficient = findInCauseChain(viemErr, InsufficientFundsError);\n    if (insufficient) {\n      return new SymmioRequestError({\n        kind: \"insufficient-funds\",\n        message: insufficient.shortMessage || \"Insufficient funds for gas.\",\n        cause: err,\n      });\n    }\n\n    const transport =\n      findInCauseChain(viemErr, HttpRequestError) ||\n      findInCauseChain(viemErr, TimeoutError) ||\n      findInCauseChain(viemErr, EstimateGasExecutionError) ||\n      findInCauseChain(viemErr, TransactionExecutionError);\n    if (transport) {\n      return new SymmioRequestError({\n        kind: \"rpc\",\n        message: transport.shortMessage || transport.message,\n        shortMessage: transport.shortMessage,\n        cause: err,\n      });\n    }\n\n    return new SymmioRequestError({\n      kind: \"rpc\",\n      message: viemErr.shortMessage || viemErr.message,\n      shortMessage: viemErr.shortMessage,\n      cause: err,\n    });\n  }\n\n  if (err instanceof Error) {\n    return new SymmioRequestError({ kind: \"unknown\", message: err.message, cause: err });\n  }\n\n  return new SymmioRequestError({\n    kind: \"unknown\",\n    message: typeof err === \"string\" ? err : \"An unknown error occurred.\",\n    cause: err,\n  });\n}\n\n/**\n * Walk an error and its `cause` chain looking for a viem `BaseError`. Returns\n * the first one found, or `undefined`.\n *\n * @internal\n */\nfunction findViemError(err: unknown): BaseError | undefined {\n  let current: unknown = err;\n  let depth = 0;\n  while (current && depth < 16) {\n    if (current instanceof BaseError) return current;\n    if (current instanceof Error && current.cause) {\n      current = current.cause;\n      depth += 1;\n      continue;\n    }\n    return undefined;\n  }\n  return undefined;\n}\n\n/**\n * Walk a viem `BaseError`'s `walk()` chain looking for a specific subclass.\n *\n * @internal\n */\nfunction findInCauseChain<T extends BaseError>(err: BaseError, ctor: new (...args: never[]) => T): T | undefined {\n  const found = err.walk((candidate) => candidate instanceof ctor);\n  return found instanceof ctor ? (found as T) : undefined;\n}\n"],"mappings":";;;;AAwBA,SAAgB,EAAmB,GAAkC;CACnE,IAAI,aAAe,GAAoB,OAAO;CAE9C,IAAI,aAAe,GACjB,OAAO,IAAI,EAAmB;EAC5B,MAAM;EACN,SAAS,EAAI;EACb,MAAM,EAAI;EACV,QAAQ,EAAI;EACZ,cAAc,EAAI;EAClB,cAAc,EAAI;EAClB,OAAO;CACT,CAAC;CAGH,IAAI,aAAe,GACjB,OAAO,IAAI,EAAmB;EAC5B,MAAM;EACN,SAAS,EAAI;EACb,MAAM,EAAI;EACV,OAAO;CACT,CAAC;CAGH,IAAM,IAAU,EAAc,CAAG;CAEjC,IAAI,GAAS;EACX,IAAM,IAAe,EAAiB,GAAS,CAAwB;EACvE,IAAI,GACF,OAAO,IAAI,EAAmB;GAC5B,MAAM;GACN,SAAS,EAAa,gBAAgB;GACtC,OAAO;EACT,CAAC;EAGH,IAAM,IAAS,EAAiB,GAAS,CAA6B;EACtE,IAAI,GAAQ;GACV,IAAM,IAAS,EAAO,UAAU,EAAO,MAAM;GAC7C,OAAO,IAAI,EAAmB;IAC5B,MAAM;IACN,SAAS,EAAO,gBAAgB,oBAAoB,IAAS,KAAK,MAAW;IAC7E;IACA,OAAO;GACT,CAAC;EACH;EAEA,IAAM,IAAe,EAAiB,GAAS,CAAsB;EACrE,IAAI,GACF,OAAO,IAAI,EAAmB;GAC5B,MAAM;GACN,SAAS,EAAa,gBAAgB;GACtC,OAAO;EACT,CAAC;EAGH,IAAM,IACJ,EAAiB,GAAS,CAAgB,KAC1C,EAAiB,GAAS,CAAY,KACtC,EAAiB,GAAS,CAAyB,KACnD,EAAiB,GAAS,CAAyB;EAUrD,OATI,IACK,IAAI,EAAmB;GAC5B,MAAM;GACN,SAAS,EAAU,gBAAgB,EAAU;GAC7C,cAAc,EAAU;GACxB,OAAO;EACT,CAAC,IAGI,IAAI,EAAmB;GAC5B,MAAM;GACN,SAAS,EAAQ,gBAAgB,EAAQ;GACzC,cAAc,EAAQ;GACtB,OAAO;EACT,CAAC;CACH;CAMA,OAJI,aAAe,QACV,IAAI,EAAmB;EAAE,MAAM;EAAW,SAAS,EAAI;EAAS,OAAO;CAAI,CAAC,IAG9E,IAAI,EAAmB;EAC5B,MAAM;EACN,SAAS,OAAO,KAAQ,WAAW,IAAM;EACzC,OAAO;CACT,CAAC;AACH;AAQA,SAAS,EAAc,GAAqC;CAC1D,IAAI,IAAmB,GACnB,IAAQ;CACZ,OAAO,KAAW,IAAQ,KAAI;EAC5B,IAAI,aAAmB,GAAW,OAAO;EACzC,IAAI,aAAmB,SAAS,EAAQ,OAAO;GAE7C,AADA,IAAU,EAAQ,OAClB,KAAS;GACT;EACF;EACA;CACF;AAEF;AAOA,SAAS,EAAsC,GAAgB,GAAkD;CAC/G,IAAM,IAAQ,EAAI,MAAM,MAAc,aAAqB,CAAI;CAC/D,OAAO,aAAiB,IAAQ,IAAc,KAAA;AAChD"}

package/dist/errors/symmio-request-error.d.ts

@@ -16,6 +16,11 @@ export interface SymmioRequestErrorOptions {
      * server's structured error fields without unwrapping `cause`.
      */
     responseData?: unknown;
+    /**
+     * Retry delay the server asked for, in ms, from `SymmApiError.retryAfterMs`.
+     * Only meaningful when `kind === "api"`. Defaults to `null`.
+     */
+    retryAfterMs?: number | null;
     /** Solidity revert reason. Only meaningful when `kind === "contract-revert"`. */
     reason?: string;
     /** viem's human-readable short message. Only meaningful when `kind === "rpc"`. */
@@ -45,6 +50,20 @@ export declare class SymmioRequestError extends Error {
     readonly status?: number;
     /** Raw response body returned by the server when `kind === "api"`. */
     readonly responseData?: unknown;
+    /**
+     * How long the server asked the client to wait before retrying, in ms,
+     * parsed from its `Retry-After` header. `normalizeSymmError` sets it only for
+     * `kind === "api"`, and even then it is `null` when the response carried no
+     * usable header. A cross-origin browser sees the header only when the server
+     * exposes it, so treat `null` as "unknown" and still back off, e.g. at least
+     * one second plus jitter.
+     *
+     * @example
+     * if (error?.kind === "api" && error.status === 429) {
+     *   retryIn(error.retryAfterMs ?? 1_000 + Math.random() * 500);
+     * }
+     */
+    readonly retryAfterMs: number | null;
     /** Solidity revert reason when `kind === "contract-revert"`. */
     readonly reason?: string;
     /** viem's short message when `kind === "rpc"`. */

package/dist/errors/symmio-request-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symmio-request-error.d.ts","sourceRoot":"","sources":["../../src/errors/symmio-request-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,wBAAwB;IAC9C,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,yBAAyB;CAS/C"}
+{"version":3,"file":"symmio-request-error.d.ts","sourceRoot":"","sources":["../../src/errors/symmio-request-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,wBAAwB;IAC9C,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,yBAAyB;CAU/C"}

package/dist/errors/symmio-request-error.js

@@ -5,10 +5,11 @@ var e = class extends Error {
 	code;
 	status;
 	responseData;
+	retryAfterMs;
 	reason;
 	shortMessage;
 	constructor(e) {
-		super(e.message, { cause: e.cause }), this.kind = e.kind, this.code = e.code, this.status = e.status, this.responseData = e.responseData, this.reason = e.reason, this.shortMessage = e.shortMessage;
+		super(e.message, { cause: e.cause }), this.kind = e.kind, this.code = e.code, this.status = e.status, this.responseData = e.responseData, this.retryAfterMs = e.retryAfterMs ?? null, this.reason = e.reason, this.shortMessage = e.shortMessage;
 	}
 };
 //#endregion

package/dist/errors/symmio-request-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"symmio-request-error.js","names":[],"sources":["../../src/errors/symmio-request-error.ts"],"sourcesContent":["import type { SymmioNormalizedErrorKind } from \"./types\";\n\n/**\n * Options accepted by the {@link SymmioRequestError} constructor. Carries\n * the discriminator-specific fields the UI cares about.\n */\nexport interface SymmioRequestErrorOptions {\n  kind: SymmioNormalizedErrorKind;\n  message: string;\n  /** SDK error code (e.g., \"FETCH_MARKETS_FAILED\", \"UNSUPPORTED_CHAIN\"). */\n  code?: string;\n  /** HTTP status code. Only meaningful when `kind === \"api\"`. */\n  status?: number;\n  /**\n   * Raw response body returned by the server. Only meaningful when `kind === \"api\"`.\n   * Forwarded verbatim from `SymmApiError.responseData` so the UI can render the\n   * server's structured error fields without unwrapping `cause`.\n   */\n  responseData?: unknown;\n  /** Solidity revert reason. Only meaningful when `kind === \"contract-revert\"`. */\n  reason?: string;\n  /** viem's human-readable short message. Only meaningful when `kind === \"rpc\"`. */\n  shortMessage?: string;\n  /** The original underlying error, kept for debugging. */\n  cause?: unknown;\n}\n\n/**\n * The single error class every SYMMIO React hook throws when a read or write\n * fails. Carries a discriminator (`kind`) the UI can switch on without\n * inspecting viem's internal error hierarchy.\n *\n * @example\n * const { error } = useUserSubAccounts({ user });\n * if (error?.kind === \"user-rejected\") return null;       // silent\n * if (error?.kind === \"contract-revert\") return <ShowReason reason={error.reason} />;\n * if (error?.kind === \"api\") return <ApiError status={error.status} code={error.code} />;\n * if (error) return <GenericError message={error.message} />;\n */\nexport class SymmioRequestError extends Error {\n  override readonly name = \"SymmioRequestError\";\n  /** Classification used by the UI to branch on this failure. */\n  readonly kind: SymmioNormalizedErrorKind;\n  /** SDK error code (e.g., \"FETCH_MARKETS_FAILED\"). */\n  readonly code?: string;\n  /** HTTP status code when `kind === \"api\"`. */\n  readonly status?: number;\n  /** Raw response body returned by the server when `kind === \"api\"`. */\n  readonly responseData?: unknown;\n  /** Solidity revert reason when `kind === \"contract-revert\"`. */\n  readonly reason?: string;\n  /** viem's short message when `kind === \"rpc\"`. */\n  readonly shortMessage?: string;\n\n  constructor(options: SymmioRequestErrorOptions) {\n    super(options.message, { cause: options.cause });\n    this.kind = options.kind;\n    this.code = options.code;\n    this.status = options.status;\n    this.responseData = options.responseData;\n    this.reason = options.reason;\n    this.shortMessage = options.shortMessage;\n  }\n}\n"],"mappings":";AAuCA,IAAa,IAAb,cAAwC,MAAM;CAC5C,OAAyB;CAEzB;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA,YAAY,GAAoC;EAO9C,AANA,MAAM,EAAQ,SAAS,EAAE,OAAO,EAAQ,MAAM,CAAC,GAC/C,KAAK,OAAO,EAAQ,MACpB,KAAK,OAAO,EAAQ,MACpB,KAAK,SAAS,EAAQ,QACtB,KAAK,eAAe,EAAQ,cAC5B,KAAK,SAAS,EAAQ,QACtB,KAAK,eAAe,EAAQ;CAC9B;AACF"}
+{"version":3,"file":"symmio-request-error.js","names":[],"sources":["../../src/errors/symmio-request-error.ts"],"sourcesContent":["import type { SymmioNormalizedErrorKind } from \"./types\";\n\n/**\n * Options accepted by the {@link SymmioRequestError} constructor. Carries\n * the discriminator-specific fields the UI cares about.\n */\nexport interface SymmioRequestErrorOptions {\n  kind: SymmioNormalizedErrorKind;\n  message: string;\n  /** SDK error code (e.g., \"FETCH_MARKETS_FAILED\", \"UNSUPPORTED_CHAIN\"). */\n  code?: string;\n  /** HTTP status code. Only meaningful when `kind === \"api\"`. */\n  status?: number;\n  /**\n   * Raw response body returned by the server. Only meaningful when `kind === \"api\"`.\n   * Forwarded verbatim from `SymmApiError.responseData` so the UI can render the\n   * server's structured error fields without unwrapping `cause`.\n   */\n  responseData?: unknown;\n  /**\n   * Retry delay the server asked for, in ms, from `SymmApiError.retryAfterMs`.\n   * Only meaningful when `kind === \"api\"`. Defaults to `null`.\n   */\n  retryAfterMs?: number | null;\n  /** Solidity revert reason. Only meaningful when `kind === \"contract-revert\"`. */\n  reason?: string;\n  /** viem's human-readable short message. Only meaningful when `kind === \"rpc\"`. */\n  shortMessage?: string;\n  /** The original underlying error, kept for debugging. */\n  cause?: unknown;\n}\n\n/**\n * The single error class every SYMMIO React hook throws when a read or write\n * fails. Carries a discriminator (`kind`) the UI can switch on without\n * inspecting viem's internal error hierarchy.\n *\n * @example\n * const { error } = useUserSubAccounts({ user });\n * if (error?.kind === \"user-rejected\") return null;       // silent\n * if (error?.kind === \"contract-revert\") return <ShowReason reason={error.reason} />;\n * if (error?.kind === \"api\") return <ApiError status={error.status} code={error.code} />;\n * if (error) return <GenericError message={error.message} />;\n */\nexport class SymmioRequestError extends Error {\n  override readonly name = \"SymmioRequestError\";\n  /** Classification used by the UI to branch on this failure. */\n  readonly kind: SymmioNormalizedErrorKind;\n  /** SDK error code (e.g., \"FETCH_MARKETS_FAILED\"). */\n  readonly code?: string;\n  /** HTTP status code when `kind === \"api\"`. */\n  readonly status?: number;\n  /** Raw response body returned by the server when `kind === \"api\"`. */\n  readonly responseData?: unknown;\n  /**\n   * How long the server asked the client to wait before retrying, in ms,\n   * parsed from its `Retry-After` header. `normalizeSymmError` sets it only for\n   * `kind === \"api\"`, and even then it is `null` when the response carried no\n   * usable header. A cross-origin browser sees the header only when the server\n   * exposes it, so treat `null` as \"unknown\" and still back off, e.g. at least\n   * one second plus jitter.\n   *\n   * @example\n   * if (error?.kind === \"api\" && error.status === 429) {\n   *   retryIn(error.retryAfterMs ?? 1_000 + Math.random() * 500);\n   * }\n   */\n  readonly retryAfterMs: number | null;\n  /** Solidity revert reason when `kind === \"contract-revert\"`. */\n  readonly reason?: string;\n  /** viem's short message when `kind === \"rpc\"`. */\n  readonly shortMessage?: string;\n\n  constructor(options: SymmioRequestErrorOptions) {\n    super(options.message, { cause: options.cause });\n    this.kind = options.kind;\n    this.code = options.code;\n    this.status = options.status;\n    this.responseData = options.responseData;\n    this.retryAfterMs = options.retryAfterMs ?? null;\n    this.reason = options.reason;\n    this.shortMessage = options.shortMessage;\n  }\n}\n"],"mappings":";AA4CA,IAAa,IAAb,cAAwC,MAAM;CAC5C,OAAyB;CAEzB;CAEA;CAEA;CAEA;CAcA;CAEA;CAEA;CAEA,YAAY,GAAoC;EAQ9C,AAPA,MAAM,EAAQ,SAAS,EAAE,OAAO,EAAQ,MAAM,CAAC,GAC/C,KAAK,OAAO,EAAQ,MACpB,KAAK,OAAO,EAAQ,MACpB,KAAK,SAAS,EAAQ,QACtB,KAAK,eAAe,EAAQ,cAC5B,KAAK,eAAe,EAAQ,gBAAgB,MAC5C,KAAK,SAAS,EAAQ,QACtB,KAAK,eAAe,EAAQ;CAC9B;AACF"}

package/dist/gasless/gasless-relay-types.d.ts

@@ -0,0 +1,115 @@
+import { ConfigParameter, GaslessAcceptedRequest, GaslessConfirmation, GaslessConfirmedRequest, GaslessRequest, GaslessRequestStatus } from '@symmio/trading-core';
+import { Hash } from 'viem';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/**
+ * Confirmation options shared by every explicit relay hook — the gasless
+ * analogue of `WriteParameters`.
+ *
+ * A relayed submit returns a `202` in milliseconds while the transaction lands
+ * seconds later, so a mutation that resolves on acceptance resolves before its
+ * own effect exists. These options decide how far the hook follows the request
+ * before calling it done.
+ */
+export interface GaslessRelayParameters extends ConfigParameter {
+    /**
+     * How far to confirm before resolving. Default `"receipt"`.
+     *
+     * `"receipt"` waits for the receipt on *this config's* client, which is what
+     * makes the invalidation that follows truthful — refetching against a node
+     * that has not seen the block re-reads pre-state. `"terminal"` trusts the
+     * relayer's view; `"none"` restores fire-and-forget, and hands you the
+     * lifecycle and the invalidation.
+     */
+    confirmation?: GaslessConfirmation;
+    /** Confirmations for the receipt wait. Default `1`. Only for `confirmation: "receipt"`. */
+    receiptConfirmations?: number;
+    /** Budget for the terminal wait. Defaults to the SDK's `GASLESS_WAIT_TIMEOUT_MS`. */
+    timeoutMs?: number;
+    /** Budget for the receipt wait. Defaults to the SDK's `GASLESS_RECEIPT_TIMEOUT_MS`. */
+    receiptTimeoutMs?: number;
+    /**
+     * Abort the wait when the hook unmounts. Default `true`.
+     *
+     * TanStack mutations do not cancel on unmount, so this is a deliberate
+     * deviation — right for a modal that closes, wrong when you want the wait to
+     * finish so the cache refreshes for the rest of the app. Either way the
+     * invalidation still runs if a `succeeded` terminal was observed before the
+     * abort.
+     */
+    abortOnUnmount?: boolean;
+    /** Observer for every polled record — the imperative form of {@link GaslessRelayProgress}. */
+    onProgress?: (request: GaslessRequest) => void;
+    /**
+     * Observer invoked the moment the service accepts the request — before any
+     * confirmation, and before the `confirmation: "none"` early return.
+     *
+     * This is the persistence hook. There is no list-by-wallet endpoint, so a
+     * request id that never left memory is unrecoverable: a reload, a crash or a
+     * closed tab loses the only handle on a workflow that keeps running and will
+     * spend the user's collateral. Persist `{ service, protocolInstance,
+     * requestId, owner, walletIds, idempotencyKey }` here, not in `onSuccess`,
+     * which does not run until the relay has landed — or never, if the wait
+     * times out.
+     *
+     * Its own failures are swallowed: a broken observer must not fail a relay
+     * that the service has already accepted.
+     */
+    onAccepted?: (accepted: GaslessAcceptedRequest) => void;
+}
+/**
+ * What a confirmed relay hook resolves with.
+ *
+ * `accepted` stays nested rather than merged: `GaslessSubmitReceipt.status` is
+ * the *acceptance* status (normally `queued`) while `GaslessRequest.status` is
+ * the *terminal* one, and flattening them would put a field named `status`
+ * holding "queued" on a result that means success.
+ */
+export interface GaslessRelayResult<accepted> {
+    /** The `202` acceptance. Its `status` is never success. */
+    accepted: accepted;
+    /** The confirmation. Absent only when `confirmation: "none"`. */
+    confirmed?: GaslessConfirmedRequest;
+}
+/**
+ * Where a relay is, merged onto the mutation result as `relay`.
+ *
+ * A confirmed mutation stays pending for as long as the relayer takes, so
+ * `isPending` alone cannot tell a user whether anything is happening. This
+ * exposes the lifecycle without making every consumer mount a second hook.
+ */
+export interface GaslessRelayProgress {
+    /**
+     * Coarse phase, suitable for driving a label or a spinner.
+     *
+     * `"unconfirmed"` is the one that needs a deliberate UI: the wait ran out of
+     * budget, so the relay's outcome is **unknown**, not failed. The request is
+     * still running server-side — show the request id and keep watching it (the
+     * mutation itself still rejects, because it cannot report a result it does not
+     * have). Never re-run the intent through the wallet from this phase.
+     */
+    phase: "idle" | "submitting" | "queued" | "submitted" | "awaiting-receipt" | "confirmed" | "unconfirmed" | "error";
+    /** Present from acceptance onward — persist it; a lost id is unrecoverable. */
+    requestId?: string;
+    /**
+     * The idempotency key the request was submitted with, from acceptance onward.
+     * Persist it with the id: resending the byte-identical request under this key
+     * is what makes a lost response recoverable.
+     */
+    idempotencyKey?: string;
+    /** The relayer's last reported status. */
+    status?: GaslessRequestStatus;
+    /** Present once the relayer broadcasts. */
+    txHash?: Hash;
+    /**
+     * Whether the status is currently unreadable — a `429`, a `503`, a dropped
+     * connection. The workflow is unaffected; only our view of it is stale, so
+     * render "status unavailable" rather than anything that reads as a failure.
+     * Clears as soon as a read succeeds.
+     */
+    degraded: boolean;
+    /** The last transient read failure, while `degraded` — for diagnostics, never for a retry decision. */
+    issue?: SymmioRequestError;
+}
+/** The initial, nothing-in-flight progress value. */
+export declare const IDLE_RELAY_PROGRESS: GaslessRelayProgress;
+//# sourceMappingURL=gasless-relay-types.d.ts.map

package/dist/gasless/gasless-relay-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gasless-relay-types.d.ts","sourceRoot":"","sources":["../../src/gasless/gasless-relay-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,2FAA2F;IAC3F,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC/C;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB,CAAC,QAAQ;IAC1C,2DAA2D;IAC3D,QAAQ,EAAE,QAAQ,CAAC;IACnB,iEAAiE;IACjE,SAAS,CAAC,EAAE,uBAAuB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;OAQG;IACH,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,kBAAkB,GAAG,WAAW,GAAG,aAAa,GAAG,OAAO,CAAC;IACnH,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,uGAAuG;IACvG,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,EAAE,oBAAyD,CAAC"}

package/dist/gasless/gasless-relay-types.js

@@ -0,0 +1,9 @@
+//#region src/gasless/gasless-relay-types.ts
+var e = {
+	phase: "idle",
+	degraded: !1
+};
+//#endregion
+export { e as IDLE_RELAY_PROGRESS };
+
+//# sourceMappingURL=gasless-relay-types.js.map

package/dist/gasless/gasless-relay-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gasless-relay-types.js","names":[],"sources":["../../src/gasless/gasless-relay-types.ts"],"sourcesContent":["import type {\n  ConfigParameter,\n  GaslessAcceptedRequest,\n  GaslessConfirmation,\n  GaslessConfirmedRequest,\n  GaslessRequest,\n  GaslessRequestStatus,\n} from \"@symmio/trading-core\";\nimport type { Hash } from \"viem\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\n\n/**\n * Confirmation options shared by every explicit relay hook — the gasless\n * analogue of `WriteParameters`.\n *\n * A relayed submit returns a `202` in milliseconds while the transaction lands\n * seconds later, so a mutation that resolves on acceptance resolves before its\n * own effect exists. These options decide how far the hook follows the request\n * before calling it done.\n */\nexport interface GaslessRelayParameters extends ConfigParameter {\n  /**\n   * How far to confirm before resolving. Default `\"receipt\"`.\n   *\n   * `\"receipt\"` waits for the receipt on *this config's* client, which is what\n   * makes the invalidation that follows truthful — refetching against a node\n   * that has not seen the block re-reads pre-state. `\"terminal\"` trusts the\n   * relayer's view; `\"none\"` restores fire-and-forget, and hands you the\n   * lifecycle and the invalidation.\n   */\n  confirmation?: GaslessConfirmation;\n  /** Confirmations for the receipt wait. Default `1`. Only for `confirmation: \"receipt\"`. */\n  receiptConfirmations?: number;\n  /** Budget for the terminal wait. Defaults to the SDK's `GASLESS_WAIT_TIMEOUT_MS`. */\n  timeoutMs?: number;\n  /** Budget for the receipt wait. Defaults to the SDK's `GASLESS_RECEIPT_TIMEOUT_MS`. */\n  receiptTimeoutMs?: number;\n  /**\n   * Abort the wait when the hook unmounts. Default `true`.\n   *\n   * TanStack mutations do not cancel on unmount, so this is a deliberate\n   * deviation — right for a modal that closes, wrong when you want the wait to\n   * finish so the cache refreshes for the rest of the app. Either way the\n   * invalidation still runs if a `succeeded` terminal was observed before the\n   * abort.\n   */\n  abortOnUnmount?: boolean;\n  /** Observer for every polled record — the imperative form of {@link GaslessRelayProgress}. */\n  onProgress?: (request: GaslessRequest) => void;\n  /**\n   * Observer invoked the moment the service accepts the request — before any\n   * confirmation, and before the `confirmation: \"none\"` early return.\n   *\n   * This is the persistence hook. There is no list-by-wallet endpoint, so a\n   * request id that never left memory is unrecoverable: a reload, a crash or a\n   * closed tab loses the only handle on a workflow that keeps running and will\n   * spend the user's collateral. Persist `{ service, protocolInstance,\n   * requestId, owner, walletIds, idempotencyKey }` here, not in `onSuccess`,\n   * which does not run until the relay has landed — or never, if the wait\n   * times out.\n   *\n   * Its own failures are swallowed: a broken observer must not fail a relay\n   * that the service has already accepted.\n   */\n  onAccepted?: (accepted: GaslessAcceptedRequest) => void;\n}\n\n/**\n * What a confirmed relay hook resolves with.\n *\n * `accepted` stays nested rather than merged: `GaslessSubmitReceipt.status` is\n * the *acceptance* status (normally `queued`) while `GaslessRequest.status` is\n * the *terminal* one, and flattening them would put a field named `status`\n * holding \"queued\" on a result that means success.\n */\nexport interface GaslessRelayResult<accepted> {\n  /** The `202` acceptance. Its `status` is never success. */\n  accepted: accepted;\n  /** The confirmation. Absent only when `confirmation: \"none\"`. */\n  confirmed?: GaslessConfirmedRequest;\n}\n\n/**\n * Where a relay is, merged onto the mutation result as `relay`.\n *\n * A confirmed mutation stays pending for as long as the relayer takes, so\n * `isPending` alone cannot tell a user whether anything is happening. This\n * exposes the lifecycle without making every consumer mount a second hook.\n */\nexport interface GaslessRelayProgress {\n  /**\n   * Coarse phase, suitable for driving a label or a spinner.\n   *\n   * `\"unconfirmed\"` is the one that needs a deliberate UI: the wait ran out of\n   * budget, so the relay's outcome is **unknown**, not failed. The request is\n   * still running server-side — show the request id and keep watching it (the\n   * mutation itself still rejects, because it cannot report a result it does not\n   * have). Never re-run the intent through the wallet from this phase.\n   */\n  phase: \"idle\" | \"submitting\" | \"queued\" | \"submitted\" | \"awaiting-receipt\" | \"confirmed\" | \"unconfirmed\" | \"error\";\n  /** Present from acceptance onward — persist it; a lost id is unrecoverable. */\n  requestId?: string;\n  /**\n   * The idempotency key the request was submitted with, from acceptance onward.\n   * Persist it with the id: resending the byte-identical request under this key\n   * is what makes a lost response recoverable.\n   */\n  idempotencyKey?: string;\n  /** The relayer's last reported status. */\n  status?: GaslessRequestStatus;\n  /** Present once the relayer broadcasts. */\n  txHash?: Hash;\n  /**\n   * Whether the status is currently unreadable — a `429`, a `503`, a dropped\n   * connection. The workflow is unaffected; only our view of it is stale, so\n   * render \"status unavailable\" rather than anything that reads as a failure.\n   * Clears as soon as a read succeeds.\n   */\n  degraded: boolean;\n  /** The last transient read failure, while `degraded` — for diagnostics, never for a retry decision. */\n  issue?: SymmioRequestError;\n}\n\n/** The initial, nothing-in-flight progress value. */\nexport const IDLE_RELAY_PROGRESS: GaslessRelayProgress = { phase: \"idle\", degraded: false };\n"],"mappings":";AA4HA,IAAa,IAA4C;CAAE,OAAO;CAAQ,UAAU;AAAM"}

package/dist/gasless/index.d.ts

@@ -0,0 +1,21 @@
+export * from './gasless-relay-types.js';
+export * from './use-approve-operational-fee.js';
+export * from './use-gasless-batch-fee-quote.js';
+export * from './use-gasless-deposit-policy.js';
+export * from './use-gasless-fee-quote.js';
+export * from './use-gasless-request.js';
+export * from './use-gasless-request-stream.js';
+export * from './use-gasless-request-transactions.js';
+export * from './use-gasless-wallet-address.js';
+export * from './use-gasless-wallet-creation-fee.js';
+export * from './use-gasless-wallet-execute.js';
+export * from './use-gasless-wallet-execute-selectors.js';
+export * from './use-gasless-wallet-nonce.js';
+export * from './use-operational-fee-allowance.js';
+export * from './use-relay-gasless-batch.js';
+export * from './use-relay-instant-operations.js';
+export * from './use-resubmit-gasless-request.js';
+export * from './use-settle-gasless-deposit-existing-account.js';
+export * from './use-settle-gasless-deposit-new-account.js';
+export * from './use-supports-gasless-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/gasless/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gasless/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wCAAwC,CAAC;AACvD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC"}

package/dist/gasless/index.js

@@ -0,0 +1,21 @@
+import { IDLE_RELAY_PROGRESS as e } from "./gasless-relay-types.js";
+import { useApproveOperationalFee as t } from "./use-approve-operational-fee.js";
+import { useGaslessBatchFeeQuote as n } from "./use-gasless-batch-fee-quote.js";
+import { useGaslessDepositPolicy as r } from "./use-gasless-deposit-policy.js";
+import { useGaslessFeeQuote as i } from "./use-gasless-fee-quote.js";
+import { useGaslessRequestStream as a } from "./use-gasless-request-stream.js";
+import { useGaslessRequest as o } from "./use-gasless-request.js";
+import { useGaslessRequestTransactions as s } from "./use-gasless-request-transactions.js";
+import { useGaslessWalletAddress as c } from "./use-gasless-wallet-address.js";
+import { useGaslessWalletCreationFee as l } from "./use-gasless-wallet-creation-fee.js";
+import { useGaslessWalletExecute as u } from "./use-gasless-wallet-execute.js";
+import { useGaslessWalletExecuteSelectors as d } from "./use-gasless-wallet-execute-selectors.js";
+import { useGaslessWalletNonce as f } from "./use-gasless-wallet-nonce.js";
+import { useOperationalFeeAllowance as p } from "./use-operational-fee-allowance.js";
+import { useRelayGaslessBatch as m } from "./use-relay-gasless-batch.js";
+import { useRelayInstantOperations as h } from "./use-relay-instant-operations.js";
+import { useResubmitGaslessRequest as g } from "./use-resubmit-gasless-request.js";
+import { useSettleGaslessDepositExistingAccount as _ } from "./use-settle-gasless-deposit-existing-account.js";
+import { useSettleGaslessDepositNewAccount as v } from "./use-settle-gasless-deposit-new-account.js";
+import { useSupportsGaslessService as y } from "./use-supports-gasless-service.js";
+export { e as IDLE_RELAY_PROGRESS, t as useApproveOperationalFee, n as useGaslessBatchFeeQuote, r as useGaslessDepositPolicy, i as useGaslessFeeQuote, o as useGaslessRequest, a as useGaslessRequestStream, s as useGaslessRequestTransactions, c as useGaslessWalletAddress, l as useGaslessWalletCreationFee, u as useGaslessWalletExecute, d as useGaslessWalletExecuteSelectors, f as useGaslessWalletNonce, p as useOperationalFeeAllowance, m as useRelayGaslessBatch, h as useRelayInstantOperations, g as useResubmitGaslessRequest, _ as useSettleGaslessDepositExistingAccount, v as useSettleGaslessDepositNewAccount, y as useSupportsGaslessService };

package/dist/gasless/invalidate-relay-reads.d.ts

@@ -0,0 +1,96 @@
+import { GaslessBatchCall } from '@symmio/trading-core';
+import { QueryClient } from '@tanstack/react-query';
+import { Address } from 'viem';
+/** Chain-config fingerprint every invalidation is scoped by. */
+interface Scope {
+    configKey?: string;
+}
+/**
+ * The GaslessWallet a relayed action touched, as far as its variables say.
+ * Every omitted field matches all of its values — a superset is correct, a
+ * silent no-op is not.
+ */
+interface GaslessWalletScope {
+    /** The wallet's owner. */
+    owner?: Address;
+    /**
+     * The wallet's id. `useGaslessWalletExecute` forwards its variables whole, so
+     * its `walletId` narrows the invalidation on its own; the settlement hooks
+     * take theirs from the acceptance receipt, which is the id the service
+     * actually settled. Omitted, every id of the owner matches.
+     */
+    walletId?: bigint;
+}
+/**
+ * Invalidate the reads a relayed InstantLayer batch changed.
+ *
+ * Only transport-level facts: `operationType` is a free-form label the fee
+ * policy ignores, so the SDK cannot know which domain reads a batch touched and
+ * must not guess. Callers who know the operation pass their own `onSuccess` to
+ * `mutate`, which now runs after confirmation.
+ *
+ * @internal
+ */
+export declare function invalidateRelayInstantOperationsReads(queryClient: QueryClient, scope: Scope, signerAccounts: readonly Address[]): void;
+/**
+ * Invalidate the reads a relayed gasless-wallet `execute` changed.
+ *
+ * The wallet-operation nonce is keyed by `(owner, walletId, signerAccount)`,
+ * and the operation consumed it under its signer account — which defaults to
+ * the owner. The wallet's own collateral balance moves, and its address is
+ * derived rather than passed, so the collateral read is invalidated chain-wide.
+ * The operation may also have deployed the wallet, which zeroes its creation fee.
+ *
+ * @param wallet - The action's variables, forwarded whole: `owner`, `signerAccount` and `walletId`
+ *   scope the invalidation, and each omitted one matches every value.
+ *
+ * @internal
+ */
+export declare function invalidateGaslessWalletExecuteReads(queryClient: QueryClient, scope: Scope, wallet: GaslessWalletScope & {
+    signerAccount?: Address;
+}): void;
+/**
+ * Invalidate the reads a relayed gasless batch changed.
+ *
+ * Unlike an opaque `relayInstantOperations` batch, every call of a gasless
+ * batch is a known relayable write (the SDK refuses anything else), so its
+ * selectors say exactly which domains moved. Each domain's reads are
+ * invalidated chain-wide — the calls' own arguments name the rows, but a
+ * superset is correct and a silent no-op is not.
+ *
+ * Always: the account's InstantLayer nonce, fee allowances and balances. Per
+ * GaslessWallet entry: that wallet's nonce, collateral and deployment reads.
+ *
+ * @param batch - The batch's variables: its `account` and `calls`.
+ *
+ * @internal
+ */
+export declare function invalidateGaslessBatchReads(queryClient: QueryClient, scope: Scope, batch: {
+    account: Address;
+    calls: readonly GaslessBatchCall[];
+}): void;
+/**
+ * Invalidate the reads a deposit settlement changed.
+ *
+ * The deposit address is swept to zero, so its collateral balance is
+ * invalidated precisely when the acceptance receipt carries it. The settlement
+ * deploys the wallet on its first use, which zeroes the wallet's creation fee
+ * and lowers its deposit policy's `settlementMinimum`, so both are invalidated
+ * for the owner's wallet.
+ *
+ * `depositAddress` arrives as the vendor's raw string, so a value that is not a
+ * well-formed address widens to a chain-wide collateral invalidation rather
+ * than scoping to nothing — a superset is correct, a silent no-op is not.
+ *
+ * @param options.owner - The settled wallet's owner.
+ * @param options.newAccount - `true` for a new-account settlement, which also
+ *   refreshes the owner's sub-account lists; omit for a top-up into an existing account.
+ *
+ * @internal
+ */
+export declare function invalidateDepositSettlementReads(queryClient: QueryClient, scope: Scope, options: GaslessWalletScope & {
+    depositAddress?: string;
+    newAccount?: boolean;
+}): void;
+export {};
+//# sourceMappingURL=invalidate-relay-reads.d.ts.map

package/dist/gasless/invalidate-relay-reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidate-relay-reads.d.ts","sourceRoot":"","sources":["../../src/gasless/invalidate-relay-reads.ts"],"names":[],"mappings":"AAAA,OAAO,EA2BL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAA6D,KAAK,OAAO,EAAY,MAAM,MAAM,CAAC;AAIzG,gEAAgE;AAChE,UAAU,KAAK;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,UAAU,kBAAkB;IAC1B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,qCAAqC,CACnD,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,SAAS,OAAO,EAAE,GACjC,IAAI,CAWN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,kBAAkB,GAAG;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD,IAAI,CAYN;AAyCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAAE,GAC9D,IAAI,CA0DN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,kBAAkB,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9E,IAAI,CAcN"}

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

@@ -0,0 +1,107 @@
+import { predicateMatch as e } from "../utils/predicate-match.js";
+import { invalidateAccountBalances as t } from "../utils/invalidate-account-balances.js";
+import { accountLayerAbi as n, getCollateralAllowanceQueryKey as r, getCollateralBalanceQueryKey as i, getDelegationExpiryQueryKey as a, getGaslessBatchSelectors as o, getGaslessDepositPolicyQueryKey as s, getGaslessWalletCreationFeeQueryKey as c, getGaslessWalletNonceQueryKey as l, getInstantLayerNonceQueryKey as u, getIsDelegationActiveQueryKey as d, getLastWithdrawRequestIdQueryKey as f, getOperationalFeeAllowanceQueryKey as p, getPartyAOpenPositionsQueryKey as m, getPartyAPendingQuotesQueryKey as h, getPendingQuotesQueryKey as g, getPendingWithdrawRequestsQueryKey as _, getQuotePendingFundingQueryKey as v, getQuoteQueryKey as y, getSubAccountQueryKey as b, getSubAccountsCountOfUserQueryKey as x, getUserSubAccountsAddressesQueryKey as S, getUserSubAccountsQueryKey as C, getWithdrawRequestsQueryKey as w, getWithdrawableTimeQueryKey as T, instantLayerAbi as E, symmioAbi as D } from "@symmio/trading-core";
+import { isAddress as O, toFunctionSelector as k } from "viem";
+//#region src/gasless/invalidate-relay-reads.ts
+function A(n, r, i) {
+	t(n, r), n.invalidateQueries({ predicate: e(p, {
+		...r,
+		payer: i
+	}) });
+}
+function j(t, n, r) {
+	let i = {
+		...n,
+		owner: r.owner,
+		walletId: r.walletId
+	};
+	t.invalidateQueries({ predicate: e(s, i) }), t.invalidateQueries({ predicate: e(c, i) });
+}
+function M(n, r, i) {
+	let a = [...new Set(i)];
+	for (let t of a) n.invalidateQueries({ predicate: e(u, {
+		...r,
+		account: t
+	}) }), n.invalidateQueries({ predicate: e(p, {
+		...r,
+		payer: t
+	}) });
+	t(n, r);
+}
+function N(t, n, r) {
+	t.invalidateQueries({ predicate: e(l, {
+		...n,
+		owner: r.owner,
+		walletId: r.walletId,
+		account: r.signerAccount ?? r.owner
+	}) }), t.invalidateQueries({ predicate: e(i, n) }), j(t, n, r), A(t, n);
+}
+function P(e, t) {
+	let n = e.find((e) => e.type === "function" && e.name === t);
+	if (!n) throw Error(`invalidate-relay-reads: the shipped ABI has no function "${t}".`);
+	return k(n);
+}
+var F = new Set([
+	P(D, "initiateWithdraw"),
+	P(D, "requestCancelWithdraw"),
+	P(D, "finalizeWithdrawRequest")
+]), I = new Set([
+	P(D, "requestToCancelQuote"),
+	P(D, "requestToCancelCloseRequest"),
+	P(D, "forceCancelQuote"),
+	P(D, "forceCancelCloseRequest"),
+	P(D, "forceClosePosition")
+]), L = new Set([
+	P(n, "createSubAccounts"),
+	P(n, "deleteSubAccount"),
+	P(n, "editAccountName")
+]), R = new Set([P(n, "depositForAccount"), P(n, "depositAndAllocateForAccount")]), z = P(E, "grantDelegation");
+function B(t, n, s) {
+	let c = new Set(o(s.calls)), l = (e) => [...e].some((e) => c.has(e));
+	t.invalidateQueries({ predicate: e(u, {
+		...n,
+		account: s.account
+	}) }), A(t, n);
+	for (let e of s.calls) "walletCalls" in e && N(t, n, {
+		walletId: e.walletId ?? 0n,
+		signerAccount: s.account
+	});
+	if (l(F)) for (let r of [
+		_,
+		f,
+		T,
+		w
+	]) t.invalidateQueries({ predicate: e(r, n) });
+	if (l(I)) for (let r of [
+		h,
+		g,
+		y,
+		m,
+		v
+	]) t.invalidateQueries({ predicate: e(r, n) });
+	if (l(L)) for (let r of [
+		C,
+		S,
+		x,
+		b
+	]) t.invalidateQueries({ predicate: e(r, n) });
+	l(R) && (t.invalidateQueries({ predicate: e(i, n) }), t.invalidateQueries({ predicate: e(r, n) })), c.has(z) && (t.invalidateQueries({ predicate: e(d, n) }), t.invalidateQueries({ predicate: e(a, n) }));
+}
+function V(n, r, a) {
+	let o = a.depositAddress && O(a.depositAddress) ? a.depositAddress : void 0;
+	if (n.invalidateQueries({ predicate: e(i, {
+		...r,
+		owner: o
+	}) }), a.newAccount && a.owner) {
+		let t = {
+			...r,
+			user: a.owner
+		};
+		n.invalidateQueries({ predicate: e(C, t) }), n.invalidateQueries({ predicate: e(S, t) }), n.invalidateQueries({ predicate: e(x, t) });
+	}
+	j(n, r, a), t(n, r);
+}
+//#endregion
+export { V as invalidateDepositSettlementReads, B as invalidateGaslessBatchReads, N as invalidateGaslessWalletExecuteReads, M as invalidateRelayInstantOperationsReads };
+
+//# sourceMappingURL=invalidate-relay-reads.js.map