@megatao/sdk 1.1.0

package/src/config/environments/dev.config.ts

@@ -0,0 +1,122 @@
+/**
+ * Development Environment Configuration
+ *
+ * Uses Mock TAO (WTAO) with 18 decimals
+ * 4 subnet markets: BitMind, Chutes, Affine, Ridges
+ * Initial vault: 3,103.45 TAO
+ *
+ * LAST SYNCED: 2025-11-05
+ * DEPLOYMENT: deployments/dev/deployment.json
+ */
+
+import { NetworkConfig } from '../../types';
+
+export const DEV_CONFIG: NetworkConfig = {
+  chainId: 964,
+  name: 'Alpha Futures - Development',
+  rpcUrl: 'https://bittensor-finney.api.onfinality.io/public',
+  blockExplorer: 'https://evm.taostats.io/',
+  contracts: {
+    alpha: '0x04C1E717BBD3A18353b1f2D426c0E3B96514794B',
+    priceOracle: '0x6541318525de2FBB108a35Ecd57b14E9A5418fCC',
+    collateralToken: '0xA4B080fd023249170e759dcA1C2Ae23792DD6b66', // Mock TAO (WTAO)
+  },
+  markets: [
+    {
+      id: 64,
+      name: 'Chutes',
+      marketAddress: '0x0000000000000000000000000000000000000040',
+      symbol: 'CHUTES',
+      displayName: 'Chutes (SN64)',
+      hasOraclePrice: false,
+    },
+    {
+      id: 51,
+      name: 'lium.io',
+      marketAddress: '0x0000000000000000000000000000000000000033',
+      symbol: 'LIUM',
+      displayName: 'lium.io (SN51)',
+      hasOraclePrice: false,
+    },
+    {
+      id: 62,
+      name: 'Ridges',
+      marketAddress: '0x000000000000000000000000000000000000003e',
+      symbol: 'RIDGES',
+      displayName: 'Ridges (SN62)',
+      hasOraclePrice: false,
+    },
+    {
+      id: 4,
+      name: 'Targon',
+      marketAddress: '0x0000000000000000000000000000000000000004',
+      symbol: 'TARGON',
+      displayName: 'Targon (SN4)',
+      hasOraclePrice: false,
+    },
+    {
+      id: 8,
+      name: 'Vanta',
+      marketAddress: '0x0000000000000000000000000000000000000008',
+      symbol: 'VANTA',
+      displayName: 'Vanta (SN8)',
+      hasOraclePrice: false,
+    },
+    {
+      id: 120,
+      name: 'Affine',
+      marketAddress: '0x0000000000000000000000000000000000000078',
+      symbol: 'AFFINE',
+      displayName: 'Affine (SN120)',
+      hasOraclePrice: false,
+    },
+    {
+      id: 3,
+      name: 'templar',
+      marketAddress: '0x0000000000000000000000000000000000000003',
+      symbol: 'TEMPLAR',
+      displayName: 'templar (SN3)',
+      hasOraclePrice: false,
+    },
+    {
+      id: 44,
+      name: 'Score',
+      marketAddress: '0x000000000000000000000000000000000000002c',
+      symbol: 'SCORE',
+      displayName: 'Score (SN44)',
+      hasOraclePrice: false,
+    },
+    {
+      id: 9,
+      name: 'iota',
+      marketAddress: '0x0000000000000000000000000000000000000009',
+      symbol: 'IOTA',
+      displayName: 'iota (SN9)',
+      hasOraclePrice: false,
+    },
+    {
+      id: 56,
+      name: 'Gradients',
+      marketAddress: '0x0000000000000000000000000000000000000038',
+      symbol: 'GRADIENTS',
+      displayName: 'Gradients (SN56)',
+      hasOraclePrice: false,
+    },
+    {
+      id: 75,
+      name: 'Hippius',
+      marketAddress: '0x000000000000000000000000000000000000004b',
+      symbol: 'HIPPIUS',
+      displayName: 'Hippius (SN75)',
+      hasOraclePrice: false,
+    },
+    {
+      id: 34,
+      name: 'BitMind',
+      marketAddress: '0x0000000000000000000000000000000000000022',
+      symbol: 'BITMIND',
+      displayName: 'BitMind (SN34)',
+      hasOraclePrice: false,
+    },
+  ],
+};

package/src/config/environments/index.ts

