perp-cli 0.11.0 → 0.12.0

package/dist/exchanges/nado.js

@@ -1,223 +0,0 @@
-/**
- * Nado DEX adapter — Orderbook DEX on Ink L2.
- * API: https://gateway.nado.xyz/v1 (mainnet) / https://gateway.test.nado.xyz/v1 (testnet)
- * Docs: https://docs.nado.xyz/developer-resources/api/gateway
- * Note: API documentation is incomplete — many endpoints are stubbed pending full docs.
- */
-export class NadoAdapter {
-    name = "nado";
-    chain = "ink";
-    aliases = ["nad"];
-    _baseUrl;
-    _apiKey;
-    constructor(apiKey, testnet = false) {
-        this._apiKey = apiKey || process.env.NADO_API_KEY || "";
-        this._baseUrl = testnet
-            ? "https://gateway.test.nado.xyz/v1"
-            : "https://gateway.nado.xyz/v1";
-    }
-    async init() {
-        // Verify connectivity
-        try {
-            await this._get("/markets");
-        }
-        catch { /* non-critical */ }
-    }
-    async getMarkets() {
-        try {
-            const data = await this._get("/markets");
-            return (data ?? []).map(m => ({
-                symbol: String(m.symbol ?? m.name ?? ""),
-                markPrice: String(m.mark_price ?? m.last_price ?? "0"),
-                indexPrice: String(m.index_price ?? "0"),
-                fundingRate: String(m.funding_rate ?? "0"),
-                volume24h: String(m.volume_24h ?? m.volume ?? "0"),
-                openInterest: String(m.open_interest ?? "0"),
-                maxLeverage: Number(m.max_leverage ?? 50),
-            }));
-        }
-        catch {
-            return [];
-        }
-    }
-    async getOrderbook(symbol) {
-        try {
-            const data = await this._get(`/orderbook?symbol=${symbol}`);
-            return {
-                bids: (data.bids ?? []),
-                asks: (data.asks ?? []),
-            };
-        }
-        catch {
-            return { bids: [], asks: [] };
-        }
-    }
-    async getRecentTrades(symbol, limit = 20) {
-        try {
-            const data = await this._get(`/trades?symbol=${symbol}&limit=${limit}`);
-            return (data ?? []).map(t => ({
-                time: Number(t.time ?? t.timestamp ?? 0),
-                symbol, side: String(t.side ?? "buy"),
-                price: String(t.price ?? "0"), size: String(t.size ?? t.qty ?? "0"), fee: "0",
-            }));
-        }
-        catch {
-            return [];
-        }
-    }
-    async getFundingHistory(symbol, _limit = 10) {
-        try {
-            const data = await this._get(`/funding?symbol=${symbol}`);
-            return (data ?? []).map(f => ({
-                time: Number(f.time ?? 0), rate: String(f.rate ?? "0"), price: null,
-            }));
-        }
-        catch {
-            return [];
-        }
-    }
-    async getKlines(symbol, interval, startTime, endTime) {
-        try {
-            const data = await this._get(`/klines?symbol=${symbol}&interval=${interval}&start=${startTime}&end=${endTime}`);
-            return (data ?? []).map(k => ({
-                time: Number(k[0]), open: String(k[1]), high: String(k[2]),
-                low: String(k[3]), close: String(k[4]), volume: String(k[5]), trades: 0,
-            }));
-        }
-        catch {
-            return [];
-        }
-    }
-    async getBalance() {
-        if (!this._apiKey)
-            throw new Error("Nado API key required. Set NADO_API_KEY.");
-        const data = await this._authGet("/account/balance");
-        return {
-            equity: String(data.equity ?? data.total ?? "0"),
-            available: String(data.available ?? data.free ?? "0"),
-            marginUsed: String(data.margin_used ?? "0"),
-            unrealizedPnl: String(data.unrealized_pnl ?? "0"),
-        };
-    }
-    async getPositions() {
-        if (!this._apiKey)
-            throw new Error("Nado API key required. Set NADO_API_KEY.");
-        const data = await this._authGet("/account/positions");
-        return (data ?? []).filter(p => Number(p.size ?? 0) !== 0).map(p => ({
-            symbol: String(p.symbol ?? ""), side: Number(p.size ?? 0) > 0 ? "long" : "short",
-            size: String(Math.abs(Number(p.size ?? 0))), entryPrice: String(p.entry_price ?? "0"),
-            markPrice: String(p.mark_price ?? "0"), liquidationPrice: String(p.liquidation_price ?? "N/A"),
-            unrealizedPnl: String(p.unrealized_pnl ?? "0"), leverage: Number(p.leverage ?? 1),
-        }));
-    }
-    async getOpenOrders() {
-        if (!this._apiKey)
-            throw new Error("Nado API key required. Set NADO_API_KEY.");
-        const data = await this._authGet("/account/orders");
-        return (data ?? []).map(o => ({
-            orderId: String(o.order_id ?? o.id ?? ""), symbol: String(o.symbol ?? ""),
-            side: String(o.side ?? "buy").toLowerCase(),
-            price: String(o.price ?? "0"), size: String(o.size ?? o.qty ?? "0"),
-            filled: String(o.filled ?? "0"), status: String(o.status ?? "open"), type: String(o.type ?? "limit"),
-        }));
-    }
-    async getOrderHistory(limit = 30) {
-        if (!this._apiKey)
-            throw new Error("Nado API key required. Set NADO_API_KEY.");
-        const data = await this._authGet(`/account/orders/history?limit=${limit}`);
-        return (data ?? []).map(o => ({
-            orderId: String(o.order_id ?? o.id ?? ""), symbol: String(o.symbol ?? ""),
-            side: String(o.side ?? "buy").toLowerCase(),
-            price: String(o.price ?? "0"), size: String(o.size ?? "0"),
-            filled: String(o.filled ?? "0"), status: String(o.status ?? "done"), type: String(o.type ?? "limit"),
-        }));
-    }
-    async getTradeHistory(limit = 30) {
-        if (!this._apiKey)
-            throw new Error("Nado API key required. Set NADO_API_KEY.");
-        const data = await this._authGet(`/account/trades?limit=${limit}`);
-        return (data ?? []).map(t => ({
-            time: Number(t.time ?? t.timestamp ?? 0), symbol: String(t.symbol ?? ""),
-            side: String(t.side ?? "buy").toLowerCase(),
-            price: String(t.price ?? "0"), size: String(t.size ?? "0"), fee: String(t.fee ?? "0"),
-        }));
-    }
-    async getFundingPayments(limit = 200) {
-        if (!this._apiKey)
-            throw new Error("Nado API key required. Set NADO_API_KEY.");
-        const data = await this._authGet(`/account/funding?limit=${limit}`);
-        return (data ?? []).map(f => ({
-            time: Number(f.time ?? 0), symbol: String(f.symbol ?? ""), payment: String(f.payment ?? f.amount ?? "0"),
-        }));
-    }
-    async marketOrder(symbol, side, size) {
-        return this._authPost("/orders", { symbol, side, size, type: "market" });
-    }
-    async limitOrder(symbol, side, price, size, opts) {
-        return this._authPost("/orders", { symbol, side, price, size, type: "limit", time_in_force: opts?.tif ?? "GTC", reduce_only: opts?.reduceOnly ?? false });
-    }
-    async editOrder(symbol, orderId, price, size) {
-        return this._authPost(`/orders/${orderId}`, { symbol, price, size });
-    }
-    async cancelOrder(symbol, orderId) {
-        return this._authDelete(`/orders/${orderId}?symbol=${symbol}`);
-    }
-    async cancelAllOrders(symbol) {
-        return this._authDelete(`/orders${symbol ? `?symbol=${symbol}` : ""}`);
-    }
-    async setLeverage(symbol, leverage, marginMode) {
-        return this._authPost("/leverage", { symbol, leverage, margin_mode: marginMode ?? "cross" });
-    }
-    async stopOrder(symbol, side, size, triggerPrice, opts) {
-        return this._authPost("/orders", {
-            symbol, side, size, type: opts?.limitPrice ? "stop_limit" : "stop_market",
-            trigger_price: triggerPrice, price: opts?.limitPrice, reduce_only: opts?.reduceOnly ?? true,
-        });
-    }
-    async withdraw(amount, destination) {
-        return this._authPost("/withdraw", { amount, destination });
-    }
-    async _get(path) {
-        const res = await fetch(`${this._baseUrl}${path}`, {
-            headers: { "Accept-Encoding": "gzip" },
-        });
-        if (!res.ok)
-            throw new Error(`GET ${path} failed (${res.status})`);
-        return res.json();
-    }
-    async _authGet(path) {
-        if (!this._apiKey)
-            throw new Error("Nado API key required. Set NADO_API_KEY.");
-        const res = await fetch(`${this._baseUrl}${path}`, {
-            headers: { "Accept-Encoding": "gzip", "Authorization": `Bearer ${this._apiKey}` },
-        });
-        if (!res.ok)
-            throw new Error(`GET ${path} failed (${res.status})`);
-        return res.json();
-    }
-    async _authPost(path, body) {
-        if (!this._apiKey)
-            throw new Error("Nado API key required. Set NADO_API_KEY.");
-        const res = await fetch(`${this._baseUrl}${path}`, {
-            method: "POST",
-            headers: { "Accept-Encoding": "gzip", "Authorization": `Bearer ${this._apiKey}`, "Content-Type": "application/json" },
-            body: JSON.stringify(body),
-        });
-        if (!res.ok)
-            throw new Error(`POST ${path} failed (${res.status})`);
-        return res.json();
-    }
-    async _authDelete(path) {
-        if (!this._apiKey)
-            throw new Error("Nado API key required. Set NADO_API_KEY.");
-        const res = await fetch(`${this._baseUrl}${path}`, {
-            method: "DELETE",
-            headers: { "Accept-Encoding": "gzip", "Authorization": `Bearer ${this._apiKey}` },
-        });
-        if (!res.ok)
-            throw new Error(`DELETE ${path} failed (${res.status})`);
-        if (res.status === 204)
-            return {};
-        return res.json();
-    }
-}

