LIGHTNING-NOTIFI...AGE_FORWARD_FAIL(7)

🧅✨ LIGHTNING-NOTIFI...AGE_FORWARD_FAIL(7) ✨🧅

okay bestie, welcome to the manual page for onionmessage_forward_fail — yes, that’s the whole manual name sitting right up there, and this page is serving onion message forwarding failure notification realness. 🫶

🌸 NAME 🌸

onionmessage_forward_fail — notification for onion message forwarding failures.

💖 DESCRIPTION 💖

This notification was added in v24.11, bestie. Not new-new, but still iconic.

The onionmessage_forward_fail notification informs whenever lightningd cannot forward an onion message. That’s it — it’s the little heads-up for when the onion-message forwarding vibe check fails. 🧅💀

📬 NOTIFICATION PAYLOAD 📬

Here’s the payload tea, field by field — no cap, every one matters:

• source (pubkey) — the node that sent the incoming onion message. 👑
• incoming (hex) — the incoming onion message payload. 📥
• path_key (pubkey) — the path key used for the attempted forward. 🔑
• outgoing (hex, optional) — the outgoing onion message payload if a next hop had already been selected. 📤
• next_node_id (pubkey, optional) — the next node id for the attempted forward when the next hop is a node. 🫶
• next_short_channel_id_dir (short_channel_id_dir, optional) — the next short_channel_id_dir for the attempted forward when the next hop is a channel. 🛣️

---

mwah 💋 later bestie — this page is brought to you by Core Lightning v26.06.9, and the footer didn’t include a date, so I’m not making one up, periodt. 💅✨