lightning-funderupdate -- Command for adjusting node funding v2 channels ======================================================================== SYNOPSIS -------- **funderupdate** \[*policy*\] \[*policy_mod*\] \[*leases_only*\] \[*min_their_funding_msat*\] \[*max_their_funding_msat*\] \[*per_channel_min_msat*\] \[*per_channel_max_msat*\] \[*reserve_tank_msat*\] \[*fuzz_percent*\] \[*fund_probability*\] \[*lease_fee_base_msat*\] \[*lease_fee_basis*\] \[*funding_weight*\] \[*channel_fee_max_base_msat*\] \[*channel_fee_max_proportional_thousandths*\] \[*compact_lease*\] NOTE: Must have --experimental-dual-fund enabled for these settings to take effect. DESCRIPTION ----------- For channel open requests using *policy*, *policy_mod* is the policy the funder plugin will use to decide how much capital to commit to a v2 open channel request. There are three policy options, detailed below: `match`, `available`, and `fixed`. The *policy_mod* is the number or 'modification' to apply to the policy. Default is (fixed, 0sats). * `match` -- Contribute *policy_mod* percent of their requested funds. Valid *policy_mod* values are 0 to 200. If this is a channel lease request, we match based on their requested funds. If it is not a channel lease request (and *lease_only* is false), then we match their funding amount. Note: any lease match less than 100 will likely fail, as clients will not accept a lease less than their request. * `available` -- Contribute *policy_mod* percent of our available node wallet funds. Valid *policy_mod* values are 0 to 100. * `fixed` -- Contributes a fixed *policy_mod* sats to v2 channel open requests. Note: to maximize channel leases, best policy setting is (match, 100). *leases_only* will only contribute funds to `option_will_fund` requests which pay to lease funds. Defaults to false, will fund any v2 open request using *policy* even if it's they're not seeking to lease funds. Note that `option_will_fund` commits funds for 4032 blocks (~1mo). Must also set *lease_fee_base_msat*, *lease_fee_basis*, *funding_weight*, *channel_fee_max_base_msat*, and *channel_fee_max_proportional_thousandths* to advertise available channel leases. *min_their_funding_msat* is the minimum funding sats that we require in order to activate our contribution policy to the v2 open. Defaults to 10k sats. *max_their_funding_msat* is the maximum funding sats that we will consider to activate our contribution policy to the v2 open. Any channel open above this will not be funded. Defaults to no max (`UINT_MAX`). *per_channel_min_msat* is the minimum amount that we will contribute to a channel open. Defaults to 10k sats. *per_channel_max_msat* is the maximum amount that we will contribute to a channel open. Defaults to no max (`UINT_MAX`). *reserve_tank_msat* is the amount of sats to leave available in the node wallet. Defaults to zero sats. *fuzz_percent* is a percentage to fuzz the resulting contribution amount by. Valid values are 0 to 100. Note that turning this on with (match, 100) policy will randomly fail `option_will_fund` leases, as most clients expect an exact or greater match of their `requested_funds`. Defaults to 0% (no fuzz). *fund_probability* is the percent of v2 channel open requests to apply our policy to. Valid values are integers from 0 (fund 0% of all open requests) to 100 (fund every request). Useful for randomizing opens that receive funds. Defaults to 100. Setting any of the next 5 options will activate channel leases for this node, and advertise these values via the lightning gossip network. If any one is set, the other values will be the default. *lease_fee_base_msat* is the flat fee for a channel lease. Node will receive this much extra added to their channel balance, paid by the opening node. Defaults to 2k sats. Note that the minimum is 1sat. *lease_fee_basis* is a basis fee that's calculated as 1/10k of the total requested funds the peer is asking for. Node will receive the total of *lease_fee_basis* times requested funds / 10k satoshis added to their channel balance, paid by the opening node. Default is 0.65% (65 basis points) *funding_weight* is used to calculate the fee the peer will compensate your node for its contributing inputs to the funding transaction. The total fee is calculated as the `open_channel2`.`funding_feerate_perkw` times this *funding_weight* divided by 1000. Node will have this funding fee added to their channel balance, paid by the opening node. Default is 2 inputs + 1 P2WPKH output. *channel_fee_max_base_msat* is a commitment to a maximum `channel_fee_base_msat` that your node will charge for routing payments over this leased channel during the lease duration. Default is 5k sats. *channel_fee_max_proportional_thousandths* is a commitment to a maximum `channel_fee_proportional_millionths` that your node will charge for routing payments over this leased channel during the lease duration. Note that it's denominated in 'thousandths'. A setting of `1` is equal to 1k ppm; `5` is 5k ppm, etc. Default is 100 (100k ppm). *compact_lease* is a compact description of the channel lease params. When opening a channel, passed in to `fundchannel` to indicate the terms we expect from the peer. RETURN VALUE ------------ [comment]: # (GENERATE-FROM-SCHEMA-START) On success, an object is returned, containing: - **summary** (string): Summary of the current funding policy e.g. (match 100) - **policy** (string): Policy funder plugin will use to decide how much captial to commit to a v2 open channel request (one of "match", "available", "fixed") - **policy_mod** (u32): The *policy_mod* is the number or 'modification' to apply to the policy. - **leases_only** (boolean): Only contribute funds to `option_will_fund` lease requests. - **min_their_funding_msat** (msat): The minimum funding sats that we require from peer to activate our funding policy. - **max_their_funding_msat** (msat): The maximum funding sats that we'll allow from peer to activate our funding policy. - **per_channel_min_msat** (msat): The minimum amount that we will fund a channel open with. - **per_channel_max_msat** (msat): The maximum amount that we will fund a channel open with. - **reserve_tank_msat** (msat): Amount of sats to leave available in the node wallet. - **fuzz_percent** (u32): Percentage to fuzz our funding amount by. - **fund_probability** (u32): Percent of opens to consider funding. 100 means we'll consider funding every requested open channel request. - **lease_fee_base_msat** (msat, optional): Flat fee to charge for a channel lease. - **lease_fee_basis** (u32, optional): Proportional fee to charge for a channel lease, calculated as 1/10,000th of requested funds. - **funding_weight** (u32, optional): Transaction weight the channel opener will pay us for a leased funding transaction. - **channel_fee_max_base_msat** (msat, optional): Maximum channel_fee_base_msat we'll charge for routing funds leased on this channel. - **channel_fee_max_proportional_thousandths** (u32, optional): Maximum channel_fee_proportional_millitionths we'll charge for routing funds leased on this channel, in thousandths. - **compact_lease** (hex, optional): Compact description of the channel lease parameters. [comment]: # (GENERATE-FROM-SCHEMA-END) The following error code may occur: - -32602: If the given parameters are invalid. AUTHOR ------ @niftynei <> is mainly responsible. SEE ALSO -------- lightning-fundchannel(7), lightning-listfunds(7) RESOURCES --------- Main web site: [comment]: # ( SHA256STAMP:e09e7cd45085dbcbf9a5ea556a413f004812995506703f91973c1d2671780c5b)