@nktkas/hyperliquid 0.23.1 → 0.24.1

package/esm/src/signing/_sorter.js

@@ -6,7 +6,7 @@ export const actionSorter = {
             signatureChainId: action.signatureChainId,
             hyperliquidChain: action.hyperliquidChain,
             agentAddress: action.agentAddress.toLowerCase(),
-            agentName: action.agentName ?? "",
+            agentName: action.agentName,
             nonce: action.nonce,
         };
     },
@@ -91,7 +91,10 @@ export const actionSorter = {
             type: action.type,
             signatureChainId: action.signatureChainId,
             hyperliquidChain: action.hyperliquidChain,
-            signers: action.signers, // key order is not important
+            signers: typeof action.signers === "string" ? action.signers : JSON.stringify(action.signers === null ? action.signers : {
+                authorizedUsers: action.signers.authorizedUsers,
+                threshold: action.signers.threshold,
+            }),
             nonce: action.nonce,
         };
     },
@@ -129,13 +132,13 @@ export const actionSorter = {
             return {
                 type: action.type,
                 changeProfile: {
-                    node_ip: action.changeProfile.node_ip ?? null,
-                    name: action.changeProfile.name ?? null,
-                    description: action.changeProfile.description ?? null,
+                    node_ip: action.changeProfile.node_ip,
+                    name: action.changeProfile.name,
+                    description: action.changeProfile.description,
                     unjailed: action.changeProfile.unjailed,
-                    disable_delegations: action.changeProfile.disable_delegations ?? null,
-                    commission_bps: action.changeProfile.commission_bps ?? null,
-                    signer: action.changeProfile.signer?.toLowerCase() ?? null,
+                    disable_delegations: action.changeProfile.disable_delegations,
+                    commission_bps: action.changeProfile.commission_bps,
+                    signer: action.changeProfile.signer?.toLowerCase(),
                 },
             };
         }
@@ -158,7 +161,7 @@ export const actionSorter = {
                 },
             };
         }
