████████╗██████╗ █████╗ ██████╗███████╗
╚══██╔══╝██╔══██╗██╔══██╗██╔════╝██╔════╝
██║ ██████╔╝███████║██║ █████╗
██║ ██╔══██╗██╔══██║██║ ██╔══╝
██║ ██║ ██║██║ ██║╚██████╗███████╗
╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝╚══════╝
fake agents have no pulse.
scan every agent deployment · classify autonomous / hybrid / human · publish onchain attestations · funded by uniswap v4 hook fees
trace protocol — onchain registry of agent classifications, written by a uniswap v4 hook that fingerprints every swap caller on base and ethereum. one hook, two chains. the chain is the source of truth — contracts and frontends read the verdict from a single onchain call.
four layers compose the stack:
- v4 hook —
beforeSwapfingerprints the caller against gas cadence, nonce drift, signer entropy, mempool timing. 1% of pool fee routes into the scanner endpoint. fee becomes forensics. - scanner — viem-based event listener, indexes the attestation contract feed across base + ethereum
- classifier — feature extraction + onnx inference + temperature-scaled confidence, capped at 0.95
- on-chain registry — solidity contract, rotatable attester key, custom errors. attestations land on base, mirrored to ethereum via L1 message proofs
every project that ships an "ai agent" puts a wallet onchain and calls it autonomous. most are scripts with an llm sticker. 97% of self-claimed agents on ethereum are humans pretending.
trace separates real agents from packaging by reading their actual behavior — tx frequency entropy, response latency, instruction diversity, decision variance, time-of-day patterns — not their marketing. signatures cannot be faked at scale. the chain does not lie.
| repo | what it is | status |
|---|---|---|
| trace-protocol | scanner + classifier + verdict engine + v4 hook + onchain registry | 🟢 v0.4.2 |
| trace-protocol-site | landing at traceprotocol.tech (next 16 + tailwind v4) | 🟢 live |
solidity 0.8.24 · foundry · openzeppelin · uniswap v4-core · typescript · viem · wagmi · onnx-runtime · pino · vitest · pnpm workspaces · python · prometheus · base + ethereum
- v0.4.2 shipped — base support live · v4 hook beforeSwap + fee routing · attestation mirroring base → ethereum
- v4 hook open source:
contracts/trace-hook - attestation registry live:
contracts/trace-attestation - arbitrum + optimism on the v0.5.x track