@hfunlabs/hyperliquid 0.29.1-hfunlabs.1 → 0.30.2-hfunlabs.2

package/src/src/api/exchange/_methods/userDexAbstraction.ts

@@ -4,15 +4,8 @@ import * as v from "valibot";
 // API Schemas
 // ============================================================
 
-import { Address } from "../../_schemas.js";
-import {
-  ErrorResponse,
-  HyperliquidChain,
-  Nonce,
-  Signature,
-  SignatureChainId,
-  SuccessResponse,
-} from "./_base/schemas.js";
+import { Address, Hex, UnsignedInteger } from "../../_schemas.js";
+import { ErrorResponse, HyperliquidChainSchema, SignatureSchema, SuccessResponse } from "./_base/commonSchemas.js";
 
 /**
  * Enable/disable HIP-3 DEX abstraction.
@@ -30,9 +23,15 @@ export const UserDexAbstractionRequest = /* @__PURE__ */ (() => {
             v.description("Type of action."),
           ),
           /** Chain ID in hex format for EIP-712 signing. */
-          signatureChainId: SignatureChainId,
+          signatureChainId: v.pipe(
+            Hex,
+            v.description("Chain ID in hex format for EIP-712 signing."),
+          ),
           /** HyperLiquid network type. */
-          hyperliquidChain: HyperliquidChain,
+          hyperliquidChain: v.pipe(
+            HyperliquidChainSchema,
+            v.description("HyperLiquid network type."),
+          ),
           /** User address. */
           user: v.pipe(
             Address,
@@ -44,14 +43,23 @@ export const UserDexAbstractionRequest = /* @__PURE__ */ (() => {
             v.description("Whether to enable or disable HIP-3 DEX abstraction."),
           ),
           /** Nonce (timestamp in ms) used to prevent replay attacks. */
-          nonce: Nonce,
+          nonce: v.pipe(
+            UnsignedInteger,
+            v.description("Nonce (timestamp in ms) used to prevent replay attacks."),
+          ),
         }),
         v.description("Action to perform."),
       ),
       /** Nonce (timestamp in ms) used to prevent replay attacks. */
-      nonce: Nonce,
+      nonce: v.pipe(
+        UnsignedInteger,
+        v.description("Nonce (timestamp in ms) used to prevent replay attacks."),
+      ),
       /** ECDSA signature components. */
-      signature: Signature,
+      signature: v.pipe(
+        SignatureSchema,
+        v.description("ECDSA signature components."),
+      ),
     }),
     v.description("Enable/disable HIP-3 DEX abstraction."),
   );

package/src/src/api/exchange/_methods/validatorL1Stream.ts

@@ -5,7 +5,7 @@ import * as v from "valibot";
 // ============================================================
 
 import { UnsignedDecimal, UnsignedInteger } from "../../_schemas.js";
-import { ErrorResponse, Nonce, Signature, SuccessResponse } from "./_base/schemas.js";
+import { ErrorResponse, SignatureSchema, SuccessResponse } from "./_base/commonSchemas.js";
 
 /**
  * Validator vote on risk-free rate for aligned quote asset.
@@ -31,9 +31,15 @@ export const ValidatorL1StreamRequest = /* @__PURE__ */ (() => {
         v.description("Action to perform."),
       ),
       /** Nonce (timestamp in ms) used to prevent replay attacks. */
-      nonce: Nonce,
+      nonce: v.pipe(
+        UnsignedInteger,
+        v.description("Nonce (timestamp in ms) used to prevent replay attacks."),
+      ),
       /** ECDSA signature components. */
-      signature: Signature,
+      signature: v.pipe(
+        SignatureSchema,
+        v.description("ECDSA signature components."),
+      ),
       /** Expiration time of the action. */
       expiresAfter: v.pipe(
         v.optional(UnsignedInteger),

package/src/src/api/exchange/_methods/vaultDistribute.ts

@@ -5,7 +5,7 @@ import * as v from "valibot";
 // ============================================================
 
 import { Address, UnsignedInteger } from "../../_schemas.js";
-import { ErrorResponse, Nonce, Signature, SuccessResponse } from "./_base/schemas.js";
+import { ErrorResponse, SignatureSchema, SuccessResponse } from "./_base/commonSchemas.js";
 
 /** Distribute funds from a vault between followers. */
 export const VaultDistributeRequest = /* @__PURE__ */ (() => {
@@ -26,23 +26,28 @@ export const VaultDistributeRequest = /* @__PURE__ */ (() => {
           ),
           /**
            * Amount to distribute (float * 1e6).
-           *
            * Set to 0 to close the vault.
            */
           usd: v.pipe(
             UnsignedInteger,
             v.description(
               "Amount to distribute (float * 1e6)." +
-                "\n\nSet to 0 to close the vault.",
+                "\nSet to 0 to close the vault.",
             ),
           ),
         }),
         v.description("Action to perform."),
       ),
       /** Nonce (timestamp in ms) used to prevent replay attacks. */
-      nonce: Nonce,
+      nonce: v.pipe(
+        UnsignedInteger,
+        v.description("Nonce (timestamp in ms) used to prevent replay attacks."),
+      ),
       /** ECDSA signature components. */
-      signature: Signature,
+      signature: v.pipe(
+        SignatureSchema,
+        v.description("ECDSA signature components."),
+      ),
       /** Expiration time of the action. */
       expiresAfter: v.pipe(
         v.optional(UnsignedInteger),

package/src/src/api/exchange/_methods/vaultModify.ts

@@ -5,7 +5,7 @@ import * as v from "valibot";
 // ============================================================
 
 import { Address, UnsignedInteger } from "../../_schemas.js";
-import { ErrorResponse, Nonce, Signature, SuccessResponse } from "./_base/schemas.js";
+import { ErrorResponse, SignatureSchema, SuccessResponse } from "./_base/commonSchemas.js";
 
 /** Modify a vault's configuration. */
 export const VaultModifyRequest = /* @__PURE__ */ (() => {
@@ -24,23 +24,29 @@ export const VaultModifyRequest = /* @__PURE__ */ (() => {
             Address,
             v.description("Vault address."),
           ),
-          /** Allow deposits from followers (default: null). */
+          /** Allow deposits from followers. */
           allowDeposits: v.pipe(
-            v.optional(v.nullable(v.boolean()), null),
+            v.nullish(v.boolean(), null),
             v.description("Allow deposits from followers."),
           ),
-          /** Always close positions on withdrawal (default: null). */
+          /** Always close positions on withdrawal. */
           alwaysCloseOnWithdraw: v.pipe(
-            v.optional(v.nullable(v.boolean()), null),
+            v.nullish(v.boolean(), null),
             v.description("Always close positions on withdrawal."),
           ),
         }),
         v.description("Action to perform."),
       ),
       /** Nonce (timestamp in ms) used to prevent replay attacks. */
-      nonce: Nonce,
+      nonce: v.pipe(
+        UnsignedInteger,
+        v.description("Nonce (timestamp in ms) used to prevent replay attacks."),
+      ),
       /** ECDSA signature components. */
-      signature: Signature,
+      signature: v.pipe(
+        SignatureSchema,
+        v.description("ECDSA signature components."),
+      ),
       /** Expiration time of the action. */
       expiresAfter: v.pipe(
         v.optional(UnsignedInteger),

package/src/src/api/exchange/_methods/vaultTransfer.ts

@@ -5,7 +5,7 @@ import * as v from "valibot";
 // ============================================================
 
 import { Address, UnsignedInteger } from "../../_schemas.js";
-import { ErrorResponse, Nonce, Signature, SuccessResponse } from "./_base/schemas.js";
+import { ErrorResponse, SignatureSchema, SuccessResponse } from "./_base/commonSchemas.js";
 
 /**
  * Deposit or withdraw from a vault.
@@ -35,15 +35,22 @@ export const VaultTransferRequest = /* @__PURE__ */ (() => {
           /** Amount for deposit/withdrawal (float * 1e6). */
           usd: v.pipe(
             UnsignedInteger,
+            v.minValue(1),
             v.description("Amount for deposit/withdrawal (float * 1e6)."),
           ),
         }),
         v.description("Action to perform."),
       ),
       /** Nonce (timestamp in ms) used to prevent replay attacks. */
-      nonce: Nonce,
+      nonce: v.pipe(
+        UnsignedInteger,
+        v.description("Nonce (timestamp in ms) used to prevent replay attacks."),
+      ),
       /** ECDSA signature components. */
-      signature: Signature,
+      signature: v.pipe(
+        SignatureSchema,
+        v.description("ECDSA signature components."),
+      ),
       /** Expiration time of the action. */
       expiresAfter: v.pipe(
         v.optional(UnsignedInteger),

package/src/src/api/exchange/_methods/withdraw3.ts

@@ -4,15 +4,8 @@ import * as v from "valibot";
 // API Schemas
 // ============================================================
 
-import { Address, UnsignedDecimal } from "../../_schemas.js";
-import {
-  ErrorResponse,
-  HyperliquidChain,
-  Nonce,
-  Signature,
-  SignatureChainId,
-  SuccessResponse,
-} from "./_base/schemas.js";
+import { Address, Hex, UnsignedDecimal, UnsignedInteger } from "../../_schemas.js";
+import { ErrorResponse, HyperliquidChainSchema, SignatureSchema, SuccessResponse } from "./_base/commonSchemas.js";
 
 /**
  * Initiate a withdrawal request.
@@ -30,9 +23,15 @@ export const Withdraw3Request = /* @__PURE__ */ (() => {
             v.description("Type of action."),
           ),
           /** Chain ID in hex format for EIP-712 signing. */
-          signatureChainId: SignatureChainId,
+          signatureChainId: v.pipe(
+            Hex,
+            v.description("Chain ID in hex format for EIP-712 signing."),
+          ),
           /** HyperLiquid network type. */
-          hyperliquidChain: HyperliquidChain,
+          hyperliquidChain: v.pipe(
+            HyperliquidChainSchema,
+            v.description("HyperLiquid network type."),
+          ),
           /** Destination address. */
           destination: v.pipe(
             Address,
@@ -44,14 +43,23 @@ export const Withdraw3Request = /* @__PURE__ */ (() => {
             v.description("Amount to withdraw (1 = $1)."),
           ),
           /** Nonce (timestamp in ms) used to prevent replay attacks. */
-          time: Nonce,
+          time: v.pipe(
+            UnsignedInteger,
+            v.description("Nonce (timestamp in ms) used to prevent replay attacks."),
+          ),
         }),
         v.description("Action to perform."),
       ),
       /** Nonce (timestamp in ms) used to prevent replay attacks. */
-      nonce: Nonce,
+      nonce: v.pipe(
+        UnsignedInteger,
+        v.description("Nonce (timestamp in ms) used to prevent replay attacks."),
+      ),
       /** ECDSA signature components. */
-      signature: Signature,
+      signature: v.pipe(
+        SignatureSchema,
+        v.description("ECDSA signature components."),
+      ),
     }),
     v.description("Initiate a withdrawal request."),
   );

package/src/src/api/exchange/client.ts

@@ -254,7 +254,9 @@ import {
 // =============================================================
 
 /**
- * A client for interacting with the Hyperliquid Exchange API.
+ * Execute actions: place orders, cancel orders, transfer funds, etc.
+ *
+ * Corresponds to the {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint | Exchange endpoint}.
  */
 export class ExchangeClient<C extends ExchangeConfig = ExchangeSingleWalletConfig> {
   config_: C;
@@ -679,7 +681,11 @@ export class ExchangeClient<C extends ExchangeConfig = ExchangeSingleWalletConfi
 // Type Re-exports
 // =============================================================
 
-export type { ExchangeMultiSigConfig, ExchangeSingleWalletConfig } from "./_methods/_base/execute.js";
+export type {
+  ExchangeExternalSigningConfig,
+  ExchangeMultiSigConfig,
+  ExchangeSingleWalletConfig,
+} from "./_methods/_base/execute.js";
 export { ApiRequestError } from "./_methods/_base/errors.js";
 
 export type {

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

@@ -2,7 +2,7 @@
  * This module re-exports all exchange-related API request functions and types.
  *
  * You can use raw functions to maximize tree-shaking in your app,
- * or to access [valibot](https://github.com/fabian-hiller/valibot) schemas Request/Response.
+ * or to access {@link https://github.com/fabian-hiller/valibot | valibot} schemas Request/Response.
  *
  * @example
  * ```ts
@@ -37,7 +37,11 @@
  * @module
  */
 
-export type { ExchangeMultiSigConfig, ExchangeSingleWalletConfig } from "./_methods/_base/execute.js";
+export type {
+  ExchangeExternalSigningConfig,
+  ExchangeMultiSigConfig,
+  ExchangeSingleWalletConfig,
+} from "./_methods/_base/execute.js";
 export { ApiRequestError } from "./_methods/_base/errors.js";
 
 export * from "./_methods/agentEnableDexAbstraction.js";