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.

tests/basis-arb-engine.test.ts

@@ -71,6 +71,13 @@ describe("BasisArbEngine", () => {
         time: 2_000,
       }),
     };
+    const futuresClient = {
+      getPremiumIndex: vi.fn().mockResolvedValue({
+        fundingRate: "0.0001",
+        nextFundingTime: 3_600_000,
+        time: 2_000,
+      }),
+    };
 
     const engine = new BasisArbEngine(
       {
@@ -79,10 +86,12 @@ describe("BasisArbEngine", () => {
         refreshIntervalMs: 1_000,
         maxLogEntries: 10,
         takerFeeRate: 0.0004,
+        arbAmount: 1,
       },
       adapter,
       {
         spotClient,
+        futuresClient,
         now: () => 1_000,
       }
     );
@@ -111,7 +120,7 @@ describe("BasisArbEngine", () => {
     const expectedNet = 1.04 * (1 - effectiveFee) - 1.05 * (1 + effectiveFee);
     expect(snapshot.netSpread).toBeCloseTo(expectedNet, 6);
     expect(snapshot.netSpreadBps).toBeCloseTo((expectedNet / 1.05) * 10_000, 6);
-    expect(snapshot.feedStatus).toEqual({ futures: true, spot: true });
+    expect(snapshot.feedStatus).toEqual({ futures: true, spot: true, funding: true });
     expect(snapshot.opportunity).toBe(expectedNet >= 0);
 
     engine.stop();