@lit-protocol/vincent-ability-hyperliquid 3.0.0

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

@@ -0,0 +1,18 @@
+import { ethers } from 'ethers';
+export type DepositPrechecksResult = DepositPrechecksResultSuccess | DepositPrechecksResultFailure;
+export interface DepositPrechecksResultSuccess {
+    success: true;
+    availableBalance: string;
+}
+export interface DepositPrechecksResultFailure {
+    success: false;
+    reason: string;
+    availableBalance?: string;
+}
+export declare const depositPrechecks: ({ provider, agentWalletPkpEthAddress, depositAmountInMicroUsdc, }: {
+    provider: ethers.providers.Provider;
+    agentWalletPkpEthAddress: string;
+    depositAmountInMicroUsdc: string;
+    useTestnet?: boolean;
+}) => Promise<DepositPrechecksResult>;
+//# sourceMappingURL=deposit-usdc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deposit-usdc.d.ts","sourceRoot":"","sources":["../../../../src/lib/ability-checks/deposit-usdc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhC,MAAM,MAAM,sBAAsB,GAAG,6BAA6B,GAAG,6BAA6B,CAAC;AAEnG,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,IAAI,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAKD,eAAO,MAAM,gBAAgB,GAAU,mEAIpC;IACD,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IACpC,wBAAwB,EAAE,MAAM,CAAC;IACjC,wBAAwB,EAAE,MAAM,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,KAAG,OAAO,CAAC,sBAAsB,CAiCjC,CAAC"}

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

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.depositPrechecks = void 0;
+const ethers_1 = require("ethers");
+const vincent_ability_sdk_1 = require("@lit-protocol/vincent-ability-sdk");
+const types_1 = require("../types");
+// https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/bridge2#deposit
+const MIN_USDC_DEPOSIT_AMOUNT = ethers_1.ethers.BigNumber.from('5000000');
+const depositPrechecks = async ({ provider, agentWalletPkpEthAddress, depositAmountInMicroUsdc, }) => {
+    const usdcContract = new ethers_1.ethers.Contract(types_1.ARBITRUM_USDC_ADDRESS_MAINNET, vincent_ability_sdk_1.ERC20_ABI, provider);
+    const ethBalance = await provider.getBalance(agentWalletPkpEthAddress);
+    if (ethBalance.eq(0n)) {
+        return {
+            success: false,
+            reason: `Agent Wallet PKP has no ETH balance. Please fund the Agent Wallet PKP with ETH`,
+        };
+    }
+    const usdcBalance = await usdcContract.balanceOf(agentWalletPkpEthAddress);
+    const _depositAmountInMicroUsdc = ethers_1.ethers.BigNumber.from(depositAmountInMicroUsdc);
+    if (_depositAmountInMicroUsdc.lt(MIN_USDC_DEPOSIT_AMOUNT)) {
+        return {
+            success: false,
+            reason: `Deposit amount is less than the minimum deposit amount. Minimum deposit amount required: ${ethers_1.ethers.utils.formatUnits(MIN_USDC_DEPOSIT_AMOUNT, 6)} USDC`,
+            availableBalance: ethers_1.ethers.utils.formatUnits(usdcBalance, 6),
+        };
+    }
+    if (usdcBalance.lt(_depositAmountInMicroUsdc)) {
+        return {
+            success: false,
+            reason: `Insufficient USDC balance. Attempted deposit amount: ${ethers_1.ethers.utils.formatUnits(depositAmountInMicroUsdc, 6)} USDC, Available balance: ${ethers_1.ethers.utils.formatUnits(usdcBalance, 6)} USDC`,
+            availableBalance: ethers_1.ethers.utils.formatUnits(usdcBalance, 6),
+        };
+    }
+    return {
+        success: true,
+        availableBalance: ethers_1.ethers.utils.formatUnits(usdcBalance, 6),
+    };
+};
+exports.depositPrechecks = depositPrechecks;
+//# sourceMappingURL=deposit-usdc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deposit-usdc.js","sourceRoot":"","sources":["../../../../src/lib/ability-checks/deposit-usdc.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAChC,2EAA8D;AAE9D,oCAAyD;AAezD,qFAAqF;AACrF,MAAM,uBAAuB,GAAG,eAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAE1D,MAAM,gBAAgB,GAAG,KAAK,EAAE,EACrC,QAAQ,EACR,wBAAwB,EACxB,wBAAwB,GAMzB,EAAmC,EAAE;IACpC,MAAM,YAAY,GAAG,IAAI,eAAM,CAAC,QAAQ,CAAC,qCAA6B,EAAE,+BAAS,EAAE,QAAQ,CAAC,CAAC;IAE7F,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;IACvE,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,gFAAgF;SACzF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAC3E,MAAM,yBAAyB,GAAG,eAAM,CAAC,SAAS,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAClF,IAAI,yBAAyB,CAAC,EAAE,CAAC,uBAAuB,CAAC,EAAE,CAAC;QAC1D,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,4FAA4F,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,uBAAuB,EAAE,CAAC,CAAC,OAAO;YAC/J,gBAAgB,EAAE,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;SAC3D,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,CAAC,EAAE,CAAC,yBAAyB,CAAC,EAAE,CAAC;QAC9C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,wDAAwD,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,wBAAwB,EAAE,CAAC,CAAC,6BAA6B,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO;YACjM,gBAAgB,EAAE,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;SAC3D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,gBAAgB,EAAE,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;KAC3D,CAAC;AACJ,CAAC,CAAC;AA1CW,QAAA,gBAAgB,oBA0C3B"}

