@lit-protocol/vincent-ability-hyperliquid 3.0.0

package/dist/src/lib/ability-checks/transfer-usdc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-usdc.d.ts","sourceRoot":"","sources":["../../../../src/lib/ability-checks/transfer-usdc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,uBAAuB,GAC/B,8BAA8B,GAC9B,8BAA8B,CAAC;AAEnC,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,IAAI,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,UAAU,EACV,UAAU,EACV,MAAM,GACP,EAAE;IACD,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAkEnC"}

package/dist/src/lib/ability-checks/transfer-usdc.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transferPrechecks = transferPrechecks;
+const ethers_1 = require("ethers");
+/**
+ * Check if transfer between spot and perp accounts can be executed
+ */
+async function transferPrechecks({ infoClient, ethAddress, params, }) {
+    // Transfer to spot means we're transferring FROM perp
+    // Transfer to perp means we're transferring FROM spot
+    if (params.to === 'spot') {
+        // Check perp account balance
+        const clearinghouseState = await infoClient.clearinghouseState({
+            user: ethAddress,
+        });
+        const availableUsdcBalance = ethers_1.ethers.utils.parseUnits(clearinghouseState.marginSummary.accountValue, 6);
+        const requestedAmount = ethers_1.ethers.BigNumber.from(params.amount);
+        if (availableUsdcBalance.lt(requestedAmount)) {
+            return {
+                success: false,
+                reason: `Insufficient perp balance. Available: ${ethers_1.ethers.utils.formatUnits(availableUsdcBalance, 6)} USDC, Requested: ${ethers_1.ethers.utils.formatUnits(requestedAmount, 6)} USDC`,
+                availableBalance: ethers_1.ethers.utils.formatUnits(availableUsdcBalance, 6),
+                requiredBalance: ethers_1.ethers.utils.formatUnits(requestedAmount, 6),
+            };
+        }
+        return {
+            success: true,
+            availableBalance: ethers_1.ethers.utils.formatUnits(availableUsdcBalance, 6),
+            requiredBalance: ethers_1.ethers.utils.formatUnits(requestedAmount, 6),
+        };
+    }
+    else {
+        // Check spot account balance
+        const spotState = await infoClient.spotClearinghouseState({
+            user: ethAddress,
+        });
+        // Find USDC balance in spot account
+        const usdcBalance = spotState.balances.find((b) => b.coin === 'USDC');
+        if (!usdcBalance) {
+            return {
+                success: false,
+                reason: 'No USDC balance found in spot account',
+                availableBalance: '0',
+            };
+        }
+        // When returned from the Hyperliquid API, the balance is in 8 decimals
+        const availableUsdcBalance = ethers_1.ethers.utils.parseUnits(usdcBalance.total, 8);
+        const requestedAmount = ethers_1.ethers.BigNumber.from(params.amount);
+        if (availableUsdcBalance.lt(requestedAmount)) {
+            return {
+                success: false,
+                reason: `Insufficient spot balance. Available: ${ethers_1.ethers.utils.formatUnits(availableUsdcBalance, 8)} USDC, Requested: ${ethers_1.ethers.utils.formatUnits(requestedAmount, 6)} USDC`,
+                availableBalance: availableUsdcBalance.toString(),
+                requiredBalance: ethers_1.ethers.utils.formatUnits(requestedAmount, 6),
+            };
+        }
+        return {
+            success: true,
+            availableBalance: availableUsdcBalance.toString(),
+            requiredBalance: requestedAmount.toString(),
+        };
+    }
+}
+//# sourceMappingURL=transfer-usdc.js.map

package/dist/src/lib/ability-checks/transfer-usdc.js.map

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

package/dist/src/lib/ability-checks/withdraw-usdc.d.ts

@@ -0,0 +1,25 @@
+import * as hyperliquid from '@nktkas/hyperliquid';
+export type WithdrawPrechecksResult = WithdrawPrechecksResultSuccess | WithdrawPrechecksResultFailure;
+export interface WithdrawPrechecksResultSuccess {
+    success: true;
+    availableBalance: string;
+    requiredBalance: string;
+}
+export interface WithdrawPrechecksResultFailure {
+    success: false;
+    reason: string;
+    availableBalance?: string;
+    requiredBalance?: string;
+}
+export interface WithdrawParams {
+    amount: string;
+}
+/**
+ * Check if withdrawal from Hyperliquid to L1 can be executed
+ */
+export declare function withdrawPrechecks({ infoClient, ethAddress, params, }: {
+    infoClient: hyperliquid.InfoClient;
+    ethAddress: string;
+    params: WithdrawParams;
+}): Promise<WithdrawPrechecksResult>;
+//# sourceMappingURL=withdraw-usdc.d.ts.map

