LIGHTNING-NOTIFICATION-FORWARD_EVENT(7)

📦
version 26.06.9 · 2 versions
, in nixpkgs unstable

💅 LIGHTNING-NOTIFICATION-FORWARD_EVENT — okay so bestie, let's talk

Sooo this is the lightning-notification-forward_event situation — a whole manual page (section 7, for the record ✨) about a notification. Yes, forward_event is literally the notification name, and it's about to be your new obsession.

🎀 NAME

forward_event — Notification for forwarding events. That's it, that's the vibe 💖

🌸 DESCRIPTION

Okay so picture this: someone's HTLC is out here getting forwarded, right? And forward_event is the notification that slides into your DMs whenever the status of a forwarded HTLC changes. Every time. No cap. It's giving diligent little messenger 🦋

✨ NOTIFICATION PAYLOAD — the whole group chat, one by one

  • payment_hash (hash) — the payment hash for the forwarded HTLC. The main character identifier, honestly 👑
  • in_channel (short_channel_id) — the inbound channel that received the HTLC. Where it all started 🍼
  • in_msat (msat) — the amount of the incoming HTLC. Money in 💸
  • status (string) — the current forwarding status, and it's one of exactly these four: "offered", "settled", "local_failed", "failed". The vibe check of the whole event, fr fr
  • received_time (number) — the UNIX timestamp when the HTLC was received. Timestamped for the archives ⭐
  • out_channel (short_channel_id, optional) — the outbound channel used for the forward, if one was selected. Only shows up when it's relevant, mysterious 💅
  • 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. Get that bag 🤑
  • failcode (u32, optional) — the BOLT 4 failcode when the forward failed locally. The receipts of what went wrong 😭
  • failreason (string, optional) — the symbolic failcode name when the forward failed locally. Same energy, but readable 🫶
  • style (string, optional) — the onion format used for the forward, if known; it's one of "legacy" or "tlv". (added v23.11) 🧚
  • resolved_time (number, optional) — the UNIX timestamp when the HTLC was resolved, if it has been resolved. Closure, at last 🌈
Heads up bestie: those little optional tags are doing real work — a field only shows up when it applies, so don't come for the payload if something's missing 🙈

Anyway, that's the whole page, fully consumed, no crumbs left. Mwah 💋

Sign-off szn 🎀 — this gorgeous little page lives in Core Lightning v26.06.9, brought to you by the LIGHTNING-NOTIFICATION-FORWARD_EVENT(7) section-7 crew. Go forth and forward, queen 👑

📦 where this page comes from