← All insights
RELEASEZcash Foundation

Zebra 5.0.0: emergency soft fork and NU6.2

In response to the Orchard circuit flaw, 4.5.3 implemented a soft fork that temporarily disables Orchard, and 5.0.0 implemented NU6.2, which restores Orchard with the fixed circuit.

The Zcash Foundation released Zebra 4.5.3 and 5.0.0 in response to a critical bug in the Orchard Action circuit. 4.5.3 implemented an emergency soft fork that temporarily disables Orchard actions while a fix was prepared, and 5.0.0 activates NU6.2, which turns Orchard back on with the fixed circuit. The Foundation strongly recommends upgrading to 5.0.0 as soon as possible, or to 4.5.3 if that is hard before the NU6.2 activation height.

On Friday, May 29, Taylor Hornby, an independent security researcher who had been doing protocol audits for Shielded Labs, found a critical soundness vulnerability in the Orchard zero-knowledge proof circuit and responsibly told a core ZODL engineer that evening. ZODL engineers confirmed the problem within hours and prepared a coordinated upgrade while keeping the details private. Private coordination with miners and exchanges began on the evening of May 31, and after the first soft fork attempt ran into deployment difficulties, a second patch targeting height 3,363,426 activated around 02:00 UTC on June 2.

At 00:05 EDT on June 3, the NU6.2 hard fork activated and Orchard was turned back on with the fixed circuit. This is the second security-motivated protocol upgrade since Zcash launched. There were no known exploits and no evidence of illicit value creation. The turnstile that tracks total ZEC balances confirmed that the supply is intact, and user privacy was not affected. Sapling and transparent transactions worked normally throughout.

The bug was a soundness flaw in the Orchard circuit implementation in the halo2_gadgets crate. If exploited, the Orchard pool could have accepted invalid state transitions and double spending inside Orchard might have been possible, but the turnstile means total supply could not be inflated. The affected scope is halo2_gadgets below 0.5.0, orchard below 0.14.0, zcash_primitives below 0.28.0, zcashd v5.0.0 through v6.12.3, and zebrad below 4.5.1. A direct patch might reveal too much about the nature of the flaw, so it chose to disable Orchard first.

NU6.2 activates at Mainnet height 3,364,600 and Testnet height 4,052,000. Fixing a proof circuit bug requires changing the fixed verification key, so a node patch alone was not enough and a hard fork was needed. 5.0.0 also adds a consensus rule rejecting Orchard proofs of non-standard size. If the activation height has passed and a node followed the fork, it must sync from scratch or from a pre-activation backup. The Foundation thanked Taylor Hornby, Shielded Labs, ZODL engineers, Arya Solhi and the ecosystem participants who adopted it quickly.

This summary is based on the original; check the original for exact details.