Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ZIP 316 updates for Unified Raw Encodings #660

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

daira
Copy link
Collaborator

@daira daira commented Jan 11, 2023

Signed-off-by: Daira Hopwood [email protected]

zip-0316.rst Outdated Show resolved Hide resolved
zip-0316.rst Outdated Show resolved Hide resolved
@daira daira changed the title ZIP 316 updates (WIP) ZIP 316 updates for Unified Raw Encodings Mar 21, 2023
@daira daira marked this pull request as ready for review March 21, 2023 14:39

There are well-defined transformations between the Unified QR Encoding,
Unified String Encoding, and Unified Raw Encoding of a given UA/UVK in
any direction.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Separately say that there is a UQRE <-> USE correspondence and a USE <-> URE correspondence.

Similarly, a Unified Full Viewing Key or Unified Incoming Viewing Key
provides the corresponding visibility into transactions that may use
addresses of different types. Typically these will be the addresses
for each pool derived from an Account as defined in [#zip-0032-specification-wallet-usage]_.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
for each pool derived from an Account as defined in [#zip-0032-specification-wallet-usage]_.
for each pool derived for an Account as defined in [#zip-0032-specification-wallet-usage]_.

addresses of different types. Typically these will be the addresses
for each pool derived from an Account as defined in [#zip-0032-specification-wallet-usage]_.
(It is not possible for a UVK to include viewing keys for multiple
addresses of the same type.)
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
addresses of the same type.)
addresses associated with the same pool.)

(i.e. the remainder of the Unified Raw Encoding after the Binary HRP).

2. Let :math:`\mathtt{padded\_hrp}` be :math:`\mathtt{hrp}` padded to
16 bytes with zero bytes.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
16 bytes with zero bytes.
16 bytes with bytes of value 0.

supported (for example, a Testnet HRP for a Consumer that only supports
Mainnet), reject.
2. Let :math:`\mathtt{expected\_padded\_hrp}` be the US-ASCII-encoded HRP,
padded to 16 bytes with zero bytes.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
padded to 16 bytes with zero bytes.
padded to 16 bytes with bytes of value 0.

Copy link
Contributor

@dconnolly dconnolly left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

approved via ZIP editors review

Copy link
Collaborator Author

@daira daira left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This was reviewed in ZIP sync with @dconnolly, @nuttycom, @sellout, @teor2345, and me present.

Comment on lines +264 to +266
There are well-defined transformations between the Unified QR Encoding,
Unified String Encoding, and Unified Raw Encoding of a given UA/UVK in
any direction.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
There are well-defined transformations between the Unified QR Encoding,
Unified String Encoding, and Unified Raw Encoding of a given UA/UVK in
any direction.
There are well-defined bidirectional transformations between the
Unified String Encoding and Unified Raw Encoding, and between the
Unified String Encoding and Unified QR Encoding of a given UA or UVK.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants