LIGHTNING-NOTIFICATION-CONNECT(7)

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

πŸ’œ connect β€” the "omg we're connected" notification πŸ’œ

Hey bestie, quick intro before we get into it: this is lightning-notification-connect(7), one of the Core Lightning notification pages. It's short, it's sweet, it's giving "little note that pops up and says hiiii" 🫢


🌸 NAME 🌸

connect β€” the notification you get when your node connects to a peer. That's it, that's the whole vibe. ✨


πŸ¦‹ DESCRIPTION πŸ¦‹

okay so. The connect notification fires off whenever the node gets connected to a peer. No cap, that's literally the whole job β€” it's the "we linked up" ping, the friendship bracelet of the Lightning Network πŸ’–

Every time a peer connection happens, this notification informs you. Periodt.


πŸŽ€ NOTIFICATION PAYLOAD πŸŽ€

This is the good part, the main character energy, the payload itself. Here's everything it hands you:

  • id (pubkey) β€” the id of the peer which sent the custom message
  • direction (string) (one of "in", "out") β€” which way the connection is going, in or out, iykyk
  • address (object) β€” address info, and lowkey this is mainly useful if direction is out:
    • type (string) (one of "local socket", "ipv4", "ipv6", "torv2", "torv3", "websocket") β€” the type of connection. Heads up: torv2/torv3 only show up if direction is out 🌈

🧚 the address object, broken down by type 🧚

Because what's inside address depends on what type you got. Vibe check time:

If type is "local socket":

  • socket (string) β€” the socket filename πŸ“

If type is "ipv4", "ipv6", "torv2" or "torv3":

  • address (string) β€” the address, in the expected format for that type
  • port (u16) β€” the port number πŸ”’
ngl, that's all the fields the page gives you β€” no extra guesses from me, bestie. What you see is what you get πŸ’…

πŸ’« a cute little sign-off πŸ’«

That's the whole page, fr fr β€” short and iconic, just like you. This one's from Core Lightning v26.06.9, so keep that in mind when you're out here reading notifications like the Unix icon you are πŸ‘‘πŸ’– go slay your peer connections, bestie! πŸ¦‹βœ¨

πŸ“¦ where this page comes from