package/dist/src/lib/ability-checks/withdraw-usdc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdraw-usdc.d.ts","sourceRoot":"","sources":["../../../../src/lib/ability-checks/withdraw-usdc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,uBAAuB,GAC/B,8BAA8B,GAC9B,8BAA8B,CAAC;AAEnC,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,IAAI,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,UAAU,EACV,UAAU,EACV,MAAM,GACP,EAAE;IACD,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAsCnC"}

package/dist/src/lib/ability-checks/withdraw-usdc.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withdrawPrechecks = withdrawPrechecks;
+const ethers_1 = require("ethers");
+/**
+ * Check if withdrawal from Hyperliquid to L1 can be executed
+ */
+async function withdrawPrechecks({ infoClient, ethAddress, params, }) {
+    // Withdrawal comes from perp account
+    const clearinghouseState = await infoClient.clearinghouseState({
+        user: ethAddress,
+    });
+    const availableUsdcBalance = ethers_1.ethers.utils.parseUnits(clearinghouseState.marginSummary.accountValue, 6);
+    const requestedAmount = ethers_1.ethers.BigNumber.from(params.amount);
+    const minimumWithdrawAmount = ethers_1.ethers.utils.parseUnits('1', 6); // 1 USDC minimum (withdrawal fee)
+    // Check if requested amount is at least 1 USDC
+    if (requestedAmount.lt(minimumWithdrawAmount)) {
+        return {
+            success: false,
+            reason: `Withdrawal amount must be at least 1 USDC due to withdrawal fee. Requested: ${ethers_1.ethers.utils.formatUnits(requestedAmount, 6)} USDC`,
+            availableBalance: ethers_1.ethers.utils.formatUnits(availableUsdcBalance, 6),
+            requiredBalance: ethers_1.ethers.utils.formatUnits(minimumWithdrawAmount, 6),
+        };
+    }
+    if (availableUsdcBalance.lt(requestedAmount)) {
+        return {
+            success: false,
+            reason: `Insufficient perp balance for withdrawal. Available: ${ethers_1.ethers.utils.formatUnits(availableUsdcBalance, 6)} USDC, Requested: ${ethers_1.ethers.utils.formatUnits(requestedAmount, 6)} USDC`,
+            availableBalance: ethers_1.ethers.utils.formatUnits(availableUsdcBalance, 6),
+            requiredBalance: ethers_1.ethers.utils.formatUnits(requestedAmount, 6),
+        };
+    }
+    return {
+        success: true,
+        availableBalance: ethers_1.ethers.utils.formatUnits(availableUsdcBalance, 6),
+        requiredBalance: ethers_1.ethers.utils.formatUnits(requestedAmount, 6),
+    };
+}
+//# sourceMappingURL=withdraw-usdc.js.map

package/dist/src/lib/ability-checks/withdraw-usdc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdraw-usdc.js","sourceRoot":"","sources":["../../../../src/lib/ability-checks/withdraw-usdc.ts"],"names":[],"mappings":";;AA2BA,8CA8CC;AAzED,mCAAgC;AAwBhC;;GAEG;AACI,KAAK,UAAU,iBAAiB,CAAC,EACtC,UAAU,EACV,UAAU,EACV,MAAM,GAKP;IACC,qCAAqC;IACrC,MAAM,kBAAkB,GAAG,MAAM,UAAU,CAAC,kBAAkB,CAAC;QAC7D,IAAI,EAAE,UAAU;KACjB,CAAC,CAAC;IAEH,MAAM,oBAAoB,GAAG,eAAM,CAAC,KAAK,CAAC,UAAU,CAClD,kBAAkB,CAAC,aAAa,CAAC,YAAY,EAC7C,CAAC,CACF,CAAC;IAEF,MAAM,eAAe,GAAG,eAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,qBAAqB,GAAG,eAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,kCAAkC;IAEjG,+CAA+C;IAC/C,IAAI,eAAe,CAAC,EAAE,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC9C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,+EAA+E,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC,OAAO;YAC1I,gBAAgB,EAAE,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,oBAAoB,EAAE,CAAC,CAAC;YACnE,eAAe,EAAE,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC;SACpE,CAAC;IACJ,CAAC;IAED,IAAI,oBAAoB,CAAC,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;QAC7C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,wDAAwD,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,oBAAoB,EAAE,CAAC,CAAC,qBAAqB,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC,OAAO;YACzL,gBAAgB,EAAE,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,oBAAoB,EAAE,CAAC,CAAC;YACnE,eAAe,EAAE,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC;SAC9D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,gBAAgB,EAAE,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,oBAAoB,EAAE,CAAC,CAAC;QACnE,eAAe,EAAE,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC;KAC9D,CAAC;AACJ,CAAC"}

package/dist/src/lib/ability-helpers/approve-builder-code.d.ts

