@nktkas/hyperliquid 0.31.0 → 0.32.0

package/script/api/subscription/client.js.map

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

package/script/api/subscription/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/api/subscription/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yCAAyC,CAAC;AACxD,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}

package/script/api/subscription/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/api/subscription/mod.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;;;;;;;;;;;;AAIH,+DAA6C;AAC7C,gEAA8C;AAC9C,mEAAiD;AACjD,iEAA+C;AAC/C,0EAAwD;AACxD,wDAAsC;AACtC,0DAAwC;AACxC,oDAAkC;AAClC,uDAAqC;AACrC,mEAAiD;AACjD,8DAA4C;AAC5C,4DAA0C;AAC1C,uDAAqC;AACrC,6DAA2C;AAC3C,2DAAyC;AACzC,6DAA2C;AAC3C,8DAA4C;AAC5C,0DAAwC;AACxC,uDAAqC;AACrC,2DAAyC;AACzC,2DAAyC;AACzC,0DAAwC;AACxC,6DAA2C;AAC3C,qEAAmD;AACnD,4EAA0D;AAC1D,gEAA8C;AAC9C,mEAAiD;AACjD,yDAAuC;AACvC,yDAAuC"}

package/script/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC"}

package/script/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;;;;;;;;;;;;;;;AAEH,6CAA2B;AAC3B,qDAAmC;AACnC,2DAAyC;AACzC,uDAAqC;AACrC,+DAA6C"}

package/script/signing/_abstractWallet.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Abstract wallet interfaces and signing utilities for EIP-712 typed data.
+ * @module
+ */
+import { HyperliquidError } from "../_base.js";
+/** Common domain type for EIP-712 typed data signing. */
+interface TypedDataDomain {
+    name: string;
+    version: string;
+    chainId: number;
+    verifyingContract: `0x${string}`;
+}
+/** Common types structure for EIP-712 typed data. */
+interface TypedDataTypes {
+    [key: string]: {
+        name: string;
+        type: string;
+    }[];
+}
+/** Abstract interface for an {@link https://docs.ethers.org/v6/api/providers/#Signer | ethers.js v6}. */
+export interface AbstractEthersV6Signer {
+    signTypedData(domain: TypedDataDomain, types: TypedDataTypes, value: Record<string, unknown>): Promise<string>;
+    getAddress(): Promise<string>;
+    provider?: {
+        getNetwork(): Promise<{
+            chainId: number | bigint;
+        }>;
+    } | null;
+}
+/** Abstract interface for an {@link https://docs.ethers.org/v5/api/signer/ | ethers.js v5}. */
+export interface AbstractEthersV5Signer {
+    _signTypedData(domain: TypedDataDomain, types: TypedDataTypes, value: Record<string, unknown>): Promise<string>;
+    getAddress(): Promise<string>;
+    provider?: {
+        getNetwork(): Promise<{
+            chainId: number | bigint;
+        }>;
+    } | null;
+}
+/** Viem-style typed data parameters. */
+interface ViemTypedDataParams {
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: `0x${string}`;
+    };
+    types: TypedDataTypes;
+    primaryType: string;
+    message: Record<string, unknown>;
+}
+/** Abstract interface for a {@link https://viem.sh/docs/accounts/jsonRpc#json-rpc-account | viem JSON-RPC Account}. */
+export interface AbstractViemJsonRpcAccount {
+    signTypedData(params: ViemTypedDataParams, options?: unknown): Promise<`0x${string}`>;
+    getAddresses(): Promise<`0x${string}`[]>;
+    getChainId(): Promise<number>;
+}
+/** Abstract interface for a {@link https://viem.sh/docs/accounts/local | viem Local Account}. */
+export interface AbstractViemLocalAccount {
+    signTypedData(params: ViemTypedDataParams, options?: unknown): Promise<`0x${string}`>;
+    address: `0x${string}`;
+}
+/** Abstract interface for a wallet that can sign typed data. */
+export type AbstractWallet = AbstractViemJsonRpcAccount | AbstractViemLocalAccount | AbstractEthersV6Signer | AbstractEthersV5Signer;
+/** ECDSA signature components. */
+export interface Signature {
+    /** First 32-byte component of ECDSA signature. */
+    r: `0x${string}`;
+    /** Second 32-byte component of ECDSA signature. */
+    s: `0x${string}`;
+    /** Recovery identifier. */
+    v: 27 | 28;
+}
+/** Thrown when an error occurs in AbstractWallet operations (e.g., signing, getting address). */
+export declare class AbstractWalletError extends HyperliquidError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Signs EIP-712 typed data using the provided wallet.
+ *
+ * @param args The wallet, domain, types, primary type, and message to sign
+ * @return The ECDSA signature components
+ *
+ * @throws {AbstractWalletError} If the wallet type is unknown or signing fails
+ */
+export declare function signTypedData(args: {
+    wallet: AbstractWallet;
+    domain: TypedDataDomain;
+    types: TypedDataTypes;
+    primaryType: string;
+    message: Record<string, unknown>;
+}): Promise<Signature>;
+/**
+ * Gets the chain ID of the wallet.
+ *
+ * @param wallet The wallet to query
+ * @return The chain ID as a hex string
+ *
+ * @throws {AbstractWalletError} If getting the chain ID fails
+ */
+export declare function getWalletChainId(wallet: AbstractWallet): Promise<`0x${string}`>;
+/**
+ * Gets the lowercase wallet address from various wallet types.
+ *
+ * @param wallet The wallet to query
+ * @return The lowercase wallet address as a hex string
+ *
+ * @throws {AbstractWalletError} If getting the address fails or wallet type is unknown
+ */
+export declare function getWalletAddress(wallet: AbstractWallet): Promise<`0x${string}`>;
+export {};
+//# sourceMappingURL=_abstractWallet.d.ts.map

