Skip to content

ZIP 317: Add Ironwood-pool Action fees as a revision to ZIP 317 - #1314

Merged
nuttycom merged 4 commits into
zcash:mainfrom
nuttycom:zip317-ironwood
Jul 3, 2026
Merged

ZIP 317: Add Ironwood-pool Action fees as a revision to ZIP 317#1314
nuttycom merged 4 commits into
zcash:mainfrom
nuttycom:zip317-ironwood

Conversation

@nuttycom

Copy link
Copy Markdown
Contributor

Updates ZIP 317 for the Ironwood network upgrade (NU6.3), which introduces
the Ironwood shielded pool (ZIP 229).
Ironwood reuses the Orchard Action structure, so the fee change is simply one
marginal fee per Ironwood Action.

The current ZIP 317 formula had folded in the ZIP 227 (ZSA) and ZIP 231
(memo bundle) contributions, which depend on the unmerged ZIP 248 Extensible
Transaction Format and are not part of NU6.3. To represent the deployment
timeline accurately, this PR restructures the fee specification using the
revisions mechanism (as in ZIP 214):

  • Revision 0 — the currently deployed mechanism (Transparent, Sprout,
    Sapling, Orchard contributions).
  • Revision 1 (Proposed, NU6.3) — adds the Ironwood-pool Action
    contribution.
  • Revision 2 (Draft) — adds memo-bundle fee handling (ZIP 231 / ZIP 248).

The ZSA contributions (ZIP 227) are removed entirely; if re-proposed they
would be reintroduced as additions to the ZIP 248 handling in Revision 2.

Three commits:

  1. Remove the ZSA issuance and asset-creation fee contributions.
  2. Introduce the revisions mechanism (recast as Revision 0; move memo
    handling to draft Revision 2).
  3. Add Revision 1 for the Ironwood upgrade.

Verified locally with make all-zips and make test (render regression).

Opened as a draft.

Closes #1312

🤖 Generated with Claude Code

nuttycom and others added 2 commits June 26, 2026 21:51
Zcash Shielded Assets (ZIP 227) are not being deployed in NU6.3 or NU7,
so remove the corresponding fee contributions for now: the ZSAIssuance
and ZSACreation contributions, the creation_cost parameter, the
nZSAIssueNotes and nAssetCreations inputs, the "garbage Custom Assets"
requirement, the ZSA Creation Cost rationale, and the ZIP 227 reference.

If ZSAs are re-proposed in future, these would be reintroduced as
additions to the ZIP 248 fee handling rather than to the base mechanism.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Recast the existing, currently-deployed fee mechanism as Revision 0, and
move the memo bundle fee handling (ZIP 231) into a draft Revision 2. Memo
bundles are defined as a modification to the Extensible Transaction Format
(ZIP 248), which has not yet been deployed, so this handling does not apply
to the deployed mechanism.

The conventional fee formula is now stated once, with logical_actions
defined as the sum of the contributions defined by the applicable revision;
each revision lists the contributions it adds. Also adds a Last-Updated
field and a Change History section, following the convention in ZIP 214.

This separates deployed behavior from not-yet-deployed additions, in
preparation for adding the Ironwood (NU6.3) contribution as Revision 1.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
arya2
arya2 previously approved these changes Jun 29, 2026
Comment thread zips/zip-0317.rst
Comment thread zips/zip-0317.rst
Comment thread zips/zip-0317.rst Outdated
Comment thread README.rst Outdated
Comment thread README.rst Outdated
The Ironwood network upgrade (NU6.3) introduces the Ironwood shielded pool,
which reuses the Orchard Action structure (ZIP 229). Revision 1 adds an
Ironwood-pool Action contribution to the logical action count, charging one
marginal fee per Ironwood Action, exactly as for Orchard Actions.

The free_memo_chunks condition in the draft Revision 2 is extended to count
Ironwood Actions, since Ironwood-pool output notes carry memos in the same
way as Orchard. The non-discrimination requirement and rationale are updated
to include Ironwood, and references to ZIP 229 and ZIP 258 (NU6.3 deployment)
are added.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@nuttycom
nuttycom marked this pull request as ready for review June 29, 2026 23:44
@nuttycom nuttycom changed the title ZIP 317: Add Ironwood-pool Action fees via a revisions mechanism ZIP 317: Add Ironwood-pool Action fees as a revision to ZIP 317 Jun 29, 2026
Comment thread zips/zip-0317.rst Outdated
Comment thread zips/zip-0317.rst
Credits: Madars Virza
Francisco Gindre
Status: Active
Status: [Revision 0] Active, [Revision 1: NU6.3] Draft, [Revision 2] Draft

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Status: [Revision 0] Active, [Revision 1: NU6.3] Draft, [Revision 2] Draft
Status: [Revision 0] Active, [Revision 1: NU6.3] Proposed, [Revision 2] Draft

(subject to ZIP Editor consensus in the 2026-06-30 sync meeting)

Comment thread zips/zip-0317.rst Outdated
Comment thread zips/zip-0317.rst Outdated
Comment thread zips/zip-0317.rst Outdated
Comment thread zips/zip-0317.rst Outdated
Comment thread zips/zip-0317.rst
daira
daira previously approved these changes Jun 30, 2026

@daira daira left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ACK modulo suggestions.

Co-authored-by: Daira-Emma Hopwood <daira@jacaranda.org>
@nuttycom
nuttycom requested review from arya2 and daira July 1, 2026 05:27
@nuttycom
nuttycom enabled auto-merge July 1, 2026 05:28
@nuttycom
nuttycom merged commit d2c4e82 into zcash:main Jul 3, 2026
3 checks passed
@nuttycom
nuttycom deleted the zip317-ironwood branch July 16, 2026 15:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[ZIP 317]: Add Ironwood fees

4 participants