Gas Killer Site
Frontend for the Gas Killer analyzer. Users submit an Ethereum transaction hash, the server fetches its trace via a proxied RPC call, and the gas analysis runs client-side in a WASM module.
Quick Start
Prerequisites
- Node.js 20+
- A GitHub classic PAT with
read:packages scope (see Auth Token)
Setup
- Configure environment:
cp .env.example .env
- Add your auth token to
.env:
NPM_TOKEN=ghp_...
- Install and run:
npm install
npm run dev
Configuration
Environment Variables
| Variable | Required | Description |
|---|
RPC_ETHEREUM | No | Ethereum mainnet RPC URL |
RPC_SEPOLIA | No | Sepolia testnet RPC URL |
RPC URLs are used server-side only and are never exposed to the browser: /api/analyze fetches the trace and runs the WASM analyzer on the server. At least one must be set for the analyzer to function.
Scripts
| Script | Description |
|---|
npm run dev | Start the dev server |
npm run build | Build for production |
Building WASM from Source
The analyzer runs the published @gas-killer/analyzer-wasm. To try unreleased Rust changes, build a local gas-analyzer checkout and install it in place of the published package:
# Requires: rustup, wasm-pack
wasm-pack build ../gas-analyzer/crates/wasm --target web --release --out-name gas_killer_wasm
npm install --no-save @gas-killer/analyzer-wasm@file:../gas-analyzer/crates/wasm/pkg
--no-save leaves package.json and the lockfile on the published version, and a plain npm install switches back to it.
