@nktkas/hyperliquid 0.25.5 → 0.25.7

package/src/src/api/exchange/_base/_nonce.ts

@@ -0,0 +1,18 @@
+/**
+ * Nonce manager for generating unique nonces for signing transactions.
+ * Uses the current timestamp, and increments if the timestamp is not greater than the last nonce.
+ */
+class NonceManager {
+  private lastNonce = 0;
+  getNonce(): number {
+    let nonce = Date.now();
+    if (nonce <= this.lastNonce) {
+      nonce = ++this.lastNonce;
+    } else {
+      this.lastNonce = nonce;
+    }
+    return nonce;
+  }
+}
+
+export const globalNonceManager = /* @__PURE__ */ new NonceManager();

package/src/src/api/exchange/_base/_schemas.ts

@@ -0,0 +1,73 @@
+import * as v from "valibot";
+import { Hex } from "../../_base.js";
+
+/** ECDSA signature components for Ethereum typed data. */
+export const Signature = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.object({
+      /** First 32-byte component of ECDSA signature. */
+      r: v.pipe(
+        v.pipe(Hex, v.length(66)),
+        v.description("First 32-byte component of ECDSA signature."),
+      ),
+      /** Second 32-byte component of ECDSA signature. */
+      s: v.pipe(
+        v.pipe(Hex, v.length(66)),
+        v.description("Second 32-byte component of ECDSA signature."),
+      ),
+      /** Recovery identifier. */
+      v: v.pipe(
+        v.union([v.literal(27), v.literal(28)]),
+        v.description("Recovery identifier."),
+      ),
+    }),
+    v.description("ECDSA signature components for Ethereum typed data."),
+  );
+})();
+export type Signature = v.InferOutput<typeof Signature>;
+
+/** Error response for failed operations. */
+export const ErrorResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.object({
+      /** Error status. */
+      status: v.pipe(
+        v.literal("err"),
+        v.description("Error status."),
+      ),
+      /** Error message. */
+      response: v.pipe(
+        v.string(),
+        v.description("Error message."),
+      ),
+    }),
+    v.description("Error response for failed operations."),
+  );
+})();
+export type ErrorResponse = v.InferOutput<typeof ErrorResponse>;
+
+/** Successful response without specific data. */
+export const SuccessResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.object({
+      /** Successful status. */
+      status: v.pipe(
+        v.literal("ok"),
+        v.description("Successful status."),
+      ),
+      /** Response details. */
+      response: v.pipe(
+        v.object({
+          /** Type of response. */
+          type: v.pipe(
+            v.literal("default"),
+            v.description("Type of response."),
+          ),
+        }),
+        v.description("Response details."),
+      ),
+    }),
+    v.description("Successful response without specific data."),
+  );
+})();
+export type SuccessResponse = v.InferOutput<typeof SuccessResponse>;

package/src/src/api/exchange/_base/_sequential.ts

