2018-10-28 00:43:31 -07:00
|
|
|
::
|
|
|
|
|
|
|
|
ZIP: 205
|
|
|
|
Title: Deployment of the Sapling Network Upgrade
|
2019-08-01 01:18:23 -07:00
|
|
|
Owners: Daira Hopwood <daira@electriccoin.co>
|
2020-01-01 08:28:27 -08:00
|
|
|
Credits: Simon Liu
|
2019-08-01 01:18:23 -07:00
|
|
|
Status: Final
|
2018-10-28 00:43:31 -07:00
|
|
|
Category: Consensus
|
|
|
|
Created: 2018-10-08
|
|
|
|
License: MIT
|
|
|
|
|
2019-08-01 01:18:23 -07:00
|
|
|
|
2018-10-28 00:43:31 -07:00
|
|
|
Terminology
|
|
|
|
===========
|
|
|
|
|
|
|
|
The key words "MUST", "MUST NOT", "SHOULD", and "MAY" in this document are to be
|
|
|
|
interpreted as described in RFC 2119. [#RFC2119]_
|
|
|
|
|
|
|
|
The terms "branch" and "network upgrade" in this document are to be interpreted as
|
|
|
|
described in ZIP 200. [#zip-0200]_
|
|
|
|
|
|
|
|
The terms below are to be interpreted as follows:
|
|
|
|
|
|
|
|
Sapling
|
|
|
|
Code-name for the second Zcash network upgrade, also known as Network Upgrade 1.
|
|
|
|
|
|
|
|
|
|
|
|
Abstract
|
|
|
|
========
|
|
|
|
|
|
|
|
This proposal defines the deployment of the Sapling network upgrade. In addition,
|
|
|
|
it describes a hard fork that occurred on testnet to allow "minimum-difficulty"
|
|
|
|
blocks.
|
|
|
|
|
|
|
|
|
|
|
|
Specification
|
|
|
|
=============
|
|
|
|
|
|
|
|
Sapling deployment
|
|
|
|
------------------
|
|
|
|
|
|
|
|
The primary sources of information about Sapling consensus protocol changes are:
|
|
|
|
|
|
|
|
- The Zcash Protocol Specification [#protocol]_.
|
|
|
|
- Transaction Signature Verification for Sapling [#zip-0243]_.
|
|
|
|
- Network Upgrade Activation Mechanism [#zip-0200]_.
|
|
|
|
|
|
|
|
The network handshake and peer management mechanisms defined in [#zip-0201]_ also
|
|
|
|
apply to this upgrade.
|
|
|
|
|
|
|
|
|
|
|
|
The following network upgrade constants [#zip-0200]_ are defined for the Sapling
|
|
|
|
upgrade:
|
|
|
|
|
|
|
|
BRANCH_ID
|
|
|
|
``0x76b809bb``
|
|
|
|
|
|
|
|
ACTIVATION_HEIGHT (Sapling)
|
|
|
|
Testnet: 280000
|
|
|
|
|
|
|
|
Mainnet: 419200
|
|
|
|
|
|
|
|
|
|
|
|
On testnet, Sapling had activated prior to this height, but that branch was rolled
|
|
|
|
back. A subsequent hard fork occurred on testnet, changing the difficulty algorithm
|
|
|
|
to accept "minimum-difficulty" blocks under certain conditions starting at block
|
|
|
|
height 299188.
|
|
|
|
|
|
|
|
|
|
|
|
On both mainnet and testnet, Sapling-compatible nodes MUST advertise protocol
|
|
|
|
version 170007 or later. The minimum peer protocol version that Sapling-compatible
|
|
|
|
nodes will connect to, remains 170002.
|
|
|
|
|
|
|
|
Pre-Sapling nodes are defined as nodes advertising a protocol version less than
|
|
|
|
170007.
|
|
|
|
|
|
|
|
Approximately three days (defined in terms of block height) before the Sapling
|
|
|
|
activation height, Sapling-compatible nodes will change the behaviour of their peer
|
|
|
|
connection logic in order to prefer pre-Sapling peers for eviction from the set of
|
|
|
|
peer connections.
|
|
|
|
|
2019-08-06 05:58:09 -07:00
|
|
|
::
|
|
|
|
|
2018-10-28 00:43:31 -07:00
|
|
|
/** The period before a network upgrade activates, where connections to upgrading peers are preferred (in blocks). */
|
|
|
|
static const int NETWORK_UPGRADE_PEER_PREFERENCE_BLOCK_PERIOD = 24 * 24 * 3;
|
|
|
|
|
|
|
|
The implementation is similar to that for Overwinter which was described in
|
2018-10-30 13:41:48 -07:00
|
|
|
[#zip-0201]_.
|
2018-10-28 00:43:31 -07:00
|
|
|
|
|
|
|
Once Sapling activates on testnet or mainnet, Sapling nodes should take steps to:
|
|
|
|
|
|
|
|
- reject new connections from pre-Sapling nodes;
|
|
|
|
- disconnect any existing connections to pre-Sapling nodes.
|
|
|
|
|
|
|
|
|
|
|
|
Change to difficulty adjustment on testnet
|
|
|
|
------------------------------------------
|
|
|
|
|
|
|
|
Section 7.6.3 of [#protocol]_ describes the algorithm used to adjust the difficulty
|
2018-10-30 13:41:48 -07:00
|
|
|
of a block (defined in terms of a "target threshold") based on the ``nTime`` and
|
|
|
|
``nBits`` fields of preceding blocks.
|
2018-10-28 00:43:31 -07:00
|
|
|
|
|
|
|
This algorithm changed on testnet, starting from block 299188, to allow
|
|
|
|
"minimum-difficulty" blocks. If the block time of a block from this height onward
|
|
|
|
is at least 15 minutes after that of the preceding block, then the block is a
|
|
|
|
minimum-difficulty block, and its target threshold is set to the value of
|
2018-10-30 13:41:48 -07:00
|
|
|
PoWLimit for testnet (see [#protocol]_ section 5.3). However, its ``nBits`` field
|
2018-10-28 00:43:31 -07:00
|
|
|
is still computed according to the original difficulty adjustment algorithm.
|
|
|
|
|
|
|
|
This does not affect how the minimum-difficulty block is treated for subsequent
|
2018-10-30 13:41:48 -07:00
|
|
|
difficulty adjustments. In particular, only the ``nBits`` field computed by the
|
|
|
|
original algorithm is used for the purpose of computing the MeanTarget values
|
2018-10-28 00:43:31 -07:00
|
|
|
from which subsequent difficulty changes are calculated.
|
|
|
|
|
|
|
|
This change does not affect mainnet.
|
|
|
|
|
|
|
|
|
|
|
|
Backward compatibility
|
|
|
|
======================
|
|
|
|
|
|
|
|
Prior to the network upgrade activating, Sapling and pre-Sapling nodes are
|
|
|
|
compatible and can connect to each other. However, Sapling nodes will have a
|
|
|
|
preference for connecting to other Sapling nodes, so pre-Sapling nodes will
|
|
|
|
gradually be disconnected in the run up to activation.
|
|
|
|
|
|
|
|
Once the network upgrades, even though pre-Sapling nodes can still accept the
|
|
|
|
numerically larger protocol version used by Sapling as being valid, Sapling nodes
|
|
|
|
will always disconnect peers using lower protocol versions.
|
|
|
|
|
|
|
|
|
|
|
|
Support in zcashd
|
|
|
|
=================
|
|
|
|
|
|
|
|
Support for Sapling consensus rules was implemented in zcashd version 2.0.0.
|
|
|
|
The majority of support for RPC calls and persistence of Sapling z-addresses
|
|
|
|
was implemented in version 2.0.1. Both of these versions advertise protocol
|
|
|
|
version 170007.
|
|
|
|
|
|
|
|
|
|
|
|
References
|
|
|
|
==========
|
|
|
|
|
2019-11-07 12:28:29 -08:00
|
|
|
.. [#protocol] `Zcash Protocol Specification, Version 2018.0-beta-37 [Overwinter+Sapling] <protocol/protocol.pdf>`_
|
2020-02-29 07:51:03 -08:00
|
|
|
.. [#RFC2119] `Key words for use in RFCs to Indicate Requirement Levels <https://www.rfc-editor.org/rfc/rfc2119.html>`_
|
2019-11-07 12:28:29 -08:00
|
|
|
.. [#zip-0200] `ZIP 200: Network Upgrade Activation Mechanism <zip-0200.rst>`_
|
|
|
|
.. [#zip-0201] `ZIP 201: Network Peer Management for Overwinter <zip-0201.rst>`_
|
|
|
|
.. [#zip-0243] `ZIP 243: Transaction Signature Verification for Sapling <zip-0243.rst>`_
|