@megatao/sdk 1.1.0

package/package.json

@@ -0,0 +1,113 @@
+{
+  "name": "@megatao/sdk",
+  "version": "1.1.0",
+  "description": "TypeScript SDK for MegaTAO perpetual futures protocol",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "jest",
+    "test:unit": "jest test/unit",
+    "test:integration": "jest test/integration",
+    "test:integration:anvil": "jest test/integration/anvil-trading.test.ts",
+    "test:e2e": "jest test/e2e",
+    "test:cli": "jest test/cli",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:ci": "jest --coverage --ci --reporters=default --reporters=jest-junit",
+    "anvil:start": "../script/e2e/anvil-manager.sh start",
+    "anvil:stop": "../script/e2e/anvil-manager.sh stop",
+    "anvil:restart": "../script/e2e/anvil-manager.sh restart",
+    "anvil:status": "../script/e2e/anvil-manager.sh status",
+    "anvil:logs": "../script/e2e/anvil-manager.sh logs",
+    "deploy:anvil": "../script/e2e/deploy.sh",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\" \"examples/**/*.ts\" \"cli/**/*.ts\"",
+    "prepublishOnly": "npm run clean && npm run build",
+    "cli": "tsx cli/index.ts",
+    "cli:dev": "tsx watch cli/index.ts",
+    "cli:interactive": "tsx cli/interactive.ts",
+    "postinstall": "node -e \"console.log('\\n✨ MegaTAO SDK installed successfully!\\n\\nRun \\'npx alf --help\\' to get started.\\n')\"",
+    "generate:abis": "ts-node scripts/generate-abis.ts",
+    "generate": "npm run generate:abis",
+    "sync-abi": "ts-node scripts/sync-abi.ts",
+    "sync": "ts-node scripts/sync-deployment.ts",
+    "typecheck": "tsc --noEmit",
+    "deploy:anvil": "./scripts/deploy-monolith-anvil.sh",
+    "test:deployment": "./scripts/test-deployment.sh",
+    "deploy:test": "npm run deploy:anvil && npm run test:deployment"
+  },
+  "keywords": [
+    "megatao",
+    "perpetual-futures",
+    "defi",
+    "bittensor",
+    "typescript",
+    "sdk"
+  ],
+  "author": "MegaTAO Team",
+  "license": "MIT",
+  "dependencies": {
+    "@types/node": "^20.10.5",
+    "abitype": "^1.0.0",
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.3",
+    "commander": "^11.1.0",
+    "conf": "^12.0.0",
+    "dotenv": "^16.3.1",
+    "figlet": "^1.7.0",
+    "inquirer": "^9.2.12",
+    "ora": "^7.0.1",
+    "tsx": "^4.20.5",
+    "viem": "^2.38.6"
+  },
+  "peerDependencies": {
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/figlet": "^1.5.8",
+    "@types/inquirer": "^9.0.7",
+    "@types/jest": "^29.5.11",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "jest": "^29.7.0",
+    "jest-junit": "^16.0.0",
+    "prettier": "^3.1.1",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  },
+  "bin": {
+    "alf": "./bin/alf"
+  },
+  "files": [
+    "dist",
+    "src",
+    "cli",
+    "bin",
+    "docs",
+    "README.md",
+    "CHANGELOG.md",
+    "config.example.json",
+    ".env.example"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mega-tao/megatao-monorepo",
+    "directory": "sdk"
+  },
+  "homepage": "https://megatao.com",
+  "bugs": {
+    "url": "https://github.com/mega-tao/megatao-monorepo/issues"
+  }
+}

package/src/AlphaFuturesClient.ts

