Skip to content

Hook checks

Nine signed safety checks for any deployed Uniswap v4 hook, what each one means, and how to verify a result.

A hook check reads a deployed hook from the chain at one block and runs nine fixed checks on it. It is free, needs no key or Foundry, and gives the same result for anyone who runs it at the same block. Run one at probecli.com/hooks or from the CLI.

shellCheck a hook
npm install -g @probecli/cli
probe check 0xYourHook                 # at the latest block
probe check 0xYourHook --block 118485512
probe check 0xYourHook --publish       # the verifier reruns, signs and publishes it

The nine checks#

Code
There is contract code at the address. For a proxy, the checks below read the implementation.
Flags
The callback flags encoded in the address are a combination the PoolManager accepts. A return-delta flag needs its base callback.
Callbacks
Every callback the flags turn on exists in the code. A missing one makes every pool action that calls it revert.
PoolManager
poolManager() returns the Uniswap v4 PoolManager on this chain.
Callers
Each enabled callback is called from an outside address with a real pool's key and must revert. The same call from the PoolManager is tried for comparison.
Upgrades
The hook is not an upgradeable proxy, so its behaviour cannot change after the check.
Owner
Ownership is absent or renounced. A single key is a warning; a contract owner, often a multisig, is shown for you to check.
Opcodes
Neither SELFDESTRUCT nor DELEGATECALL appears in the code that runs.
Source
Sourcify has a matching source, so anyone can read what the hook does.

Reading a result#

Each check passes, warns or fails. A warning is a property worth knowing about, not a bug: many good hooks are upgradeable or use DELEGATECALL on purpose. A failure is a concrete problem at that block. Information rows, like a contract owner, are not scored. The headline counts scored checks only.

Verifying a published result#

The verifier signs an EIP-191 message naming the chain, hook, block and a digest of every result. Each report page shows the message and signature. Recover the signer with any Ethereum library and compare it with the verifier address on Contracts, or rerun the checks at the same block.

tsRecover the signer
import { recoverMessageAddress } from "viem";

const r = await fetch("https://verifier.probecli.com/hooks/0xYourHook").then((x) => x.json());
const signer = await recoverMessageAddress({ message: r.message, signature: r.signature });
// signer === r.signer === the verifier address

Badge#

Every checked hook has a badge that shows its latest result and links to its report. Copy the Markdown from the report page into your README.