From 482530b9f7711009d7e1a17dfec06de7996aa2cd Mon Sep 17 00:00:00 2001 From: Github Actions Date: Sat, 1 Oct 2022 00:07:32 +0000 Subject: [PATCH] Update proto files --- proto/lightning.proto | 35 +++++++++++++++++++++++++++++++++++ proto/router.proto | 18 ++++++++++++++++++ 2 files changed, 53 insertions(+) diff --git a/proto/lightning.proto b/proto/lightning.proto index cf2cfb0e7..95b5a0b4b 100644 --- a/proto/lightning.proto +++ b/proto/lightning.proto @@ -2190,6 +2190,33 @@ message OpenChannelRequest { attempted. */ bool scid_alias = 20; + + /* + The base fee charged regardless of the number of milli-satoshis sent. + */ + uint64 base_fee = 21; + + /* + The fee rate in ppm (parts per million) that will be charged in + proportion of the value of each forwarded HTLC. + */ + uint64 fee_rate = 22; + + /* + If use_base_fee is true the open channel announcement will update the + channel base fee with the value specified in base_fee. In the case of + a base_fee of 0 use_base_fee is needed downstream to distinguish whether + to use the default base fee value specified in the config or 0. + */ + bool use_base_fee = 23; + + /* + If use_fee_rate is true the open channel announcement will update the + channel fee rate with the value specified in fee_rate. In the case of + a fee_rate of 0 use_fee_rate is needed downstream to distinguish whether + to use the default fee rate value specified in the config or 0. + */ + bool use_fee_rate = 24; } message OpenStatusUpdate { oneof update { @@ -2564,9 +2591,17 @@ message PendingChannelsResponse { repeated PendingHTLC pending_htlcs = 8; + /* + There are three resolution states for the anchor: + limbo, lost and recovered. Derive the current state + from the limbo and recovered balances. + */ enum AnchorState { + // The recovered_balance is zero and limbo_balance is non-zero. LIMBO = 0; + // The recovered_balance is non-zero. RECOVERED = 1; + // A state that is neither LIMBO nor RECOVERED. LOST = 2; } diff --git a/proto/router.proto b/proto/router.proto index 04812b4d3..52b34eee5 100644 --- a/proto/router.proto +++ b/proto/router.proto @@ -22,6 +22,16 @@ service Router { */ rpc TrackPaymentV2 (TrackPaymentRequest) returns (stream lnrpc.Payment); + /* + TrackPayments returns an update stream for every payment that is not in a + terminal state. Note that if payments are in-flight while starting a new + subscription, the start of the payment stream could produce out-of-order + and/or duplicate events. In order to get updates for every in-flight + payment attempt make sure to subscribe to this method before initiating any + payments. + */ + rpc TrackPayments (TrackPaymentsRequest) returns (stream lnrpc.Payment); + /* EstimateRouteFee allows callers to obtain a lower bound w.r.t how much it may cost to send an HTLC to the target end destination. @@ -303,6 +313,14 @@ message TrackPaymentRequest { bool no_inflight_updates = 2; } +message TrackPaymentsRequest { + /* + If set, only the final payment updates are streamed back. Intermediate + updates that show which htlcs are still in flight are suppressed. + */ + bool no_inflight_updates = 1; +} + message RouteFeeRequest { /* The destination once wishes to obtain a routing fee quote to.