Prerequisites
- Node.js 20 or newer
- npm 10 or newer
- A terminal at the ChainLens repository root
The app can run without
HELIUS_API_KEY or ALCHEMY_API_KEY. Without those keys, ChainLens uses public RPC endpoints for real on-chain events and falls back to mock data only when real sources are unavailable.Install and run
1
Install dependencies
Run the workspace install from the repository root.
2
Create an optional environment file
Copy the example file if you want to set provider keys, RPC overrides, CORS, or rate-limit settings.
3
Start both apps
Start the Fastify API and the Vite web app together.
4
Open the dashboard
Visit
http://localhost:5173, choose a chain, and paste a pool address. You can also use the sample pair chips in the UI.Run services separately
First pair workflow
1
Select a chain
Pick Solana, Ethereum, Base, Arbitrum, or BNB Chain.
2
Paste a pool or token address
ChainLens validates Solana base58 addresses and EVM
0x addresses. If you paste a token address, ChainLens attempts to resolve the highest-liquidity pool for that token on the selected chain.3
Choose a time window
Use a preset window from
5m through 7d, or choose a custom range. Custom ranges support second-level precision and are capped at 7 days.4
Filter the tape
Filter by buy, sell, LP add, LP remove, minimum USD value, sort order, or wallet address.
5
Use the leaderboards
Click a Top Buyer, Top Seller, or Top LP row to filter the tape to that wallet. Click again or clear the wallet filter to return to all events.