Skip to content

Commit b202868

Browse files
nuttycomclaude
andcommitted
[ZIP 227]: Register ZIP 248 bundle type.
- Register ZSA Issuance bundle type in the V6 bundle registry - Update digest section to reference effects_bundles_digest and auth_bundles_digest - Add reference to extensible transaction format ZIP - Remove unused ZIP 244 and ZIP 246 references Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 483b335 commit b202868

File tree

1 file changed

+33
-7
lines changed

1 file changed

+33
-7
lines changed

zips/zip-0227.rst

Lines changed: 33 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -308,6 +308,28 @@ where $\mathsf{GroupHash}^\mathbb{P}$ is defined as in [#protocol-concretegrouph
308308
Diagram relating the Issuer identifier, asset description, asset description hash, Asset Identifier, Asset Digest, and Asset Base for the OrchardZSA Protocol.
309309

310310

311+
Bundle Type Registration
312+
========================
313+
314+
This ZIP registers the ZSA Issuance bundle type in the V6 transaction bundle
315+
type registry defined in ZIP 248 [#zip-0248]_:
316+
317+
+------------+----------------------+--------------------+------------------+--------------+
318+
| BundleType | ``mValuePoolDeltas`` | ``mEffectBundles`` | ``mAuthBundles`` | Bundle kind |
319+
+============+======================+====================+==================+==============+
320+
| TBD |✅ |✅ |✅ | ZSA Issuance |
321+
+------------+----------------------+--------------------+------------------+--------------+
322+
323+
The ZSA Issuance bundle has value pool deltas (issuance adds value to the
324+
transparent transaction value pool for Custom Assets), effecting data (the
325+
issuance actions and issue notes), and authorizing data (the issuance
326+
authorization signature).
327+
328+
The effecting data for the ZSA Issuance bundle is encoded as specified in
329+
`Issuance Bundle`_. The authorizing data consists of the ``issueAuthSig``
330+
field.
331+
332+
311333
Specification: Issue Note, Issuance Action, Issuance Bundle and Issuance Protocol
312334
=================================================================================
313335

@@ -593,12 +615,17 @@ Concrete Applications
593615

594616

595617

596-
Modifications relative to ZIP 244 [#zip-0244]_
597-
==============================================
618+
Modifications to Digest Algorithms
619+
==================================
620+
621+
The ZSA Issuance bundle contributes to the transaction identifier and signature
622+
digest via the ``effects_bundles_digest`` and ``auth_bundles_digest`` defined
623+
in ZIP 248 [#zip-0248]_.
598624

599-
Relative to the sighash algorithm defined in ZIP 244, the sighash algorithm
600-
that applies to v6 transactions differs by including the issuance bundle
601-
components within the tree hash. See ZIP 246 [#zip-0246]_ for details.
625+
The issuance bundle's value pool deltas are committed via
626+
``value_pool_deltas_digest``. The issuance effecting data (issuance actions and
627+
issue notes) is committed via ``effects_bundles_digest``. The issuance
628+
authorization signature is committed via ``auth_bundles_digest``.
602629

603630

604631
Changes to ZIP 317 [#zip-0317]_
@@ -695,8 +722,7 @@ References
695722
.. [#zip-0230-issuance-action-description] `ZIP 230: Version 6 Transaction Format — Issuance Action Description (IssueAction) <zip-0230.rst#issuance-action-description-issueaction>`_
696723
.. [#zip-0230-issue-note] `ZIP 230: Version 6 Transaction Format — Issue Note Description (IssueNoteDescription) <zip-0230.rst#issue-note-description-issuenotedescription>`_
697724
.. [#zip-0230-transaction-format] `ZIP 230: Version 6 Transaction Format — Transaction Format <zip-0230.rst#transaction-format>`_
698-
.. [#zip-0244] `ZIP 244: Transaction Identifier Non-Malleability <zip-0244.rst>`_
699-
.. [#zip-0246] `ZIP 246: Digests for the Version 6 Transaction Format <zip-0246.rst>`_
725+
.. [#zip-0248] `ZIP 248: Extensible Transaction Format <zip-0248.rst>`_
700726
.. [#zip-0317] `ZIP 317: Proportional Transfer Fee Mechanism <zip-0317.rst>`_
701727
.. [#zip-0317-fee-calculation] `ZIP 317: Proportional Transfer Fee Mechanism — Fee calculation <zip-0317.rst#fee-calculation>`_
702728
.. [#bip-0043] `BIP 43: Purpose Field for Deterministic Wallets <https://github.com/bitcoin/bips/blob/master/bip-0043.mediawiki>`_

0 commit comments

Comments
 (0)