LIGHTNING-ENABLEOFFER(7)

💅 LIGHTNING-ENABLEOFFER(7)

ok so bestie, welcome to the glow-up era of this lil page — it's the manual for lightning-enableoffer, and yes the name is a mouthful, we're coping 🫶

---

✨ NAME ✨

enableoffer — the command that un-disables your offer, i.e. the "jk, come back 🥺" of offers.

---

🎀 SYNOPSIS 🎀

enableoffer offer_id

---

🌸 DESCRIPTION 🌸

okay so first thing: this command was added in v24.08. mark your calendars, she's new-ish 💖

The enableoffer RPC command enables an offer, after it has been disabled. That's it. That's the whole vibe. You had an offer, you hit the off switch, now you want it back on — this is the button.

• offer_id (hash) — the id we use to identify this offer. it's the little name tag your offer wears so we know which one you mean 💅

---

🦋 RETURN VALUE 🦋

note: the returned object is the same format as listoffers. On success, an object is returned, containing:

• offer_id (hash) — the merkle hash of the offer. very demure, very merkle.
• active (boolean) (always true) — whether the offer can produce invoices/payments. and bestie, it's always true here, that's literally the point of the command 🥳
• single_use (boolean) — whether the offer is disabled after first successful use.
• force_paths (boolean) — True if fronting_nodes (or the payment-fronting-node configuration entry) is set: implies any invoice issued for this offer must use a subset of the same blinded paths. (added v26.04)
• bolt12 (string) — the bolt12 string representing this offer. the iconic long string, she's back ✨
• used (boolean) — whether the offer has had an invoice paid / payment made.
• description (string, optional) — the user-specified bolt 12 description. (added v26.04)
• label (string, optional) — the label provided when offer was created.

---

😭 ERRORS 😭

on failure, one of the following error codes may be returned — read these, they're your group chat receipts:

• -32602 — Error in given parameters. check ur args bestie 💀
• 1006 — offer already enabled. she's already up, no need to do all that 🙈

---

👑 AUTHOR 👑

Rusty Russell rusty@rustcorp.com.au is mainly responsible. (the main character, tbh 🔥)

---

🌈 SEE ALSO 🌈

lightning-offer(7), lightning-disableoffer(7), lightning-listoffers(7)

---

🧚 RESOURCES 🧚

Main web site: https://github.com/ElementsProject/lightning

---

⭐ EXAMPLES ⭐

Example 1:

Request:

$ lightning-cli enableoffer -k "offer_id"="offeridl23000002300000230000023000002300000230000023000002300000"

{
  "id": "example:enableoffer#1",
  "method": "enableoffer",
  "params": {
    "offer_id": "offeridl23000002300000230000023000002300000230000023000002300000"
  }
}

Response:

{
  "offer_id": "offeridl23000002300000230000023000002300000230000002300000",
  "active": true,
  "single_use": false,
  "bolt12": "lno1qgsq000bolt230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000",
  "description": "Movie ticket",
  "used": false
}

---

aaand that's the whole page, bestie 🎀 ok bye, this was LIGHTNING-ENABLEOFFER(7) from Core Lightning v26.06.9 — mwah, go enable some offers, ily 💜🦋🍓