package/dist/src/lib/ability-checks/hyperliquid-account-exists.d.ts

@@ -0,0 +1,6 @@
+import type { InfoClient } from '@nktkas/hyperliquid';
+export declare const hyperliquidAccountExists: ({ infoClient, ethAddress, }: {
+    infoClient: InfoClient;
+    ethAddress: string;
+}) => Promise<boolean>;
+//# sourceMappingURL=hyperliquid-account-exists.d.ts.map

package/dist/src/lib/ability-checks/hyperliquid-account-exists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperliquid-account-exists.d.ts","sourceRoot":"","sources":["../../../../src/lib/ability-checks/hyperliquid-account-exists.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,eAAO,MAAM,wBAAwB,GAAU,6BAG5C;IACD,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,qBAkBA,CAAC"}

package/dist/src/lib/ability-checks/hyperliquid-account-exists.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hyperliquidAccountExists = void 0;
+const hyperliquidAccountExists = async ({ infoClient, ethAddress, }) => {
+    try {
+        await infoClient.clearinghouseState({ user: ethAddress });
+        return true;
+    }
+    catch (error) {
+        console.error('[@lit-protocol/vincent-ability-hyperliquid precheck] Error checking clearinghouse state', error);
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('does not exist')) {
+            return false;
+        }
+        else {
+            // Unknown error occurred - not a "does not exist" error
+            throw error;
+        }
+    }
+};
+exports.hyperliquidAccountExists = hyperliquidAccountExists;
+//# sourceMappingURL=hyperliquid-account-exists.js.map

package/dist/src/lib/ability-checks/hyperliquid-account-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperliquid-account-exists.js","sourceRoot":"","sources":["../../../../src/lib/ability-checks/hyperliquid-account-exists.ts"],"names":[],"mappings":";;;AAEO,MAAM,wBAAwB,GAAG,KAAK,EAAE,EAC7C,UAAU,EACV,UAAU,GAIX,EAAE,EAAE;IACH,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,yFAAyF,EACzF,KAAK,CACN,CAAC;QAEF,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,IAAI,YAAY,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC5C,OAAO,KAAK,CAAC;QACf,CAAC;aAAM,CAAC;YACN,wDAAwD;YACxD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAxBW,QAAA,wBAAwB,4BAwBnC"}

package/dist/src/lib/ability-checks/index.d.ts

