perp-cli 0.4.2 → 0.4.9

package/dist/exchanges/hyperliquid.d.ts

@@ -1,22 +1,27 @@
 import { Hyperliquid } from "hyperliquid";
 import type { ExchangeAdapter, ExchangeMarketInfo, ExchangePosition, ExchangeOrder, ExchangeBalance, ExchangeTrade, ExchangeFundingPayment, ExchangeKline } from "./interface.js";
+import type { EvmSigner } from "../signer/interface.js";
 export declare class HyperliquidAdapter implements ExchangeAdapter {
     readonly name = "hyperliquid";
     private sdk;
     private _address;
     private _privateKey;
     private _testnet;
+    private _evmSigner?;
     private _assetMap;
     private _assetMapReverse;
+    private _szDecimalsMap;
     /** HIP-3 deployed perp dex name. Empty string = native (validator) perps. */
     private _dex;
-    constructor(privateKey: string, testnet?: boolean);
+    constructor(privateKey?: string, testnet?: boolean);
     /** Set the HIP-3 deployed perp dex to query/trade on. */
     setDex(dex: string): void;
     get dex(): string;
     get client(): Hyperliquid;
     get address(): string;
     get isTestnet(): boolean;
+    /** Inject an external EVM signer. Call before init() to skip LocalEvmSigner creation. */
+    setSigner(signer: EvmSigner): void;
     init(): Promise<void>;
     /** Load asset index map — supports native and HIP-3 dex. */
     private _loadAssetMap;
@@ -25,25 +30,36 @@ export declare class HyperliquidAdapter implements ExchangeAdapter {
      * Handles: "ICP" → "ICP-PERP", "BTC-PERP" → "BTC-PERP", "km:GOOGL" → "km:GOOGL"
      */
     resolveSymbol(symbol: string): string;
-    getAssetIndex(symbol: string): number;
+    /** Get szDecimals for a symbol (cached from init/getMeta) */
+    getSzDecimals(symbol: string): number;
+    /** HL official price rounding: 5 significant figures */
+    private _hlRoundPrice;
+    getAssetIndex(symbol: string): Promise<number>;
     getMarkets(): Promise<ExchangeMarketInfo[]>;
     getOrderbook(symbol: string): Promise<{
         bids: [string, string][];
         asks: [string, string][];
     }>;
+    private ensureAddress;
     /** Always fetches live clearinghouseState, writes result to shared cache for dashboard */
     private _getClearinghouseState;
     getBalance(): Promise<ExchangeBalance>;
     getPositions(): Promise<ExchangePosition[]>;
     getOpenOrders(): Promise<ExchangeOrder[]>;
     private _invalidateAccountCache;
-    marketOrder(symbol: string, side: "buy" | "sell", size: string): Promise<any>;
+    marketOrder(symbol: string, side: "buy" | "sell", size: string): Promise<unknown>;
     /**
      * Place a market order on a HIP-3 deployed dex.
      * Bypasses SDK's symbolConversion (which only knows native perps)
      * and constructs + signs the order action directly.
      */
     private _dexMarketOrder;
+    /**
+     * Sign and send any exchange action via raw EIP-712 signing.
+     * Bypasses the SDK entirely — works for order, batchModify, twapOrder, etc.
+     */
+    private ensureSigner;
+    private _signAndSendAction;
     /**
      * Place an order via raw exchange API with EIP-712 signing.
      * This bypasses the SDK's symbolConversion and supports dex-specific orders.
@@ -52,7 +68,7 @@ export declare class HyperliquidAdapter implements ExchangeAdapter {
     limitOrder(symbol: string, side: "buy" | "sell", price: string, size: string, opts?: {
         reduceOnly?: boolean;
         tif?: string;
-    }): Promise<any>;
+    }): Promise<unknown>;
     cancelOrder(symbol: string, orderId: string): Promise<import("hyperliquid").CancelOrderResponse>;
     cancelAllOrders(symbol?: string): Promise<import("hyperliquid").CancelOrderResponse[]>;
     editOrder(symbol: string, orderId: string, price: string, size: string): Promise<unknown>;
@@ -69,7 +85,7 @@ export declare class HyperliquidAdapter implements ExchangeAdapter {
     getFundingHistory(symbol: string, limit?: number): Promise<{
         time: number;
         rate: string;
-        price: string;
+        price: string | null;
     }[]>;
     /**
      * Place a trigger order (stop loss / take profit).
@@ -209,6 +225,11 @@ export declare class HyperliquidAdapter implements ExchangeAdapter {
      * POST to /info endpoint.
      */
     private _infoPost;
+    /**
+     * Public entry point for sending signed exchange actions.
+     * Used by HyperliquidSpotAdapter to delegate signing.
+     */
+    exchangeAction(action: Record<string, unknown>): Promise<unknown>;
     /**
      * Send a raw exchange action through the SDK.
      * Used for methods not directly exposed by the SDK.