feat(lighter): add Robinhood Chain venue support

src/exchanges/lighter/constants.ts

@@ -1,36 +1,114 @@
-export type LighterEnvironment = "mainnet" | "testnet" | "staging" | "dev";
+export type LighterEnvironment = "mainnet" | "testnet" | "staging" | "dev" | "rh" | "rh-testnet";
 
 export interface LighterHostConfig {
   rest: string;
   ws: string;
 }
 
-export const LIGHTER_HOSTS: Record<LighterEnvironment, LighterHostConfig> = {
+export interface LighterNetworkConfig extends LighterHostConfig {
+  /**
+   * Chain id folded into every signature. A wrong value is unrecoverable: the signer
+   * happily produces a payload and the sequencer rejects every transaction.
+   * No endpoint exposes it, so this table is the only source of truth.
+   */
+  chainId: number;
+  /**
+   * `l1_providers[0].chainId` from `/api/v1/layer1BasicInfo`, plus the ZkLighter contract
+   * address — the only deployment fingerprints the server hands out. Used at startup to
+   * prove REST really points at the venue the config claims. `null` = not verified.
+   */
+  l1ChainId: number | null;
+  zkLighterContract: string | null;
+  /** Settlement/quote asset the venue defaults to when metadata does not name one. */
+  defaultQuoteAsset: string;
+}
+
+/**
+ * Every knob a deployment needs, bound together so no caller can mix a REST host from one
+ * venue with the chain id or websocket of another.
+ */
+export const LIGHTER_NETWORKS: Record<LighterEnvironment, LighterNetworkConfig> = {
   mainnet: {
     rest: "https://mainnet.zklighter.elliot.ai",
     ws: "wss://mainnet.zklighter.elliot.ai/stream",
+    chainId: 304,
+    l1ChainId: 1,
+    zkLighterContract: "0x3B4D794a66304F130a4Db8F2551B0070dfCf5ca7",
+    defaultQuoteAsset: "USDC",
+  },
+  rh: {
+    rest: "https://api.rh.lighter.xyz",
+    ws: "wss://api.rh.lighter.xyz/stream",
+    chainId: 466324,
+    l1ChainId: 4663,
+    zkLighterContract: "0x94bAB9693Ba2f6358507eFfcbd372b0660AFfF9d",
+    defaultQuoteAsset: "USDG",
+  },
+  "rh-testnet": {
+    rest: "https://api.rh-testnet.lighter.xyz",
+    ws: "wss://api.rh-testnet.lighter.xyz/stream",
+    chainId: 300,
+    // Shares L1 chain id 123456 with zklighter testnet; only the contract tells them apart.
+    l1ChainId: 123456,
+    zkLighterContract: "0x8413Cd5B9856B6D156A8A1066D778885FeaE38F8",
+    defaultQuoteAsset: "USDG",
   },
   testnet: {
     rest: "https://testnet.zklighter.elliot.ai",
     ws: "wss://testnet.zklighter.elliot.ai/stream",
+    chainId: 300,
+    l1ChainId: 123456,
+    zkLighterContract: "0xe034801BC49cCDC79FB683022dA0591C86077261",
+    defaultQuoteAsset: "USDC",
   },
   staging: {
     rest: "https://staging.zklighter.elliot.ai",
     ws: "wss://staging.zklighter.elliot.ai/stream",
+    chainId: 300,
+    l1ChainId: null,
+    zkLighterContract: null,
+    defaultQuoteAsset: "USDC",
   },
   dev: {
     rest: "https://dev.zklighter.elliot.ai",
     ws: "wss://dev.zklighter.elliot.ai/stream",
+    chainId: 300,
+    l1ChainId: null,
+    zkLighterContract: null,
+    defaultQuoteAsset: "USDC",
   },
 };
 
-export const LIGHTER_CHAIN_IDS: Record<LighterEnvironment, number> = {
-  mainnet: 304,
-  testnet: 300,
-  staging: 300,
-  dev: 300,
+/** Spellings users actually type, mapped onto canonical environment names. */
+export const LIGHTER_ENVIRONMENT_ALIASES: Record<string, LighterEnvironment> = {
+  robinhood: "rh",
+  robinhoodchain: "rh",
+  "robinhood-chain": "rh",
+  "rh-mainnet": "rh",
+  rhc: "rh",
+  "robinhood-testnet": "rh-testnet",
+  rhtestnet: "rh-testnet",
+  prod: "mainnet",
+  production: "mainnet",
 };
 
+/**
+ * Web app hostnames. Pasting one of these as a base URL is a common mistake — they serve the
+ * SPA, not the API — so they resolve to the matching environment's real REST host instead.
+ */
+export const LIGHTER_APP_HOSTS: Record<string, LighterEnvironment> = {
+  "app.lighter.xyz": "mainnet",
+  "robinhoodchain.lighter.xyz": "rh",
+};
+
+export const LIGHTER_HOSTS: Record<LighterEnvironment, LighterHostConfig> = Object.fromEntries(
+  Object.entries(LIGHTER_NETWORKS).map(([env, config]) => [env, { rest: config.rest, ws: config.ws }])
+) as Record<LighterEnvironment, LighterHostConfig>;
+
+export const LIGHTER_CHAIN_IDS: Record<LighterEnvironment, number> = Object.fromEntries(
+  Object.entries(LIGHTER_NETWORKS).map(([env, config]) => [env, config.chainId])
+) as Record<LighterEnvironment, number>;
+
 export const DEFAULT_LIGHTER_ENVIRONMENT: LighterEnvironment = "testnet";
 
 export const DEFAULT_TRANSACTION_EXPIRY_BUFFER_MS = 10 * 60 * 1000 - 1000; // 10 min minus 1s