@rabby-wallet/hyperliquid-sdk 1.1.7-beta.3 → 1.1.8-beta.0

package/dist/client/exchange-client.d.ts

@@ -1,5 +1,5 @@
 import { ExchangeType } from '../types/constants';
-import type { OrderResponse, CancelResponse, ExchangeClientConfig, PlaceOrderParams, MultiOrderParams, CancelOrderParams, ModifyOrderParams, WithdrawParams, SendAssetParams, ApproveBuilderFeeParams, PrepareApproveBuilderFeeResult, SendApproveParams, MarketOrderParams, UpdateLeverageParams, BindTpslByOrderIdParams, UpdateIsolatedMarginParams, TwapOrderParams, TwapCancelParams, TwapOrderResponse, PlaceTPSlMarketOrderParams, PlaceTPSlLimitOrderParams, ClearinghouseState, UpdateTpslByOrderIdParams, LimitOrderParams, Abstraction, UserSetAbstractionParams, Tif } from '../types';
+import type { OrderResponse, CancelResponse, ExchangeClientConfig, PlaceOrderParams, MultiOrderParams, CancelOrderParams, ModifyOrderParams, WithdrawParams, SendAssetParams, UsdClassTransferParams, ApproveBuilderFeeParams, PrepareApproveBuilderFeeResult, SendApproveParams, MarketOrderParams, UpdateLeverageParams, BindTpslByOrderIdParams, UpdateIsolatedMarginParams, TwapOrderParams, TwapCancelParams, TwapOrderResponse, PlaceTPSlMarketOrderParams, PlaceTPSlLimitOrderParams, ClearinghouseState, UpdateTpslByOrderIdParams, LimitOrderParams, Abstraction, UserSetAbstractionParams, Tif } from '../types';
 /**
  * Client for executing trades on Hyperliquid (perpetuals only)
  * Only includes essential trading APIs as specified
@@ -173,6 +173,15 @@ export declare class ExchangeClient {
      */
     prepareSendAsset(params: SendAssetParams): PrepareApproveBuilderFeeResult;
     sendSendAsset(params: SendApproveParams): Promise<any>;
+    /**
+     * Move USDC between the spot and perp account on Hyperliquid.
+     * Signed by the master wallet.
+     *
+     * @param params.amount - USDC amount as a decimal string (e.g. "100.5")
+     * @param params.toPerp - true: Spot → Perp; false: Perp → Spot
+     */
+    prepareUsdClassTransfer(params: UsdClassTransferParams): PrepareApproveBuilderFeeResult;
+    sendUsdClassTransfer(params: SendApproveParams): Promise<any>;
     /**
      * Place a TWAP order
      * TWAP orders split a large order into smaller slices over time

package/dist/client/exchange-client.js

@@ -1051,6 +1051,50 @@ class ExchangeClient {
             signature: splitSignature,
         });
     }
+    /**
+     * Move USDC between the spot and perp account on Hyperliquid.
+     * Signed by the master wallet.
+     *
+     * @param params.amount - USDC amount as a decimal string (e.g. "100.5")
+     * @param params.toPerp - true: Spot → Perp; false: Perp → Spot
+     */
+    prepareUsdClassTransfer(params) {
+        const nonce = Date.now();
+        const action = {
+            type: constants_1.ExchangeType.USD_CLASS_TRANSFER,
+            hyperliquidChain: this.isTestnet ? 'Testnet' : 'Mainnet',
+            signatureChainId: this.isTestnet ? '0x66eee' : '0xa4b1',
+            amount: params.amount,
+            toPerp: params.toPerp,
+            nonce,
+        };
+        const { domain, types, primaryType, message } = (0, signer_1.prepareMasterSignData)({
+            action,
+            payloadTypes: [
+                { name: 'hyperliquidChain', type: 'string' },
+                { name: 'amount', type: 'string' },
+                { name: 'toPerp', type: 'bool' },
+                { name: 'nonce', type: 'uint64' },
+            ],
+            primaryType: 'HyperliquidTransaction:UsdClassTransfer',
+            isMainnet: !this.isTestnet,
+        });
+        return {
+            domain,
+            types,
+            primaryType,
+            message,
+            nonce,
+        };
+    }
+    sendUsdClassTransfer(params) {
+        const splitSignature = (0, signer_1.splitSig)(params.signature);
+        return this.httpClient.exchange({
+            action: params.action,
+            nonce: params.nonce,
+            signature: splitSignature,
+        });
+    }
     /**
      * Place a TWAP order
      * TWAP orders split a large order into smaller slices over time

package/dist/types/constants.d.ts

@@ -19,6 +19,7 @@ export declare enum ExchangeType {
     UPDATE_LEVERAGE = "updateLeverage",
     UPDATE_ISOLATED_MARGIN = "updateIsolatedMargin",
     USD_SEND = "usdSend",
+    USD_CLASS_TRANSFER = "usdClassTransfer",
     WITHDRAW = "withdraw3",
     SEND_ASSET = "sendAsset",
     APPROVE_AGENT = "approveAgent",

package/dist/types/constants.js

@@ -25,6 +25,7 @@ var ExchangeType;
     ExchangeType["UPDATE_LEVERAGE"] = "updateLeverage";
     ExchangeType["UPDATE_ISOLATED_MARGIN"] = "updateIsolatedMargin";
     ExchangeType["USD_SEND"] = "usdSend";
+    ExchangeType["USD_CLASS_TRANSFER"] = "usdClassTransfer";
     ExchangeType["WITHDRAW"] = "withdraw3";
     ExchangeType["SEND_ASSET"] = "sendAsset";
     ExchangeType["APPROVE_AGENT"] = "approveAgent";

package/dist/types/index.d.ts

@@ -226,6 +226,7 @@ export type UserNonFundingLedgerUpdates = {
         sourceDex?: string;
         source?: string;
         fee?: string;
+        usdcValue?: string;
     };
 };
 export interface OrderResponse {
@@ -606,6 +607,15 @@ export interface SendAssetParams {
     destinationDex?: string;
     fromSubAccount?: string;
 }
+/**
+ * Spot ↔ Perp USDC transfer parameters.
+ * `toPerp = true`  : Spot → Perp
+ * `toPerp = false` : Perp → Spot
+ */
+export interface UsdClassTransferParams {
+    amount: string;
+    toPerp: boolean;
+}
 export interface DepositParams {
     amount: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rabby-wallet/hyperliquid-sdk",
-  "version": "1.1.7-beta.3",
+  "version": "1.1.8-beta.0",
   "description": "Simplified Hyperliquid Perpetuals Trading SDK for Frontend Applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",