@symmio/trading-core 3.0.0 → 3.1.0

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

@@ -0,0 +1,75 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter, ExactPartial } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GaslessRequestStatus } from '../types.js';
+import { GetGaslessRequestTransactionsParameters, GetGaslessRequestTransactionsReturnType } from './get-gasless-request-transactions.js';
+/** Data resolved by the {@link getGaslessRequestTransactionsQueryOptions} query. */
+export type GetGaslessRequestTransactionsData = GetGaslessRequestTransactionsReturnType;
+/**
+ * Build the TanStack Query key for {@link getGaslessRequestTransactionsQueryOptions}.
+ *
+ * @param options - Partial query parameters.
+ * @returns A stable, hashable query key.
+ */
+export declare function getGaslessRequestTransactionsQueryKey(options?: Compute<ExactPartial<GetGaslessRequestTransactionsParameters> & ConfigKeyParameter>): readonly ["getGaslessRequestTransactions", Record<string, unknown>];
+/** Query-key type produced by {@link getGaslessRequestTransactionsQueryKey}. */
+export type GetGaslessRequestTransactionsQueryKey = ReturnType<typeof getGaslessRequestTransactionsQueryKey>;
+/**
+ * Options accepted by {@link getGaslessRequestTransactionsQueryOptions}.
+ */
+export type GetGaslessRequestTransactionsOptions = Compute<GetGaslessRequestTransactionsParameters & {
+    /**
+     * The record's last known status, used **only** to drive the poll cadence:
+     * the attempts list carries nothing that says when the workflow is over, so
+     * without it this query has no stopping condition and does not poll at all.
+     *
+     * Pass the status you are already reading (`useGaslessRequest(...).data?.status`
+     * or `getGaslessRequest`) and the list follows the record's jittered
+     * cadence — 1–2 s while `queued`, 3–5 s after `submitted` — and stops on a
+     * terminal status, whose attempts are final.
+     *
+     * It is deliberately not part of the query key: the attempts of one request
+     * are one cache entry, not one per status.
+     */
+    status?: GaslessRequestStatus;
+} & QueryParameter<GetGaslessRequestTransactionsData, Error, GetGaslessRequestTransactionsData, GetGaslessRequestTransactionsQueryKey>>;
+/**
+ * TanStack Query options returned by
+ * {@link getGaslessRequestTransactionsQueryOptions}. Its `queryFn` takes the
+ * query context, so TanStack's `AbortSignal` cancels the read in flight.
+ */
+export type GetGaslessRequestTransactionsQueryOptions = Omit<SymmioQueryOptions<GetGaslessRequestTransactionsData, Error, GetGaslessRequestTransactionsData, GetGaslessRequestTransactionsQueryKey>, "queryFn"> & {
+    queryFn: (context?: {
+        signal?: AbortSignal;
+    }) => Promise<GetGaslessRequestTransactionsData>;
+};
+/**
+ * Build TanStack Query options for {@link getGaslessRequestTransactions}.
+ *
+ * **Polls only when you hand it the record's `status`.** The attempts list has
+ * no stopping condition of its own — an attempt that `reverted` may be followed
+ * by another one, and a request with no attempt yet looks exactly like a request
+ * that will never get one — so a self-driven poll here would keep billing the
+ * service long after the workflow ended. Given `status` it follows the record's
+ * jittered cadence and stops at a terminal status; without it it fetches once,
+ * and `query.refetchInterval` is yours to set.
+ *
+ * Transient transport failures (`429`, `503`, a dropped connection) are retried
+ * with the gateway's `Retry-After` when it sent one and a jittered backoff
+ * otherwise; a definitive answer is surfaced immediately.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters, the optional cadence `status`, and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * const request = useQuery(getGaslessRequestQueryOptions(config, { requestId }));
+ * // Follows the record: same cadence, stops when it does.
+ * const attempts = useQuery(
+ *   getGaslessRequestTransactionsQueryOptions(config, { requestId, status: request.data?.status }),
+ * );
+ * ```
+ */
+export declare function getGaslessRequestTransactionsQueryOptions(config: Config, options: GetGaslessRequestTransactionsOptions): GetGaslessRequestTransactionsQueryOptions;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-request-transactions/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAInF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAEL,KAAK,uCAAuC,EAC5C,KAAK,uCAAuC,EAC7C,MAAM,oCAAoC,CAAC;AAE5C,oFAAoF;AACpF,MAAM,MAAM,iCAAiC,GAAG,uCAAuC,CAAC;AAExF;;;;;GAKG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,GAAE,OAAO,CAAC,YAAY,CAAC,uCAAuC,CAAC,GAAG,kBAAkB,CAAM,uEAGlG;AAED,gFAAgF;AAChF,MAAM,MAAM,qCAAqC,GAAG,UAAU,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAE7G;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,OAAO,CACxD,uCAAuC,GAAG;IACxC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B,GAAG,cAAc,CACd,iCAAiC,EACjC,KAAK,EACL,iCAAiC,EACjC,qCAAqC,CACtC,CACJ,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yCAAyC,GAAG,IAAI,CAC1D,kBAAkB,CAChB,iCAAiC,EACjC,KAAK,EACL,iCAAiC,EACjC,qCAAqC,CACtC,EACD,SAAS,CACV,GAAG;IACF,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,iCAAiC,CAAC,CAAC;CAC7F,CAAC;AAKF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,yCAAyC,CACvD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,oCAAoC,GAC5C,yCAAyC,CAwC3C"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/gasless/get-gasless-request-transactions/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter, ExactPartial } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport { gaslessQueryPollDelay } from \"../query-poll-delay\";\nimport { gaslessTransientReadDelay, isTransientGaslessReadError } from \"../transient-read\";\nimport type { GaslessRequestStatus } from \"../types\";\nimport {\n  getGaslessRequestTransactions,\n  type GetGaslessRequestTransactionsParameters,\n  type GetGaslessRequestTransactionsReturnType,\n} from \"./get-gasless-request-transactions\";\n\n/** Data resolved by the {@link getGaslessRequestTransactionsQueryOptions} query. */\nexport type GetGaslessRequestTransactionsData = GetGaslessRequestTransactionsReturnType;\n\n/**\n * Build the TanStack Query key for {@link getGaslessRequestTransactionsQueryOptions}.\n *\n * @param options - Partial query parameters.\n * @returns A stable, hashable query key.\n */\nexport function getGaslessRequestTransactionsQueryKey(\n  options: Compute<ExactPartial<GetGaslessRequestTransactionsParameters> & ConfigKeyParameter> = {},\n) {\n  return [\"getGaslessRequestTransactions\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getGaslessRequestTransactionsQueryKey}. */\nexport type GetGaslessRequestTransactionsQueryKey = ReturnType<typeof getGaslessRequestTransactionsQueryKey>;\n\n/**\n * Options accepted by {@link getGaslessRequestTransactionsQueryOptions}.\n */\nexport type GetGaslessRequestTransactionsOptions = Compute<\n  GetGaslessRequestTransactionsParameters & {\n    /**\n     * The record's last known status, used **only** to drive the poll cadence:\n     * the attempts list carries nothing that says when the workflow is over, so\n     * without it this query has no stopping condition and does not poll at all.\n     *\n     * Pass the status you are already reading (`useGaslessRequest(...).data?.status`\n     * or `getGaslessRequest`) and the list follows the record's jittered\n     * cadence — 1–2 s while `queued`, 3–5 s after `submitted` — and stops on a\n     * terminal status, whose attempts are final.\n     *\n     * It is deliberately not part of the query key: the attempts of one request\n     * are one cache entry, not one per status.\n     */\n    status?: GaslessRequestStatus;\n  } & QueryParameter<\n      GetGaslessRequestTransactionsData,\n      Error,\n      GetGaslessRequestTransactionsData,\n      GetGaslessRequestTransactionsQueryKey\n    >\n>;\n\n/**\n * TanStack Query options returned by\n * {@link getGaslessRequestTransactionsQueryOptions}. Its `queryFn` takes the\n * query context, so TanStack's `AbortSignal` cancels the read in flight.\n */\nexport type GetGaslessRequestTransactionsQueryOptions = Omit<\n  SymmioQueryOptions<\n    GetGaslessRequestTransactionsData,\n    Error,\n    GetGaslessRequestTransactionsData,\n    GetGaslessRequestTransactionsQueryKey\n  >,\n  \"queryFn\"\n> & {\n  queryFn: (context?: { signal?: AbortSignal }) => Promise<GetGaslessRequestTransactionsData>;\n};\n\n/** How many consecutive transient transport failures are absorbed before the query surfaces an error. */\nconst TRANSIENT_RETRIES = 8;\n\n/**\n * Build TanStack Query options for {@link getGaslessRequestTransactions}.\n *\n * **Polls only when you hand it the record's `status`.** The attempts list has\n * no stopping condition of its own — an attempt that `reverted` may be followed\n * by another one, and a request with no attempt yet looks exactly like a request\n * that will never get one — so a self-driven poll here would keep billing the\n * service long after the workflow ended. Given `status` it follows the record's\n * jittered cadence and stops at a terminal status; without it it fetches once,\n * and `query.refetchInterval` is yours to set.\n *\n * Transient transport failures (`429`, `503`, a dropped connection) are retried\n * with the gateway's `Retry-After` when it sent one and a jittered backoff\n * otherwise; a definitive answer is surfaced immediately.\n *\n * @param config - The SDK config.\n * @param options - Query parameters, the optional cadence `status`, and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * const request = useQuery(getGaslessRequestQueryOptions(config, { requestId }));\n * // Follows the record: same cadence, stops when it does.\n * const attempts = useQuery(\n *   getGaslessRequestTransactionsQueryOptions(config, { requestId, status: request.data?.status }),\n * );\n * ```\n */\nexport function getGaslessRequestTransactionsQueryOptions(\n  config: Config,\n  options: GetGaslessRequestTransactionsOptions,\n): GetGaslessRequestTransactionsQueryOptions {\n  const query = options.query;\n  /** Cadence input, never cache identity — see the field's docs. */\n  const { status, ...keyOptions } = options;\n\n  return {\n    ...query,\n    /**\n     * `service` is defaulted into the key exactly as the record's factory does\n     * it: the action defaults it too, so a key built without it would address\n     * the same attempts under a second cache entry.\n     */\n    queryKey: getGaslessRequestTransactionsQueryKey({\n      ...keyOptions,\n      service: options.service ?? \"operations\",\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: query?.enabled ?? true,\n    /**\n     * Seeded from the query's fetch timestamps, not drawn per call: TanStack\n     * restarts the countdown whenever a recomputed `refetchInterval` differs\n     * from the running one, so a per-call random delay never fires.\n     */\n    refetchInterval:\n      query?.refetchInterval ?? (status === undefined ? false : (q) => gaslessQueryPollDelay(status, q.state)),\n    queryFn: (context) => {\n      const { chainId, requestId, service } = options;\n      return getGaslessRequestTransactions(config, {\n        chainId,\n        requestId,\n        service,\n        signal: context?.signal ?? options.signal,\n      });\n    },\n    retry:\n      query?.retry ??\n      ((failureCount: number, error: Error) => isTransientGaslessReadError(error) && failureCount < TRANSIENT_RETRIES),\n    retryDelay:\n      query?.retryDelay ?? ((failureCount: number, error: Error) => gaslessTransientReadDelay(failureCount, error)),\n  };\n}\n"],"mappings":";;;;;AAsBA,SAAgB,EACd,IAA+F,CAAC,GAChG;CACA,OAAO,CAAC,iCAAiC,EAAmB,CAAO,CAAC;AACtE;AAkDA,IAAM,IAAoB;AA8B1B,SAAgB,EACd,GACA,GAC2C;CAC3C,IAAM,IAAQ,EAAQ,OAEhB,EAAE,WAAQ,GAAG,MAAe;CAElC,OAAO;EACL,GAAG;EAMH,UAAU,EAAsC;GAC9C,GAAG;GACH,SAAS,EAAQ,WAAW;GAC5B,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,GAAO,WAAW;EAM3B,iBACE,GAAO,oBAAoB,MAAW,KAAA,IAAY,MAAS,MAAM,EAAsB,GAAQ,EAAE,KAAK;EACxG,UAAU,MAAY;GACpB,IAAM,EAAE,YAAS,cAAW,eAAY;GACxC,OAAO,EAA8B,GAAQ;IAC3C;IACA;IACA;IACA,QAAQ,GAAS,UAAU,EAAQ;GACrC,CAAC;EACH;EACA,OACE,GAAO,WACL,GAAsB,MAAiB,EAA4B,CAAK,KAAK,IAAe;EAChG,YACE,GAAO,gBAAgB,GAAsB,MAAiB,EAA0B,GAAc,CAAK;CAC/G;AACF"}

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

@@ -0,0 +1,21 @@
+import { GaslessTransactionAttemptStatus, GaslessRequestTransaction } from '../types.js';
+import { GaslessWireTransactionAttempt } from '../wire-types.js';
+/**
+ * Parse a wire attempt status into {@link GaslessTransactionAttemptStatus}.
+ *
+ * @throws {SymmError} `GASLESS_ATTEMPT_STATUS_UNKNOWN` for a value outside the
+ *   documented set — the same loud-failure rule the request-status parser
+ *   follows, so a silently mistyped attempt never renders as a confirmed one.
+ *
+ * @internal
+ */
+export declare function toGaslessTransactionAttemptStatus(raw: string): GaslessTransactionAttemptStatus;
+/**
+ * Normalize one stored EVM broadcast attempt into
+ * {@link GaslessRequestTransaction}. Optional wire fields normalize to
+ * explicit `null`.
+ *
+ * @internal
+ */
+export declare function toGaslessRequestTransaction(raw: GaslessWireTransactionAttempt): GaslessRequestTransaction;
+//# sourceMappingURL=to-gasless-request-transaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"to-gasless-request-transaction.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-request-transactions/to-gasless-request-transaction.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,+BAA+B,EAAE,KAAK,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC3F,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAInE;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,+BAA+B,CAS9F;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,6BAA6B,GAAG,yBAAyB,CAczG"}

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

@@ -0,0 +1,27 @@
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+import { GaslessTransactionAttemptStatus as t } from "../types.js";
+//#region src/gasless/get-gasless-request-transactions/to-gasless-request-transaction.ts
+var n = new Set(Object.values(t));
+function r(t) {
+	if (!n.has(t)) throw new e("api", "GASLESS_ATTEMPT_STATUS_UNKNOWN", `Gasless: unknown transaction attempt status "${t}".`);
+	return t;
+}
+function i(e) {
+	return {
+		id: e.id,
+		txHash: e.tx_hash ?? null,
+		attemptNumber: e.attempt_number,
+		status: r(e.status),
+		requestId: e.entity_id,
+		workflow: e.workflow,
+		receipt: e.receipt ?? null,
+		errorCode: e.error_code ?? null,
+		errorMessage: e.error_message ?? null,
+		createdAt: e.created_at ?? null,
+		updatedAt: e.updated_at ?? null
+	};
+}
+//#endregion
+export { i as toGaslessRequestTransaction };
+
+//# sourceMappingURL=to-gasless-request-transaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"to-gasless-request-transaction.js","names":[],"sources":["../../../src/gasless/get-gasless-request-transactions/to-gasless-request-transaction.ts"],"sourcesContent":["import type { Hash } from \"viem\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport { GaslessTransactionAttemptStatus, type GaslessRequestTransaction } from \"../types\";\nimport type { GaslessWireTransactionAttempt } from \"../wire-types\";\n\nconst ATTEMPT_STATUS_VALUES = new Set<string>(Object.values(GaslessTransactionAttemptStatus));\n\n/**\n * Parse a wire attempt status into {@link GaslessTransactionAttemptStatus}.\n *\n * @throws {SymmError} `GASLESS_ATTEMPT_STATUS_UNKNOWN` for a value outside the\n *   documented set — the same loud-failure rule the request-status parser\n *   follows, so a silently mistyped attempt never renders as a confirmed one.\n *\n * @internal\n */\nexport function toGaslessTransactionAttemptStatus(raw: string): GaslessTransactionAttemptStatus {\n  if (!ATTEMPT_STATUS_VALUES.has(raw)) {\n    throw new SymmError(\n      \"api\",\n      \"GASLESS_ATTEMPT_STATUS_UNKNOWN\",\n      `Gasless: unknown transaction attempt status \"${raw}\".`,\n    );\n  }\n  return raw as GaslessTransactionAttemptStatus;\n}\n\n/**\n * Normalize one stored EVM broadcast attempt into\n * {@link GaslessRequestTransaction}. Optional wire fields normalize to\n * explicit `null`.\n *\n * @internal\n */\nexport function toGaslessRequestTransaction(raw: GaslessWireTransactionAttempt): GaslessRequestTransaction {\n  return {\n    id: raw.id,\n    txHash: (raw.tx_hash as Hash | undefined) ?? null,\n    attemptNumber: raw.attempt_number,\n    status: toGaslessTransactionAttemptStatus(raw.status),\n    requestId: raw.entity_id,\n    workflow: raw.workflow,\n    receipt: raw.receipt ?? null,\n    errorCode: raw.error_code ?? null,\n    errorMessage: raw.error_message ?? null,\n    createdAt: raw.created_at ?? null,\n    updatedAt: raw.updated_at ?? null,\n  };\n}\n"],"mappings":";;;AAKA,IAAM,IAAwB,IAAI,IAAY,OAAO,OAAO,CAA+B,CAAC;AAW5F,SAAgB,EAAkC,GAA8C;CAC9F,IAAI,CAAC,EAAsB,IAAI,CAAG,GAChC,MAAM,IAAI,EACR,OACA,kCACA,gDAAgD,EAAI,GACtD;CAEF,OAAO;AACT;AASA,SAAgB,EAA4B,GAA+D;CACzG,OAAO;EACL,IAAI,EAAI;EACR,QAAS,EAAI,WAAgC;EAC7C,eAAe,EAAI;EACnB,QAAQ,EAAkC,EAAI,MAAM;EACpD,WAAW,EAAI;EACf,UAAU,EAAI;EACd,SAAS,EAAI,WAAW;EACxB,WAAW,EAAI,cAAc;EAC7B,cAAc,EAAI,iBAAiB;EACnC,WAAW,EAAI,cAAc;EAC7B,WAAW,EAAI,cAAc;CAC/B;AACF"}

package/dist/gasless/get-gasless-wallet-address/get-gasless-wallet-address.d.ts

@@ -0,0 +1,48 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+/**
+ * Parameters for {@link getGaslessWalletAddress}.
+ */
+export type GetGaslessWalletAddressParameters = Compute<ChainIdParameter & {
+    /** The owner wallet the deterministic gasless wallet belongs to — an owner address, never a GaslessWallet address. */
+    owner: Address;
+    /**
+     * Which of the owner's GaslessWallets to read. Defaults to `0n`, the
+     * original wallet, whose address is unchanged by the multi-wallet upgrade.
+     * Every positive id derives its own independent address. Range `0n`
+     * through `2^256 - 1`.
+     */
+    walletId?: bigint;
+}>;
+/** Return type of {@link getGaslessWalletAddress}. */
+export type GetGaslessWalletAddressReturnType = Address;
+/**
+ * Read the deterministic address of an owner's GaslessWallet from the
+ * GaslessLayer — `getGaslessWalletAddress(owner, walletId)`.
+ *
+ * A pure `CREATE2` view, safe to show **before** any transaction exists: a
+ * wallet is deployed lazily on first use and can receive collateral before
+ * that. A wallet is identified by `(owner, walletId)`, and each id has its own
+ * address, balances and nonce stream. The address is the wallet's **deposit
+ * address** for gasless onboarding and the `target` of its gasless-wallet
+ * `execute` operations. Collateral sent to it can only ever reach a
+ * sub-account owned by `owner`.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Owner wallet, optional wallet id (default `0n`), optional chain id.
+ * @returns The deterministic wallet address.
+ * @throws {SymmError} `GASLESS_WALLET_ID_INVALID` for a wallet id outside the `uint256` range
+ *   (or a JavaScript `number`), before any RPC call.
+ * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`.
+ * @throws {SymmError} `GASLESS_WALLET_UNAVAILABLE` when the gateway returns the
+ *   zero address (an unconfigured deployment returns `0x0` instead of reverting).
+ *
+ * @example
+ * ```ts
+ * const original = await getGaslessWalletAddress(config, { owner });
+ * const depositWallet = await getGaslessWalletAddress(config, { owner, walletId: 1n });
+ * ```
+ */
+export declare function getGaslessWalletAddress(config: Config, parameters: GetGaslessWalletAddressParameters): Promise<GetGaslessWalletAddressReturnType>;
+//# sourceMappingURL=get-gasless-wallet-address.d.ts.map

package/dist/gasless/get-gasless-wallet-address/get-gasless-wallet-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gasless-wallet-address.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-wallet-address/get-gasless-wallet-address.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAK/E;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,OAAO,CACrD,gBAAgB,GAAG;IACjB,sHAAsH;IACtH,KAAK,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CACF,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,iCAAiC,GAAG,OAAO,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,iCAAiC,GAC5C,OAAO,CAAC,iCAAiC,CAAC,CAsB5C"}

package/dist/gasless/get-gasless-wallet-address/get-gasless-wallet-address.js

@@ -0,0 +1,20 @@
+import { gaslessLayerAbi as e } from "../../symmio-contracts/abi/v0.8.6/gasless-layer.js";
+import { SymmError as t } from "../../shared/errors/symm-error.js";
+import { resolveGaslessService as n } from "../resolve-gasless.js";
+import { assertGaslessWalletId as r } from "../wallet-id.js";
+import { isAddressEqual as i, zeroAddress as a } from "viem";
+//#region src/gasless/get-gasless-wallet-address/get-gasless-wallet-address.ts
+async function o(o, s) {
+	let { chainId: c, owner: l } = s, u = r(s.walletId ?? 0n), d = n(o, { chainId: c }), f = await o.getClient({ chainId: c }).readContract({
+		address: d.gaslessLayerAddress,
+		abi: e,
+		functionName: "getGaslessWalletAddress",
+		args: [l, u]
+	});
+	if (i(f, a)) throw new t("api", "GASLESS_WALLET_UNAVAILABLE", `Gasless: the GaslessLayer returned the zero address for wallet ${u} of ${l} — the gateway is not fully configured.`);
+	return f;
+}
+//#endregion
+export { o as getGaslessWalletAddress };
+
+//# sourceMappingURL=get-gasless-wallet-address.js.map

package/dist/gasless/get-gasless-wallet-address/get-gasless-wallet-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gasless-wallet-address.js","names":[],"sources":["../../../src/gasless/get-gasless-wallet-address/get-gasless-wallet-address.ts"],"sourcesContent":["import { isAddressEqual, zeroAddress, type Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { gaslessLayerAbi } from \"../../symmio-contracts/abi/v0.8.6/gasless-layer\";\nimport { resolveGaslessService } from \"../resolve-gasless\";\nimport { assertGaslessWalletId } from \"../wallet-id\";\n\n/**\n * Parameters for {@link getGaslessWalletAddress}.\n */\nexport type GetGaslessWalletAddressParameters = Compute<\n  ChainIdParameter & {\n    /** The owner wallet the deterministic gasless wallet belongs to — an owner address, never a GaslessWallet address. */\n    owner: Address;\n    /**\n     * Which of the owner's GaslessWallets to read. Defaults to `0n`, the\n     * original wallet, whose address is unchanged by the multi-wallet upgrade.\n     * Every positive id derives its own independent address. Range `0n`\n     * through `2^256 - 1`.\n     */\n    walletId?: bigint;\n  }\n>;\n\n/** Return type of {@link getGaslessWalletAddress}. */\nexport type GetGaslessWalletAddressReturnType = Address;\n\n/**\n * Read the deterministic address of an owner's GaslessWallet from the\n * GaslessLayer — `getGaslessWalletAddress(owner, walletId)`.\n *\n * A pure `CREATE2` view, safe to show **before** any transaction exists: a\n * wallet is deployed lazily on first use and can receive collateral before\n * that. A wallet is identified by `(owner, walletId)`, and each id has its own\n * address, balances and nonce stream. The address is the wallet's **deposit\n * address** for gasless onboarding and the `target` of its gasless-wallet\n * `execute` operations. Collateral sent to it can only ever reach a\n * sub-account owned by `owner`.\n *\n * @param config - The SDK config.\n * @param parameters - Owner wallet, optional wallet id (default `0n`), optional chain id.\n * @returns The deterministic wallet address.\n * @throws {SymmError} `GASLESS_WALLET_ID_INVALID` for a wallet id outside the `uint256` range\n *   (or a JavaScript `number`), before any RPC call.\n * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`.\n * @throws {SymmError} `GASLESS_WALLET_UNAVAILABLE` when the gateway returns the\n *   zero address (an unconfigured deployment returns `0x0` instead of reverting).\n *\n * @example\n * ```ts\n * const original = await getGaslessWalletAddress(config, { owner });\n * const depositWallet = await getGaslessWalletAddress(config, { owner, walletId: 1n });\n * ```\n */\nexport async function getGaslessWalletAddress(\n  config: Config,\n  parameters: GetGaslessWalletAddressParameters,\n): Promise<GetGaslessWalletAddressReturnType> {\n  const { chainId, owner } = parameters;\n  const walletId = assertGaslessWalletId(parameters.walletId ?? 0n);\n  const gasless = resolveGaslessService(config, { chainId });\n  const client = config.getClient({ chainId });\n\n  const wallet = await client.readContract({\n    address: gasless.gaslessLayerAddress,\n    abi: gaslessLayerAbi,\n    functionName: \"getGaslessWalletAddress\",\n    args: [owner, walletId],\n  });\n\n  /** The zero-address guard is load-bearing: an unwired gateway answers 0x0. */\n  if (isAddressEqual(wallet, zeroAddress)) {\n    throw new SymmError(\n      \"api\",\n      \"GASLESS_WALLET_UNAVAILABLE\",\n      `Gasless: the GaslessLayer returned the zero address for wallet ${walletId} of ${owner} — the gateway is not fully configured.`,\n    );\n  }\n  return wallet;\n}\n"],"mappings":";;;;;;AAuDA,eAAsB,EACpB,GACA,GAC4C;CAC5C,IAAM,EAAE,YAAS,aAAU,GACrB,IAAW,EAAsB,EAAW,YAAY,EAAE,GAC1D,IAAU,EAAsB,GAAQ,EAAE,WAAQ,CAAC,GAGnD,IAAS,MAFA,EAAO,UAAU,EAAE,WAAQ,CAErB,EAAO,aAAa;EACvC,SAAS,EAAQ;EACjB,KAAK;EACL,cAAc;EACd,MAAM,CAAC,GAAO,CAAQ;CACxB,CAAC;CAGD,IAAI,EAAe,GAAQ,CAAW,GACpC,MAAM,IAAI,EACR,OACA,8BACA,kEAAkE,EAAS,MAAM,EAAM,wCACzF;CAEF,OAAO;AACT"}

