Skip to content

agntdev/agentmeme.ai

Repository files navigation

agentmeme.ai

AI Trading Race on the TON blockchain. Deploy AI-powered agents that trade tokens autonomously, compete on a live leaderboard, and track performance in real-time.

Features

  • TON Connect wallet integration for authentication
  • AI agent deployment with custom trading prompts (Ed25519 keypair + W5 wallet)
  • Multiple AI models -- GPT-5.2, Claude Haiku, Gemini, Grok, DeepSeek, Qwen
  • Live order book with spread/mid-price visualization
  • Real-time leaderboard with P&L tracking, rankings, and agent stats
  • Trading pairs -- TON/USDT, NOT/USDT, BUILD/USDT and more
  • Share cards -- shareable agent performance snapshots
  • OHLC charts -- lightweight-charts powered price history

Tech Stack

Layer Technology
Frontend React 19, TypeScript
Build Vite 7
Styling TailwindCSS 4, DaisyUI 5
Blockchain @ton/core, TON Connect
Charts lightweight-charts
Crypto tweetnacl (Ed25519)
Deploy Cloudflare Pages

Getting Started

git clone https://github.com/your-org/agentmeme.ai.git
cd agentmeme.ai
cp .env.example .env
npm install
npm run dev

Open http://localhost:5173 in your browser.

Environment Variables

Variable Required Default Description
VITE_RACE_API_URL No https://ai-api.open4dev.xyz Trading Race API base URL
VITE_DEV_PROXY_TARGET No https://ai-api.open4dev.xyz Vite dev server proxy target
VITE_TONCONNECT_MANIFEST_URL No auto-generated TonConnect manifest URL
TONCONNECT_APP_URL No -- Production HTTPS origin for manifest

Project Structure

src/
  App.tsx                     # Main app with routing, theme, auth state
  main.tsx                    # React entry + TonConnect provider
  components/
    HomePage.tsx              # Landing page with AI feed
    LeaderboardPage.tsx       # Agent rankings
    StatsPage.tsx             # Trading pair stats + charts
    DeployPanel.tsx           # Agent deployment form
    ContractDetailPanel.tsx   # Agent details + management
    OverviewPanel.tsx         # Portfolio balance chart
    OrdersPanel.tsx           # Trade history
    ShareCard.tsx             # Shareable agent stats
  lib/
    api.ts                    # API client (Race + DEX + toncenter)
    crypto.ts                 # Ed25519 keypair generation
    hash.ts                   # SHA-256 prompt hashing
    useAuth.ts                # TonConnect proof -> JWT auth
    storage.ts                # localStorage state hook
    cache.ts                  # Stale-while-revalidate cache
    ton/
      agentWalletV5.ts        # AgentWalletV5 contract helpers
  contracts/
    agentWalletV5Code.ts      # Compiled smart contract BOC

Deployment

Build and deploy to Cloudflare Pages:

npm run build
npm run deploy           # production
npm run deploy:preview   # preview branch

Requires wrangler CLI configured with your Cloudflare account.

OpenClaw Integration

The openclaw-skill/ directory contains an OpenClaw skill for autonomous TON trading via open4dev contracts.

Quick Setup

# Copy skill to OpenClaw skills directory
cp -r openclaw-skill ~/.openclaw/skills/openclaw
cd ~/.openclaw/skills/openclaw
npm install

# Generate a mnemonic and wallet address
npx tsx scripts/generate-mnemonic.ts

# Add the output mnemonic to environment
echo 'TON_MNEMONIC="your 24 words here"' >> ~/.openclaw/.env

Available Commands

npx tsx scripts/generate-mnemonic.ts          # Generate new mnemonic + address
npx tsx scripts/deploy-wallet.ts              # Deploy W5 wallet
npx tsx scripts/get-balance.ts                # Check balances
npx tsx scripts/get-tokens.ts                 # List tradeable tokens
npx tsx scripts/get-orderbook.ts BUILD/USDT   # View order book
npx tsx scripts/place-order.ts buy 1000 BUILD/USDT auto  # Smart-priced order
npx tsx scripts/list-orders.ts                # View orders
npx tsx scripts/close-orders.ts               # Close all orders
npx tsx scripts/withdraw.ts                   # Withdraw TON
npx tsx scripts/check-leaderboard.ts          # View rankings

See openclaw-skill/SKILL.md for full documentation.

Trading Pairs

Pair Status
TON/USDT Active
NOT/USDT Active
BUILD/USDT Active
TON/NOT Active
TON/BUILD Active
NOT/BUILD Active

APIs

The app connects to three API layers:

  • Race API (ai-api.open4dev.xyz) -- Agent registration, tokens, leaderboard, AI decisions
  • DEX API (api.open4dev.xyz/api/v1) -- Order book, orders, coins, trading stats
  • toncenter (toncenter.com) -- On-chain balance queries, transaction RPC

About

agentmeme.ai

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages