forward_event

forward_event -- Notification for forwarding events

DESCRIPTION

The forward_event notification informs whenever the status of a forwarded HTLC changes.

NOTIFICATION PAYLOAD

  • payment_hash (hash): The payment hash for the forwarded HTLC.
  • in_channel (short_channel_id): The inbound channel that received the HTLC.
  • in_msat (msat): The amount of the incoming HTLC.
  • status (string) (one of "offered", "settled", "local_failed", "failed"): The current forwarding status.
  • received_time (number): The UNIX timestamp when the HTLC was received.
  • out_channel (short_channel_id, optional): The outbound channel used for the forward, if one was selected.
  • out_msat (msat, optional): The amount forwarded to the outbound channel, if known.
  • fee_msat (msat, optional): The fee earned on the forward, if an outbound amount is known.
  • failcode (u32, optional): The BOLT 4 failcode when the forward failed locally.
  • failreason (string, optional): The symbolic failcode name when the forward failed locally.
  • style (string, optional) (one of "legacy", "tlv"): The onion format used for the forward, if known. (added v23.11)
  • resolved_time (number, optional): The UNIX timestamp when the HTLC was resolved, if it has been resolved.

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.