package/script/signing/_abstractWallet.d.ts.map

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

package/script/signing/_abstractWallet.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * Abstract wallet interfaces and signing utilities for EIP-712 typed data.
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractWalletError = void 0;
+exports.signTypedData = signTypedData;
+exports.getWalletChainId = getWalletChainId;
+exports.getWalletAddress = getWalletAddress;
+const _base_js_1 = require("../_base.js");
+function isEthersV6Signer(wallet) {
+    return "signTypedData" in wallet && typeof wallet.signTypedData === "function" &&
+        wallet.signTypedData.length === 3 &&
+        "getAddress" in wallet && typeof wallet.getAddress === "function";
+}
+function isEthersV5Signer(wallet) {
+    return "_signTypedData" in wallet && typeof wallet._signTypedData === "function" &&
+        wallet._signTypedData.length === 3 &&
+        "getAddress" in wallet && typeof wallet.getAddress === "function";
+}
+function isViemJsonRpcAccount(wallet) {
+    return "signTypedData" in wallet && typeof wallet.signTypedData === "function" &&
+        (wallet.signTypedData.length === 1 || wallet.signTypedData.length === 2) &&
+        "getAddresses" in wallet && typeof wallet.getAddresses === "function" &&
+        "getChainId" in wallet && typeof wallet.getChainId === "function";
+}
+function isViemLocalAccount(wallet) {
+    return "signTypedData" in wallet && typeof wallet.signTypedData === "function" &&
+        (wallet.signTypedData.length === 1 || wallet.signTypedData.length === 2) &&
+        "address" in wallet && typeof wallet.address === "string";
+}
+/** Thrown when an error occurs in AbstractWallet operations (e.g., signing, getting address). */
+class AbstractWalletError extends _base_js_1.HyperliquidError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "AbstractWalletError";
+    }
+}
+exports.AbstractWalletError = AbstractWalletError;
+/**
+ * Signs EIP-712 typed data using the provided wallet.
+ *
+ * @param args The wallet, domain, types, primary type, and message to sign
+ * @return The ECDSA signature components
+ *
+ * @throws {AbstractWalletError} If the wallet type is unknown or signing fails
+ */
+async function signTypedData(args) {
+    const { wallet, domain, types, primaryType, message } = args;
+    const isViemWallet = isViemJsonRpcAccount(wallet) || isViemLocalAccount(wallet);
+    const isEthersV6 = isEthersV6Signer(wallet);
+    const isEthersV5 = isEthersV5Signer(wallet);
+    let signature;
+    try {
+        if (isViemWallet) {
+            signature = await wallet.signTypedData({
+                domain,
+                types: {
+                    EIP712Domain: [
+                        { name: "name", type: "string" },
+                        { name: "version", type: "string" },
+                        { name: "chainId", type: "uint256" },
+                        { name: "verifyingContract", type: "address" },
+                    ],
+                    ...types,
+                },
+                primaryType,
+                message,
+            });
+        }
+        else if (isEthersV6) {
+            signature = await wallet.signTypedData(domain, types, message);
+        }
+        else if (isEthersV5) {
+            signature = await wallet._signTypedData(domain, types, message);
+        }
+        else {
+            throw new AbstractWalletError("Failed to sign typed data: unknown wallet type");
+        }
+    }
+    catch (error) {
+        if (error instanceof AbstractWalletError)
+            throw error;
+        const walletType = isViemWallet ? "viem" : isEthersV6 ? "ethers v6" : "ethers v5";
+        throw new AbstractWalletError(`Failed to sign typed data with ${walletType} wallet`, { cause: error });
+    }
+    return splitSignature(signature);
+}
+function splitSignature(signature) {
+    const r = `0x${signature.slice(2, 66)}`;
+    const s = `0x${signature.slice(66, 130)}`;
+    const v = parseInt(signature.slice(130, 132), 16);
+    return { r, s, v };
+}
+// ============================================================
+// Helpers
+// ============================================================
+/**
+ * Gets the chain ID of the wallet.
+ *
+ * @param wallet The wallet to query
+ * @return The chain ID as a hex string
+ *
+ * @throws {AbstractWalletError} If getting the chain ID fails
+ */
+async function getWalletChainId(wallet) {
+    try {
+        // Viem JSON-RPC account has getChainId method
+        if (isViemJsonRpcAccount(wallet)) {
+            const chainId = await wallet.getChainId();
+            return `0x${chainId.toString(16)}`;
+        }
+        // Ethers signers use provider.getNetwork()
+        const isEthersSigner = isEthersV6Signer(wallet) || isEthersV5Signer(wallet);
+        if (isEthersSigner && wallet.provider) {
+            const network = await wallet.provider.getNetwork();
+            return `0x${network.chainId.toString(16)}`;
+        }
+    }
+    catch (error) {
+        throw new AbstractWalletError("Failed to get chain ID from wallet", { cause: error });
+    }
+    // Default chain ID for local accounts or signers without provider
+    return "0x1";
+}
+/**
+ * Gets the lowercase wallet address from various wallet types.
+ *
+ * @param wallet The wallet to query
+ * @return The lowercase wallet address as a hex string
+ *
+ * @throws {AbstractWalletError} If getting the address fails or wallet type is unknown
+ */
+async function getWalletAddress(wallet) {
+    try {
+        // Viem JSON-RPC account uses getAddresses()
+        if (isViemJsonRpcAccount(wallet)) {
+            const addresses = await wallet.getAddresses();
+            return addresses[0].toLowerCase();
+        }
+        // Viem local account has address property
+        if (isViemLocalAccount(wallet)) {
+            return wallet.address.toLowerCase();
+        }
+        // Ethers signers use getAddress()
+        if (isEthersV6Signer(wallet) || isEthersV5Signer(wallet)) {
+            const address = await wallet.getAddress();
+            return address.toLowerCase();
+        }
+    }
+    catch (error) {
+        throw new AbstractWalletError("Failed to get address from wallet", { cause: error });
+    }
+    throw new AbstractWalletError("Failed to get wallet address: unknown wallet type");
+}
+//# sourceMappingURL=_abstractWallet.js.map