package/dist/funding/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./normalize.js";
-export * from "./rates.js";
-export * from "./history.js";

package/dist/funding/index.js

@@ -1,3 +0,0 @@
-export * from "./normalize.js";
-export * from "./rates.js";
-export * from "./history.js";

package/dist/retry.d.ts

@@ -1,74 +0,0 @@
-/**
- * Auto-retry middleware for exchange operations.
- * Retries operations that fail with retryable error codes.
- */
-import { type StructuredError } from "./errors.js";
-import type { ExchangeAdapter } from "./exchanges/interface.js";
-export interface RetryOptions {
-    maxRetries?: number;
-    baseDelayMs?: number;
-    maxDelayMs?: number;
-    backoffMultiplier?: number;
-    onRetry?: (attempt: number, error: StructuredError, delayMs: number) => void;
-}
-export interface RetryResult<T> {
-    data: T;
-    attempts: number;
-    totalDelayMs: number;
-    retries: {
-        attempt: number;
-        error: StructuredError;
-        delayMs: number;
-    }[];
-}
-/** Error thrown when all retries are exhausted */
-export declare class RetriesExhaustedError extends Error {
-    readonly lastError: StructuredError;
-    readonly attempts: number;
-    readonly retries: {
-        attempt: number;
-        error: StructuredError;
-        delayMs: number;
-    }[];
-    constructor(lastError: StructuredError, attempts: number, retries: {
-        attempt: number;
-        error: StructuredError;
-        delayMs: number;
-    }[]);
-}
-/**
- * Apply jitter of +/-20% to a delay value.
- * Returns a value in [delay * 0.8, delay * 1.2].
- */
-export declare function applyJitter(delayMs: number): number;
-/**
- * Compute the delay for a given retry attempt.
- * Uses exponential backoff, respects retryAfterMs from the error code,
- * applies jitter, and caps at maxDelayMs.
- */
-export declare function computeDelay(attempt: number, error: StructuredError, opts: Required<Omit<RetryOptions, "onRetry">>): number;
-/**
- * Execute `fn` with automatic retry on retryable errors.
- *
- * - On failure, classifies the error via `classifyError`.
- * - If `retryable: true`, waits with exponential backoff and retries.
- * - If `retryable: false`, throws immediately.
- * - Uses `retryAfterMs` from the error code if available (e.g., rate limit = 1000ms).
- * - Caps delay at `maxDelayMs`.
- * - Adds jitter (+/-20%) to prevent thundering herd.
- * - Returns the result with retry metadata.
- */
-export declare function withRetry<T>(fn: () => Promise<T>, opts?: RetryOptions): Promise<RetryResult<T>>;
-/**
- * Simpler version of withRetry that just returns T (no metadata).
- * For use in places where you just want automatic retry without caring about details.
- */
-export declare function withRetrySimple<T>(fn: () => Promise<T>, maxRetries?: number): Promise<T>;
-/**
- * Wrap an ExchangeAdapter so every async method is automatically retried.
- *
- * Returns a Proxy that intercepts property access:
- * - For non-function properties (like `name`), returns the value directly.
- * - For function properties, returns a wrapper that calls `withRetry` around the original method.
- */
-export declare function wrapAdapterWithRetry(adapter: ExchangeAdapter, opts?: RetryOptions): ExchangeAdapter;

