Docs Hub

Hypurrliquid Research, Protocol, and Build Docs

This is the compiled entrypoint for the repo's knowledge system: public paper, protocol notes, generated findings, and status tracking. The long-term model is sources -> claims -> docs -> code -> verification.

Paper

Public-facing reverse-engineering reference with diagrams, formulas, and subsystem overviews.

docs/paper/index.html

Liquidation & ADL

Dedicated execution reference for perp liquidation, portfolio margin, BOLE, and auto-deleveraging.

docs/liquidation/index.html

Block Lifecycle

Whole-block execution reference covering topology, leader rotation, hook points, hashing, and VoteAppHash.

docs/block-lifecycle/index.html

Hashing

Dedicated reference for RespHash, LtHash, backend splits, concise hashes, and VoteAppHash surfaces.

docs/hashing/index.html

Staking & Validators

Validator lifecycle, epochs, jailing, signer gates, delegation, and control-plane boundaries.

docs/staking/index.html

Bridge2

Bridge withdrawal, finalization, validator-set update flow, signer reuse, and dispute-period trust model.

docs/bridge/index.html

Outcomes

HIP-4 baseline market model, settlement lifecycle, question metadata, and the open solvency lane.

docs/outcomes/index.html

Call Graphs

Rendered subsystem call graphs and architecture relationships.

docs/call-graphs.html

White Paper

Narrative system-design paper covering architecture, product families, universes, risk modes, and solvency goals, with downloadable PDF and TeX.

docs/whitepaper/index.html + docs/latex/whitepaper.pdf

Yellow Paper

Protocol-truth paper covering action surfaces, state layout, block lifecycle, routing, liquidation, and hashing boundaries, with downloadable PDF and TeX.

docs/yellowpaper/index.html + docs/latex/yellowpaper.pdf + docs/latex/yellowpaper.tex

Findings

Curated fact ledger and compiled claim surfaces for the strongest current reverse-engineering takeaways.

docs/findings/truth-register.html

Status

Open claims and active truth-maintenance lanes for implementation, replay, and protocol closure.

docs/status/open-claims.html

Paper Set

The site now has three complementary paper surfaces instead of one monolith. Read them in layers depending on what you need.

White Paper for architecture, design intent, risk model, and system decomposition.
Yellow Paper for protocol truth, execution order, state layout, and implementation boundaries.
Action Inventory for action families, signing surfaces, and binary-discovered sub-variants.
Hypurrliquid Paper for the large reverse-engineering reference with diagrams, tables, and subsystem deep dives.
Hashing, Staking, Bridge2, and Outcomes for the denser subsystem references split out of the monolith.

Knowledge Layout

The repo is moving toward a structured knowledge compiler. Humans consume the docs, while agents maintain the structured source layer under knowledge/.