Skip to content

lightning: improve accept_forwards_to_priv_channels doc #3786

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

Anyitechs
Copy link
Contributor

This PR documents that accept_forwards_to_priv_channels does not apply for intercepted payments, that we manually forward them.

Closes #3679

@ldk-reviews-bot
Copy link

ldk-reviews-bot commented May 20, 2025

I've assigned @valentinewallace as a reviewer!
I'll wait for their review and will help manage the review process.
Once they submit their review, I'll check if a second reviewer would be helpful.

@@ -830,6 +830,8 @@ pub struct UserConfig {
/// all your channels and open new ones. For privacy, you should also change your node_id
/// (swapping all private and public key material for new ones) at that time.
///
/// Note that this setting does not apply for intercepted payments, we manually forward them.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe say that the payments are surfaced via [Event::HTLCIntercepted] (with a doc link) and manually forwarded.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you. I'll update it.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@valentinewallace is this better "Note that this setting does not apply for intercepted payments that are surfaced via [Event::HTLCIntercepted] and manually forwarded."?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, thanks!

@ldk-reviews-bot
Copy link

👋 The first review has been submitted!

Do you think this PR is ready for a second reviewer? If so, click here to assign a second reviewer.

@Anyitechs Anyitechs force-pushed the doc-accept-forwards-to-priv-channels branch from be83fa3 to 25a9564 Compare May 20, 2025 19:17
@@ -830,6 +830,9 @@ pub struct UserConfig {
/// all your channels and open new ones. For privacy, you should also change your node_id
/// (swapping all private and public key material for new ones) at that time.
///
/// Note that this setting does not apply for intercepted payments that are surfaced via
/// [`Event::HTLCIntercepted`] and manually forwarded.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe you need to add an import line for this, similar to the one on accept_underpaying_htlcs

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've fixed that. Thank you.

@Anyitechs Anyitechs force-pushed the doc-accept-forwards-to-priv-channels branch from 25a9564 to bd07a92 Compare May 20, 2025 20:24
@valentinewallace
Copy link
Contributor

Can you squash and limit the commit message title to 50 characters?

Document that `accept_forwards_to_priv_channels` does not apply for intercepted payments.
@Anyitechs Anyitechs force-pushed the doc-accept-forwards-to-priv-channels branch from bd07a92 to 2e5ff7e Compare May 20, 2025 22:39
@Anyitechs Anyitechs changed the title doc(lightning): document that accept_forwards_to_priv_channels does not apply for intercepted payments lightning: improve accept_forwards_to_priv_channels doc May 20, 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
4 participants