Hypurr Harbor โ๐ฑ
A retro pixel-art harbor where the Hyperliquid blockchain plays out in real time. Every pending transaction is a little cat waiting on the pier. Every block is a boat. When a block confirms, the cats whose transactions made it in hop aboard and sail away. Nothing is replayed or delayed: boats arrive at true HyperBFT cadence, several per second.

Built on a single Quicknode Hyperliquid endpoint. One URL covers the gRPC streams, the info API, and the hypercore JSON-RPC used here.
๐ What you're looking at
- ๐ชต The pier is the mempool. Each kitty is a live pending transaction, and its coat, markings, and name are derived deterministically from the tx hash, so the same tx always produces the same cat.
- โต Boats are finalized blocks. A cat only boards the boat whose block actually contains its transaction.
- ๐ Golden kitties are orders paying a priority fee (
grouping: {"p": N}). Hi-vis kitties are cancels, which consensus lets board before every taker.
- ๐ Cat size tracks order type: tiny cancels, hefty transfers, huge whales.
- ๐ซ Boarding order mirrors real consensus ordering: account actions, then cancels and post-only orders, then priority fees by bps, then everyone else.
- ๐ง Transactions that never confirm slip through the planks into the water.
- ๐งถ Hover a cat to pet it (hearts, purring). Click anything to pin a live info card that keeps updating as the tx confirms. The cursor is a ball of yarn, because of course it is.
- ๐ผ The bay gate announces each block on its LED screen. The lighthouse beacon sweeps green while the stream is healthy and turns red during reconnects.
There are a few easter eggs. The Konami code is one of them. Typing a certain four letter word cats say is another.
๐ง How it works
Quicknode Hyperliquid endpoint
โ
โโ gRPC :10000 MEMPOOL_TXS + BLOCKS streams
โโ /info coin names โ asset id filters
โโ /hypercore hl_getBlock anchors rounds to block heights
โ
โผ
server/index.js (Node relay, ~500 lines)
โ WebSocket, one compact JSON message per event
โผ
Vite + TypeScript frontend, PixiJS v8 harbor engine
The relay subscribes to two gRPC streams: MEMPOOL_TXS for pending transactions and BLOCKS for confirmations. It rebroadcasts them to browsers over a WebSocket with no batching, so on-screen timing is on-chain timing.
A few details that took real effort to get right:
Rounds vs heights. The raw BLOCKS stream numbers blocks by HyperBFT consensus round, which is not the block height you see on explorers. The relay calls hl_getLatestBlockNumber and hl_getBlock on the endpoint's /hypercore path, matches block timestamps against the live stream, and from that one anchor derives the exact height of every boat. Hulls show ยท ยท ยท until the anchor lands (usually under a second), then every boat gets its real height, retroactively.
Coin filtering. Raw mempool actions carry numeric asset ids, not coin names. The relay fetches meta and spotMeta from the endpoint's /info path to translate names like BTC into ids, then applies them as server-side stream filters so the firehose never leaves Quicknode.
Credit politeness. Upstream gRPC streams only run while someone is watching. The first browser to connect starts them; thirty seconds after the last one leaves, they stop. Per-stream watchdogs resubscribe if a stream goes quiet.
No cat left behind. The animation engine guarantees a cat never vanishes mid-air. Hops only start if the landing is reachable, boats with cats aboard are never rushed off-screen, and every cat ends its story on a deck, in a sparkle, or with a splash.
Rendering is PixiJS v8 (WebGPU with WebGL fallback) drawing into a small logical backbuffer that scales with your window's aspect ratio, supersampled 3x for crisp pixels. Every sprite is drawn procedurally and texture-cached; there are no image assets except one sound. Text lives on a separate canvas layer so labels stay sharp at any zoom.
๐ Run it locally
You need Node 20 or newer.
git clone https://github.com/quicknode/HYPURR-HARBOR.git
cd HYPURR-HARBOR
npm install
npm run dev # โ http://localhost:5173
With no credentials the harbor runs in demo mode, generating synthetic traffic at realistic cadence so you can see everything working immediately.
๐ก Going live
- Create a Quicknode Hyperliquid endpoint.
- Copy
.env.example to .env and fill it in:
QN_GRPC_URL=your-endpoint.hype-mainnet.quiknode.pro:10000
QN_GRPC_TOKEN=your-token
QN_HTTP_URL=https://your-endpoint.hype-mainnet.quiknode.pro/YOUR_TOKEN
QN_FILTER_COINS=BTC,ETH
BOATS=all
- Restart
npm run dev. The badge flips from DEMO to MAINNET.
| Variable |
What it does |
QN_GRPC_URL |
Endpoint host with :10000, where the gRPC streams live |
QN_GRPC_TOKEN |
Endpoint token. Leave empty for demo mode |
QN_HTTP_URL |
Full HTTP URL of the same endpoint, used for /info and /hypercore |
QN_FILTER_COINS |
Comma separated coins to filter the mempool. Empty means everything |
BOATS |
all gives every block a boat, relevant only blocks touching your coins |
PORT |
Relay port, defaults to 8787 |
HOST |
Bind address. Set 127.0.0.1 when the relay sits behind a reverse proxy |
A word of warning: the unfiltered mempool is a firehose. QN_FILTER_COINS=BTC,ETH keeps the pier lively without melting it.
๐ฆ Production build
npm run build # type-check + bundle to dist/
npm start # serves dist/ and the WebSocket relay on :8787
๐ข Deploying
Anything that runs npm start can host the whole app as a single process: Railway, Render, Fly.io, a VPS. Static-only platforms like Vercel cannot run it alone, because the relay has to stay alive to hold its gRPC streams open.
You can also split it: the static frontend on Vercel or any CDN, the relay on a small server behind a reverse proxy. Build the frontend with VITE_WS_URL=wss://your-relay-host/ws so it knows where to dial, and set HOST=127.0.0.1 on the relay so only the proxy can reach it. With Caddy the proxy config is one block:
relay.example.com {
reverse_proxy 127.0.0.1:8787
}
๐ Sounds
All audio is synthesized in the browser (a generative synthwave radio included), except the meow, which is a real cat recorded by a Wikimedia contributor: Meow.ogg, licensed CC BY-SA 3.0, pitched per kitty. Click anywhere once to enable audio, toggle it with the ๐ chip.
License
MIT, see LICENSE.