Feat/support binance (#22)

* add docs

* Add Binance exchange support

- Updated the environment configuration to include Binance as a selectable exchange option.
- Enhanced the README documentation to reflect the addition of Binance.
- Implemented the Binance exchange adapter and integrated it into the existing exchange framework.
- Modified the basis arbitrage strategy to support Binance alongside existing exchanges.
- Added tests to ensure proper functionality and integration of Binance within the trading system.

* Enhance README with detailed Binance exchange configuration

- Added comprehensive instructions for setting up Binance as an exchange option.
- Included environment variable specifications for API keys, market types, and trading symbols.
- Provided examples for both perpetual and spot trading strategies.
- Clarified the use of WebSocket and REST for the Binance adapter.

* Enhance exchange support and testing framework

- Added a new test suite for exchange contracts to ensure consistency and functionality across supported exchanges.
- Refactored exchange ID handling to utilize a centralized list of supported exchanges, improving maintainability.
- Updated CLI argument parsing and help documentation to reflect the new exchange structure.
- Introduced utility functions for validating supported exchanges and their display names.
- Enhanced the BasisApp and strategy runner to leverage the new exchange validation logic.
- Added a new test command for running exchange-related tests.

* Refactor exchange contract tests and update CLI commands

- Removed the trailing supported exchanges set and simplified the logic for trailing stop support in the exchange contract tests.
- Updated the test command for exchange contracts to exclude unnecessary tests, streamlining the testing process.
- Enhanced test descriptions for clarity and improved understanding of the functionality being tested.

src/exchanges/order-router.ts

@@ -1,5 +1,6 @@
 import type { ExchangeAdapter } from "./adapter";
 import type { AsterOrder } from "./types";
+import { SUPPORTED_EXCHANGE_IDS, type SupportedExchangeId } from "./create-adapter";
 import type {
   BaseOrderIntent,
   ClosePositionIntent,
@@ -15,8 +16,9 @@ import * as lighterOrders from "./lighter/order";
 import * as paradexOrders from "./paradex/order";
 import * as nadoOrders from "./nado/order";
 import * as standxOrders from "./standx/order";
+import * as binanceOrders from "./binance/order";
 
-type ExchangeKey = "aster" | "backpack" | "grvt" | "lighter" | "paradex" | "nado" | "standx";
+type ExchangeKey = SupportedExchangeId;
 
 interface ExchangeOrderHandlers {
   limit(intent: LimitOrderIntent): Promise<AsterOrder>;
@@ -76,17 +78,16 @@ const handlerMap: Record<ExchangeKey, ExchangeOrderHandlers> = {
     trailingStop: standxOrders.createTrailingStopOrder,
     close: standxOrders.createClosePositionOrder,
   },
+  binance: {
+    limit: binanceOrders.createLimitOrder,
+    market: binanceOrders.createMarketOrder,
+    stop: binanceOrders.createStopOrder,
+    trailingStop: binanceOrders.createTrailingStopOrder,
+    close: binanceOrders.createClosePositionOrder,
+  },
 };
 
-const knownExchanges: ExchangeKey[] = [
-  "aster",
-  "backpack",
-  "grvt",
-  "lighter",
-  "paradex",
-  "nado",
-  "standx",
-];
+const knownExchanges: ExchangeKey[] = [...SUPPORTED_EXCHANGE_IDS];
 
 function normalizeExchangeId(value: string | undefined | null): string | undefined {
   if (!value) return undefined;
@@ -98,7 +99,7 @@ function resolveExchangeKey(adapter: ExchangeAdapter): ExchangeKey {
   const candidates = [fromEnv, normalizeExchangeId(adapter.id)];
   for (const candidate of candidates) {
     if (!candidate) continue;
-    if ((knownExchanges as string[]).includes(candidate)) {
+    if (knownExchanges.includes(candidate as ExchangeKey)) {
       return candidate as ExchangeKey;
     }
   }