Skip to content

ZSA integration (cumulative steps 1–7): up to Orchard ZSA consensus modifications (copy 2)#43

Closed
dmidem wants to merge 258 commits into
zsa1from
zsa-integration-consensus
Closed

ZSA integration (cumulative steps 1–7): up to Orchard ZSA consensus modifications (copy 2)#43
dmidem wants to merge 258 commits into
zsa1from
zsa-integration-consensus

Conversation

@dmidem
Copy link
Copy Markdown
Collaborator

@dmidem dmidem commented Mar 3, 2025

This pull request merges the changes from several incremental PRs into one cumulative set of updates on top of the zsa1 branch. It introduces ZSA-compatible crates, Network Upgrade 7 (Nu7), initial Transaction V6 support, Orchard generics for ZSA, property-based testing enhancements, note commitment handling for ZSA issuance, and initial consensus modifications for Orchard ZSA.

It does not include the final state management changes or additional tests — those come in subsequent PRs.

Below is a high-level overview of the merged changes:

  1. ZSA-Compatible Crates Integration (Step 1)
    ZSA integration (step 1): Integrate ZSA-compatible crates into Zebra while maintaining original Orchard (Vanilla) support for now [to upstream] #24:

    • Replaces core libraries (halo2, zcash_note_encryption, etc.) with QED-it’s ZSA-compatible forks.
    • Maintains full support for Orchard “Vanilla” without activating any new ZSA features yet.
  2. Network Upgrade 7 (Nu7) Support (Step 2)
    ZSA integration (step 2): Add Network Upgrade 7 (Nu7) support to Zebra #15

    • Introduces code paths and placeholders for Nu7, the upcoming network upgrade required for ZSA.
    • Adds FIXME comments where final activation heights and other specifics must be filled in.
  3. Transaction V6 Foundations (Step 3)
    ZSA integration (step 3): Add initial Transaction V6 support to Zebra (currently copies V5 behavior) #16

    • Adds a V6 variant to Zebra’s Transaction enum, initially mirroring V5 logic.
    • Sets a baseline for future ZSA-related modifications, including placeholders for relevant fields and logic.
  4. Refactor Orchard Structures to Generics (Step 4)
    ZSA integration (step 4): Refactor Orchard structures to generics and add Orchard ZSA support for Transaction V6 #17

    • Converts key Orchard data structures (e.g., ShieldedData) to generics, enabling a single code path for both Orchard Vanilla and Orchard ZSA.
    • Implements serialization/deserialization for V6 transactions, including a burn field in the ZSA flavor.
  5. Orchard Proptests with ZSA Enhancements (Step 5)
    ZSA integration (step 5): Modify Orchard proptest implementations to support ZSA #18

    • Extends the property-based testing framework to handle ZSA-specific fields and behaviors in Transaction V6.
    • Refactors code organization (e.g., extracting Burn types) for better clarity and future expansion.
  6. Integration of ZSA Issuance Commitments (Step 6)
    ZSA integration (step 6): Integrate Orchard ZSA Issuance note commitments with Shielded Data action commitments for V6 transactions #25

    • Merges issuance action note commitments with existing shielded data commitments for V6 transactions.
    • Ensures Transaction::orchard_note_commitments includes issuance note commitments when present, preserving V5 behavior.
  7. Initial ZSA Consensus Support (Step 7)
    ZSA integration (step 7): Modify zebra-consensus to support Orchard ZSA #28

    • Modifies zebra-consensus to support Orchard ZSA.

Next Steps

  • State Management & Additional Testing: Future PRs will introduce state-layer modifications, refine consensus checks, and add more comprehensive tests.

By consolidating these first several steps into a single PR, we aim to simplify the review process .

…(without unit tests fixing for now).

- Refactored `ShieldedData` and `Action` structures to be generics parameterized by Orchard flavor
  (`OrchardVanilla` or `OrchardZSA`), enabling support for both Orchard protocols in Tx V6.
- Introduced a `burn` field in `ShieldedData` to support ZSA, with unit type for Tx V5 and a vector of burn items for Tx V6.
- Modified `Transaction` enum methods (orchard_...) to handle generics properly, ensuring compatibility with both Orchard flavors.
- Implemented serialization and deserialization for Tx V6 while avoiding code redundancy with Tx V5 wherever possible.
… explicit imlps as const generic are stabilized
@dmidem dmidem closed this Mar 3, 2025
@dmidem dmidem changed the title ZSA integration (cumulative steps 1–7): up to Orchard ZSA consensus modifications ZSA integration (cumulative steps 1–7): up to Orchard ZSA consensus modifications (copy 2) Mar 3, 2025
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.

1 participant