@@ -0,0 +1,22 @@
+import * as hyperliquid from '@nktkas/hyperliquid';
+import { SuccessResponse } from '@nktkas/hyperliquid/api/exchange';
+export type ApproveBuilderCodeResult = {
+    approveResult: SuccessResponse | hyperliquid.ErrorResponse;
+};
+/**
+ * Approve a builder code (builder address) with a maximum fee rate on Hyperliquid
+ * @param transport - Hyperliquid HTTP transport instance
+ * @param pkpPublicKey - PKP public key for signing
+ * @param builderAddress - Builder address to approve
+ * @param maxFeeRate - Maximum fee rate as a percentage string (e.g., "0.01" for 0.01%)
+ * @param useTestnet - Whether to use testnet (default: false)
+ * @returns Approval result from Hyperliquid
+ */
+export declare function approveBuilderCode({ transport, pkpPublicKey, builderAddress, maxFeeRate, useTestnet, }: {
+    transport: hyperliquid.HttpTransport;
+    pkpPublicKey: string;
+    builderAddress: string;
+    maxFeeRate: string;
+    useTestnet?: boolean;
+}): Promise<ApproveBuilderCodeResult>;
+//# sourceMappingURL=approve-builder-code.d.ts.map

package/dist/src/lib/ability-helpers/approve-builder-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve-builder-code.d.ts","sourceRoot":"","sources":["../../../../src/lib/ability-helpers/approve-builder-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAGL,eAAe,EAEhB,MAAM,kCAAkC,CAAC;AAQ1C,MAAM,MAAM,wBAAwB,GAAG;IACrC,aAAa,EAAE,eAAe,GAAG,WAAW,CAAC,aAAa,CAAC;CAC5D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,SAAS,EACT,YAAY,EACZ,cAAc,EACd,UAAU,EACV,UAAkB,GACnB,EAAE;IACD,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA6CpC"}

package/dist/src/lib/ability-helpers/approve-builder-code.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.approveBuilderCode = approveBuilderCode;
+const exchange_1 = require("@nktkas/hyperliquid/api/exchange");
+const signing_1 = require("@nktkas/hyperliquid/signing");
+const vincent_ability_sdk_1 = require("@lit-protocol/vincent-ability-sdk");
+const lit_action_pkp_ethers_wallet_1 = require("./lit-action-pkp-ethers-wallet");
+const get_hyperliquid_nonce_1 = require("./get-hyperliquid-nonce");
+const get_hyperliquid_chain_id_1 = require("./get-hyperliquid-chain-id");
+/**
+ * Approve a builder code (builder address) with a maximum fee rate on Hyperliquid
+ * @param transport - Hyperliquid HTTP transport instance
+ * @param pkpPublicKey - PKP public key for signing
+ * @param builderAddress - Builder address to approve
+ * @param maxFeeRate - Maximum fee rate as a percentage string (e.g., "0.01" for 0.01%)
+ * @param useTestnet - Whether to use testnet (default: false)
+ * @returns Approval result from Hyperliquid
+ */
+async function approveBuilderCode({ transport, pkpPublicKey, builderAddress, maxFeeRate, useTestnet = false, }) {
+    const pkpWallet = new lit_action_pkp_ethers_wallet_1.LitActionPkpEthersWallet(pkpPublicKey);
+    const nonce = await (0, get_hyperliquid_nonce_1.getHyperliquidNonce)();
+    // Ensure maxFeeRate has the % suffix (required by Hyperliquid schema)
+    const maxFeeRateWithPercent = maxFeeRate.endsWith('%') ? maxFeeRate : `${maxFeeRate}%`;
+    // Construct approve builder fee action
+    const approveAction = (0, exchange_1.parser)(exchange_1.ApproveBuilderFeeRequest.entries.action)({
+        type: 'approveBuilderFee',
+        signatureChainId: (0, get_hyperliquid_chain_id_1.getHyperliquidChainId)(useTestnet),
+        hyperliquidChain: (0, get_hyperliquid_chain_id_1.getHyperliquidChainName)(useTestnet),
+        maxFeeRate: maxFeeRateWithPercent,
+        builder: builderAddress,
+        nonce,
+    });
+    // ApproveBuilderFee is a user-signed action that uses EIP-712 typed data
+    const signature = await (0, signing_1.signUserSignedAction)({
+        wallet: pkpWallet,
+        action: approveAction,
+        types: exchange_1.ApproveBuilderFeeTypes,
+    });
+    const approveResult = await Lit.Actions.runOnce({ waitForResponse: true, name: 'HyperLiquidApproveBuilderFeeRequest' }, async () => {
+        return JSON.stringify({
+            result: await transport.request('exchange', {
+                action: approveAction,
+                signature,
+                nonce,
+            }),
+        }, vincent_ability_sdk_1.bigIntReplacer, 2);
+    });
+    const parsedApproveResult = JSON.parse(approveResult);
+    return {
+        approveResult: parsedApproveResult.result,
+    };
+}
+//# sourceMappingURL=approve-builder-code.js.map

package/dist/src/lib/ability-helpers/approve-builder-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve-builder-code.js","sourceRoot":"","sources":["../../../../src/lib/ability-helpers/approve-builder-code.ts"],"names":[],"mappings":";;AA2BA,gDAyDC;AAnFD,+DAK0C;AAC1C,yDAAmE;AACnE,2EAAmE;AAEnE,iFAA0E;AAC1E,mEAA8D;AAC9D,yEAA4F;AAM5F;;;;;;;;GAQG;AACI,KAAK,UAAU,kBAAkB,CAAC,EACvC,SAAS,EACT,YAAY,EACZ,cAAc,EACd,UAAU,EACV,UAAU,GAAG,KAAK,GAOnB;IACC,MAAM,SAAS,GAAG,IAAI,uDAAwB,CAAC,YAAY,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,MAAM,IAAA,2CAAmB,GAAE,CAAC;IAE1C,sEAAsE;IACtE,MAAM,qBAAqB,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,CAAC;IAEvF,uCAAuC;IACvC,MAAM,aAAa,GAAG,IAAA,iBAAM,EAAC,mCAAwB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpE,IAAI,EAAE,mBAAmB;QACzB,gBAAgB,EAAE,IAAA,gDAAqB,EAAC,UAAU,CAAC;QACnD,gBAAgB,EAAE,IAAA,kDAAuB,EAAC,UAAU,CAAC;QACrD,UAAU,EAAE,qBAAqB;QACjC,OAAO,EAAE,cAAc;QACvB,KAAK;KACN,CAAC,CAAC;IAEH,yEAAyE;IACzE,MAAM,SAAS,GAAG,MAAM,IAAA,8BAAoB,EAAC;QAC3C,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,iCAAsB;KAC9B,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,CAC7C,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,qCAAqC,EAAE,EACtE,KAAK,IAAI,EAAE;QACT,OAAO,IAAI,CAAC,SAAS,CACnB;YACE,MAAM,EAAE,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE;gBAC1C,MAAM,EAAE,aAAa;gBACrB,SAAS;gBACT,KAAK;aACN,CAAC;SACH,EACD,oCAAc,EACd,CAAC,CACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACtD,OAAO;QACL,aAAa,EAAE,mBAAmB,CAAC,MAAqD;KACzF,CAAC;AACJ,CAAC"}

package/dist/src/lib/ability-helpers/cancel-order/cancel-all-orders.d.ts

@@ -0,0 +1,21 @@
+import * as hyperliquid from '@nktkas/hyperliquid';
+import { CancelResponse } from '@nktkas/hyperliquid/api/exchange';
+export type CancelAllOrdersResult = CancelAllOrdersResultSuccess | CancelAllOrdersResultFailure;
+export interface CancelAllOrdersResultSuccess {
+    status: 'success';
+    cancelResult: CancelResponse;
+}
+export interface CancelAllOrdersResultFailure {
+    status: 'error';
+    reason: string;
+}
+/**
+ * Cancel all open spot orders for a specific symbol
+ */
+export declare function cancelAllOrdersForSymbol({ transport, pkpPublicKey, symbol, useTestnet, }: {
+    transport: hyperliquid.HttpTransport;
+    pkpPublicKey: string;
+    symbol: string;
+    useTestnet?: boolean;
+}): Promise<CancelAllOrdersResult>;
+//# sourceMappingURL=cancel-all-orders.d.ts.map

package/dist/src/lib/ability-helpers/cancel-order/cancel-all-orders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-all-orders.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ability-helpers/cancel-order/cancel-all-orders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAiB,cAAc,EAAU,MAAM,kCAAkC,CAAC;AAMzF,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,GAAG,4BAA4B,CAAC;AAEhG,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,cAAc,CAAC;CAC9B;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,EAC7C,SAAS,EACT,YAAY,EACZ,MAAM,EACN,UAAkB,GACnB,EAAE;IACD,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAsEjC"}

package/dist/src/lib/ability-helpers/cancel-order/cancel-all-orders.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cancelAllOrdersForSymbol = cancelAllOrdersForSymbol;
+const tslib_1 = require("tslib");
+const hyperliquid = tslib_1.__importStar(require("@nktkas/hyperliquid"));
+const utils_1 = require("@nktkas/hyperliquid/utils");
+const exchange_1 = require("@nktkas/hyperliquid/api/exchange");
+const signing_1 = require("@nktkas/hyperliquid/signing");
+const lit_action_pkp_ethers_wallet_1 = require("../lit-action-pkp-ethers-wallet");
+const get_hyperliquid_nonce_1 = require("../get-hyperliquid-nonce");
+/**
+ * Cancel all open spot orders for a specific symbol
+ */
+async function cancelAllOrdersForSymbol({ transport, pkpPublicKey, symbol, useTestnet = false, }) {
+    // Get converter for symbol to asset ID
+    const converter = await utils_1.SymbolConverter.create({ transport });
+    const assetId = converter.getAssetId(symbol);
+    if (assetId === undefined) {
+        throw new Error(`Failed to get asset ID for ${symbol}. The trading pair may not exist.`);
+    }
+    // Create PKP wallet
+    const pkpWallet = new lit_action_pkp_ethers_wallet_1.LitActionPkpEthersWallet(pkpPublicKey);
+    const pkpAddress = await pkpWallet.getAddress();
+    // Get all open orders for this user
+    const infoClient = new hyperliquid.InfoClient({ transport });
+    const openOrders = await infoClient.openOrders({
+        user: pkpAddress,
+    });
+    // Filter orders for the specific symbol/asset
+    const ordersToCancel = openOrders
+        .filter((order) => order.coin === symbol)
+        .map((order) => ({
+        a: assetId,
+        o: order.oid,
+    }));
+    if (ordersToCancel.length === 0) {
+        return {
+            status: 'error',
+            reason: 'No open orders to cancel',
+        };
+    }
+    const nonce = await (0, get_hyperliquid_nonce_1.getHyperliquidNonce)();
+    // Construct cancel action for all orders
+    const cancelAction = (0, exchange_1.parser)(exchange_1.CancelRequest.entries.action)({
+        type: 'cancel',
+        cancels: ordersToCancel,
+    });
+    // Sign and send
+    const signature = await (0, signing_1.signL1Action)({
+        wallet: pkpWallet,
+        action: cancelAction,
+        nonce,
+        isTestnet: useTestnet,
+    });
+    const cancelResult = await Lit.Actions.runOnce({ waitForResponse: true, name: 'HyperLiquidCancelAllOrdersRequest' }, async () => {
+        return JSON.stringify(await transport.request('exchange', {
+            action: cancelAction,
+            signature,
+            nonce,
+        }));
+    });
+    const parsedCancelResult = JSON.parse(cancelResult);
+    console.log('[cancelAllSpotOrders] Cancel result', parsedCancelResult);
+    return {
+        status: 'success',
+        cancelResult: parsedCancelResult.result,
+    };
+}
+//# sourceMappingURL=cancel-all-orders.js.map

package/dist/src/lib/ability-helpers/cancel-order/cancel-all-orders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-all-orders.js","sourceRoot":"","sources":["../../../../../src/lib/ability-helpers/cancel-order/cancel-all-orders.ts"],"names":[],"mappings":";;AAuBA,4DAgFC;;AAvGD,yEAAmD;AACnD,qDAA4D;AAC5D,+DAAyF;AACzF,yDAA2D;AAE3D,kFAA2E;AAC3E,oEAA+D;AAc/D;;GAEG;AACI,KAAK,UAAU,wBAAwB,CAAC,EAC7C,SAAS,EACT,YAAY,EACZ,MAAM,EACN,UAAU,GAAG,KAAK,GAMnB;IACC,uCAAuC;IACvC,MAAM,SAAS,GAAG,MAAM,uBAAe,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAE7C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,mCAAmC,CAAC,CAAC;IAC3F,CAAC;IAED,oBAAoB;IACpB,MAAM,SAAS,GAAG,IAAI,uDAAwB,CAAC,YAAY,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;IAEhD,oCAAoC;IACpC,MAAM,UAAU,GAAG,IAAI,WAAW,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC;QAC7C,IAAI,EAAE,UAA2B;KAClC,CAAC,CAAC;IAEH,8CAA8C;IAC9C,MAAM,cAAc,GAAG,UAAU;SAC9B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;SACxC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,CAAC,EAAE,OAAO;QACV,CAAC,EAAE,KAAK,CAAC,GAAG;KACb,CAAC,CAAC,CAAC;IAEN,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,MAAM,EAAE,OAAO;YACf,MAAM,EAAE,0BAA0B;SACnC,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,IAAA,2CAAmB,GAAE,CAAC;IAE1C,yCAAyC;IACzC,MAAM,YAAY,GAAG,IAAA,iBAAM,EAAC,wBAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,gBAAgB;IAChB,MAAM,SAAS,GAAG,MAAM,IAAA,sBAAY,EAAC;QACnC,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,YAAY;QACpB,KAAK;QACL,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,CAC5C,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,mCAAmC,EAAE,EACpE,KAAK,IAAI,EAAE;QACT,OAAO,IAAI,CAAC,SAAS,CACnB,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE;YAClC,MAAM,EAAE,YAAY;YACpB,SAAS;YACT,KAAK;SACN,CAAC,CACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,kBAAkB,CAAC,CAAC;IAEvE,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,YAAY,EAAE,kBAAkB,CAAC,MAAwB;KAC1D,CAAC;AACJ,CAAC"}

package/dist/src/lib/ability-helpers/cancel-order/cancel-order.d.ts

@@ -0,0 +1,25 @@
+import * as hyperliquid from '@nktkas/hyperliquid';
+import { CancelResponse } from '@nktkas/hyperliquid/api/exchange';
+export interface CancelSpotOrderParams {
+    symbol: string;
+    orderId: number;
+}
+export type CancelOrderResult = CancelOrderResultSuccess | CancelOrderResultFailure;
+export interface CancelOrderResultSuccess {
+    status: 'success';
+    cancelResult: CancelResponse;
+}
+export interface CancelOrderResultFailure {
+    status: 'error';
+    reason: string;
+}
+/**
+ * Cancel a specific spot order on Hyperliquid
+ */
+export declare function cancelOrder({ transport, pkpPublicKey, params, useTestnet, }: {
+    transport: hyperliquid.HttpTransport;
+    pkpPublicKey: string;
+    params: CancelSpotOrderParams;
+    useTestnet?: boolean;
+}): Promise<CancelOrderResult>;
+//# sourceMappingURL=cancel-order.d.ts.map

package/dist/src/lib/ability-helpers/cancel-order/cancel-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-order.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ability-helpers/cancel-order/cancel-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAiB,cAAc,EAAU,MAAM,kCAAkC,CAAC;AAOzF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,GAAG,wBAAwB,CAAC;AAEpF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,cAAc,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,EAChC,SAAS,EACT,YAAY,EACZ,MAAM,EACN,UAAkB,GACnB,EAAE;IACD,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiE7B"}

package/dist/src/lib/ability-helpers/cancel-order/cancel-order.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cancelOrder = cancelOrder;
+const utils_1 = require("@nktkas/hyperliquid/utils");
+const exchange_1 = require("@nktkas/hyperliquid/api/exchange");
+const signing_1 = require("@nktkas/hyperliquid/signing");
+const vincent_ability_sdk_1 = require("@lit-protocol/vincent-ability-sdk");
+const lit_action_pkp_ethers_wallet_1 = require("../lit-action-pkp-ethers-wallet");
+const get_hyperliquid_nonce_1 = require("../get-hyperliquid-nonce");
+/**
+ * Cancel a specific spot order on Hyperliquid
+ */
+async function cancelOrder({ transport, pkpPublicKey, params, useTestnet = false, }) {
+    // Get converter for symbol to asset ID
+    const converter = await utils_1.SymbolConverter.create({ transport });
+    const assetId = converter.getAssetId(params.symbol);
+    if (assetId === undefined) {
+        throw new Error(`Failed to get asset ID for ${params.symbol}. The trading pair may not exist.`);
+    }
+    // Create PKP wallet
+    const pkpWallet = new lit_action_pkp_ethers_wallet_1.LitActionPkpEthersWallet(pkpPublicKey);
+    const nonce = await (0, get_hyperliquid_nonce_1.getHyperliquidNonce)();
+    // Construct cancel action
+    const cancelAction = (0, exchange_1.parser)(exchange_1.CancelRequest.entries.action)({
+        type: 'cancel',
+        cancels: [
+            {
+                a: assetId,
+                o: params.orderId,
+            },
+        ],
+    });
+    // Sign and send
+    const signature = await (0, signing_1.signL1Action)({
+        wallet: pkpWallet,
+        action: cancelAction,
+        nonce,
+        isTestnet: useTestnet,
+    });
+    const cancelResult = await Lit.Actions.runOnce({ waitForResponse: true, name: 'HyperLiquidCancelOrderRequest' }, async () => {
+        return JSON.stringify({
+            result: await transport.request('exchange', {
+                action: cancelAction,
+                signature,
+                nonce,
+            }),
+        }, vincent_ability_sdk_1.bigIntReplacer, 2);
+    });
+    const parsedCancelResult = JSON.parse(cancelResult);
+    console.log('[cancelSpotOrder] Cancel result', parsedCancelResult);
+    const cancelStatus = parsedCancelResult.result.response.data.statuses[0];
+    if (typeof cancelStatus === 'object' && cancelStatus.error !== undefined) {
+        return {
+            status: 'error',
+            reason: cancelStatus.error,
+        };
+    }
+    return {
+        status: 'success',
+        cancelResult: parsedCancelResult.result,
+    };
+}
+//# sourceMappingURL=cancel-order.js.map

package/dist/src/lib/ability-helpers/cancel-order/cancel-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-order.js","sourceRoot":"","sources":["../../../../../src/lib/ability-helpers/cancel-order/cancel-order.ts"],"names":[],"mappings":";;AA6BA,kCA2EC;AAvGD,qDAA4D;AAC5D,+DAAyF;AACzF,yDAA2D;AAC3D,2EAAmE;AAEnE,kFAA2E;AAC3E,oEAA+D;AAmB/D;;GAEG;AACI,KAAK,UAAU,WAAW,CAAC,EAChC,SAAS,EACT,YAAY,EACZ,MAAM,EACN,UAAU,GAAG,KAAK,GAMnB;IACC,uCAAuC;IACvC,MAAM,SAAS,GAAG,MAAM,uBAAe,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEpD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,MAAM,mCAAmC,CAAC,CAAC;IAClG,CAAC;IAED,oBAAoB;IACpB,MAAM,SAAS,GAAG,IAAI,uDAAwB,CAAC,YAAY,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,MAAM,IAAA,2CAAmB,GAAE,CAAC;IAE1C,0BAA0B;IAC1B,MAAM,YAAY,GAAG,IAAA,iBAAM,EAAC,wBAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP;gBACE,CAAC,EAAE,OAAO;gBACV,CAAC,EAAE,MAAM,CAAC,OAAO;aAClB;SACF;KACF,CAAC,CAAC;IAEH,gBAAgB;IAChB,MAAM,SAAS,GAAG,MAAM,IAAA,sBAAY,EAAC;QACnC,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,YAAY;QACpB,KAAK;QACL,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,CAC5C,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,+BAA+B,EAAE,EAChE,KAAK,IAAI,EAAE;QACT,OAAO,IAAI,CAAC,SAAS,CACnB;YACE,MAAM,EAAE,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE;gBAC1C,MAAM,EAAE,YAAY;gBACpB,SAAS;gBACT,KAAK;aACN,CAAC;SACH,EACD,oCAAc,EACd,CAAC,CACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,kBAAkB,CAAC,CAAC;IAEnE,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEzE,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACzE,OAAO;YACL,MAAM,EAAE,OAAO;YACf,MAAM,EAAE,YAAY,CAAC,KAAK;SAC3B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,YAAY,EAAE,kBAAkB,CAAC,MAAwB;KAC1D,CAAC;AACJ,CAAC"}

package/dist/src/lib/ability-helpers/execute-perp-order.d.ts

@@ -0,0 +1,65 @@
+import * as hyperliquid from '@nktkas/hyperliquid';
+import { OrderResponse } from '@nktkas/hyperliquid/api/exchange';
+export type TimeInForce = 'Gtc' | 'Ioc' | 'Alo';
+export interface PerpTradeParams {
+    symbol: string;
+    price: string;
+    size: string;
+    isLong: boolean;
+    /**
+     * Reduce-only flag. If true, order will only reduce existing position.
+     * Use this to close positions - the order will only fill up to the position size.
+     * @default false
+     */
+    reduceOnly?: boolean;
+    /**
+     * Order type configuration.
+     * - For limit orders: specify { type: 'limit', tif: 'Gtc' | 'Ioc' | 'Alo' }
+     * - For market orders: specify { type: 'market' }
+     * @default { type: 'limit', tif: 'Gtc' }
+     */
+    orderType?: {
+        type: 'limit';
+        tif: TimeInForce;
+    } | {
+        type: 'market';
+    };
+    /**
+     * Leverage configuration.
+     * Required parameter - must specify leverage (1-10x) and margin type.
+     */
+    leverage: {
+        leverage: number;
+        isCross: boolean;
+    };
+    /**
+     * Builder fee configuration.
+     * Applies to both long and short orders for perpetuals.
+     * Fee is specified in tenths of basis points (e.g., 10 = 0.01% = 1 basis point).
+     * Maximum builder fee is 0.1% (100 tenths of basis points) for perps.
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#builder-codes
+     */
+    builderFee?: {
+        builderAddress: string;
+        feeInTenthsOfBps: number;
+    };
+}
+export type PerpOrderResult = PerpOrderResultSuccess | PerpOrderResultFailure;
+export interface PerpOrderResultSuccess {
+    status: 'success';
+    orderResult: OrderResponse;
+}
+export interface PerpOrderResultFailure {
+    status: 'error';
+    error: string;
+}
+/**
+ * Execute a perpetual trade on Hyperliquid
+ */
+export declare function executePerpOrder({ transport, pkpPublicKey, params, useTestnet, }: {
+    transport: hyperliquid.HttpTransport;
+    pkpPublicKey: string;
+    params: PerpTradeParams;
+    useTestnet?: boolean;
+}): Promise<PerpOrderResult>;
+//# sourceMappingURL=execute-perp-order.d.ts.map

package/dist/src/lib/ability-helpers/execute-perp-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-perp-order.d.ts","sourceRoot":"","sources":["../../../../src/lib/ability-helpers/execute-perp-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAEL,aAAa,EAGd,MAAM,kCAAkC,CAAC;AAO1C,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,WAAW,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;IACrE;;;OAGG;IACH,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF;;;;;;OAMG;IACH,UAAU,CAAC,EAAE;QACX,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAE9E,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,aAAa,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,SAAS,EACT,YAAY,EACZ,MAAM,EACN,UAAkB,GACnB,EAAE;IACD,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,eAAe,CAAC,CAsJ3B"}

package/dist/src/lib/ability-helpers/execute-perp-order.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executePerpOrder = executePerpOrder;
+const utils_1 = require("@nktkas/hyperliquid/utils");
+const exchange_1 = require("@nktkas/hyperliquid/api/exchange");
+const signing_1 = require("@nktkas/hyperliquid/signing");
+const vincent_ability_sdk_1 = require("@lit-protocol/vincent-ability-sdk");
+const lit_action_pkp_ethers_wallet_1 = require("./lit-action-pkp-ethers-wallet");
+const get_hyperliquid_nonce_1 = require("./get-hyperliquid-nonce");
+/**
+ * Execute a perpetual trade on Hyperliquid
+ */
+async function executePerpOrder({ transport, pkpPublicKey, params, useTestnet = false, }) {
+    // Get converter for symbol to asset ID
+    const converter = await utils_1.SymbolConverter.create({ transport });
+    const assetId = converter.getAssetId(params.symbol);
+    if (assetId === undefined) {
+        throw new Error(`Failed to get asset ID for ${params.symbol}. The perpetual contract may not exist.`);
+    }
+    // Create PKP wallet
+    const pkpWallet = new lit_action_pkp_ethers_wallet_1.LitActionPkpEthersWallet(pkpPublicKey);
+    // Set leverage if specified
+    if (params.leverage) {
+        const leverageNonceResponse = await Lit.Actions.runOnce({ waitForResponse: true, name: 'HyperLiquidPerpLeverageNonce' }, async () => {
+            return Date.now().toString();
+        });
+        const leverageNonce = parseInt(leverageNonceResponse);
+        const updateLeverageAction = (0, exchange_1.parser)(exchange_1.UpdateLeverageRequest.entries.action)({
+            type: 'updateLeverage',
+            asset: assetId,
+            isCross: params.leverage.isCross,
+            leverage: params.leverage.leverage,
+        });
+        const leverageSignature = await (0, signing_1.signL1Action)({
+            wallet: pkpWallet,
+            action: updateLeverageAction,
+            nonce: leverageNonce,
+            isTestnet: useTestnet,
+        });
+        await Lit.Actions.runOnce({ waitForResponse: true, name: 'HyperLiquidPerpLeverageRequest' }, async () => {
+            return JSON.stringify(await transport.request('exchange', {
+                action: updateLeverageAction,
+                signature: leverageSignature,
+                nonce: leverageNonce,
+            }));
+        });
+        console.log(`[executePerpOrder] Set leverage to ${params.leverage.leverage}x (${params.leverage.isCross ? 'cross' : 'isolated'})`);
+    }
+    const nonce = await (0, get_hyperliquid_nonce_1.getHyperliquidNonce)();
+    // Determine order type configuration
+    const orderType = params.orderType || { type: 'limit', tif: 'Gtc' };
+    // Construct order type field based on orderType
+    const orderTypeField = orderType.type === 'market'
+        ? { limit: { tif: 'FrontendMarket' } }
+        : { limit: { tif: orderType.tif } };
+    // Construct order action
+    const orderActionParams = {
+        type: 'order',
+        orders: [
+            {
+                a: assetId,
+                b: params.isLong, // true for long (buy), false for short (sell)
+                p: params.price,
+                s: params.size,
+                r: params.reduceOnly ?? false, // reduce only (true to close positions, false for opening)
+                t: orderTypeField,
+            },
+        ],
+        grouping: 'na',
+    };
+    // Add builder fee if provided
+    // Builder codes apply to both long and short orders for perpetuals
+    if (params.builderFee) {
+        orderActionParams.builder = {
+            b: params.builderFee.builderAddress,
+            f: params.builderFee.feeInTenthsOfBps,
+        };
+    }
+    const orderAction = (0, exchange_1.parser)(exchange_1.OrderRequest.entries.action)(orderActionParams);
+    // Sign and send
+    const signature = await (0, signing_1.signL1Action)({
+        wallet: pkpWallet,
+        action: orderAction,
+        nonce,
+        isTestnet: useTestnet,
+    });
+    const orderResult = await Lit.Actions.runOnce({ waitForResponse: true, name: 'HyperLiquidPerpOrderRequest' }, async () => {
+        return JSON.stringify({
+            result: await transport.request('exchange', {
+                action: orderAction,
+                signature,
+                nonce,
+            }),
+        }, vincent_ability_sdk_1.bigIntReplacer, 2);
+    });
+    const parsedOrderResult = JSON.parse(orderResult);
+    console.log('[executePerpOrder] Order result', parsedOrderResult);
+    const perpOrderStatus = parsedOrderResult.result.response.data.statuses[0];
+    if (perpOrderStatus.error !== undefined) {
+        return {
+            status: 'error',
+            error: perpOrderStatus.error,
+        };
+    }
+    return {
+        status: 'success',
+        orderResult: parsedOrderResult.result,
+    };
+}
+//# sourceMappingURL=execute-perp-order.js.map

package/dist/src/lib/ability-helpers/execute-perp-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-perp-order.js","sourceRoot":"","sources":["../../../../src/lib/ability-helpers/execute-perp-order.ts"],"names":[],"mappings":"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"}