Skip to content

Commit bf47343

Browse files
committed
docs: release-notes-0.21
Warning message about removing the deprecated option --sat_per_byte
1 parent a76f22d commit bf47343

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

docs/release-notes/release-notes-0.21.0.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,30 @@
6363

6464
## Deprecations
6565

66+
### ⚠️ **Warning:** The deprecated fee rate option `--sat_per_byte` will be removed in release version **0.22**
67+
68+
The deprecated `--sat_per_byte` option will be fully removed. This flag was
69+
originally deprecated and hidden from the lncli commands in v0.13.0
70+
([PR#4704](https://github.com/lightningnetwork/lnd/pull/4704)). Users should
71+
migrate to the `--sat_per_vbyte` option, which correctly represents fee rates
72+
in terms of virtual bytes (vbytes).
73+
74+
Internally `--sat_per_byte` was treated as sat/vbyte, this meant the option
75+
name was misleading and could result in unintended fee calculations. To avoid
76+
further confusion and to align with ecosystem terminology, the option will be
77+
removed.
78+
79+
The following RPCs will be impacted:
80+
81+
| RPC Method | Messages | Removed Option |
82+
|----------------------|----------------|-------------|
83+
| [`lnrpc.CloseChannel`](https://lightning.engineering/api-docs/api/lnd/lightning/close-channel/) | [`lnrpc.CloseChannelRequest`](https://lightning.engineering/api-docs/api/lnd/lightning/close-channel/#lnrpcclosechannelrequest) | sat_per_byte
84+
| [`lnrpc.OpenChannelSync`](https://lightning.engineering/api-docs/api/lnd/lightning/open-channel-sync/) | [`lnrpc.OpenChannelRequest`](https://lightning.engineering/api-docs/api/lnd/lightning/open-channel-sync/#lnrpcopenchannelrequest) | sat_per_byte
85+
| [`lnrpc.OpenChannel`](https://lightning.engineering/api-docs/api/lnd/lightning/open-channel/) | [`lnrpc.OpenChannelRequest`](https://lightning.engineering/api-docs/api/lnd/lightning/open-channel/#lnrpcopenchannelrequest) | sat_per_byte
86+
| [`lnrpc.SendCoins`](https://lightning.engineering/api-docs/api/lnd/lightning/send-coins/) | [`lnrpc.SendCoinsRequest`](https://lightning.engineering/api-docs/api/lnd/lightning/send-coins/#lnrpcsendcoinsrequest) | sat_per_byte
87+
| [`lnrpc.SendMany`](https://lightning.engineering/api-docs/api/lnd/lightning/send-many/) | [`lnrpc.SendManyRequest`](https://lightning.engineering/api-docs/api/lnd/lightning/send-many/#lnrpcsendmanyrequest) | sat_per_byte
88+
| [`walletrpc.BumpFee`](https://lightning.engineering/api-docs/api/lnd/wallet-kit/bump-fee/) | [`walletrpc.BumpFeeRequest`](walletrpc.BumpFeeRequest) | sat_per_byte
89+
6690
# Technical and Architectural Updates
6791
## BOLT Spec Updates
6892

@@ -84,3 +108,4 @@
84108
* Elle Mouton
85109
* Mohamed Awnallah
86110
* Nishant Bansal
111+
* Pins

0 commit comments

Comments
 (0)