@nktkas/hyperliquid 0.25.5 → 0.25.7

package/script/src/utils/_format.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatPrice = formatPrice;
+exports.formatSize = formatSize;
+const _base_js_1 = require("../_base.js");
+/**
+ * Format price according to Hyperliquid {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size | rules}:
+ * - Maximum 5 significant figures
+ * - Maximum (6 for perp, 8 for spot) - `szDecimals` decimal places
+ * - Integer prices are always allowed regardless of significant figures
+ * - Remove trailing zeros
+ * @example
+ * ```ts
+ * import { formatPrice } from "@nktkas/hyperliquid/utils";
+ *
+ * //        `true` for perp (default), `false` for spot
+ * //                                              ⌄⌄⌄⌄⌄
+ * const price = formatPrice("0.0000123456789", 0, false); // → "0.00001234"
+ * ```
+ */
+function formatPrice(price, szDecimals, isPerp = true) {
+    // Prepare: trim, validate, normalize leading/trailing zeros
+    let priceStr = prepareNumber(typeof price === "string" ? price : price.toString());
+    // Integer prices bypass sig figs limit per spec
+    if (!priceStr.includes(".")) {
+        return priceStr;
+    }
+    // Apply decimal limit: max (6 for perp, 8 for spot) - `szDecimals` decimals
+    const maxDecimals = Math.max((isPerp ? 6 : 8) - szDecimals, 0);
+    priceStr = truncateDecimals(priceStr, maxDecimals);
+    // Apply sig figs limit: max 5 significant figures
+    priceStr = truncateSigFigs(priceStr, 5);
+    return priceStr;
+}
+/**
+ * Format size according to Hyperliquid {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size | rules}:
+ * - Truncate to `szDecimals` decimal places
+ * - Remove trailing zeros
+ * @example
+ * ```ts
+ * import { formatSize } from "@nktkas/hyperliquid/utils";
+ *
+ * const size = formatSize("1.23456789", 5); // → "1.23456"
+ * ```
+ */
+function formatSize(size, szDecimals) {
+    // Prepare: trim, validate, normalize leading/trailing zeros
+    let sizeStr = prepareNumber(typeof size === "string" ? size : size.toString());
+    // Truncate to `szDecimals` decimal places
+    sizeStr = truncateDecimals(sizeStr, szDecimals);
+    return sizeStr;
+}
+/**
+ * Prepare number string for processing:
+ * 1. Trim whitespace
+ * 2. Validate format (decimal number, not hex/scientific)
+ * 3. Normalize: remove leading zeros from integer part, trailing zeros from decimal part
+ */
+function prepareNumber(numStr) {
+    const trimmed = numStr.trim();
+    // Validate: only decimal numbers allowed (no hex, scientific notation, etc)
+    if (!/^-?(\d+\.?\d*|\.\d+)$/.test(trimmed)) {
+        throw new _base_js_1.HyperliquidError(`Invalid number format: ${numStr}`);
+    }
+    // Normalize: remove leading zeros from integer, trailing zeros from decimal
+    const [int, dec] = trimmed.split(".");
+    const trimmedInt = int.replace(/^0+/, "") || "0";
+    const trimmedDec = dec?.replace(/0+$/, "");
+    return trimmedInt + (trimmedDec ? "." + trimmedDec : "");
+}
+/** String-based Math operations for arbitrary precision */
+const StringMath = {
+    /** Absolute value: remove negative sign if present */
+    abs(numStr) {
+        return numStr[0] === "-" ? numStr.slice(1) : numStr;
+    },
+    /** Floor log10 (magnitude): position of most significant digit */
+    log10Floor(numStr) {
+        const abs = this.abs(numStr);
+        const [int, dec] = abs.split(".");
+        // Number >= 1: magnitude = length of integer part - 1
+        if (int !== "0") {
+            const trimmed = int.replace(/^0+/, "");
+            return trimmed.length - 1;
+        }
+        // Number < 1: count leading zeros in decimal part
+        if (!dec)
+            return -Infinity;
+        const leadingZeros = dec.match(/^0*/)?.[0].length ?? 0;
+        return -(leadingZeros + 1);
+    },
+    /** Multiply by 10^exp: shift decimal point left (negative) or right (positive) */
+    multiplyByPow10(numStr, exp) {
+        if (exp === 0)
+            return numStr;
+        const neg = numStr[0] === "-";
+        const abs = neg ? numStr.slice(1) : numStr;
+        const [int, dec = ""] = abs.split(".");
+        if (exp > 0) {
+            // Shift right: move digits from decimal to integer
+            if (exp >= dec.length) {
+                return (neg ? "-" : "") + int + dec + "0".repeat(exp - dec.length);
+            }
+            return (neg ? "-" : "") + int + dec.slice(0, exp) + "." + dec.slice(exp);
+        }
+        else {
+            // Shift left: move digits from integer to decimal
+            const absExp = -exp;
+            if (absExp >= int.length) {
+                return (neg ? "-" : "") + "0." + "0".repeat(absExp - int.length) + int + dec;
+            }
+            return (neg ? "-" : "") + int.slice(0, -absExp) + "." + int.slice(-absExp) + dec;
+        }
+    },
+    /** Truncate: remove decimal part */
+    trunc(numStr) {
+        const dotIndex = numStr.indexOf(".");
+        return dotIndex === -1 ? numStr : numStr.slice(0, dotIndex);
+    },
+};
+/** Truncate to specified decimal places */
+function truncateDecimals(numStr, maxDecimals) {
+    const dotIndex = numStr.indexOf(".");
+    if (dotIndex === -1)
+        return numStr;
+    const truncated = numStr.substring(0, dotIndex + maxDecimals + 1);
+    // Remove trailing zeros from decimal
+    const [int, dec] = truncated.split(".");
+    const trimmedDec = dec?.replace(/0+$/, "");
+    return trimmedDec ? int + "." + trimmedDec : int;
+}
+/** Truncate to specified significant figures using string-based math */
+function truncateSigFigs(numStr, maxSigFigs) {
+    if (parseFloat(numStr) === 0)
+        return "0";
+    const neg = numStr[0] === "-";
+    const abs = neg ? numStr.slice(1) : numStr;
+    // Calculate how much to shift: align most significant digit to ones place + (maxSigFigs-1)
+    const magnitude = StringMath.log10Floor(abs);
+    const shiftAmount = maxSigFigs - magnitude - 1;
+    // Shift right, truncate integer part, shift back
+    const shifted = StringMath.multiplyByPow10(abs, shiftAmount);
+    const truncated = StringMath.trunc(shifted);
+    const result = StringMath.multiplyByPow10(truncated, -shiftAmount);
+    // Remove trailing zeros introduced by shifting
+    const final = neg ? "-" + result : result;
+    const [int, dec] = final.split(".");
+    const trimmedDec = dec?.replace(/0+$/, "");
+    return trimmedDec ? int + "." + trimmedDec : int;
+}
+//# sourceMappingURL=_format.js.map

