lightning-delforward – Command for removing a forwarding entry¶
delforward in_channel in_htlc_id status
The delforward RPC command removes a single forward from listforwards, using the uniquely-identifying in_channel and in_htlc_id (and, as a sanity check, the status) given by that command.
This command is mainly used by the autoclean plugin (see lightningd-config(7)), As these database entries are only kept for your own analysis, removing them has no effect on the running of your node.
You cannot delete forwards which have status offered (i.e. are currently active).
Note: for listforwards entries without an in_htlc_id entry (no longer created in v22.11, but can exist from older versions), a value of 18446744073709551615 can be used, but then it will delete all entries without in_htlc_id for this in_channel and status.
On success, an empty object is returned.
The following errors may be reported:
- 1401: The forward specified does not exist.