-        else { // "unregister" in action
+        else {
             return {
                 type: action.type,
                 unregister: action.unregister,
@@ -222,10 +225,17 @@ export const actionSorter = {
             payload: {
                 multiSigUser: action.payload.multiSigUser.toLowerCase(),
                 outerSigner: action.payload.outerSigner.toLowerCase(),
-                action: structuredClone(action.payload.action),
+                action: actionSorter[action.payload.action.type](
+                // @ts-ignore - TypeScript cannot infer the type correctly
+                action.payload.action),
             },
         };
     },
+    noop: (action) => {
+        return {
+            type: action.type,
+        };
+    },
     order: (action) => {
         const sortedAction = {
             type: action.type,
@@ -272,7 +282,7 @@ export const actionSorter = {
             return {
                 type: action.type,
                 registerAsset: {
-                    maxGas: action.registerAsset.maxGas ?? null,
+                    maxGas: action.registerAsset.maxGas,
                     assetRequest: {
                         coin: action.registerAsset.assetRequest.coin,
                         szDecimals: action.registerAsset.assetRequest.szDecimals,
@@ -285,9 +295,9 @@ export const actionSorter = {
                         ? {
                             fullName: action.registerAsset.schema.fullName,
                             collateralToken: action.registerAsset.schema.collateralToken,
-                            oracleUpdater: action.registerAsset.schema.oracleUpdater?.toLowerCase() ?? null,
+                            oracleUpdater: action.registerAsset.schema.oracleUpdater?.toLowerCase(),
                         }
-                        : null,
+                        : action.registerAsset.schema,
                 },
             };
         }
@@ -297,34 +307,11 @@ export const actionSorter = {
                 setOracle: {
                     dex: action.setOracle.dex,
                     oraclePxs: action.setOracle.oraclePxs.map((el) => [...el]),
-                    markPxs: action.setOracle.markPxs.map((el) => [...el]),
+                    markPxs: action.setOracle.markPxs.map((el) => el.map((el2) => [...el2])),
                 },
             };
         }
     },
-    PerpDexClassTransfer: (action) => {
-        return {
-            type: action.type,
-            signatureChainId: action.signatureChainId,
-            hyperliquidChain: action.hyperliquidChain,
-            dex: action.dex,
-            token: action.token,
-            amount: action.amount,
-            toPerp: action.toPerp,
-            nonce: action.nonce,
-        };
-    },
-    PerpDexTransfer: (action) => {
-        return {
-            type: action.type,
-            signatureChainId: action.signatureChainId,
-            hyperliquidChain: action.hyperliquidChain,
-            sourceDex: action.sourceDex,
-            destinationDex: action.destinationDex,
-            amount: action.amount,
-            nonce: action.nonce,
-        };
-    },
     registerReferrer: (action) => {
         return {
             type: action.type,
@@ -346,6 +333,20 @@ export const actionSorter = {
             delete sortedAction.time;
         return sortedAction;
     },
+    sendAsset: (action) => {
+        return {
+            type: action.type,
+            signatureChainId: action.signatureChainId,
+            hyperliquidChain: action.hyperliquidChain,
+            destination: action.destination.toLowerCase(),
+            sourceDex: action.sourceDex,
+            destinationDex: action.destinationDex,
+            token: action.token,
+            amount: action.amount,
+            fromSubAccount: action.fromSubAccount.toLowerCase(),
+            nonce: action.nonce,
+        };
+    },
     setDisplayName: (action) => {
         return {
             type: action.type,
@@ -368,9 +369,8 @@ export const actionSorter = {
                     noHyperliquidity: action.genesis.noHyperliquidity,
                 },
             };
-            if (sortedAction.genesis.noHyperliquidity === undefined) {
+            if (sortedAction.genesis.noHyperliquidity === undefined)
                 delete sortedAction.genesis.noHyperliquidity;
-            }
             return sortedAction;
         }
         else if ("registerHyperliquidity" in action) {
@@ -410,9 +410,8 @@ export const actionSorter = {
                     fullName: action.registerToken2.fullName,
                 },
             };
-            if (sortedAction.registerToken2.fullName === undefined) {
+            if (sortedAction.registerToken2.fullName === undefined)
                 delete sortedAction.registerToken2.fullName;
-            }
             return sortedAction;
         }
         else if ("setDeployerTradingFeeShare" in action) {
@@ -424,7 +423,7 @@ export const actionSorter = {
                 },
             };
         }
-        else { // "userGenesis" in action
+        else {
             const sortedAction = {
                 type: action.type,
                 userGenesis: {
@@ -434,9 +433,8 @@ export const actionSorter = {
                     blacklistUsers: action.userGenesis.blacklistUsers?.map((el) => [...el]),
                 },
             };
-            if (sortedAction.userGenesis.blacklistUsers === undefined) {
+            if (sortedAction.userGenesis.blacklistUsers === undefined)
                 delete sortedAction.userGenesis.blacklistUsers;
-            }
             return sortedAction;
         }
     },
@@ -459,6 +457,13 @@ export const actionSorter = {
             },
         };
     },
+    subAccountModify: (action) => {
+        return {
+            type: action.type,
+            subAccountUser: action.subAccountUser.toLowerCase(),
+            name: action.name,
+        };
+    },
     subAccountSpotTransfer: (action) => {
         return {
             type: action.type,
@@ -624,29 +629,22 @@ export const userSignedActionEip712Types = {
             { name: "nonce", type: "uint64" },
         ],
     },
-    PerpDexClassTransfer: {
-        "HyperliquidTransaction:PerpDexClassTransfer": [
+    multiSig: {
+        "HyperliquidTransaction:SendMultiSig": [
             { name: "hyperliquidChain", type: "string" },
-            { name: "dex", type: "string" },
-            { name: "token", type: "string" },
-            { name: "amount", type: "string" },
-            { name: "toPerp", type: "bool" },
+            { name: "multiSigActionHash", type: "bytes32" },
             { name: "nonce", type: "uint64" },
         ],
     },
-    PerpDexTransfer: {
-        "HyperliquidTransaction:PerpDexTransfer": [
+    sendAsset: {
+        "HyperliquidTransaction:SendAsset": [
             { name: "hyperliquidChain", type: "string" },
+            { name: "destination", type: "string" },
             { name: "sourceDex", type: "string" },
             { name: "destinationDex", type: "string" },
+            { name: "token", type: "string" },
             { name: "amount", type: "string" },
-            { name: "nonce", type: "uint64" },
-        ],
-    },
-    multiSig: {
-        "HyperliquidTransaction:SendMultiSig": [
-            { name: "hyperliquidChain", type: "string" },
-            { name: "multiSigActionHash", type: "bytes32" },
+            { name: "fromSubAccount", type: "string" },
             { name: "nonce", type: "uint64" },
         ],
     },

package/esm/src/signing/mod.d.ts

@@ -6,108 +6,135 @@
  * ```ts
  * import { actionSorter, signL1Action } from "@nktkas/hyperliquid/signing";
  *
- * const privateKey = "0x..."; // or `viem`, `ethers`
+ * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
  *
+ * const action = actionSorter.cancel({
+ *   type: "cancel",
+ *   cancels: [
+ *     { a: 0, o: 12345 },
+ *   ],
+ * });
  * const nonce = Date.now();
- * const action = {
- *     type: "cancel",
- *     cancels: [
- *         { a: 0, o: 12345 },
- *     ],
- * } as const;
- *
- * const signature = await signL1Action({
- *     wallet: privateKey,
- *     action: actionSorter[action.type](action),
- *     nonce,
+ *
+ * const signature = await signL1Action({ wallet: privateKey, 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 }), // recommended to send the same formatted action
  * });
+ * const body = await response.json();
  * ```
  *
  * @example Signing a user-signed action
  * ```ts
- * import { signUserSignedAction, userSignedActionEip712Types } from "@nktkas/hyperliquid/signing";
+ * import { actionSorter, signUserSignedAction, userSignedActionEip712Types } from "@nktkas/hyperliquid/signing";
  *
- * const privateKey = "0x..."; // or `viem`, `ethers`
+ * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
  *
- * const action = {
- *     type: "approveAgent",
- *     signatureChainId: "0x66eee",
- *     hyperliquidChain: "Mainnet",
- *     agentAddress: "0x...",
- *     agentName: "Agent",
- *     nonce: Date.now(),
- * } as const;
+ * const action = actionSorter.approveAgent({
+ *   type: "approveAgent",
+ *   signatureChainId: "0x66eee",
+ *   hyperliquidChain: "Mainnet",
+ *   agentAddress: "0x...",
+ *   agentName: "Agent",
+ *   nonce: Date.now(),
+ * });
  *
  * const signature = await signUserSignedAction({
- *     wallet: privateKey,
- *     action,
- *     types: userSignedActionEip712Types[action.type],
+ *   wallet: privateKey,
+ *   action,
+ *   types: userSignedActionEip712Types[action.type],
+ * });
+ *
+ * // 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 }), // recommended to send the same formatted action
  * });
+ * const body = await response.json();
  * ```
  *
  * @example Signing a multi-signature action
  * ```ts
  * import { actionSorter, signL1Action, signMultiSigAction } from "@nktkas/hyperliquid/signing";
- * import { privateKeyToAccount } from "viem/accounts";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
  *
- * const wallet = privateKeyToAccount("0x..."); // or `ethers`, private key with address
+ * const wallet = privateKeyToAccount("0x..."); // or `ethers`, private key directly
  * const multiSigUser = "0x...";
  *
+ * const action = actionSorter.scheduleCancel({
+ *   type: "scheduleCancel",
+ *   time: Date.now() + 10000,
+ * });
  * const nonce = Date.now();
- * const action = {
- *     type: "scheduleCancel",
- *     time: Date.now() + 10000,
- * } as const;
- *
- * // First, create the required number of signatures
- * const signature = await signL1Action({
- *     wallet,
- *     action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), actionSorter[action.type](action)],
+ *
+ * // Create the required number of signatures
+ * const signatures = await Promise.all(["0x...", "0x..."].map(async (signerPrivKey) => {
+ *   return await signL1Action({
+ *     wallet: signerPrivKey as `0x${string}`,
+ *     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: signerPrivKey as `0x${string}`,
+ * //     action: {
+ * //       ...action,
+ * //       payloadMultiSigUser: multiSigUser,
+ * //       outerSigner: wallet.address,
+ * //     },
+ * //     types: userSignedActionEip712Types[action.type],
+ * //   });
+ * // }));
  *
  * // Then use signatures in the multi-sig action
- * const multiSigSignature = await signMultiSigAction({
- *     wallet,
- *     action: {
- *         signatureChainId: "0x66eee",
- *         signatures: [signature],
- *         payload: {
- *             multiSigUser,
- *             outerSigner: wallet.address,
- *             action,
- *         },
- *     },
- *     nonce,
+ * const multiSigAction = actionSorter.multiSig({
+ *   type: "multiSig",
+ *   signatureChainId: "0x66eee",
+ *   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 }), // recommended to send the same formatted action
  * });
+ * const body = await response.json();
  * ```
  *
  * @module
  */
-import type { Hex } from "../base.js";
-import { type AbstractEthersSigner, type AbstractEthersV5Signer, type AbstractViemWalletClient, type AbstractWallet, type AbstractWindowEthereum, isAbstractEthersSigner, isAbstractEthersV5Signer, isAbstractViemWalletClient, isAbstractWindowEthereum, isValidPrivateKey, type Signature } from "./_signTypedData/mod.js";
-export { type AbstractEthersSigner, type AbstractEthersV5Signer, type AbstractViemWalletClient, type AbstractWallet, type AbstractWindowEthereum, type Hex, isAbstractEthersSigner, isAbstractEthersV5Signer, isAbstractViemWalletClient, isAbstractWindowEthereum, isValidPrivateKey, type Signature, };
-export * from "./_sorter.js";
+import { type AbstractWallet, getWalletAddress, getWalletChainId, type Signature } from "./_signTypedData/mod.js";
+import { actionSorter, userSignedActionEip712Types } from "./_sorter.js";
+export { type AbstractWallet, actionSorter, getWalletAddress, getWalletChainId, type Signature, userSignedActionEip712Types, };
 /**
  * Create a hash of the L1 action.
  * @example
  * ```ts
  * import { actionSorter, createL1ActionHash } from "@nktkas/hyperliquid/signing";
  *
- * const action = {
- *     type: "cancel",
- *     cancels: [
- *         { a: 0, o: 12345 },
- *     ],
- * } as const;
+ * const action = actionSorter.cancel({
+ *   type: "cancel",
+ *   cancels: [
+ *     { a: 0, o: 12345 },
+ *   ],
+ * });
  * const nonce = Date.now();
  *
- * const actionHash = createL1ActionHash({
- *     action: actionSorter[action.type](action),
- *     nonce,
- *     vaultAddress: "0x...", // optional
- *     expiresAfter: Date.now() + 10_000, // optional
- * });
+ * const actionHash = createL1ActionHash({ action, nonce });
  * ```
  */
 export declare function createL1ActionHash(args: {
@@ -116,37 +143,33 @@ export declare function createL1ActionHash(args: {
     /** The current timestamp in ms. */
     nonce: number;
     /** Optional vault address used in the action. */
-    vaultAddress?: Hex;
+    vaultAddress?: `0x${string}`;
     /** Optional expiration time of the action in ms since the epoch. */
     expiresAfter?: number;
-}): Hex;
+}): `0x${string}`;
 /**
  * Sign an L1 action.
  * @example
  * ```ts
  * import { actionSorter, signL1Action } from "@nktkas/hyperliquid/signing";
  *
- * const privateKey = "0x..."; // or `viem`, `ethers`
+ * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
  *
- * const nonce = Date.now();
- * const action = {
- *     type: "cancel",
- *     cancels: [
- *         { a: 0, o: 12345 },
- *     ],
- * } as const;
- *
- * const signature = await signL1Action({
- *     wallet: privateKey,
- *     action: actionSorter[action.type](action),
- *     nonce,
+ * const action = actionSorter.cancel({
+ *   type: "cancel",
+ *   cancels: [
+ *     { a: 0, o: 12345 },
+ *   ],
  * });
+ * const nonce = Date.now();
+ *
+ * const signature = await signL1Action({ wallet: privateKey, 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 }),
+ *   method: "POST",
+ *   headers: { "Content-Type": "application/json" },
+ *   body: JSON.stringify({ action, signature, nonce }), // recommended to send the same formatted action
  * });
  * const body = await response.json();
  * ```
@@ -161,7 +184,7 @@ export declare function signL1Action(args: {
     /** Indicates if the action is for the testnet. (default: false) */
     isTestnet?: boolean;
     /** Optional vault address used in the action. */
-    vaultAddress?: Hex;
+    vaultAddress?: `0x${string}`;
     /** Optional expiration time of the action in ms since the epoch. */
     expiresAfter?: number;
 }): Promise<Signature>;
@@ -169,30 +192,30 @@ export declare function signL1Action(args: {
  * Sign a user-signed action.
  * @example
  * ```ts
- * import { signUserSignedAction, userSignedActionEip712Types } from "@nktkas/hyperliquid/signing";
+ * import { actionSorter, signUserSignedAction, userSignedActionEip712Types } from "@nktkas/hyperliquid/signing";
  *
- * const privateKey = "0x..."; // or `viem`, `ethers`
+ * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
  *
- * const action = {
- *     type: "approveAgent",
- *     signatureChainId: "0x66eee",
- *     hyperliquidChain: "Mainnet",
- *     agentAddress: "0x...",
- *     agentName: "Agent",
- *     nonce: Date.now(),
- * } as const;
+ * const action = actionSorter.approveAgent({
+ *   type: "approveAgent",
+ *   signatureChainId: "0x66eee",
+ *   hyperliquidChain: "Mainnet",
+ *   agentAddress: "0x...",
+ *   agentName: "Agent",
+ *   nonce: Date.now(),
+ * });
  *
  * const signature = await signUserSignedAction({
- *     wallet: privateKey,
- *     action,
- *     types: userSignedActionEip712Types[action.type],
+ *   wallet: privateKey,
+ *   action,
+ *   types: userSignedActionEip712Types[action.type],
  * });
  *
  * // 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 }),
+ *   method: "POST",
+ *   headers: { "Content-Type": "application/json" },
+ *   body: JSON.stringify({ action, signature, nonce: action.nonce }), // recommended to send the same formatted action
  * });
  * const body = await response.json();
  * ```
@@ -200,11 +223,17 @@ export declare function signL1Action(args: {
 export declare function signUserSignedAction(args: {
     /** Wallet to sign the action. */
     wallet: AbstractWallet;
-    /** The action to be signed. */
+    /** The action to be signed (hex strings must be in lower case). */
     action: {
-        signatureChainId: Hex;
+        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]: {
@@ -218,38 +247,59 @@ export declare function signUserSignedAction(args: {
  * @example
  * ```ts
  * import { actionSorter, signL1Action, signMultiSigAction } from "@nktkas/hyperliquid/signing";
- * import { privateKeyToAccount } from "viem/accounts";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
  *
- * const wallet = privateKeyToAccount("0x..."); // or `ethers`, private key with address
+ * const wallet = privateKeyToAccount("0x..."); // or ethers, private key directly
  * const multiSigUser = "0x...";
  *
+ * const action = actionSorter.scheduleCancel({
+ *   type: "scheduleCancel",
+ *   time: Date.now() + 10000,
+ * });
  * const nonce = Date.now();
- * const action = {
- *     type: "scheduleCancel",
- *     time: Date.now() + 10000,
- * } as const;
- *
- * // First, create the required number of signatures
- * const signature = await signL1Action({
- *     wallet,
- *     action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), actionSorter[action.type](action)],
+ *
+ * // Create the required number of signatures
+ * const signatures = await Promise.all(["0x...", "0x..."].map(async (signerPrivKey) => {
+ *   return await signL1Action({
+ *     wallet: signerPrivKey as `0x${string}`,
+ *     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: signerPrivKey as `0x${string}`,
+ * //     action: {
+ * //       ...action,
+ * //       payloadMultiSigUser: multiSigUser,
+ * //       outerSigner: wallet.address,
+ * //     },
+ * //     types: userSignedActionEip712Types[action.type],
+ * //   });
+ * // }));
  *
  * // Then use signatures in the multi-sig action
- * const multiSigSignature = await signMultiSigAction({
- *     wallet,
- *     action: {
- *         signatureChainId: "0x66eee",
- *         signatures: [signature],
- *         payload: {
- *             multiSigUser,
- *             outerSigner: wallet.address,
- *             action,
- *         },
- *     },
- *     nonce,
+ * const multiSigAction = actionSorter.multiSig({
+ *   type: "multiSig",
+ *   signatureChainId: "0x66eee",
+ *   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 }), // recommended to send the same formatted action
+ * });
+ * const body = await response.json();
  * ```
  */
 export declare function signMultiSigAction(args: {
@@ -257,7 +307,7 @@ export declare function signMultiSigAction(args: {
     wallet: AbstractWallet;
     /** The action to be signed (hash depends on key order). */
     action: {
-        signatureChainId: Hex;
+        signatureChainId: `0x${string}`;
         [key: string]: unknown;
     };
     /** The current timestamp in ms. */
@@ -265,7 +315,7 @@ export declare function signMultiSigAction(args: {
     /** Indicates if the action is for the testnet. (default: false) */
     isTestnet?: boolean;
     /** Optional vault address used in the action. */
-    vaultAddress?: Hex;
+    vaultAddress?: `0x${string}`;
     /** Optional expiration time of the action in ms since the epoch. */
     expiresAfter?: number;
 }): Promise<Signature>;