package/dist/retry.js

@@ -1,129 +0,0 @@
-/**
- * Auto-retry middleware for exchange operations.
- * Retries operations that fail with retryable error codes.
- */
-import { classifyError } from "./errors.js";
-/** Error thrown when all retries are exhausted */
-export class RetriesExhaustedError extends Error {
-    lastError;
-    attempts;
-    retries;
-    constructor(lastError, attempts, retries) {
-        super(`All ${attempts} attempts failed. Last error: [${lastError.code}] ${lastError.message}`);
-        this.name = "RetriesExhaustedError";
-        this.lastError = lastError;
-        this.attempts = attempts;
-        this.retries = retries;
-    }
-}
-const DEFAULT_OPTIONS = {
-    maxRetries: 3,
-    baseDelayMs: 1000,
-    maxDelayMs: 30000,
-    backoffMultiplier: 2,
-};
-/**
- * Apply jitter of +/-20% to a delay value.
- * Returns a value in [delay * 0.8, delay * 1.2].
- */
-export function applyJitter(delayMs) {
-    const jitterFactor = 0.8 + Math.random() * 0.4; // [0.8, 1.2]
-    return Math.round(delayMs * jitterFactor);
-}
-/**
- * Compute the delay for a given retry attempt.
- * Uses exponential backoff, respects retryAfterMs from the error code,
- * applies jitter, and caps at maxDelayMs.
- */
-export function computeDelay(attempt, error, opts) {
-    // Start with exponential backoff: baseDelay * multiplier^(attempt-1)
-    let delay = opts.baseDelayMs * Math.pow(opts.backoffMultiplier, attempt - 1);
-    // If the error specifies a retryAfterMs, use the larger of the two
-    if (error.retryAfterMs !== undefined) {
-        delay = Math.max(delay, error.retryAfterMs);
-    }
-    // Cap at maxDelayMs
-    delay = Math.min(delay, opts.maxDelayMs);
-    // Apply jitter
-    return applyJitter(delay);
-}
-/** Internal sleep helper */
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/**
- * Execute `fn` with automatic retry on retryable errors.
- *
- * - On failure, classifies the error via `classifyError`.
- * - If `retryable: true`, waits with exponential backoff and retries.
- * - If `retryable: false`, throws immediately.
- * - Uses `retryAfterMs` from the error code if available (e.g., rate limit = 1000ms).
- * - Caps delay at `maxDelayMs`.
- * - Adds jitter (+/-20%) to prevent thundering herd.
- * - Returns the result with retry metadata.
- */
-export async function withRetry(fn, opts) {
-    const { maxRetries, baseDelayMs, maxDelayMs, backoffMultiplier } = {
-        ...DEFAULT_OPTIONS,
-        ...opts,
-    };
-    const resolvedOpts = { maxRetries, baseDelayMs, maxDelayMs, backoffMultiplier };
-    const retries = [];
-    let totalDelayMs = 0;
-    for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
-        try {
-            const data = await fn();
-            return { data, attempts: attempt, totalDelayMs, retries };
-        }
-        catch (err) {
-            const classified = classifyError(err);
-            // Non-retryable error: throw immediately
-            if (!classified.retryable) {
-                throw err;
-            }
-            // Out of retries: throw with exhaustion info
-            if (attempt > maxRetries) {
-                throw new RetriesExhaustedError(classified, attempt, retries);
-            }
-            const delayMs = computeDelay(attempt, classified, resolvedOpts);
-            // Call onRetry callback if provided
-            opts?.onRetry?.(attempt, classified, delayMs);
-            retries.push({ attempt, error: classified, delayMs });
-            totalDelayMs += delayMs;
-            await sleep(delayMs);
-        }
-    }
-    // Unreachable, but TypeScript needs it
-    throw new Error("withRetry: unexpected exit from retry loop");
-}
-/**
- * Simpler version of withRetry that just returns T (no metadata).
- * For use in places where you just want automatic retry without caring about details.
- */
-export async function withRetrySimple(fn, maxRetries) {
-    const result = await withRetry(fn, maxRetries !== undefined ? { maxRetries } : undefined);
-    return result.data;
-}
-/**
- * Wrap an ExchangeAdapter so every async method is automatically retried.
- *
- * Returns a Proxy that intercepts property access:
- * - For non-function properties (like `name`), returns the value directly.
- * - For function properties, returns a wrapper that calls `withRetry` around the original method.
- */
-export function wrapAdapterWithRetry(adapter, opts) {
-    return new Proxy(adapter, {
-        get(target, prop, receiver) {
-            const value = Reflect.get(target, prop, receiver);
-            // Pass through non-function properties (e.g., `name` getter)
-            if (typeof value !== "function") {
-                return value;
-            }
-            // Wrap function in retry logic
-            return async function (...args) {
-                const result = await withRetry(() => value.apply(target, args), opts);
-                return result.data;
-            };
-        },
-    });
-}

