ZIP: 207
Title: Funding Streams
Owners: Jack Grigg <[email protected]>
Daira-Emma Hopwood <[email protected]>
Status: [Revision 0: Canopy, Revision 1: NU6] Final, [Revision 2: NU7] Proposed
Category: Consensus
Created: 2019-01-04
Last-Updated: 2026-10-13
License: MIT
The key word "MUST" in this document is to be interpreted as described in BCP 14 1 when, and only when, it appears in all capitals.
The terms "block subsidy" and "halving" in this document are to be interpreted as described in sections 3.10 and 7.8 of the Zcash Protocol Specification. 2 10
The terms "consensus branch" and "network upgrade" in this document are to be interpreted as described in ZIP 200. 14
The terms below are to be interpreted as follows:
This proposal specifies a mechanism to support funding streams, distributed from a portion of the block subsidy for a specified range of block heights.
This is intended as a means of implementing the Zcash Development Fund, using the funding stream definitions specified in ZIP 214 19. It should be read in conjunction with ZIP 1014 25, which describes the high-level requirements for that fund.
Revision 2 preserves the approximate duration and value of each address period when NU7 reduces the target block spacing to 25 seconds.
Motivation for the Zcash Development Fund is considered in ZIP 1014 25.
This ZIP 207 was originally proposed for the Blossom network upgrade, as a means of splitting the original Founders’ Reward into several streams. It was then withdrawn when such splitting was judged to be unnecessary at the consensus level. Since the capabilities of the funding stream mechanism match the requirements for the Zcash Development Fund, the ZIP was reintroduced for that purpose in the Canopy upgrade in order to reuse specification, analysis, and implementation effort.
As of NU6, ZIP 1015 26 directs part of the block subsidy to a reserve, the distribution of which is to be determined via a future ZIP. ZIP 2001 27 modified this ZIP to augment the funding stream mechanism with a common mechanism to implement this proposal. ZIP 271 24 specifies a one-time disbursement from this reserve at NU6.1 activation, which is deducted from the Deferred Development Fund Chain Value Pool Balance.
The primary requirement of this ZIP is to provide a mechanism for specifying the funding streams that are used in ZIP 214 19 to implement the Zcash Development Fund. It should be sufficiently expressive to handle both the main three "slices" (BP, ZF, and MG) defined in ZIP 1014 25, and also (with additional funding stream definitions) the "direct grant option" described in that ZIP.
As for the original Founders’ Reward, a mechanism is provided to allow addresses for a given funding stream to be changed on a roughly-monthly basis, so that keys that are not yet needed may be kept off-line as a security measure.
We use the following constants and functions defined in 5, 9, and 10:
We also define the following function:
A funding stream is defined by a block subsidy fraction (represented as a numerator and a denominator), a start height (inclusive), an end height (exclusive), and a sequence of recipients as defined below.
By defining the issuance as a proportion of the total block subsidy, rather than absolute zatoshis, this ZIP dovetails with any changes to both block target spacing and issuance-per-block rates. Such a change occurred at the Blossom network upgrade, for example. 15
The value of a funding stream at a given block height is defined as:
An active funding stream at a given block height is defined as a funding stream for which the block height is less than its end height, but not less than its start height.
The value of each funding stream is paid to one of a pre-defined set of recipients, depending on the block height.
As of Revision 0, each recipient MUST be the string encoding of a transparent P2SH address or Sapling address (as specified in 6 or 7).
As of Revision 1, each recipient identifier MUST be either the string encoding of a transparent P2SH address or Sapling address (as specified in 6 or 7) or the identifier \(\mathsf{DEFERRED\_POOL}\kern-0.03em\textsf{.}\) The latter, added in the NU6 network upgrade 22, indicates that the value is to be paid to a reserve to be used for development funding, the distribution of which is to be determined via a future ZIP.
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 6 or 7) or the identifier \(\mathsf{DEFERRED\_POOL}\kern-0.03em\textsf{.}\)
Each address is used for at most 1/48th of a halving interval, creating a roughly-monthly sequence of funding periods. The address to be used for a given block height is defined as follows:
This has the property that all active funding streams change the address they are using on the same block height schedule, aligned to the height of the first halving so that 48 funding periods fit cleanly within a halving interval. This can be leveraged to simplify implementations, by batching the necessary outputs for each funding period.
The sequence \(\mathsf{FundingStream[FUND].Addresses}\) is indexed from 0, and MUST have \(\mathsf{FundingStream[FUND].AddressIndex}(\mathsf{FundingStream[FUND].EndHeight} - 1) + 1\) entries. (The protocol specification calls the same sequence \(\mathsf{fs.Recipients}\) and indexes it from 1. 12)
For a funding stream \(\mathsf{fs}\) we write \(\mathsf{fs.Value}(\mathsf{height})\) for \(\mathsf{FundingStream[fs].Value}(\mathsf{height})\) and \(\mathsf{fs.Recipient}(\mathsf{height})\) for \(\mathsf{FundingStream[fs].Address}(\mathsf{height})\) at each block height.
As of Revision 2, the definition of \(\mathsf{AddressPeriod}\) above is replaced on each network by the following piecewise definition. Let \(A\) be the NU7 activation height on that network, let \(R = \mathsf{NU7PoWTargetSpacingRatio} = 3\) and \(\mathsf{IsNU7Activated}\) be as defined in ZIP 218 20, let \(C = \mathsf{AddressChangeInterval}\kern-0.03em\textsf{,}\) let \(I = \mathsf{PostBlossomHalvingInterval}\kern-0.03em\textsf{,}\) and let \(H_1 = \mathsf{HeightForHalving}(1)\kern-0.03em\textsf{.}\)
The \(\mathsf{FundingStream[FUND].AddressIndex}\) and \(\mathsf{FundingStream[FUND].Address}\) calculations above MUST use this definition for funding streams active at or after NU7 activation, including when calculating the period at a stream's start height. This preserves the address index at activation. If NU7 activates partway through an address period, its remaining block count is tripled; each subsequent period lasts 105000 blocks. At the 25-second target spacing, each period therefore retains approximately its previous wall-clock duration and funding amount, subject to per-block rounding.
Below is a visual representation of how stream addresses align with funding periods:
Example height Stream A Stream B Stream C AddressChangeInterval - 2A0 AddressChangeInterval - 1A0 AddressChangeIntervalA1 B0 C0 AddressChangeInterval + 1A1 B0 C0 ... 2*AddressChangeInterval - 2A1 B0 C0 2*AddressChangeInterval - 1A1 B0 C0 2*AddressChangeIntervalA2 C1 2*AddressChangeInterval + 1A2 C1 ... PostBlossomHalvingInterval - 2A2 C1 PostBlossomHalvingInterval - 1A2 C1 PostBlossomHalvingIntervalC2 PostBlossomHalvingInterval + 1C2 ... PostBlossomHalvingInterval + AddressChangeInterval/2C2 ... PostBlossomHalvingInterval + 2*AddressChangeInterval - 1C2 PostBlossomHalvingInterval + 2*AddressChangeIntervalC3 ... PostBlossomHalvingInterval + 5*AddressChangeInterval - 1C3 PostBlossomHalvingInterval + 5*AddressChangeIntervalC4
The last rows illustrate Revision 2 with NU7 activating halfway through the period of address C2, at height PostBlossomHalvingInterval + AddressChangeInterval/2: the remaining half of that period is tripled, and the period of C3 lasts 3*AddressChangeInterval blocks.
On Mainnet, Canopy activated exactly at the point when the Founders’ Reward expired, at block height 1046400. On Testnet, there was a shortened Founders’ Reward address period prior to Canopy activation.
As of Revision 1 of this specification, full node implementations MUST track an additional \(\mathsf{ChainValuePoolBalance^{Deferred}}\) chain value pool balance, in addition to the other chain value pool balances defined in 4 (see also ZIP 209 16).
Define \(\mathsf{totalDeferredOutput}(\mathsf{height}) := \sum_{\mathsf{fs} \in \mathsf{DeferredFundingStreams}(\mathsf{height})} \mathsf{fs.Value}(\mathsf{height})\) where \(\mathsf{DeferredFundingStreams}(\mathsf{height})\) is the set of funding streams with recipient identifier \(\mathsf{DEFERRED\_POOL}\) in the block at height \(\mathsf{height}\kern-0.03em\textsf{.}\)
Define \(\mathsf{totalDeferredInput}(\mathsf{height})\) as in 10: it is \(\mathsf{ZIP271DisbursementAmount}\) at the height \(\mathsf{ZIP271ActivationHeight}\) of the one-time lockbox disbursement specified in ZIP 271 24, and zero at every other height.
The \(\mathsf{ChainValuePoolBalance^{Deferred}}\) chain value pool balance for a given block chain is the sum of the values of payments to \(\mathsf{DEFERRED\_POOL}\) for transactions in the block chain, minus the lockbox disbursement from it in that block chain.
Equivalently, \(\mathsf{ChainValuePoolBalance^{Deferred}}\) for a block chain up to and including height \(\mathsf{height}\) is given by \(\sum_{\mathsf{h} = 0}^{\mathsf{height}} \left(\mathsf{totalDeferredOutput}(\mathsf{h}) - \mathsf{totalDeferredInput}(\mathsf{h})\right)\kern-0.03em\textsf{.}\)
Note: \(\mathsf{totalDeferredOutput}(\mathsf{h})\) is necessarily zero for heights \(\mathsf{h}\) prior to NU6 activation, and \(\mathsf{totalDeferredInput}(\mathsf{h})\) is necessarily zero for heights \(\mathsf{h}\) prior to NU6.1 activation.
Prior to activation of the Canopy network upgrade, the existing consensus rule for payment of the original Founders’ Reward is enforced. 11
Once the Canopy network upgrade activates:
OP_HASH160 RedeemScriptHash OP_EQUAL as the scriptPubKey 29, where RedeemScriptHash is the 20-byte script hash in the raw encoding of the address 6.
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.
Once the NU6 network upgrade activates:
Note: The outputs required by rule 2 before NU6 activation are likewise distinct for each funding stream. In particular, a single output cannot be counted for two active funding streams that have the same recipient and the same value.
Rule 5 has subsequently been clarified as follows:
Note: The recipient identifiers permitted above do not include Orchard addresses; the "prescribed way" to pay an Orchard address is defined in anticipation of a future change. Up to and including NU7 there have been no funding streams defined with a shielded payment address as a recipient. That might change in future, so implementations are encouraged to support Sapling and Orchard addresses as recipients, as permitted by 18.
These rules are reproduced in 12.
The effect of the definition of \(\mathsf{ChainValuePoolBalance^{Deferred}}\) above is that payments to the \(\mathsf{DEFERRED\_POOL}\) cause \(\mathsf{FundingStream[FUND].Value}(\mathsf{height})\) to be added to \(\mathsf{ChainValuePoolBalance^{Deferred}}\) for the block chain including that block, and that the lockbox disbursement specified in ZIP 271 24 causes \(\mathsf{ZIP271DisbursementAmount}\) to be subtracted from it.
For the funding stream definitions activated at Canopy, NU6, and NU6.1, and their changes at NU7, see ZIP 214. 19 Funding stream definitions can be added, changed, or deleted in ZIPs associated with subsequent network upgrades, subject to the ZIP process. 13
This proposal was initially deployed with Canopy. 21
Changes to support deferred funding streams were deployed with NU6. 22
Revision 2 is intended to activate with NU7 as specified in ZIP 259 23.
This proposal intentionally creates what is known as a "bilateral consensus rule change". Use of this mechanism requires that all network participants upgrade their software to a compatible version within the upgrade window. Older software will treat post-upgrade blocks as invalid, and will follow any pre-upgrade consensus branch that persists.
fs.Value and fs.Recipient, and required each address list to cover its funding stream's height range.| 1 | 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" |
|---|
| 2 | Zcash Protocol Specification, Version 2026.8.0 [NU6.3]. Section 3.10: Block Subsidy, Funding Streams, and Founders’ Reward |
|---|
| 3 | Zcash Protocol Specification, Version 2026.8.0 [NU6.3]. Section 3.12: Mainnet and Testnet |
|---|
| 4 | Zcash Protocol Specification, Version 2026.8.0 [NU6.3]. Section 4.17: Chain Value Pool Balances |
|---|
| 5 | Zcash Protocol Specification, Version 2026.8.0 [NU6.3]. Section 5.3: Constants |
|---|
| 6 | Zcash Protocol Specification, Version 2026.8.0 [NU6.3]. Section 5.6.1.1: Transparent Addresses |
|---|
| 7 | Zcash Protocol Specification, Version 2026.8.0 [NU6.3]. Section 5.6.3.1: Sapling Payment Addresses |
|---|
| 8 | Zcash Protocol Specification, Version 2026.8.0 [NU6.3]. Section 7.1.2: Transaction Consensus Rules |
|---|
| 9 | Zcash Protocol Specification, Version 2026.8.0 [NU6.3]. Section 7.7.3: Difficulty adjustment |
|---|
| 10 | Zcash Protocol Specification, Version 2026.8.0 [NU6.3]. Section 7.8: Calculating Block Subsidy, Funding Streams, Lockbox Disbursement, and Founders’ Reward |
|---|
| 11 | Zcash Protocol Specification, Version 2026.8.0 [NU6.3]. Section 7.9: Payment of Founders’ Reward |
|---|
| 12 | Zcash Protocol Specification, Version 2026.8.0 [NU6.3]. Section 7.10: Payment of Funding Streams, Deferred Lockbox, and Lockbox Disbursement |
|---|
| 13 | ZIP 0: ZIP Process |
|---|
| 14 | ZIP 200: Network Upgrade Mechanism |
|---|
| 15 | ZIP 208: Shorter Block Target Spacing |
|---|
| 16 | ZIP 209: Prohibit Out-of-Range Chain Value Pool Balances |
|---|
| 17 | ZIP 212: Allow Recipient to Derive Ephemeral Secret from Note Plaintext |
|---|
| 18 | ZIP 213: Shielded Coinbase |
|---|
| 19 | ZIP 214: Consensus rules for a Zcash Development Fund |
|---|
| 20 | ZIP 218: 25-second Block Target Spacing |
|---|
| 21 | ZIP 251: Deployment of the Canopy Network Upgrade |
|---|
| 22 | ZIP 253: Deployment of the NU6 Network Upgrade |
|---|
| 23 | ZIP 259: Deployment of the NU7 Network Upgrade |
|---|
| 24 | ZIP 271: Dev Fund Extension and One-Time Disbursement |
|---|
| 25 | ZIP 1014: Establishing a Dev Fund for ECC, ZF, and Major Grants |
|---|
| 26 | ZIP 1015: Block Subsidy Allocation for Non-Direct Development Funding |
|---|
| 27 | ZIP 2001: Lockbox Funding Streams |
|---|
| 28 | ZIP 2008: Update to FS_FPF_ZCG_H3 address list |
|---|
| 29 | Transactions: P2SH Scripts — Bitcoin Developer Guide |
|---|
| 30 | Zebra PR 11529: feat(consensus)!: implement NU7 spacing, funding schedules, and shielded limits |
|---|
| 31 | Zebra PR 11527: feat(nu7)!: prepare ZIP 259 deployment and ZIP 2008 payouts |
|---|