package/dist/gasless/get-gasless-wallet-address/index.d.ts

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

package/dist/gasless/get-gasless-wallet-address/index.d.ts.map

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

package/dist/gasless/get-gasless-wallet-address/query.d.ts

@@ -0,0 +1,46 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter, ExactPartial } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetGaslessWalletAddressParameters, GetGaslessWalletAddressReturnType } from './get-gasless-wallet-address.js';
+/** Data resolved by the {@link getGaslessWalletAddressQueryOptions} query. */
+export type GetGaslessWalletAddressData = GetGaslessWalletAddressReturnType;
+/**
+ * Build the TanStack Query key for {@link getGaslessWalletAddressQueryOptions}.
+ *
+ * An omitted `walletId` keys as `0n`, so `{ owner }` and `{ owner, walletId: 0n }`
+ * share one cache entry — they read the same wallet. `predicateMatch` compares
+ * only the fields its partial sets, so `predicateMatch(getGaslessWalletAddressQueryKey, { owner })`
+ * still matches every wallet id of the owner.
+ *
+ * @param options - Partial query parameters.
+ * @returns A stable, hashable query key.
+ *
+ * @example
+ * ```ts
+ * getGaslessWalletAddressQueryKey({ owner });
+ * // → ["getGaslessWalletAddress", { owner, walletId: "0" }]
+ * ```
+ */
+export declare function getGaslessWalletAddressQueryKey(options?: Compute<ExactPartial<GetGaslessWalletAddressParameters> & ConfigKeyParameter>): readonly ["getGaslessWalletAddress", Record<string, unknown>];
+/** Query-key type produced by {@link getGaslessWalletAddressQueryKey}. */
+export type GetGaslessWalletAddressQueryKey = ReturnType<typeof getGaslessWalletAddressQueryKey>;
+/**
+ * Options accepted by {@link getGaslessWalletAddressQueryOptions}.
+ */
+export type GetGaslessWalletAddressOptions = Compute<GetGaslessWalletAddressParameters & QueryParameter<GetGaslessWalletAddressData, Error, GetGaslessWalletAddressData, GetGaslessWalletAddressQueryKey>>;
+/** TanStack Query options returned by {@link getGaslessWalletAddressQueryOptions}. */
+export type GetGaslessWalletAddressQueryOptions = SymmioQueryOptions<GetGaslessWalletAddressData, Error, GetGaslessWalletAddressData, GetGaslessWalletAddressQueryKey>;
+/**
+ * Build TanStack Query options for {@link getGaslessWalletAddress}.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getGaslessWalletAddressQueryOptions(config, { owner, walletId: 1n }));
+ * ```
+ */
+export declare function getGaslessWalletAddressQueryOptions(config: Config, options: GetGaslessWalletAddressOptions): GetGaslessWalletAddressQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/gasless/get-gasless-wallet-address/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-wallet-address/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,EACvC,MAAM,8BAA8B,CAAC;AAEtC,8EAA8E;AAC9E,MAAM,MAAM,2BAA2B,GAAG,iCAAiC,CAAC;AAE5E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,OAAO,CAAC,YAAY,CAAC,iCAAiC,CAAC,GAAG,kBAAkB,CAAM,iEAG5F;AAED,0EAA0E;AAC1E,MAAM,MAAM,+BAA+B,GAAG,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEjG;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,OAAO,CAClD,iCAAiC,GAC/B,cAAc,CAAC,2BAA2B,EAAE,KAAK,EAAE,2BAA2B,EAAE,+BAA+B,CAAC,CACnH,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,mCAAmC,GAAG,kBAAkB,CAClE,2BAA2B,EAC3B,KAAK,EACL,2BAA2B,EAC3B,+BAA+B,CAChC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,8BAA8B,GACtC,mCAAmC,CAYrC"}

package/dist/gasless/get-gasless-wallet-address/query.js

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

