@nktkas/hyperliquid 0.25.4 → 0.25.6

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

@@ -0,0 +1 @@
+{"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

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

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

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

package/script/src/utils/mod.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./_symbolConverter.js"), exports);
+//# sourceMappingURL=mod.js.map

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

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

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]);
+  }
+}

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";