@raintree-technology/perps 0.1.2 → 0.1.4

package/dist/adapters/interface.d.ts

@@ -192,6 +192,7 @@ export interface ExchangeCredentials {
     accountAddress?: string;
     subaccountAddress?: string;
     packageAddress?: string;
+    usdcAddress?: string;
     restUrl?: string;
     wsUrl?: string;
     fullnodeUrl?: string;
@@ -286,20 +287,20 @@ export interface PerpDEXAdapter {
     cancelAllOrders(market?: string): Promise<number>;
     setLeverage(market: string, leverage: number): Promise<void>;
     setMarginType(market: string, type: MarginType): Promise<void>;
-    modifyOrder(params: ModifyOrderParams): Promise<Order>;
-    batchPlaceOrders(paramsList: OrderParams[]): Promise<Order[]>;
-    batchCancelOrders(paramsList: CancelOrderParams[]): Promise<boolean[]>;
-    cancelAllAfter(timeoutMs: number): Promise<void>;
-    getOrderHistory(market?: string, limit?: number): Promise<Order[]>;
-    getFundingHistory(market?: string, limit?: number): Promise<FundingPayment[]>;
-    getPublicTrades(market: string, limit?: number): Promise<PublicTrade[]>;
-    setMMP(config: MMPConfig): Promise<void>;
-    getMMP(market: string): Promise<MMPStatus>;
-    resetMMP(market: string): Promise<void>;
-    placeTWAP(params: TWAPParams): Promise<TWAPStatus>;
-    cancelTWAP(twapId: string): Promise<boolean>;
-    getTWAPStatus(twapId: string): Promise<TWAPStatus | null>;
-    updateIsolatedMargin(market: string, amount: string): Promise<void>;
+    modifyOrder?: (params: ModifyOrderParams) => Promise<Order>;
+    batchPlaceOrders?: (paramsList: OrderParams[]) => Promise<Order[]>;
+    batchCancelOrders?: (paramsList: CancelOrderParams[]) => Promise<boolean[]>;
+    cancelAllAfter?: (timeoutMs: number) => Promise<void>;
+    getOrderHistory?: (market?: string, limit?: number) => Promise<Order[]>;
+    getFundingHistory?: (market?: string, limit?: number) => Promise<FundingPayment[]>;
+    getPublicTrades?: (market: string, limit?: number) => Promise<PublicTrade[]>;
+    setMMP?: (config: MMPConfig) => Promise<void>;
+    getMMP?: (market: string) => Promise<MMPStatus>;
+    resetMMP?: (market: string) => Promise<void>;
+    placeTWAP?: (params: TWAPParams) => Promise<TWAPStatus>;
+    cancelTWAP?: (twapId: string) => Promise<boolean>;
+    getTWAPStatus?: (twapId: string) => Promise<TWAPStatus | null>;
+    updateIsolatedMargin?: (market: string, amount: string) => Promise<void>;
     subscribe(callbacks: SubscriptionCallbacks): Unsubscribe;
     subscribeOrderBook(market: string, callback: (book: OrderBook) => void): Unsubscribe;
     subscribeTicker(market: string, callback: (ticker: Ticker) => void): Unsubscribe;

package/dist/adapters/orderly.d.ts

@@ -5,7 +5,7 @@
  * API Docs: https://orderly.network/docs
  * Base URL: https://api-evm.orderly.org/v1
  */
-import { type PerpDEXAdapter, type ExchangeInfo, type ExchangeConfig, type Market, type Ticker, type OrderBook, type FundingRate, type Position, type Order, type Balance, type Trade, type OrderParams, type CancelOrderParams, type ModifyOrderParams, type FundingPayment, type PublicTrade, type SubscriptionCallbacks, type Unsubscribe, type MarginType, type MMPConfig, type MMPStatus, type TWAPParams, type TWAPStatus } from "./interface.js";
+import { type PerpDEXAdapter, type ExchangeInfo, type ExchangeConfig, type Market, type Ticker, type OrderBook, type FundingRate, type Position, type Order, type Balance, type Trade, type OrderParams, type CancelOrderParams, type FundingPayment, type PublicTrade, type SubscriptionCallbacks, type Unsubscribe, type MarginType } from "./interface.js";
 export declare class OrderlyAdapter implements PerpDEXAdapter {
     readonly info: ExchangeInfo;
     private baseUrl;
@@ -43,20 +43,12 @@ export declare class OrderlyAdapter implements PerpDEXAdapter {
     cancelAllOrders(market?: string): Promise<number>;
     setLeverage(_market: string, leverage: number): Promise<void>;
     setMarginType(_market: string, type: MarginType): Promise<void>;
-    modifyOrder(_params: ModifyOrderParams): Promise<Order>;
     batchPlaceOrders(paramsList: OrderParams[]): Promise<Order[]>;
     batchCancelOrders(paramsList: CancelOrderParams[]): Promise<boolean[]>;
     cancelAllAfter(timeoutMs: number): Promise<void>;
     getOrderHistory(market?: string, limit?: number): Promise<Order[]>;
     getFundingHistory(market?: string, limit?: number): Promise<FundingPayment[]>;
     getPublicTrades(market: string, limit?: number): Promise<PublicTrade[]>;
-    setMMP(_config: MMPConfig): Promise<void>;
-    getMMP(_market: string): Promise<MMPStatus>;
-    resetMMP(_market: string): Promise<void>;
-    placeTWAP(_params: TWAPParams): Promise<TWAPStatus>;
-    cancelTWAP(_twapId: string): Promise<boolean>;
-    getTWAPStatus(_twapId: string): Promise<TWAPStatus | null>;
-    updateIsolatedMargin(_market: string, _amount: string): Promise<void>;
     subscribe(callbacks: SubscriptionCallbacks): Unsubscribe;
     subscribeOrderBook(market: string, callback: (book: OrderBook) => void): Unsubscribe;
     subscribeTicker(market: string, callback: (ticker: Ticker) => void): Unsubscribe;

package/dist/adapters/orderly.js

@@ -660,9 +660,6 @@ export class OrderlyAdapter {
     // --------------------------------------------------------------------------
     // Advanced Trading
     // --------------------------------------------------------------------------
-    async modifyOrder(_params) {
-        throw new Error("Orderly does not support order modification. Cancel and replace instead.");
-    }
     async batchPlaceOrders(paramsList) {
         // Orderly has batch create order endpoint
         const results = [];
@@ -741,36 +738,6 @@ export class OrderlyAdapter {
         }));
     }
     // --------------------------------------------------------------------------
-    // Market Maker Protection
-    // --------------------------------------------------------------------------
-    async setMMP(_config) {
-        throw new Error("Orderly does not support Market Maker Protection (MMP)");
-    }
-    async getMMP(_market) {
-        throw new Error("Orderly does not support Market Maker Protection (MMP)");
-    }
-    async resetMMP(_market) {
-        throw new Error("Orderly does not support Market Maker Protection (MMP)");
-    }
-    // --------------------------------------------------------------------------
-    // TWAP Orders
-    // --------------------------------------------------------------------------
-    async placeTWAP(_params) {
-        throw new Error("Orderly does not support TWAP orders");
-    }
-    async cancelTWAP(_twapId) {
-        throw new Error("Orderly does not support TWAP orders");
-    }
-    async getTWAPStatus(_twapId) {
-        throw new Error("Orderly does not support TWAP orders");
-    }
-    // --------------------------------------------------------------------------
-    // Margin Management
-    // --------------------------------------------------------------------------
-    async updateIsolatedMargin(_market, _amount) {
-        throw new Error("Orderly does not support isolated margin adjustment");
-    }
-    // --------------------------------------------------------------------------
     // Subscriptions (polling)
     // --------------------------------------------------------------------------
     subscribe(callbacks) {

package/dist/adapters/paradex.d.ts

@@ -5,7 +5,7 @@
  * API Docs: https://docs.paradex.trade/
  * Base URL: https://api.prod.paradex.trade/v1
  */
-import { type PerpDEXAdapter, type ExchangeInfo, type ExchangeConfig, type Market, type Ticker, type OrderBook, type FundingRate, type Position, type Order, type Balance, type Trade, type OrderParams, type CancelOrderParams, type SubscriptionCallbacks, type Unsubscribe, type MarginType, type ModifyOrderParams, type FundingPayment, type PublicTrade, type MMPConfig, type MMPStatus, type TWAPParams, type TWAPStatus } from "./interface.js";
+import { type PerpDEXAdapter, type ExchangeInfo, type ExchangeConfig, type Market, type Ticker, type OrderBook, type FundingRate, type Position, type Order, type Balance, type Trade, type OrderParams, type CancelOrderParams, type SubscriptionCallbacks, type Unsubscribe, type MarginType, type ModifyOrderParams, type FundingPayment, type PublicTrade } from "./interface.js";
 export declare class ParadexAdapter implements PerpDEXAdapter {
     readonly info: ExchangeInfo;
     private baseUrl;
@@ -46,17 +46,9 @@ export declare class ParadexAdapter implements PerpDEXAdapter {
     modifyOrder(params: ModifyOrderParams): Promise<Order>;
     batchPlaceOrders(paramsList: OrderParams[]): Promise<Order[]>;
     batchCancelOrders(paramsList: CancelOrderParams[]): Promise<boolean[]>;
-    cancelAllAfter(_timeoutMs: number): Promise<void>;
     getOrderHistory(market?: string, limit?: number): Promise<Order[]>;
     getFundingHistory(market?: string, limit?: number): Promise<FundingPayment[]>;
     getPublicTrades(market: string, limit?: number): Promise<PublicTrade[]>;
-    setMMP(_config: MMPConfig): Promise<void>;
-    getMMP(_market: string): Promise<MMPStatus>;
-    resetMMP(_market: string): Promise<void>;
-    placeTWAP(_params: TWAPParams): Promise<TWAPStatus>;
-    cancelTWAP(_twapId: string): Promise<boolean>;
-    getTWAPStatus(_twapId: string): Promise<TWAPStatus | null>;
-    updateIsolatedMargin(_market: string, _amount: string): Promise<void>;
     subscribe(callbacks: SubscriptionCallbacks): Unsubscribe;
     subscribeOrderBook(market: string, callback: (book: OrderBook) => void): Unsubscribe;
     subscribeTicker(market: string, callback: (ticker: Ticker) => void): Unsubscribe;

package/dist/adapters/paradex.js

@@ -24,7 +24,7 @@ export class ParadexAdapter {
             perp: true,
             margin: true,
             crossMargin: true,
-            isolatedMargin: true,
+            isolatedMargin: false,
             stopOrders: true,
             takeProfitOrders: true,
             postOnly: true,
@@ -635,9 +635,6 @@ export class ParadexAdapter {
         }
         return results;
     }
-    async cancelAllAfter(_timeoutMs) {
-        throw new Error("Paradex does not support cancelAllAfter (dead man's switch)");
-    }
     async getOrderHistory(market, limit = 100) {
         const params = new URLSearchParams();
         if (market)
@@ -674,36 +671,6 @@ export class ParadexAdapter {
         }));
     }
     // --------------------------------------------------------------------------
-    // Market Maker Protection
-    // --------------------------------------------------------------------------
-    async setMMP(_config) {
-        throw new Error("Paradex does not support Market Maker Protection (MMP)");
-    }
-    async getMMP(_market) {
-        throw new Error("Paradex does not support Market Maker Protection (MMP)");
-    }
-    async resetMMP(_market) {
-        throw new Error("Paradex does not support Market Maker Protection (MMP)");
-    }
-    // --------------------------------------------------------------------------
-    // TWAP Orders
-    // --------------------------------------------------------------------------
-    async placeTWAP(_params) {
-        throw new Error("Paradex does not support TWAP orders");
-    }
-    async cancelTWAP(_twapId) {
-        throw new Error("Paradex does not support TWAP orders");
-    }
-    async getTWAPStatus(_twapId) {
-        throw new Error("Paradex does not support TWAP orders");
-    }
-    // --------------------------------------------------------------------------
-    // Margin Management
-    // --------------------------------------------------------------------------
-    async updateIsolatedMargin(_market, _amount) {
-        throw new Error("Paradex does not support isolated margin adjustment");
-    }
-    // --------------------------------------------------------------------------
     // Subscriptions (polling)
     // --------------------------------------------------------------------------
     subscribe(callbacks) {

package/dist/cli/experience.js

@@ -107,7 +107,6 @@ export function printSessionBanner(args) {
     for (const line of getPerpsAsciiMark()) {
         console.log(highlighter.brand(line));
     }
-    console.log(highlighter.dim("by Raintree Technology"));
     console.log("");
     console.log(`${highlighter.dim("mode")} ${networkTag}  ${highlighter.dim("exchange")} ${exchangeTag}`);
     console.log(`${highlighter.dim("command")} ${commandTag}  ${highlighter.dim("version")} ${highlighter.dim(`v${args.version}`)}`);

package/dist/cli/program.js

@@ -8,6 +8,8 @@ import { createContext } from "./context.js";
 import { highlighter, printCommandCompletion, printSessionBanner } from "./experience.js";
 import { commandPathFromCommand, resolveTestnetMode } from "./network-defaults.js";
 import { outputError } from "./output.js";
+import { inferExitCode } from "../lib/exit-codes.js";
+import { withJsonContract } from "../lib/contracts.js";
 const require = createRequire(import.meta.url);
 const pkg = require("../../package.json");
 const commandMeta = new WeakMap();
@@ -30,6 +32,7 @@ export function createProgram() {
         .description("Universal CLI for perpetual DEXes")
         .showSuggestionAfterError(true)
         .showHelpAfterError()
+        .exitOverride()
         .version(pkg.version)
         .option("--json", "Output in JSON format", false)
         .option("--human", "Enable human-first output UX (banner, timing, rich formatting)", false)
@@ -62,17 +65,37 @@ Examples:
             setExchange(opts.exchange);
         }
         catch (err) {
-            outputError(err instanceof Error ? err.message : String(err));
-            console.error(highlighter.dim(`Available exchanges: ${getAvailableExchanges().join(", ")}`));
-            process.exit(1);
+            const message = err instanceof Error ? err.message : String(err);
+            const exitCode = inferExitCode(err);
+            if (opts.json) {
+                console.error(JSON.stringify(withJsonContract("perps.error", {
+                    status: "error",
+                    error: { message, exitCode },
+                }), null, 2));
+            }
+            else {
+                outputError(message);
+                console.error(highlighter.dim(`Available exchanges: ${getAvailableExchanges().join(", ")}`));
+            }
+            process.exit(exitCode);
         }
         let config;
         try {
             config = loadConfig(isTestnet, opts.exchange);
         }
         catch (err) {
-            outputError(err instanceof Error ? err.message : String(err));
-            process.exit(1);
+            const message = err instanceof Error ? err.message : String(err);
+            const exitCode = inferExitCode(err);
+            if (opts.json) {
+                console.error(JSON.stringify(withJsonContract("perps.error", {
+                    status: "error",
+                    error: { message, exitCode },
+                }), null, 2));
+            }
+            else {
+                outputError(message);
+            }
+            process.exit(exitCode);
         }
         const context = createContext(config);
         // Store metadata on the root command

package/dist/commands/arb/alert.d.ts

@@ -1,6 +1,2 @@
-/**
- * Arb Alert Command
- * Set up alerts for funding rate arbitrage opportunities
- */
 import { Command } from "commander";
 export declare function registerArbAlertCommand(arb: Command): void;

package/dist/commands/arb/alert.js

@@ -1,12 +1,8 @@
-/**
- * Arb Alert Command
- * Set up alerts for funding rate arbitrage opportunities
- */
 import { getContext } from "../../cli/program.js";
-import { pollFundingRates } from "../../lib/funding-tracker.js";
+import { COMMON_ASSETS, DEFAULT_ALERT_INTERVAL_MS, MIN_PROFITABLE_SPREAD_PCT, } from "../../lib/constants.js";
 import { getAvailableExchanges } from "../../lib/exchange.js";
-import { COMMON_ASSETS, MIN_PROFITABLE_SPREAD_PCT, DEFAULT_ALERT_INTERVAL_MS } from "../../lib/constants.js";
-import { parseAssetList, parsePositiveNumber, parsePositiveInt } from "../../lib/validate.js";
+import { pollFundingRates } from "../../lib/funding-tracker.js";
+import { parseAssetList, parsePositiveInt, parsePositiveNumber } from "../../lib/validate.js";
 export function registerArbAlertCommand(arb) {
     arb
         .command("alert")
@@ -31,19 +27,15 @@ export function registerArbAlertCommand(arb) {
         console.log(`  Exchanges:  ${exchanges.join(", ")}`);
         console.log("\n  Monitoring... (Ctrl+C to stop)\n");
         console.log("  " + "─".repeat(60));
-        // Check immediately
         await checkAndAlert(config.assets, exchanges, config.threshold, isTestnet);
-        // Then check on interval
         const interval = setInterval(async () => {
             await checkAndAlert(config.assets, exchanges, config.threshold, isTestnet);
         }, config.intervalMin * 60 * 1000);
-        // Handle Ctrl+C
         process.once("SIGINT", () => {
             clearInterval(interval);
             console.log("\n\n  Alert monitor stopped.\n");
             process.exit(0);
         });
-        // Keep running
         await new Promise(() => { });
     });
 }
@@ -51,7 +43,6 @@ async function checkAndAlert(assets, exchanges, threshold, isTestnet) {
     try {
         const records = await pollFundingRates(assets, exchanges, undefined, isTestnet);
         const now = new Date().toLocaleTimeString();
-        // Group by asset and find opportunities
         const byAsset = new Map();
         for (const r of records) {
             const asset = r.market.replace("-PERP", "");
@@ -71,11 +62,10 @@ async function checkAndAlert(assets, exchanges, threshold, isTestnet) {
             if (annualized >= threshold) {
                 foundAny = true;
                 const dailyOn10k = spread * 24 * 10000;
-                console.log(`\n  \x1b[32m🔔 ${now} - ${asset} OPPORTUNITY\x1b[0m`);
+                console.log(`\n  \x1b[32m${now} - ${asset} OPPORTUNITY\x1b[0m`);
                 console.log(`     Short ${high.exchange} (${(high.rate * 100).toFixed(4)}%)`);
                 console.log(`     Long  ${low.exchange} (${(low.rate * 100).toFixed(4)}%)`);
                 console.log(`     Spread: \x1b[32m${annualized.toFixed(1)}%\x1b[0m annualized (~$${dailyOn10k.toFixed(2)}/day on $10k)`);
-                // Could add external notifications here (Discord, Telegram, etc.)
             }
         }
         if (!foundAny) {

package/dist/commands/markets/index.js

@@ -1,5 +1,7 @@
 import { registerMarketsLsSimpleCommand } from "./ls-simple.js";
+import { registerMarketsReadSimpleCommands } from "./read-simple.js";
 export function registerMarketsCommands(program) {
     const markets = program.command("markets").description("Market information");
     registerMarketsLsSimpleCommand(markets);
+    registerMarketsReadSimpleCommands(markets);
 }

package/dist/commands/markets/read-simple.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerMarketsReadSimpleCommands(markets: Command): void;

package/dist/commands/markets/read-simple.js

@@ -0,0 +1,130 @@
+import { getContext, getOutputOptions } from "../../cli/program.js";
+import { output, outputError, outputSuccess } from "../../cli/output.js";
+import { getExchangeAdapter } from "../../lib/exchange.js";
+import { getExchangeCredentials } from "../../lib/config.js";
+import { normalizeMarket } from "../order/shared.js";
+function parseMarketSymbol(symbol) {
+    return normalizeMarket(symbol);
+}
+async function withConnectedMarketAdapter(command, action) {
+    const ctx = getContext(command);
+    const outputOpts = getOutputOptions(command);
+    const adapter = getExchangeAdapter();
+    let connected = false;
+    try {
+        const credentials = getExchangeCredentials(ctx.config, adapter.info.id);
+        await adapter.connect({
+            testnet: ctx.config.testnet,
+            rpcUrl: credentials.fullnodeUrl,
+            wsUrl: credentials.wsUrl,
+            credentials,
+        });
+        connected = true;
+        await action(adapter, outputOpts);
+    }
+    catch (err) {
+        outputError(err instanceof Error ? err.message : String(err));
+        process.exitCode = 1;
+    }
+    finally {
+        if (connected) {
+            await adapter.disconnect().catch(() => undefined);
+        }
+    }
+}
+export function registerMarketsReadSimpleCommands(markets) {
+    markets
+        .command("get <symbol>")
+        .description("Show market details for one symbol")
+        .action(async function (symbol) {
+        const market = parseMarketSymbol(symbol);
+        await withConnectedMarketAdapter(this, async (adapter, outputOpts) => {
+            const row = await adapter.getMarket(market);
+            if (outputOpts.json) {
+                output({ market: row }, outputOpts);
+                return;
+            }
+            if (!row) {
+                outputError(`Market ${market} not found`);
+                return;
+            }
+            outputSuccess(`Market ${row.symbol}`);
+            console.log(`  Base:        ${row.baseAsset}`);
+            console.log(`  Quote:       ${row.quoteAsset}`);
+            console.log(`  Type:        ${row.type}`);
+            console.log(`  MaxLeverage: ${row.maxLeverage}x`);
+            console.log(`  TickSize:    ${row.tickSize}`);
+            console.log("");
+        });
+    });
+    markets
+        .command("ticker <symbol>")
+        .description("Show ticker for one symbol")
+        .action(async function (symbol) {
+        const market = parseMarketSymbol(symbol);
+        await withConnectedMarketAdapter(this, async (adapter, outputOpts) => {
+            const ticker = await adapter.getTicker(market);
+            if (outputOpts.json) {
+                output({ ticker }, outputOpts);
+                return;
+            }
+            outputSuccess(`Ticker ${ticker.market}`);
+            console.log(`  Last:         ${ticker.lastPrice}`);
+            console.log(`  Mark:         ${ticker.markPrice}`);
+            console.log(`  FundingRate:  ${ticker.fundingRate}`);
+            console.log(`  OpenInterest: ${ticker.openInterest}`);
+            console.log("");
+        });
+    });
+    markets
+        .command("tickers")
+        .description("Show all tickers")
+        .action(async function () {
+        await withConnectedMarketAdapter(this, async (adapter, outputOpts) => {
+            const tickers = await adapter.getTickers();
+            if (outputOpts.json) {
+                output({ tickers }, outputOpts);
+                return;
+            }
+            outputSuccess(`Fetched ${tickers.length} tickers`);
+            for (const row of tickers) {
+                console.log(`  ${row.market.padEnd(10)} last=${row.lastPrice} funding=${row.fundingRate} oi=${row.openInterest}`);
+            }
+            console.log("");
+        });
+    });
+    markets
+        .command("funding-rate <symbol>")
+        .description("Show funding rate for one symbol")
+        .action(async function (symbol) {
+        const market = parseMarketSymbol(symbol);
+        await withConnectedMarketAdapter(this, async (adapter, outputOpts) => {
+            const rate = await adapter.getFundingRate(market);
+            if (outputOpts.json) {
+                output({ fundingRate: rate }, outputOpts);
+                return;
+            }
+            outputSuccess(`Funding rate ${rate.market}`);
+            console.log(`  Rate:         ${rate.rate}`);
+            console.log(`  NextFunding:  ${new Date(rate.nextFundingTime).toISOString()}`);
+            console.log("");
+        });
+    });
+    markets
+        .command("funding-rates")
+        .description("Show funding rates for all markets")
+        .action(async function () {
+        await withConnectedMarketAdapter(this, async (adapter, outputOpts) => {
+            const rates = await adapter.getFundingRates();
+            if (outputOpts.json) {
+                output({ fundingRates: rates }, outputOpts);
+                return;
+            }
+            outputSuccess(`Fetched ${rates.length} funding rates`);
+            for (const row of rates) {
+                console.log(`  ${row.market.padEnd(10)} rate=${row.rate}`);
+            }
+            console.log("");
+        });
+    });
+}

package/dist/commands/order/advanced-simple.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerAdvancedOrderSimpleCommands(order: Command): void;