@@ -0,0 +1,11 @@
+export { hyperliquidAccountExists } from './hyperliquid-account-exists';
+export { depositPrechecks } from './deposit-usdc';
+export { transferPrechecks } from './transfer-usdc';
+export { spotTradePrechecks } from './spot';
+export { perpTradePrechecks } from './perp';
+export { cancelOrderPrechecks, cancelAllOrdersForSymbolPrechecks } from './cancel';
+export { withdrawPrechecks } from './withdraw-usdc';
+export { sendSpotAssetPrechecks } from './send-spot-asset';
+export { sendPerpUsdcPrechecks } from './send-perp-usdc';
+export { isBuilderCodeApproved } from './is-builder-code-approved';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/ability-checks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,iCAAiC,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/lib/ability-checks/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBuilderCodeApproved = exports.sendPerpUsdcPrechecks = exports.sendSpotAssetPrechecks = exports.withdrawPrechecks = exports.cancelAllOrdersForSymbolPrechecks = exports.cancelOrderPrechecks = exports.perpTradePrechecks = exports.spotTradePrechecks = exports.transferPrechecks = exports.depositPrechecks = exports.hyperliquidAccountExists = void 0;
+var hyperliquid_account_exists_1 = require("./hyperliquid-account-exists");
+Object.defineProperty(exports, "hyperliquidAccountExists", { enumerable: true, get: function () { return hyperliquid_account_exists_1.hyperliquidAccountExists; } });
+var deposit_usdc_1 = require("./deposit-usdc");
+Object.defineProperty(exports, "depositPrechecks", { enumerable: true, get: function () { return deposit_usdc_1.depositPrechecks; } });
+var transfer_usdc_1 = require("./transfer-usdc");
+Object.defineProperty(exports, "transferPrechecks", { enumerable: true, get: function () { return transfer_usdc_1.transferPrechecks; } });
+var spot_1 = require("./spot");
+Object.defineProperty(exports, "spotTradePrechecks", { enumerable: true, get: function () { return spot_1.spotTradePrechecks; } });
+var perp_1 = require("./perp");
+Object.defineProperty(exports, "perpTradePrechecks", { enumerable: true, get: function () { return perp_1.perpTradePrechecks; } });
+var cancel_1 = require("./cancel");
+Object.defineProperty(exports, "cancelOrderPrechecks", { enumerable: true, get: function () { return cancel_1.cancelOrderPrechecks; } });
+Object.defineProperty(exports, "cancelAllOrdersForSymbolPrechecks", { enumerable: true, get: function () { return cancel_1.cancelAllOrdersForSymbolPrechecks; } });
+var withdraw_usdc_1 = require("./withdraw-usdc");
+Object.defineProperty(exports, "withdrawPrechecks", { enumerable: true, get: function () { return withdraw_usdc_1.withdrawPrechecks; } });
+var send_spot_asset_1 = require("./send-spot-asset");
+Object.defineProperty(exports, "sendSpotAssetPrechecks", { enumerable: true, get: function () { return send_spot_asset_1.sendSpotAssetPrechecks; } });
+var send_perp_usdc_1 = require("./send-perp-usdc");
+Object.defineProperty(exports, "sendPerpUsdcPrechecks", { enumerable: true, get: function () { return send_perp_usdc_1.sendPerpUsdcPrechecks; } });
+var is_builder_code_approved_1 = require("./is-builder-code-approved");
+Object.defineProperty(exports, "isBuilderCodeApproved", { enumerable: true, get: function () { return is_builder_code_approved_1.isBuilderCodeApproved; } });
+//# sourceMappingURL=index.js.map

package/dist/src/lib/ability-checks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/ability-checks/index.ts"],"names":[],"mappings":";;;AAAA,2EAAwE;AAA/D,sIAAA,wBAAwB,OAAA;AACjC,+CAAkD;AAAzC,gHAAA,gBAAgB,OAAA;AACzB,iDAAoD;AAA3C,kHAAA,iBAAiB,OAAA;AAC1B,+BAA4C;AAAnC,0GAAA,kBAAkB,OAAA;AAC3B,+BAA4C;AAAnC,0GAAA,kBAAkB,OAAA;AAC3B,mCAAmF;AAA1E,8GAAA,oBAAoB,OAAA;AAAE,2HAAA,iCAAiC,OAAA;AAChE,iDAAoD;AAA3C,kHAAA,iBAAiB,OAAA;AAC1B,qDAA2D;AAAlD,yHAAA,sBAAsB,OAAA;AAC/B,mDAAyD;AAAhD,uHAAA,qBAAqB,OAAA;AAC9B,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA"}

package/dist/src/lib/ability-checks/is-builder-code-approved.d.ts

@@ -0,0 +1,14 @@
+import type { InfoClient } from '@nktkas/hyperliquid';
+/**
+ * Check if a given address has approved a given builder address
+ * @param infoClient - Hyperliquid InfoClient instance
+ * @param ethAddress - Ethereum address to check approval for
+ * @param builderAddress - Builder address to check approval for
+ * @returns true if the builder is approved, false otherwise
+ */
+export declare const isBuilderCodeApproved: ({ infoClient, ethAddress, builderAddress, }: {
+    infoClient: InfoClient;
+    ethAddress: string;
+    builderAddress: string;
+}) => Promise<boolean>;
+//# sourceMappingURL=is-builder-code-approved.d.ts.map

package/dist/src/lib/ability-checks/is-builder-code-approved.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-builder-code-approved.d.ts","sourceRoot":"","sources":["../../../../src/lib/ability-checks/is-builder-code-approved.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAU,6CAIzC;IACD,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB,KAAG,OAAO,CAAC,OAAO,CAmBlB,CAAC"}

package/dist/src/lib/ability-checks/is-builder-code-approved.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBuilderCodeApproved = void 0;
+/**
+ * Check if a given address has approved a given builder address
+ * @param infoClient - Hyperliquid InfoClient instance
+ * @param ethAddress - Ethereum address to check approval for
+ * @param builderAddress - Builder address to check approval for
+ * @returns true if the builder is approved, false otherwise
+ */
+const isBuilderCodeApproved = async ({ infoClient, ethAddress, builderAddress, }) => {
+    // Call maxBuilderFee to get the maximum builder fee approved for this builder
+    // If the builder is not approved, this will return 0
+    const maxFee = await infoClient.maxBuilderFee({
+        user: ethAddress,
+        builder: builderAddress,
+    });
+    // Builder is approved if maxFee is greater than 0
+    const isApproved = typeof maxFee === 'number' && maxFee > 0;
+    console.log('[isBuilderCodeApproved] Builder approval check', {
+        ethAddress,
+        builderAddress,
+        maxFee,
+        isApproved,
+    });
+    return isApproved;
+};
+exports.isBuilderCodeApproved = isBuilderCodeApproved;
+//# sourceMappingURL=is-builder-code-approved.js.map

package/dist/src/lib/ability-checks/is-builder-code-approved.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-builder-code-approved.js","sourceRoot":"","sources":["../../../../src/lib/ability-checks/is-builder-code-approved.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACI,MAAM,qBAAqB,GAAG,KAAK,EAAE,EAC1C,UAAU,EACV,UAAU,EACV,cAAc,GAKf,EAAoB,EAAE;IACrB,8EAA8E;IAC9E,qDAAqD;IACrD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC;QAC5C,IAAI,EAAE,UAA2B;QACjC,OAAO,EAAE,cAA+B;KACzC,CAAC,CAAC;IAEH,kDAAkD;IAClD,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,GAAG,CAAC,CAAC;IAE5D,OAAO,CAAC,GAAG,CAAC,gDAAgD,EAAE;QAC5D,UAAU;QACV,cAAc;QACd,MAAM;QACN,UAAU;KACX,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AA3BW,QAAA,qBAAqB,yBA2BhC"}

package/dist/src/lib/ability-checks/perp.d.ts

@@ -0,0 +1,23 @@
+import * as hyperliquid from '@nktkas/hyperliquid';
+export type PerpTradePrechecksResult = PerpTradePrechecksResultSuccess | PerpTradePrechecksResultFailure;
+export interface PerpTradePrechecksResultSuccess {
+    success: true;
+    availableMargin: string;
+}
+export interface PerpTradePrechecksResultFailure {
+    success: false;
+    reason: string;
+    availableMargin?: string;
+}
+export interface PerpTradeParams {
+    symbol: string;
+}
+/**
+ * Check if perpetual trade can be executed
+ */
+export declare function perpTradePrechecks({ transport, ethAddress, params, }: {
+    transport: hyperliquid.HttpTransport;
+    ethAddress: string;
+    params: PerpTradeParams;
+}): Promise<PerpTradePrechecksResult>;
+//# sourceMappingURL=perp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"perp.d.ts","sourceRoot":"","sources":["../../../../src/lib/ability-checks/perp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AAGnD,MAAM,MAAM,wBAAwB,GAChC,+BAA+B,GAC/B,+BAA+B,CAAC;AAEpC,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,IAAI,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,SAAS,EACT,UAAU,EACV,MAAM,GACP,EAAE;IACD,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;CACzB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAyCpC"}

package/dist/src/lib/ability-checks/perp.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.perpTradePrechecks = perpTradePrechecks;
+const tslib_1 = require("tslib");
+const ethers_1 = require("ethers");
+const hyperliquid = tslib_1.__importStar(require("@nktkas/hyperliquid"));
+const utils_1 = require("@nktkas/hyperliquid/utils");
+/**
+ * Check if perpetual trade can be executed
+ */
+async function perpTradePrechecks({ transport, ethAddress, params, }) {
+    const converter = await utils_1.SymbolConverter.create({ transport });
+    const assetId = converter.getAssetId(params.symbol);
+    if (assetId === undefined) {
+        return {
+            success: false,
+            reason: `Perpetual contract ${params.symbol} does not exist`,
+        };
+    }
+    // Check perp balance to ensure user has funds
+    const infoClient = new hyperliquid.InfoClient({ transport });
+    const perpState = await infoClient.clearinghouseState({
+        user: ethAddress,
+    });
+    // Check if user has any cross margin value or margin summary
+    if (!perpState.crossMarginSummary) {
+        return {
+            success: false,
+            reason: 'No perp account found. Please transfer funds to perp account first.',
+        };
+    }
+    // Check if user has available margin
+    // accountValue is in USDC with 6 decimals
+    const availableMarginBN = ethers_1.ethers.utils.parseUnits(perpState.crossMarginSummary.accountValue, 6);
+    if (availableMarginBN.lte(0)) {
+        return {
+            success: false,
+            reason: 'Insufficient perp account balance. Please transfer funds to perp account first.',
+            availableMargin: '0',
+        };
+    }
+    return {
+        success: true,
+        availableMargin: perpState.crossMarginSummary.accountValue,
+    };
+}
+//# sourceMappingURL=perp.js.map

package/dist/src/lib/ability-checks/perp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perp.js","sourceRoot":"","sources":["../../../../src/lib/ability-checks/perp.ts"],"names":[],"mappings":";;AA0BA,gDAiDC;;AA3ED,mCAAgC;AAChC,yEAAmD;AACnD,qDAA4D;AAqB5D;;GAEG;AACI,KAAK,UAAU,kBAAkB,CAAC,EACvC,SAAS,EACT,UAAU,EACV,MAAM,GAKP;IACC,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,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,sBAAsB,MAAM,CAAC,MAAM,iBAAiB;SAC7D,CAAC;IACJ,CAAC;IAED,8CAA8C;IAC9C,MAAM,UAAU,GAAG,IAAI,WAAW,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,kBAAkB,CAAC;QACpD,IAAI,EAAE,UAAU;KACjB,CAAC,CAAC;IAEH,6DAA6D;IAC7D,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,qEAAqE;SAC9E,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,0CAA0C;IAC1C,MAAM,iBAAiB,GAAG,eAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,kBAAkB,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAEhG,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,iFAAiF;YACzF,eAAe,EAAE,GAAG;SACrB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,eAAe,EAAE,SAAS,CAAC,kBAAkB,CAAC,YAAY;KAC3D,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,26 @@
+import * as hyperliquid from '@nktkas/hyperliquid';
+export type SendPerpUsdcPrechecksResult = SendPerpUsdcPrechecksResultSuccess | SendPerpUsdcPrechecksResultFailure;
+export interface SendPerpUsdcPrechecksResultSuccess {
+    success: true;
+    availableBalance: string;
+    requiredBalance: string;
+}
+export interface SendPerpUsdcPrechecksResultFailure {
+    success: false;
+    reason: string;
+    availableBalance?: string;
+    requiredBalance?: string;
+}
+export interface SendPerpUsdcParams {
+    destination: string;
+    amount: string;
+}
+/**
+ * Check if sending USDC from perp account to another Hyperliquid perp account can be executed
+ */
+export declare function sendPerpUsdcPrechecks({ infoClient, ethAddress, params, }: {
+    infoClient: hyperliquid.InfoClient;
+    ethAddress: string;
+    params: SendPerpUsdcParams;
+}): Promise<SendPerpUsdcPrechecksResult>;
+//# sourceMappingURL=send-perp-usdc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send-perp-usdc.d.ts","sourceRoot":"","sources":["../../../../src/lib/ability-checks/send-perp-usdc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,2BAA2B,GACnC,kCAAkC,GAClC,kCAAkC,CAAC;AAEvC,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,IAAI,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kCAAkC;IACjD,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,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,UAAU,EACV,UAAU,EACV,MAAM,GACP,EAAE;IACD,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;CAC5B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAqCvC"}