@@ -0,0 +1,87 @@
+/**
+ * Environment configurations for Alpha Futures Protocol
+ *
+ * Provides environment-specific configurations for different deployment stages:
+ * - dev: Development environment with Mock TAO
+ * - alpha: Internal testing with Mock USDC
+ * - beta: Staging environment with Mock USDC
+ * - prod: Production environment with Real USDC
+ */
+
+import { NetworkConfig } from '../../types';
+import { DEV_CONFIG } from './dev.config';
+import { ALPHA_CONFIG } from './alpha.config';
+import { BETA_CONFIG } from './beta.config';
+import { PROD_CONFIG } from './prod.config';
+import { LOCALHOST_CONFIG } from './localhost.config';
+
+export type Environment = 'localhost' | 'dev' | 'alpha' | 'beta' | 'prod';
+
+/**
+ * Environment configurations mapped by environment name
+ */
+export const ENVIRONMENT_CONFIGS: Record<Environment, NetworkConfig> = {
+  localhost: LOCALHOST_CONFIG,
+  dev: DEV_CONFIG,
+  alpha: ALPHA_CONFIG,
+  beta: BETA_CONFIG,
+  prod: PROD_CONFIG,
+};
+
+/**
+ * Get configuration for a specific environment
+ * @param environment - The environment to get configuration for
+ * @returns Network configuration for the specified environment
+ * @throws Error if environment is invalid
+ */
+export function getEnvironmentConfig(environment: Environment): NetworkConfig {
+  const config = ENVIRONMENT_CONFIGS[environment];
+  if (!config) {
+    throw new Error(
+      `Invalid environment: ${environment}. Valid environments are: ${Object.keys(ENVIRONMENT_CONFIGS).join(', ')}`,
+    );
+  }
+  return config;
+}
+
+/**
+ * Check if an environment name is valid
+ * @param environment - The environment name to validate
+ * @returns True if the environment is valid
+ */
+export function isValidEnvironment(environment: string): environment is Environment {
+  return environment in ENVIRONMENT_CONFIGS;
+}
+
+/**
+ * Get all available environments
+ * @returns Array of all valid environment names
+ */
+export function getAvailableEnvironments(): Environment[] {
+  return Object.keys(ENVIRONMENT_CONFIGS) as Environment[];
+}
+
+/**
+ * Get environment name by chain ID and contract address
+ * Useful for determining which environment a user is connected to
+ * @param chainId - The chain ID to match
+ * @param alphaAddress - The alpha contract address to match
+ * @returns The environment name or undefined if not found
+ */
+export function getEnvironmentByAddress(
+  chainId: number,
+  alphaAddress: string,
+): Environment | undefined {
+  const normalizedAddress = alphaAddress.toLowerCase();
+
+  for (const [env, config] of Object.entries(ENVIRONMENT_CONFIGS)) {
+    if (config.chainId === chainId && config.contracts.alpha?.toLowerCase() === normalizedAddress) {
+      return env as Environment;
+    }
+  }
+
+  return undefined;
+}
+
+// Re-export environment configs for convenience
+export { LOCALHOST_CONFIG, DEV_CONFIG, ALPHA_CONFIG, BETA_CONFIG, PROD_CONFIG };

package/src/config/environments/localhost.config.ts

