onionmessage_forward_fail

onionmessage_forward_fail -- Notification for onion message forwarding failures

DESCRIPTION

Notification added in v24.11.

The onionmessage_forward_fail notification informs whenever lightningd cannot forward an onion message.

NOTIFICATION PAYLOAD

  • 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.

Core Lightning is Blockstream's open-source implementation of the Lightning Network optimised for performance. It is highly customizable through modular expandability.

© 2026 Core Lightning, a Blockstream project.
All rights reserved.

X Twitter Logo Streamline Icon: https://streamlinehq.com

X

The official Core Lightning X(Twitter) handle to follow project updates and announcements.

Github Logo 2 Streamline Icon: https://streamlinehq.com

Github

Github repository for source code, issues, and contributions. Visit our project here to explore or contibute.

Telegram

Community-driven telegram group where most of the node operators hang out. Go to https://t.me/lightningd to join.

Discord

Community-driven discord server where the devs flock together. Go to https://discord.gg/V6ay9yNhBQ to join.