@luxexchange/config 1.0.0

package/src/chains.ts

@@ -0,0 +1,224 @@
+import { defineChain } from 'viem'
+
+/**
+ * Lux Mainnet Chain Definition
+ */
+export const luxMainnet = defineChain({
+  id: 96369,
+  name: 'Lux Mainnet',
+  nativeCurrency: {
+    name: 'LUX',
+    symbol: 'LUX',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: { http: ['https://api.lux.network/mainnet/ext/bc/C/rpc'] },
+    public: { http: ['https://api.lux.network/mainnet/ext/bc/C/rpc'] },
+  },
+  blockExplorers: {
+    default: { name: 'Lux Explorer', url: 'https://explore.lux.network' },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xd25F88CBdAe3c2CCA3Bb75FC4E723b44C0Ea362F',
+    },
+  },
+})
+
+/**
+ * Lux Testnet Chain Definition
+ */
+export const luxTestnet = defineChain({
+  id: 96368,
+  name: 'Lux Testnet',
+  nativeCurrency: {
+    name: 'LUX',
+    symbol: 'LUX',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: { http: ['https://api.lux.network/testnet/ext/bc/C/rpc'] },
+    public: { http: ['https://api.lux.network/testnet/ext/bc/C/rpc'] },
+  },
+  blockExplorers: {
+    default: { name: 'Lux Testnet Explorer', url: 'https://explore.lux-test.network' },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xd25F88CBdAe3c2CCA3Bb75FC4E723b44C0Ea362F',
+    },
+  },
+  testnet: true,
+})
+
+/**
+ * Zoo Mainnet Chain Definition
+ */
+export const zooMainnet = defineChain({
+  id: 200200,
+  name: 'Zoo Network',
+  nativeCurrency: {
+    name: 'ZOO',
+    symbol: 'ZOO',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: { http: ['https://api.zoo.network/rpc'] },
+    public: { http: ['https://api.zoo.network/rpc'] },
+  },
+  blockExplorers: {
+    default: { name: 'Zoo Explorer', url: 'https://explore.zoo.network' },
+  },
+})
+
+/**
+ * Zoo Testnet Chain Definition
+ */
+export const zooTestnet = defineChain({
+  id: 200201,
+  name: 'Zoo Testnet',
+  nativeCurrency: {
+    name: 'ZOO',
+    symbol: 'ZOO',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: { http: ['https://api.zoo-test.network/rpc'] },
+    public: { http: ['https://api.zoo-test.network/rpc'] },
+  },
+  blockExplorers: {
+    default: { name: 'Zoo Testnet Explorer', url: 'https://explore.zoo-test.network' },
+  },
+  testnet: true,
+})
+
+/**
+ * Hanzo Network (AI Coin) Chain Definition
+ */
+export const hanzoMainnet = defineChain({
+  id: 36963,
+  name: 'Hanzo Network',
+  nativeCurrency: {
+    name: 'HANZO',
+    symbol: 'HANZO',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: { http: ['https://api.lux.network/mainnet/ext/bc/2GiQb73CeJESjc4omFv2YtQHZrRgJf25NXPzAr5J6UNHRcDV2F/rpc'] },
+    public: { http: ['https://api.lux.network/mainnet/ext/bc/2GiQb73CeJESjc4omFv2YtQHZrRgJf25NXPzAr5J6UNHRcDV2F/rpc'] },
+  },
+  blockExplorers: {
+    default: { name: 'Hanzo Explorer', url: 'https://explore-hanzo.lux.network' },
+  },
+})
+
+/**
+ * SPC Network Chain Definition
+ */
+export const spcMainnet = defineChain({
+  id: 36911,
+  name: 'SPC Network',
+  nativeCurrency: {
+    name: 'SPC',
+    symbol: 'SPC',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: { http: ['https://api.lux.network/mainnet/ext/bc/rtjwvtE1tEvrokmpeYdTq7b2zqZgmybKwR5MLjKMGAR1W78dQ/rpc'] },
+    public: { http: ['https://api.lux.network/mainnet/ext/bc/rtjwvtE1tEvrokmpeYdTq7b2zqZgmybKwR5MLjKMGAR1W78dQ/rpc'] },
+  },
+  blockExplorers: {
+    default: { name: 'SPC Explorer', url: 'https://explore-spc.lux.network' },
+  },
+})
+
+/**
+ * Pars Network Chain Definition
+ */
+export const parsMainnet = defineChain({
+  id: 494949,
+  name: 'Pars Network',
+  nativeCurrency: {
+    name: 'PARS',
+    symbol: 'PARS',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: { http: ['https://api.lux.network/mainnet/ext/bc/2pUskxqaL5Bpx7uRUGG1fDjPckjxQ4UKX4sLKeaS1NdSVBJd3F/rpc'] },
+    public: { http: ['https://api.lux.network/mainnet/ext/bc/2pUskxqaL5Bpx7uRUGG1fDjPckjxQ4UKX4sLKeaS1NdSVBJd3F/rpc'] },
+  },
+  blockExplorers: {
+    default: { name: 'Pars Explorer', url: 'https://explore-pars.lux.network' },
+  },
+})
+
+/**
+ * Liquid EVM (Liquidity Network) Chain Definition
+ */
+export const liquidEvm = defineChain({
+  id: 8675311,
+  name: 'Liquid Network',
+  nativeCurrency: {
+    name: 'LQDTY',
+    symbol: 'LQDTY',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: { http: ['https://rpc.next.satschel.com'] },
+    public: { http: ['https://rpc.next.satschel.com'] },
+  },
+  blockExplorers: {
+    default: { name: 'Liquid Explorer', url: 'https://explore.next.satschel.com' },
+  },
+})
+
+/**
+ * Dev Chain Definition (for running local node with --dev)
+ */
+export const luxDev = defineChain({
+  id: 1337,
+  name: 'Lux Dev',
+  nativeCurrency: {
+    name: 'LUX',
+    symbol: 'LUX',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: { http: ['http://localhost:8545/ext/bc/C/rpc'] },
+    public: { http: ['http://localhost:8545/ext/bc/C/rpc'] },
+  },
+  blockExplorers: {
+    default: { name: 'Dev', url: 'http://localhost:8545' },
+  },
+  testnet: false,
+})
+
+/**
+ * Chain IDs
+ */
+export const LUX_MAINNET_ID = 96369
+export const LUX_TESTNET_ID = 96368
+export const ZOO_MAINNET_ID = 200200
+export const ZOO_TESTNET_ID = 200201
+export const HANZO_MAINNET_ID = 36963
+export const SPC_MAINNET_ID = 36911
+export const PARS_MAINNET_ID = 494949
+export const LIQUID_EVM_ID = 8675311
+export const LUX_DEV_ID = 1337
+
+/**
+ * All supported chains
+ */
+export const supportedChains = [
+  luxMainnet,
+  luxTestnet,
+  zooMainnet,
+  zooTestnet,
+  hanzoMainnet,
+  spcMainnet,
+  parsMainnet,
+  liquidEvm,
+  luxDev,
+] as const
+
+export type SupportedChainId = typeof supportedChains[number]['id']

package/src/config-types.ts

@@ -0,0 +1,50 @@
+/**
+ * Naming requirements for different environments:
+ * - Web ENV vars: must have process.env.REACT_APP_<var_name>
+ * - Extension ENV vars: must have process.env.<var_name>
+ * - Mobile ENV vars: must have BOTH process.env.<var_name> and <var_name>
+ *
+ *  The CI requires web vars to have the required 'REACT_APP_' prefix. The react-dot-env library doesnt integrate with CI correctly,
+ *  so we pull from github secrets directly with process.env.<var_name> for both extension and mobile. <var_name> is used for local mobile builds.
+ */
+
+export interface Config {
+  alchemyApiKey: string
+  amplitudeProxyUrlOverride: string
+  apiBaseUrlOverride: string
+  apiBaseUrlV2Override: string
+  appsflyerApiKey: string
+  appsflyerAppId: string
+  blockaidProxyUrl: string
+  datadogClientToken: string
+  datadogProjectId: string
+  isE2ETest: boolean
+  forApiUrlOverride: string
+  graphqlUrlOverride: string
+  gChainGraphqlUrl: string
+  includePrototypeFeatures: string
+  infuraKey: string
+  isVercelEnvironment: boolean
+  jupiterProxyUrl: string
+  onesignalAppId: string
+  quicknodeEndpointName: string
+  quicknodeEndpointToken: string
+  scantasticApiUrlOverride: string
+  statsigProxyUrlOverride: string
+  statsigApiKey: string
+  tradingApiKey: string
+  tradingApiUrlOverride: string
+  tradingApiWebTestEnv: string
+  liquidityServiceUrlOverride: string
+  luxApiKey: string
+  unitagsApiUrlOverride: string
+  luxNotifApiBaseUrlOverride: string
+  entryGatewayApiUrlOverride: string
+  luxGatewayUrlOverride: string
+  walletConnectProjectId: string
+  walletConnectProjectIdBeta: string
+  walletConnectProjectIdDev: string
+  enableSessionService: boolean
+  enableSessionUpgradeAuto: boolean
+  enableEntryGatewayProxy: boolean
+}

package/src/contracts.ts

@@ -0,0 +1,193 @@
+import type { Address } from 'viem'
+
+/**
+ * Contract addresses for Lux Mainnet (96369)
+ */
+export const LUX_MAINNET_CONTRACTS = {
+  // Core — verified on-chain 2026-03-05 (149M supply)
+  WLUX: '0x4888e4a2ee0f03051c72d2bd3acf755ed3498b3e' as Address,
+  MULTICALL: '0xd25F88CBdAe3c2CCA3Bb75FC4E723b44C0Ea362F' as Address,
+
+  // Bridge tokens — verified on-chain via V3 pools and bridge MPC
+  LETH: '0x60E0a8167FC13dE89348978860466C9ceC24B9ba' as Address,
+  LBTC: '0x1E48D32a4F5e9f08DB9aE4959163300FaF8A6C8e' as Address,
+  LUSD: '0x848Cff46eb323f323b6Bbe1Df274E40793d7f2c2' as Address,
+  LSOL: '0x26B40f650156C7EbF9e087Dd0dca181Fe87625B7' as Address,
+  LTON: '0x3141b94b89691009b950c96e97Bff48e0C543E3C' as Address,
+  LAVAX: '0x0e4bD0DD67c15dECfBBBdbbE07FC9d51D737693D' as Address,
+
+  // AMM V2 (CREATE2) — 1 pair on-chain
+  V2_FACTORY: '0xD173926A10A0C4eCd3A51B1422270b65Df0551c1' as Address,
+  V2_ROUTER: '0xAe2cf1E403aAFE6C05A5b8Ef63EB19ba591d8511' as Address,
+
+  // AMM V3 (CREATE2) — 8+ pools, active trading, verified on-chain
+  V3_FACTORY: '0x80bBc7C4C7a59C899D1B37BC14539A22D5830a84' as Address,
+  V3_SWAP_ROUTER: '0xE8fb25086C8652c92f5AF90D730Bac7C63Fc9A58' as Address,
+  V3_SWAP_ROUTER_02: '0x939bC0Bca6F9B9c52E6e3AD8A3C590b5d9B9D10E' as Address,
+  V3_QUOTER: '0x12e2B76FaF4dDA5a173a4532916bb6Bfa3645275' as Address,
+  V3_QUOTER_V2: '0x15C729fdd833Ba675edd466Dfc63E1B737925A4c' as Address,
+  V3_NFT_POSITION_MANAGER: '0x7a4C48B9dae0b7c396569b34042fcA604150Ee28' as Address,
+
+  // Governance
+  STAKED_LUX: '0xc606302cd0722DD42c460B09930477d09993F913' as Address,
+  VLUX: '0x55833074AD22E2aAE81ad377A600340eC0bc7cbd' as Address,
+  KARMA: '0xc3d1efb6Eaedd048dDfE7066F1c719C7B6Ca43ad' as Address,
+  DLUX: '0xAAbD65c4Fe3d3f9d54A7C3C7B95B9eD359CC52A8' as Address,
+
+  // DeFi
+  MARKETS: '0x308EBD39eB5E27980944630A0af6F8B0d19e31C6' as Address,
+  PERP: '0x82312E295533Ab5167B306d5aBF7F3eB2C0D95fD' as Address,
+} as const
+
+/**
+ * Contract addresses for Lux Testnet (96368)
+ */
+export const LUX_TESTNET_CONTRACTS = {
+  // Core — deployed via DeployMultiNetwork.s.sol 2026-02-27
+  WLUX: '0xDe5310d0Eccc04C8987cB66Ff6b89Ee793442C91' as Address,
+  MULTICALL: '0xd25F88CBdAe3c2CCA3Bb75FC4E723b44C0Ea362F' as Address,
+
+  // Bridge tokens — deployed via DeployMultiNetwork.s.sol 2026-02-27
+  LETH: '0xA695a8A66fbe3E32d15a531db04185313595771A' as Address,
+  LBTC: '0x5a88986958ea76Dd043f834542724F081cA1443B' as Address,
+  LUSDC: '0x8a3fad1c7FB94461621351aa6A983B6f814F039c' as Address,
+
+  // AMM V2 — deployed via DeployMultiNetwork.s.sol 2026-02-27
+  V2_FACTORY: '0x1DD4e6cbC6B8FD032fCAD5A3B0a45e446A014637' as Address,
+  V2_ROUTER: '0xb06B31521Afc434F87Fe4852c98FC15A26c92aE8' as Address,
+} as const
+
+/**
+ * DEX Precompile addresses (native AMM - Lux v4 style singleton PoolManager)
+ * These provide sub-microsecond execution via native Go implementation
+ *
+ * Address format: 0x0000...00LPNUMBER (addresses end with LP number)
+ * LP-9010: DEX Precompile - Native HFT Order Book (PoolManager)
+ * LP-9011: Oracle Precompile - Multi-Source Price Aggregation
+ *
+ * @see ~/work/lux/precompile/registry/registry.go for the full address scheme
+ * @see ~/work/lux/dex/pkg/gateway/lux/provider.go for gateway implementation
+ */
+export const DEX_PRECOMPILES = {
+  // Core DEX (LP-9010 series - Lux v4 style)
+  POOL_MANAGER: '0x0000000000000000000000000000000000009010' as Address,   // LP-9010
+  SWAP_ROUTER: '0x0000000000000000000000000000000000009012' as Address,    // LP-9012
+  HOOKS_REGISTRY: '0x0000000000000000000000000000000000009013' as Address, // LP-9013
+  FLASH_LOAN: '0x0000000000000000000000000000000000009014' as Address,     // LP-9014
+
+  // DeFi Extensions
+  ORACLE_HUB: '0x0000000000000000000000000000000000009011' as Address,     // LP-9011
+  CLOB: '0x0000000000000000000000000000000000009020' as Address,           // LP-9020
+  VAULT: '0x0000000000000000000000000000000000009030' as Address,          // LP-9030
+
+  // Bridges (LP-6xxx)
+  TELEPORT: '0x0000000000000000000000000000000000006010' as Address,       // LP-6010
+} as const
+
+/**
+ * Contract addresses for Zoo Mainnet (200200)
+ */
+export const ZOO_MAINNET_CONTRACTS = {
+  // Core — deployed via DeployMultiNetwork.s.sol 2026-03-04
+  WLUX: '0x5491216406daB99b7032b83765F36790E27F8A61' as Address,
+  LETH: '0x4870621EA8be7a383eFCfdA225249d35888bD9f2' as Address,
+  LBTC: '0x6fc44509a32E513bE1aa00d27bb298e63830C6A8' as Address,
+  LUSDC: '0xb2ee1CE7b84853b83AA08702aD0aD4D79711882D' as Address,
+  V2_FACTORY: '0xF034942c1140125b5c278aE9cEE1B488e915B2FE' as Address,
+  V2_ROUTER: '0x2cd306913e6546C59249b48d7c786A6D1d7ebE08' as Address,
+  MARKETS: '0x6B7D3c38A3e030B95E101927Ee6ff9913ef626d4' as Address,
+} as const
+
+/**
+ * Contract addresses for Hanzo Mainnet (36963)
+ * Shared subnet deployment addresses (nonce 0)
+ */
+export const HANZO_MAINNET_CONTRACTS = {
+  // Deployed via DeployMultiNetwork.s.sol 2026-03-04
+  WLUX: '0xc65ea8882020Af7CDa7854d590C6Fcd34BF364ec' as Address,
+  LETH: '0x9378b62fC172d2A4f715d7ecF49DE0362f1BB702' as Address,
+  LBTC: '0x7fC4f8a926E47Fa3587C0d7658C00E7489e67916' as Address,
+  LUSDC: '0x51c3408B9A6a0B2446CCB78c72C846CEB76201FA' as Address,
+  V2_FACTORY: '0xDc384E006BAec602b0b2B2fe6f2712646EFb1e9D' as Address,
+  V2_ROUTER: '0x191067f88d61f9506555E88CEab9CF71deeD61A9' as Address,
+  MARKETS: '0x9BC44B0De1aBe2e436C8fA5Cd5cA519026b9D8fD' as Address,
+} as const
+
+/**
+ * Contract addresses for SPC Mainnet (36911)
+ * Shared subnet deployment addresses (nonce 0)
+ */
+export const SPC_MAINNET_CONTRACTS = {
+  // NOT DEPLOYED — genesis key unknown, deployment blocked
+  WLUX: '0x0000000000000000000000000000000000000000' as Address,
+  LETH: '0x0000000000000000000000000000000000000000' as Address,
+  LBTC: '0x0000000000000000000000000000000000000000' as Address,
+  LUSDC: '0x0000000000000000000000000000000000000000' as Address,
+  V2_FACTORY: '0x0000000000000000000000000000000000000000' as Address,
+  V2_ROUTER: '0x0000000000000000000000000000000000000000' as Address,
+  MARKETS: '0x0000000000000000000000000000000000000000' as Address,
+} as const
+
+/**
+ * Contract addresses for Pars Mainnet (494949)
+ * Shared subnet deployment addresses (nonce 0)
+ */
+export const PARS_MAINNET_CONTRACTS = {
+  // Deployed via DeployMultiNetwork.s.sol 2026-03-04
+  WLUX: '0x548F54Dfb32ea6cE4fa3515236696CF3d1b7D26a' as Address,
+  LETH: '0xe0f7E9A0cB1688ccA453995fd6e19AE4fbD9cBfd' as Address,
+  LBTC: '0x7d7cC8D05BB0F38D80b5Ce44b4b069A6FB769468' as Address,
+  LUSDC: '0xC5e4A6f54Be469551a342872C1aB83AB46f61b22' as Address,
+  V2_FACTORY: '0x84CF0A13db1be8e1F0676405cfcBC8b09692FD1C' as Address,
+  V2_ROUTER: '0x2382F7A49FA48E1F91Bec466c32e1D7F13ec8206' as Address,
+  MARKETS: '0x3589fd09e7dfF3f7653fc4965B7CE1b8d8fdA9Bd' as Address,
+} as const
+
+/**
+ * Contract addresses for Lux Dev (1337)
+ * Deterministic CREATE addresses from DeployFullStack.s.sol deployed by anvil account 0
+ * Account 0: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
+ */
+export const LUX_DEV_CONTRACTS = {
+  // Core - Nonce 0
+  WLUX: '0x5FbDB2315678afecb367f032d93F642f64180aa3' as Address,
+  MULTICALL: '0xd25F88CBdAe3c2CCA3Bb75FC4E723b44C0Ea362F' as Address,
+
+  // Bridged tokens (deterministic deployment nonces 1-3)
+  LETH: '0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512' as Address, // Nonce 1
+  LBTC: '0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0' as Address, // Nonce 2
+  LUSD: '0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9' as Address, // Nonce 3
+
+  // AMM V2
+  V2_FACTORY: '0x959922bE3CAee4b8Cd9a407cc3ac1C251C2007B1' as Address,
+  V2_ROUTER: '0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE' as Address,
+
+  // Staking
+  STAKED_LUX: '0xA51c1fc2f0D1a1b8494Ed1FE312d7C3a78Ed91C0' as Address,
+} as const
+
+/**
+ * Get contracts for a specific chain
+ */
+export function getContracts(chainId: number) {
+  switch (chainId) {
+    case 96369:
+      return LUX_MAINNET_CONTRACTS
+    case 96368:
+      return LUX_TESTNET_CONTRACTS
+    case 200200:
+      return ZOO_MAINNET_CONTRACTS
+    case 36963:
+      return HANZO_MAINNET_CONTRACTS
+    case 36911:
+      return SPC_MAINNET_CONTRACTS
+    case 494949:
+      return PARS_MAINNET_CONTRACTS
+    case 1337:
+      return LUX_DEV_CONTRACTS
+    default:
+      return LUX_MAINNET_CONTRACTS
+  }
+}
+
+export type ContractAddresses = typeof LUX_MAINNET_CONTRACTS