package/script/src/utils/_format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_format.js","sourceRoot":"","sources":["../../../src/src/utils/_format.ts"],"names":[],"mappings":"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"}

package/script/src/utils/_symbolConverter.d.ts

@@ -19,6 +19,9 @@ export interface SymbolConverterOptions {
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  * const converter = await SymbolConverter.create({ transport });
  *
+ * // By default, dexs are not loaded; specify them when creating an instance
+ * // const converter = await SymbolConverter.create({ transport, dexs: ["test"] });
+ *
  * const btcId = converter.getAssetId("BTC"); // perpetual → 0
  * const hypeUsdcId = converter.getAssetId("HYPE/USDC"); // spot market → 10107
  * const dexAbcId = converter.getAssetId("test:ABC"); // builder dex (if enabled) → 110000
@@ -26,6 +29,8 @@ export interface SymbolConverterOptions {
  * const btcSzDecimals = converter.getSzDecimals("BTC"); // perpetual → 5
  * const hypeUsdcSzDecimals = converter.getSzDecimals("HYPE/USDC"); // spot market → 2
  * const dexAbcSzDecimals = converter.getSzDecimals("test:ABC"); // builder dex (if enabled) → 0
+ *
+ * const spotPairId = converter.getSpotPairId("HFUN/USDC"); // → "@2"
  * ```
  */
 export declare class SymbolConverter {
@@ -33,6 +38,7 @@ export declare class SymbolConverter {
     private readonly dexOption;
     private readonly nameToAssetId;
     private readonly nameToSzDecimals;
+    private readonly nameToSpotPairId;
     private constructor();
     /**
      * Create and initialize a SymbolConverter instance.
@@ -73,5 +79,12 @@ export declare class SymbolConverter {
      * @example "BTC" → 5, "HYPE/USDC" → 2, "test:ABC" → 0
      */
     getSzDecimals(name: string): number | undefined;
+    /**
+     * Get spot pair ID for info endpoints and subscriptions (e.g., l2book, trades).
+     *
+     * Accepts spot markets in the "BASE/QUOTE" format (e.g., "HFUN/USDC").
+     * @example "HFUN/USDC" → "@2", "PURR/USDC" → "PURR/USDC"
+     */
+    getSpotPairId(name: string): string | undefined;
 }
 //# sourceMappingURL=_symbolConverter.d.ts.map

package/script/src/utils/_symbolConverter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_symbolConverter.d.ts","sourceRoot":"","sources":["../../../src/src/utils/_symbolConverter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAK9D,MAAM,MAAM,SAAS,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;AAE3C,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,SAAS,EAAE,iBAAiB,CAAC;IAC7B,+FAA+F;IAC/F,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAE9D,OAAO;IAKP;;;;;;;;;;;;OAYG;WACU,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAM9E;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B7B,OAAO,CAAC,mBAAmB;YAOb,kBAAkB;IA6BhC,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,iBAAiB;IAmBzB;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGhD"}
+{"version":3,"file":"_symbolConverter.d.ts","sourceRoot":"","sources":["../../../src/src/utils/_symbolConverter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAK9D,MAAM,MAAM,SAAS,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;AAE3C,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,SAAS,EAAE,iBAAiB,CAAC;IAC7B,+FAA+F;IAC/F,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAE9D,OAAO;IAKP;;;;;;;;;;;;OAYG;WACU,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAM9E;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B7B,OAAO,CAAC,mBAAmB;YAOb,kBAAkB;IA6BhC,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,iBAAiB;IAoBzB;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGhD"}

package/script/src/utils/_symbolConverter.js

@@ -16,6 +16,9 @@ const perpDexs_js_1 = require("../api/info/perpDexs.js");
  * const transport = new HttpTransport(); // or `WebSocketTransport`
  * const converter = await SymbolConverter.create({ transport });
  *
+ * // By default, dexs are not loaded; specify them when creating an instance
+ * // const converter = await SymbolConverter.create({ transport, dexs: ["test"] });
+ *
  * const btcId = converter.getAssetId("BTC"); // perpetual → 0
  * const hypeUsdcId = converter.getAssetId("HYPE/USDC"); // spot market → 10107
  * const dexAbcId = converter.getAssetId("test:ABC"); // builder dex (if enabled) → 110000
@@ -23,6 +26,8 @@ const perpDexs_js_1 = require("../api/info/perpDexs.js");
  * const btcSzDecimals = converter.getSzDecimals("BTC"); // perpetual → 5
  * const hypeUsdcSzDecimals = converter.getSzDecimals("HYPE/USDC"); // spot market → 2
  * const dexAbcSzDecimals = converter.getSzDecimals("test:ABC"); // builder dex (if enabled) → 0
+ *
+ * const spotPairId = converter.getSpotPairId("HFUN/USDC"); // → "@2"
  * ```
  */
 class SymbolConverter {
@@ -30,6 +35,7 @@ class SymbolConverter {
     dexOption;
     nameToAssetId = new Map();
     nameToSzDecimals = new Map();
+    nameToSpotPairId = new Map();
     constructor(options) {
         this.transport = options.transport;
         this.dexOption = options.dexs ?? false;
@@ -71,6 +77,7 @@ class SymbolConverter {
         }
         this.nameToAssetId.clear();
         this.nameToSzDecimals.clear();
+        this.nameToSpotPairId.clear();
         this.processDefaultPerps(perpMetaData);
         this.processSpotAssets(spotMetaData);
         // Only process builder dexs if dex support is enabled
@@ -132,6 +139,7 @@ class SymbolConverter {
             const baseQuoteKey = `${baseToken.name}/${quoteToken.name}`;
             this.nameToAssetId.set(baseQuoteKey, assetId);
             this.nameToSzDecimals.set(baseQuoteKey, baseToken.szDecimals);
+            this.nameToSpotPairId.set(baseQuoteKey, market.name);
         });
     }
     /**
@@ -154,6 +162,15 @@ class SymbolConverter {
     getSzDecimals(name) {
         return this.nameToSzDecimals.get(name);
     }
+    /**
+     * Get spot pair ID for info endpoints and subscriptions (e.g., l2book, trades).
+     *
+     * Accepts spot markets in the "BASE/QUOTE" format (e.g., "HFUN/USDC").
+     * @example "HFUN/USDC" → "@2", "PURR/USDC" → "PURR/USDC"
+     */
+    getSpotPairId(name) {
+        return this.nameToSpotPairId.get(name);
+    }
 }
 exports.SymbolConverter = SymbolConverter;
 //# sourceMappingURL=_symbolConverter.js.map

package/script/src/utils/_symbolConverter.js.map

@@ -1 +1 @@
-{"version":3,"file":"_symbolConverter.js","sourceRoot":"","sources":["../../../src/src/utils/_symbolConverter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"_symbolConverter.js","sourceRoot":"","sources":["../../../src/src/utils/_symbolConverter.ts"],"names":[],"mappings":"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"}

package/script/src/utils/mod.d.ts

@@ -1,2 +1,3 @@
 export * from "./_symbolConverter.js";
+export * from "./_format.js";
 //# sourceMappingURL=mod.d.ts.map

package/script/src/utils/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC"}

package/script/src/utils/mod.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./_symbolConverter.js"), exports);
+__exportStar(require("./_format.js"), exports);
 //# sourceMappingURL=mod.js.map

package/script/src/utils/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC"}
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,+CAA6B"}

package/src/bin/cli.ts

@@ -108,6 +108,7 @@ INFO ENDPOINT METHODS
 Market Data:
   alignedQuoteTokenInfo   --token <number>
   allMids                 [--dex <string>]
+  allPerpMetas            (no params)
   candleSnapshot          --coin <string> --interval <1m|3m|5m|15m|30m|1h|2h|4h|8h|12h|1d|3d|1w|1M>
                           --startTime <number> [--endTime <number>]
   fundingHistory          --coin <string> --startTime <number> [--endTime <number>]
@@ -137,6 +138,7 @@ User Account:
   referral                --user <address>
   spotClearinghouseState  --user <address> [--dex <string>]
   subAccounts             --user <address>
+  subAccounts2            --user <address>
   userDexAbstraction      --user <address>
   userFees                --user <address>
   userFunding             --user <address> --startTime <number> [--endTime <number>]
@@ -248,9 +250,12 @@ Vault:
   vaultTransfer           --vaultAddress <address> --isDeposit <bool> --usd <number>
 
 Deploy Market:
-  perpDeploy              --registerAsset <json> | --setOracle <json>
+  perpDeploy              --registerAsset <json> | --setOracle <json> | --setFundingMultipliers <json> |
+                          --haltTrading <json> | --setMarginTableIds <json> | --setFeeRecipient <json> |
+                          --setOpenInterestCaps <json>
   spotDeploy              --genesis <json> | --registerHyperliquidity <json> | --registerSpot <json> |
-                          --registerToken2 <json> | --setDeployerTradingFeeShare <json> | --userGenesis <json>
+                          --registerToken2 <json> | --setDeployerTradingFeeShare <json> | --userGenesis <json> |
+                          --enableQuoteToken <json>
 
 Validator Actions:
   cSignerAction           --jailSelf null | --unjailSelf null

package/src/src/api/_base.ts

@@ -4,6 +4,8 @@ import { HyperliquidError } from "../_base.js";
 
 // -------------------- Types --------------------
 
+export type MaybePromise<T> = T | Promise<T>;
+
 export type Prettify<T> =
   & { [K in keyof T]: T[K] }
   & {};

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

@@ -0,0 +1,60 @@
+import { HyperliquidError } from "../../../_base.js";
+import type { ErrorResponse } from "./_schemas.js";
+import type { CancelResponse } from "../cancel.js";
+import type { OrderResponse } from "../order.js";
+import type { TwapOrderResponse } from "../twapOrder.js";
+import type { TwapCancelResponse } from "../twapCancel.js";
+import type { AnyResponse, AnySuccessResponse } from "./_types.js";
+
+/** Thrown when an API request fails. */
+export class ApiRequestError extends HyperliquidError {
+  constructor(
+    public response:
+      | ErrorResponse
+      | CancelResponse
+      | OrderResponse
+      | TwapOrderResponse
+      | TwapCancelResponse,
+  ) {
+    let message;
+    if (response.status === "err") {
+      // ErrorResponse
+      message = response.response;
+    } else {
+      if ("statuses" in response.response.data) {
+        // OrderResponse | CancelResponse
+        const errors = response.response.data.statuses.reduce<string[]>((acc, status, index) => {
+          if (typeof status === "object" && "error" in status) {
+            acc.push(`Order ${index}: ${status.error}`);
+          }
+          return acc;
+        }, []);
+        if (errors.length > 0) {
+          message = errors.join(", ");
+        }
+      } else {
+        // TwapOrderResponse | TwapCancelResponse
+        if (typeof response.response.data.status === "object" && "error" in response.response.data.status) {
+          message = response.response.data.status.error;
+        }
+      }
+    }
+
+    super(message || "An unknown error occurred while processing an API request. See `response` for more details.");
+    this.name = "ApiRequestError";
+  }
+}
+
+export function assertSuccessResponse(response: AnyResponse): asserts response is AnySuccessResponse {
+  if (response.status === "err") {
+    throw new ApiRequestError(response as ErrorResponse);
+  } else if (response.response.type === "order" || response.response.type === "cancel") {
+    if (response.response.data.statuses.some((status) => typeof status === "object" && "error" in status)) {
+      throw new ApiRequestError(response as OrderResponse | CancelResponse);
+    }
+  } else if (response.response.type === "twapOrder" || response.response.type === "twapCancel") {
+    if (typeof response.response.data.status === "object" && "error" in response.response.data.status) {
+      throw new ApiRequestError(response as TwapOrderResponse | TwapCancelResponse);
+    }
+  }
+}

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

@@ -0,0 +1,220 @@
+import { getWalletAddress, signL1Action, signMultiSigAction, signUserSignedAction } from "../../../signing/mod.js";
+import { assertSuccessResponse } from "./_errors.js";
+import type { AnyResponse, AnySuccessResponse, ExchangeRequestConfig, MultiSignRequestConfig } from "./_types.js";
+import { globalNonceManager } from "./_nonce.js";
+import { getSignatureChainId } from "./_helpers.js";
+import { getRequestQueue } from "./_sequential.js";
+
+export async function executeL1Action<T extends AnySuccessResponse>(
+  config: ExchangeRequestConfig | MultiSignRequestConfig,
+  request: {
+    action: Record<string, unknown>;
+    vaultAddress?: `0x${string}`;
+    expiresAfter?: number;
+  },
+  signal?: AbortSignal,
+): Promise<T> {
+  const fn = async (): Promise<T> => {
+    const { transport } = config;
+    const { action, vaultAddress, expiresAfter } = request;
+
+    const nonce = globalNonceManager.getNonce();
+
+    if ("signers" in config) {
+      const { signers, multiSigUser } = config;
+      const outerSigner = await getWalletAddress(signers[0]);
+
+      // Sign an L1 action for each signer
+      const signatures = await Promise.all(signers.map(async (signer) => {
+        const signature = await signL1Action({
+          wallet: signer,
+          action: [multiSigUser, outerSigner, action],
+          nonce,
+          isTestnet: transport.isTestnet,
+          vaultAddress,
+          expiresAfter,
+        });
+        signature.r = signature.r.replace(/^0x0+/, "0x") as `0x${string}`;
+        signature.s = signature.s.replace(/^0x0+/, "0x") as `0x${string}`;
+        return signature;
+      }));
+
+      // Send a request via multi-sign action
+      return await executeMultiSigAction(
+        {
+          ...config,
+          wallet: signers[0],
+          // Disable queue since we're already inside the queue
+          sequentialRequests: false,
+        },
+        {
+          action: {
+            type: "multiSig",
+            signatureChainId: await getSignatureChainId(config),
+            signatures,
+            payload: { multiSigUser, outerSigner, action },
+          },
+          vaultAddress,
+          expiresAfter,
+          nonce,
+        },
+        signal,
+      );
+    } else {
+      const { wallet } = config;
+
+      // Sign an L1 action
+      const signature = await signL1Action({
+        wallet,
+        action,
+        nonce,
+        isTestnet: transport.isTestnet,
+        vaultAddress,
+        expiresAfter,
+      });
+
+      // Send a request
+      const response = await transport.request(
+        "exchange",
+        { action, signature, nonce, vaultAddress, expiresAfter },
+        signal,
+      ) as AnyResponse;
+      assertSuccessResponse(response);
+      return response as T;
+    }
+  };
+
+  // Execute with queue if enabled, otherwise execute directly
+  const queue = await getRequestQueue(config);
+  return queue ? await queue.enqueue(fn) : await fn();
+}
+
+export async function executeUserSignedAction<T extends AnySuccessResponse>(
+  config: ExchangeRequestConfig | MultiSignRequestConfig,
+  request: {
+    action:
+      & {
+        signatureChainId: `0x${string}`;
+        [key: string]: unknown;
+      }
+      & (
+        | { nonce: number; time?: undefined }
+        | { time: number; nonce?: undefined }
+      );
+    types: {
+      [key: string]: {
+        name: string;
+        type: string;
+      }[];
+    };
+  },
+  signal?: AbortSignal,
+): Promise<T> {
+  const fn = async (): Promise<T> => {
+    const { transport } = config;
+    const { action, types } = request;
+
+    const nonce = action.nonce ?? action.time;
+
+    if ("signers" in config) {
+      const { signers, multiSigUser } = config;
+      const outerSigner = await getWalletAddress(signers[0]);
+
+      // Sign a user-signed action for each signer
+      const signatures = await Promise.all(signers.map(async (signer) => {
+        const signature = await signUserSignedAction({
+          wallet: signer,
+          action: {
+            payloadMultiSigUser: multiSigUser as `0x${string}`,
+            outerSigner,
+            ...action,
+          },
+          types,
+        });
+        signature.r = signature.r.replace(/^0x0+/, "0x") as `0x${string}`;
+        signature.s = signature.s.replace(/^0x0+/, "0x") as `0x${string}`;
+        return signature;
+      }));
+
+      // Send a request via multi-sign action
+      return await executeMultiSigAction(
+        {
+          ...config,
+          wallet: signers[0],
+          // Disable queue since we're already inside the queue
+          sequentialRequests: false,
+        },
+        {
+          action: {
+            type: "multiSig",
+            signatureChainId: action.signatureChainId,
+            signatures,
+            payload: { multiSigUser, outerSigner, action },
+          },
+          nonce,
+        },
+        signal,
+      );
+    } else {
+      const { wallet } = config;
+
+      // Sign a user-signed action
+      const signature = await signUserSignedAction({ wallet, action, types });
+
+      // Send a request
+      const response = await transport.request(
+        "exchange",
+        { action, signature, nonce },
+        signal,
+      ) as AnyResponse;
+      assertSuccessResponse(response);
+      return response as T;
+    }
+  };
+
+  // Execute with queue if enabled, otherwise execute directly
+  const queue = await getRequestQueue(config);
+  return queue ? await queue.enqueue(fn) : await fn();
+}
+
+export async function executeMultiSigAction<T extends AnySuccessResponse>(
+  config: ExchangeRequestConfig,
+  request: {
+    action: {
+      signatureChainId: `0x${string}`;
+      [key: string]: unknown;
+    };
+    nonce: number;
+    vaultAddress?: `0x${string}`;
+    expiresAfter?: number;
+  },
+  signal?: AbortSignal,
+): Promise<T> {
+  const fn = async (): Promise<T> => {
+    const { transport, wallet } = config;
+    const { action, nonce, vaultAddress, expiresAfter } = request;
+
+    // Sign a multi-signature action
+    const signature = await signMultiSigAction({
+      wallet,
+      action,
+      nonce,
+      isTestnet: transport.isTestnet,
+      vaultAddress,
+      expiresAfter,
+    });
+
+    // Send a request
+    const response = await transport.request(
+      "exchange",
+      { action, signature, nonce, vaultAddress, expiresAfter },
+      signal,
+    ) as AnyResponse;
+    assertSuccessResponse(response);
+    return response as T;
+  };
+
+  // Execute with queue if enabled, otherwise execute directly
+  const queue = await getRequestQueue(config);
+  return queue ? await queue.enqueue(fn) : await fn();
+}

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

@@ -0,0 +1,26 @@
+import { type AbstractWallet, getWalletChainId } from "../../../signing/mod.js";
+import { Hex, type MaybePromise, parser } from "../../_base.js";
+
+/** Get the signature chain ID from the config value / function or from the wallet. */
+export async function getSignatureChainId(
+  config:
+    | {
+      wallet: AbstractWallet;
+      signatureChainId?: string | (() => MaybePromise<string>);
+    }
+    | {
+      signers: readonly AbstractWallet[];
+      signatureChainId?: string | (() => MaybePromise<string>);
+    },
+): Promise<`0x${string}`> {
+  if ("signatureChainId" in config && config.signatureChainId) {
+    const signatureChainId = typeof config.signatureChainId === "string"
+      ? config.signatureChainId
+      : await config.signatureChainId();
+    return parser(Hex)(signatureChainId);
+  } else if ("wallet" in config) {
+    return await getWalletChainId(config.wallet);
+  } else {
+    return await getWalletChainId(config.signers[0]);
+  }
+}