@symmio/trading-core 3.0.0 → 3.1.0

package/dist/gasless/resubmit-gasless-request/resubmit-gasless-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resubmit-gasless-request.js","names":[],"sources":["../../../src/gasless/resubmit-gasless-request/resubmit-gasless-request.ts"],"sourcesContent":["import { isAddress, type Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport { getGaslessWalletAddress } from \"../get-gasless-wallet-address/get-gasless-wallet-address\";\nimport { postGaslessSubmit, resolveGaslessHttp } from \"../http\";\nimport { assertGaslessDepositWallet, toGaslessDepositReceipt } from \"../to-gasless-deposit-receipt\";\nimport { toGaslessSubmitReceipt } from \"../to-gasless-submit-receipt\";\nimport type { GaslessDepositSubmitReceipt, GaslessSubmitReceipt } from \"../types\";\nimport type { GaslessUnconfirmedSubmit } from \"../unconfirmed-submit\";\nimport { parseGaslessWalletId } from \"../wallet-id\";\nimport type { GaslessWireDepositAccepted, GaslessWireOperationAccepted } from \"../wire-types\";\n\n/** Parameters for {@link resubmitGaslessRequest}: the recorded submit, unchanged. */\nexport type ResubmitGaslessRequestParameters = GaslessUnconfirmedSubmit;\n\n/** Return type of {@link resubmitGaslessRequest}. */\nexport type ResubmitGaslessRequestReturnType = GaslessSubmitReceipt | GaslessDepositSubmitReceipt;\n\nfunction asRecord(value: unknown): Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new SymmError(\n      \"validation\",\n      \"GASLESS_RESUBMIT_BODY_INVALID\",\n      \"Gasless: the recorded submit has no JSON object body, so there is nothing to resend. Only a GaslessUnconfirmedSubmit taken from getGaslessUnconfirmedSubmit can be resubmitted.\",\n    );\n  }\n  return value as Record<string, unknown>;\n}\n\n/** Read an address the recorded body must carry, without rebuilding the body. */\nfunction requireAddress(body: Record<string, unknown>, field: string): Address {\n  const value = body[field];\n  if (typeof value !== \"string\" || !isAddress(value)) {\n    throw new SymmError(\n      \"validation\",\n      \"GASLESS_RESUBMIT_BODY_INVALID\",\n      `Gasless: the recorded submit body has no valid \"${field}\" address, so the acceptance could not be attributed to an owner. Resubmit only a GaslessUnconfirmedSubmit taken from getGaslessUnconfirmedSubmit.`,\n    );\n  }\n  return value;\n}\n\n/**\n * Resend an **unconfirmed** gasless submit, byte for byte, under its original\n * idempotency key.\n *\n * This is the vendor's prescribed recovery for a lost response: the same key\n * with the same payload either lands the request or returns the record the\n * service already created, so it can never execute the intent twice. It is the\n * *only* safe response to `GASLESS_SUBMIT_UNCONFIRMED` — re-running the intent\n * through the wallet would double-execute whatever the relayer accepted.\n *\n * The body is sent exactly as recorded, never rebuilt: the signatures inside it\n * cover specific nonces and deadlines, and a regenerated payload would be a\n * different request under a key the service has already bound.\n *\n * A deposit settlement is re-verified the same way the original submit was —\n * the wallet's deterministic address is read before the POST and checked\n * against the acceptance — so a replay can never sweep a wallet you did not\n * fund.\n *\n * @param config - The SDK config.\n * @param submit - The record from `getGaslessUnconfirmedSubmit(err)`, unmodified.\n * @returns The acceptance receipt: an operation receipt for `/gateway/relay-instant`,\n *   a deposit receipt for either settlement path.\n * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION` for the recorded chain.\n * @throws {SymmError} `GASLESS_RESUBMIT_BODY_INVALID` when the record is not a submit this SDK produced.\n * @throws {SymmApiError} `GASLESS_SUBMIT_UNCONFIRMED` again when the replay is itself\n *   inconclusive — keep the record and try again later.\n *\n * @example\n * ```ts\n * try {\n *   await relayInstantOperations(config, parameters);\n * } catch (err) {\n *   const pending = getGaslessUnconfirmedSubmit(err);\n *   if (!pending) throw err;\n *   await store.save(pending);\n *   const receipt = await resubmitGaslessRequest(config, pending);\n *   await store.clear(pending.idempotencyKey);\n * }\n * ```\n */\nexport async function resubmitGaslessRequest(\n  config: Config,\n  submit: ResubmitGaslessRequestParameters,\n): Promise<ResubmitGaslessRequestReturnType> {\n  const { chainId, path, body, idempotencyKey } = submit;\n  const context = resolveGaslessHttp(config, { chainId, service: submit.service });\n  const record = asRecord(body);\n\n  if (path === \"/gateway/relay-instant\") {\n    const owner = requireAddress(record, \"userAddress\");\n    const walletIds = Array.isArray(record.walletIds)\n      ? record.walletIds.map((walletId, index) => parseGaslessWalletId(walletId, `walletIds[${index}]`))\n      : [];\n    const raw = await postGaslessSubmit<GaslessWireOperationAccepted>(context, path, body, idempotencyKey);\n    return toGaslessSubmitReceipt(raw, {\n      owner,\n      walletIds,\n      idempotencyKey,\n      protocolInstance: context.protocolInstance,\n    });\n  }\n\n  const owner = requireAddress(record, \"owner\");\n  const walletId =\n    record.walletId === undefined || record.walletId === null ? 0n : parseGaslessWalletId(record.walletId);\n\n  /** Read before the POST, exactly as the original settlement did: a failed read must not follow a 202. */\n  const depositAddress = await getGaslessWalletAddress(config, { chainId, owner, walletId });\n\n  const raw = await postGaslessSubmit<GaslessWireDepositAccepted>(context, path, body, idempotencyKey);\n  const receipt = toGaslessDepositReceipt(raw, {\n    owner,\n    walletId,\n    idempotencyKey,\n    protocolInstance: context.protocolInstance,\n  });\n  assertGaslessDepositWallet(receipt, { walletId, depositAddress, url: context.baseURL, path });\n  return receipt;\n}\n"],"mappings":";;;;;;;;AAkBA,SAAS,EAAS,GAAyC;CACzD,IAAI,OAAO,KAAU,aAAY,KAAkB,MAAM,QAAQ,CAAK,GACpE,MAAM,IAAI,EACR,cACA,iCACA,iLACF;CAEF,OAAO;AACT;AAGA,SAAS,EAAe,GAA+B,GAAwB;CAC7E,IAAM,IAAQ,EAAK;CACnB,IAAI,OAAO,KAAU,YAAY,CAAC,EAAU,CAAK,GAC/C,MAAM,IAAI,EACR,cACA,iCACA,mDAAmD,EAAM,mJAC3D;CAEF,OAAO;AACT;AA2CA,eAAsB,EACpB,GACA,GAC2C;CAC3C,IAAM,EAAE,YAAS,SAAM,SAAM,sBAAmB,GAC1C,IAAU,EAAmB,GAAQ;EAAE;EAAS,SAAS,EAAO;CAAQ,CAAC,GACzE,IAAS,EAAS,CAAI;CAE5B,IAAI,MAAS,0BAA0B;EACrC,IAAM,IAAQ,EAAe,GAAQ,aAAa,GAC5C,IAAY,MAAM,QAAQ,EAAO,SAAS,IAC5C,EAAO,UAAU,KAAK,GAAU,MAAU,EAAqB,GAAU,aAAa,EAAM,EAAE,CAAC,IAC/F,CAAC;EAEL,OAAO,EAAuB,MADZ,EAAgD,GAAS,GAAM,GAAM,CAAc,GAClE;GACjC;GACA;GACA;GACA,kBAAkB,EAAQ;EAC5B,CAAC;CACH;CAEA,IAAM,IAAQ,EAAe,GAAQ,OAAO,GACtC,IACJ,EAAO,aAAa,KAAA,KAAa,EAAO,aAAa,OAAO,KAAK,EAAqB,EAAO,QAAQ,GAGjG,IAAiB,MAAM,EAAwB,GAAQ;EAAE;EAAS;EAAO;CAAS,CAAC,GAGnF,IAAU,EAAwB,MADtB,EAA8C,GAAS,GAAM,GAAM,CAAc,GACtD;EAC3C;EACA;EACA;EACA,kBAAkB,EAAQ;CAC5B,CAAC;CAED,OADA,EAA2B,GAAS;EAAE;EAAU;EAAgB,KAAK,EAAQ;EAAS;CAAK,CAAC,GACrF;AACT"}

