perp-cli 0.3.3

package/dist/bot/presets.js

@@ -0,0 +1,296 @@
+const DEFAULT_RISK = {
+    max_position_usd: 1000,
+    max_daily_loss: 100,
+    max_drawdown: 200,
+    pause_after_loss_sec: 300,
+    max_open_bots: 5,
+};
+// ── Grid Presets ──
+const gridConservative = {
+    name: "grid-conservative",
+    description: "Wide range (±5%), 8 grids, small size, no leverage — low risk sideways strategy",
+    strategy: "grid",
+    risk: "low",
+    buildConfig: (exchange, symbol) => ({
+        name: `grid-conservative-${symbol.toLowerCase()}-${Date.now().toString(36)}`,
+        exchange,
+        symbol,
+        strategy: {
+            type: "grid",
+            grids: 8,
+            size: 0.05,
+            side: "neutral",
+            range_mode: "auto",
+            range_pct: 5,
+            rebalance: true,
+            rebalance_cooldown: 120,
+        },
+        entry_conditions: [{ type: "volatility_below", value: 8 }],
+        exit_conditions: [
+            { type: "volatility_above", value: 15 },
+            { type: "time_after", value: 86400 },
+        ],
+        risk: { ...DEFAULT_RISK, max_drawdown: 50, max_daily_loss: 30 },
+        monitor_interval_sec: 15,
+    }),
+};
+const gridStandard = {
+    name: "grid-standard",
+    description: "Medium range (±3%), 12 grids, moderate size — balanced grid trading",
+    strategy: "grid",
+    risk: "medium",
+    buildConfig: (exchange, symbol) => ({
+        name: `grid-standard-${symbol.toLowerCase()}-${Date.now().toString(36)}`,
+        exchange,
+        symbol,
+        strategy: {
+            type: "grid",
+            grids: 12,
+            size: 0.1,
+            side: "neutral",
+            range_mode: "auto",
+            range_pct: 3,
+            rebalance: true,
+            rebalance_cooldown: 60,
+        },
+        entry_conditions: [{ type: "always", value: 0 }],
+        exit_conditions: [
+            { type: "volatility_above", value: 12 },
+        ],
+        risk: { ...DEFAULT_RISK, max_drawdown: 100, max_daily_loss: 50 },
+        monitor_interval_sec: 10,
+    }),
+};
+const gridAggressive = {
+    name: "grid-aggressive",
+    description: "Tight range (±1.5%), 20 grids, 5x leverage — high frequency, high risk",
+    strategy: "grid",
+    risk: "high",
+    buildConfig: (exchange, symbol) => ({
+        name: `grid-aggressive-${symbol.toLowerCase()}-${Date.now().toString(36)}`,
+        exchange,
+        symbol,
+        strategy: {
+            type: "grid",
+            grids: 20,
+            size: 0.2,
+            side: "neutral",
+            range_mode: "auto",
+            range_pct: 1.5,
+            rebalance: true,
+            rebalance_cooldown: 30,
+            leverage: 5,
+        },
+        entry_conditions: [{ type: "volatility_below", value: 5 }],
+        exit_conditions: [
+            { type: "volatility_above", value: 8 },
+        ],
+        risk: { ...DEFAULT_RISK, max_drawdown: 200, max_daily_loss: 100, max_position_usd: 5000 },
+        monitor_interval_sec: 5,
+    }),
+};
+const gridLongBias = {
+    name: "grid-long-bias",
+    description: "Long-biased grid (±3%), 10 grids — profit from uptrend + range trading",
+    strategy: "grid",
+    risk: "medium",
+    buildConfig: (exchange, symbol) => ({
+        name: `grid-long-${symbol.toLowerCase()}-${Date.now().toString(36)}`,
+        exchange,
+        symbol,
+        strategy: {
+            type: "grid",
+            grids: 10,
+            size: 0.1,
+            side: "long",
+            range_mode: "auto",
+            range_pct: 3,
+            rebalance: true,
+            rebalance_cooldown: 60,
+        },
+        entry_conditions: [{ type: "always", value: 0 }],
+        exit_conditions: [],
+        risk: { ...DEFAULT_RISK, max_drawdown: 150, max_daily_loss: 75 },
+        monitor_interval_sec: 10,
+    }),
+};
+// ── DCA Presets ──
+const dcaDaily = {
+    name: "dca-daily",
+    description: "Buy once per day, 30 orders — steady accumulation over 1 month",
+    strategy: "dca",
+    risk: "low",
+    buildConfig: (exchange, symbol) => ({
+        name: `dca-daily-${symbol.toLowerCase()}-${Date.now().toString(36)}`,
+        exchange,
+        symbol,
+        strategy: {
+            type: "dca",
+            amount: 0.01,
+            interval_sec: 86400,
+            total_orders: 30,
+        },
+        entry_conditions: [{ type: "always", value: 0 }],
+        exit_conditions: [],
+        risk: { ...DEFAULT_RISK, max_drawdown: 100, max_daily_loss: 50 },
+        monitor_interval_sec: 3600,
+    }),
+};
+const dcaDipBuyer = {
+    name: "dca-dip-buyer",
+    description: "Buy only when volatility is high — accumulate during dips",
+    strategy: "dca",
+    risk: "medium",
+    buildConfig: (exchange, symbol) => ({
+        name: `dca-dip-${symbol.toLowerCase()}-${Date.now().toString(36)}`,
+        exchange,
+        symbol,
+        strategy: {
+            type: "dca",
+            amount: 0.02,
+            interval_sec: 3600,
+            total_orders: 0, // unlimited
+        },
+        entry_conditions: [{ type: "volatility_above", value: 5 }],
+        exit_conditions: [
+            { type: "volatility_below", value: 2 },
+        ],
+        risk: { ...DEFAULT_RISK, max_drawdown: 200, max_daily_loss: 100 },
+        monitor_interval_sec: 1800,
+    }),
+};
+const dcaHourly = {
+    name: "dca-hourly",
+    description: "Buy every hour, 24 orders — short-term aggressive accumulation",
+    strategy: "dca",
+    risk: "medium",
+    buildConfig: (exchange, symbol) => ({
+        name: `dca-hourly-${symbol.toLowerCase()}-${Date.now().toString(36)}`,
+        exchange,
+        symbol,
+        strategy: {
+            type: "dca",
+            amount: 0.005,
+            interval_sec: 3600,
+            total_orders: 24,
+        },
+        entry_conditions: [{ type: "always", value: 0 }],
+        exit_conditions: [],
+        risk: { ...DEFAULT_RISK, max_drawdown: 50, max_daily_loss: 30 },
+        monitor_interval_sec: 600,
+    }),
+};
+const dcaSeller = {
+    name: "dca-seller",
+    description: "Sell (short) periodically — dollar-cost average out of a position",
+    strategy: "dca",
+    risk: "medium",
+    buildConfig: (exchange, symbol) => ({
+        name: `dca-sell-${symbol.toLowerCase()}-${Date.now().toString(36)}`,
+        exchange,
+        symbol,
+        strategy: {
+            type: "dca",
+            amount: 0.01,
+            interval_sec: 3600,
+            total_orders: 24,
+        },
+        entry_conditions: [{ type: "always", value: 0 }],
+        exit_conditions: [],
+        risk: { ...DEFAULT_RISK, max_drawdown: 100, max_daily_loss: 50 },
+        monitor_interval_sec: 600,
+    }),
+};
+// ── Funding Arb Presets ──
+const arbConservative = {
+    name: "arb-conservative",
+    description: "High spread threshold (30%), small size ($30/leg), 2 max positions",
+    strategy: "funding-arb",
+    risk: "low",
+    buildConfig: (exchange, _symbol) => ({
+        name: `arb-conservative-${Date.now().toString(36)}`,
+        exchange,
+        symbol: "ETH",
+        strategy: {
+            type: "funding-arb",
+            min_spread: 30,
+            close_spread: 10,
+            size_usd: 30,
+            max_positions: 2,
+            exchanges: ["pacifica", "hyperliquid"],
+        },
+        entry_conditions: [{ type: "always", value: 0 }],
+        exit_conditions: [],
+        risk: { ...DEFAULT_RISK, max_drawdown: 100, max_daily_loss: 50, max_position_usd: 200 },
+        monitor_interval_sec: 120,
+    }),
+};
+const arbStandard = {
+    name: "arb-standard",
+    description: "Medium spread (20%), $50/leg, 3 positions, 3 exchanges",
+    strategy: "funding-arb",
+    risk: "medium",
+    buildConfig: (exchange, _symbol) => ({
+        name: `arb-standard-${Date.now().toString(36)}`,
+        exchange,
+        symbol: "ETH",
+        strategy: {
+            type: "funding-arb",
+            min_spread: 20,
+            close_spread: 5,
+            size_usd: 50,
+            max_positions: 3,
+            exchanges: ["pacifica", "hyperliquid", "lighter"],
+        },
+        entry_conditions: [{ type: "always", value: 0 }],
+        exit_conditions: [],
+        risk: { ...DEFAULT_RISK, max_drawdown: 200, max_daily_loss: 100, max_position_usd: 500 },
+        monitor_interval_sec: 60,
+    }),
+};
+const arbAggressive = {
+    name: "arb-aggressive",
+    description: "Low spread (10%), $100/leg, 5 positions — captures smaller opportunities",
+    strategy: "funding-arb",
+    risk: "high",
+    buildConfig: (exchange, _symbol) => ({
+        name: `arb-aggressive-${Date.now().toString(36)}`,
+        exchange,
+        symbol: "ETH",
+        strategy: {
+            type: "funding-arb",
+            min_spread: 10,
+            close_spread: 3,
+            size_usd: 100,
+            max_positions: 5,
+            exchanges: ["pacifica", "hyperliquid", "lighter"],
+        },
+        entry_conditions: [{ type: "always", value: 0 }],
+        exit_conditions: [],
+        risk: { ...DEFAULT_RISK, max_drawdown: 500, max_daily_loss: 200, max_position_usd: 2000 },
+        monitor_interval_sec: 30,
+    }),
+};
+// ── Registry ──
+export const PRESETS = [
+    // Grid
+    gridConservative,
+    gridStandard,
+    gridAggressive,
+    gridLongBias,
+    // DCA
+    dcaDaily,
+    dcaDipBuyer,
+    dcaHourly,
+    dcaSeller,
+    // Funding Arb
+    arbConservative,
+    arbStandard,
+    arbAggressive,
+];
+export function getPreset(name) {
+    return PRESETS.find(p => p.name === name);
+}
+export function getPresetsByStrategy(strategy) {
+    return PRESETS.filter(p => p.strategy === strategy);
+}

