Skip to content

Hoon Kernels

vesl's logic lives in Hoon kernels. These get compiled to Nock (via hoonc) and loaded by the Hull at runtime. For most developers, the kernels ship pre-compiled — you don't need to touch Hoon.

Kernels

vesl ships four kernels — each a progressively lighter slice of the protocol:

KernelFileWhat it does
veslvesl-kernel.hoonFull: settlement, STARK proving, and tx-engine
beakbeak-kernel.hoonSettlement + verification, no STARK proving
gripgrip-kernel.hoonCommitment + verification, no settlement
inkink-kernel.hoonCommitment only — just hashing and root registration

Supporting libraries:

  • vesl-logic.hoon — pure verification gates (Merkle, manifest, settlement)
  • vesl-prover.hoon — STARK proof generation
  • vesl-verifier.hoon — STARK verification

Compilation

If you're working on the kernels themselves:

bash
hoonc --new protocol/lib/vesl-kernel.hoon hoon/

The --new flag forces a fresh compile (hoonc caches aggressively). Compiled kernels are output as .jam files in assets/.

~

~