Add LSPS5 webhook notification support#993
Draft
Camillarhi wants to merge 2 commits into
Draft
Conversation
|
👋 Hi! This PR is now in draft status. |
Implement the bLIP-55 / LSPS5 webhook registration protocol on top of the
multi-LSP liquidity module (src/liquidity/{client,service}).
Client side, exposed via Node::liquidity().lsps5():
- set_webhook / list_webhooks / remove_webhook to manage webhook
registrations with an LSP.
- When no node_id is given, set_webhook and remove_webhook fan out to every
LSPS5-capable LSP so a webhook can be configured once across all configured
LSPs; set_webhook returns one result per LSP that accepted the registration
and remove_webhook returns the LSPs it was removed from.
Service side, enabled via Builder::enable_liquidity_provider_lsps5():
- Deliver outgoing webhook notifications over HTTP in response to
LSPS5ServiceEvent::SendWebhookNotification.
- Automatically send an onion-message-incoming notification when an
intercepted onion message targets a client that is currently offline
(wired from LdkEvent::OnionMessageIntercepted, gated on peer connectivity).
Wires the feature through the UniFFI bindings and adds LSPS5-specific Error
variants.
Camillarhi
marked this pull request as draft
July 17, 2026 12:06
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
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.
Integrates LSPS5 (bLIP-0055) from lightning-liquidity, enabling webhook-based push notifications so clients can be alerted to events while their app is offline. Built on the refactored multi-LSP liquidity module
(src/liquidity/{client,service}).When
node_idisNone,set_webhookandremove_webhookfan out to every LSPS5-capable LSP, so a webhook can be configured once across all configured LSPs.Lets a node act as an LSPS5 server:
LSPS5ServiceEvent::SendWebhookNotification.onion_message_incomingnotification when an intercepted onion message targets a client that is currently offline (wired fromLdkEvent::OnionMessageIntercepted, gated on peer connectivity via the peer manager).Reopening after an accidental force-push pushed the branch to main's tip and auto-closed #729.