package/dist/gasless/get-gasless-wallet-address/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/gasless/get-gasless-wallet-address/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter, ExactPartial } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport {\n  getGaslessWalletAddress,\n  type GetGaslessWalletAddressParameters,\n  type GetGaslessWalletAddressReturnType,\n} from \"./get-gasless-wallet-address\";\n\n/** Data resolved by the {@link getGaslessWalletAddressQueryOptions} query. */\nexport type GetGaslessWalletAddressData = GetGaslessWalletAddressReturnType;\n\n/**\n * Build the TanStack Query key for {@link getGaslessWalletAddressQueryOptions}.\n *\n * An omitted `walletId` keys as `0n`, so `{ owner }` and `{ owner, walletId: 0n }`\n * share one cache entry — they read the same wallet. `predicateMatch` compares\n * only the fields its partial sets, so `predicateMatch(getGaslessWalletAddressQueryKey, { owner })`\n * still matches every wallet id of the owner.\n *\n * @param options - Partial query parameters.\n * @returns A stable, hashable query key.\n *\n * @example\n * ```ts\n * getGaslessWalletAddressQueryKey({ owner });\n * // → [\"getGaslessWalletAddress\", { owner, walletId: \"0\" }]\n * ```\n */\nexport function getGaslessWalletAddressQueryKey(\n  options: Compute<ExactPartial<GetGaslessWalletAddressParameters> & ConfigKeyParameter> = {},\n) {\n  return [\"getGaslessWalletAddress\", filterQueryOptions({ ...options, walletId: options.walletId ?? 0n })] as const;\n}\n\n/** Query-key type produced by {@link getGaslessWalletAddressQueryKey}. */\nexport type GetGaslessWalletAddressQueryKey = ReturnType<typeof getGaslessWalletAddressQueryKey>;\n\n/**\n * Options accepted by {@link getGaslessWalletAddressQueryOptions}.\n */\nexport type GetGaslessWalletAddressOptions = Compute<\n  GetGaslessWalletAddressParameters &\n    QueryParameter<GetGaslessWalletAddressData, Error, GetGaslessWalletAddressData, GetGaslessWalletAddressQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getGaslessWalletAddressQueryOptions}. */\nexport type GetGaslessWalletAddressQueryOptions = SymmioQueryOptions<\n  GetGaslessWalletAddressData,\n  Error,\n  GetGaslessWalletAddressData,\n  GetGaslessWalletAddressQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getGaslessWalletAddress}.\n *\n * @param config - The SDK config.\n * @param options - Query parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(getGaslessWalletAddressQueryOptions(config, { owner, walletId: 1n }));\n * ```\n */\nexport function getGaslessWalletAddressQueryOptions(\n  config: Config,\n  options: GetGaslessWalletAddressOptions,\n): GetGaslessWalletAddressQueryOptions {\n  /** Every parameter reaches the action: a hand-listed subset would silently drop a new one, such as `walletId`. */\n  const { query, ...parameters } = options;\n  return {\n    ...query,\n    queryKey: getGaslessWalletAddressQueryKey({\n      ...parameters,\n      configKey: config.getChainConfigKey(parameters.chainId),\n    }),\n    enabled: query?.enabled ?? true,\n    queryFn: () => getGaslessWalletAddress(config, parameters),\n  };\n}\n"],"mappings":";;;AA8BA,SAAgB,EACd,IAAyF,CAAC,GAC1F;CACA,OAAO,CAAC,2BAA2B,EAAmB;EAAE,GAAG;EAAS,UAAU,EAAQ,YAAY;CAAG,CAAC,CAAC;AACzG;AAiCA,SAAgB,EACd,GACA,GACqC;CAErC,IAAM,EAAE,UAAO,GAAG,MAAe;CACjC,OAAO;EACL,GAAG;EACH,UAAU,EAAgC;GACxC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAW,OAAO;EACxD,CAAC;EACD,SAAS,GAAO,WAAW;EAC3B,eAAe,EAAwB,GAAQ,CAAU;CAC3D;AACF"}

package/dist/gasless/get-gasless-wallet-creation-fee/get-gasless-wallet-creation-fee.d.ts

@@ -0,0 +1,57 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+/**
+ * Parameters for {@link getGaslessWalletCreationFee}.
+ */
+export type GetGaslessWalletCreationFeeParameters = Compute<ChainIdParameter & {
+    /** The owner wallet the gasless wallet belongs to — an owner address, never a GaslessWallet address. */
+    owner: Address;
+    /**
+     * Which of the owner's GaslessWallets to quote. Defaults to `0n`, the
+     * original wallet. Range `0n` through `2^256 - 1`.
+     */
+    walletId?: bigint;
+}>;
+/**
+ * Return type of {@link getGaslessWalletCreationFee}: the fee in the collateral
+ * token's own units (its decimals, not SYMMIO's 18).
+ */
+export type GetGaslessWalletCreationFeeReturnType = bigint;
+/**
+ * Read the one-time fee for deploying a GaslessWallet —
+ * `getWalletCreationFee(owner, walletId)` on the GaslessLayer.
+ *
+ * Wallets deploy lazily, on their first use. While the wallet derived from
+ * `(owner, walletId)` has no code, the read returns the GaslessLayer's
+ * configured `walletCreationFee`; once the wallet is deployed it returns `0n`.
+ * That holds for **every** wallet id, wallet `0` included: an original wallet
+ * that was never deployed pays the fee once too.
+ *
+ * The amount is in **collateral token units**, and whoever deploys the wallet
+ * pays it once:
+ * - a deposit settlement deducts it from the swept balance, on top of the
+ *   deposit fee, so it raises the settlement minimum (see
+ *   `getGaslessDepositPolicy`);
+ * - a relayed wallet operation charges it to the payer's SYMMIO balance,
+ *   rescaled to 18 decimals — the `walletCreationFee18` of that operation's
+ *   fee-quote payment (see `getGaslessFeeQuote`).
+ *
+ * It is a snapshot of the current state: the value drops to `0n` as soon as
+ * any action deploys the wallet.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Owner wallet, optional wallet id (default `0n`), optional chain id.
+ * @returns The creation fee in collateral token units; `0n` for a deployed wallet.
+ * @throws {SymmError} `GASLESS_WALLET_ID_INVALID` for a wallet id outside the `uint256` range
+ *   (or a JavaScript `number`), before any RPC call.
+ * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`.
+ *
+ * @example
+ * ```ts
+ * const fee = await getGaslessWalletCreationFee(config, { owner, walletId: 1n });
+ * // Collateral token units; 0n once the wallet is deployed or when the deployment charges none.
+ * ```
+ */
+export declare function getGaslessWalletCreationFee(config: Config, parameters: GetGaslessWalletCreationFeeParameters): Promise<GetGaslessWalletCreationFeeReturnType>;
+//# sourceMappingURL=get-gasless-wallet-creation-fee.d.ts.map

package/dist/gasless/get-gasless-wallet-creation-fee/get-gasless-wallet-creation-fee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gasless-wallet-creation-fee.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-wallet-creation-fee/get-gasless-wallet-creation-fee.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAK/E;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAAG,OAAO,CACzD,gBAAgB,GAAG;IACjB,wGAAwG;IACxG,KAAK,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qCAAqC,GAAG,MAAM,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,qCAAqC,GAChD,OAAO,CAAC,qCAAqC,CAAC,CAYhD"}

package/dist/gasless/get-gasless-wallet-creation-fee/get-gasless-wallet-creation-fee.js

@@ -0,0 +1,17 @@
+import { gaslessLayerAbi as e } from "../../symmio-contracts/abi/v0.8.6/gasless-layer.js";
+import { resolveGaslessService as t } from "../resolve-gasless.js";
+import { assertGaslessWalletId as n } from "../wallet-id.js";
+//#region src/gasless/get-gasless-wallet-creation-fee/get-gasless-wallet-creation-fee.ts
+async function r(r, i) {
+	let { chainId: a, owner: o } = i, s = n(i.walletId ?? 0n), c = t(r, { chainId: a });
+	return r.getClient({ chainId: a }).readContract({
+		address: c.gaslessLayerAddress,
+		abi: e,
+		functionName: "getWalletCreationFee",
+		args: [o, s]
+	});
+}
+//#endregion
+export { r as getGaslessWalletCreationFee };
+
+//# sourceMappingURL=get-gasless-wallet-creation-fee.js.map

