Zcash in Simplified Technical English

This page is the Simplified Technical English version of ZIP 2008. The source ZIP is the normative text. Read the writing rules to understand the marked words.

ZIP 2008: Update to FS_FPF_ZCG_H3 address list

ZIP: 2008
Title: Update to `FS_FPF_ZCG_H3` address list
Owners: Jack Grigg <thestr4d@gmail.com>
Status: Final
Category: Consensus
Created: 2026-09-24
License: MIT

Terminology

On this page, STE words are in the place of the BCP 14 key words of the source. Refer to the key word table.

The term NU7ActivationHeight has the same meaning as in ZIP 218 [zip-0218].

Abstract

This ZIP contains an update to the address list for the FS_FPF_ZCG_H3 funding stream. The update is a result of operational changes that the recipient made.

Motivation

The recipient of the FS_FPF_ZCG_H3 funding stream told the ZIP Editors that it was necessary to receive the funding stream at a new address. This change can occur only at a network upgrade boundary. The reason is that the recipient addresses of the funding streams are part of the consensus rules.

Requirements

Specification

Changes to ZIP 207

In "Funding streams" [zip-0207], find the paragraph that starts with this text:

As of Revision 1_, each recipient identifier MUST be...

After that paragraph, add this text:

As of Revision 2_, each recipient identifier MUST be either the string encoding of a transparent P2PKH or P2SH address or of a Sapling address (as specified in [#protocol-transparentaddrencoding]_ or [#protocol-saplingpaymentaddrencoding]_) or the identifier \(\mathsf{DEFERRED\_POOL}\).

In "Consensus rules" [zip-0207], add this text at the end of rule 4:

As of Revision 2_, the "prescribed way" to pay a transparent P2PKH address is to use OP_DUP OP_HASH160 <keyHash> OP_EQUALVERIFY OP_CHECKSIG as the output's scriptPubKey, where <keyHash> is the direct push of the 20-byte public-key hash decoded from the recipient's Base58Check address. No other script encoding satisfies this funding-stream payment rule.

In "References" [zip-0207], add this text:

.. [#zip-2008] `ZIP 2008: Update to FS_FPF_ZCG_H3 address list <zip-2008.md>`_

Changes to the Zcash Protocol Specification

In § 7.10 'Payment of Funding Streams, Deferred Lockbox, and Lockbox Disbursement' [protocol-fundingstreams], make these two changes from NU7 activation:

  • Add transparent P2PKH addresses to the valid types of funding stream recipients.
  • Add the text that follows, next to the existing P2SH and shielded prescribed ways.

The prescribed way to pay a transparent P2PKH address is to use a script of the form OP_DUP OP_HASH160 fs.PubKeyHash(height) OP_EQUALVERIFY OP_CHECKSIG as the scriptPubKey, where \(\mathsf{fs.PubKeyHash}(\mathsf{height})\) is the direct push of the 20-byte public key hash in the raw encoding of the recipient address for \(\mathsf{fs.Recipient}(\mathsf{height})\). No other script encoding satisfies this rule.

The requirements for the amount and for distinct outputs stay the same.

Changes to ZIP 214

In "Abstract" [zip-0214], find the paragraph about Revision 3. Replace the end of this paragraph:

streams at the third halving.

Put this text in its place:

streams at the third halving, and updates the ``FS_FPF_ZCG_H3`` recipient
address per ZIP 2008 [#zip-2008]_.

In "Mainnet Recipients for Revision 2" [zip-0214], replace the section heading with this text:

Mainnet Recipients for `Revision 2`_ and `Revision 3`_
------------------------------------------------------

In the same section, replace this text:

FS_FPF_ZCG_H3.AddressList[0..35] = ["t3cFfPt1Bcvgez9ZbMBFWeZsskxTkPzGCow"] * 36

Put this text in its place:

N = FundingStream[FS_FPF_ZCG_H3].AddressIndex(NU7ActivationHeight - 1) + 1
FS_FPF_ZCG_H3.AddressList[0..N-1] = ["t3cFfPt1Bcvgez9ZbMBFWeZsskxTkPzGCow"] * N
FS_FPF_ZCG_H3.AddressList[N..35] = ["t1MkHnkxVjNpNbCrSs3AJ8J7ZSp6NTYiUcG"] * (36 - N)

In the paragraph after that text, replace "address list remains valid" with "address list length remains valid".

After that paragraph, add this note:

Note: The addresses ``FS_FPF_ZCG_H3.AddressList[N..35]`` were altered
in `Revision 3`_ by the NU7 upgrade in ZIP 2008 [#zip-2008]_.

In "References" [zip-0214], add this text:

.. [#zip-2008] `ZIP 2008: Update to FS_FPF_ZCG_H3 address list <zip-2008.md>`_

Activation constraint

The Mainnet NU7 activation height must be selected so that \(0 \leq N < 36\) is true. With this constraint, the new address is selected for a minimum of one remaining funding period. With the current funding schedule and the multiple-of-three activation constraint, the latest valid Mainnet activation height is 4,371,399.

Consensus node implementor note

After ZIP 259 [zip-0259] has a Mainnet activation height, implementations can use a fixed array of addresses in the correct sequence and not calculate N dynamically.

Rationale

This ZIP contains a change to the existing address list. With this change, the new address is used from the first funding period that starts after NU7 activation. Thus, the first use of the new address depends on the exact value of NU7ActivationHeight. This first use can occur at any time from "immediately" to "about a month" after activation.

This approach was selected because it is simple and because there was little time before NU7 activation. An alternative approach is to change the address at the activation of the network upgrade. With that approach, larger changes to ZIP 214 [zip-0214] are necessary. Larger changes to ZIP 207 [zip-0207] are possibly necessary also.

Deployment

This ZIP was deployed with NU7 [zip-0259].

Reference implementation

References

[BCP14]
Information on BCP 14 — "RFC 2119: Key words for use in RFCs to Indicate Requirement Levels" and "RFC 8174: Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words"
[protocol-fundingstreams]
Zcash Protocol Specification, Version 2026.8.0 [NU6.3]. Section 7.10: Payment of Funding Streams, Deferred Lockbox, and Lockbox Disbursement
[zip-0207]
ZIP 207: Funding Streams
[zip-0214]
ZIP 214: Consensus rules for a Zcash Development Fund
[zip-0218]
ZIP 218: 25-second Block Target Spacing
[zip-0259]
ZIP 259: Deployment of the NU7 Network Upgrade
[zakura-1201]
Zakura PR 1201: feat(consensus): rotate NU7 FPF address (ZIP 2008)
[zebra-11527]
Zebra PR 11527: feat(nu7)!: prepare ZIP 259 deployment and ZIP 2008 payouts