package/script/signing/_abstractWallet.js.map

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

package/script/signing/mod.d.ts

@@ -0,0 +1,300 @@
+/**
+ * Low-level utilities for signing Hyperliquid transactions.
+ *
+ * @example Signing an L1 action
+ * ```ts
+ * import { signL1Action } from "@nktkas/hyperliquid/signing";
+ * import { CancelRequest } from "@nktkas/hyperliquid/api/exchange";
+ * import * as v from "npm:valibot";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ *
+ * const action = v.parse(CancelRequest.entries.action, { // not required, but for correct generation
+ *   type: "cancel",
+ *   cancels: [
+ *     { a: 0, o: 12345 },
+ *   ],
+ * });
+ * const nonce = Date.now();
+ *
+ * const signature = await signL1Action({ wallet, action, nonce });
+ *
+ * // Send the signed action to the Hyperliquid API
+ * const response = await fetch("https://api.hyperliquid.xyz/exchange", {
+ *   method: "POST",
+ *   headers: { "Content-Type": "application/json" },
+ *   body: JSON.stringify({ action, signature, nonce }),
+ * });
+ * const body = await response.json();
+ * ```
+ *
+ * @example Signing a user-signed action
+ * ```ts
+ * import { signUserSignedAction } from "@nktkas/hyperliquid/signing";
+ * import { ApproveAgentRequest, ApproveAgentTypes } from "@nktkas/hyperliquid/api/exchange";
+ * import * as v from "npm:valibot";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ *
+ * const action = v.parse(ApproveAgentRequest.entries.action, { // not required, but for correct generation
+ *   type: "approveAgent",
+ *   signatureChainId: "0x66eee",
+ *   hyperliquidChain: "Mainnet",
+ *   agentAddress: "0x...",
+ *   agentName: "Agent",
+ *   nonce: Date.now(),
+ * });
+ *
+ * const signature = await signUserSignedAction({ wallet, action, types: ApproveAgentTypes });
+ *
+ * // Send the signed action to the Hyperliquid API
+ * const response = await fetch("https://api.hyperliquid.xyz/exchange", {
+ *   method: "POST",
+ *   headers: { "Content-Type": "application/json" },
+ *   body: JSON.stringify({ action, signature, nonce: action.nonce }),
+ * });
+ * const body = await response.json();
+ * ```
+ *
+ * @module
+ */
+import { type AbstractWallet, type Signature } from "./_abstractWallet.js";
+export { type AbstractEthersV5Signer, type AbstractEthersV6Signer, type AbstractViemJsonRpcAccount, type AbstractViemLocalAccount, type AbstractWallet, AbstractWalletError, getWalletAddress, getWalletChainId, type Signature, } from "./_abstractWallet.js";
+/**
+ * Creates a hash of the L1 action.
+ *
+ * @param args The action and metadata to hash
+ * @return The keccak256 hash as a hex string
+ *
+ * @example
+ * ```ts
+ * import { createL1ActionHash } from "@nktkas/hyperliquid/signing";
+ * import { CancelRequest } from "@nktkas/hyperliquid/api/exchange";
+ * import * as v from "npm:valibot";
+ *
+ * const action = v.parse(CancelRequest.entries.action, { // not required, but for correct generation
+ *   type: "cancel",
+ *   cancels: [
+ *     { a: 0, o: 12345 },
+ *   ],
+ * });
+ * const nonce = Date.now();
+ *
+ * const actionHash = createL1ActionHash({ action, nonce });
+ * ```
+ */
+export declare function createL1ActionHash(args: {
+    /** The action to be hashed (hash depends on key order). */
+    action: Record<string, unknown> | unknown[];
+    /** The current timestamp in ms. */
+    nonce: number;
+    /** Optional vault address used in the action. */
+    vaultAddress?: `0x${string}`;
+    /** Optional expiration time of the action in ms since the epoch. */
+    expiresAfter?: number;
+}): `0x${string}`;
+/**
+ * Signs an L1 action.
+ *
+ * @param args The wallet, action, and signing parameters
+ * @return The ECDSA signature components
+ *
+ * @throws {AbstractWalletError} If signing fails
+ *
+ * @example
+ * ```ts
+ * import { signL1Action } from "@nktkas/hyperliquid/signing";
+ * import { CancelRequest } from "@nktkas/hyperliquid/api/exchange";
+ * import * as v from "npm:valibot";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ *
+ * const action = v.parse(CancelRequest.entries.action, { // not required, but for correct generation
+ *   type: "cancel",
+ *   cancels: [
+ *     { a: 0, o: 12345 },
+ *   ],
+ * });
+ * const nonce = Date.now();
+ *
+ * const signature = await signL1Action({ wallet, action, nonce });
+ *
+ * // Send the signed action to the Hyperliquid API
+ * const response = await fetch("https://api.hyperliquid.xyz/exchange", {
+ *   method: "POST",
+ *   headers: { "Content-Type": "application/json" },
+ *   body: JSON.stringify({ action, signature, nonce }),
+ * });
+ * const body = await response.json();
+ * ```
+ */
+export declare function signL1Action(args: {
+    /** Wallet to sign the action. */
+    wallet: AbstractWallet;
+    /** The action to be signed (hash depends on key order). */
+    action: Record<string, unknown> | unknown[];
+    /** The current timestamp in ms. */
+    nonce: number;
+    /**
+     * Indicates if the action is for the testnet.
+     *
+     * Default: `false`
+     */
+    isTestnet?: boolean;
+    /** Optional vault address used in the action. */
+    vaultAddress?: `0x${string}`;
+    /** Optional expiration time of the action in ms since the epoch. */
+    expiresAfter?: number;
+}): Promise<Signature>;
+/**
+ * Signs a user-signed action.
+ *
+ * @param args The wallet, action, and EIP-712 types
+ * @return The ECDSA signature components
+ *
+ * @throws {AbstractWalletError} If signing fails
+ *
+ * @example
+ * ```ts
+ * import { signUserSignedAction } from "@nktkas/hyperliquid/signing";
+ * import { ApproveAgentRequest, ApproveAgentTypes } from "@nktkas/hyperliquid/api/exchange";
+ * import * as v from "npm:valibot";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ *
+ * const action = v.parse(ApproveAgentRequest.entries.action, { // not required, but for correct generation
+ *   type: "approveAgent",
+ *   signatureChainId: "0x66eee",
+ *   hyperliquidChain: "Mainnet",
+ *   agentAddress: "0x...",
+ *   agentName: "Agent",
+ *   nonce: Date.now(),
+ * });
+ *
+ * const signature = await signUserSignedAction({ wallet, action, types: ApproveAgentTypes });
+ *
+ * // Send the signed action to the Hyperliquid API
+ * const response = await fetch("https://api.hyperliquid.xyz/exchange", {
+ *   method: "POST",
+ *   headers: { "Content-Type": "application/json" },
+ *   body: JSON.stringify({ action, signature, nonce: action.nonce }),
+ * });
+ * const body = await response.json();
+ * ```
+ */
+export declare function signUserSignedAction(args: {
+    /** Wallet to sign the action. */
+    wallet: AbstractWallet;
+    /** The action to be signed (hex strings must be in lower case). */
+    action: {
+        signatureChainId: `0x${string}`;
+        [key: string]: unknown;
+    } & ({
+        payloadMultiSigUser: `0x${string}`;
+        outerSigner: `0x${string}`;
+    } | {
+        payloadMultiSigUser?: undefined;
+        outerSigner?: undefined;
+    });
+    /** The types of the action (hash depends on key order). */
+    types: {
+        [key: string]: {
+            name: string;
+            type: string;
+        }[];
+    };
+}): Promise<Signature>;
+/**
+ * Signs a multi-signature action.
+ *
+ * @param args The wallet, action, and signing parameters
+ * @return The ECDSA signature components
+ *
+ * @throws {AbstractWalletError} If signing fails
+ *
+ * @example
+ * ```ts
+ * import { signL1Action, signMultiSigAction } from "@nktkas/hyperliquid/signing";
+ * import { ScheduleCancelRequest } from "@nktkas/hyperliquid/api/exchange";
+ * import * as v from "npm:valibot";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const multiSigUser = "0x...";
+ *
+ * const nonce = Date.now();
+ * const action = v.parse(ScheduleCancelRequest.entries.action, { // not required, but for correct generation
+ *   type: "scheduleCancel",
+ *   time: Date.now() + 10000,
+ * });
+ *
+ * // Create the required number of signatures
+ * const signatures = await Promise.all(["0x...", "0x..."].map(async (signerPrivKey) => {
+ *   return await signL1Action({
+ *     wallet: privateKeyToAccount(signerPrivKey as `0x${string}`), // viem or ethers
+ *     action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), action],
+ *     nonce,
+ *   });
+ * }));
+ *
+ * // // or user-signed action
+ * // const signatures = await Promise.all(["0x...", "0x..."].map(async (signerPrivKey) => {
+ * //   return await signUserSignedAction({
+ * //     wallet: privateKeyToAccount(signerPrivKey as `0x${string}`), // viem or ethers
+ * //     action: {
+ * //       ...action,
+ * //       payloadMultiSigUser: multiSigUser,
+ * //       outerSigner: wallet.address,
+ * //     },
+ * //     types: SomeTypes,
+ * //   });
+ * // }));
+ *
+ * // Then use signatures in the multi-sig action
+ * const multiSigAction = {
+ *   type: "multiSig",
+ *   signatureChainId: "0x66eee" as const,
+ *   signatures,
+ *   payload: {
+ *     multiSigUser,
+ *     outerSigner: wallet.address,
+ *     action,
+ *   },
+ * };
+ * const multiSigSignature = await signMultiSigAction({ wallet, action: multiSigAction, nonce });
+ *
+ * // Send the multi-sig action to the Hyperliquid API
+ * const response = await fetch("https://api.hyperliquid.xyz/exchange", {
+ *   method: "POST",
+ *   headers: { "Content-Type": "application/json" },
+ *   body: JSON.stringify({ action: multiSigAction, signature: multiSigSignature, nonce }),
+ * });
+ * const body = await response.json();
+ * ```
+ */
+export declare function signMultiSigAction(args: {
+    /** Wallet to sign the action. */
+    wallet: AbstractWallet;
+    /** The action to be signed (hash depends on key order). */
+    action: {
+        signatureChainId: `0x${string}`;
+        [key: string]: unknown;
+    };
+    /** The current timestamp in ms. */
+    nonce: number;
+    /**
+     * Indicates if the action is for the testnet.
+     *
+     * Default: `false`
+     */
+    isTestnet?: boolean;
+    /** Optional vault address used in the action. */
+    vaultAddress?: `0x${string}`;
+    /** Optional expiration time of the action in ms since the epoch. */
+    expiresAfter?: number;
+}): Promise<Signature>;
+//# sourceMappingURL=mod.d.ts.map

package/script/signing/mod.d.ts.map

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