@@ -0,0 +1,82 @@
+/**
+ * Sequential request execution to prevent nonce race conditions.
+ *
+ * Problem: When multiple requests are sent rapidly, they may execute in different order
+ * on the transport layer, causing nonce errors (e.g., server receives nonce 101 before 100).
+ *
+ * Solution: Queue ensures requests execute sequentially in order.
+ */
+
+import type { ExchangeRequestConfig, MultiSignRequestConfig } from "./_types.js";
+import { getWalletAddress } from "../../../signing/mod.js";
+
+/**
+ * Request queue for sequential execution of requests.
+ * Ensures that requests are executed in order, preventing them from arriving at the server out of sequence.
+ */
+class RequestQueue {
+  private queue: Promise<unknown> = Promise.resolve();
+
+  /**
+   * Enqueue a request to be executed sequentially.
+   * @param fn - The function to execute.
+   * @returns A promise that resolves with the result of the function.
+   */
+  enqueue<T>(fn: () => Promise<T>): Promise<T> {
+    const current = this.queue.then(() => fn());
+    this.queue = current.catch(() => {}); // Prevent unhandled rejection
+    return current;
+  }
+}
+
+/**
+ * Map of wallet addresses to weak references of request queues.
+ * Uses WeakRef to allow garbage collection of unused queues:
+ * - When a queue is no longer referenced (all requests completed), GC can remove it
+ * - FinalizationRegistry automatically cleans up the Map entry when queue is GC'd
+ * - This prevents memory leaks in long-running applications without manual cleanup
+ */
+const requestQueueMap = /* @__PURE__ */ new Map<string, WeakRef<RequestQueue>>();
+
+/**
+ * Registry to clean up Map entries when queues are garbage collected.
+ * When a RequestQueue is GC'd, this callback removes the corresponding Map entry.
+ */
+const requestQueueRegistry = /* @__PURE__ */ new FinalizationRegistry<string>((address) => {
+  requestQueueMap.delete(address);
+});
+
+/**
+ * Get or create a request queue for the given config.
+ * Uses a global Map keyed by wallet address to ensure the same wallet uses the same queue
+ * regardless of whether called via client or direct function.
+ */
+export async function getRequestQueue(
+  config: ExchangeRequestConfig | MultiSignRequestConfig,
+): Promise<RequestQueue | undefined> {
+  const sequentialRequests = config.sequentialRequests ?? true; // default to true
+  if (!sequentialRequests) {
+    return undefined;
+  }
+
+  // Get wallet address to use as key
+  const walletAddress = "signers" in config
+    ? await getWalletAddress(config.signers[0])
+    : await getWalletAddress(config.wallet);
+
+  const address = walletAddress.toLowerCase();
+
+  // Try to get existing queue from weak reference
+  const queueRef = requestQueueMap.get(address);
+  let queue = queueRef?.deref();
+
+  if (!queue) {
+    // Create new queue if it doesn't exist or was garbage collected
+    queue = new RequestQueue();
+    requestQueueMap.set(address, new WeakRef(queue));
+    // Register for automatic cleanup when queue is GC'd
+    requestQueueRegistry.register(queue, address);
+  }
+
+  return queue;
+}

package/src/src/api/exchange/_base/_types.ts

@@ -0,0 +1,95 @@
+import type { IRequestTransport } from "../../../transport/base.js";
+import type { AbstractWallet } from "../../../signing/_signTypedData.js";
+import type { MaybePromise, Prettify } from "../../_base.js";
+
+import type { CancelResponse, CancelSuccessResponse } from "../cancel.js";
+import type { CreateSubAccountResponse } from "../createSubAccount.js";
+import type { CreateVaultResponse } from "../createVault.js";
+import type { OrderResponse, OrderSuccessResponse } from "../order.js";
+import type { TwapCancelResponse, TwapCancelSuccessResponse } from "../twapCancel.js";
+import type { TwapOrderResponse, TwapOrderSuccessResponse } from "../twapOrder.js";
+import type { ErrorResponse, SuccessResponse } from "./_schemas.js";
+
+export type AnyResponse =
+  | SuccessResponse
+  | ErrorResponse
+  | CancelResponse
+  | CreateSubAccountResponse
+  | CreateVaultResponse
+  | OrderResponse
+  | TwapOrderResponse
+  | TwapCancelResponse;
+export type AnySuccessResponse =
+  | SuccessResponse
+  | CancelSuccessResponse
+  | CreateSubAccountResponse
+  | CreateVaultResponse
+  | OrderSuccessResponse
+  | TwapOrderSuccessResponse
+  | TwapCancelSuccessResponse;
+
+/** Configuration for Exchange API requests. */
+export interface ExchangeRequestConfig<
+  T extends IRequestTransport = IRequestTransport,
+  W extends AbstractWallet = AbstractWallet,
+> {
+  /** The transport used to connect to the Hyperliquid Exchange API. */
+  transport: T;
+  /** The wallet used to sign requests. */
+  wallet: W;
+  /**
+   * The network that will be used to sign transactions.
+   * Must match the network of the {@link wallet}.
+   *
+   * Defaults to get chain id from wallet otherwise `0x1`.
+   */
+  signatureChainId?: string | (() => MaybePromise<string>);
+  /**
+   * Sets a default vaultAddress to be used if no vaultAddress is explicitly passed to a method.
+   * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#subaccounts-and-vaults
+   */
+  defaultVaultAddress?: string;
+  /**
+   * Sets a default expiresAfter to be used if no expiresAfter is explicitly passed to a method.
+   * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#expires-after
+   */
+  defaultExpiresAfter?: number | (() => MaybePromise<number>);
+  /**
+   * Execute requests sequentially to prevent network-level race conditions.
+   * When enabled, requests are queued and executed one by one in order,
+   * ensuring they arrive at the server in the correct sequence.
+   * @default true
+   */
+  sequentialRequests?: boolean;
+}
+
+/** Configuration for Exchange API requests using multi-signature wallets. */
+export interface MultiSignRequestConfig<
+  T extends IRequestTransport = IRequestTransport,
+  S extends readonly AbstractWallet[] = AbstractWallet[],
+> extends Omit<ExchangeRequestConfig<T, S[0]>, "wallet"> {
+  /** The multi-signature account address. */
+  multiSigUser: string;
+  /** Array of wallets used for multi-signature operations. The first wallet acts as the leader. */
+  signers: S;
+}
+
+// deno-lint-ignore no-explicit-any
+type DistributiveOmit<T, K extends keyof any> = T extends unknown ? Omit<T, K> : never;
+export type ExtractRequestAction<T extends { action: Record<string, unknown> }> = Prettify<
+  T["action"] extends { signatureChainId: unknown }
+    ? DistributiveOmit<T["action"], "type" | "signatureChainId" | "hyperliquidChain" | "nonce" | "time"> // user-signed actions
+    : DistributiveOmit<T["action"], "type"> // L1 actions
+>;
+
+export type ExtractRequestOptions<T extends { action: Record<string, unknown> }> = Prettify<
+  & {
+    /**
+     * An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal)
+     * If this option is set, the request can be canceled by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort)
+     * on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+     */
+    signal?: AbortSignal;
+  }
+  & Omit<T, "action" | "nonce" | "signature">
+>;

package/src/src/api/exchange/_base/mod.ts

@@ -0,0 +1,7 @@
+export * from "./_errors.js";
+export * from "./_execute.js";
+export * from "./_helpers.js";
+export * from "./_nonce.js";
+export * from "./_sequential.js";
+export * from "./_schemas.js";
+export * from "./_types.js";

package/src/src/api/exchange/agentEnableDexAbstraction.ts

@@ -1,3 +1,4 @@
+import * as v from "valibot";
 import { parser, UnsignedInteger } from "../_base.js";
 import {
   type ExchangeRequestConfig,
@@ -5,8 +6,7 @@ import {
   type ExtractRequestOptions,
   type MultiSignRequestConfig,
   Signature,
-} from "./_base.js";
-import * as v from "valibot";
+} from "./_base/mod.js";
 
 // -------------------- Schemas --------------------
 
@@ -49,7 +49,7 @@ export const AgentEnableDexAbstractionRequest = /* @__PURE__ */ (() => {
 })();
 export type AgentEnableDexAbstractionRequest = v.InferOutput<typeof AgentEnableDexAbstractionRequest>;
 
-import { SuccessResponse } from "./_base.js";
+import { SuccessResponse } from "./_base/mod.js";
 export { SuccessResponse };
 
 // -------------------- Function --------------------
@@ -89,8 +89,11 @@ export async function agentEnableDexAbstraction(
   const action = parser(AgentEnableDexAbstractionRequest.entries.action)({
     type: "agentEnableDexAbstraction",
   });
-  const expiresAfter = typeof config.defaultExpiresAfter === "number"
+
+  const expiresAfter_ = typeof config.defaultExpiresAfter === "number"
     ? config.defaultExpiresAfter
     : await config.defaultExpiresAfter?.();
+  const expiresAfter = parser(v.optional(UnsignedInteger))(expiresAfter_);
+
   return await executeL1Action(config, { action, expiresAfter }, opts?.signal);
 }

package/src/src/api/exchange/approveAgent.ts

@@ -1,15 +1,15 @@
+import * as v from "valibot";
 import { Address, type DeepImmutable, Hex, parser, UnsignedInteger } from "../_base.js";
 import {
   type ExchangeRequestConfig,
   executeUserSignedAction,
   type ExtractRequestAction,
   type ExtractRequestOptions,
-  getNonce,
   getSignatureChainId,
+  globalNonceManager,
   type MultiSignRequestConfig,
   Signature,
-} from "./_base.js";
-import * as v from "valibot";
+} from "./_base/mod.js";
 
 // -------------------- Schemas --------------------
 
