Rails

The web app behind rails.finance: position explorers for DeFi lending protocols, with every figure re-derived from the chain and a transaction timeline that says what happened, event by event.

What it covers

Twenty-six explorers across Ethereum, Base and Sepolia. On Ethereum: Aave V3, Aave V4, Asymmetry, Compound V2, Compound V3, Dolomite, Ebisu, Fluid, Frankencoin, f(x), Liquity V1, Liquity V2, LlamaLend, MakerDAO, Maple, Moonwell, Morpho Blue, PWN and Spark. On Base: Aave V3, Basedollar, Compound V3, Moonwell, Morpho Blue and Seamless. On Sepolia: Polaris. The roster is lib/shared/protocols.ts; what each explorer can state, and what it cannot yet, is the coverage matrix at /coverage, driven by lib/shared/coverage.ts.

Every explorer has a listing, a position page and a timeline. A position page shows chain-state balances and health beside the indexed history, prices each event at its own block where the protocol's oracle allows it, and exports the position as Markdown or CSV for pasting into an LLM. Where a figure cannot be stated from chain, the page says so rather than estimating.

How it is built

Next.js App Router, TypeScript, Tailwind. Server-side route handlers talk to a bearer-authenticated indexing backend (RAILS_API_URL) and, for live chain state, to an Ethereum and a Base RPC. No key reaches the browser. .env.example documents every variable the app and its scripts read.

pnpm install
cp .env.example .env.local   # fill in the runtime keys
pnpm dev
pnpm check                   # routes, locale, OG cards, dead code, types

scripts/verify-*-chain.mjs re-derive an explorer's figures from the protocol's own contracts and check them against what the site serves; scripts/verify/run-all.mjs runs the page-level verifiers against a running dev server.

Status

Rails is in beta. Explorers whose coverage cells are still open say so on /coverage.

License

MIT — see LICENSE. Third-party images and one transcribed icon are listed in ATTRIBUTION.md and are not covered by it.