87 lines
2.7 KiB
Groff
87 lines
2.7 KiB
Groff
.TH "LIGHTNING-SETCHANNELFEE" "7" "" "" "lightning-setchannelfee"
|
|
.SH NAME
|
|
lightning-setchannelfee - Command for setting specific routing fees on a lightning channel
|
|
.SH SYNOPSIS
|
|
|
|
\fBsetchannelfee\fR \fIid\fR [\fIbase\fR] [\fIppm\fR]
|
|
|
|
.SH DESCRIPTION
|
|
|
|
The \fBsetchannelfee\fR RPC command sets channel specific routing fees as
|
|
defined in BOLT #7\. The channel has to be in normal or awaiting state\.
|
|
This can be checked by \fBlistpeers\fR reporting a \fIstate\fR of
|
|
CHANNELD_NORMAL or CHANNELD_AWAITING_LOCKIN for the channel\.
|
|
|
|
|
|
\fIid\fR is required and should contain a scid (short channel ID), channel
|
|
id or peerid (pubkey) of the channel to be modified\. If \fIid\fR is set to
|
|
"all", the fees for all channels are updated that are in state
|
|
CHANNELD_NORMAL or CHANNELD_AWAITING_LOCKIN\.
|
|
|
|
|
|
\fIbase\fR is an optional value in millisatoshi that is added as base fee to
|
|
any routed payment\. If the parameter is left out, the global config
|
|
value fee-base will be used again\. It can be a whole number, or a whole
|
|
number ending in \fImsat\fR or \fIsat\fR, or a number with three decimal places
|
|
ending in \fIsat\fR, or a number with 1 to 11 decimal places ending in
|
|
\fIbtc\fR\.
|
|
|
|
|
|
\fIppm\fR is an optional value that is added proportionally per-millionths
|
|
to any routed payment volume in satoshi\. For example, if ppm is 1,000
|
|
and 1,000,000 satoshi is being routed through the channel, an
|
|
proportional fee of 1,000 satoshi is added, resulting in a 0\.1% fee\. If
|
|
the parameter is left out, the global config value will be used again\.
|
|
|
|
.SH RETURN VALUE
|
|
|
|
On success, an object is returned, containing:
|
|
|
|
.RS
|
|
.IP \[bu]
|
|
\fBbase\fR (u32): The fee_base_msat value
|
|
.IP \[bu]
|
|
\fBppm\fR (u32): The fee_proportional_millionths value
|
|
.IP \[bu]
|
|
\fBchannels\fR (array of objects): channel(s) whose rate is now set:
|
|
.RS
|
|
.IP \[bu]
|
|
\fBpeer_id\fR (pubkey): The node_id of the peer
|
|
.IP \[bu]
|
|
\fBchannel_id\fR (hex): The channel_id of the channel (always 64 characters)
|
|
.IP \[bu]
|
|
\fBshort_channel_id\fR (short_channel_id, optional): the short_channel_id (if locked in)
|
|
|
|
.RE
|
|
|
|
|
|
.RE
|
|
.SH ERRORS
|
|
|
|
The following error codes may occur:
|
|
|
|
.RS
|
|
.IP \[bu]
|
|
-1: Channel is in incorrect state, i\.e\. Catchall nonspecific error\.
|
|
.IP \[bu]
|
|
-32602: JSONRPC2_INVALID_PARAMS, i\.e\. Given id is not a channel ID
|
|
or short channel ID\.
|
|
|
|
.RE
|
|
.SH AUTHOR
|
|
|
|
Michael Schmoock \fI<michael@schmoock.net\fR> is the author of this
|
|
feature\. Rusty Russell \fI<rusty@rustcorp.com.au\fR> is mainly
|
|
responsible for the c-lightning project\.
|
|
|
|
.SH SEE ALSO
|
|
|
|
\fBlightningd-config\fR(5), \fBlightning-fundchannel\fR(7),
|
|
\fBlightning-listchannels\fR(7), \fBlightning-listpeers\fR(7)
|
|
|
|
.SH RESOURCES
|
|
|
|
Main web site: \fIhttps://github.com/ElementsProject/lightning\fR
|
|
|
|
\" SHA256STAMP:adc53b579ff0592bc35a6ccdbbf19f78241def679f48ae4eceeee39acc277857
|