Multi-chain AI alpha, data, and strategy intelligence for Mantle and Celo.

Langclaw is a wallet-authenticated AI agent workspace for Mantle and Celo. It analyzes smart-money flow, liquidity anomalies, protocol momentum, and DEX pair history, then turns the result into source-backed alpha briefs, watchlist signals, Dune-backed strategy backtests, paper-trading orders, and on-chain proof records.

The current hackathon build is intentionally analysis-first. It does not execute live-funds trades. Strategy Lab produces backtests and deterministic paper-trade proofs so signals can be evaluated without custody or execution risk.

All public repos in this organization now include a project-level MIT LICENSE file. For the current Celo eligibility runbook, see backend/docs/CELO_ELIGIBILITY.md.

Organization: Langclaw-AI-Mantle

This workspace can be run as a monorepo with frontend/, backend/, and contracts/ as sibling folders, or as three separate clones from the organization above.

Fast path:

1. Open the deployed app, or run the local stack below.
2. Connect an EVM wallet on Mantle mainnet, chain ID 5000, or open the app inside MiniPay on Celo mainnet, chain ID 42220.
3. Open the intelligence workspace in chat and use the chain that matches your wallet or demo flow.
4. Run one of the demo prompts below.
5. Inspect the evidence, source gaps, agent decision proof, Alpha Watchlist, Strategy Lab, Proof Center, and the selected-chain usage flow.

Demo prompts:

Current research prompts focus on Mantle market analysis, while Celo is live in wallet auth, proof anchoring, MiniPay, and USDT billing.

Analyze holder flow and smart-money signals on Mantle token 0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34

Detect liquidity anomaly on Mantle pair 0xeAfc4D6d4c3391Cd4Fc10c85D2f5f972d58C0dD5

Rank Mantle protocols by TVL and yield momentum

Strategy Lab demo:

Open /strategy, select the sample Mantle DEX pair, provide a Dune query ID if the backend env does not set one, run a backtest, then open a paper trade from the latest signal.

Live decision proof examples:

Each LangclawRegistry decision stores the ERC-8004 agentId, Langclaw runId, deterministic decisionHash, evidence URI, signal type, recorder wallet, and block timestamp.

• All three live Celo contracts are deployed and source-verified on Celoscan: LangclawRegistry, LangclawTradingJournal, and the USDT-backed LangclawUsageVault.
• The live Celo usage vault address is 0x837a2948586de4e7638c742f99e520ffc049bcf7 and its deposit token is USDT at 0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e.
• The Celo ERC-8004 agent is already registered as agent ID 9109, backed by the same dedicated agent wallet used for on-chain proof and journal activity.
• The remaining Celo eligibility blocker is Self Agent ID registration and its proof flow completion. See the runbook in backend/docs/CELO_ELIGIBILITY.md.

Provider failures are shown as source gaps instead of hidden. The UI separates usable evidence from missing or unconfigured data sources.

Backend:

cd backend
cp .env.example .env
npm install
npm run dev

Frontend:

cd frontend
cp .env.example .env.local
pnpm install
pnpm dev

Contracts:

cd contracts
git submodule update --init
forge build
forge test

Smoke check:

curl http://localhost:3001/health
# {"ok":true,"service":"langclaw-backend"}

Open http://localhost:3000, connect a wallet, and sign the Langclaw login message.

Core backend variables:

OPENAI_API_KEY=
OPENAI_CHAT_MODEL=gpt-5-mini
OPENAI_AGENT_MODEL=gpt-5.2
SUPABASE_URL=
SUPABASE_SERVICE_ROLE_KEY=
LANGCLAW_API_KEY_PEPPER=
CORS_ORIGIN=http://localhost:3000

Current chain proof and data variables:

MANTLE_CHAIN_RPC_URL=https://rpc.mantle.xyz
MANTLE_CHAIN_ID=5000
MANTLE_ERC8004_AGENT_ID=94
MANTLE_LANGCLAW_REGISTRY_ADDRESS=0xe69755e4249c4978c39fbe847ca9674ce7af3505
MANTLE_LANGCLAW_USAGE_VAULT_ADDRESS=0x7e93Ef361e7b54297cF963977bA829E47E59e8E1
MANTLE_LANGCLAW_TRADING_JOURNAL_ADDRESS=0xe96e9b76af8c8f32bfa2235d647186826d92fb7d
MANTLE_TRADING_JOURNAL_ENABLED=true
CELO_CHAIN_RPC_URL=https://forno.celo.org
CELO_CHAIN_ID=42220
CELO_ERC8004_AGENT_ID=9109
CELO_LANGCLAW_REGISTRY_ADDRESS=0xe69755e4249c4978c39fbe847ca9674ce7af3505
CELO_LANGCLAW_USAGE_VAULT_ADDRESS=0x837a2948586de4e7638c742f99e520ffc049bcf7
CELO_LANGCLAW_TRADING_JOURNAL_ADDRESS=0x69984c20176704685236fd633192d7de1c13a5ec
CELO_TRADING_JOURNAL_ENABLED=true
DUNE_API_KEY=
DUNE_DEFAULT_QUERY_ID=
DUNE_STRATEGY_QUERY_ID=
ALCHEMY_API_KEY=
ETHERSCAN_API_KEY=
GOPLUS_API_KEY=
GOPLUS_API_SECRET=

Frontend variable:

NEXT_PUBLIC_LANGCLAW_API_URL=http://localhost:3001

See the repo env templates for the full list:

• backend/.env.example
• frontend/.env.example
• contracts/.env.example

User -> Frontend (:3000) -> Backend API (:3001)
                              |-> Supabase: sessions, memory, API keys, usage ledger, watchlist
                              |-> OpenClaw: planner, scorer, evidence, verifier
                              |-> OpenAI Responses: chat and synthesis
                              |-> On-chain data providers: Dune, DEX Screener, DeFiLlama, Alchemy, Etherscan, GoPlus
                              |-> LangclawRegistry: agent decision proof
                              |-> LangclawTradingJournal: strategy and paper-trade proof
                              |-> LangclawUsageVault: optional MNT billing on Mantle and USDT billing on Celo

Backend base URL defaults to http://localhost:3001.

Full shapes: API_REFERENCE.md.

Deploy examples and contract details: contracts README.

cd backend
npm run typecheck
npm test

cd frontend
pnpm typecheck
pnpm build

cd contracts
forge build
forge test

• Keep provider keys, Supabase service role keys, API key pepper, and private keys on the backend only.
• API keys are stored as HMAC hashes using LANGCLAW_API_KEY_PEPPER.
• Use a dedicated recorder wallet for proof writes.
• Use a multisig owner for production contract ownership.
• Never commit .env files.

• GitHub: https://github.com/Langclaw-AI-Mantle
• Mantle: https://www.mantle.xyz/
• Mantle docs: https://docs.mantle.xyz/

TBD