@nktkas/hyperliquid 0.31.0 → 0.32.0

package/script/api/exchange/_methods/_base/execute.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Execute helpers for L1 and user-signed Exchange API actions.
+ * @module
+ */
+import { type AbstractWallet } from "../../../../signing/mod.js";
+import type { IRequestTransport } from "../../../../transport/mod.js";
+type MaybePromise<T> = T | Promise<T>;
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** Options for any execute functions. */
+interface BaseOptions {
+    /** {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal} to cancel a request. */
+    signal?: AbortSignal;
+}
+/** Extract request options from a request type (excludes action, nonce, signature). */
+export type ExtractRequestOptions<T extends {
+    action: Record<string, unknown>;
+}> = Prettify<BaseOptions & Omit<T, "action" | "nonce" | "signature">>;
+/** Base configuration shared by single-wallet and multi-sig configs. */
+interface BaseConfig<T extends IRequestTransport = IRequestTransport> {
+    /** The transport used to connect to the Hyperliquid Exchange API. */
+    transport: T;
+    /** Signature chain ID for EIP-712 signing, defaults to wallet's chain ID. */
+    signatureChainId?: `0x${string}` | (() => MaybePromise<`0x${string}`>);
+    /**
+     * Default vault address for vault-based operations, used when not specified in action options.
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#subaccounts-and-vaults
+     */
+    defaultVaultAddress?: `0x${string}`;
+    /**
+     * Default expiration time in milliseconds, used when not specified in action options.
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#expires-after
+     */
+    defaultExpiresAfter?: number | (() => MaybePromise<number>);
+    /**
+     * Custom nonce generator function.
+     * Defaults to a global manager using timestamp with auto-increment.
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/nonces-and-api-wallets#hyperliquid-nonces
+     */
+    nonceManager?: (address: string) => MaybePromise<number>;
+}
+/** Configuration for single-wallet Exchange API requests. */
+export interface ExchangeSingleWalletConfig<T extends IRequestTransport = IRequestTransport> extends BaseConfig<T> {
+    /** The wallet used to sign requests. */
+    wallet: AbstractWallet;
+}
+/** Configuration for multi-signature Exchange API requests. */
+export interface ExchangeMultiSigConfig<T extends IRequestTransport = IRequestTransport> extends BaseConfig<T> {
+    /** Array of wallets for multi-sig. First wallet is the leader. */
+    signers: readonly [AbstractWallet, ...AbstractWallet[]];
+    /** The multi-signature account address. */
+    multiSigUser: `0x${string}`;
+}
+/** Union type for all Exchange API configurations. */
+export type ExchangeConfig = ExchangeSingleWalletConfig | ExchangeMultiSigConfig;
+/**
+ * Execute an L1 action on the Hyperliquid Exchange.
+ *
+ * Handles both single-wallet and multi-sig signing.
+ *
+ * @param config Exchange API configuration
+ * @param action Action payload to execute
+ * @param options Additional options for the request
+ * @return API response
+ *
+ * @throws {ApiRequestError} If the API returns an error response
+ */
+export declare function executeL1Action<T>(config: ExchangeConfig, action: Record<string, unknown>, options?: {
+    vaultAddress?: string;
+    expiresAfter?: string | number;
+    signal?: AbortSignal;
+}): Promise<T>;
+/**
+ * Execute a user-signed action (EIP-712) on the Hyperliquid Exchange.
+ *
+ * Handles both single-wallet and multi-sig signing.
+ * Automatically adds signatureChainId, hyperliquidChain, and nonce/time.
+ *
+ * @param config Exchange API configuration
+ * @param action Action payload to execute
+ * @param types EIP-712 type definitions for signing
+ * @param options Additional options for the request
+ * @return API response
+ *
+ * @throws {ApiRequestError} If the API returns an error response
+ */
+export declare function executeUserSignedAction<T>(config: ExchangeConfig, action: Record<string, unknown>, types: Record<string, {
+    name: string;
+    type: string;
+}[]>, options?: {
+    signal?: AbortSignal;
+}): Promise<T>;
+export {};
+//# sourceMappingURL=execute.d.ts.map

package/script/api/exchange/_methods/_base/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../../../src/api/exchange/_methods/_base/execute.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EACL,KAAK,cAAc,EAMpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAWtE,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAGtC,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAEjD,yCAAyC;AACzC,UAAU,WAAW;IACnB,8GAA8G;IAC9G,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,uFAAuF;AACvF,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,IAAI,QAAQ,CACvF,WAAW,GACX,IAAI,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC,CAC5C,CAAC;AAMF,wEAAwE;AACxE,UAAU,UAAU,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAClE,qEAAqE;IACrE,SAAS,EAAE,CAAC,CAAC;IAEb,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,CAAC,MAAM,YAAY,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;IAEvE;;;OAGG;IACH,mBAAmB,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAEpC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5D;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC,MAAM,CAAC,CAAC;CAC1D;AAED,6DAA6D;AAC7D,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IAChH,wCAAwC;IACxC,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IAC5G,kEAAkE;IAClE,OAAO,EAAE,SAAS,CAAC,cAAc,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC;IACxD,2CAA2C;IAC3C,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;CAC7B;AAED,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG,0BAA0B,GAAG,sBAAsB,CAAC;AAMjF;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CAAC,CAAC,CAAC,CAkDZ;AAgBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,EACvD,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CAAC,CAAC,CAAC,CAoCZ"}

package/script/api/exchange/_methods/_base/execute.js

@@ -0,0 +1,266 @@
+"use strict";
+/**
+ * Execute helpers for L1 and user-signed Exchange API actions.
+ * @module
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeL1Action = executeL1Action;
+exports.executeUserSignedAction = executeUserSignedAction;
+const v = __importStar(require("valibot"));
+const _base_js_1 = require("../../../../_base.js");
+const mod_js_1 = require("../../../../signing/mod.js");
+const _schemas_js_1 = require("../../../_schemas.js");
+const _nonce_js_1 = require("./_nonce.js");
+const _semaphore_js_1 = require("./_semaphore.js");
+const errors_js_1 = require("./errors.js");
+// ============================================================
+// Execute L1 Action
+// ============================================================
+/**
+ * Execute an L1 action on the Hyperliquid Exchange.
+ *
+ * Handles both single-wallet and multi-sig signing.
+ *
+ * @param config Exchange API configuration
+ * @param action Action payload to execute
+ * @param options Additional options for the request
+ * @return API response
+ *
+ * @throws {ApiRequestError} If the API returns an error response
+ */
+async function executeL1Action(config, action, options) {
+    const { transport } = config;
+    const leader = getLeader(config);
+    const walletAddress = await (0, mod_js_1.getWalletAddress)(leader);
+    // Semaphore ensures requests arrive at server in nonce order (prevents out-of-order delivery)
+    const key = `${walletAddress}:${transport.isTestnet}`;
+    return await (0, _semaphore_js_1.withLock)(key, async () => {
+        const nonce = await (config.nonceManager?.(walletAddress) ?? _nonce_js_1.globalNonceManager.getNonce(key));
+        // Validate and resolve options
+        const vaultAddress = (0, _base_js_1.parse)(v.optional(_schemas_js_1.Address), options?.vaultAddress ?? config.defaultVaultAddress);
+        const expiresAfter = (0, _base_js_1.parse)(v.optional(_schemas_js_1.UnsignedInteger), options?.expiresAfter ??
+            (typeof config.defaultExpiresAfter === "number"
+                ? config.defaultExpiresAfter
+                : await config.defaultExpiresAfter?.()));
+        const signal = options?.signal;
+        // Sign action (multi-sig or single wallet)
+        const [finalAction, signature] = "wallet" in config
+            ? [
+                action,
+                await (0, mod_js_1.signL1Action)({
+                    wallet: leader,
+                    action,
+                    nonce,
+                    isTestnet: transport.isTestnet,
+                    vaultAddress,
+                    expiresAfter,
+                }),
+            ]
+            : await signMultiSigL1(config, action, walletAddress, nonce, vaultAddress, expiresAfter);
+        // Send request and validate response
+        const response = await transport.request("exchange", {
+            action: finalAction,
+            signature,
+            nonce,
+            vaultAddress,
+            expiresAfter,
+        }, signal);
+        (0, errors_js_1.assertSuccessResponse)(response);
+        return response;
+    });
+}
+// ============================================================
+// Execute User-Signed Action
+// ============================================================
+/** Extract nonce field name from EIP-712 types ("nonce" or "time"). */
+function getNonceFieldName(types) {
+    const primaryType = Object.keys(types)[0];
+    const field = types[primaryType].find((f) => f.name === "nonce" || f.name === "time");
+    return field?.name ?? "nonce";
+}
+/**
+ * Execute a user-signed action (EIP-712) on the Hyperliquid Exchange.
+ *
+ * Handles both single-wallet and multi-sig signing.
+ * Automatically adds signatureChainId, hyperliquidChain, and nonce/time.
+ *
+ * @param config Exchange API configuration
+ * @param action Action payload to execute
+ * @param types EIP-712 type definitions for signing
+ * @param options Additional options for the request
+ * @return API response
+ *
+ * @throws {ApiRequestError} If the API returns an error response
+ */
+async function executeUserSignedAction(config, action, types, options) {
+    const { transport } = config;
+    const leader = getLeader(config);
+    const walletAddress = await (0, mod_js_1.getWalletAddress)(leader);
+    // Semaphore ensures requests arrive at server in nonce order (prevents out-of-order delivery)
+    const key = `${walletAddress}:${transport.isTestnet}`;
+    return (0, _semaphore_js_1.withLock)(key, async () => {
+        const nonce = await (config.nonceManager?.(walletAddress) ?? _nonce_js_1.globalNonceManager.getNonce(key));
+        const signal = options?.signal;
+        // Add system fields for user-signed actions
+        const { type, ...restAction } = action;
+        const nonceFieldName = getNonceFieldName(types);
+        const fullAction = {
+            type,
+            signatureChainId: await getSignatureChainId(config),
+            hyperliquidChain: transport.isTestnet ? "Testnet" : "Mainnet",
+            ...restAction,
+            [nonceFieldName]: nonce,
+        };
+        // Sign action (multi-sig or single wallet)
+        const [finalAction, signature] = "wallet" in config
+            ? [fullAction, await (0, mod_js_1.signUserSignedAction)({ wallet: leader, action: fullAction, types })]
+            : await signMultiSigUserSigned(config, fullAction, types, walletAddress, nonce);
+        // Send request and validate response
+        const response = await transport.request("exchange", {
+            action: finalAction,
+            signature,
+            nonce,
+        }, signal);
+        (0, errors_js_1.assertSuccessResponse)(response);
+        return response;
+    });
+}
+// ============================================================
+// Multi-sig signing
+// ============================================================
+/** Remove leading zeros from signature components (required by Hyperliquid). */
+function trimSignature(sig) {
+    return {
+        r: sig.r.replace(/^0x0+/, "0x"),
+        s: sig.s.replace(/^0x0+/, "0x"),
+        v: sig.v,
+    };
+}
+/** Sign an L1 action with multi-sig. */
+async function signMultiSigL1(config, action, outerSigner, nonce, vaultAddress, expiresAfter) {
+    const { transport: { isTestnet }, signers, multiSigUser } = config;
+    const multiSigUser_ = (0, _base_js_1.parse)(_schemas_js_1.Address, multiSigUser);
+    const outerSigner_ = (0, _base_js_1.parse)(_schemas_js_1.Address, outerSigner);
+    // Collect signatures from all signers
+    const signatures = await Promise.all(signers.map(async (signer) => {
+        const signature = await (0, mod_js_1.signL1Action)({
+            wallet: signer,
+            action: [multiSigUser_, outerSigner_, action],
+            nonce,
+            isTestnet,
+            vaultAddress,
+            expiresAfter,
+        });
+        return trimSignature(signature);
+    }));
+    // Build multi-sig action wrapper
+    const multiSigAction = {
+        type: "multiSig",
+        signatureChainId: await getSignatureChainId(config),
+        signatures,
+        payload: {
+            multiSigUser: multiSigUser_,
+            outerSigner: outerSigner_,
+            action,
+        },
+    };
+    // Sign the wrapper with the leader
+    const signature = await (0, mod_js_1.signMultiSigAction)({
+        wallet: signers[0],
+        action: multiSigAction,
+        nonce,
+        isTestnet,
+        vaultAddress,
+        expiresAfter,
+    });
+    return [multiSigAction, signature];
+}
+/** Sign a user-signed action (EIP-712) with multi-sig. */
+async function signMultiSigUserSigned(config, action, types, outerSigner, nonce) {
+    const { signers, multiSigUser, transport: { isTestnet } } = config;
+    const multiSigUser_ = (0, _base_js_1.parse)(_schemas_js_1.Address, multiSigUser);
+    const outerSigner_ = (0, _base_js_1.parse)(_schemas_js_1.Address, outerSigner);
+    // Collect signatures from all signers
+    const signatures = await Promise.all(signers.map(async (signer) => {
+        const signature = await (0, mod_js_1.signUserSignedAction)({
+            wallet: signer,
+            action: {
+                payloadMultiSigUser: multiSigUser_,
+                outerSigner: outerSigner_,
+                ...action,
+            },
+            types,
+        });
+        return trimSignature(signature);
+    }));
+    // Build multi-sig action wrapper
+    const multiSigAction = {
+        type: "multiSig",
+        signatureChainId: await getSignatureChainId(config),
+        signatures,
+        payload: {
+            multiSigUser: multiSigUser_,
+            outerSigner: outerSigner_,
+            action,
+        },
+    };
+    // Sign the wrapper with the leader
+    const signature = await (0, mod_js_1.signMultiSigAction)({
+        wallet: signers[0],
+        action: multiSigAction,
+        nonce,
+        isTestnet,
+    });
+    return [multiSigAction, signature];
+}
+// ============================================================
+// Helpers
+// ============================================================
+/** Get the leader wallet (first signer for the single wallet, or multi-sig). */
+function getLeader(config) {
+    return "wallet" in config ? config.wallet : config.signers[0];
+}
+/** Resolve signature chain ID from config or wallet. */
+async function getSignatureChainId(config) {
+    if (config.signatureChainId) {
+        const id = typeof config.signatureChainId === "function"
+            ? await config.signatureChainId()
+            : config.signatureChainId;
+        return (0, _base_js_1.parse)(_schemas_js_1.Hex, id);
+    }
+    return (0, mod_js_1.getWalletChainId)(getLeader(config));
+}
+//# sourceMappingURL=execute.js.map

package/script/api/exchange/_methods/_base/execute.js.map

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

package/script/api/exchange/_methods/agentEnableDexAbstraction.d.ts

@@ -0,0 +1,64 @@
+import * as v from "valibot";
+import { type ErrorResponse, type SuccessResponse } from "./_base/commonSchemas.js";
+/**
+ * Enable HIP-3 DEX abstraction.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#enable-hip-3-dex-abstraction-agent
+ */
+export declare const AgentEnableDexAbstractionRequest: v.ObjectSchema<{
+    /** Action to perform. */
+    readonly action: v.ObjectSchema<{
+        /** Type of action. */
+        readonly type: v.LiteralSchema<"agentEnableDexAbstraction", undefined>;
+    }, undefined>;
+    /** Nonce (timestamp in ms) used to prevent replay attacks. */
+    readonly nonce: v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    /** ECDSA signature components. */
+    readonly signature: v.ObjectSchema<{
+        readonly r: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>;
+        readonly s: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>;
+        readonly v: v.PicklistSchema<[27, 28], undefined>;
+    }, undefined>;
+    /** Expiration time of the action. */
+    readonly expiresAfter: v.OptionalSchema<v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+}, undefined>;
+export type AgentEnableDexAbstractionRequest = v.InferOutput<typeof AgentEnableDexAbstractionRequest>;
+/**
+ * Successful response without specific data or error response.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#enable-hip-3-dex-abstraction-agent
+ */
+export type AgentEnableDexAbstractionResponse = SuccessResponse | ErrorResponse;
+import type { ExcludeErrorResponse } from "./_base/errors.js";
+import { type ExchangeConfig, type ExtractRequestOptions } from "./_base/execute.js";
+/** Request options for the {@linkcode agentEnableDexAbstraction} function. */
+export type AgentEnableDexAbstractionOptions = ExtractRequestOptions<v.InferInput<typeof AgentEnableDexAbstractionRequest>>;
+/** Successful variant of {@linkcode AgentEnableDexAbstractionResponse} without errors. */
+export type AgentEnableDexAbstractionSuccessResponse = ExcludeErrorResponse<AgentEnableDexAbstractionResponse>;
+/**
+ * Enable HIP-3 DEX abstraction.
+ *
+ * @param config General configuration for Exchange API requests.
+ * @param opts Request execution options.
+ * @return Successful response without specific data.
+ *
+ * @throws {ValidationError} When the request parameters fail validation (before sending).
+ * @throws {TransportError} When the transport layer throws an error.
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { agentEnableDexAbstraction } from "@nktkas/hyperliquid/api/exchange";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * await agentEnableDexAbstraction({ transport, wallet });
+ * ```
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#enable-hip-3-dex-abstraction-agent
+ *
+ * @deprecated Use {@link agentSetAbstraction} instead.
+ */
+export declare function agentEnableDexAbstraction(config: ExchangeConfig, opts?: AgentEnableDexAbstractionOptions): Promise<AgentEnableDexAbstractionSuccessResponse>;
+//# sourceMappingURL=agentEnableDexAbstraction.d.ts.map

