Fix all links in ZIPs (and almost eliminate plain http links).
Signed-off-by: Daira Hopwood <daira@jacaranda.org>
This commit is contained in:
Daira Hopwood
parent
195b8147eb
commit
db418a5dd5
|
|
@ -215,20 +215,20 @@ Updates:</pre>
|
|||
<li>BSD-2-Clause: <a href="https://opensource.org/licenses/BSD-2-Clause">OSI-approved BSD 2-clause license</a></li>
|
||||
<li>BSD-3-Clause: <a href="https://opensource.org/licenses/BSD-3-Clause">OSI-approved BSD 3-clause license</a></li>
|
||||
<li>CC0-1.0: <a href="https://creativecommons.org/publicdomain/zero/1.0/">Creative Commons CC0 1.0 Universal</a></li>
|
||||
<li>GNU-All-Permissive: <a href="http://www.gnu.org/prep/maintain/html_node/License-Notices-for-Other-Files.html">GNU All-Permissive License</a></li>
|
||||
<li>Apache-2.0: <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, version 2.0</a></li>
|
||||
<li>GNU-All-Permissive: <a href="https://www.gnu.org/prep/maintain/html_node/License-Notices-for-Other-Files.html">GNU All-Permissive License</a></li>
|
||||
<li>Apache-2.0: <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, version 2.0</a></li>
|
||||
</ul>
|
||||
<p>In addition, it is RECOMMENDED that literal code included in the ZIP be dual-licensed under the same license terms as the project it modifies. For example, literal code intended for zcashd would ideally be dual-licensed under the MIT license terms as well as one of the above with the rest of the ZIP text.</p>
|
||||
</section>
|
||||
<section id="not-recommended-but-acceptable-licenses"><h3><span class="section-heading">Not recommended, but acceptable licenses</span><span class="section-anchor"> <a rel="bookmark" href="#not-recommended-but-acceptable-licenses"><img width="24" height="24" src="assets/images/section-anchor.png" alt=""></a></span></h3>
|
||||
<ul>
|
||||
<li>BSL-1.0: <a href="http://www.boost.org/LICENSE_1_0.txt">Boost Software License, version 1.0</a></li>
|
||||
<li>BSL-1.0: <a href="https://www.boost.org/LICENSE_1_0.txt">Boost Software License, version 1.0</a></li>
|
||||
<li>CC-BY-4.0: <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International</a></li>
|
||||
<li>CC-BY-SA-4.0: <a href="https://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International</a></li>
|
||||
<li>AGPL-3.0+: <a href="http://www.gnu.org/licenses/agpl-3.0.en.html">GNU Affero General Public License (AGPL), version 3 or newer</a></li>
|
||||
<li>FDL-1.3: <a href="http://www.gnu.org/licenses/fdl-1.3.en.html">GNU Free Documentation License, version 1.3</a></li>
|
||||
<li>GPL-2.0+: <a href="http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html">GNU General Public License (GPL), version 2 or newer</a></li>
|
||||
<li>LGPL-2.1+: <a href="http://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html">GNU Lesser General Public License (LGPL), version 2.1 or newer</a></li>
|
||||
<li>AGPL-3.0+: <a href="https://www.gnu.org/licenses/agpl-3.0.en.html">GNU Affero General Public License (AGPL), version 3 or newer</a></li>
|
||||
<li>FDL-1.3: <a href="https://www.gnu.org/licenses/fdl-1.3.en.html">GNU Free Documentation License, version 1.3</a></li>
|
||||
<li>GPL-2.0+: <a href="https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html">GNU General Public License (GPL), version 2 or newer</a></li>
|
||||
<li>LGPL-2.1+: <a href="https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html">GNU Lesser General Public License (LGPL), version 2.1 or newer</a></li>
|
||||
</ul>
|
||||
</section>
|
||||
<section id="not-acceptable-licenses"><h3><span class="section-heading">Not acceptable licenses</span><span class="section-anchor"> <a rel="bookmark" href="#not-acceptable-licenses"><img width="24" height="24" src="assets/images/section-anchor.png" alt=""></a></span></h3>
|
||||
|
|
@ -291,7 +291,7 @@ Updates:</pre>
|
|||
<tbody>
|
||||
<tr>
|
||||
<th>5</th>
|
||||
<td><a href="http://docutils.sourceforge.net/rst.html">reStructuredText documentation</a></td>
|
||||
<td><a href="https://docutils.sourceforge.io/rst.html">reStructuredText documentation</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
|
|
|||
16
zip-0000.rst
16
zip-0000.rst
|
|
@ -560,9 +560,9 @@ Recommended licenses
|
|||
* CC0-1.0: `Creative Commons CC0 1.0
|
||||
Universal <https://creativecommons.org/publicdomain/zero/1.0/>`__
|
||||
* GNU-All-Permissive: `GNU All-Permissive
|
||||
License <http://www.gnu.org/prep/maintain/html_node/License-Notices-for-Other-Files.html>`__
|
||||
License <https://www.gnu.org/prep/maintain/html_node/License-Notices-for-Other-Files.html>`__
|
||||
* Apache-2.0: `Apache License, version
|
||||
2.0 <http://www.apache.org/licenses/LICENSE-2.0>`__
|
||||
2.0 <https://www.apache.org/licenses/LICENSE-2.0>`__
|
||||
|
||||
In addition, it is RECOMMENDED that literal code included in the ZIP be
|
||||
dual-licensed under the same license terms as the project it modifies.
|
||||
|
|
@ -574,19 +574,19 @@ Not recommended, but acceptable licenses
|
|||
----------------------------------------
|
||||
|
||||
* BSL-1.0: `Boost Software License, version
|
||||
1.0 <http://www.boost.org/LICENSE_1_0.txt>`__
|
||||
1.0 <https://www.boost.org/LICENSE_1_0.txt>`__
|
||||
* CC-BY-4.0: `Creative Commons Attribution 4.0
|
||||
International <https://creativecommons.org/licenses/by/4.0/>`__
|
||||
* CC-BY-SA-4.0: `Creative Commons Attribution-ShareAlike 4.0
|
||||
International <https://creativecommons.org/licenses/by-sa/4.0/>`__
|
||||
* AGPL-3.0+: `GNU Affero General Public License (AGPL), version 3 or
|
||||
newer <http://www.gnu.org/licenses/agpl-3.0.en.html>`__
|
||||
newer <https://www.gnu.org/licenses/agpl-3.0.en.html>`__
|
||||
* FDL-1.3: `GNU Free Documentation License, version
|
||||
1.3 <http://www.gnu.org/licenses/fdl-1.3.en.html>`__
|
||||
1.3 <https://www.gnu.org/licenses/fdl-1.3.en.html>`__
|
||||
* GPL-2.0+: `GNU General Public License (GPL), version 2 or
|
||||
newer <http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>`__
|
||||
newer <https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>`__
|
||||
* LGPL-2.1+: `GNU Lesser General Public License (LGPL), version 2.1 or
|
||||
newer <http://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html>`__
|
||||
newer <https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html>`__
|
||||
|
||||
Not acceptable licenses
|
||||
-----------------------
|
||||
|
|
@ -632,6 +632,6 @@ References
|
|||
.. [#RFC3552] `RFC 3552: Guidelines for Writing RFC Text on Security Considerations <https://www.rfc-editor.org/rfc/rfc3552.html>`_
|
||||
.. [#zip-0200] `ZIP 200: Network Upgrade Mechanism <zip-0200.rst>`_
|
||||
.. [#conduct] `Zcash Code of Conduct <https://github.com/zcash/zcash/blob/master/code_of_conduct.md>`_
|
||||
.. [#rst] `reStructuredText documentation <http://docutils.sourceforge.net/rst.html>`_
|
||||
.. [#rst] `reStructuredText documentation <https://docutils.sourceforge.io/rst.html>`_
|
||||
.. [#markdown] `The Markdown Guide <https://www.markdownguide.org/>`_
|
||||
.. [#latex] `LaTeX — a document preparation system <https://www.latex-project.org/>`_
|
||||
|
|
|
|||
|
|
@ -378,9 +378,9 @@ sighash: 23652e76cb13b85a0e3363bb5fca061fa791c40c533eccee899364e6e60bb4f7</pre>
|
|||
<th>4</th>
|
||||
<td>
|
||||
<ul>
|
||||
<li><a href="https://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-2013-2292">CVE-2013-2292</a></li>
|
||||
<li><a href="https://nvd.nist.gov/vuln/detail/CVE-2013-2292">CVE-2013-2292</a></li>
|
||||
<li><a href="https://bitcointalk.org/?topic=140078">New Bitcoin vulnerability: A transaction that takes at least 3 minutes to verify</a></li>
|
||||
<li><a href="http://rusty.ozlabs.org/?p=522">The Megatransaction: Why Does It Take 25 Seconds?</a></li>
|
||||
<li><a href="https://rusty.ozlabs.org/?p=522">The Megatransaction: Why Does It Take 25 Seconds?</a></li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
|
|
|
|||
|
|
@ -458,9 +458,9 @@ References
|
|||
.. [#protocol-sproutsend] `Zcash Protocol Specification, Version 2020.1.15. Section 4.6: Sending Notes (Sprout) <protocol/protocol.pdf#sproutsend>`_
|
||||
.. [#wiki-checksig] `OP\_CHECKSIG. Bitcoin Wiki <https://en.bitcoin.it/wiki/OP_CHECKSIG>`_
|
||||
.. [#quadratic]
|
||||
* `CVE-2013-2292 <https://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-2013-2292>`_
|
||||
* `CVE-2013-2292 <https://nvd.nist.gov/vuln/detail/CVE-2013-2292>`_
|
||||
* `New Bitcoin vulnerability: A transaction that takes at least 3 minutes to verify <https://bitcointalk.org/?topic=140078>`_
|
||||
* `The Megatransaction: Why Does It Take 25 Seconds? <http://rusty.ozlabs.org/?p=522>`_
|
||||
* `The Megatransaction: Why Does It Take 25 Seconds? <https://rusty.ozlabs.org/?p=522>`_
|
||||
.. [#offline-wallets] `SIGHASH_WITHINPUTVALUE: Super-lightweight HW wallets and offline data <https://bitcointalk.org/index.php?topic=181734.0>`_
|
||||
.. [#bip-0143] `BIP 143: Transaction Signature Verification for Version 0 Witness Program <https://github.com/bitcoin/bips/blob/master/bip-0143.mediawiki>`_
|
||||
.. [#buip-HF] `BUIP-HF Digest for replay protected signature verification across hard forks, version 1.2 <https://github.com/Bitcoin-ABC/bitcoin-abc/blob/master/doc/abc/replay-protected-sighash.md>`_
|
||||
|
|
|
|||
|
|
@ -276,7 +276,7 @@ CHECKSUM = H(".onion checksum" || PUBKEY || VERSION)[:2] // first 2 bytes</pre>
|
|||
<tbody>
|
||||
<tr>
|
||||
<th>12</th>
|
||||
<td><a href="https://github.com/cjdelisle/cjdns/blob/f909b960709a4e06730ddd4d221e5df38164dbb6/doc/Whitepaper.md#pulling-it-all-together">Cjdns whitepaper: Pulling It All Together</a></td>
|
||||
<td><a href="https://github.com/cjdelisle/cjdns/blob/f909b960709a4e06730ddd4d221e5df38164dbb6/doc/Whitepaper.md#user-content-pulling-it-all-together">Cjdns whitepaper: Pulling It All Together</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
|
|
|||
|
|
@ -246,4 +246,4 @@ References
|
|||
.. [#Tor-rendezvous-v3] `Tor Rendezvous Specification - Version 3 <https://gitweb.torproject.org/torspec.git/tree/rend-spec-v3.txt>`_
|
||||
.. [#NIST-SHA3] `NIST FIPS 202 - SHA-3 Standard: Permutation-Based Hash and Extendable-Output Functions <https://csrc.nist.gov/publications/detail/fips/202/final>`_
|
||||
.. [#I2P-naming] `I2P: Naming and address book <https://geti2p.net/en/docs/naming#base32>`_
|
||||
.. [#Cjdns-whitepaper] `Cjdns whitepaper: Pulling It All Together <https://github.com/cjdelisle/cjdns/blob/f909b960709a4e06730ddd4d221e5df38164dbb6/doc/Whitepaper.md#pulling-it-all-together>`_
|
||||
.. [#Cjdns-whitepaper] `Cjdns whitepaper: Pulling It All Together <https://github.com/cjdelisle/cjdns/blob/f909b960709a4e06730ddd4d221e5df38164dbb6/doc/Whitepaper.md#user-content-pulling-it-all-together>`_
|
||||
|
|
|
|||
|
|
@ -140,7 +140,7 @@ def bech32_verify_checksum(hrp, data):
|
|||
<p>The lowercase form is used when determining a character's value for checksum purposes.</p>
|
||||
<p>Encoders MUST always output an all-lowercase Bech32 string. If an uppercase version of the encoding result is desired (e.g. for presentation purposes, or QR code use), then an uppercasing procedure can be performed external to the encoding process.</p>
|
||||
<p>Decoders MUST NOT accept strings where some characters are uppercase and some are lowercase (such strings are referred to as mixed-case strings).</p>
|
||||
<p>For presentation, lowercase is usually preferable, but inside QR codes uppercase SHOULD be used, as those permit the use of <a href="http://www.thonky.com/qr-code-tutorial/alphanumeric-mode-encoding">alphanumeric mode</a>, which is 45% more compact than the <a href="http://www.thonky.com/qr-code-tutorial/byte-mode-encoding">byte mode</a> that would otherwise be used.</p>
|
||||
<p>For presentation, lowercase is usually preferable, but inside QR codes uppercase SHOULD be used, as those permit the use of <a href="https://www.thonky.com/qr-code-tutorial/alphanumeric-mode-encoding">alphanumeric mode</a>, which is 45% more compact than the <a href="https://www.thonky.com/qr-code-tutorial/byte-mode-encoding">byte mode</a> that would otherwise be used.</p>
|
||||
</section>
|
||||
<section id="encoding"><h4><span class="section-heading">Encoding</span><span class="section-anchor"> <a rel="bookmark" href="#encoding"><img width="24" height="24" src="assets/images/section-anchor.png" alt=""></a></span></h4>
|
||||
<ul>
|
||||
|
|
@ -207,7 +207,7 @@ def bech32_verify_checksum(hrp, data):
|
|||
</li>
|
||||
<li>Fancy decoder written for Bitcoin that localizes errors:
|
||||
<ul>
|
||||
<li><a href="https://github.com/sipa/bech32/tree/master/ecc/javascript">Fancy decoder for Javascript</a> (<a href="http://bitcoin.sipa.be/bech32/demo/demo.html">demo website</a>)</li>
|
||||
<li><a href="https://github.com/sipa/bech32/tree/master/ecc/javascript">Fancy decoder for Javascript</a> (<a href="HTTP://bitcoin.sipa.be/bech32/demo/demo.html">demo website</a>)</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
|
|
|
|||
|
|
@ -181,9 +181,9 @@ are lowercase (such strings are referred to as mixed-case strings).
|
|||
|
||||
For presentation, lowercase is usually preferable, but inside QR codes
|
||||
uppercase SHOULD be used, as those permit the use of `alphanumeric mode
|
||||
<http://www.thonky.com/qr-code-tutorial/alphanumeric-mode-encoding>`_,
|
||||
<https://www.thonky.com/qr-code-tutorial/alphanumeric-mode-encoding>`_,
|
||||
which is 45% more compact than the `byte mode
|
||||
<http://www.thonky.com/qr-code-tutorial/byte-mode-encoding>`_ that would
|
||||
<https://www.thonky.com/qr-code-tutorial/byte-mode-encoding>`_ that would
|
||||
otherwise be used.
|
||||
|
||||
Encoding
|
||||
|
|
@ -313,7 +313,7 @@ Reference implementations
|
|||
* Fancy decoder written for Bitcoin that localizes errors:
|
||||
|
||||
* `Fancy decoder for Javascript <https://github.com/sipa/bech32/tree/master/ecc/javascript>`_
|
||||
(`demo website <http://bitcoin.sipa.be/bech32/demo/demo.html>`_)
|
||||
(`demo website <HTTP://bitcoin.sipa.be/bech32/demo/demo.html>`_)
|
||||
|
||||
Note that the encoders written for Bitcoin may make assumptions specific to
|
||||
Segregated Witness address formats that do not apply to Zcash. Only the Python
|
||||
|
|
|
|||
|
|
@ -213,12 +213,16 @@ License: MIT</pre>
|
|||
</section>
|
||||
<section id="header-field"><h3><span class="section-heading">Header Field</span><span class="section-anchor"> <a rel="bookmark" href="#header-field"><img width="24" height="24" src="assets/images/section-anchor.png" alt=""></a></span></h3>
|
||||
<p>The first four bytes of pre-Overwinter and Overwinter transactions are little-endian encoded.</p>
|
||||
<p>Version 1 transaction (txid 5c6ba844e1ca1c8083cd53e29971bd82f1f9eea1f86c1763a22dd4ca183ae061 <a href="https://zcash.blockexplorer.com/tx/5c6ba844e1ca1c8083cd53e29971bd82f1f9eea1f86c1763a22dd4ca183ae061">https://zcash.blockexplorer.com/tx/5c6ba844e1ca1c8083cd53e29971bd82f1f9eea1f86c1763a22dd4ca183ae061</a>)</p>
|
||||
<p>Version 1 transaction (txid <a href="https://blockchair.com/zcash/transaction/5c6ba844e1ca1c8083cd53e29971bd82f1f9eea1f86c1763a22dd4ca183ae061">5c6ba844e1ca1c8083cd53e29971bd82f1f9eea1f86c1763a22dd4ca183ae061</a>)</p>
|
||||
<ul>
|
||||
<li>begins with little-endian byte sequence [0x01, 0x00, 0x00, 0x00];</li>
|
||||
<li>deserialized as 32-bit signed integer with decimal value of 1.</li>
|
||||
</ul>
|
||||
<p>Version 2 transaction (txid 4435bf8064e74f01262cb1725fd9b53e600fa285950163fd961bed3a64260d8b <a href="https://zcash.blockexplorer.com/tx/4435bf8064e74f01262cb1725fd9b53e600fa285950163fd961bed3a64260d8b">https://zcash.blockexplorer.com/tx/4435bf8064e74f01262cb1725fd9b53e600fa285950163fd961bed3a64260d8b</a>)</p>
|
||||
<p>Version 2 transaction (txid <a id="id9" class="problematic" href="#id8">`</a>4435bf8064e74f01262cb1725fd9b53e600fa285950163fd961bed3a64260d8b <<a href="https://blockchair.com/zcash/transaction/4435bf8064e74f01262cb1725fd9b53e600fa285950163fd961bed3a64260d8b">https://blockchair.com/zcash/transaction/4435bf8064e74f01262cb1725fd9b53e600fa285950163fd961bed3a64260d8b</a>>)</p>
|
||||
<div id="id8">
|
||||
<h1>System Message: WARNING/2 (zip-0202.rst line 110) <a href="#id9">id9</a></h1>
|
||||
<p>Inline interpreted text or phrase reference start-string without end-string.</p>
|
||||
</div>
|
||||
<ul>
|
||||
<li>begins with little-endian byte sequence [0x02, 0x00, 0x00, 0x00];</li>
|
||||
<li>deserialized as 32-bit signed integer with decimal value of 2.</li>
|
||||
|
|
@ -268,13 +272,13 @@ License: MIT</pre>
|
|||
<p>However, if a new transaction version can be correctly parsed according to the format of a preceding version (that is, it only restricts the format, or defines fields that were previously reserved and which old parsers can safely ignore), then the same version group ID MAY be re-used.</p>
|
||||
</section>
|
||||
<section id="expiry-height"><h3><span class="section-heading">Expiry Height</span><span class="section-anchor"> <a rel="bookmark" href="#expiry-height"><img width="24" height="24" src="assets/images/section-anchor.png" alt=""></a></span></h3>
|
||||
<p>The expiry height field, as defined in the Transaction Expiry ZIP <a id="id8" class="footnote_reference" href="#zip-0203">5</a>, stores the block height after which a transaction can no longer be mined.</p>
|
||||
<p>The expiry height field, as defined in the Transaction Expiry ZIP <a id="id10" class="footnote_reference" href="#zip-0203">5</a>, stores the block height after which a transaction can no longer be mined.</p>
|
||||
</section>
|
||||
<section id="transaction-validation"><h3><span class="section-heading">Transaction Validation</span><span class="section-anchor"> <a rel="bookmark" href="#transaction-validation"><img width="24" height="24" src="assets/images/section-anchor.png" alt=""></a></span></h3>
|
||||
<p>A valid Overwinter transaction intended for Zcash MUST have:</p>
|
||||
<ul>
|
||||
<li>version number 3; and</li>
|
||||
<li>version group ID 0x03C48270 <a id="id9" class="footnote_reference" href="#versiongroupid">6</a>; and</li>
|
||||
<li>version group ID 0x03C48270; and</li>
|
||||
<li><code>fOverwintered</code> flag set.</li>
|
||||
</ul>
|
||||
<p>Overwinter validators MUST reject transactions for violating consensus rules if:</p>
|
||||
|
|
@ -283,7 +287,7 @@ License: MIT</pre>
|
|||
<li>the version group ID is unknown; or</li>
|
||||
<li>the version number is unknown.</li>
|
||||
</ul>
|
||||
<p>Validation of version 3 transactions MUST use the signature validation process detailed in the Transaction Signature Validation for Overwinter ZIP <a id="id10" class="footnote_reference" href="#zip-0143">2</a>.</p>
|
||||
<p>Validation of version 3 transactions MUST use the signature validation process detailed in the Transaction Signature Validation for Overwinter ZIP <a id="id11" class="footnote_reference" href="#zip-0143">2</a>.</p>
|
||||
</section>
|
||||
</section>
|
||||
<section id="implementation"><h2><span class="section-heading">Implementation</span><span class="section-anchor"> <a rel="bookmark" href="#implementation"><img width="24" height="24" src="assets/images/section-anchor.png" alt=""></a></span></h2>
|
||||
|
|
@ -317,14 +321,14 @@ License: MIT</pre>
|
|||
}</pre>
|
||||
<p>It is expected that this test involving <code>nVersionGroupId</code> is only required when a transaction is being constructed or deserialized e.g. when an external transaction enters the system.</p>
|
||||
<p>However, it's possible that a clone of Zcash is using the same version group ID and passes the conditional.</p>
|
||||
<p>Ultimately, a client can determine if a transaction is truly intended for the client's chain or not by following the signature validation process detailed in the Transaction Signature Validation for Overwinter ZIP <a id="id11" class="footnote_reference" href="#zip-0143">2</a>.</p>
|
||||
<p>Ultimately, a client can determine if a transaction is truly intended for the client's chain or not by following the signature validation process detailed in the Transaction Signature Validation for Overwinter ZIP <a id="id12" class="footnote_reference" href="#zip-0143">2</a>.</p>
|
||||
</section>
|
||||
</section>
|
||||
<section id="deployment"><h2><span class="section-heading">Deployment</span><span class="section-anchor"> <a rel="bookmark" href="#deployment"><img width="24" height="24" src="assets/images/section-anchor.png" alt=""></a></span></h2>
|
||||
<p>This proposal will be deployed with the Overwinter network upgrade. The activation block height proposal is in <a id="id12" class="footnote_reference" href="#zip-0201">4</a>.</p>
|
||||
<p>This proposal will be deployed with the Overwinter network upgrade. The activation block height proposal is in <a id="id13" class="footnote_reference" href="#zip-0201">4</a>.</p>
|
||||
</section>
|
||||
<section id="backwards-compatibility"><h2><span class="section-heading">Backwards compatibility</span><span class="section-anchor"> <a rel="bookmark" href="#backwards-compatibility"><img width="24" height="24" src="assets/images/section-anchor.png" alt=""></a></span></h2>
|
||||
<p>This proposal intentionally creates what is known as a "bilateral consensus rule change" <a id="id13" class="footnote_reference" href="#zip-0200">3</a> between pre-Overwinter software and Overwinter-compatible software. Use of this new transaction format requires that all network participants upgrade their software to a compatible version within the upgrade window. Pre-Overwinter software will treat Overwinter transactions as invalid.</p>
|
||||
<p>This proposal intentionally creates what is known as a "bilateral consensus rule change" <a id="id14" class="footnote_reference" href="#zip-0200">3</a> between pre-Overwinter software and Overwinter-compatible software. Use of this new transaction format requires that all network participants upgrade their software to a compatible version within the upgrade window. Pre-Overwinter software will treat Overwinter transactions as invalid.</p>
|
||||
<p>Once Overwinter has activated, Overwinter-compatible software will reject version 1 and version 2 transactions, and will only accept transactions based upon supported transaction version numbers and recognized version group IDs.</p>
|
||||
</section>
|
||||
<section id="reference-implementation"><h2><span class="section-heading">Reference Implementation</span><span class="section-anchor"> <a rel="bookmark" href="#reference-implementation"><img width="24" height="24" src="assets/images/section-anchor.png" alt=""></a></span></h2>
|
||||
|
|
@ -371,14 +375,6 @@ License: MIT</pre>
|
|||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<table id="versiongroupid" class="footnote">
|
||||
<tbody>
|
||||
<tr>
|
||||
<th>6</th>
|
||||
<td><a href="https://github.com/zcash/zcash/pull/2925/files#diff-5cb8d9decaa15620a8f98b0c6c44da9bR311">OVERWINTER_VERSION_GROUP_ID</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</section>
|
||||
</section>
|
||||
</body>
|
||||
|
|
|
|||
|
|
@ -102,12 +102,12 @@ Header Field
|
|||
|
||||
The first four bytes of pre-Overwinter and Overwinter transactions are little-endian encoded.
|
||||
|
||||
Version 1 transaction (txid 5c6ba844e1ca1c8083cd53e29971bd82f1f9eea1f86c1763a22dd4ca183ae061 https://zcash.blockexplorer.com/tx/5c6ba844e1ca1c8083cd53e29971bd82f1f9eea1f86c1763a22dd4ca183ae061)
|
||||
Version 1 transaction (txid `5c6ba844e1ca1c8083cd53e29971bd82f1f9eea1f86c1763a22dd4ca183ae061 <https://blockchair.com/zcash/transaction/5c6ba844e1ca1c8083cd53e29971bd82f1f9eea1f86c1763a22dd4ca183ae061>`_)
|
||||
|
||||
* begins with little-endian byte sequence [0x01, 0x00, 0x00, 0x00];
|
||||
* deserialized as 32-bit signed integer with decimal value of 1.
|
||||
|
||||
Version 2 transaction (txid 4435bf8064e74f01262cb1725fd9b53e600fa285950163fd961bed3a64260d8b https://zcash.blockexplorer.com/tx/4435bf8064e74f01262cb1725fd9b53e600fa285950163fd961bed3a64260d8b)
|
||||
Version 2 transaction (txid `4435bf8064e74f01262cb1725fd9b53e600fa285950163fd961bed3a64260d8b <https://blockchair.com/zcash/transaction/4435bf8064e74f01262cb1725fd9b53e600fa285950163fd961bed3a64260d8b>)
|
||||
|
||||
* begins with little-endian byte sequence [0x02, 0x00, 0x00, 0x00];
|
||||
* deserialized as 32-bit signed integer with decimal value of 2.
|
||||
|
|
@ -183,7 +183,7 @@ Transaction Validation
|
|||
A valid Overwinter transaction intended for Zcash MUST have:
|
||||
|
||||
- version number 3; and
|
||||
- version group ID 0x03C48270 [#versiongroupid]_; and
|
||||
- version group ID 0x03C48270; and
|
||||
- ``fOverwintered`` flag set.
|
||||
|
||||
Overwinter validators MUST reject transactions for violating consensus rules if:
|
||||
|
|
@ -286,4 +286,3 @@ References
|
|||
.. [#zip-0200] `ZIP 200: Network Upgrade Mechanism <zip-0200.rst>`_
|
||||
.. [#zip-0201] `ZIP 201: Network Handshaking for Overwinter <zip-0201.rst>`_
|
||||
.. [#zip-0203] `ZIP 203: Transaction Expiry <zip-0203.rst>`_
|
||||
.. [#versiongroupid] `OVERWINTER_VERSION_GROUP_ID <https://github.com/zcash/zcash/pull/2925/files#diff-5cb8d9decaa15620a8f98b0c6c44da9bR311>`_
|
||||
|
|
|
|||
|
|
@ -122,7 +122,7 @@ License: MIT</pre>
|
|||
<tbody>
|
||||
<tr>
|
||||
<th>8</th>
|
||||
<td><a href="http://zerocash-project.org/media/pdf/zerocash-extended-20140518.pdf">Zerocash: Decentralized Anonymous Payments from Bitcoin (extended version)</a></td>
|
||||
<td><a href="https://eprint.iacr.org/2014/349">Zerocash: Decentralized Anonymous Payments from Bitcoin (extended version)</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
|
|
|||
|
|
@ -150,5 +150,5 @@ References
|
|||
.. [#zip-0209] `ZIP 209: Prohibit Negative Shielded Value Pool <zip-0209.rst>`_
|
||||
.. [#zip-0251] `ZIP 251: Deployment of the Canopy Network Upgrade <zip-0251.rst>`_
|
||||
.. [#zip-0308] `ZIP 308: Sprout to Sapling Migration <zip-0308.rst>`_
|
||||
.. [#zerocash] `Zerocash: Decentralized Anonymous Payments from Bitcoin (extended version) <http://zerocash-project.org/media/pdf/zerocash-extended-20140518.pdf>`_
|
||||
.. [#zerocash] `Zerocash: Decentralized Anonymous Payments from Bitcoin (extended version) <https://eprint.iacr.org/2014/349>`_
|
||||
.. [#counterfeiting] `Zcash Counterfeiting Vulnerability Successfully Remediated <https://electriccoin.co/blog/zcash-counterfeiting-vulnerability-successfully-remediated/>`_
|
||||
|
|
|
|||
|
|
@ -322,7 +322,7 @@ Discussions-To: <<a href="https://github.com/zcash/zips/issues/400">https://g
|
|||
<tbody>
|
||||
<tr>
|
||||
<th>15</th>
|
||||
<td><a href="https://crates.io/crates/jubjub">jubjub Rust crate</a></td>
|
||||
<td><a href="https://github.com/zkcrypto/jubjub">jubjub Rust crate</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
|
|
|||
|
|
@ -228,4 +228,4 @@ References
|
|||
.. [#zip-0200] `ZIP 200: Network Upgrade Mechanism <zip-0200.rst>`_
|
||||
.. [#zip-0215] `ZIP 215: Explicitly Defining and Modifying Ed25519 Validation Rules <zip-0215.rst>`_
|
||||
.. [#zip-0251] `ZIP 251: Deployment of the Canopy Network Upgrade <zip-0251.rst>`_
|
||||
.. [#jubjub-crate] `jubjub Rust crate <https://crates.io/crates/jubjub>`_
|
||||
.. [#jubjub-crate] `jubjub Rust crate <https://github.com/zkcrypto/jubjub>`_
|
||||
|
|
|
|||
|
|
@ -650,13 +650,13 @@ License: MIT</pre>
|
|||
<section id="additional-reading"><h2><span class="section-heading">Additional Reading</span><span class="section-anchor"> <a rel="bookmark" href="#additional-reading"><img width="24" height="24" src="assets/images/section-anchor.png" alt=""></a></span></h2>
|
||||
<ul>
|
||||
<li><a href="https://github.com/mahdiz/flyeth">Flyclient enabled geth fork by FlyClient authors</a></li>
|
||||
<li><a href="https://github.com/etclabscore/ECIPs/pull/11/files?short_path=44c106e#diff-44c106ea0ef54fab09596596934d3d15">ECIP-1055: Succinct PoW Using Merkle Mountain Ranges</a></li>
|
||||
<li><a href="https://github.com/mimblewimble/grin/tree/milestone/2.0.0/core/src/core">Grin project MMR implementation in Rust</a></li>
|
||||
<li><a href="https://github.com/tari-project/tari/tree/development/infrastructure/merklemountainrange">Tari Project MMR implementation in Rust</a></li>
|
||||
<li><a href="https://github.com/etclabscore/ECIPs/blob/f37acdbb392e18a61c8a6600ca1c4a2edee5813d/ECLIPs/ECIP-draft_succinct-proofs.md">Draft ECIP-1055: Succinct PoW Using Merkle Mountain Ranges</a></li>
|
||||
<li><a href="https://github.com/mimblewimble/grin/tree/master/core/src/core/pmmr">Grin project MMR implementation in Rust</a></li>
|
||||
<li><a href="https://github.com/tari-project/tari/tree/development/base_layer/mmr">Tari Project MMR implementation in Rust</a></li>
|
||||
<li><a href="https://github.com/BeamMW/beam/blob/master/core/merkle.cpp">Beam Project MMR implementation in C++</a></li>
|
||||
<li><a href="https://github.com/mimblewimble/grin/blob/master/doc/mmr.md">Mimblewimble MMR docs</a></li>
|
||||
<li><a href="https://github.com/proofchains/python-proofmarshal/blob/master/proofmarshal/mmr.py">MMR Python implementation</a></li>
|
||||
<li><a href="https://docs.rs/merklemountainrange/0.0.1/src/merklemountainrange/lib.rs.html#23-183">Tari MMR documentation</a></li>
|
||||
<li><a href="https://docs.rs/merklemountainrange/0.0.1/src/merklemountainrange/lib.rs.html">Tari MMR documentation</a></li>
|
||||
<li><a href="https://zips.z.cash/protocol/protocol.pdf">Zcash Protocol Specification, Version 2020.1.1 [Overwinter+Sapling+Blossom] or later</a></li>
|
||||
<li><a href="https://github.com/opentimestamps/opentimestamps-server/blob/master/doc/merkle-mountain-range.md">opentimestamps-server Merkle Mountain Range documentation</a></li>
|
||||
</ul>
|
||||
|
|
|
|||
|
|
@ -813,13 +813,13 @@ Additional Reading
|
|||
==================
|
||||
|
||||
- `Flyclient enabled geth fork by FlyClient authors <https://github.com/mahdiz/flyeth>`_
|
||||
- `ECIP-1055: Succinct PoW Using Merkle Mountain Ranges <https://github.com/etclabscore/ECIPs/pull/11/files?short_path=44c106e#diff-44c106ea0ef54fab09596596934d3d15>`_
|
||||
- `Grin project MMR implementation in Rust <https://github.com/mimblewimble/grin/tree/milestone/2.0.0/core/src/core>`_
|
||||
- `Tari Project MMR implementation in Rust <https://github.com/tari-project/tari/tree/development/infrastructure/merklemountainrange>`_
|
||||
- `Draft ECIP-1055: Succinct PoW Using Merkle Mountain Ranges <https://github.com/etclabscore/ECIPs/blob/f37acdbb392e18a61c8a6600ca1c4a2edee5813d/ECLIPs/ECIP-draft_succinct-proofs.md>`_
|
||||
- `Grin project MMR implementation in Rust <https://github.com/mimblewimble/grin/tree/master/core/src/core/pmmr>`_
|
||||
- `Tari Project MMR implementation in Rust <https://github.com/tari-project/tari/tree/development/base_layer/mmr>`_
|
||||
- `Beam Project MMR implementation in C++ <https://github.com/BeamMW/beam/blob/master/core/merkle.cpp>`_
|
||||
- `Mimblewimble MMR docs <https://github.com/mimblewimble/grin/blob/master/doc/mmr.md>`_
|
||||
- `MMR Python implementation <https://github.com/proofchains/python-proofmarshal/blob/master/proofmarshal/mmr.py>`_
|
||||
- `Tari MMR documentation <https://docs.rs/merklemountainrange/0.0.1/src/merklemountainrange/lib.rs.html#23-183>`_
|
||||
- `Tari MMR documentation <https://docs.rs/merklemountainrange/0.0.1/src/merklemountainrange/lib.rs.html>`_
|
||||
- `Zcash Protocol Specification, Version 2020.1.1 [Overwinter+Sapling+Blossom] or later <https://zips.z.cash/protocol/protocol.pdf>`_
|
||||
- `opentimestamps-server Merkle Mountain Range documentation <https://github.com/opentimestamps/opentimestamps-server/blob/master/doc/merkle-mountain-range.md>`_
|
||||
|
||||
|
|
|
|||
|
|
@ -418,7 +418,7 @@ License: MIT</pre>
|
|||
<tbody>
|
||||
<tr>
|
||||
<th>10</th>
|
||||
<td><a href="http://www.jsonrpc.org/specification">JSON-RPC 2.0 Specification. The JSON-RPC Working Group.</a></td>
|
||||
<td><a href="https://www.jsonrpc.org/specification">JSON-RPC 2.0 Specification. The JSON-RPC Working Group.</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
|
|
|||
|
|
@ -497,4 +497,4 @@ References
|
|||
.. [#Bitcoin-Block] `Block Headers - Bitcoin Developer Reference. <https://developer.bitcoin.org/reference/block_chain.html#block-headers>`_
|
||||
.. [#Bitcoin-CompactSize] `Variable length integer. Bitcoin Wiki <https://en.bitcoin.it/wiki/Protocol_documentation#Variable_length_integer>`_
|
||||
.. [#JSON-RPC-1.0] `JSON-RPC 1.0 Specification (2005). <https://www.jsonrpc.org/specification_v1>`_
|
||||
.. [#JSON-RPC-2.0] `JSON-RPC 2.0 Specification. The JSON-RPC Working Group. <http://www.jsonrpc.org/specification>`_
|
||||
.. [#JSON-RPC-2.0] `JSON-RPC 2.0 Specification. The JSON-RPC Working Group. <https://www.jsonrpc.org/specification>`_
|
||||
|
|
|
|||
|
|
@ -77,7 +77,7 @@ Pull-Request: <<a href="https://github.com/zcash/zips/pull/105">https://githu
|
|||
<tbody>
|
||||
<tr>
|
||||
<th>2</th>
|
||||
<td><a href="https://tools.ietf.org/html/rfc3629">UTF-8, a transformation format of ISO 10646</a></td>
|
||||
<td><a href="https://www.rfc-editor.org/rfc/rfc3629.html">UTF-8, a transformation format of ISO 10646</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
|
|
|||
|
|
@ -96,5 +96,5 @@ References
|
|||
==========
|
||||
|
||||
.. [#protocol] `Zcash Protocol Specification, Version 2021.1.19 <protocol/protocol.pdf>`_
|
||||
.. [#UTF-8] `UTF-8, a transformation format of ISO 10646 <https://tools.ietf.org/html/rfc3629>`_
|
||||
.. [#UTF-8] `UTF-8, a transformation format of ISO 10646 <https://www.rfc-editor.org/rfc/rfc3629.html>`_
|
||||
.. [#Bitcoin-CompactSize] `Variable length integer. Bitcoin Wiki <https://en.bitcoin.it/wiki/Protocol_documentation#Variable_length_integer>`_
|
||||
|
|
|
|||
|
|
@ -15,7 +15,7 @@ Credits: Ian Miers
|
|||
Status: Reserved
|
||||
Category: Standards / Ecosystem
|
||||
Created: 2019-07-15
|
||||
Discussions-To: <<a href="https://github.com/zcash/zips/issues/2353">https://github.com/zcash/zips/issues/2353</a>>
|
||||
Discussions-To: <<a href="https://github.com/zcash/zcash/issues/2353">https://github.com/zcash/zcash/issues/2353</a>>
|
||||
Pull-Request: <<a href="https://github.com/zcash/zips/pull/216">https://github.com/zcash/zips/pull/216</a>></pre>
|
||||
</section>
|
||||
</body>
|
||||
|
|
|
|||
|
|
@ -9,5 +9,5 @@
|
|||
Status: Reserved
|
||||
Category: Standards / Ecosystem
|
||||
Created: 2019-07-15
|
||||
Discussions-To: <https://github.com/zcash/zips/issues/2353>
|
||||
Discussions-To: <https://github.com/zcash/zcash/issues/2353>
|
||||
Pull-Request: <https://github.com/zcash/zips/pull/216>
|
||||
|
|
|
|||
|
|
@ -19,7 +19,7 @@ Status: Obsolete
|
|||
Category: Consensus Process
|
||||
Created: 2019-08-31
|
||||
License: MIT
|
||||
Discussions-To: <<a href="https://forum.zcashcommunity.com/t/a-grand-compromise-synthesis-zip-proposal/34812/">https://forum.zcashcommunity.com/t/a-grand-compromise-synthesis-zip-proposal/34812/</a>></pre>
|
||||
Discussions-To: <<a href="https://forum.zcashcommunity.com/t/a-grand-compromise-synthesis-zip-proposal/34812">https://forum.zcashcommunity.com/t/a-grand-compromise-synthesis-zip-proposal/34812</a>></pre>
|
||||
<section id="terminology"><h2><span class="section-heading">Terminology</span><span class="section-anchor"> <a rel="bookmark" href="#terminology"><img width="24" height="24" src="assets/images/section-anchor.png" alt=""></a></span></h2>
|
||||
<p>The key words "MUST", "MUST NOT", "SHOULD", and "SHOULD NOT" in this document are to be interpreted as described in RFC 2119. <a id="id1" class="footnote_reference" href="#rfc2119">1</a></p>
|
||||
<p>The term "network upgrade" in this document is to be interpreted as described in ZIP 200. <a id="id2" class="footnote_reference" href="#zip-0200">2</a></p>
|
||||
|
|
|
|||
|
|
@ -13,7 +13,7 @@
|
|||
Category: Consensus Process
|
||||
Created: 2019-08-31
|
||||
License: MIT
|
||||
Discussions-To: <https://forum.zcashcommunity.com/t/a-grand-compromise-synthesis-zip-proposal/34812/>
|
||||
Discussions-To: <https://forum.zcashcommunity.com/t/a-grand-compromise-synthesis-zip-proposal/34812>
|
||||
|
||||
|
||||
Terminology
|
||||
|
|
|
|||
|
|
@ -234,7 +234,7 @@ Pull-Request: <<a href="https://github.com/zcash/zips/pull/308">https://githu
|
|||
<tbody>
|
||||
<tr>
|
||||
<th>12</th>
|
||||
<td><a href="https://uscode.house.gov/view.xhtml?req=granuleid:USC-prelim-title26-section501&num=0&edition=prelim">U.S. Code, Title 26, Section 501(c)(3)</a></td>
|
||||
<td><a href="https://www.law.cornell.edu/uscode/text/26/501">U.S. Code, Title 26, Section 501(c)(3)</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
|
|
|||
|
|
@ -409,4 +409,4 @@ References
|
|||
.. [#zip-1011] `ZIP 1011: Decentralize the Dev Fee <zip-1011.rst>`_
|
||||
.. [#zip-1012] `ZIP 1012: Dev Fund to ECC + ZF + Major Grants <zip-1012.rst>`_
|
||||
.. [#zf-community] `ZF Community Advisory Panel <https://www.zfnd.org/governance/community-advisory-panel/>`_
|
||||
.. [#section501c3] `U.S. Code, Title 26, Section 501(c)(3) <https://uscode.house.gov/view.xhtml?req=granuleid:USC-prelim-title26-section501&num=0&edition=prelim>`_
|
||||
.. [#section501c3] `U.S. Code, Title 26, Section 501(c)(3) <https://www.law.cornell.edu/uscode/text/26/501>`_
|
||||
|
|
|
|||
|
|
@ -98,11 +98,11 @@ sudo pip3 install rst2html5</pre>
|
|||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<table id="zip-xxxx" class="footnote">
|
||||
<table id="zip-0000" class="footnote">
|
||||
<tbody>
|
||||
<tr>
|
||||
<th>4</th>
|
||||
<td><a href="zip-xxxx">ZIP xxxx: Title</a></td>
|
||||
<td><a href="zip-0000">ZIP 0: ZIP Process</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
|
|
|||
|
|
@ -141,4 +141,4 @@ References
|
|||
.. [#RFC2119] `RFC 2119: Key words for use in RFCs to Indicate Requirement Levels <https://www.rfc-editor.org/rfc/rfc2119.html>`_
|
||||
.. [#protocol] `Zcash Protocol Specification, Version 2020.1.24 or later <protocol/protocol.pdf>`_
|
||||
.. [#protocol-introduction] `Zcash Protocol Specification, Version 2020.1.24. Section 1: Introduction <protocol/protocol.pdf#introduction>`_
|
||||
.. [#zip-xxxx] `ZIP xxxx: Title <zip-xxxx.rst>`_
|
||||
.. [#zip-0000] `ZIP 0: ZIP Process <zip-0000.rst>`_
|
||||
|
|
|
|||
Loading…
Reference in New Issue