@@ -0,0 +1,153 @@
+/**
+ * Localhost Environment Configuration
+ *
+ * Used for local Anvil development and E2E testing
+ * Reads contract addresses from environment variables set by .env.anvil
+ *
+ * Environment variables (from .env.anvil):
+ *   ALPHA - Main protocol contract
+ *   TAO_TOKEN - Collateral token
+ *   PRICE_ORACLE - Price oracle contract
+ *   ALPHA_BTC - BTC market address
+ *   ALPHA_ETH - ETH market address
+ */
+
+import { NetworkConfig } from '../../types';
+import { Address } from 'viem';
+
+// Helper to get address from env with fallback
+const getEnvAddress = (key: string, fallback: string): Address => {
+  return (process.env[key] || fallback) as Address;
+};
+
+// Create config as a getter so env vars are read at access time, not import time
+export const LOCALHOST_CONFIG: NetworkConfig = {
+  chainId: 31337,
+  name: 'Alpha Futures - Localhost',
+  rpcUrl: process.env.RPC_URL || 'http://localhost:8545',
+  blockExplorer: 'http://localhost:8545',
+  get contracts() {
+    return {
+      alpha: getEnvAddress('ALPHA', '0x610178dA211FEF7D417bC0e6FeD39F05609AD788'),
+      priceOracle: getEnvAddress('PRICE_ORACLE', '0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9'),
+      collateralToken: getEnvAddress('TAO_TOKEN', '0x5FbDB2315678afecb367f032d93F642f64180aa3'),
+    };
+  },
+  get markets() {
+    return [
+      {
+        id: 64,
+        name: 'Chutes',
+        marketAddress: '0x0000000000000000000000000000000000000040' as Address,
+        symbol: 'CHUTES',
+        displayName: 'Chutes (SN64)',
+        hasOraclePrice: false,
+      },
+      {
+        id: 51,
+        name: 'lium.io',
+        marketAddress: '0x0000000000000000000000000000000000000033' as Address,
+        symbol: 'LIUM',
+        displayName: 'lium.io (SN51)',
+        hasOraclePrice: false,
+      },
+      {
+        id: 62,
+        name: 'Ridges',
+        marketAddress: '0x000000000000000000000000000000000000003e' as Address,
+        symbol: 'RIDGES',
+        displayName: 'Ridges (SN62)',
+        hasOraclePrice: false,
+      },
+      {
+        id: 4,
+        name: 'Targon',
+        marketAddress: '0x0000000000000000000000000000000000000004' as Address,
+        symbol: 'TARGON',
+        displayName: 'Targon (SN4)',
+        hasOraclePrice: false,
+      },
+      {
+        id: 8,
+        name: 'Vanta',
+        marketAddress: '0x0000000000000000000000000000000000000008' as Address,
+        symbol: 'VANTA',
+        displayName: 'Vanta (SN8)',
+        hasOraclePrice: false,
+      },
+      {
+        id: 120,
+        name: 'Affine',
+        marketAddress: '0x0000000000000000000000000000000000000078' as Address,
+        symbol: 'AFFINE',
+        displayName: 'Affine (SN120)',
+        hasOraclePrice: false,
+      },
+      {
+        id: 3,
+        name: 'templar',
+        marketAddress: '0x0000000000000000000000000000000000000003' as Address,
+        symbol: 'TEMPLAR',
+        displayName: 'templar (SN3)',
+        hasOraclePrice: false,
+      },
+      {
+        id: 44,
+        name: 'Score',
+        marketAddress: '0x000000000000000000000000000000000000002c' as Address,
+        symbol: 'SCORE',
+        displayName: 'Score (SN44)',
+        hasOraclePrice: false,
+      },
+      {
+        id: 9,
+        name: 'iota',
+        marketAddress: '0x0000000000000000000000000000000000000009' as Address,
+        symbol: 'IOTA',
+        displayName: 'iota (SN9)',
+        hasOraclePrice: false,
+      },
+      {
+        id: 56,
+        name: 'Gradients',
+        marketAddress: '0x0000000000000000000000000000000000000038' as Address,
+        symbol: 'GRADIENTS',
+        displayName: 'Gradients (SN56)',
+        hasOraclePrice: false,
+      },
+      {
+        id: 75,
+        name: 'Hippius',
+        marketAddress: '0x000000000000000000000000000000000000004b' as Address,
+        symbol: 'HIPPIUS',
+        displayName: 'Hippius (SN75)',
+        hasOraclePrice: false,
+      },
+      {
+        id: 34,
+        name: 'BitMind',
+        marketAddress: '0x0000000000000000000000000000000000000022' as Address,
+        symbol: 'BITMIND',
+        displayName: 'BitMind (SN34)',
+        hasOraclePrice: false,
+      },
+      // Legacy test markets (for localhost testing)
+      {
+        id: 1,
+        name: 'Alpha BTC',
+        marketAddress: getEnvAddress('ALPHA_BTC', '0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512'),
+        symbol: 'BTC',
+        displayName: 'Alpha BTC',
+        hasOraclePrice: true,
+      },
+      {
+        id: 2,
+        name: 'Alpha ETH',
+        marketAddress: getEnvAddress('ALPHA_ETH', '0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0'),
+        symbol: 'ETH',
+        displayName: 'Alpha ETH',
+        hasOraclePrice: true,
+      },
+    ];
+  },
+};

package/src/config/environments/prod.config.ts

