LIGHTNING-NOTIFI...PAY_PAY_PART_END(7)

πŸ“¦
version 26.06.9 Β· 2 versions
, in nixpkgs unstable

✨ LIGHTNING-NOTIFI...PAY_PAY_PART_END(7) ✨

okay so bestie, the manual page we're reading is literally called LIGHTNING-NOTIFI...PAY_PAY_PART_END(7) (yes the name is a whole vibe, it's truncated, we love that for it) and it's all about one very specific notification πŸ’…


🌸 NAME 🌸

pay_part_end β€” the notification that slides into your DMs when an xpay part finishes πŸŽ€


πŸ¦‹ DESCRIPTION πŸ¦‹

okay so first thing: this notification was added in v25.09. note that, fr fr, because if you're on an older version and you're sitting there waiting for it like πŸ‘€ it is simply not coming 😭

The pay_part_end notification gets emitted by the xpay plugin when a payment part completes. that's it, that's the whole thing β€” one part finishes, the notification shows up, main character energy 🌟


πŸ‘‘ NOTIFICATION PAYLOAD πŸ‘‘

here's everything that comes in the payload, no cap, all the fields 🫢

  • status (string) (one of "success", "failure") β€” whether this payment part succeeded or failed. two options, that's it, pick your fighter πŸ’€
  • duration (number) β€” the time in seconds from send to result. the clock starts when it's sent and stops at the result ⏱️
  • payment_hash (hash) β€” the payment hash for the xpay invocation πŸ”‘
  • groupid (u64) β€” the xpay group identifier for the payment attempt 🏷️
  • partid (u64) β€” the identifier for this specific payment part. hi little part, we see you πŸ’–
  • failed_msg (hex, optional) β€” the decrypted onion error message, if it's available πŸ§…
  • failed_node_id (pubkey, optional) β€” the node that generated the failure, if that's known πŸ‘€
  • failed_short_channel_id (short_channel_id, optional) β€” the short channel id that got complained about, if known πŸ“
  • failed_direction (u32, optional) β€” the direction within the failed short channel id, if known ➑️
  • error_code (u32, optional) β€” the xpay error code, if known πŸ”’
  • error_message (string, optional) β€” the human-readable xpay error message πŸ“
quick vibe check bestie: see all those (optional) tags? they're optional. so don't come for the payload when a field isn't there β€” it was literally allowed to ghost you πŸ™ˆ

and that's the page!! every field accounted for, nothing skipped, we ate and left no crumbs πŸ’…βœ¨

signing off with the source + version tea: this beauty is from Core Lightning v26.06.9 πŸ§šπŸ’œ

πŸ“¦ where this page comes from