package/src/env.ts

@@ -0,0 +1,27 @@
+/**
+ * Environment configuration
+ */
+
+export const ENV = {
+  // Chain IDs
+  DEFAULT_CHAIN_ID: parseInt(process.env['NEXT_PUBLIC_DEFAULT_CHAIN_ID'] || '96369'),
+
+  // API URLs
+  API_URL: process.env['NEXT_PUBLIC_API_URL'] || 'https://api.lux.exchange',
+
+  // RPC URLs
+  LUX_MAINNET_RPC: process.env['NEXT_PUBLIC_LUX_MAINNET_RPC'] || 'https://api.lux.network/rpc',
+  LUX_TESTNET_RPC: process.env['NEXT_PUBLIC_LUX_TESTNET_RPC'] || 'https://api.lux-test.network/rpc',
+  ZOO_MAINNET_RPC: process.env['NEXT_PUBLIC_ZOO_MAINNET_RPC'] || 'https://api.zoo.network/rpc',
+  ZOO_TESTNET_RPC: process.env['NEXT_PUBLIC_ZOO_TESTNET_RPC'] || 'https://api.zoo-test.network/rpc',
+
+  // Feature flags
+  ENABLE_TESTNET: process.env['NEXT_PUBLIC_ENABLE_TESTNET'] === 'true',
+  ENABLE_DEX_PRECOMPILES: process.env['NEXT_PUBLIC_ENABLE_DEX_PRECOMPILES'] === 'true',
+  ENABLE_CROSS_CHAIN: process.env['NEXT_PUBLIC_ENABLE_CROSS_CHAIN'] === 'true',
+
+  // WalletConnect
+  WALLETCONNECT_PROJECT_ID: process.env['NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID'] || '',
+} as const
+
+export type Env = typeof ENV

package/src/getConfig.native.ts

@@ -0,0 +1,130 @@
+import type { Config } from '@luxfi/config/src/config-types'
+import {
+  ALCHEMY_API_KEY,
+  AMPLITUDE_PROXY_URL_OVERRIDE,
+  API_BASE_URL_OVERRIDE,
+  API_BASE_URL_V2_OVERRIDE,
+  APPSFLYER_API_KEY,
+  APPSFLYER_APP_ID,
+  BLOCKAID_PROXY_URL,
+  DATADOG_CLIENT_TOKEN,
+  DATADOG_PROJECT_ID,
+  ENABLE_ENTRY_GATEWAY_PROXY,
+  ENABLE_SESSION_SERVICE,
+  ENABLE_SESSION_UPGRADE_AUTO,
+  ENTRY_GATEWAY_API_URL_OVERRIDE,
+  LUX_GATEWAY_URL,
+  FOR_API_URL_OVERRIDE,
+  GRAPHQL_URL_OVERRIDE,
+  INCLUDE_PROTOTYPE_FEATURES,
+  INFURA_KEY,
+  IS_E2E_TEST,
+  JUPITER_PROXY_URL,
+  LIQUIDITY_SERVICE_URL_OVERRIDE,
+  ONESIGNAL_APP_ID,
+  QUICKNODE_ENDPOINT_NAME,
+  QUICKNODE_ENDPOINT_TOKEN,
+  SCANTASTIC_API_URL_OVERRIDE,
+  STATSIG_API_KEY,
+  STATSIG_PROXY_URL_OVERRIDE,
+  TRADING_API_KEY,
+  TRADING_API_URL_OVERRIDE,
+  LUX_API_KEY,
+  LUX_NOTIF_API_BASE_URL_OVERRIDE,
+  UNITAGS_API_URL_OVERRIDE,
+  WALLETCONNECT_PROJECT_ID,
+  WALLETCONNECT_PROJECT_ID_BETA,
+  WALLETCONNECT_PROJECT_ID_DEV,
+} from 'react-native-dotenv'
+import { isNonTestDev } from '@luxfi/utilities/src/environment/constants'
+
+// Module-level cache for config to avoid recomputing on every call
+let cachedConfig: Config | undefined
+
+// eslint-disable-next-line complexity
+export const getConfig = (): Config => {
+  // Return cached config if already computed
+  if (cachedConfig !== undefined) {
+    return cachedConfig
+  }
+
+  /**
+   * Naming requirements for different environments:
+   * - Web ENV vars: must have process.env.REACT_APP_<var_name>
+   * - Extension ENV vars: must have process.env.<var_name>
+   * - Mobile ENV vars: must have BOTH process.env.<var_name> and <var_name>
+   *
+   *  The CI requires web vars to have the required 'REACT_APP_' prefix. The react-dot-env library doesnt integrate with CI correctly,
+   *  so we pull from github secrets directly with process.env.<var_name> for both extension and mobile. <var_name> is used for local mobile builds.
+   */
+
+  const config: Config = {
+    alchemyApiKey: process.env.REACT_APP_ALCHEMY_API_KEY || process.env.ALCHEMY_API_KEY || ALCHEMY_API_KEY,
+    amplitudeProxyUrlOverride: process.env.AMPLITUDE_PROXY_URL_OVERRIDE || AMPLITUDE_PROXY_URL_OVERRIDE,
+    apiBaseUrlOverride: process.env.API_BASE_URL_OVERRIDE || API_BASE_URL_OVERRIDE,
+    apiBaseUrlV2Override: process.env.API_BASE_URL_V2_OVERRIDE || API_BASE_URL_V2_OVERRIDE,
+    appsflyerApiKey: process.env.APPSFLYER_API_KEY || APPSFLYER_API_KEY,
+    appsflyerAppId: process.env.APPSFLYER_APP_ID || APPSFLYER_APP_ID,
+    blockaidProxyUrl: process.env.BLOCKAID_PROXY_URL || BLOCKAID_PROXY_URL,
+    datadogClientToken:
+      process.env.REACT_APP_DATADOG_CLIENT_TOKEN || process.env.DATADOG_CLIENT_TOKEN || DATADOG_CLIENT_TOKEN,
+    datadogProjectId: process.env.REACT_APP_DATADOG_PROJECT_ID || process.env.DATADOG_PROJECT_ID || DATADOG_PROJECT_ID,
+    enableEntryGatewayProxy: process.env.ENABLE_ENTRY_GATEWAY_PROXY === 'true' || ENABLE_ENTRY_GATEWAY_PROXY === 'true',
+    enableSessionService: process.env.ENABLE_SESSION_SERVICE === 'true' || ENABLE_SESSION_SERVICE === 'true',
+    enableSessionUpgradeAuto:
+      process.env.ENABLE_SESSION_UPGRADE_AUTO === 'true' || ENABLE_SESSION_UPGRADE_AUTO === 'true',
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    isE2ETest: process.env.IS_E2E_TEST?.toLowerCase() === 'true' || IS_E2E_TEST?.toLowerCase() === 'true',
+    forApiUrlOverride: process.env.FOR_API_URL_OVERRIDE || FOR_API_URL_OVERRIDE,
+    graphqlUrlOverride: process.env.GRAPHQL_URL_OVERRIDE || GRAPHQL_URL_OVERRIDE,
+    // G-Chain GraphQL: testnet=9650, mainnet=9630
+    gChainGraphqlUrl:
+      process.env['GCHAIN_GRAPHQL_URL'] ||
+      (isNonTestDev ? 'http://localhost:9650/ext/bc/G/graphql' : 'http://localhost:9630/ext/bc/G/graphql'),
+    infuraKey: process.env.REACT_APP_INFURA_KEY || INFURA_KEY,
+    includePrototypeFeatures: process.env.INCLUDE_PROTOTYPE_FEATURES || INCLUDE_PROTOTYPE_FEATURES,
+    isVercelEnvironment: false, // never set to true for native
+    jupiterProxyUrl: process.env.JUPITER_PROXY_URL || JUPITER_PROXY_URL,
+    onesignalAppId: process.env.ONESIGNAL_APP_ID || ONESIGNAL_APP_ID,
+    quicknodeEndpointName:
+      process.env.REACT_APP_QUICKNODE_ENDPOINT_NAME || process.env.QUICKNODE_ENDPOINT_NAME || QUICKNODE_ENDPOINT_NAME,
+    quicknodeEndpointToken:
+      process.env.REACT_APP_QUICKNODE_ENDPOINT_TOKEN ||
+      process.env.QUICKNODE_ENDPOINT_TOKEN ||
+      QUICKNODE_ENDPOINT_TOKEN,
+    scantasticApiUrlOverride: process.env.SCANTASTIC_API_URL_OVERRIDE || SCANTASTIC_API_URL_OVERRIDE,
+    statsigApiKey: process.env.REACT_APP_STATSIG_API_KEY || process.env.STATSIG_API_KEY || STATSIG_API_KEY,
+    statsigProxyUrlOverride: process.env.STATSIG_PROXY_URL_OVERRIDE || STATSIG_PROXY_URL_OVERRIDE,
+    tradingApiKey: process.env.REACT_APP_TRADING_API_KEY || process.env.TRADING_API_KEY || TRADING_API_KEY,
+    tradingApiUrlOverride:
+      process.env.REACT_APP_TRADING_API_URL_OVERRIDE ||
+      process.env.TRADING_API_URL_OVERRIDE ||
+      TRADING_API_URL_OVERRIDE,
+    tradingApiWebTestEnv: process.env.REACT_APP_TRADING_API_TEST_ENV || '',
+    liquidityServiceUrlOverride:
+      process.env.REACT_APP_LIQUIDITY_SERVICE_URL_OVERRIDE ||
+      process.env.LIQUIDITY_SERVICE_URL_OVERRIDE ||
+      LIQUIDITY_SERVICE_URL_OVERRIDE,
+    luxApiKey: process.env.LUX_API_KEY || LUX_API_KEY,
+    unitagsApiUrlOverride: process.env.UNITAGS_API_URL_OVERRIDE || UNITAGS_API_URL_OVERRIDE,
+    luxNotifApiBaseUrlOverride:
+      process.env.LUX_NOTIF_API_BASE_URL_OVERRIDE || LUX_NOTIF_API_BASE_URL_OVERRIDE,
+    entryGatewayApiUrlOverride: process.env.ENTRY_GATEWAY_API_URL_OVERRIDE || ENTRY_GATEWAY_API_URL_OVERRIDE,
+    luxGatewayUrlOverride: process.env['LUX_GATEWAY_URL'] || LUX_GATEWAY_URL || '',
+    walletConnectProjectId:
+      process.env.REACT_APP_WALLET_CONNECT_PROJECT_ID ||
+      process.env.WALLETCONNECT_PROJECT_ID ||
+      WALLETCONNECT_PROJECT_ID,
+    walletConnectProjectIdBeta: process.env.WALLETCONNECT_PROJECT_ID_BETA || WALLETCONNECT_PROJECT_ID_BETA,
+    walletConnectProjectIdDev: process.env.WALLETCONNECT_PROJECT_ID_DEV || WALLETCONNECT_PROJECT_ID_DEV,
+  }
+
+  if (isNonTestDev) {
+    // biome-ignore lint/suspicious/noConsole: Cannot use logger here, causes error from circular dep
+    console.debug('Using app config:', config)
+  }
+
+  // Cache and return frozen config
+  cachedConfig = Object.freeze(config)
+  return cachedConfig
+}

package/src/getConfig.ts

@@ -0,0 +1,6 @@
+import { Config } from '@luxfi/config/src/config-types'
+import { PlatformSplitStubError } from '@luxfi/utilities/src/errors'
+
+export function getConfig(): Config {
+  throw new PlatformSplitStubError('Use the correct getConfig for your platform')
+}