@@ -757,12 +757,18 @@ where
757
757
}
758
758
}
759
759
760
- /// Used by LSP to provide the client with the intercept scid and
761
- /// `cltv_expiry_delta` to include in their invoice. The intercept scid
762
- /// must be retrieved from [`ChannelManager::get_intercept_scid`].
760
+ /// Used by LSP to provide the client with the intercept scid, a unique `user_channel_id`, and
761
+ /// `cltv_expiry_delta` to include in their invoice.
762
+ ///
763
+ /// The intercept scid must be retrieved from [`ChannelManager::get_intercept_scid`]. The given
764
+ /// `user_channel_id` must be locally unique and will eventually be returned via events to be
765
+ /// used when opening the channel via [`ChannelManager::create_channel`]. Note implementors
766
+ /// will need to ensure their calls to [`ChannelManager::create_channel`] are idempotent based
767
+ /// on this identifier.
763
768
///
764
769
/// Should be called in response to receiving a [`LSPS2ServiceEvent::BuyRequest`] event.
765
770
///
771
+ /// [`ChannelManager::create_channel`]: lightning::ln::channelmanager::ChannelManager::create_channel
766
772
/// [`ChannelManager::get_intercept_scid`]: lightning::ln::channelmanager::ChannelManager::get_intercept_scid
767
773
/// [`LSPS2ServiceEvent::BuyRequest`]: crate::lsps2::event::LSPS2ServiceEvent::BuyRequest
768
774
#[ allow( clippy:: await_holding_lock) ]
@@ -1815,7 +1821,7 @@ where
1815
1821
)
1816
1822
}
1817
1823
1818
- /// Used by LSP to provide the client with the intercept scid and
1824
+ /// Used by LSP to provide the client with the intercept scid, a unique `user_channel_id`, and
1819
1825
/// `cltv_expiry_delta` to include in their invoice.
1820
1826
///
1821
1827
/// Wraps [`LSPS2ServiceHandler::invoice_parameters_generated`].
0 commit comments