feat: init send-spot-asset. Add debug false to getVincentAbilityClient in tests

Author: spacesailor24

.cursorignore

@@ -0,0 +1,2 @@
+# Add directories or file patterns to ignore during indexing (e.g. foo/ or *.csv)
+packages/**/generated/lit-action.js

packages/apps/ability-hyperliquid/src/generated/lit-action.js

@@ -1,3 +1,3 @@
 {
-  "ipfsCid": "QmVSTjgvv9jEGiuyvTf3ESLx3hUMkPFshnyhqLXHgiNRN8"
+  "ipfsCid": "Qmdakz7BTv3s9rma9RByEHcJeCUPFJc8AbSjhTkPWijhbR"
 }

packages/apps/ability-hyperliquid/src/generated/vincent-ability-metadata.json

@@ -1,7 +1,8 @@
 export { hyperliquidAccountExists } from './hyperliquid-account-exists';
-export { depositPrechecks } from './deposit';
-export { transferPrechecks } from './transfer';
+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';
+export { withdrawPrechecks } from './withdraw-usdc';
+export { sendSpotAssetPrechecks } from './send-spot-asset';

packages/apps/ability-hyperliquid/src/lib/ability-checks/deposit.ts renamed to packages/apps/ability-hyperliquid/src/lib/ability-checks/deposit-usdc.ts

@@ -0,0 +1,101 @@
+import { ethers } from 'ethers';
+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 async function sendSpotAssetPrechecks({
+  infoClient,
+  ethAddress,
+  params,
+}: {
+  infoClient: hyperliquid.InfoClient;
+  ethAddress: string;
+  params: SendSpotAssetParams;
+}): Promise<SendSpotAssetPrechecksResult> {
+  // Validate destination address
+  if (!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.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.BigNumber.from(
+    ethers.utils.parseUnits(tokenBalance.total, tokenInfo.weiDecimals),
+  );
+  console.log('[sendAssetPrechecks] Available balance:', availableBalance);
+
+  const requestedAmount = 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.utils.formatUnits(availableBalance, tokenInfo.weiDecimals)} ${params.token}, Requested: ${ethers.utils.formatUnits(requestedAmount, tokenInfo.weiDecimals)} ${params.token}`,
+      availableBalance: ethers.utils.formatUnits(availableBalance, tokenInfo.weiDecimals),
+      requiredBalance: ethers.utils.formatUnits(requestedAmount, tokenInfo.weiDecimals),
+    };
+  }
+
+  return {
+    success: true,
+    availableBalance: ethers.utils.formatUnits(availableBalance, tokenInfo.weiDecimals),
+    requiredBalance: ethers.utils.formatUnits(requestedAmount, tokenInfo.weiDecimals),
+  };
+}

packages/apps/ability-hyperliquid/src/lib/ability-checks/index.ts

@@ -6,3 +6,4 @@ export { transferUsdcTo } from './transfer-usdc-to';
 export { executeSpotOrder } from './execute-spot-order';
 export { executePerpOrder } from './execute-perp-order';
 export { withdrawUsdc } from './withdraw-usdc';
+export { sendSpotAsset } from './send-spot-asset';

packages/apps/ability-hyperliquid/src/lib/ability-checks/send-spot-asset.ts

@@ -0,0 +1,99 @@
+import * as hyperliquid from '@nktkas/hyperliquid';
+import {
+  SpotSendRequest,
+  SpotSendTypes,
+  SuccessResponse,
+  parser,
+} from '@nktkas/hyperliquid/api/exchange';
+import { signUserSignedAction } from '@nktkas/hyperliquid/signing';
+import { ethers } from 'ethers';
+import { bigIntReplacer } from '@lit-protocol/vincent-ability-sdk';
+
+import { LitActionPkpEthersWallet } from './lit-action-pkp-ethers-wallet';
+import { getHyperliquidNonce } from './get-hyperliquid-nonce';
+
+export type SendSpotAssetResult = {
+  sendResult: SuccessResponse;
+};
+
+/**
+ * Send spot assets (USDC or other tokens) to another Hyperliquid spot account
+ */
+export async function sendSpotAsset({
+  transport,
+  pkpPublicKey,
+  destination,
+  token,
+  amount,
+  useTestnet = false,
+}: {
+  transport: hyperliquid.HttpTransport;
+  pkpPublicKey: string;
+  destination: string;
+  token: string;
+  amount: string;
+  useTestnet?: boolean;
+}): Promise<SendSpotAssetResult> {
+  const pkpWallet = new LitActionPkpEthersWallet(pkpPublicKey);
+  const nonce = await getHyperliquidNonce();
+
+  // Fetch token metadata to get the correct decimal places
+  const infoClient = new hyperliquid.InfoClient({ transport });
+  const spotMeta = await infoClient.spotMeta();
+
+  // Find the token in the metadata
+  const tokenInfo = spotMeta.tokens.find((t) => t.name === token);
+  if (!tokenInfo) {
+    throw new Error(`Token ${token} not found in spot metadata`);
+  }
+  console.log('[sendAsset] Token info:', tokenInfo);
+
+  // Select chain ID and network based on testnet flag
+  const signatureChainId = useTestnet
+    ? '0x66eee' // Arbitrum Sepolia testnet chain ID: 421614
+    : '0xa4b1'; // Arbitrum mainnet chain ID: 42161
+  const hyperliquidChain = useTestnet ? 'Testnet' : 'Mainnet';
+
+  // Construct send action
+  const sendAction = parser(SpotSendRequest.entries.action)({
+    type: 'spotSend',
+    signatureChainId,
+    hyperliquidChain,
+    destination,
+    // Construct token identifier in the format expected by SpotSend: "name:0xaddress"
+    token: `${tokenInfo.name}:${tokenInfo.tokenId}`,
+    // Convert amount from smallest units (micro-units) to human-readable format
+    // using weiDecimals which represents the exchange precision for amounts
+    amount: ethers.utils.formatUnits(amount, tokenInfo.weiDecimals),
+    time: nonce,
+  });
+
+  // SpotSend is a user-signed action that uses EIP-712 typed data
+  const signature = await signUserSignedAction({
+    wallet: pkpWallet,
+    action: sendAction,
+    types: SpotSendTypes,
+  });
+
+  const sendResult = await Lit.Actions.runOnce(
+    { waitForResponse: true, name: 'HyperLiquidSendAssetRequest' },
+    async () => {
+      return JSON.stringify(
+        {
+          result: await transport.request('exchange', {
+            action: sendAction,
+            signature,
+            nonce,
+          }),
+        },
+        bigIntReplacer,
+        2,
+      );
+    },
+  );
+
+  const parsedSendResult = JSON.parse(sendResult);
+  return {
+    sendResult: parsedSendResult.result as SuccessResponse,
+  };
+}