package/script/api/exchange/_methods/agentEnableDexAbstraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentEnableDexAbstraction.d.ts","sourceRoot":"","sources":["../../../../src/api/exchange/_methods/agentEnableDexAbstraction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAO7B,OAAO,EAAE,KAAK,aAAa,EAAmB,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAErG;;;GAGG;AACH,eAAO,MAAM,gCAAgC;IAEzC,yBAAyB;;QAEvB,sBAAsB;;;IAGxB,8DAA8D;;IAE9D,kCAAkC;;;;;;IAElC,qCAAqC;;aAGrC,CAAC;AACL,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAEtG;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,eAAe,GAAG,aAAa,CAAC;AAMhF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,KAAK,cAAc,EAAmB,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEtG,8EAA8E;AAC9E,MAAM,MAAM,gCAAgC,GAAG,qBAAqB,CAClE,CAAC,CAAC,UAAU,CAAC,OAAO,gCAAgC,CAAC,CACtD,CAAC;AAEF,0FAA0F;AAC1F,MAAM,MAAM,wCAAwC,GAAG,oBAAoB,CAAC,iCAAiC,CAAC,CAAC;AAE/G;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,cAAc,EACtB,IAAI,CAAC,EAAE,gCAAgC,GACtC,OAAO,CAAC,wCAAwC,CAAC,CAEnD"}

package/script/api/exchange/_methods/agentEnableDexAbstraction.js

@@ -0,0 +1,94 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentEnableDexAbstractionRequest = void 0;
+exports.agentEnableDexAbstraction = agentEnableDexAbstraction;
+const v = __importStar(require("valibot"));
+// ============================================================
+// API Schemas
+// ============================================================
+const _schemas_js_1 = require("../../_schemas.js");
+const commonSchemas_js_1 = require("./_base/commonSchemas.js");
+/**
+ * Enable HIP-3 DEX abstraction.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#enable-hip-3-dex-abstraction-agent
+ */
+exports.AgentEnableDexAbstractionRequest = (() => {
+    return v.object({
+        /** Action to perform. */
+        action: v.object({
+            /** Type of action. */
+            type: v.literal("agentEnableDexAbstraction"),
+        }),
+        /** Nonce (timestamp in ms) used to prevent replay attacks. */
+        nonce: _schemas_js_1.UnsignedInteger,
+        /** ECDSA signature components. */
+        signature: commonSchemas_js_1.SignatureSchema,
+        /** Expiration time of the action. */
+        expiresAfter: v.optional(_schemas_js_1.UnsignedInteger),
+    });
+})();
+const execute_js_1 = require("./_base/execute.js");
+/**
+ * Enable HIP-3 DEX abstraction.
+ *
+ * @param config General configuration for Exchange API requests.
+ * @param opts Request execution options.
+ * @return Successful response without specific data.
+ *
+ * @throws {ValidationError} When the request parameters fail validation (before sending).
+ * @throws {TransportError} When the transport layer throws an error.
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { agentEnableDexAbstraction } from "@nktkas/hyperliquid/api/exchange";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * await agentEnableDexAbstraction({ transport, wallet });
+ * ```
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#enable-hip-3-dex-abstraction-agent
+ *
+ * @deprecated Use {@link agentSetAbstraction} instead.
+ */
+function agentEnableDexAbstraction(config, opts) {
+    return (0, execute_js_1.executeL1Action)(config, { type: "agentEnableDexAbstraction" }, opts);
+}
+//# sourceMappingURL=agentEnableDexAbstraction.js.map

package/script/api/exchange/_methods/agentEnableDexAbstraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentEnableDexAbstraction.js","sourceRoot":"","sources":["../../../../src/api/exchange/_methods/agentEnableDexAbstraction.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8EA,8DAKC;AAnFD,2CAA6B;AAE7B,+DAA+D;AAC/D,cAAc;AACd,+DAA+D;AAE/D,mDAAoD;AACpD,+DAAqG;AAErG;;;GAGG;AACU,QAAA,gCAAgC,GAAmB,CAAC,GAAG,EAAE;IACpE,OAAO,CAAC,CAAC,MAAM,CAAC;QACd,yBAAyB;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,sBAAsB;YACtB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAAC;SAC7C,CAAC;QACF,8DAA8D;QAC9D,KAAK,EAAE,6BAAe;QACtB,kCAAkC;QAClC,SAAS,EAAE,kCAAe;QAC1B,qCAAqC;QACrC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,6BAAe,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC,EAAE,CAAC;AAcL,mDAAsG;AAUtG;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,yBAAyB,CACvC,MAAsB,EACtB,IAAuC;IAEvC,OAAO,IAAA,4BAAe,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,2BAA2B,EAAE,EAAE,IAAI,CAAC,CAAC;AAC9E,CAAC"}