@@ -72,7 +72,7 @@ export const ApproveAgentRequest = /* @__PURE__ */ (() => {
 })();
 export type ApproveAgentRequest = v.InferOutput<typeof ApproveAgentRequest>;
 
-import { SuccessResponse } from "./_base.js";
+import { SuccessResponse } from "./_base/mod.js";
 export { SuccessResponse };
 
 // -------------------- Function --------------------
@@ -127,7 +127,7 @@ export async function approveAgent(
     type: "approveAgent",
     hyperliquidChain: config.transport.isTestnet ? "Testnet" : "Mainnet",
     signatureChainId: await getSignatureChainId(config),
-    nonce: await getNonce(config),
+    nonce: globalNonceManager.getNonce(),
     ...params,
   });
   return await executeUserSignedAction(

package/src/src/api/exchange/approveBuilderFee.ts

@@ -1,15 +1,15 @@
+import * as v from "valibot";
 import { Address, type DeepImmutable, Hex, parser, Percent, UnsignedInteger } from "../_base.js";
 import {
   type ExchangeRequestConfig,
   executeUserSignedAction,
   type ExtractRequestAction,
   type ExtractRequestOptions,
-  getNonce,
   getSignatureChainId,
+  globalNonceManager,
   type MultiSignRequestConfig,
   Signature,
-} from "./_base.js";
-import * as v from "valibot";
+} from "./_base/mod.js";
 
 // -------------------- Schemas --------------------
 
@@ -72,7 +72,7 @@ export const ApproveBuilderFeeRequest = /* @__PURE__ */ (() => {
 })();
 export type ApproveBuilderFeeRequest = v.InferOutput<typeof ApproveBuilderFeeRequest>;
 
-import { SuccessResponse } from "./_base.js";
+import { SuccessResponse } from "./_base/mod.js";
 export { SuccessResponse };
 
 // -------------------- Function --------------------
@@ -127,7 +127,7 @@ export async function approveBuilderFee(
     type: "approveBuilderFee",
     hyperliquidChain: config.transport.isTestnet ? "Testnet" : "Mainnet",
     signatureChainId: await getSignatureChainId(config),
-    nonce: await getNonce(config),
+    nonce: globalNonceManager.getNonce(),
     ...params,
   });
   return await executeUserSignedAction(

package/src/src/api/exchange/batchModify.ts

@@ -1,3 +1,4 @@
+import * as v from "valibot";
 import { Address, type DeepImmutable, Hex, parser, UnsignedInteger } from "../_base.js";
 import {
   type ExchangeRequestConfig,
@@ -6,8 +7,7 @@ import {
   type ExtractRequestOptions,
   type MultiSignRequestConfig,
   Signature,
-} from "./_base.js";
-import * as v from "valibot";
+} from "./_base/mod.js";
 
 import { PlaceOrderParamsSchema } from "../_common_schemas.js";
 
@@ -132,9 +132,14 @@ export async function batchModify(
     type: "batchModify",
     ...params,
   });
-  const vaultAddress = opts?.vaultAddress ?? config.defaultVaultAddress;
-  const expiresAfter = typeof config.defaultExpiresAfter === "number"
+
+  const vaultAddress_ = opts?.vaultAddress ?? config.defaultVaultAddress;
+  const vaultAddress = parser(v.optional(Address))(vaultAddress_);
+
+  const expiresAfter_ = typeof config.defaultExpiresAfter === "number"
     ? config.defaultExpiresAfter
     : await config.defaultExpiresAfter?.();
+  const expiresAfter = parser(v.optional(UnsignedInteger))(expiresAfter_);
+
   return await executeL1Action(config, { action, vaultAddress, expiresAfter }, opts?.signal);
 }

package/src/src/api/exchange/cDeposit.ts

@@ -1,15 +1,15 @@
+import * as v from "valibot";
 import { type DeepImmutable, Hex, parser, UnsignedInteger } from "../_base.js";
 import {
   type ExchangeRequestConfig,
   executeUserSignedAction,
   type ExtractRequestAction,
   type ExtractRequestOptions,
-  getNonce,
   getSignatureChainId,
+  globalNonceManager,
   type MultiSignRequestConfig,
   Signature,
-} from "./_base.js";
-import * as v from "valibot";
+} from "./_base/mod.js";
 
 // -------------------- Schemas --------------------
 
