perp-cli 0.3.3

package/dist/exchanges/interface.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Common exchange interface for multi-DEX CLI support.
+ * All exchange adapters (Pacifica, Hyperliquid, Lighter) implement this.
+ */
+export interface ExchangeMarketInfo {
+    symbol: string;
+    markPrice: string;
+    indexPrice: string;
+    fundingRate: string;
+    volume24h: string;
+    openInterest: string;
+    maxLeverage: number;
+}
+export interface ExchangePosition {
+    symbol: string;
+    side: "long" | "short";
+    size: string;
+    entryPrice: string;
+    markPrice: string;
+    liquidationPrice: string;
+    unrealizedPnl: string;
+    leverage: number;
+}
+export interface ExchangeOrder {
+    orderId: string;
+    symbol: string;
+    side: "buy" | "sell";
+    price: string;
+    size: string;
+    filled: string;
+    status: string;
+    type: string;
+}
+export interface ExchangeBalance {
+    equity: string;
+    available: string;
+    marginUsed: string;
+    unrealizedPnl: string;
+}
+export interface ExchangeTrade {
+    time: number;
+    symbol: string;
+    side: "buy" | "sell";
+    price: string;
+    size: string;
+    fee: string;
+}
+export interface ExchangeFundingPayment {
+    time: number;
+    symbol: string;
+    payment: string;
+}
+export interface ExchangeKline {
+    time: number;
+    open: string;
+    high: string;
+    low: string;
+    close: string;
+    volume: string;
+    trades: number;
+}
+export interface ExchangeAdapter {
+    readonly name: string;
+    getMarkets(): Promise<ExchangeMarketInfo[]>;
+    getOrderbook(symbol: string): Promise<{
+        bids: [string, string][];
+        asks: [string, string][];
+    }>;
+    getRecentTrades(symbol: string, limit?: number): Promise<ExchangeTrade[]>;
+    getFundingHistory(symbol: string, limit?: number): Promise<{
+        time: number;
+        rate: string;
+        price: string;
+    }[]>;
+    getKlines(symbol: string, interval: string, startTime: number, endTime: number): Promise<ExchangeKline[]>;
+    getBalance(): Promise<ExchangeBalance>;
+    getPositions(): Promise<ExchangePosition[]>;
+    getOpenOrders(): Promise<ExchangeOrder[]>;
+    getOrderHistory(limit?: number): Promise<ExchangeOrder[]>;
+    getTradeHistory(limit?: number): Promise<ExchangeTrade[]>;
+    getFundingPayments(limit?: number): Promise<ExchangeFundingPayment[]>;
+    marketOrder(symbol: string, side: "buy" | "sell", size: string): Promise<unknown>;
+    limitOrder(symbol: string, side: "buy" | "sell", price: string, size: string, opts?: {
+        reduceOnly?: boolean;
+        tif?: string;
+    }): Promise<unknown>;
+    editOrder(symbol: string, orderId: string, price: string, size: string): Promise<unknown>;
+    cancelOrder(symbol: string, orderId: string): Promise<unknown>;
+    cancelAllOrders(symbol?: string): Promise<unknown>;
+    setLeverage(symbol: string, leverage: number, marginMode?: "cross" | "isolated"): Promise<unknown>;
+    stopOrder(symbol: string, side: "buy" | "sell", size: string, triggerPrice: string, opts?: {
+        limitPrice?: string;
+        reduceOnly?: boolean;
+    }): Promise<unknown>;
+}

package/dist/exchanges/interface.js

@@ -0,0 +1,5 @@
+/**
+ * Common exchange interface for multi-DEX CLI support.
+ * All exchange adapters (Pacifica, Hyperliquid, Lighter) implement this.
+ */
+export {};

package/dist/exchanges/lighter.d.ts

