This is a plugin for eclair to adjust your channel relay fees dynamically according to the channel balance. The plugin conceptually defines 3 states in which the channel [balance] can be and a multiplier associated to each state, the multiplier will be used to compute the new relay fees.
- Depleted: when 'toLocal' becomes too little the channel is considered depleted
- Saturated: when 'toLocal' becomes too large the channel is considered saturated
- Balanced: when the channel is not depleted nor saturated then it's balanced, no multiplier applied
The goal of the plugin is to keep the user's channel balanced by incentivizing the usage of depleted channels and
disincentivizing the usage of saturated channels, with this strategy the channels naturally tend to stay in a balanced
state. Note that if all nodes on the network apply this strategy all the users would benefit from a more balanced network.
The plugin works by intercepting the relayed payments and creates a new channel_update if and only if the channel is
transitioning from a state to another (i.e going balanced -> depleted), the plugin will ignore sent/received payments because they are user initiated. The plugin will apply the multiplier only to the fee_proportional value of the relay fee and use the configured value in eclair.fee-proportional-millionths as basepoint for the multiplication. This means that a manually updated relay fee will be overridden by the plugin once there is a relayed payments that make the channel transition to a new state.
The plugin can be built locally or downloaded from the release page of this repo, it's a fat jar that must be passed as argument to eclair when it's launched, see the instructions.
Once the plugin is configured and loaded it doesn't need any further input from the user, below there is a breakdown of how the plugin works:
- for each relayed payment retrieve the data for the channels involved (in/out)
- for each channel involved, if the channel is not blacklisted OR if the whitelist is non-empty and the channel is whitelisted
- compute the channel balance status
-
- if the balance is below the depleted threshold compute the new fee according to depleted multiplier
- if the balance is above the saturated threshold compute the new fee according to saturated multiplier
- if the balance is above depleted and below saturated threshold use multiplier 1x
- create a candidate channel_update using the new fee
-
- if the previous channel_update contains the same fees as the candidate do not broadcast it
- if the previous channel_update contains different fees from the candidate do broadcast it
Users MUST define a configuration section specifying the chosen values for their depleted/saturated thresholds
and their relative multiplier, note that the plugin only asks for a depleted and saturated thresholds and everything
in between will be considered balanced. It is possible to specify either a blacklist OR a whitelist of channel
short_ids, this allows to filter only for certain channels or filter out channels that you want to exclude from
the dynamic fees operations:
In eclair.conf add:
| eclair.dynamicfees.depleted.threshold | 0.3 | 0.3 = 30% this value must be below 1 and below the saturated threshold |
| eclair.dynamicfees.saturated.threshold | 0.8 | 0.8 = 80% this value must be below 1 and above the depleted threshold |
| eclair.dynamicfees.depleted.multiplier | 0.6 | when in depleted state the fees will be fee-proportional-millionths * 0.6 |
| eclair.dynamicfees.saturated.multiplier | 3 | when in saturated state the fees will be fee-proportional-millionths * 3 |
| eclair.dynamicfees.whitelist | ["0x1x2"] | if non empty only the channels in this list will be affected by the plugin |
| eclair.dynamicfees.blacklist | ["0x1x2"] | if non empty only the channels NOT in this list will be affected by the plugin |