@@ -67,7 +67,7 @@ export const CDepositRequest = /* @__PURE__ */ (() => {
 })();
 export type CDepositRequest = v.InferOutput<typeof CDepositRequest>;
 
-import { SuccessResponse } from "./_base.js";
+import { SuccessResponse } from "./_base/mod.js";
 export { SuccessResponse };
 
 // -------------------- Function --------------------
@@ -121,7 +121,7 @@ export async function cDeposit(
     type: "cDeposit",
     hyperliquidChain: config.transport.isTestnet ? "Testnet" : "Mainnet",
     signatureChainId: await getSignatureChainId(config),
-    nonce: await getNonce(config),
+    nonce: globalNonceManager.getNonce(),
     ...params,
   });
   return await executeUserSignedAction(

package/src/src/api/exchange/cSignerAction.ts

@@ -1,3 +1,4 @@
+import * as v from "valibot";
 import { type DeepImmutable, parser, UnsignedInteger } from "../_base.js";
 import {
   type ExchangeRequestConfig,
@@ -6,8 +7,7 @@ import {
   type ExtractRequestOptions,
   type MultiSignRequestConfig,
   Signature,
-} from "./_base.js";
-import * as v from "valibot";
+} from "./_base/mod.js";
 
 // -------------------- Schemas --------------------
 
@@ -20,7 +20,7 @@ export const CSignerActionRequest = /* @__PURE__ */ (() => {
     v.object({
       /** Action to perform. */
       action: v.pipe(
-        v.variant("type", [
+        v.union([
           v.object({
             /** Type of action. */
             type: v.pipe(
@@ -69,7 +69,7 @@ export const CSignerActionRequest = /* @__PURE__ */ (() => {
 })();
 export type CSignerActionRequest = v.InferOutput<typeof CSignerActionRequest>;
 
-import { SuccessResponse } from "./_base.js";
+import { SuccessResponse } from "./_base/mod.js";
 export { SuccessResponse };
 
 // -------------------- Function --------------------
@@ -121,8 +121,11 @@ export async function cSignerAction(
     type: "CSignerAction",
     ...params,
   });
-  const expiresAfter = typeof config.defaultExpiresAfter === "number"
+
+  const expiresAfter_ = typeof config.defaultExpiresAfter === "number"
     ? config.defaultExpiresAfter
     : await config.defaultExpiresAfter?.();
+  const expiresAfter = parser(v.optional(UnsignedInteger))(expiresAfter_);
+
   return await executeL1Action(config, { action, expiresAfter }, opts?.signal);
 }

package/src/src/api/exchange/cValidatorAction.ts

@@ -1,3 +1,4 @@
+import * as v from "valibot";
 import { Address, type DeepImmutable, parser, UnsignedInteger } from "../_base.js";
 import {
   type ExchangeRequestConfig,
@@ -6,8 +7,7 @@ import {
   type ExtractRequestOptions,
   type MultiSignRequestConfig,
   Signature,
-} from "./_base.js";
-import * as v from "valibot";
+} from "./_base/mod.js";
 
 // -------------------- Schemas --------------------
 
@@ -20,7 +20,7 @@ export const CValidatorActionRequest = /* @__PURE__ */ (() => {
     v.object({
       /** Action to perform. */
       action: v.pipe(
-        v.variant("type", [
+        v.union([
           v.object({
             /** Type of action. */
             type: v.pipe(
@@ -180,7 +180,7 @@ export const CValidatorActionRequest = /* @__PURE__ */ (() => {
 })();
 export type CValidatorActionRequest = v.InferOutput<typeof CValidatorActionRequest>;
 
-import { SuccessResponse } from "./_base.js";
+import { SuccessResponse } from "./_base/mod.js";
 export { SuccessResponse };
 
 // -------------------- Function --------------------
@@ -261,8 +261,11 @@ export async function cValidatorAction(
     type: "CValidatorAction",
     ...params,
   });
-  const expiresAfter = typeof config.defaultExpiresAfter === "number"
+
+  const expiresAfter_ = typeof config.defaultExpiresAfter === "number"
     ? config.defaultExpiresAfter
     : await config.defaultExpiresAfter?.();
+  const expiresAfter = parser(v.optional(UnsignedInteger))(expiresAfter_);
+
   return await executeL1Action(config, { action, expiresAfter }, opts?.signal);
 }

package/src/src/api/exchange/cWithdraw.ts

@@ -1,15 +1,15 @@
+import * as v from "valibot";
 import { type DeepImmutable, Hex, parser, UnsignedInteger } from "../_base.js";
 import {
   type ExchangeRequestConfig,
   executeUserSignedAction,
   type ExtractRequestAction,
   type ExtractRequestOptions,
-  getNonce,
   getSignatureChainId,
+  globalNonceManager,
   type MultiSignRequestConfig,
   Signature,
-} from "./_base.js";
-import * as v from "valibot";
+} from "./_base/mod.js";
 
 // -------------------- Schemas --------------------
 
@@ -67,7 +67,7 @@ export const CWithdrawRequest = /* @__PURE__ */ (() => {
 })();
 export type CWithdrawRequest = v.InferOutput<typeof CWithdrawRequest>;
 
-import { SuccessResponse } from "./_base.js";
+import { SuccessResponse } from "./_base/mod.js";
 export { SuccessResponse };
 
 // -------------------- Function --------------------
@@ -121,7 +121,7 @@ export async function cWithdraw(
     type: "cWithdraw",
     hyperliquidChain: config.transport.isTestnet ? "Testnet" : "Mainnet",
     signatureChainId: await getSignatureChainId(config),
-    nonce: await getNonce(config),
+    nonce: globalNonceManager.getNonce(),
     ...params,
   });
   return await executeUserSignedAction(

package/src/src/api/exchange/cancel.ts

@@ -1,3 +1,4 @@
+import * as v from "valibot";
 import { Address, type DeepImmutable, parser, UnsignedInteger } from "../_base.js";
 import {
   type ExchangeRequestConfig,
@@ -6,8 +7,7 @@ import {
   type ExtractRequestOptions,
   type MultiSignRequestConfig,
   Signature,
-} from "./_base.js";
-import * as v from "valibot";
+} from "./_base/mod.js";
 
 // -------------------- Schemas --------------------
 
@@ -202,9 +202,14 @@ export async function cancel(
     type: "cancel",
     ...params,
   });
-  const vaultAddress = opts?.vaultAddress ?? config.defaultVaultAddress;
-  const expiresAfter = typeof config.defaultExpiresAfter === "number"
+
+  const vaultAddress_ = opts?.vaultAddress ?? config.defaultVaultAddress;
+  const vaultAddress = parser(v.optional(Address))(vaultAddress_);
+
+  const expiresAfter_ = typeof config.defaultExpiresAfter === "number"
     ? config.defaultExpiresAfter
     : await config.defaultExpiresAfter?.();
+  const expiresAfter = parser(v.optional(UnsignedInteger))(expiresAfter_);
+
   return await executeL1Action(config, { action, vaultAddress, expiresAfter }, opts?.signal);
 }

package/src/src/api/exchange/cancelByCloid.ts

@@ -1,3 +1,4 @@
+import * as v from "valibot";
 import { Address, type DeepImmutable, Hex, parser, UnsignedInteger } from "../_base.js";
 import {
   type ExchangeRequestConfig,
@@ -6,8 +7,7 @@ import {
   type ExtractRequestOptions,
   type MultiSignRequestConfig,
   Signature,
-} from "./_base.js";
-import * as v from "valibot";
+} from "./_base/mod.js";
 
 // -------------------- Schemas --------------------
 
@@ -120,9 +120,14 @@ export async function cancelByCloid(
     type: "cancelByCloid",
     ...params,
   });
-  const vaultAddress = opts?.vaultAddress ?? config.defaultVaultAddress;
-  const expiresAfter = typeof config.defaultExpiresAfter === "number"
+
+  const vaultAddress_ = opts?.vaultAddress ?? config.defaultVaultAddress;
+  const vaultAddress = parser(v.optional(Address))(vaultAddress_);
+
+  const expiresAfter_ = typeof config.defaultExpiresAfter === "number"
     ? config.defaultExpiresAfter
     : await config.defaultExpiresAfter?.();
+  const expiresAfter = parser(v.optional(UnsignedInteger))(expiresAfter_);
+
   return await executeL1Action(config, { action, vaultAddress, expiresAfter }, opts?.signal);
 }