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

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, Tif } from '../types';
+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';
 /**
  * Client for executing trades on Hyperliquid (perpetuals only)
  * Only includes essential trading APIs as specified
@@ -116,6 +116,17 @@ export declare class ExchangeClient {
      */
     setReferrer(code: string): Promise<any>;
     agentEnableDexAbstraction(): Promise<any>;
+    /**
+     * Prepare userSetAbstraction data for main wallet signing
+     * Must be signed by the master wallet (NOT the agent)
+     * abstraction values: 'disabled' | 'unifiedAccount' | 'portfolioMargin'
+     */
+    prepareUserSetAbstraction(params: UserSetAbstractionParams): PrepareApproveBuilderFeeResult;
+    /**
+     * Send userSetAbstraction request with main wallet signature
+     * nonce must be the same as the nonce in prepareUserSetAbstraction
+     */
+    sendUserSetAbstraction(params: SendApproveParams): Promise<any>;
     agentSetAbstraction(abstraction: Abstraction): Promise<any>;
     /**
      * Prepare approve agent data for main wallet signing
@@ -175,17 +186,17 @@ export declare class ExchangeClient {
      * Place a spot order for stablecoin swaps on Hyperliquid.
      * Used to swap between USDC, USDT, USDH, USDE on the spot market.
      *
-     * @param params.coin - The spot asset to trade (e.g., 'USDT', 'USDH')
+     * @param params.coin - The spot asset to trade (e.g., 'USDT', 'USDH', 'USDE')
      * @param params.isBuy - true = buy the coin (sell USDC), false = sell the coin (buy USDC)
      * @param params.size - Amount to trade
      * @param params.limitPx - Limit price (use '1' for stablecoin 1:1 swaps)
      * @param params.tif - Time in force: 'Ioc' for immediate or cancel
      */
-    spotOrder(params: {
-        coin: string;
+    stableCoinOrder(params: {
+        coin: 'USDT' | 'USDH' | 'USDE';
         isBuy: boolean;
         size: string;
         limitPx: string;
         tif?: Tif;
-    }): Promise<any>;
+    }): Promise<OrderResponse>;
 }

package/dist/client/exchange-client.js

@@ -797,6 +797,52 @@ class ExchangeClient {
             }
         });
     }
+    /**
+     * Prepare userSetAbstraction data for main wallet signing
+     * Must be signed by the master wallet (NOT the agent)
+     * abstraction values: 'disabled' | 'unifiedAccount' | 'portfolioMargin'
+     */
+    prepareUserSetAbstraction(params) {
+        const nonce = Date.now();
+        const action = {
+            type: constants_1.ExchangeType.USER_SET_ABSTRACTION,
+            hyperliquidChain: this.isTestnet ? 'Testnet' : 'Mainnet',
+            signatureChainId: this.isTestnet ? '0x66eee' : '0xa4b1',
+            user: params.user,
+            abstraction: params.abstraction,
+            nonce,
+        };
+        const { domain, types, primaryType, message } = (0, signer_1.prepareMasterSignData)({
+            action,
+            payloadTypes: [
+                { name: 'hyperliquidChain', type: 'string' },
+                { name: 'user', type: 'address' },
+                { name: 'abstraction', type: 'string' },
+                { name: 'nonce', type: 'uint64' },
+            ],
+            primaryType: 'HyperliquidTransaction:UserSetAbstraction',
+            isMainnet: !this.isTestnet,
+        });
+        return {
+            domain,
+            types,
+            primaryType,
+            message,
+            nonce,
+        };
+    }
+    /**
+     * Send userSetAbstraction request with main wallet signature
+     * nonce must be the same as the nonce in prepareUserSetAbstraction
+     */
+    sendUserSetAbstraction(params) {
+        const splitSignature = (0, signer_1.splitSig)(params.signature);
+        return this.httpClient.exchange({
+            action: params.action,
+            nonce: params.nonce,
+            signature: splitSignature,
+        });
+    }
     agentSetAbstraction(abstraction) {
         return __awaiter(this, void 0, void 0, function* () {
             const nonce = Date.now();
@@ -1061,16 +1107,21 @@ class ExchangeClient {
      * Place a spot order for stablecoin swaps on Hyperliquid.
      * Used to swap between USDC, USDT, USDH, USDE on the spot market.
      *
-     * @param params.coin - The spot asset to trade (e.g., 'USDT', 'USDH')
+     * @param params.coin - The spot asset to trade (e.g., 'USDT', 'USDH', 'USDE')
      * @param params.isBuy - true = buy the coin (sell USDC), false = sell the coin (buy USDC)
      * @param params.size - Amount to trade
      * @param params.limitPx - Limit price (use '1' for stablecoin 1:1 swaps)
      * @param params.tif - Time in force: 'Ioc' for immediate or cancel
      */
-    spotOrder(params) {
+    stableCoinOrder(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { coin, isBuy, size, limitPx, tif = 'Ioc' } = params;
-            const assetIndex = yield this.symbolConversion.getAssetIndex(coin);
+            const { coin, isBuy, size, limitPx, tif = 'FrontendMarket' } = params;
+            const assetIndexMap = {
+                USDT: 10166,
+                USDH: 10230,
+                USDE: 10150,
+            };
+            const assetIndex = assetIndexMap[coin];
             const nonce = Date.now();
             const orderRequest = {
                 a: assetIndex,

package/dist/types/constants.d.ts

@@ -27,6 +27,7 @@ export declare enum ExchangeType {
     SET_REFERRER = "setReferrer",
     AGENT_ENABLE_DEX_ABSTRACTION = "agentEnableDexAbstraction",
     AGENT_SET_ABSTRACTION = "agentSetAbstraction",
+    USER_SET_ABSTRACTION = "userSetAbstraction",
     TWAP_ORDER = "twapOrder",
     TWAP_CANCEL = "twapCancel"
 }

package/dist/types/constants.js

@@ -33,6 +33,7 @@ var ExchangeType;
     ExchangeType["SET_REFERRER"] = "setReferrer";
     ExchangeType["AGENT_ENABLE_DEX_ABSTRACTION"] = "agentEnableDexAbstraction";
     ExchangeType["AGENT_SET_ABSTRACTION"] = "agentSetAbstraction";
+    ExchangeType["USER_SET_ABSTRACTION"] = "userSetAbstraction";
     ExchangeType["TWAP_ORDER"] = "twapOrder";
     ExchangeType["TWAP_CANCEL"] = "twapCancel";
 })(ExchangeType || (exports.ExchangeType = ExchangeType = {}));

package/dist/types/index.d.ts

@@ -380,6 +380,15 @@ export declare enum Abstraction {
     PORTFOLIO_MARGIN = "p",
     DISABLED = "i"
 }
+export declare enum UserAbstraction {
+    UNIFIED_ACCOUNT = "unifiedAccount",
+    PORTFOLIO_MARGIN = "portfolioMargin",
+    DISABLED = "disabled"
+}
+export interface UserSetAbstractionParams {
+    user: string;
+    abstraction: UserAbstraction;
+}
 export declare enum UserAbstractionResp {
     unifiedAccount = "unifiedAccount",
     portfolioMargin = "portfolioMargin",

package/dist/types/index.js

@@ -1,12 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.USDC_TOKEN_ID = exports.UserAbstractionResp = exports.Abstraction = void 0;
+exports.USDC_TOKEN_ID = exports.UserAbstractionResp = exports.UserAbstraction = exports.Abstraction = void 0;
 var Abstraction;
 (function (Abstraction) {
     Abstraction["UNIFIED_ACCOUNT"] = "u";
     Abstraction["PORTFOLIO_MARGIN"] = "p";
     Abstraction["DISABLED"] = "i";
 })(Abstraction || (exports.Abstraction = Abstraction = {}));
+var UserAbstraction;
+(function (UserAbstraction) {
+    UserAbstraction["UNIFIED_ACCOUNT"] = "unifiedAccount";
+    UserAbstraction["PORTFOLIO_MARGIN"] = "portfolioMargin";
+    UserAbstraction["DISABLED"] = "disabled";
+})(UserAbstraction || (exports.UserAbstraction = UserAbstraction = {}));
 var UserAbstractionResp;
 (function (UserAbstractionResp) {
     UserAbstractionResp["unifiedAccount"] = "unifiedAccount";

package/package.json

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