package/dist/bridge-engine.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Unified bridge engine: Circle CCTP V2 (primary, $0 fee) + Relay + deBridge DLN (fallback).
+ *
+ * CCTP V2 routes (all tested with real TX):
+ *   Sol→EVM:  Circle auto-relay (free)
+ *   EVM→EVM:  attestation poll + manual receiveMessage on dest chain
+ *   EVM→Sol:  attestation poll + Solana receiveMessage (ALT + 400k CU)
+ *
+ * Handles USDC bridging between Solana ↔ Arbitrum ↔ Base ↔ HyperCore
+ * for cross-exchange rebalancing in funding arb.
+ */
+export declare const CHAIN_IDS: {
+    readonly solana: 7565164;
+    readonly arbitrum: 42161;
+    readonly base: 8453;
+};
+export declare const USDC_ADDRESSES: Record<string, string>;
+export declare const EXCHANGE_TO_CHAIN: Record<string, string>;
+/**
+ * Check USDC balance on an EVM chain.
+ * Returns balance in USDC (human-readable).
+ */
+export declare function getEvmUsdcBalance(chain: string, address: string): Promise<number>;
+/**
+ * Check USDC balance on Solana.
+ * Returns balance in USDC (human-readable).
+ */
+export declare function getSolanaUsdcBalance(ownerPubkey: string): Promise<number>;
+/**
+ * Check USDC balance for a bridge source chain + address.
+ */
+export declare function checkBridgeBalance(srcChain: string, senderAddress: string, requiredAmount: number): Promise<{
+    balance: number;
+    sufficient: boolean;
+}>;
+/**
+ * Get native gas token balance (ETH for EVM, SOL for Solana).
+ * Returns balance in human-readable units.
+ */
+export declare function getNativeGasBalance(chain: string, address: string): Promise<number>;
+/**
+ * Check gas balance on source (and optionally destination) chains before bridging.
+ * Returns errors for any chain with insufficient gas.
+ */
+export declare function checkBridgeGasBalance(srcChain: string, srcAddress: string, dstChain: string, dstAddress: string, needsDstGas: boolean): Promise<{
+    ok: boolean;
+    errors: string[];
+}>;
+export interface BridgeQuote {
+    provider: "debridge" | "cctp" | "relay";
+    srcChain: string;
+    dstChain: string;
+    amountIn: number;
+    amountOut: number;
+    fee: number;
+    estimatedTime: number;
+    gasIncluded: boolean;
+    gasNote?: string;
+    raw: unknown;
+}
+export interface BridgeResult {
+    provider: string;
+    txHash: string;
+    srcChain: string;
+    dstChain: string;
+    amountIn: number;
+    amountOut: number;
+    receiveTxHash?: string;
+}
+/**
+ * Get a bridge quote via deBridge DLN.
+ */
+export declare function getDebridgeQuote(srcChain: string, dstChain: string, amountUsdc: number, senderAddress: string, recipientAddress: string): Promise<BridgeQuote>;
+/**
+ * Execute a deBridge bridge transaction.
+ * Returns the TX hash after signing and submitting.
+ */
+export declare function executeDebridgeBridge(bridgeQuote: BridgeQuote, signerKey: string): Promise<BridgeResult>;
+export declare const CCTP_DOMAINS: Record<string, number>;
+export declare const EVM_TOKEN_MINTER_V2 = "0xfd78EE919681417d192449715b2594ab58f5D002";
+/**
+ * Get a CCTP V2 bridge quote. Supports EVM ↔ EVM, Solana ↔ EVM, and → HyperCore.
+ *
+ * Uses Circle Forwarding Service when available (all routes except →Solana):
+ * - Circle handles dst chain mint automatically, no manual receiveMessage needed.
+ * - Service fee ~$0.20 (included in maxFee).
+ *
+ * @param fast - If true, use fast finality (1000): ~1-2 min, $1-1.3 + $0.20 forwarding.
+ *               If false (default), use standard finality (2000): ~2-5 min, ~$0.20 forwarding.
+ */
+export declare function getCctpQuote(srcChain: string, dstChain: string, amountUsdc: number, fast?: boolean): Promise<BridgeQuote>;
+/**
+ * Execute a CCTP V2 bridge. Routes to the appropriate implementation.
+ *
+ * @param fast - If true, use fast finality (1000): Circle auto-relays, no manual receiveMessage.
+ *               If false (default), use standard finality (2000): cheaper but requires manual relay.
+ */
+export declare function executeCctpBridge(srcChain: string, dstChain: string, amountUsdc: number, signerKey: string, recipientAddress: string, dstSignerKey?: string, // EVM key for receiveMessage (Solana→EVM) or Solana key for receiveMessage (EVM→Solana)
+fast?: boolean): Promise<BridgeResult>;
+/**
+ * Call receiveMessage on Solana MessageTransmitter V2 to complete an EVM→Solana bridge.
+ * This mints USDC on Solana after the attestation is ready.
+ */
+export declare function executeSolanaReceiveMessage(messageHex: string, // "0x..." CCTP message from Iris API
+attestationHex: string, // "0x..." attestation from Iris API
+recipientAddress: string, // Solana wallet pubkey (base58)
+payerKey: string): Promise<string>;
+export declare function getRelayQuote(srcChain: string, dstChain: string, amountUsdc: number, senderAddress: string, recipientAddress: string): Promise<BridgeQuote>;
+export declare function executeRelayBridge(bridgeQuote: BridgeQuote, signerKey: string): Promise<BridgeResult>;
+/**
+ * Get the best bridge quote. Strategy:
+ * - CCTP primary ($0 fee) for all routes: Solana↔EVM, EVM↔EVM, →HyperCore
+ * - Relay + deBridge DLN in parallel, pick cheapest
+ */
+/**
+ * Get quotes from ALL available providers in parallel.
+ * Returns sorted by amountOut (best first).
+ */
+export declare function getAllQuotes(srcChain: string, dstChain: string, amountUsdc: number, senderAddress: string, recipientAddress: string): Promise<BridgeQuote[]>;
+/**
+ * Get the best quote across all providers.
+ */
+export declare function getBestQuote(srcChain: string, dstChain: string, amountUsdc: number, senderAddress: string, recipientAddress: string): Promise<BridgeQuote>;
+/**
+ * Execute a bridge using the specified or best available provider.
+ * @param provider - Optional: force a specific provider ("cctp" | "relay" | "debridge")
+ */
+export declare function executeBestBridge(srcChain: string, dstChain: string, amountUsdc: number, signerKey: string, senderAddress: string, recipientAddress: string, dstSignerKey?: string, // Optional EVM key for manual receiveMessage (standard finality)
+provider?: "cctp" | "relay" | "debridge", fast?: boolean): Promise<BridgeResult>;
+/**
+ * Check bridge order status via deBridge.
+ */
+export declare function checkDebridgeStatus(orderId: string): Promise<Record<string, unknown>>;