Transaction Analysis Agent (EVM)

A TypeScript + LangGraph project that fetches on-chain transaction data (RPC / Tenderly / Etherscan) and generates a natural-language explanation using an LLM.

Setup

pnpm install
cp .env.example .env

Minimum required in .env:

# LLM
LLM_PROVIDER=openrouter   # or: anthropic
OPENROUTER_API_KEY=...    # or: ANTHROPIC_API_KEY=...
LLM_MODEL=anthropic/claude-3.5-sonnet

# RPC
ETHEREUM_RPC_URL=https://eth.llamarpc.com
CHAIN_ID=1

Optional (recommended):

# Better traces (historical debug_traceTransaction via Tenderly RPC)
TENDERLY_RPC_URL=https://mainnet.gateway.tenderly.co/YOUR_KEY
USE_TENDERLY_SIMULATION=true

# Contract ABI / source (when available)
ETHERSCAN_API_KEY=YOUR_KEY

If you need a proxy, run via:

./run-with-proxy.sh pnpm exec tsx src/cli.ts 0xYOUR_TX_HASH

Run

CLI

pnpm exec tsx src/cli.ts 0xYOUR_TX_HASH

Chat API (for frontend)

pnpm run server

• POST /api/chat — body: { "conversationId"?: string, "message": string }. Response: SSE stream.
• Rule-based: if message contains a tx hash (0x + 64 hex), the backend runs the analysis pipeline and streams progress events (rpc_done, etherscan_start, etherscan_done, tenderly_start, tenderly_done, draft_start, draft_done, done), then message_end with { content, report }.
• First event: session with { conversationId }. If no tx hash, reply is: "Send a transaction hash (0x...) to analyze it."

License

MIT (see LICENSE).