package/dist/gasless/settle-gasless-deposit-existing-account/index.d.ts

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

package/dist/gasless/settle-gasless-deposit-existing-account/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gasless/settle-gasless-deposit-existing-account/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,2CAA2C,CAAC"}

package/dist/gasless/settle-gasless-deposit-existing-account/query.d.ts

@@ -0,0 +1,18 @@
+import { Config } from '../../core/config/index.js';
+import { SettleGaslessDepositExistingAccountParameters, SettleGaslessDepositExistingAccountReturnType } from './settle-gasless-deposit-existing-account.js';
+/**
+ * Build TanStack Mutation options for {@link settleGaslessDepositExistingAccount}.
+ *
+ * @param config - The SDK config.
+ * @returns Options to pass to `useMutation`.
+ *
+ * @example
+ * ```ts
+ * useMutation(settleGaslessDepositExistingAccountMutationOptions(config));
+ * ```
+ */
+export declare function settleGaslessDepositExistingAccountMutationOptions(config: Config): {
+    mutationKey: readonly ["settleGaslessDepositExistingAccount"];
+    mutationFn: (variables: SettleGaslessDepositExistingAccountParameters) => Promise<SettleGaslessDepositExistingAccountReturnType>;
+};
+//# sourceMappingURL=query.d.ts.map

package/dist/gasless/settle-gasless-deposit-existing-account/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/gasless/settle-gasless-deposit-existing-account/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAEL,KAAK,6CAA6C,EAClD,KAAK,6CAA6C,EACnD,MAAM,2CAA2C,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,wBAAgB,kDAAkD,CAAC,MAAM,EAAE,MAAM;;4BAIhE,6CAA6C,KACvD,OAAO,CAAC,6CAA6C,CAAC;EAE5D"}

package/dist/gasless/settle-gasless-deposit-existing-account/query.js

@@ -0,0 +1,12 @@
+import { settleGaslessDepositExistingAccount as e } from "./settle-gasless-deposit-existing-account.js";
+//#region src/gasless/settle-gasless-deposit-existing-account/query.ts
+function t(t) {
+	return {
+		mutationKey: ["settleGaslessDepositExistingAccount"],
+		mutationFn: (n) => e(t, n)
+	};
+}
+//#endregion
+export { t as settleGaslessDepositExistingAccountMutationOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/gasless/settle-gasless-deposit-existing-account/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/gasless/settle-gasless-deposit-existing-account/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport {\n  settleGaslessDepositExistingAccount,\n  type SettleGaslessDepositExistingAccountParameters,\n  type SettleGaslessDepositExistingAccountReturnType,\n} from \"./settle-gasless-deposit-existing-account\";\n\n/**\n * Build TanStack Mutation options for {@link settleGaslessDepositExistingAccount}.\n *\n * @param config - The SDK config.\n * @returns Options to pass to `useMutation`.\n *\n * @example\n * ```ts\n * useMutation(settleGaslessDepositExistingAccountMutationOptions(config));\n * ```\n */\nexport function settleGaslessDepositExistingAccountMutationOptions(config: Config) {\n  return {\n    mutationKey: [\"settleGaslessDepositExistingAccount\"] as const,\n    mutationFn: (\n      variables: SettleGaslessDepositExistingAccountParameters,\n    ): Promise<SettleGaslessDepositExistingAccountReturnType> => settleGaslessDepositExistingAccount(config, variables),\n  };\n}\n"],"mappings":";;AAkBA,SAAgB,EAAmD,GAAgB;CACjF,OAAO;EACL,aAAa,CAAC,qCAAqC;EACnD,aACE,MAC2D,EAAoC,GAAQ,CAAS;CACpH;AACF"}

package/dist/gasless/settle-gasless-deposit-existing-account/settle-gasless-deposit-existing-account.d.ts

@@ -0,0 +1,66 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+import { GaslessDepositSubmitReceipt } from '../types.js';
+/**
+ * Parameters for {@link settleGaslessDepositExistingAccount}.
+ */
+export type SettleGaslessDepositExistingAccountParameters = Compute<ChainIdParameter & {
+    /**
+     * Owner of the GaslessWallet whose deposit address is being settled — an
+     * owner address, never a GaslessWallet address.
+     */
+    owner: Address;
+    /**
+     * Which of the owner's GaslessWallets to sweep. Defaults to `0n`, the
+     * original wallet. Each id has its own deposit address and balance.
+     */
+    walletId?: bigint;
+    /** The existing wallet-owned sub-account to credit; the gateway verifies ownership. */
+    subAccount: Address;
+    /**
+     * Stable retry key; defaults to a random UUID.
+     *
+     * **One key per settlement attempt.** Reuse it only to replay a submit
+     * whose response was lost — the service then returns the existing record.
+     * A **completed** settlement's key must never be reused: mint a fresh one
+     * after any terminal status, and after any change to the wallet selection,
+     * or the service answers `409 IDEMPOTENCY_KEY_CONFLICT`
+     * (`isGaslessIdempotencyConflictError`).
+     */
+    idempotencyKey?: string;
+}>;
+/** Return type of {@link settleGaslessDepositExistingAccount}. */
+export type SettleGaslessDepositExistingAccountReturnType = GaslessDepositSubmitReceipt;
+/**
+ * Queue the sweep of an owner's deposit address into an **existing**
+ * wallet-owned sub-account (a gasless top-up).
+ *
+ * Same lifecycle as the new-account settlement: the entire observed balance of
+ * the selected wallet settles, the flat fee is deducted, and the worker's
+ * pre-broadcast re-check can still turn an accepted settlement `rejected`. Poll
+ * with `service: "deposits"`. The wallet's deterministic address is read before
+ * the submit and checked against the acceptance.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Owner, optional wallet id, target sub-account, retry key.
+ * @returns The acceptance receipt; persist `requestId`.
+ * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`.
+ * @throws {SymmError} `GASLESS_WALLET_ID_INVALID` for a wallet id outside the `uint256` range.
+ * @throws {SymmApiError} `GASLESS_SETTLEMENT_SUBMIT_FAILED` on HTTP failure.
+ * @throws {SymmApiError} `GASLESS_SUBMIT_UNCONFIRMED` when the outcome could not be
+ *   established; `responseData` is the replayable submit, for `resubmitGaslessRequest`.
+ * @throws {SymmApiError} `GASLESS_DEPOSIT_WALLET_MISMATCH` when the acceptance names
+ *   another wallet or deposit address, with the parsed receipt as `responseData`.
+ *
+ * @example
+ * ```ts
+ * const receipt = await settleGaslessDepositExistingAccount(config, {
+ *   owner,
+ *   walletId: 1n,
+ *   subAccount,
+ * });
+ * ```
+ */
+export declare function settleGaslessDepositExistingAccount(config: Config, parameters: SettleGaslessDepositExistingAccountParameters): Promise<SettleGaslessDepositExistingAccountReturnType>;
+//# sourceMappingURL=settle-gasless-deposit-existing-account.d.ts.map

package/dist/gasless/settle-gasless-deposit-existing-account/settle-gasless-deposit-existing-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle-gasless-deposit-existing-account.d.ts","sourceRoot":"","sources":["../../../src/gasless/settle-gasless-deposit-existing-account/settle-gasless-deposit-existing-account.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;AAI/E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAO5D;;GAEG;AACH,MAAM,MAAM,6CAA6C,GAAG,OAAO,CACjE,gBAAgB,GAAG;IACjB;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CACF,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,6CAA6C,GAAG,2BAA2B,CAAC;AAExF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,mCAAmC,CACvD,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,6CAA6C,GACxD,OAAO,CAAC,6CAA6C,CAAC,CAoCxD"}

package/dist/gasless/settle-gasless-deposit-existing-account/settle-gasless-deposit-existing-account.js

@@ -0,0 +1,36 @@
+import { generateGaslessIdempotencyKey as e, postGaslessSubmit as t, resolveGaslessHttp as n } from "../http.js";
+import { assertGaslessWalletId as r, toGaslessWalletIdWire as i } from "../wallet-id.js";
+import { getGaslessWalletAddress as a } from "../get-gasless-wallet-address/get-gasless-wallet-address.js";
+import { assertGaslessDepositWallet as o, toGaslessDepositReceipt as s } from "../to-gasless-deposit-receipt.js";
+//#region src/gasless/settle-gasless-deposit-existing-account/settle-gasless-deposit-existing-account.ts
+var c = "/deposit-settlements/existing-account";
+async function l(l, u) {
+	let { chainId: d, owner: f, subAccount: p } = u, m = r(u.walletId ?? 0n), h = n(l, {
+		chainId: d,
+		service: "deposits"
+	}), g = u.idempotencyKey ?? e(), _ = {
+		idempotencyKey: g,
+		owner: f,
+		walletId: i(m),
+		subAccount: p
+	}, v = await a(l, {
+		chainId: d,
+		owner: f,
+		walletId: m
+	}), y = s(await t(h, c, _, g), {
+		owner: f,
+		walletId: m,
+		idempotencyKey: g,
+		protocolInstance: h.protocolInstance
+	});
+	return o(y, {
+		walletId: m,
+		depositAddress: v,
+		url: h.baseURL,
+		path: c
+	}), y;
+}
+//#endregion
+export { l as settleGaslessDepositExistingAccount };
+
+//# sourceMappingURL=settle-gasless-deposit-existing-account.js.map

package/dist/gasless/settle-gasless-deposit-existing-account/settle-gasless-deposit-existing-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle-gasless-deposit-existing-account.js","names":[],"sources":["../../../src/gasless/settle-gasless-deposit-existing-account/settle-gasless-deposit-existing-account.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { getGaslessWalletAddress } from \"../get-gasless-wallet-address/get-gasless-wallet-address\";\nimport { generateGaslessIdempotencyKey, postGaslessSubmit, resolveGaslessHttp } from \"../http\";\nimport { assertGaslessDepositWallet, toGaslessDepositReceipt } from \"../to-gasless-deposit-receipt\";\nimport type { GaslessDepositSubmitReceipt } from \"../types\";\nimport { assertGaslessWalletId, toGaslessWalletIdWire } from \"../wallet-id\";\nimport type { GaslessWireDepositAccepted, GaslessWireExistingAccountSettlementRequest } from \"../wire-types\";\n\n/** Path the existing-account settlement submits to, under the deposits service base. */\nconst SETTLE_EXISTING_ACCOUNT_PATH = \"/deposit-settlements/existing-account\";\n\n/**\n * Parameters for {@link settleGaslessDepositExistingAccount}.\n */\nexport type SettleGaslessDepositExistingAccountParameters = Compute<\n  ChainIdParameter & {\n    /**\n     * Owner of the GaslessWallet whose deposit address is being settled — an\n     * owner address, never a GaslessWallet address.\n     */\n    owner: Address;\n    /**\n     * Which of the owner's GaslessWallets to sweep. Defaults to `0n`, the\n     * original wallet. Each id has its own deposit address and balance.\n     */\n    walletId?: bigint;\n    /** The existing wallet-owned sub-account to credit; the gateway verifies ownership. */\n    subAccount: Address;\n    /**\n     * Stable retry key; defaults to a random UUID.\n     *\n     * **One key per settlement attempt.** Reuse it only to replay a submit\n     * whose response was lost — the service then returns the existing record.\n     * A **completed** settlement's key must never be reused: mint a fresh one\n     * after any terminal status, and after any change to the wallet selection,\n     * or the service answers `409 IDEMPOTENCY_KEY_CONFLICT`\n     * (`isGaslessIdempotencyConflictError`).\n     */\n    idempotencyKey?: string;\n  }\n>;\n\n/** Return type of {@link settleGaslessDepositExistingAccount}. */\nexport type SettleGaslessDepositExistingAccountReturnType = GaslessDepositSubmitReceipt;\n\n/**\n * Queue the sweep of an owner's deposit address into an **existing**\n * wallet-owned sub-account (a gasless top-up).\n *\n * Same lifecycle as the new-account settlement: the entire observed balance of\n * the selected wallet settles, the flat fee is deducted, and the worker's\n * pre-broadcast re-check can still turn an accepted settlement `rejected`. Poll\n * with `service: \"deposits\"`. The wallet's deterministic address is read before\n * the submit and checked against the acceptance.\n *\n * @param config - The SDK config.\n * @param parameters - Owner, optional wallet id, target sub-account, retry key.\n * @returns The acceptance receipt; persist `requestId`.\n * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`.\n * @throws {SymmError} `GASLESS_WALLET_ID_INVALID` for a wallet id outside the `uint256` range.\n * @throws {SymmApiError} `GASLESS_SETTLEMENT_SUBMIT_FAILED` on HTTP failure.\n * @throws {SymmApiError} `GASLESS_SUBMIT_UNCONFIRMED` when the outcome could not be\n *   established; `responseData` is the replayable submit, for `resubmitGaslessRequest`.\n * @throws {SymmApiError} `GASLESS_DEPOSIT_WALLET_MISMATCH` when the acceptance names\n *   another wallet or deposit address, with the parsed receipt as `responseData`.\n *\n * @example\n * ```ts\n * const receipt = await settleGaslessDepositExistingAccount(config, {\n *   owner,\n *   walletId: 1n,\n *   subAccount,\n * });\n * ```\n */\nexport async function settleGaslessDepositExistingAccount(\n  config: Config,\n  parameters: SettleGaslessDepositExistingAccountParameters,\n): Promise<SettleGaslessDepositExistingAccountReturnType> {\n  const { chainId, owner, subAccount } = parameters;\n  const walletId = assertGaslessWalletId(parameters.walletId ?? 0n);\n  const context = resolveGaslessHttp(config, { chainId, service: \"deposits\" });\n  const idempotencyKey = parameters.idempotencyKey ?? generateGaslessIdempotencyKey();\n\n  const body: GaslessWireExistingAccountSettlementRequest = {\n    idempotencyKey,\n    owner,\n    walletId: toGaslessWalletIdWire(walletId),\n    subAccount,\n  };\n\n  /** Read before the submit: the acceptance is verified against it, and a failed read must not follow a 202. */\n  const depositAddress = await getGaslessWalletAddress(config, { chainId, owner, walletId });\n\n  const raw = await postGaslessSubmit<GaslessWireDepositAccepted>(\n    context,\n    SETTLE_EXISTING_ACCOUNT_PATH,\n    body,\n    idempotencyKey,\n  );\n\n  const receipt = toGaslessDepositReceipt(raw, {\n    owner,\n    walletId,\n    idempotencyKey,\n    protocolInstance: context.protocolInstance,\n  });\n  assertGaslessDepositWallet(receipt, {\n    walletId,\n    depositAddress,\n    url: context.baseURL,\n    path: SETTLE_EXISTING_ACCOUNT_PATH,\n  });\n  return receipt;\n}\n"],"mappings":";;;;;AAWA,IAAM,IAA+B;AAkErC,eAAsB,EACpB,GACA,GACwD;CACxD,IAAM,EAAE,YAAS,UAAO,kBAAe,GACjC,IAAW,EAAsB,EAAW,YAAY,EAAE,GAC1D,IAAU,EAAmB,GAAQ;EAAE;EAAS,SAAS;CAAW,CAAC,GACrE,IAAiB,EAAW,kBAAkB,EAA8B,GAE5E,IAAoD;EACxD;EACA;EACA,UAAU,EAAsB,CAAQ;EACxC;CACF,GAGM,IAAiB,MAAM,EAAwB,GAAQ;EAAE;EAAS;EAAO;CAAS,CAAC,GASnF,IAAU,EAAwB,MAPtB,EAChB,GACA,GACA,GACA,CACF,GAE6C;EAC3C;EACA;EACA;EACA,kBAAkB,EAAQ;CAC5B,CAAC;CAOD,OANA,EAA2B,GAAS;EAClC;EACA;EACA,KAAK,EAAQ;EACb,MAAM;CACR,CAAC,GACM;AACT"}

package/dist/gasless/settle-gasless-deposit-new-account/index.d.ts

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

package/dist/gasless/settle-gasless-deposit-new-account/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gasless/settle-gasless-deposit-new-account/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,sCAAsC,CAAC"}

package/dist/gasless/settle-gasless-deposit-new-account/query.d.ts

@@ -0,0 +1,18 @@
+import { Config } from '../../core/config/index.js';
+import { SettleGaslessDepositNewAccountParameters, SettleGaslessDepositNewAccountReturnType } from './settle-gasless-deposit-new-account.js';
+/**
+ * Build TanStack Mutation options for {@link settleGaslessDepositNewAccount}.
+ *
+ * @param config - The SDK config.
+ * @returns Options to pass to `useMutation`.
+ *
+ * @example
+ * ```ts
+ * useMutation(settleGaslessDepositNewAccountMutationOptions(config));
+ * ```
+ */
+export declare function settleGaslessDepositNewAccountMutationOptions(config: Config): {
+    mutationKey: readonly ["settleGaslessDepositNewAccount"];
+    mutationFn: (variables: SettleGaslessDepositNewAccountParameters) => Promise<SettleGaslessDepositNewAccountReturnType>;
+};
+//# sourceMappingURL=query.d.ts.map

package/dist/gasless/settle-gasless-deposit-new-account/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/gasless/settle-gasless-deposit-new-account/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAEL,KAAK,wCAAwC,EAC7C,KAAK,wCAAwC,EAC9C,MAAM,sCAAsC,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,wBAAgB,6CAA6C,CAAC,MAAM,EAAE,MAAM;;4BAI3D,wCAAwC,KAClD,OAAO,CAAC,wCAAwC,CAAC;EAEvD"}

package/dist/gasless/settle-gasless-deposit-new-account/query.js

@@ -0,0 +1,12 @@
+import { settleGaslessDepositNewAccount as e } from "./settle-gasless-deposit-new-account.js";
+//#region src/gasless/settle-gasless-deposit-new-account/query.ts
+function t(t) {
+	return {
+		mutationKey: ["settleGaslessDepositNewAccount"],
+		mutationFn: (n) => e(t, n)
+	};
+}
+//#endregion
+export { t as settleGaslessDepositNewAccountMutationOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/gasless/settle-gasless-deposit-new-account/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/gasless/settle-gasless-deposit-new-account/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport {\n  settleGaslessDepositNewAccount,\n  type SettleGaslessDepositNewAccountParameters,\n  type SettleGaslessDepositNewAccountReturnType,\n} from \"./settle-gasless-deposit-new-account\";\n\n/**\n * Build TanStack Mutation options for {@link settleGaslessDepositNewAccount}.\n *\n * @param config - The SDK config.\n * @returns Options to pass to `useMutation`.\n *\n * @example\n * ```ts\n * useMutation(settleGaslessDepositNewAccountMutationOptions(config));\n * ```\n */\nexport function settleGaslessDepositNewAccountMutationOptions(config: Config) {\n  return {\n    mutationKey: [\"settleGaslessDepositNewAccount\"] as const,\n    mutationFn: (\n      variables: SettleGaslessDepositNewAccountParameters,\n    ): Promise<SettleGaslessDepositNewAccountReturnType> => settleGaslessDepositNewAccount(config, variables),\n  };\n}\n"],"mappings":";;AAkBA,SAAgB,EAA8C,GAAgB;CAC5E,OAAO;EACL,aAAa,CAAC,gCAAgC;EAC9C,aACE,MACsD,EAA+B,GAAQ,CAAS;CAC1G;AACF"}

package/dist/gasless/settle-gasless-deposit-new-account/settle-gasless-deposit-new-account.d.ts

@@ -0,0 +1,106 @@
+import { Address, Hex } from 'viem';
+import { Config } from '../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+import { SubAccountIsolationType } from '../../symmio-contracts/account-layer/types.js';
+import { GaslessDepositSubmitReceipt } from '../types.js';
+/**
+ * Creation data for the sub-account a new-account settlement creates.
+ *
+ * `isolationType` and `singleVAMode` are deliberately **required**: they are
+ * product decisions (the lowcap flow uses `MARKET_DIRECTION` with
+ * `singleVAMode: true`; majors differ), and the service-side defaults would be
+ * silently wrong for either product. There is no `symmioCore` field — the
+ * gateway overwrites it with its configured core.
+ */
+export interface GaslessDepositAccountData {
+    /** Sub-account name, 1–64 characters. */
+    name: string;
+    /** Sub-account isolation strategy — a product decision, choose explicitly. */
+    isolationType: SubAccountIsolationType;
+    /** Whether the account runs in single-VA mode — a product decision, choose explicitly. */
+    singleVAMode: boolean;
+    /** Optional hex metadata (affiliate hooks may expect a specific encoding). Defaults to `0x`. */
+    metadata?: Hex;
+}
+/**
+ * Parameters for {@link settleGaslessDepositNewAccount}.
+ */
+export type SettleGaslessDepositNewAccountParameters = Compute<ChainIdParameter & {
+    /**
+     * Owner of the GaslessWallet whose deposit address is being settled — an
+     * owner address, never a GaslessWallet address. The new sub-account is
+     * created for this owner.
+     */
+    owner: Address;
+    /**
+     * Which of the owner's GaslessWallets to sweep. Defaults to `0n`, the
+     * original wallet. Each id has its own deposit address and its own balance:
+     * settle the id you funded, and read that id's address with
+     * `getGaslessWalletAddress` before sending anything to it.
+     */
+    walletId?: bigint;
+    /** Affiliate passed to `settleDepositToNewAccount`; the zero address disables attribution. */
+    affiliate: Address;
+    /** Creation data for the new wallet-owned sub-account. */
+    accountData: GaslessDepositAccountData;
+    /**
+     * Stable retry key; defaults to a random UUID.
+     *
+     * **One key per settlement attempt.** Reuse it only to replay a submit
+     * whose response was lost — the service then returns the existing record.
+     * A **completed** settlement's key must never be reused: mint a fresh one
+     * after any terminal status, and after any change to the wallet selection,
+     * or the service answers `409 IDEMPOTENCY_KEY_CONFLICT`
+     * (`isGaslessIdempotencyConflictError`).
+     */
+    idempotencyKey?: string;
+    /** Non-secret client correlation data stored with the request. */
+    metadata?: Record<string, unknown>;
+}>;
+/** Return type of {@link settleGaslessDepositNewAccount}. */
+export type SettleGaslessDepositNewAccountReturnType = GaslessDepositSubmitReceipt;
+/**
+ * Queue the sweep of an owner's deposit address into a **new** wallet-owned
+ * sub-account.
+ *
+ * The gateway settles the **entire observed collateral balance** at the
+ * selected wallet's deposit address, deducts the flat fee, creates the
+ * sub-account, and credits the net amount — paying all gas itself. The worker
+ * re-checks balance, fee, and minimum before broadcast, so an accepted
+ * settlement can still turn `rejected` (funds not yet visible, or moved). Poll
+ * with `service: "deposits"`. A `succeeded` settlement is not instantly
+ * readable — wait until the sub-account and its balance appear on-chain before
+ * flipping the UI.
+ *
+ * The wallet's deterministic address is read **before** the submit and checked
+ * against the acceptance, so a settlement that would sweep a different wallet
+ * than the one you funded surfaces as an error instead of moving funds
+ * silently. A sweep takes the whole balance of the selected id, so give a
+ * deposit flow its own id when it must not share a balance with another flow.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Owner, optional wallet id, affiliate, account creation data, retry key.
+ * @returns The acceptance receipt (with the observed/credited estimates); persist `requestId`.
+ * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`.
+ * @throws {SymmError} `GASLESS_WALLET_ID_INVALID` for a wallet id outside the `uint256` range.
+ * @throws {SymmApiError} `GASLESS_SETTLEMENT_SUBMIT_FAILED` on HTTP failure —
+ *   `DEPOSIT_BELOW_MINIMUM` in the vendor detail means the address is not
+ *   funded to the settlement minimum yet.
+ * @throws {SymmApiError} `GASLESS_SUBMIT_UNCONFIRMED` when the outcome could not be
+ *   established; `responseData` is the replayable submit, for `resubmitGaslessRequest`.
+ * @throws {SymmApiError} `GASLESS_DEPOSIT_WALLET_MISMATCH` when the acceptance names
+ *   another wallet or deposit address. The request is already accepted, so the
+ *   error carries the parsed receipt (with its `requestId`) as `responseData`.
+ *
+ * @example
+ * ```ts
+ * const receipt = await settleGaslessDepositNewAccount(config, {
+ *   owner,
+ *   walletId: 1n,
+ *   affiliate: zeroAddress,
+ *   accountData: { name: "Main", isolationType: SubAccountIsolationType.MARKET_DIRECTION, singleVAMode: true },
+ * });
+ * ```
+ */
+export declare function settleGaslessDepositNewAccount(config: Config, parameters: SettleGaslessDepositNewAccountParameters): Promise<SettleGaslessDepositNewAccountReturnType>;
+//# sourceMappingURL=settle-gasless-deposit-new-account.d.ts.map

package/dist/gasless/settle-gasless-deposit-new-account/settle-gasless-deposit-new-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle-gasless-deposit-new-account.d.ts","sourceRoot":"","sources":["../../../src/gasless/settle-gasless-deposit-new-account/settle-gasless-deposit-new-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAI1F,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAO5D;;;;;;;;GAQG;AACH,MAAM,WAAW,yBAAyB;IACxC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,aAAa,EAAE,uBAAuB,CAAC;IACvC,0FAA0F;IAC1F,YAAY,EAAE,OAAO,CAAC;IACtB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG,OAAO,CAC5D,gBAAgB,GAAG;IACjB;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,SAAS,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,WAAW,EAAE,yBAAyB,CAAC;IACvC;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CACF,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,wCAAwC,GAAG,2BAA2B,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,wCAAwC,GACnD,OAAO,CAAC,wCAAwC,CAAC,CA2CnD"}

package/dist/gasless/settle-gasless-deposit-new-account/settle-gasless-deposit-new-account.js

@@ -0,0 +1,43 @@
+import { generateGaslessIdempotencyKey as e, postGaslessSubmit as t, resolveGaslessHttp as n } from "../http.js";
+import { assertGaslessWalletId as r, toGaslessWalletIdWire as i } from "../wallet-id.js";
+import { getGaslessWalletAddress as a } from "../get-gasless-wallet-address/get-gasless-wallet-address.js";
+import { assertGaslessDepositWallet as o, toGaslessDepositReceipt as s } from "../to-gasless-deposit-receipt.js";
+//#region src/gasless/settle-gasless-deposit-new-account/settle-gasless-deposit-new-account.ts
+var c = "/deposit-settlements/new-account";
+async function l(l, u) {
+	let { chainId: d, owner: f, affiliate: p, accountData: m, metadata: h } = u, g = r(u.walletId ?? 0n), _ = n(l, {
+		chainId: d,
+		service: "deposits"
+	}), v = u.idempotencyKey ?? e(), y = {
+		idempotencyKey: v,
+		owner: f,
+		walletId: i(g),
+		affiliate: p,
+		accountData: {
+			name: m.name,
+			metadata: m.metadata ?? "0x",
+			isolationType: m.isolationType,
+			singleVAMode: m.singleVAMode
+		},
+		...h === void 0 ? {} : { metadata: h }
+	}, b = await a(l, {
+		chainId: d,
+		owner: f,
+		walletId: g
+	}), x = s(await t(_, c, y, v), {
+		owner: f,
+		walletId: g,
+		idempotencyKey: v,
+		protocolInstance: _.protocolInstance
+	});
+	return o(x, {
+		walletId: g,
+		depositAddress: b,
+		url: _.baseURL,
+		path: c
+	}), x;
+}
+//#endregion
+export { l as settleGaslessDepositNewAccount };
+
+//# sourceMappingURL=settle-gasless-deposit-new-account.js.map

package/dist/gasless/settle-gasless-deposit-new-account/settle-gasless-deposit-new-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle-gasless-deposit-new-account.js","names":[],"sources":["../../../src/gasless/settle-gasless-deposit-new-account/settle-gasless-deposit-new-account.ts"],"sourcesContent":["import type { Address, Hex } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport type { SubAccountIsolationType } from \"../../symmio-contracts/account-layer/types\";\nimport { getGaslessWalletAddress } from \"../get-gasless-wallet-address/get-gasless-wallet-address\";\nimport { generateGaslessIdempotencyKey, postGaslessSubmit, resolveGaslessHttp } from \"../http\";\nimport { assertGaslessDepositWallet, toGaslessDepositReceipt } from \"../to-gasless-deposit-receipt\";\nimport type { GaslessDepositSubmitReceipt } from \"../types\";\nimport { assertGaslessWalletId, toGaslessWalletIdWire } from \"../wallet-id\";\nimport type { GaslessWireDepositAccepted, GaslessWireNewAccountSettlementRequest } from \"../wire-types\";\n\n/** Path the new-account settlement submits to, under the deposits service base. */\nconst SETTLE_NEW_ACCOUNT_PATH = \"/deposit-settlements/new-account\";\n\n/**\n * Creation data for the sub-account a new-account settlement creates.\n *\n * `isolationType` and `singleVAMode` are deliberately **required**: they are\n * product decisions (the lowcap flow uses `MARKET_DIRECTION` with\n * `singleVAMode: true`; majors differ), and the service-side defaults would be\n * silently wrong for either product. There is no `symmioCore` field — the\n * gateway overwrites it with its configured core.\n */\nexport interface GaslessDepositAccountData {\n  /** Sub-account name, 1–64 characters. */\n  name: string;\n  /** Sub-account isolation strategy — a product decision, choose explicitly. */\n  isolationType: SubAccountIsolationType;\n  /** Whether the account runs in single-VA mode — a product decision, choose explicitly. */\n  singleVAMode: boolean;\n  /** Optional hex metadata (affiliate hooks may expect a specific encoding). Defaults to `0x`. */\n  metadata?: Hex;\n}\n\n/**\n * Parameters for {@link settleGaslessDepositNewAccount}.\n */\nexport type SettleGaslessDepositNewAccountParameters = Compute<\n  ChainIdParameter & {\n    /**\n     * Owner of the GaslessWallet whose deposit address is being settled — an\n     * owner address, never a GaslessWallet address. The new sub-account is\n     * created for this owner.\n     */\n    owner: Address;\n    /**\n     * Which of the owner's GaslessWallets to sweep. Defaults to `0n`, the\n     * original wallet. Each id has its own deposit address and its own balance:\n     * settle the id you funded, and read that id's address with\n     * `getGaslessWalletAddress` before sending anything to it.\n     */\n    walletId?: bigint;\n    /** Affiliate passed to `settleDepositToNewAccount`; the zero address disables attribution. */\n    affiliate: Address;\n    /** Creation data for the new wallet-owned sub-account. */\n    accountData: GaslessDepositAccountData;\n    /**\n     * Stable retry key; defaults to a random UUID.\n     *\n     * **One key per settlement attempt.** Reuse it only to replay a submit\n     * whose response was lost — the service then returns the existing record.\n     * A **completed** settlement's key must never be reused: mint a fresh one\n     * after any terminal status, and after any change to the wallet selection,\n     * or the service answers `409 IDEMPOTENCY_KEY_CONFLICT`\n     * (`isGaslessIdempotencyConflictError`).\n     */\n    idempotencyKey?: string;\n    /** Non-secret client correlation data stored with the request. */\n    metadata?: Record<string, unknown>;\n  }\n>;\n\n/** Return type of {@link settleGaslessDepositNewAccount}. */\nexport type SettleGaslessDepositNewAccountReturnType = GaslessDepositSubmitReceipt;\n\n/**\n * Queue the sweep of an owner's deposit address into a **new** wallet-owned\n * sub-account.\n *\n * The gateway settles the **entire observed collateral balance** at the\n * selected wallet's deposit address, deducts the flat fee, creates the\n * sub-account, and credits the net amount — paying all gas itself. The worker\n * re-checks balance, fee, and minimum before broadcast, so an accepted\n * settlement can still turn `rejected` (funds not yet visible, or moved). Poll\n * with `service: \"deposits\"`. A `succeeded` settlement is not instantly\n * readable — wait until the sub-account and its balance appear on-chain before\n * flipping the UI.\n *\n * The wallet's deterministic address is read **before** the submit and checked\n * against the acceptance, so a settlement that would sweep a different wallet\n * than the one you funded surfaces as an error instead of moving funds\n * silently. A sweep takes the whole balance of the selected id, so give a\n * deposit flow its own id when it must not share a balance with another flow.\n *\n * @param config - The SDK config.\n * @param parameters - Owner, optional wallet id, affiliate, account creation data, retry key.\n * @returns The acceptance receipt (with the observed/credited estimates); persist `requestId`.\n * @throws {SymmError} `GASLESS_NOT_CONFIGURED` / `GASLESS_UNSUPPORTED_CONTRACTS_VERSION`.\n * @throws {SymmError} `GASLESS_WALLET_ID_INVALID` for a wallet id outside the `uint256` range.\n * @throws {SymmApiError} `GASLESS_SETTLEMENT_SUBMIT_FAILED` on HTTP failure —\n *   `DEPOSIT_BELOW_MINIMUM` in the vendor detail means the address is not\n *   funded to the settlement minimum yet.\n * @throws {SymmApiError} `GASLESS_SUBMIT_UNCONFIRMED` when the outcome could not be\n *   established; `responseData` is the replayable submit, for `resubmitGaslessRequest`.\n * @throws {SymmApiError} `GASLESS_DEPOSIT_WALLET_MISMATCH` when the acceptance names\n *   another wallet or deposit address. The request is already accepted, so the\n *   error carries the parsed receipt (with its `requestId`) as `responseData`.\n *\n * @example\n * ```ts\n * const receipt = await settleGaslessDepositNewAccount(config, {\n *   owner,\n *   walletId: 1n,\n *   affiliate: zeroAddress,\n *   accountData: { name: \"Main\", isolationType: SubAccountIsolationType.MARKET_DIRECTION, singleVAMode: true },\n * });\n * ```\n */\nexport async function settleGaslessDepositNewAccount(\n  config: Config,\n  parameters: SettleGaslessDepositNewAccountParameters,\n): Promise<SettleGaslessDepositNewAccountReturnType> {\n  const { chainId, owner, affiliate, accountData, metadata } = parameters;\n  const walletId = assertGaslessWalletId(parameters.walletId ?? 0n);\n  const context = resolveGaslessHttp(config, { chainId, service: \"deposits\" });\n  const idempotencyKey = parameters.idempotencyKey ?? generateGaslessIdempotencyKey();\n\n  const body: GaslessWireNewAccountSettlementRequest = {\n    idempotencyKey,\n    owner,\n    walletId: toGaslessWalletIdWire(walletId),\n    affiliate,\n    accountData: {\n      name: accountData.name,\n      metadata: accountData.metadata ?? \"0x\",\n      isolationType: accountData.isolationType,\n      singleVAMode: accountData.singleVAMode,\n    },\n    ...(metadata !== undefined ? { metadata } : {}),\n  };\n\n  /** Read before the submit: the acceptance is verified against it, and a failed read must not follow a 202. */\n  const depositAddress = await getGaslessWalletAddress(config, { chainId, owner, walletId });\n\n  const raw = await postGaslessSubmit<GaslessWireDepositAccepted>(\n    context,\n    SETTLE_NEW_ACCOUNT_PATH,\n    body,\n    idempotencyKey,\n  );\n\n  const receipt = toGaslessDepositReceipt(raw, {\n    owner,\n    walletId,\n    idempotencyKey,\n    protocolInstance: context.protocolInstance,\n  });\n  assertGaslessDepositWallet(receipt, {\n    walletId,\n    depositAddress,\n    url: context.baseURL,\n    path: SETTLE_NEW_ACCOUNT_PATH,\n  });\n  return receipt;\n}\n"],"mappings":";;;;;AAYA,IAAM,IAA0B;AA0GhC,eAAsB,EACpB,GACA,GACmD;CACnD,IAAM,EAAE,YAAS,UAAO,cAAW,gBAAa,gBAAa,GACvD,IAAW,EAAsB,EAAW,YAAY,EAAE,GAC1D,IAAU,EAAmB,GAAQ;EAAE;EAAS,SAAS;CAAW,CAAC,GACrE,IAAiB,EAAW,kBAAkB,EAA8B,GAE5E,IAA+C;EACnD;EACA;EACA,UAAU,EAAsB,CAAQ;EACxC;EACA,aAAa;GACX,MAAM,EAAY;GAClB,UAAU,EAAY,YAAY;GAClC,eAAe,EAAY;GAC3B,cAAc,EAAY;EAC5B;EACA,GAAI,MAAa,KAAA,IAA2B,CAAC,IAAhB,EAAE,YAAS;CAC1C,GAGM,IAAiB,MAAM,EAAwB,GAAQ;EAAE;EAAS;EAAO;CAAS,CAAC,GASnF,IAAU,EAAwB,MAPtB,EAChB,GACA,GACA,GACA,CACF,GAE6C;EAC3C;EACA;EACA;EACA,kBAAkB,EAAQ;CAC5B,CAAC;CAOD,OANA,EAA2B,GAAS;EAClC;EACA;EACA,KAAK,EAAQ;EACb,MAAM;CACR,CAAC,GACM;AACT"}

package/dist/gasless/status-read-limiter.d.ts

@@ -0,0 +1,44 @@
+import { Config } from '../core/config/index.js';
+import { GaslessHttpContext } from './http.js';
+/**
+ * Sustained status GETs per second, per deployment.
+ *
+ * The anonymous gateway allows 10 requests/s per IP and protocol instance, and
+ * status polling is the one gasless call that runs unattended and in parallel —
+ * one loop per in-flight workflow, plus every mounted `useGaslessRequest`. This
+ * keeps the whole page's polling inside a predictable share of that budget so a
+ * submit, a fee quote or a deposit-policy read is never the call that earns the
+ * `429`.
+ *
+ * @internal
+ */
+export declare const GASLESS_STATUS_READ_RATE_PER_SECOND = 4;
+/**
+ * How many status reads may start back-to-back after an idle period. Matching
+ * the rate keeps a freshly opened page responsive — four workflows resolve
+ * their first poll immediately — without letting a burst outrun the sustained
+ * rate afterwards.
+ *
+ * @internal
+ */
+export declare const GASLESS_STATUS_READ_BURST = 4;
+/**
+ * Wait for this deployment's next status-read slot.
+ *
+ * Paces status GETs at {@link GASLESS_STATUS_READ_RATE_PER_SECOND} per second
+ * with a {@link GASLESS_STATUS_READ_BURST} burst, per `(config, origin +
+ * protocol instance)`. It only ever delays a read — it never drops one, and a
+ * caller that aborts releases nothing, because a slot that was never used stays
+ * in the past and is handed to the next caller immediately.
+ *
+ * @param config - The SDK config the read runs under.
+ * @param context - The resolved HTTP context (its origin and instance pick the bucket).
+ * @param options - Abort signal for the wait.
+ * @throws {SymmError} `GASLESS_WAIT_ABORTED` when `options.signal` aborts while queued.
+ *
+ * @internal
+ */
+export declare function acquireGaslessStatusRead(config: Config, context: GaslessHttpContext, options?: {
+    signal?: AbortSignal;
+}): Promise<void>;
+//# sourceMappingURL=status-read-limiter.d.ts.map

package/dist/gasless/status-read-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-read-limiter.d.ts","sourceRoot":"","sources":["../../src/gasless/status-read-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AA6C3C;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACrC,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/gasless/status-read-limiter.js

@@ -0,0 +1,28 @@
+import { gaslessAbortedError as e, gaslessSleep as t } from "./abortable-sleep.js";
+var n = 1e3 / 4, r = /* @__PURE__ */ new WeakMap();
+function i(e) {
+	let t;
+	try {
+		t = new URL(e.baseURL).origin;
+	} catch {
+		t = e.baseURL;
+	}
+	return `${t}|${e.protocolInstance ?? ""}`;
+}
+function a(e, t) {
+	let n = r.get(e);
+	n || (n = /* @__PURE__ */ new Map(), r.set(e, n));
+	let i = n.get(t);
+	return i || (i = { nextStartAt: 0 }, n.set(t, i)), i;
+}
+async function o(r, o, s = {}) {
+	if (s.signal?.aborted) throw e("the status read");
+	let c = a(r, i(o)), l = Date.now(), u = l - 3 * n, d = Math.max(c.nextStartAt, u);
+	c.nextStartAt = d + n;
+	let f = d - l;
+	f <= 0 || await t(f, s.signal, "the status read");
+}
+//#endregion
+export { o as acquireGaslessStatusRead };
+
+//# sourceMappingURL=status-read-limiter.js.map

package/dist/gasless/status-read-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-read-limiter.js","names":[],"sources":["../../src/gasless/status-read-limiter.ts"],"sourcesContent":["import type { Config } from \"../core/config\";\nimport { gaslessAbortedError, gaslessSleep } from \"./abortable-sleep\";\nimport type { GaslessHttpContext } from \"./http\";\n\n/**\n * Sustained status GETs per second, per deployment.\n *\n * The anonymous gateway allows 10 requests/s per IP and protocol instance, and\n * status polling is the one gasless call that runs unattended and in parallel —\n * one loop per in-flight workflow, plus every mounted `useGaslessRequest`. This\n * keeps the whole page's polling inside a predictable share of that budget so a\n * submit, a fee quote or a deposit-policy read is never the call that earns the\n * `429`.\n *\n * @internal\n */\nexport const GASLESS_STATUS_READ_RATE_PER_SECOND = 4;\n\n/**\n * How many status reads may start back-to-back after an idle period. Matching\n * the rate keeps a freshly opened page responsive — four workflows resolve\n * their first poll immediately — without letting a burst outrun the sustained\n * rate afterwards.\n *\n * @internal\n */\nexport const GASLESS_STATUS_READ_BURST = 4;\n\n/** Minimum spacing between two sustained reads, in ms. */\nconst MIN_SPACING_MS = 1_000 / GASLESS_STATUS_READ_RATE_PER_SECOND;\n\n/**\n * One deployment's schedule: the earliest time the next read may start. A read\n * reserves its slot by moving the mark forward, so concurrent callers queue in\n * arrival order instead of racing for the same instant.\n */\ninterface ReadSchedule {\n  nextStartAt: number;\n}\n\nconst schedules = new WeakMap<Config, Map<string, ReadSchedule>>();\n\n/**\n * The bucket a context shares its budget with: the gateway limits per IP and\n * protocol instance, so both services of one deployment draw from one bucket\n * while a second deployment (a different origin or instance) gets its own.\n */\nfunction scheduleKey(context: GaslessHttpContext): string {\n  let origin: string;\n  try {\n    origin = new URL(context.baseURL).origin;\n  } catch {\n    origin = context.baseURL;\n  }\n  return `${origin}|${context.protocolInstance ?? \"\"}`;\n}\n\nfunction getSchedule(config: Config, key: string): ReadSchedule {\n  let byDeployment = schedules.get(config);\n  if (!byDeployment) {\n    byDeployment = new Map();\n    schedules.set(config, byDeployment);\n  }\n  let schedule = byDeployment.get(key);\n  if (!schedule) {\n    schedule = { nextStartAt: 0 };\n    byDeployment.set(key, schedule);\n  }\n  return schedule;\n}\n\n/**\n * Wait for this deployment's next status-read slot.\n *\n * Paces status GETs at {@link GASLESS_STATUS_READ_RATE_PER_SECOND} per second\n * with a {@link GASLESS_STATUS_READ_BURST} burst, per `(config, origin +\n * protocol instance)`. It only ever delays a read — it never drops one, and a\n * caller that aborts releases nothing, because a slot that was never used stays\n * in the past and is handed to the next caller immediately.\n *\n * @param config - The SDK config the read runs under.\n * @param context - The resolved HTTP context (its origin and instance pick the bucket).\n * @param options - Abort signal for the wait.\n * @throws {SymmError} `GASLESS_WAIT_ABORTED` when `options.signal` aborts while queued.\n *\n * @internal\n */\nexport async function acquireGaslessStatusRead(\n  config: Config,\n  context: GaslessHttpContext,\n  options: { signal?: AbortSignal } = {},\n): Promise<void> {\n  if (options.signal?.aborted) throw gaslessAbortedError(\"the status read\");\n\n  const schedule = getSchedule(config, scheduleKey(context));\n  const now = Date.now();\n  /** An idle bucket refills up to the burst, so the mark never rewinds further than that. */\n  const earliest = now - (GASLESS_STATUS_READ_BURST - 1) * MIN_SPACING_MS;\n  const startAt = Math.max(schedule.nextStartAt, earliest);\n  schedule.nextStartAt = startAt + MIN_SPACING_MS;\n\n  const delay = startAt - now;\n  if (delay <= 0) return;\n  await gaslessSleep(delay, options.signal, \"the status read\");\n}\n"],"mappings":";AA6BA,IAAM,IAAiB,MAAA,GAWjB,oBAAY,IAAI,QAA2C;AAOjE,SAAS,EAAY,GAAqC;CACxD,IAAI;CACJ,IAAI;EACF,IAAS,IAAI,IAAI,EAAQ,OAAO,EAAE;CACpC,QAAQ;EACN,IAAS,EAAQ;CACnB;CACA,OAAO,GAAG,EAAO,GAAG,EAAQ,oBAAoB;AAClD;AAEA,SAAS,EAAY,GAAgB,GAA2B;CAC9D,IAAI,IAAe,EAAU,IAAI,CAAM;CACvC,AAAK,MACH,oBAAe,IAAI,IAAI,GACvB,EAAU,IAAI,GAAQ,CAAY;CAEpC,IAAI,IAAW,EAAa,IAAI,CAAG;CAKnC,OAJK,MACH,IAAW,EAAE,aAAa,EAAE,GAC5B,EAAa,IAAI,GAAK,CAAQ,IAEzB;AACT;AAkBA,eAAsB,EACpB,GACA,GACA,IAAoC,CAAC,GACtB;CACf,IAAI,EAAQ,QAAQ,SAAS,MAAM,EAAoB,iBAAiB;CAExE,IAAM,IAAW,EAAY,GAAQ,EAAY,CAAO,CAAC,GACnD,IAAM,KAAK,IAAI,GAEf,IAAW,IAAA,IAAwC,GACnD,IAAU,KAAK,IAAI,EAAS,aAAa,CAAQ;CACvD,EAAS,cAAc,IAAU;CAEjC,IAAM,IAAQ,IAAU;CACpB,KAAS,KACb,MAAM,EAAa,GAAO,EAAQ,QAAQ,iBAAiB;AAC7D"}

package/dist/gasless/to-gasless-deposit-receipt.d.ts

@@ -0,0 +1,61 @@
+import { Address } from 'viem';
+import { GaslessDepositSubmitReceipt } from './types.js';
+import { GaslessWireDepositAccepted } from './wire-types.js';
+/**
+ * What the submitter knows about a settlement the acceptance body does not
+ * echo, plus the wallet it must have settled.
+ *
+ * @internal
+ */
+export interface GaslessDepositSubmitContext {
+    /** The `owner` the settlement was submitted for. */
+    owner: Address;
+    /** The wallet id the settlement was submitted for. */
+    walletId: bigint;
+    /** The idempotency key the settlement was submitted with. */
+    idempotencyKey: string;
+    /** The protocol instance the submit was routed to, or `null` for a proxy base that names none. */
+    protocolInstance: string | null;
+}
+/**
+ * Parse a deposit settlement's `202` acceptance into
+ * {@link GaslessDepositSubmitReceipt}. Shared by the new-account and
+ * existing-account settlement actions.
+ *
+ * Tolerant in the same way as the operations receipt: only `request_id` is
+ * required, an unknown status reads as `queued`, unreported amounts read as
+ * `null`, and an omitted `wallet_id` means wallet `0` — the service's own
+ * default for a request that names none.
+ *
+ * @param raw - The acceptance body.
+ * @param context - What the submitter knows that the body does not echo.
+ * @returns The normalized receipt.
+ * @throws {SymmError} `GASLESS_ACCEPTANCE_INVALID` when the body carries no `request_id`.
+ * @throws {SymmError} `GASLESS_WALLET_ID_INVALID` when `wallet_id` is present but not a `uint256` decimal.
+ *
+ * @internal
+ */
+export declare function toGaslessDepositReceipt(raw: GaslessWireDepositAccepted, context: GaslessDepositSubmitContext): GaslessDepositSubmitReceipt;
+/**
+ * Assert that the accepted settlement is the one that was asked for: the same
+ * wallet id, sweeping the same deposit address.
+ *
+ * The vendor requires this check (doc: "verify the returned ID and address
+ * match the wallet funded for this workflow"), because a wrong wallet sweeps a
+ * balance the user never meant to move. The request is already accepted when
+ * this runs, so the error carries the parsed receipt — the `requestId` must
+ * survive the mismatch or the workflow becomes untrackable.
+ *
+ * @param receipt - The parsed acceptance.
+ * @param expected - The wallet the settlement was submitted for, with its derived deposit address.
+ * @throws {SymmApiError} `GASLESS_DEPOSIT_WALLET_MISMATCH`, with the receipt as `responseData`.
+ *
+ * @internal
+ */
+export declare function assertGaslessDepositWallet(receipt: GaslessDepositSubmitReceipt, expected: {
+    walletId: bigint;
+    depositAddress: Address;
+    url: string;
+    path: string;
+}): void;
+//# sourceMappingURL=to-gasless-deposit-receipt.d.ts.map

package/dist/gasless/to-gasless-deposit-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-gasless-deposit-receipt.d.ts","sourceRoot":"","sources":["../../src/gasless/to-gasless-deposit-receipt.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAG3D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB,kGAAkG;IAClG,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,0BAA0B,EAC/B,OAAO,EAAE,2BAA2B,GACnC,2BAA2B,CAa7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,EACpC,QAAQ,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjF,IAAI,CAeN"}

package/dist/gasless/to-gasless-deposit-receipt.js

@@ -0,0 +1,36 @@
+import { SymmApiError as e } from "../shared/errors/symm-error.js";
+import { parseGaslessWalletId as t } from "./wallet-id.js";
+import { toGaslessAcceptanceStatus as n, toGaslessOptionalAmount as r } from "./wire-parse.js";
+import { requireGaslessRequestId as i } from "./to-gasless-submit-receipt.js";
+import { isAddress as a, isAddressEqual as o } from "viem";
+//#region src/gasless/to-gasless-deposit-receipt.ts
+function s(e, a) {
+	return {
+		requestId: i(e?.request_id),
+		status: n(e.status),
+		depositAddress: e.deposit_address,
+		walletId: e.wallet_id === void 0 || e.wallet_id === null ? 0n : t(e.wallet_id),
+		owner: a.owner,
+		observedAmount: r(e.observed_amount),
+		paidFee: r(e.paid_fee),
+		creditedAmount: r(e.credited_amount),
+		idempotencyKey: a.idempotencyKey,
+		protocolInstance: a.protocolInstance
+	};
+}
+function c(t, n) {
+	let r = t.walletId === n.walletId, i = a(t.depositAddress) && o(t.depositAddress, n.depositAddress);
+	if (!(r && i)) throw new e({
+		code: "GASLESS_DEPOSIT_WALLET_MISMATCH",
+		message: `Gasless: settlement ${t.requestId} was accepted for wallet ${t.walletId} at ${t.depositAddress}, but it was submitted for wallet ${n.walletId} at ${n.depositAddress}. The request is already accepted — reconcile it by its request id before funding or settling anything else.`,
+		status: 202,
+		statusText: "Accepted",
+		responseData: t,
+		url: `${n.url}${n.path}`,
+		method: "POST"
+	});
+}
+//#endregion
+export { c as assertGaslessDepositWallet, s as toGaslessDepositReceipt };
+
+//# sourceMappingURL=to-gasless-deposit-receipt.js.map