Skip to content

readme: fix config doc for eclair #296

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 2 commits into
base: main
Choose a base branch
from

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

Abdulkbk added 2 commits July 5, 2025 21:16
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).
@@ -35,7 +35,14 @@ have permission to execute commands on. Note that the current version
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.

@@ -35,7 +35,14 @@ have permission to execute commands on. Note that the current version
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`
* 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 🎉

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.

2 participants