LIGHTNING-DELFORWARD(7)

💅 lightning-delforward(7) — delforward

okay so bestie, picture this: you're deep in listforwards and there's just one little entry you need gone. That's literally this whole page. It's the delforward command, section 7 of the manual, and it's here to delete exactly one forward and nothing else. No cap. 🎀

---

✨ SYNOPSIS ✨

delforward in_channel in_htlc_id status

three args, that's the whole vibe. 🦋

---

🌸 DESCRIPTION 🌸

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)). And here's the tea ☕: these database entries are only kept for your own analysis, so removing them has no effect on the running of your node. Like, zero. Your node does not care. Delete away. 💀

• in_channel (short_channel_id) — Only the matching forwards on the given inbound channel are deleted. Heads up though: 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. so like, be careful with that one, she's a big number and she means business 😭
• in_htlc_id (u64) — The unique HTLC id the sender gave this (not present if incoming channel was closed before upgrade to v22.11).
• status (string) (one of "settled", "local_failed", "failed") — The status of the forward to delete. You cannot delete forwards which have status offered (i.e. are currently active). active ones are off-limits, bestie, no exceptions 🔥

---

🦋 RETURN VALUE 🦋

On success, an empty object is returned. That's it. That's the reward. {} and a little serotonin. ✨

---

💅 ERRORS 💅

The following errors may be reported:

• 1401 — The forward specified does not exist. she's not here, girl, check your listforwards again 🙈

---

👑 AUTHOR 👑

Rusty Russell rusty@rustcorp.com.au is mainly responsible. main character energy fr fr 💜

---

🌈 SEE ALSO 🌈

• lightning-autoclean(7)

---

⭐ RESOURCES ⭐

Main web site: https://github.com/ElementsProject/lightning — go touch grass in the repo, it's iconic 🧚

---

🍓 EXAMPLES 🍓

Example 1:

Request:

$ lightning-cli delforward -k "in_channel"="109x1x1" "in_htlc_id"=4 "status"="local_failed"

{
  "id": "example:delforward#1",
  "method": "delforward",
  "params": {
    "in_channel": "109x1x1",
    "in_htlc_id": 4,
    "status": "local_failed"
  }
}

Response:

{}

ate and left no crumbs 💅

Example 2:

Request:

$ lightning-cli delforward -k "in_channel"="109x1x1" "in_htlc_id"=21 "status"="failed"

{
  "id": "example:delforward#2",
  "method": "delforward",
  "params": {
    "in_channel": "109x1x1",
    "in_htlc_id": 21,
    "status": "failed"
  }
}

Response:

{}

another one gone, slay 🎀

---

okay that's the whole page, you're officially a delforward expert now, iykyk 🫶 this gem was brought to you by Core Lightning v26.06.9 — mwah, go delete some forwards bestie ✨💖