noir-idioms

These guidelines help you write Noir programs that are readable, idiomatic, and produce efficient circuits.

Computing a value is often more expensive in a circuit than verifying a claimed value is correct. Use unconstrained functions to compute results off-circuit, then verify them with cheap constraints.

Note that the compiler already injects unconstrained helpers for some operations automatically (e.g., integer division). Don't hint what the compiler already optimizes — focus on higher-level computations like sorting, searching, and array construction where the compiler cannot automatically apply this pattern.

Guidelines for writing idiomatic, efficient Noir programs. Use when writing or reviewing Noir code. Source: noir-lang/noir.