Overview

AlphaTrade is a decentralized GPU compute and AI-trading-model marketplace. The system has five layers, all in this repo:

1. GPU Marketplace — providers list rigs, users rent and escrow ETH
2. Model NFTs (ERC-7857) — trained AI models tokenized with zkML proofs
3. Performance Oracle — verifies SNARK proofs and recomputes Sharpe on-chain
4. Meta-Agent Vaults (ERC-4626) — autonomous trading bots that own model NFTs and rebalance a basket on Uniswap V3
5. Frontend — Next.js 14 dApp covering all five tabs

Built for ETHGlobal Open Agents (approach C). Single-developer scope; all layers in one repo.

Quick Start (Local)

You need three terminals. After this you'll have a fully working dApp on Anvil.

bash
cd /Users/pushkaraj/Documents/AlphaTrade/ComputeX-Contracts
anvil

bash
# In a new terminal:
cd /Users/pushkaraj/Documents/AlphaTrade/ComputeX-Contracts
export PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
export RPC_URL=http://127.0.0.1:8545
forge script script/Deploy.s.sol:Deploy --rpc-url $RPC_URL --broadcast

bash
forge script script/DeployMetaAgentLocal.s.sol:DeployMetaAgentLocal --rpc-url $RPC_URL --broadcast

bash
cd ../frontend
npm install   # only first time
npm run dev   # serves on http://localhost:3000

Testing the Full Flow

The full loop uses three Anvil accounts. Each row below is one MetaMask account switch.

The Stack

Why these choices:

• Foundry over Hardhat — faster tests, native fuzzing, simpler scripts
• OZ v5.0.2 pinned — v5.6+ requires solc 0.8.24 which breaks Foundry's default toolchain
• EZKL Halo2 over Risc0/SP1 — smaller proofs (~29 KB) and ~38s prove time on M1
• ERC-4626 for vaults — battle-tested deposit/redeem accounting

Smart Contracts

zkML Pipeline

The off-chain pipeline lives in backend/zkml/:

• model.py — AlphaMLP: 120→32→16→5 ReLU+softmax, ~3.4k params
• train.py — PyTorch trainer, exports ONNX, deterministic SHA3 weights hash
• oracle_feed.py — generates GBM price feed, builds sorted-pair Merkle tree, signs root
• backtest.py + sharpe.py — bit-exact Sharpe-bps parity with Solidity _isqrt
• prove.py — full EZKL Halo2 pipeline (gen_settings → calibrate → compile → witness → setup → prove → EVM verifier)

Meta-Agents

A meta-agent is a fund + bot pair:

• On-chain: a MetaAgentVault holding USDC and a basket of 5 tokens
• Off-chain: a Python runtime (backend/meta_agent/runtime.py) that:
  • Listens for AuditAccepted events from the oracle
  • Runs an EXP4 contextual bandit over eligible model NFTs
  • Aggregates ONNX inference outputs into target weights
  • Signs and submits executeTrade(uint16[5] weights, blockNumber, sig)

The operator is whoever holds the agentId NFT in MetaAgentRegistry. They earn the perf fee on harvest. Depositors track the NAV.

Prerequisites

• Foundry — install with

  bash
  curl -L https://foundry.paradigm.xyz | bash && foundryup

• Node.js 20+ and npm
• Python 3.12 (for zkML + meta-agent runtime)
• MetaMask browser extension
• Optional: Halo2-compatible Linux box for prove.py (macOS arm64 has SRS issues)

Installation

bash
git clone <repo> AlphaTrade
cd AlphaTrade

# Smart contracts
cd ComputeX-Contracts
forge install
forge build

# Frontend
cd ../frontend
npm install

# Backend (zkML + meta-agent)
cd ../backend
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

Deploy Locally (Anvil)

bash
# Terminal 1
cd ComputeX-Contracts && anvil

# Terminal 2
cd ComputeX-Contracts
export PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
export RPC_URL=http://127.0.0.1:8545
forge script script/Deploy.s.sol:Deploy --rpc-url $RPC_URL --broadcast
forge script script/DeployMetaAgentLocal.s.sol:DeployMetaAgentLocal --rpc-url $RPC_URL --broadcast

# Terminal 3
cd frontend && npm run dev

Anvil addresses are deterministic — they match the values pre-baked into frontend/app/lib/contracts.ts. No copy-paste needed.

Deploy to Ethereum Sepolia

Plan 1 + Plan 2 contracts are already live on Sepolia. To redeploy, fund the deployer with ~0.02 ETH on Sepolia, then:

bash
export PRIVATE_KEY=<your-key>
export RPC_URL=https://ethereum-sepolia-rpc.publicnode.com

forge script script/Deploy.s.sol:Deploy --rpc-url $RPC_URL --broadcast
forge script script/DeployMetaAgent.s.sol:DeployMetaAgent --rpc-url $RPC_URL --broadcast

The DeployMetaAgent script uses real Uniswap V3 addresses on Sepolia (SwapRouter02 = 0x3bFA4769FB09eefC5a80d6E87c3B9C650f7Ae48E). Mock USDC/WBTC/LINK/UNI are deployed inline since canonical testnet addresses don't exist.

MetaMask Setup

Guide: List & Rent a GPU

Guide: Mint & Trade Model NFT

Guide: Deploy a Meta-Agent Vault

Guide: Run the Python Runtime

bash
cd backend
source .venv/bin/activate

# Train a model and export ONNX
python -m zkml.train --job-id 0 --output /tmp/ax_train

# Run the meta-agent runtime
cat > config.json << EOF
{
  "rpc_url": "http://localhost:8545",
  "vault_addr": "<your vault address from Tab 05>",
  "operator_key": "<operator's private key>",
  "oracle_addr": "<PerformanceOracle address>",
  "model_dir": "/tmp/ax_train",
  "tick_seconds": 30,
  "score_threshold_bps": 0
}
EOF

python -m meta_agent.runtime --config config.json

Every tick_seconds, the bandit picks model NFTs, ONNX inference produces basket weights, the runtime signs and submits executeTrade.

Contract Addresses

Anvil (chain 31337) — deterministic

Ethereum Sepolia (chain 11155111) — live

Key Events

solidity
// GPUMarketplace
event GPUListed(uint256 indexed gpuId, address indexed provider, uint256 pricePerHour, string metadata);
event JobCreated(uint256 indexed jobId, address indexed renter, uint256 indexed gpuId, uint256 duration, uint256 totalCost);
event JobCompleted(uint256 indexed jobId, address indexed renter, uint256 indexed gpuId);

// ModelNFT
event ModelMinted(uint256 indexed tokenId, uint256 indexed jobId, address indexed creator, string modelCID, string proofCID);
event PerformanceScoreUpdated(uint256 indexed tokenId, uint256 score, uint256 sharpeBps);

// PerformanceOracle
event AuditAccepted(uint256 indexed tokenId, uint256 indexed epoch, uint256 sharpeBps, uint256 nTrades);

// MetaAgentVault
event Deposit(address indexed sender, address indexed owner, uint256 assets, uint256 shares);
event TradeExecuted(uint256 indexed blockNumber, uint256 navBefore);
event Harvested(uint256 nav, uint256 gain, uint256 feeShares);

Common Errors