@@ -0,0 +1,159 @@
+import type { ExchangeAdapter, ExchangeMarketInfo, ExchangePosition, ExchangeOrder, ExchangeBalance, ExchangeTrade, ExchangeFundingPayment, ExchangeKline } from "./interface.js";
+type LighterSignerClientType = import("lighter-sdk").LighterSignerClient;
+export declare class LighterAdapter implements ExchangeAdapter {
+    readonly name = "lighter";
+    private _signer;
+    private _accountIndex;
+    private _address;
+    private _marketMap;
+    private _marketDecimals;
+    private _evmKey;
+    private _apiKey;
+    private _accountIndexInit;
+    private _baseUrl;
+    private _chainId;
+    private _testnet;
+    private _readOnly;
+    /**
+     * @param evmKey    EVM private key (0x-prefixed, 32 bytes) — for deposits & key registration
+     * @param testnet   Use testnet (chain ID 300) instead of mainnet (chain ID 304)
+     * @param opts      Optional: apiKey (40-byte Lighter signing key), accountIndex
+     */
+    constructor(evmKey: string, testnet?: boolean, opts?: {
+        apiKey?: string;
+        accountIndex?: number;
+    });
+    get signer(): LighterSignerClientType;
+    get accountIndex(): number;
+    get address(): string;
+    get evmKey(): string;
+    get isReadOnly(): boolean;
+    init(): Promise<void>;
+    getMarketIndex(symbol: string): number;
+    private getMarkPrice;
+    private toTicks;
+    getMarkets(): Promise<ExchangeMarketInfo[]>;
+    private fetchAccount;
+    getOrderbook(symbol: string): Promise<{
+        bids: [string, string][];
+        asks: [string, string][];
+    }>;
+    getBalance(): Promise<ExchangeBalance>;
+    getPositions(): Promise<ExchangePosition[]>;
+    private getAuthToken;
+    private restGetAuth;
+    getOpenOrders(): Promise<ExchangeOrder[]>;
+    marketOrder(symbol: string, side: "buy" | "sell", size: string): Promise<unknown>;
+    limitOrder(symbol: string, side: "buy" | "sell", price: string, size: string, opts?: {
+        reduceOnly?: boolean;
+        tif?: string;
+    }): Promise<unknown>;
+    cancelOrder(symbol: string, orderId: string): Promise<unknown>;
+    cancelAllOrders(_symbol?: string): Promise<unknown>;
+    modifyOrder(symbol: string, orderId: string, price: string, size: string): Promise<unknown>;
+    stopOrder(symbol: string, side: "buy" | "sell", size: string, triggerPrice: string, opts?: {
+        limitPrice?: string;
+        reduceOnly?: boolean;
+    }): Promise<unknown>;
+    updateLeverage(symbol: string, leverage: number, marginMode?: "cross" | "isolated"): Promise<unknown>;
+    withdraw(amount: number, assetId?: number, routeType?: number): Promise<unknown>;
+    editOrder(symbol: string, orderId: string, price: string, size: string): Promise<unknown>;
+    setLeverage(symbol: string, leverage: number, marginMode?: "cross" | "isolated"): Promise<unknown>;
+    getRecentTrades(symbol: string, limit?: number): Promise<ExchangeTrade[]>;
+    getFundingHistory(symbol: string, limit?: number): Promise<{
+        time: number;
+        rate: string;
+        price: string;
+    }[]>;
+    getKlines(symbol: string, interval: string, startTime: number, endTime: number): Promise<ExchangeKline[]>;
+    getOrderHistory(limit?: number): Promise<ExchangeOrder[]>;
+    getTradeHistory(limit?: number): Promise<ExchangeTrade[]>;
+    getFundingPayments(limit?: number): Promise<ExchangeFundingPayment[]>;
+    /**
+     * Get funding rates for all markets.
+     * API: GET /api/v1/funding-rates
+     */
+    getFundingRates(): Promise<Map<string, {
+        rate: string;
+        markPrice: string;
+    }>>;
+    /**
+     * Get candle data for a market.
+     */
+    getCandles(symbol: string, resolution: string, startTime: number, endTime: number, countBack?: number): Promise<unknown>;
+    /**
+     * Get order history (inactive orders) — raw response.
+     */
+    private _getOrderHistoryRaw;
+    /**
+     * Get trade history — raw response.
+     */
+    private _getTradeHistoryRaw;
+    /**
+     * Get position funding history — raw response.
+     */
+    private _getPositionFundingRaw;
+    /**
+     * Get PnL chart data.
+     */
+    getPnl(period?: string): Promise<unknown>;
+    /**
+     * Get deposit history.
+     */
+    getDepositHistory(): Promise<unknown>;
+    /**
+     * Get withdrawal history.
+     */
+    getWithdrawHistory(): Promise<unknown>;
+    /**
+     * Get transfer history.
+     */
+    getTransferHistory(): Promise<unknown>;
+    /**
+     * Get asset details.
+     */
+    getAssetDetails(assetId?: number): Promise<unknown>;
+    /**
+     * Get exchange metrics.
+     */
+    getExchangeMetrics(symbol?: string): Promise<unknown>;
+    /**
+     * Get account limits.
+     */
+    getAccountLimits(): Promise<unknown>;
+    /**
+     * Create CCTP intent address for cross-chain deposit.
+     */
+    createIntentAddress(chainId: number): Promise<unknown>;
+    /**
+     * Use a referral code.
+     */
+    useReferralCode(code: string): Promise<unknown>;
+    /**
+     * Direct REST GET helper.
+     */
+    private getNextNonce;
+    private signOrder;
+    private sendTx;
+    private restGet;
+    private ensureSigner;
+    private static getWasmOps;
+    /**
+     * Generate a new Lighter API key pair using the WASM signer.
+     * Returns { privateKey, publicKey } (both 0x-prefixed, 40 bytes).
+     */
+    static generateApiKey(seed?: string): Promise<{
+        privateKey: string;
+        publicKey: string;
+    }>;
+    /**
+     * Generate an API key and register it on-chain via ChangePubKey.
+     * Uses WASM signer to sign + ETH key for L1 signature.
+     * Returns the generated key pair.
+     */
+    setupApiKey(apiKeyIndex?: number): Promise<{
+        privateKey: string;
+        publicKey: string;
+    }>;
+}
+export {};