CodeTrack

Analytics dashboard for ERC-8021 Builder Code attribution on Base mainnet, built for indie builders who want to see which transactions their apps generate.

Live Demo

codetrack-phi.vercel.app

Also available as a Farcaster Mini App.

Features

• Search any Builder Code (bc_xxxxxxxx) and view its stats, no wallet required
• Top Builder Codes leaderboard for Base mainnet
• Per-code metrics: all-time, 7-day and 30-day transaction counts, unique senders and total gas, aggregated server-side for exact numbers
• Daily transaction chart for the last 30 days and a recent transactions table with Basescan links
• Wallet connect to auto-detect codes you own, plus a demo mode with sample data

How it works

Transactions carrying an ERC-8021 calldata suffix are indexed into a Supabase Postgres database. The frontend queries pre-aggregated materialized views through Supabase RPCs (get_code_stats, get_code_daily_chart, get_top_builders), defined in sql/code_stats.sql. The UI shows the currently indexed block range so you know exactly which window the numbers cover.

Tech Stack

• Vanilla HTML/CSS/JavaScript, single file, no build step
• ethers.js v6 for wallet connection (Base mainnet, chain id 8453)
• Chart.js 4 for the daily transaction chart
• Supabase (Postgres materialized views + RPC functions) as the data layer
• Farcaster Mini App SDK for Mini App support
• Deployed as a static site on Vercel

Getting Started

git clone https://github.com/memosr/codetrack.git
cd codetrack

# no dependencies to install, serve the frontend with any static server
npx serve frontend
# or
python3 -m http.server 8080 --directory frontend

No environment variables are required. The Supabase URL and publishable (anon) key are embedded in frontend/index.html; publishable keys are safe to expose client-side.

To point the app at your own Supabase project:

1. Create a transactions table with tx_hash, from_address, gas_used, block_timestamp, block_number and a codes text array column
2. Run sql/code_stats.sql once in the Supabase SQL Editor
3. Replace the supabase client constants at the top of the script in frontend/index.html

Never put private keys or secret keys in this repo. If you add a .env file for tooling, it is already covered by .gitignore.

Limitations

• Attribution coverage is limited to the indexed block range shown in the UI
• Owned-code detection is currently based on a known wallet-to-code mapping in the frontend

License

MIT, copyright (c) 2026 memosr. See LICENSE.