@@ -0,0 +1,142 @@
+/**
+ * Production Environment Configuration
+ *
+ * Uses Real USDC with 6 decimals
+ * 1 market: ALPHA_BTC
+ * No initial vault seeding
+ *
+ * LAST SYNCED: 2026-02-13
+ * DEPLOYMENT: deployments/prod/deployment.json
+ *
+ * NOTE: This environment has not been deployed yet.
+ * Production deployment requires CONFIRM_PROD=true environment variable.
+ * Run `CONFIRM_PROD=true npm run deploy -- --env prod` to deploy contracts.
+ * Then run `npm run sync -- --env prod` to update these addresses.
+ *
+ * ⚠️ WARNING: Production deployment uses real USDC. Handle with extreme care.
+ */
+
+import { NetworkConfig } from '../../types';
+
+export const PROD_CONFIG: NetworkConfig = {
+  chainId: 964,
+  name: 'Alpha Futures - Production',
+  rpcUrl: 'https://bittensor-finney.api.onfinality.io/public',
+  blockExplorer: 'https://evm.taostats.io/',
+  contracts: {
+    alpha: '0xdA50070976Da21A0E7afaB1BB0c81CD51926AE64', // Placeholder - will be updated after deployment
+    priceOracle: '0x446A342221ed83b56fc17eA3e046dd19153beA85',
+    collateralToken: '0x0000000000000000000000000000000000000000', // Real USDC
+  },
+  collateralTokenInfo: {
+    symbol: 'TAO',
+    decimals: 18,
+    name: 'TAO',
+  },
+  markets: [
+    {
+      id: 64,
+      name: 'Chutes',
+      marketAddress: '0x0000000000000000000000000000000000000040',
+      symbol: 'CHUTES',
+      displayName: 'Chutes (SN64)',
+      hasOraclePrice: true,
+    },
+    {
+      id: 51,
+      name: 'lium.io',
+      marketAddress: '0x0000000000000000000000000000000000000033',
+      symbol: 'LIUM',
+      displayName: 'lium.io (SN51)',
+      hasOraclePrice: true,
+    },
+    {
+      id: 62,
+      name: 'Ridges',
+      marketAddress: '0x000000000000000000000000000000000000003e',
+      symbol: 'RIDGES',
+      displayName: 'Ridges (SN62)',
+      hasOraclePrice: true,
+    },
+    {
+      id: 4,
+      name: 'Targon',
+      marketAddress: '0x0000000000000000000000000000000000000004',
+      symbol: 'TARGON',
+      displayName: 'Targon (SN4)',
+      hasOraclePrice: true,
+    },
+    {
+      id: 8,
+      name: 'Vanta',
+      marketAddress: '0x0000000000000000000000000000000000000008',
+      symbol: 'VANTA',
+      displayName: 'Vanta (SN8)',
+      hasOraclePrice: true,
+    },
+    {
+      id: 120,
+      name: 'Affine',
+      marketAddress: '0x0000000000000000000000000000000000000078',
+      symbol: 'AFFINE',
+      displayName: 'Affine (SN120)',
+      hasOraclePrice: true,
+    },
+    {
+      id: 3,
+      name: 'templar',
+      marketAddress: '0x0000000000000000000000000000000000000003',
+      symbol: 'TEMPLAR',
+      displayName: 'templar (SN3)',
+      hasOraclePrice: true,
+    },
+    {
+      id: 44,
+      name: 'Score',
+      marketAddress: '0x000000000000000000000000000000000000002c',
+      symbol: 'SCORE',
+      displayName: 'Score (SN44)',
+      hasOraclePrice: true,
+    },
+    {
+      id: 9,
+      name: 'iota',
+      marketAddress: '0x0000000000000000000000000000000000000009',
+      symbol: 'IOTA',
+      displayName: 'iota (SN9)',
+      hasOraclePrice: true,
+    },
+    {
+      id: 56,
+      name: 'Gradients',
+      marketAddress: '0x0000000000000000000000000000000000000038',
+      symbol: 'GRADIENTS',
+      displayName: 'Gradients (SN56)',
+      hasOraclePrice: true,
+    },
+    {
+      id: 75,
+      name: 'Hippius',
+      marketAddress: '0x000000000000000000000000000000000000004b',
+      symbol: 'HIPPIUS',
+      displayName: 'Hippius (SN75)',
+      hasOraclePrice: true,
+    },
+    {
+      id: 34,
+      name: 'BitMind',
+      marketAddress: '0x0000000000000000000000000000000000000022',
+      symbol: 'BITMIND',
+      displayName: 'BitMind (SN34)',
+      hasOraclePrice: true,
+    },
+    {
+      id: 65534,
+      name: 'MTSOS',
+      marketAddress: '0x000000000000000000000000000000000000FFFE',
+      symbol: 'MTSOS',
+      displayName: 'MegaTAO Sum-of-Subnets Index',
+      hasOraclePrice: true,
+    },
+  ],
+};

package/src/config/index.ts

@@ -0,0 +1,29 @@
+/**
+ * Configuration module exports
+ */
+
+export * from './contracts.config';
+
+// Re-export network utilities for convenience
+export {
+  detectNetwork,
+  switchNetwork,
+  addNetwork,
+  createNetworkClient,
+  validateChainId,
+  getSupportedNetworks,
+  formatNetworkName,
+  NetworkInfo,
+  createCustomChain,
+  getChainById,
+} from '../utils/network';
+
+// Re-export network constants
+export {
+  NETWORK_CONFIGS,
+  DEFAULT_NETWORK,
+  getCurrentNetwork,
+  getNetworkByChainId,
+  isValidNetwork,
+  getNetworkName,
+} from '../constants/networks';