LIGHTNING-NOTIFI...-BALANCE_SNAPSHOT(7)

🎀 LIGHTNING-NOTIFI...-BALANCE_SNAPSHOT(7) 🎀

okay so bestie, this is a page from the Core Lightning manual — the lightning-notifi...-balance_snapshot one, aka the glow-up notification page. it's short, it's cute, it's giving "receipts for your sats" energy, and honestly? we're obsessed. let's get into it 💅

---

✨ NAME ✨

balance_snapshot — Notification for balance snapshots 🧾✨

---

🌸 DESCRIPTION 🌸

This notification was added in v24.11 — so if you're out here on some ancient version, no it wasn't, bestie 💀

The balance_snapshot notification informs whenever lightningd emits a balance snapshot for bookkeeping. like, it's the group chat ping that says "hey, your books just got balanced, look at this" 🫶

---

🦋 NOTIFICATION PAYLOAD 🦋

here's what shows up in the payload — every field, no skipping, we don't do that here:

• node_id (pubkey) — the node id the snapshot was taken for 👑
• blockheight (u32) — the blockheight at which the snapshot was taken 🧱
• timestamp (u32) — the snapshot time as seconds since epoch ⏰
• accounts (array of objects) — the balances for each tracked account at the snapshot time, and inside that:
  • account_id (string) — the account identifier for the balance 🏷️
  • balance_msat (msat) — the account balance in millisatoshis 💰
  • coin_type (string) — the BIP173 coin type name for the balance 🪙

---

🌈 fr fr, that's the whole payload. every object, every field, every unit — that's the vibe check and it passed ✨

---

💖 a lil sign-off 💖

this iconic lil page is from Core Lightning v26.06.9 — go forth and snapshot those balances, bestie, you're the main character of bookkeeping now 🎀🦋💜