Skip to content

Conversation

@Abdulkbk
Copy link
Contributor

@Abdulkbk Abdulkbk commented Jul 5, 2025

In this PR, we update the eclair config to enable keysend. Initially, we are using a config that is only applicable for running Eclair in Polar. --features.keysend=optional works only in polar SEE.

We also add additional configuration to enable CLN to send keysend payments to Eclair. Without

-Declair.channel.min-final-expiry-delta-blocks

the payment will fail because CLN uses 22 for keysend while Eclair's minimum default is 30.

-Declair.channel.fulfill-safety-before-timeout-blocks

is explicitly required when -Declair.channel.min-final-expiry-delta-blocks is set and must be less than it. SEE

of the simulator uses keysend to execute payments, which must be enabled as follows:
* LND: `--accept-keysend`
* CLN: enabled by default
* Eclair: `--features.keysend=optional`
Copy link
Collaborator

Choose a reason for hiding this comment

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

Without this flag on polar keysend is not activated. Maybe it would be better to indicate that this flag only works with polar and the -Declair.features.keysend in other cases.

README.md Outdated
* LND: `--accept-keysend`
* CLN: enabled by default
* Eclair: `--features.keysend=optional`
* Eclair: `-Declair.features.keysend=optional`
Copy link
Collaborator

Choose a reason for hiding this comment

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

tested on a local eclair setup and it works 🎉

@carlaKC
Copy link
Contributor

carlaKC commented Aug 4, 2025

@mubarak23 any updates here? Will be closing due to inactivity if review is not addressed soon.

@Abdulkbk
Copy link
Contributor Author

Abdulkbk commented Aug 4, 2025

@mubarak23 any updates here? Will be closing due to inactivity if review is not addressed soon.

This must've escaped my mind. I will address the feedback asap.

In this commit we correct the doc for enabling `keysend` in eclair.
Note: `--features.keysend=optional` is only usefull in Polar
because of how eclair docker image is built.
See: https://github.com/jamaljsr/polar/blob/master/docker/eclair/docker-entrypoint.sh#L25-L35
Without these configs CLN keysend payments to eclair will fail.
This is because CLN uses 22 final expiry delta which is less than
eclair's default (30).
@Abdulkbk
Copy link
Contributor Author

Abdulkbk commented Aug 4, 2025

Thanks @f3r10 for the review, I've addressed your feedback.

@Abdulkbk Abdulkbk requested a review from f3r10 August 4, 2025 20:00
@carlaKC carlaKC merged commit 2bdd675 into bitcoin-dev-project:main Aug 12, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants