Skip to content

Ironwood ZIPs#135

Draft
vivek-arte wants to merge 19 commits into
QED-it:mainfrom
daira:ironwood-zips
Draft

Ironwood ZIPs#135
vivek-arte wants to merge 19 commits into
QED-it:mainfrom
daira:ironwood-zips

Conversation

@vivek-arte

Copy link
Copy Markdown

A local copy of zcash#1301 for rendering and viewability.

dependabot Bot and others added 11 commits June 2, 2026 21:31
Bumps [actions/checkout](https://github.com/actions/checkout) from 6.0.2 to 6.0.3.
- [Release notes](https://github.com/actions/checkout/releases)
- [Commits](actions/checkout@v6.0.2...v6.0.3)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: 6.0.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
[Protocol spec] Fix minor rendering issues
…tions/checkout-6.0.3

Bump actions/checkout from 6.0.2 to 6.0.3
A draft (modelled on ZIP 225) specifying version 6 of the transaction format
for NU6.3: version 5 plus an appended Ironwood bundle, an Orchard-protocol
shielded bundle committing to the Ironwood pool.

Covers the v6 field layout (Ironwood bundle = Orchard bundle shape; no ZIP 233
amount and no per-input sighash info); the consensus rules (lead byte, field
presence, the flag bits including enableCrossAddressOrchard at bit 2, and the
no-new-value-into-Orchard turnstile rule); changes to ZIP 209 and § 4.17 for the
Ironwood chain value pool balance; and the transaction-hashing changes — the
Ironwood txid and auth bundle digests with their 16-byte personalizations, and
the version 6 move of the Orchard and Ironwood anchors from effecting data to
authorizing data.

Open issues remain (the explicit fee field, the enableCrossAddress flag name,
placement of the turnstile rules, and confirmation of the personalization
strings).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
- Title -> "Version 6 Transaction Format"; drop the fee field; coinbase
  empty-Orchard-bundle note; reword the Orchard/Ironwood tree/nullifier-set
  separation.
- Sighash: extend the v6 anchor move (effecting -> auth data) to Sapling as
  well as Orchard and Ironwood; full txid/auth digest trees and the per-node
  personalization table (with _v6 personalizations where the encoding changed).
- Add a "Changes to ZIP 221" section: the Ironwood chain-history MMR node
  fields (hashEarliest/LatestIronwoodRoot, nIronwoodTxCount) [NU6.3 onward],
  mirroring the NU5 Orchard fields.
- Add a ZIP 209 intro citing [^zip-0209]; add the [^zip-0221], [^zip-0252],
  [^zip-0244-txiddigest], and [^zip-0244-authorizingdatacommitment] references.
- Fix the #openissues internal anchor (MMD strips hyphens).

The [0, MAX_MONEY] ZIP 209 change is left as a TODO pending the ZIP 256 update
in zcash#1295.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
…inology

Recoverable notes are now created in the Ironwood pool (introduced by the
version 6 transaction format), not directly in the Orchard pool. Retitle
accordingly, distinguish "Orchard[ZSA] protocol" from the pools, and define
the Ironwood/Orchard pool terms by reference to the v6 transaction format draft.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
Substantial revision of the v6 transaction format draft:

- Reframe around the Ironwood pool: Abstract/Motivation/Privacy Implications
  covering quantum recoverability, the supply-integrity motivation, the
  Orchard-address restriction, and the v5-vs-v6 anchor (effecting -> authorizing
  data) rationale; Requirements and Non-requirements reworked.
- Terminology: Orchard protocol vs Orchard pool vs Ironwood pool.
- Consensus rules split out; full txid/auth digest trees and the per-node
  personalization table.
- Resolve all references: split the deployment citations into ZIP 257 (the NU6.2
  deployment / vulnerability) and the NU6.3 deployment draft; add the ZIP 248,
  ZIP 2002, action-circuit-update, deploy-nu6.3, and ironwood-migration
  references; fix the action-circuit-update URL.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
- Drop the "...Orchard" suffix from the flag bit names: enableSpendsOrchard →
  enableSpends, enableOutputsOrchard → enableOutputs, enableCrossAddressOrchard
  → enableCrossAddress. These bits have the same meaning in both flagsOrchard
  and flagsIronwood, so the suffix was misleading; add a note for the
  rename relative to v5.
- State explicitly that version 4, version 5, and version 6 transactions are
  all valid from NU6.3 onward, and that the Orchard-protocol cross-address
  restriction is enforced for every Orchard-pool Action regardless of
  transaction version, so version 5 cannot be used to bypass it.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
…wledgement

- Add a "Note" column to the transaction-format table with †/‡/§/◊ markers
  for conditionally-present fields, and a legend giving each presence
  condition (matching the protocol spec § 7.1 convention). Move the presence
  conditions out of the Consensus Rules into that legend, leaving the 1:1
  proofs/signatures correspondence rule.
- Cosmetic improvements to the table presentations.
- Acknowledge the developers of Penumbra for demonstrating the advantages
  of treating the note commitment tree anchor as authorizing rather than
  effecting data.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Deploy Preview for zcash-zips-qedit ready!

Name Link
🔨 Latest commit d138c0d
🔍 Latest deploy log https://app.netlify.com/projects/zcash-zips-qedit/deploys/6a3bbac140530300070bb784
😎 Deploy Preview https://deploy-preview-135--zcash-zips-qedit.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@vivek-arte vivek-arte marked this pull request as draft June 23, 2026 12:44
daira and others added 8 commits June 24, 2026 08:23
draft-zodl-valargroup-ironwood-txformat. Also disambiguate protocol
and pool for some cases.

Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
* Updates to activate QR only for the Ironwood pool, and consequences
  such as being able to identify the QR nullifier set.
* Remove references to ZSAs other than to say that the QR proposal is
  compatible with them.
* Harmonize the Abstract wording with the Motivation section of
  draft-zodl-valargroup-ironwood-txformat.
* Add a note about recovery not being possible from the Sprout,
  Sapling, or Orchard pools.
* Add "It should be possible for wallets to identify what subset of a
  user's funds have been made recoverable." to the Requirements.
* Update the reference timeframe for updates to other ZIPs.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
of funds in shielded pools other than Ironwood.

Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
Co-authored-by: Daira-Emma Hopwood <daira@jacaranda.org>
Co-authored-by: Tal Derei <tal@bowe.tech>
Co-authored-by: Dev Ojha <ValarDragon@users.noreply.github.com>
* Set the `Discussions-To` field to zcash#1304
* Add a TODO about updates to ZIP 209.
* Add a section heading before the ZIP 209-related changes to the protocol
  specification.
* Cosmetic line-wrap and header fix.

Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
echo "I want freedom, the right to self-expression, everybody's right to beautiful, radiant things." |sha256sum |head --bytes=8

Signed-off-by: Daira-Emma Hopwood <daira@jacaranda.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants