@raintree-technology/perps 0.1.0

package/dist/adapters/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./interface.js";
+import "./hyperliquid.js";
+import "./decibel.js";
+import "./aevo.js";
+import "./paradex.js";
+import "./orderly.js";
+export { HyperliquidAdapter } from "./hyperliquid.js";
+export { DecibelAdapter } from "./decibel.js";
+export { AevoAdapter } from "./aevo.js";
+export { ParadexAdapter } from "./paradex.js";
+export { OrderlyAdapter } from "./orderly.js";

package/dist/adapters/index.js

@@ -0,0 +1,12 @@
+export * from "./interface.js";
+// Import adapters to trigger registration
+import "./hyperliquid.js";
+import "./decibel.js";
+import "./aevo.js";
+import "./paradex.js";
+import "./orderly.js";
+export { HyperliquidAdapter } from "./hyperliquid.js";
+export { DecibelAdapter } from "./decibel.js";
+export { AevoAdapter } from "./aevo.js";
+export { ParadexAdapter } from "./paradex.js";
+export { OrderlyAdapter } from "./orderly.js";

package/dist/adapters/interface.d.ts

@@ -0,0 +1,310 @@
+/**
+ * Universal Perpetual DEX Adapter Interface
+ * All exchange adapters must implement this interface
+ */
+import type { Address, Hex } from "viem";
+export type OrderSide = "long" | "short";
+export type OrderType = "limit" | "market" | "stop" | "stop_limit" | "take_profit";
+export type OrderStatus = "open" | "filled" | "partial" | "cancelled" | "expired";
+export type PositionSide = "long" | "short";
+export type MarginType = "cross" | "isolated";
+export type AssetType = "perp" | "spot";
+export interface Asset {
+    symbol: string;
+    name: string;
+    decimals: number;
+    minSize: string;
+    tickSize: string;
+    type: AssetType;
+}
+export interface Market {
+    symbol: string;
+    baseAsset: string;
+    quoteAsset: string;
+    type: AssetType;
+    maxLeverage: number;
+    minSize: string;
+    tickSize: string;
+    fundingInterval: number;
+    isActive: boolean;
+}
+export interface Position {
+    market: string;
+    side: PositionSide;
+    size: string;
+    entryPrice: string;
+    markPrice: string;
+    liquidationPrice: string | null;
+    unrealizedPnl: string;
+    realizedPnl: string;
+    leverage: number;
+    marginType: MarginType;
+    margin: string;
+    timestamp: number;
+}
+export interface Order {
+    id: string;
+    market: string;
+    side: OrderSide;
+    type: OrderType;
+    size: string;
+    price: string | null;
+    filled: string;
+    remaining: string;
+    status: OrderStatus;
+    reduceOnly: boolean;
+    postOnly: boolean;
+    timestamp: number;
+    triggerPrice?: string;
+}
+export interface Balance {
+    asset: string;
+    total: string;
+    available: string;
+    locked: string;
+    unrealizedPnl: string;
+    marginUsed: string;
+}
+export interface OrderBook {
+    market: string;
+    bids: Array<{
+        price: string;
+        size: string;
+    }>;
+    asks: Array<{
+        price: string;
+        size: string;
+    }>;
+    timestamp: number;
+}
+export interface Trade {
+    id: string;
+    market: string;
+    side: OrderSide;
+    price: string;
+    size: string;
+    fee: string;
+    feeAsset: string;
+    timestamp: number;
+    orderId?: string;
+}
+export interface FundingRate {
+    market: string;
+    rate: string;
+    nextFundingTime: number;
+    timestamp: number;
+}
+export interface Ticker {
+    market: string;
+    lastPrice: string;
+    markPrice: string;
+    indexPrice: string;
+    bid: string;
+    ask: string;
+    volume24h: string;
+    change24h: string;
+    high24h: string;
+    low24h: string;
+    openInterest: string;
+    fundingRate: string;
+    timestamp: number;
+}
+export interface OrderParams {
+    market: string;
+    side: OrderSide;
+    type: OrderType;
+    size: string;
+    price?: string;
+    reduceOnly?: boolean;
+    postOnly?: boolean;
+    leverage?: number;
+    marginType?: MarginType;
+    triggerPrice?: string;
+    clientOrderId?: string;
+}
+export interface CancelOrderParams {
+    orderId?: string;
+    clientOrderId?: string;
+    market?: string;
+}
+export interface ModifyOrderParams {
+    orderId: string;
+    market: string;
+    size?: string;
+    price?: string;
+    triggerPrice?: string;
+}
+export interface FundingPayment {
+    market: string;
+    amount: string;
+    rate: string;
+    timestamp: number;
+}
+export interface PublicTrade {
+    id: string;
+    market: string;
+    side: OrderSide;
+    price: string;
+    size: string;
+    timestamp: number;
+}
+export interface MMPConfig {
+    market: string;
+    windowMs: number;
+    frozenMs: number;
+    quantityLimit: string;
+    deltaLimit: string;
+}
+export interface MMPStatus {
+    market: string;
+    frozen: boolean;
+    frozenUntil: number | null;
+    config: MMPConfig | null;
+}
+export interface TWAPParams {
+    market: string;
+    side: OrderSide;
+    size: string;
+    durationMs: number;
+    intervalMs?: number;
+    randomize?: boolean;
+}
+export interface TWAPStatus {
+    id: string;
+    market: string;
+    side: OrderSide;
+    totalSize: string;
+    executedSize: string;
+    remainingSize: string;
+    status: "active" | "completed" | "cancelled";
+    startTime: number;
+    endTime: number;
+}
+export interface ExchangeCredentials {
+    apiKey?: string;
+    apiSecret?: string;
+    passphrase?: string;
+    privateKey?: Hex;
+    walletAddress?: Address;
+    subaccountId?: string;
+    agentWallet?: Hex;
+    apiBearerToken?: string;
+    accountAddress?: string;
+    subaccountAddress?: string;
+    packageAddress?: string;
+    restUrl?: string;
+    wsUrl?: string;
+    fullnodeUrl?: string;
+    orderlyAccountId?: string;
+    orderlyKey?: string;
+    orderlySecret?: string;
+    orderlyTradingKey?: string;
+    orderlyTradingSecret?: string;
+    paradexAccount?: string;
+    paradexEthereumAccount?: string;
+    paradexChainId?: string;
+    network?: "testnet" | "mainnet";
+}
+export interface ExchangeConfig {
+    credentials?: ExchangeCredentials;
+    testnet?: boolean;
+    rpcUrl?: string;
+    wsUrl?: string;
+}
+export type Unsubscribe = () => void;
+export interface SubscriptionCallbacks {
+    onPositions?: (positions: Position[]) => void;
+    onOrders?: (orders: Order[]) => void;
+    onBalances?: (balances: Balance[]) => void;
+    onTicker?: (ticker: Ticker) => void;
+    onOrderBook?: (book: OrderBook) => void;
+    onTrades?: (trades: Trade[]) => void;
+    onError?: (error: Error) => void;
+}
+export type CapabilityLevel = "full" | "partial" | "none";
+export interface AdapterImplementationStatus {
+    marketData: CapabilityLevel;
+    authenticatedReads: CapabilityLevel;
+    orderLifecycle: CapabilityLevel;
+    orderCancellation: CapabilityLevel;
+    subscriptions: CapabilityLevel;
+    advancedTrading: CapabilityLevel;
+}
+export interface ExchangeInfo {
+    id: string;
+    name: string;
+    type: "dex" | "cex";
+    chains: string[];
+    features: {
+        spot: boolean;
+        perp: boolean;
+        margin: boolean;
+        crossMargin: boolean;
+        isolatedMargin: boolean;
+        stopOrders: boolean;
+        takeProfitOrders: boolean;
+        postOnly: boolean;
+        reduceOnly: boolean;
+        subaccounts: boolean;
+        modifyOrders: boolean;
+        batchOrders: boolean;
+        cancelAllAfter: boolean;
+        publicTrades: boolean;
+        fundingHistory: boolean;
+        orderHistory: boolean;
+        mmp: boolean;
+        twapOrders: boolean;
+    };
+    urls: {
+        app: string;
+        api: string;
+        docs: string;
+        testnet?: string;
+    };
+    implementation: AdapterImplementationStatus;
+}
+export interface PerpDEXAdapter {
+    readonly info: ExchangeInfo;
+    connect(config: ExchangeConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getMarkets(): Promise<Market[]>;
+    getMarket(symbol: string): Promise<Market | null>;
+    getTicker(market: string): Promise<Ticker>;
+    getTickers(): Promise<Ticker[]>;
+    getOrderBook(market: string, depth?: number): Promise<OrderBook>;
+    getFundingRate(market: string): Promise<FundingRate>;
+    getFundingRates(): Promise<FundingRate[]>;
+    getPositions(): Promise<Position[]>;
+    getPosition(market: string): Promise<Position | null>;
+    getOrders(market?: string): Promise<Order[]>;
+    getOrder(orderId: string): Promise<Order | null>;
+    getBalances(): Promise<Balance[]>;
+    getTrades(market?: string, limit?: number): Promise<Trade[]>;
+    placeOrder(params: OrderParams): Promise<Order>;
+    cancelOrder(params: CancelOrderParams): Promise<boolean>;
+    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;
+}
+export type AdapterFactory = () => PerpDEXAdapter;
+export declare function registerAdapter(id: string, factory: AdapterFactory): void;
+export declare function getAdapter(id: string): PerpDEXAdapter | null;
+export declare function listAdapters(): string[];

package/dist/adapters/interface.js

@@ -0,0 +1,15 @@
+/**
+ * Universal Perpetual DEX Adapter Interface
+ * All exchange adapters must implement this interface
+ */
+const adapters = new Map();
+export function registerAdapter(id, factory) {
+    adapters.set(id.toLowerCase(), factory);
+}
+export function getAdapter(id) {
+    const factory = adapters.get(id.toLowerCase());
+    return factory ? factory() : null;
+}
+export function listAdapters() {
+    return Array.from(adapters.keys());
+}

package/dist/adapters/orderly.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Orderly Network Adapter
+ * Implements PerpDEXAdapter interface for Orderly Network
+ *
+ * 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";
+export declare class OrderlyAdapter implements PerpDEXAdapter {
+    readonly info: ExchangeInfo;
+    private baseUrl;
+    private config;
+    private connected;
+    private marketsCache;
+    private readonly subscriptionTimers;
+    connect(config: ExchangeConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    private fetchPublic;
+    private fetchPrivate;
+    private fetchMarkets;
+    private getAuthConfig;
+    private buildSignedHeaders;
+    private signTradingPayload;
+    private deriveTradingPublicKey;
+    private buildQueryString;
+    private canUseReadAuth;
+    getMarkets(): Promise<Market[]>;
+    getMarket(symbol: string): Promise<Market | null>;
+    getTicker(market: string): Promise<Ticker>;
+    getTickers(): Promise<Ticker[]>;
+    getOrderBook(market: string, depth?: number): Promise<OrderBook>;
+    getFundingRate(market: string): Promise<FundingRate>;
+    getFundingRates(): Promise<FundingRate[]>;
+    getPositions(): Promise<Position[]>;
+    getPosition(market: string): Promise<Position | null>;
+    getOrders(market?: string): Promise<Order[]>;
+    getOrder(orderId: string): Promise<Order | null>;
+    getBalances(): Promise<Balance[]>;
+    getTrades(market?: string, limit?: number): Promise<Trade[]>;
+    placeOrder(params: OrderParams): Promise<Order>;
+    cancelOrder(params: CancelOrderParams): Promise<boolean>;
+    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;
+    private toOrderlyOrderType;
+    private toOrderlySymbol;
+    private toStandardSymbol;
+    private normalizeSymbol;
+    private toOrder;
+    private toBookLevels;
+}
+export default OrderlyAdapter;