BooneTools

BooneTools is the public THORChain tooling site served at boone.tools. The canonical standalone repository is:

https://github.com/erebuskaimoros/boonetools

This repo is a Svelte/Vite frontend with a small Node/Postgres backend for cached THORChain analytics. Most chain reads still use public THORChain endpoints directly or through lightweight local/prod proxy paths.

What Is In Here

• src/ - Svelte app code for the public tools.
• public/ - static assets and generated public data artifacts.
• backend/ - Node backend for cached NodeOp, Bond Tracker, and Rapid Swap data.
• scripts/ - deploy, listener, backfill, repair, and generated-data scripts.
• docs/ - operational docs plus generated research/chart artifacts.
• ops/ - Caddy, Docker, and systemd files for the production host.
• knowledge/ - repo-local session notes and protocol references.

Current Notable Tools

• Bond Tracker
• Rapid Swaps
• Treasury Tracker
• Vault Explorer
• Limit Orders
• App Layer to Base Layer dashboard at /app-layer-base-layer

The App Layer dashboard tracks Rujira App Layer fee-share flows into the THORChain Base Layer. It reads generated files under public/data/rujira-base-layer-fees/, links collector addresses and txs to thorchain.net, charts weekly and cumulative Reserve payments, and shows app-collector all-time revenue estimates from rujira-collector-revenue.json.

Local Development

npm install
npm run dev

Open:

http://127.0.0.1:5173/
http://127.0.0.1:5173/app-layer-base-layer

Run a production build:

npm run build

Run frontend tests:

npm test

Run backend tests:

npm run backend:test

Environment

Do not commit real secrets. The committed env files are examples only:

• .env.example
• backend/.env.example

Frontend production builds use these public runtime values:

VITE_NODEOP_API_BASE=https://boone.tools/functions/v1
VITE_RAPID_SWAPS_API_BASE=https://boone.tools/functions/v1
VITE_NODEOP_API_KEY=
VITE_RAPID_SWAPS_API_KEY=

Backend runtime values live in backend/.env on the server. Start from backend/.env.example and set real values there, including DATABASE_URL and PUBLIC_API_KEY.

Generated Rujira Data

Refresh observed Base Layer Reserve payments:

node scripts/rujira-base-layer-fees.mjs

Refresh app-collector all-time revenue estimates:

node scripts/rujira-collector-revenue.mjs

The collector-revenue artifact estimates all-time net collected as outbound collector distributions plus current residual collector balances, priced with current THORNode pool TOR prices. It is not historical USD-at-receipt accounting.

Deployment

The live frontend is served from:

/var/www/boone-tools/

on the production host for:

https://boone.tools/

Frontend deploy script:

npm run boonetools:deploy:frontend

Backend deploy script:

npm run boonetools:deploy:backend

After a frontend deploy, verify the built bundle still contains the expected API base:

https://boone.tools/functions/v1

Notes For Future Work

• Prefer official *.thorchain.network endpoints first.
• Keep tested non-Nine-Realms fallbacks such as Liquify gateway paths where the code already uses them.
• Avoid pushing browser traffic directly into Midgard-heavy scan paths when a cached backend route exists.
• New UI work should follow DESIGN.md, which reflects the current terminal-style BooneTools interface.