[RFC] bolt12: add BLIP-42 contact support #732
Draft
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This adds support for BLIP-42, enabling bidirectional contact establishment between payers and payees in BOLT12 payments. Sender side: - Add `send_with_contact` and `send_using_amount_with_contact` methods to `Bolt12Payment` that accept optional `ContactSecrets` and a payer offer to include in the invoice request. Receiver side: - Extend `Event::PaymentReceived` with `contact_secret` and `payer_offer` fields, which are extracted from incoming BOLT12 payments when present. The implementation is stateless - ldk-node surfaces the BLIP-42 data to the application layer without managing contact state internally. See BLIP-42: https://github.com/lightning/blips/blob/master/blip-0042.md Signed-off-by: Vincenzo Palazzo <[email protected]>
Adds `create_contact_offer` method to `Bolt12Payment` that creates compact offers suitable for BLIP-42's `payer_offer` field. These offers have either no blinded paths or single-hop paths, making them small enough to embed in invoice requests. Also adds integration test for the complete BLIP-42 flow: - Creating compact contact offers - Sending payments with contact info - Receiving payments with BLIP-42 fields Signed-off-by: Vincenzo Palazzo <[email protected]>
|
👋 Hi! I see this is a draft PR. |
vincenzopalazzo
changed the title
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
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.
Add support for BLIP-42 contact management in BOLT12 payments. This allows
payers to optionally include contact information when paying an offer,
enabling recipients to identify the sender and establish bidirectional
payment relationships.
The invoice request can now carry two optional fields:
Introduce three new methods to Bolt12Payment:
Extend PaymentReceived event to expose contact_secret and payer_offer
when present in incoming BOLT12 payments.
Add ContactSecrets wrapper type for UniFFI bindings compatibility.
Depends on rust-lightning BLIP-42 support (vincenzopalazzo/rust-lightning
branch macros/blip02-prep-v2).