Add Single-Use Reply Block (SURB) Functionality (exit ≠ destination) #50
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
This PR introduces Single-Use Reply Blocks (SURB) functionality to the Mix protocol for the case where the exit node is not the destination.
Summary of changes
Added SURB implementation functions:
createSURB: Creates a single-use reply block.useSURB: Encrypts a reply message, attaches a given SURB to it, and creates a response Sphinx packet.processReply: Decrypts and extracts the message from a reply payload.Refactored Sphinx packet construction logic:
computeBetaGammaDeltaintocomputeBetaGammaandcomputeDeltafor modularity and reuse across SURB operations.Added comprehensive unit tests:
Motivation
SURBs enable anonymous replies and ACKs in the Mix protocol without revealing sender identity.
Target branch: Waku branch
Related: Core SURB integration, Issue #41, and PR #51