package/dist/gasless/get-gasless-wallet-creation-fee/get-gasless-wallet-creation-fee.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gasless-wallet-creation-fee.js","names":[],"sources":["../../../src/gasless/get-gasless-wallet-creation-fee/get-gasless-wallet-creation-fee.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { gaslessLayerAbi } from \"../../symmio-contracts/abi/v0.8.6/gasless-layer\";\nimport { resolveGaslessService } from \"../resolve-gasless\";\nimport { assertGaslessWalletId } from \"../wallet-id\";\n\n/**\n * Parameters for {@link getGaslessWalletCreationFee}.\n */\nexport type GetGaslessWalletCreationFeeParameters = Compute<\n  ChainIdParameter & {\n    /** The owner wallet the gasless wallet belongs to — an owner address, never a GaslessWallet address. */\n    owner: Address;\n    /**\n     * Which of the owner's GaslessWallets to quote. Defaults to `0n`, the\n     * original wallet. Range `0n` through `2^256 - 1`.\n     */\n    walletId?: bigint;\n  }\n>;\n\n/**\n * Return type of {@link getGaslessWalletCreationFee}: the fee in the collateral\n * token's own units (its decimals, not SYMMIO's 18).\n */\nexport type GetGaslessWalletCreationFeeReturnType = bigint;\n\n/**\n * Read the one-time fee for deploying a GaslessWallet —\n * `getWalletCreationFee(owner, walletId)` on the GaslessLayer.\n *\n * Wallets deploy lazily, on their first use. While the wallet derived from\n * `(owner, walletId)` has no code, the read returns the GaslessLayer's\n * configured `walletCreationFee`; once the wallet is deployed it returns `0n`.\n * That holds for **every** wallet id, wallet `0` included: an original wallet\n * that was never deployed pays the fee once too.\n *\n * The amount is in **collateral token units**, and whoever deploys the wallet\n * pays it once:\n * - a deposit settlement deducts it from the swept balance, on top of the\n *   deposit fee, so it raises the settlement minimum (see\n *   `getGaslessDepositPolicy`);\n * - a relayed wallet operation charges it to the payer's SYMMIO balance,\n *   rescaled to 18 decimals — the `walletCreationFee18` of that operation's\n *   fee-quote payment (see `getGaslessFeeQuote`).\n *\n * It is a snapshot of the current state: the value drops to `0n` as soon as\n * any action deploys the wallet.\n *\n * @param config - The SDK config.\n * @param parameters - Owner wallet, optional wallet id (default `0n`), optional chain id.\n * @returns The creation fee in collateral token units; `0n` for a deployed wallet.\n * @throws {SymmError} `GASLESS_WALLET_ID_INVALID` for a wallet id outside the `uint256` range\n *   (or a JavaScript `number`), before any RPC call.\n * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`.\n *\n * @example\n * ```ts\n * const fee = await getGaslessWalletCreationFee(config, { owner, walletId: 1n });\n * // Collateral token units; 0n once the wallet is deployed or when the deployment charges none.\n * ```\n */\nexport async function getGaslessWalletCreationFee(\n  config: Config,\n  parameters: GetGaslessWalletCreationFeeParameters,\n): Promise<GetGaslessWalletCreationFeeReturnType> {\n  const { chainId, owner } = parameters;\n  const walletId = assertGaslessWalletId(parameters.walletId ?? 0n);\n  const gasless = resolveGaslessService(config, { chainId });\n  const client = config.getClient({ chainId });\n\n  return client.readContract({\n    address: gasless.gaslessLayerAddress,\n    abi: gaslessLayerAbi,\n    functionName: \"getWalletCreationFee\",\n    args: [owner, walletId],\n  });\n}\n"],"mappings":";;;;AA+DA,eAAsB,EACpB,GACA,GACgD;CAChD,IAAM,EAAE,YAAS,aAAU,GACrB,IAAW,EAAsB,EAAW,YAAY,EAAE,GAC1D,IAAU,EAAsB,GAAQ,EAAE,WAAQ,CAAC;CAGzD,OAFe,EAAO,UAAU,EAAE,WAAQ,CAEnC,EAAO,aAAa;EACzB,SAAS,EAAQ;EACjB,KAAK;EACL,cAAc;EACd,MAAM,CAAC,GAAO,CAAQ;CACxB,CAAC;AACH"}

package/dist/gasless/get-gasless-wallet-creation-fee/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-wallet-creation-fee/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,SAAS,CAAC"}

package/dist/gasless/get-gasless-wallet-creation-fee/query.d.ts

@@ -0,0 +1,51 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter, ExactPartial } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetGaslessWalletCreationFeeParameters, GetGaslessWalletCreationFeeReturnType } from './get-gasless-wallet-creation-fee.js';
+/** Data resolved by the {@link getGaslessWalletCreationFeeQueryOptions} query. */
+export type GetGaslessWalletCreationFeeData = GetGaslessWalletCreationFeeReturnType;
+/**
+ * Build the TanStack Query key for {@link getGaslessWalletCreationFeeQueryOptions}.
+ *
+ * An omitted `walletId` keys as `0n`, so `{ owner }` and `{ owner, walletId: 0n }`
+ * share one cache entry — they quote the same wallet. `predicateMatch` compares
+ * only the fields its partial sets, so
+ * `predicateMatch(getGaslessWalletCreationFeeQueryKey, { owner })` still matches
+ * every wallet id of the owner.
+ *
+ * @param options - Partial query parameters.
+ * @returns A stable, hashable query key.
+ *
+ * @example
+ * ```ts
+ * getGaslessWalletCreationFeeQueryKey({ owner, walletId: 1n });
+ * // → ["getGaslessWalletCreationFee", { owner, walletId: "1" }]
+ * ```
+ */
+export declare function getGaslessWalletCreationFeeQueryKey(options?: Compute<ExactPartial<GetGaslessWalletCreationFeeParameters> & ConfigKeyParameter>): readonly ["getGaslessWalletCreationFee", Record<string, unknown>];
+/** Query-key type produced by {@link getGaslessWalletCreationFeeQueryKey}. */
+export type GetGaslessWalletCreationFeeQueryKey = ReturnType<typeof getGaslessWalletCreationFeeQueryKey>;
+/**
+ * Options accepted by {@link getGaslessWalletCreationFeeQueryOptions}.
+ */
+export type GetGaslessWalletCreationFeeOptions = Compute<GetGaslessWalletCreationFeeParameters & QueryParameter<GetGaslessWalletCreationFeeData, Error, GetGaslessWalletCreationFeeData, GetGaslessWalletCreationFeeQueryKey>>;
+/** TanStack Query options returned by {@link getGaslessWalletCreationFeeQueryOptions}. */
+export type GetGaslessWalletCreationFeeQueryOptions = SymmioQueryOptions<GetGaslessWalletCreationFeeData, Error, GetGaslessWalletCreationFeeData, GetGaslessWalletCreationFeeQueryKey>;
+/**
+ * Build TanStack Query options for {@link getGaslessWalletCreationFee}.
+ *
+ * The fee drops to `0n` once any action deploys the wallet, so invalidate this
+ * query after a settlement or wallet operation that may have deployed it — the
+ * React relay hooks do.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getGaslessWalletCreationFeeQueryOptions(config, { owner, walletId: 1n }));
+ * ```
+ */
+export declare function getGaslessWalletCreationFeeQueryOptions(config: Config, options: GetGaslessWalletCreationFeeOptions): GetGaslessWalletCreationFeeQueryOptions;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/gasless/get-gasless-wallet-creation-fee/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAEL,KAAK,qCAAqC,EAC1C,KAAK,qCAAqC,EAC3C,MAAM,mCAAmC,CAAC;AAE3C,kFAAkF;AAClF,MAAM,MAAM,+BAA+B,GAAG,qCAAqC,CAAC;AAEpF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,GAAE,OAAO,CAAC,YAAY,CAAC,qCAAqC,CAAC,GAAG,kBAAkB,CAAM,qEAGhG;AAED,8EAA8E;AAC9E,MAAM,MAAM,mCAAmC,GAAG,UAAU,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEzG;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG,OAAO,CACtD,qCAAqC,GACnC,cAAc,CACZ,+BAA+B,EAC/B,KAAK,EACL,+BAA+B,EAC/B,mCAAmC,CACpC,CACJ,CAAC;AAEF,0FAA0F;AAC1F,MAAM,MAAM,uCAAuC,GAAG,kBAAkB,CACtE,+BAA+B,EAC/B,KAAK,EACL,+BAA+B,EAC/B,mCAAmC,CACpC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kCAAkC,GAC1C,uCAAuC,CAYzC"}

package/dist/gasless/get-gasless-wallet-creation-fee/query.js

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

package/dist/gasless/get-gasless-wallet-creation-fee/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/gasless/get-gasless-wallet-creation-fee/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter, ExactPartial } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport {\n  getGaslessWalletCreationFee,\n  type GetGaslessWalletCreationFeeParameters,\n  type GetGaslessWalletCreationFeeReturnType,\n} from \"./get-gasless-wallet-creation-fee\";\n\n/** Data resolved by the {@link getGaslessWalletCreationFeeQueryOptions} query. */\nexport type GetGaslessWalletCreationFeeData = GetGaslessWalletCreationFeeReturnType;\n\n/**\n * Build the TanStack Query key for {@link getGaslessWalletCreationFeeQueryOptions}.\n *\n * An omitted `walletId` keys as `0n`, so `{ owner }` and `{ owner, walletId: 0n }`\n * share one cache entry — they quote the same wallet. `predicateMatch` compares\n * only the fields its partial sets, so\n * `predicateMatch(getGaslessWalletCreationFeeQueryKey, { owner })` still matches\n * every wallet id of the owner.\n *\n * @param options - Partial query parameters.\n * @returns A stable, hashable query key.\n *\n * @example\n * ```ts\n * getGaslessWalletCreationFeeQueryKey({ owner, walletId: 1n });\n * // → [\"getGaslessWalletCreationFee\", { owner, walletId: \"1\" }]\n * ```\n */\nexport function getGaslessWalletCreationFeeQueryKey(\n  options: Compute<ExactPartial<GetGaslessWalletCreationFeeParameters> & ConfigKeyParameter> = {},\n) {\n  return [\"getGaslessWalletCreationFee\", filterQueryOptions({ ...options, walletId: options.walletId ?? 0n })] as const;\n}\n\n/** Query-key type produced by {@link getGaslessWalletCreationFeeQueryKey}. */\nexport type GetGaslessWalletCreationFeeQueryKey = ReturnType<typeof getGaslessWalletCreationFeeQueryKey>;\n\n/**\n * Options accepted by {@link getGaslessWalletCreationFeeQueryOptions}.\n */\nexport type GetGaslessWalletCreationFeeOptions = Compute<\n  GetGaslessWalletCreationFeeParameters &\n    QueryParameter<\n      GetGaslessWalletCreationFeeData,\n      Error,\n      GetGaslessWalletCreationFeeData,\n      GetGaslessWalletCreationFeeQueryKey\n    >\n>;\n\n/** TanStack Query options returned by {@link getGaslessWalletCreationFeeQueryOptions}. */\nexport type GetGaslessWalletCreationFeeQueryOptions = SymmioQueryOptions<\n  GetGaslessWalletCreationFeeData,\n  Error,\n  GetGaslessWalletCreationFeeData,\n  GetGaslessWalletCreationFeeQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getGaslessWalletCreationFee}.\n *\n * The fee drops to `0n` once any action deploys the wallet, so invalidate this\n * query after a settlement or wallet operation that may have deployed it — the\n * React relay hooks do.\n *\n * @param config - The SDK config.\n * @param options - Query parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(getGaslessWalletCreationFeeQueryOptions(config, { owner, walletId: 1n }));\n * ```\n */\nexport function getGaslessWalletCreationFeeQueryOptions(\n  config: Config,\n  options: GetGaslessWalletCreationFeeOptions,\n): GetGaslessWalletCreationFeeQueryOptions {\n  /** Every parameter reaches the action: a hand-listed subset would silently drop a new one, such as `walletId`. */\n  const { query, ...parameters } = options;\n  return {\n    ...query,\n    queryKey: getGaslessWalletCreationFeeQueryKey({\n      ...parameters,\n      configKey: config.getChainConfigKey(parameters.chainId),\n    }),\n    enabled: query?.enabled ?? true,\n    queryFn: () => getGaslessWalletCreationFee(config, parameters),\n  };\n}\n"],"mappings":";;;AA+BA,SAAgB,EACd,IAA6F,CAAC,GAC9F;CACA,OAAO,CAAC,+BAA+B,EAAmB;EAAE,GAAG;EAAS,UAAU,EAAQ,YAAY;CAAG,CAAC,CAAC;AAC7G;AA0CA,SAAgB,EACd,GACA,GACyC;CAEzC,IAAM,EAAE,UAAO,GAAG,MAAe;CACjC,OAAO;EACL,GAAG;EACH,UAAU,EAAoC;GAC5C,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAW,OAAO;EACxD,CAAC;EACD,SAAS,GAAO,WAAW;EAC3B,eAAe,EAA4B,GAAQ,CAAU;CAC/D;AACF"}