From 130a2954c2d863620a0af97a8aa51a9aae8e4294 Mon Sep 17 00:00:00 2001 From: Kris Nuttycombe Date: Wed, 20 May 2026 11:57:18 -0600 Subject: [PATCH] ZIP 321: Add Deployment section. ZIP 321 has been Active since its initial publication; this commit adds an explicit Deployment section describing its existing deployment in production wallets and noting that the req-asset extension is not yet deployed pending ZIP 227 activation. Closes zcash/zips#937. Co-Authored-By: Claude Opus 4.7 (1M context) --- README.rst | 2 -- zips/zip-0321.rst | 18 ++++++++++++++++++ 2 files changed, 18 insertions(+), 2 deletions(-) diff --git a/README.rst b/README.rst index db775dc4f..8bbfb414e 100644 --- a/README.rst +++ b/README.rst @@ -198,7 +198,6 @@ written. 312 FROST for Spend Authorization Multisignatures Draft zips#382 314 Privacy upgrades to the Zcash light client protocol Reserved zips#434 315 Best Practices for Wallet Implementations Draft zips#447 - 318 Associated Payload Encryption Reserved zips#633 319 Options for Shielded Pool Retirement Reserved zips#635 322 Generic Signed Message Format Reserved zips#429 323 Specification of getblocktemplate for Zcash Reserved zips#405 @@ -355,7 +354,6 @@ Index of ZIPs 315 Best Practices for Wallet Implementations Draft 316 Unified Addresses and Unified Viewing Keys [Revision 0] Active, [Revision 1] Withdrawn, [Revision 2] Draft 317 Proportional Transfer Fee Mechanism Active - 318 Associated Payload Encryption Reserved 319 Options for Shielded Pool Retirement Reserved 320 Defining an Address Type to which funds can only be sent from Transparent Addresses Active 321 Payment Request URIs Active diff --git a/zips/zip-0321.rst b/zips/zip-0321.rst index 9be1a94de..3a1d5e649 100644 --- a/zips/zip-0321.rst +++ b/zips/zip-0321.rst @@ -449,6 +449,23 @@ query parameter rather than in the ``hier-part`` of the URI. They may also not support the ``memo`` parameter, or may not treat it as base64url-encoded. +Deployment +========== + +ZIP 321 payment request URIs are widely deployed in the Zcash ecosystem. +A reference implementation of parsing and construction of ZIP 321 URIs (for +the ZEC-only subset of the format, excluding the ``req-asset`` extension) is +provided by the ``zip321`` crate in the ``librustzcash`` repository +[#librustzcash-zip321]_, and is used by wallets built on the +``zcash_client_backend`` library. Support for ZIP 321 URIs has shipped in +production wallets including Zashi, Nighthawk Wallet, Edge, Unstoppable +Wallet, YWallet, and (historically) ZecWallet Lite, among others, and is +commonly relied upon for generating QR codes and clickable payment links. + +The ``req-asset`` extension for Custom Asset payments described in this ZIP +is not yet deployed, pending the activation of ZIP 227 [#zip-0227]_. + + References ========== @@ -463,6 +480,7 @@ References .. [#zip-0173] `ZIP 173: Bech32 Format `_ .. [#zip-0211] `ZIP 211: Disabling Addition of New Value to the Sprout Value Pool `_ .. [#zip-0227] `ZIP 227: Issuance of Zcash Shielded Assets `_ +.. [#librustzcash-zip321] `librustzcash: zip321 crate `_ .. [#zip-0227-asset-identifier] `ZIP 227: Issuance of Zcash Shielded Assets — Asset Identifier `_ .. [#zip-0316] `ZIP 316: Unified Addresses and Unified Viewing Keys `_ .. [#protocol-networks] `Zcash Protocol Specification, Version 2023.4.0. Section 3.11: Mainnet and Testnet `_