Mantle-first AI alpha, data, and strategy intelligence.

Langclaw is a wallet-authenticated AI agent workspace for Mantle. 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.

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.
3. Select Research mode in chat (legacy onchain is aliased to Research).
4. Run one of the demo prompts below.
5. Inspect the evidence, source gaps, agent decision proof, Alpha Watchlist, Strategy Lab, and Proof Center.

Demo prompts:

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.

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

Mantle proof and data variables:

MANTLE_CHAIN_RPC_URL=https://rpc.mantle.xyz
MANTLE_CHAIN_ID=5000
MANTLE_PRIVATE_KEY=
MANTLE_ERC8004_AGENT_ID=94
LANGCLAW_REGISTRY_ADDRESS=0xe69755e4249c4978c39fbe847ca9674ce7af3505
LANGCLAW_USAGE_VAULT_ADDRESS=0x7e93Ef361e7b54297cF963977bA829E47E59e8E1
MANTLE_LANGCLAW_TRADING_JOURNAL_ADDRESS=0xe96e9b76af8c8f32bfa2235d647186826d92fb7d
MANTLE_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
                              |-> Research workflow:
                              |     runtime probe -> planner -> discovery (TS)
                              |     -> source normalizer (TS) -> trend scorer -> evidence -> verifier
                              |     -> on-chain enrichment (TS) -> final conclusion
                              |     -> evidence bundle -> LangclawRegistry proof
                              |-> OpenClaw: planner, trend scorer, evidence, verifier, final conclusion
                              |-> OpenAI Responses: direct chat and synthesis fallback
                              |-> Mantle providers: Surf, Elfa, Nansen, Dune, DEX Screener, DeFiLlama, Alchemy, Etherscan, GoPlus
                              |-> LangclawRegistry / LangclawTradingJournal / LangclawUsageVault

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