package/dist/ws/market-feed.d.ts

@@ -1,74 +0,0 @@
-/**
- * Unified market data feeds for CLI streaming commands.
- *
- * - Hyperliquid: native WebSocket (allMids, l2Book, trades, candle)
- * - Lighter: REST polling (no public market data WS)
- * - Pacifica: handled via existing PacificaWSClient in stream.ts
- */
-import { EventEmitter } from "events";
-export interface PriceUpdate {
-    symbol: string;
-    mid: number;
-    funding?: number;
-}
-export interface BookUpdate {
-    bids: [string, string][];
-    asks: [string, string][];
-}
-export interface TradeUpdate {
-    side: string;
-    price: string;
-    size: string;
-    time: number;
-}
-export interface CandleUpdate {
-    o: string;
-    h: string;
-    l: string;
-    c: string;
-    v: string;
-    t: number;
-}
-export declare class HyperliquidMarketFeed extends EventEmitter {
-    private ws;
-    private closed;
-    private reconnectTimer;
-    private subs;
-    get wsUrl(): string;
-    connect(): Promise<void>;
-    private send;
-    private sub;
-    private scheduleReconnect;
-    subscribePrices(): void;
-    subscribeBook(symbol: string): void;
-    subscribeTrades(symbol: string): void;
-    subscribeCandle(symbol: string, interval: string): void;
-    private handleMessage;
-    close(): void;
-}
-export interface LighterFeedOpts {
-    /** Polling interval for prices in ms (default: 3000) */
-    pricesIntervalMs?: number;
-    /** Polling interval for book/trades in ms (default: 2000) */
-    bookIntervalMs?: number;
-    /** Polling interval for candles in ms (default: 5000) */
-    candleIntervalMs?: number;
-}
-export declare class LighterMarketFeed extends EventEmitter {
-    private closed;
-    private timers;
-    private marketMap;
-    private pricesMs;
-    private bookMs;
-    private candleMs;
-    constructor(opts?: LighterFeedOpts);
-    connect(): Promise<void>;
-    private getMarketId;
-    private poll;
-    subscribePrices(): void;
-    subscribeBook(symbol: string): void;
-    subscribeTrades(symbol: string): void;
-    subscribeCandle(symbol: string, interval: string): void;
-    close(): void;
-}
-export declare function createMarketFeed(exchange: string): HyperliquidMarketFeed | LighterMarketFeed;