package/dist/src/lib/ability-checks/send-perp-usdc.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendPerpUsdcPrechecks = sendPerpUsdcPrechecks;
+const ethers_1 = require("ethers");
+/**
+ * Check if sending USDC from perp account to another Hyperliquid perp account can be executed
+ */
+async function sendPerpUsdcPrechecks({ infoClient, ethAddress, params, }) {
+    // Validate destination address
+    if (!ethers_1.ethers.utils.isAddress(params.destination)) {
+        return {
+            success: false,
+            reason: `Invalid destination address: ${params.destination}`,
+        };
+    }
+    // Get perp account balance
+    const clearinghouseState = await infoClient.clearinghouseState({
+        user: ethAddress,
+    });
+    const availableUsdcBalance = ethers_1.ethers.utils.parseUnits(clearinghouseState.marginSummary.accountValue, 6);
+    console.log('[sendPerpUsdcPrechecks] Available balance:', availableUsdcBalance);
+    const requestedAmount = ethers_1.ethers.BigNumber.from(params.amount);
+    console.log('[sendPerpUsdcPrechecks] Requested amount:', requestedAmount);
+    if (availableUsdcBalance.lt(requestedAmount)) {
+        return {
+            success: false,
+            reason: `Insufficient perp balance for send. 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=send-perp-usdc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send-perp-usdc.js","sourceRoot":"","sources":["../../../../src/lib/ability-checks/send-perp-usdc.ts"],"names":[],"mappings":";;AA4BA,sDA6CC;AAzED,mCAAgC;AAyBhC;;GAEG;AACI,KAAK,UAAU,qBAAqB,CAAC,EAC1C,UAAU,EACV,UAAU,EACV,MAAM,GAKP;IACC,+BAA+B;IAC/B,IAAI,CAAC,eAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAChD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,gCAAgC,MAAM,CAAC,WAAW,EAAE;SAC7D,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,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;IACF,OAAO,CAAC,GAAG,CAAC,4CAA4C,EAAE,oBAAoB,CAAC,CAAC;IAEhF,MAAM,eAAe,GAAG,eAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,2CAA2C,EAAE,eAAe,CAAC,CAAC;IAE1E,IAAI,oBAAoB,CAAC,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;QAC7C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,kDAAkD,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,oBAAoB,EAAE,CAAC,CAAC,qBAAqB,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC,OAAO;YACnL,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-checks/send-spot-asset.d.ts

@@ -0,0 +1,27 @@
+import * as hyperliquid from '@nktkas/hyperliquid';
+export type SendSpotAssetPrechecksResult = SendSpotAssetPrechecksResultSuccess | SendSpotAssetPrechecksResultFailure;
+export interface SendSpotAssetPrechecksResultSuccess {
+    success: true;
+    availableBalance: string;
+    requiredBalance: string;
+}
+export interface SendSpotAssetPrechecksResultFailure {
+    success: false;
+    reason: string;
+    availableBalance?: string;
+    requiredBalance?: string;
+}
+export interface SendSpotAssetParams {
+    destination: string;
+    token: string;
+    amount: string;
+}
+/**
+ * Check if sending spot assets to another Hyperliquid spot account can be executed
+ */
+export declare function sendSpotAssetPrechecks({ infoClient, ethAddress, params, }: {
+    infoClient: hyperliquid.InfoClient;
+    ethAddress: string;
+    params: SendSpotAssetParams;
+}): Promise<SendSpotAssetPrechecksResult>;
+//# sourceMappingURL=send-spot-asset.d.ts.map

package/dist/src/lib/ability-checks/send-spot-asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-spot-asset.d.ts","sourceRoot":"","sources":["../../../../src/lib/ability-checks/send-spot-asset.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,4BAA4B,GACpC,mCAAmC,GACnC,mCAAmC,CAAC;AAExC,MAAM,WAAW,mCAAmC;IAClD,OAAO,EAAE,IAAI,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mCAAmC;IAClD,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,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,UAAU,EACV,UAAU,EACV,MAAM,GACP,EAAE;IACD,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC;CAC7B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CA+DxC"}

package/dist/src/lib/ability-checks/send-spot-asset.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendSpotAssetPrechecks = sendSpotAssetPrechecks;
+const ethers_1 = require("ethers");
+/**
+ * Check if sending spot assets to another Hyperliquid spot account can be executed
+ */
+async function sendSpotAssetPrechecks({ infoClient, ethAddress, params, }) {
+    // Validate destination address
+    if (!ethers_1.ethers.utils.isAddress(params.destination)) {
+        return {
+            success: false,
+            reason: `Invalid destination address: ${params.destination}`,
+        };
+    }
+    // Fetch token metadata to get the correct decimal places
+    const spotMeta = await infoClient.spotMeta();
+    const tokenInfo = spotMeta.tokens.find((t) => t.name === params.token);
+    if (!tokenInfo) {
+        return {
+            success: false,
+            reason: `Token ${params.token} not found in spot metadata`,
+        };
+    }
+    // Get spot balances
+    const spotClearinghouseState = await infoClient.spotClearinghouseState({
+        user: ethAddress,
+    });
+    // Find the token balance
+    const tokenBalance = spotClearinghouseState.balances.find((balance) => balance.coin === params.token);
+    if (!tokenBalance) {
+        return {
+            success: false,
+            reason: `No balance found for token: ${params.token}`,
+            availableBalance: '0',
+            requiredBalance: ethers_1.ethers.utils.formatUnits(params.amount, tokenInfo.weiDecimals),
+        };
+    }
+    // Convert the balance from human-readable format to smallest units using token's weiDecimals
+    // weiDecimals represents the exchange precision for amounts
+    const availableBalance = ethers_1.ethers.BigNumber.from(ethers_1.ethers.utils.parseUnits(tokenBalance.total, tokenInfo.weiDecimals));
+    console.log('[sendAssetPrechecks] Available balance:', availableBalance);
+    const requestedAmount = ethers_1.ethers.BigNumber.from(params.amount);
+    console.log('[sendAssetPrechecks] Requested amount:', requestedAmount);
+    if (availableBalance.lt(requestedAmount)) {
+        return {
+            success: false,
+            reason: `Insufficient ${params.token} balance for send. Available: ${ethers_1.ethers.utils.formatUnits(availableBalance, tokenInfo.weiDecimals)} ${params.token}, Requested: ${ethers_1.ethers.utils.formatUnits(requestedAmount, tokenInfo.weiDecimals)} ${params.token}`,
+            availableBalance: ethers_1.ethers.utils.formatUnits(availableBalance, tokenInfo.weiDecimals),
+            requiredBalance: ethers_1.ethers.utils.formatUnits(requestedAmount, tokenInfo.weiDecimals),
+        };
+    }
+    return {
+        success: true,
+        availableBalance: ethers_1.ethers.utils.formatUnits(availableBalance, tokenInfo.weiDecimals),
+        requiredBalance: ethers_1.ethers.utils.formatUnits(requestedAmount, tokenInfo.weiDecimals),
+    };
+}
+//# sourceMappingURL=send-spot-asset.js.map

package/dist/src/lib/ability-checks/send-spot-asset.js.map

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

package/dist/src/lib/ability-checks/spot.d.ts

@@ -0,0 +1,24 @@
+import * as hyperliquid from '@nktkas/hyperliquid';
+export type SpotTradePrechecksResult = SpotTradePrechecksResultSuccess | SpotTradePrechecksResultFailure;
+export interface SpotTradePrechecksResultSuccess {
+    success: true;
+}
+export interface SpotTradePrechecksResultFailure {
+    success: false;
+    reason: string;
+}
+export interface SpotTradeParams {
+    symbol: string;
+    price: string;
+    size: string;
+    isBuy: boolean;
+}
+/**
+ * Check if spot trade can be executed
+ */
+export declare function spotTradePrechecks({ transport, ethAddress, params, }: {
+    transport: hyperliquid.HttpTransport;
+    ethAddress: string;
+    params: SpotTradeParams;
+}): Promise<SpotTradePrechecksResult>;
+//# sourceMappingURL=spot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spot.d.ts","sourceRoot":"","sources":["../../../../src/lib/ability-checks/spot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,qBAAqB,CAAC;AAGnD,MAAM,MAAM,wBAAwB,GAChC,+BAA+B,GAC/B,+BAA+B,CAAC;AAEpC,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,SAAS,EACT,UAAU,EACV,MAAM,GACP,EAAE;IACD,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;CACzB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA6FpC"}

package/dist/src/lib/ability-checks/spot.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spotTradePrechecks = spotTradePrechecks;
+const tslib_1 = require("tslib");
+const hyperliquid = tslib_1.__importStar(require("@nktkas/hyperliquid"));
+const utils_1 = require("@nktkas/hyperliquid/utils");
+/**
+ * Check if spot trade can be executed
+ */
+async function spotTradePrechecks({ transport, ethAddress, params, }) {
+    try {
+        const converter = await utils_1.SymbolConverter.create({ transport });
+        const assetId = converter.getAssetId(params.symbol);
+        if (assetId === undefined) {
+            return {
+                success: false,
+                reason: `Trading pair ${params.symbol} does not exist`,
+            };
+        }
+        // Check if account exists
+        const infoClient = new hyperliquid.InfoClient({ transport });
+        try {
+            await infoClient.clearinghouseState({ user: ethAddress });
+            // If this succeeds, account exists
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (errorMessage.includes('does not exist')) {
+                return {
+                    success: false,
+                    reason: 'Hyperliquid account does not exist. Please deposit first.',
+                };
+            }
+            throw error;
+        }
+        // Check spot balance to ensure user has funds
+        const spotState = await infoClient.spotClearinghouseState({
+            user: ethAddress,
+        });
+        if (!spotState.balances || spotState.balances.length === 0) {
+            return {
+                success: false,
+                reason: 'No spot balance found. Please transfer funds to spot account first.',
+            };
+        }
+        // Parse the trading pair to get base and quote assets
+        // Format examples: "BTC/USDC", "ETH/USDC", "BTC/ETH"
+        // Note: Format validation is handled by spotTradeParamsSchema in schemas.ts
+        const [baseAsset, quoteAsset] = params.symbol.split('/');
+        // Check balance based on whether this is a buy or sell
+        if (params.isBuy) {
+            // For buy orders, check if user has the quote asset (what they're spending)
+            const quoteBalance = spotState.balances.find((b) => b.coin === quoteAsset);
+            if (!quoteBalance) {
+                return {
+                    success: false,
+                    reason: `No ${quoteAsset} balance found in spot account. Cannot buy ${baseAsset}.`,
+                };
+            }
+            // Check if quote balance is available (not all locked in orders)
+            const availableQuote = parseFloat(quoteBalance.total) - parseFloat(quoteBalance.hold);
+            if (availableQuote <= 0) {
+                return {
+                    success: false,
+                    reason: `Insufficient available ${quoteAsset} balance. All ${quoteAsset} is locked in open orders.`,
+                };
+            }
+        }
+        else {
+            // For sell orders, check if user has the base asset (what they're selling)
+            const baseBalance = spotState.balances.find((b) => b.coin === baseAsset);
+            if (!baseBalance) {
+                return {
+                    success: false,
+                    reason: `No ${baseAsset} balance found in spot account. Cannot sell ${baseAsset}.`,
+                };
+            }
+            // Check if base balance is available (not all locked in orders)
+            const availableBase = parseFloat(baseBalance.total) - parseFloat(baseBalance.hold);
+            if (availableBase <= 0) {
+                return {
+                    success: false,
+                    reason: `Insufficient available ${baseAsset} balance. All ${baseAsset} is locked in open orders.`,
+                };
+            }
+        }
+        return {
+            success: true,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            reason: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=spot.js.map

package/dist/src/lib/ability-checks/spot.js.map

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

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

@@ -0,0 +1,26 @@
+import * as hyperliquid from '@nktkas/hyperliquid';
+export type TransferPrechecksResult = TransferPrechecksResultSuccess | TransferPrechecksResultFailure;
+export interface TransferPrechecksResultSuccess {
+    success: true;
+    availableBalance: string;
+    requiredBalance: string;
+}
+export interface TransferPrechecksResultFailure {
+    success: false;
+    reason: string;
+    availableBalance?: string;
+    requiredBalance?: string;
+}
+export interface TransferParams {
+    amount: string;
+    to: 'spot' | 'perp';
+}
+/**
+ * Check if transfer between spot and perp accounts can be executed
+ */
+export declare function transferPrechecks({ infoClient, ethAddress, params, }: {
+    infoClient: hyperliquid.InfoClient;
+    ethAddress: string;
+    params: TransferParams;
+}): Promise<TransferPrechecksResult>;
+//# sourceMappingURL=transfer-usdc.d.ts.map