@@ -0,0 +1,158 @@
+/**
+ * Alpha Futures Client
+ * Main client class that provides access to all protocol contracts
+ */
+
+import { PriceOracleViem } from './contracts/viem/PriceOracleViem';
+import { AlphaViem } from './contracts/viem/AlphaViem';
+import { getEnvironmentConfig, type Environment } from './config/environments';
+import {
+  createPublicClient,
+  createWalletClient,
+  http,
+  type PublicClient,
+  type WalletClient,
+  type Address,
+} from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+
+export interface AlphaClientConfig {
+  rpcUrl?: string;
+  privateKey?: `0x${string}`;
+  walletClient?: WalletClient;
+}
+
+export class AlphaFuturesClient {
+  private alphaContract: AlphaViem;
+  private oracleContract: PriceOracleViem;
+  private publicClient: PublicClient;
+  private walletClient?: WalletClient;
+  private environment?: Environment;
+  public readonly oracle: PriceOracleViem;
+
+  constructor(environment: Environment, config: AlphaClientConfig = {}) {
+    this.environment = environment;
+    const envConfig = getEnvironmentConfig(environment);
+
+    const rpcUrl = config.rpcUrl || envConfig.rpcUrl || 'http://localhost:8545';
+    // Multicall3 is deployed at the standard address on Bittensor EVM
+    const MULTICALL3_ADDRESS = '0xcA11bde05977b3631167028862bE2a173976CA11';
+
+    // Only configure multicall3 for non-localhost environments
+    // Anvil/localhost doesn't have multicall3 deployed by default
+    const isLocalhost = environment === 'localhost';
+    const chain = {
+      id: envConfig.chainId,
+      name: envConfig.name,
+      network: envConfig.name.toLowerCase().replace(/\s+/g, '-'),
+      nativeCurrency: { name: 'TAO', symbol: 'TAO', decimals: 18 },
+      rpcUrls: {
+        default: { http: [rpcUrl] },
+        public: { http: [rpcUrl] },
+      },
+      ...(isLocalhost
+        ? {}
+        : {
+            contracts: {
+              multicall3: {
+                address: MULTICALL3_ADDRESS as Address,
+              },
+            },
+          }),
+    } as any;
+
+    // Create public client with caching disabled for fresh blockchain data
+    // Multicall enabled only for non-localhost: batches eth_call requests into single multicall3 call
+    // This improves performance and guarantees all reads are from the same block
+    this.publicClient = createPublicClient({
+      chain,
+      transport: http(rpcUrl, {
+        // Disable Next.js/Vercel fetch caching - critical for fresh blockchain data
+        fetchOptions: { cache: 'no-store' },
+      }),
+      cacheTime: 0, // Disable viem's internal caching
+      ...(isLocalhost
+        ? {}
+        : {
+            batch: {
+              multicall: {
+                wait: 10, // Batch requests within 10ms window
+              },
+            },
+          }),
+    }) as PublicClient;
+
+    // Use provided wallet client or create one from private key
+    if (config.walletClient) {
+      this.walletClient = config.walletClient;
+    } else if (config.privateKey) {
+      const account = privateKeyToAccount(config.privateKey);
+      this.walletClient = createWalletClient({
+        account,
+        chain,
+        transport: http(rpcUrl, { fetchOptions: { cache: 'no-store' } }),
+      });
+    }
+
+    // Initialize Alpha contract
+    this.alphaContract = new AlphaViem(
+      envConfig.contracts.alpha as Address,
+      this.publicClient,
+      this.walletClient,
+      envConfig.contracts.collateralToken as Address,
+    );
+
+    // Initialize Oracle contract
+    this.oracleContract = new PriceOracleViem(
+      envConfig.contracts.priceOracle as Address,
+      this.publicClient,
+      this.walletClient,
+    );
+    this.oracle = this.oracleContract;
+  }
+
+  getAlpha(): AlphaViem {
+    return this.alphaContract;
+  }
+
+  getPublicClient(): PublicClient {
+    return this.publicClient;
+  }
+
+  getWalletClient(): WalletClient | undefined {
+    return this.walletClient;
+  }
+
+  getEnvironment(): Environment | undefined {
+    return this.environment;
+  }
+
+  get isInitialized(): boolean {
+    return !!this.alphaContract;
+  }
+
+  get isConnected(): boolean {
+    return !!this.walletClient;
+  }
+
+  async getSignerAddress(): Promise<Address | undefined> {
+    return this.walletClient?.account?.address;
+  }
+
+  /**
+   * Get the collateral token address (TAO/USDC) for the current environment
+   * @returns The collateral token contract address
+   */
+  getCollateralTokenAddress(): Address | undefined {
+    if (!this.environment) return undefined;
+    const envConfig = getEnvironmentConfig(this.environment);
+    return envConfig.contracts.collateralToken;
+  }
+
+  static forEnvironment(
+    environment: Environment,
+    config: AlphaClientConfig = {},
+  ): AlphaFuturesClient {
+    return new AlphaFuturesClient(environment, config);
+  }
+}

package/src/abi/.gitkeep

@@ -0,0 +1 @@
+# ABI files will be generated here by the generate-abis script