Documentation
Start here
What censoredHooks is, how a scan reads a hook, how to read a report, and the words it uses.
- What censoredHooks isA scanner that reads any Uniswap v4 hook on Robinhood Chain from the chain itself, with or without its source, and says what it does to your swap and your liquidity.
- How a scan worksFrom an address to a verdict, step by step. Every step is a read against the chain; nothing is sent, signed or paid.
- Reading a reportWhat each part of a hook's page at /hook/<address> says, and which numbers to look at first.
- GlossaryThe words the reports and these docs use, in alphabetical order.
Hooks
Uniswap v4 hooks and each part of a scan: the permission bits, the probe, the eight checks, the score and verdict, and the limits.
- Uniswap v4 hooks in one pageThe PoolManager, the pool key, the callbacks and the deltas: just enough of v4 to read a hook report.
- The permission bitsThe fourteen bits at the end of every hook address, what each one lets a hook do, and how to read them yourself.
- The probeHow censoredHooks swaps through a hook's real pool, and adds and removes liquidity, without a transaction, without tokens, and with an exact answer.
- The eight checksWhat each check reads or measures, the exact thresholds, and its weight in the score.
- Score and verdictHow the eight checks become a number from 0 to 100 and a word, and why the two can disagree.
- LimitsWhat a scan does not see, cannot promise, and sometimes gets wrong. Read this before you rely on a verdict.
Developers
The scan API, wiring it into a bot or an AI agent, and building a hook that passes the checks.
- The scan APIGET /api/scan?hook=0x… returns the full scan of one hook as JSON. Every field, its units, and how to read it.
- Scan a repositoryPaste a GitHub repository in the app to read the hooks in its source, before you trust the deployment.
- Using it in a bot or an agentCall the scan before routing through a v4 pool, turn it into a yes or no in code, and give an AI agent the evidence rather than the decision.
- For hook buildersWhat the market will see when it scans your hook, and how to build one that passes each check without publishing anything you do not want to.
Tutorials
Step by step: checking a pool before you swap, and reading the board of every hook.
The whitepaper
The whole design in one document: the problem with audits, the seal, the eight checks, the proof, the review, the stake and the claims, the privacy line, the economics, the road from signed checks to a zkVM and an on-chain registry.
Read it