disableoffer

disableoffer -- Command for removing an offer

SYNOPSIS

disableoffer offer_id

DESCRIPTION

The disableoffer RPC command disables an offer, so that no further invoices will be given out.

We currently don't support deletion of offers, so offers are not forgotten entirely (there may be invoices which refer to this offer).

  • offer_id (hash): The id we use to identify this offer.

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.
  • active (boolean) (always false): Whether the offer can produce invoices/payments.
  • single_use (boolean): Whether the offer is disabled after first successful use.
  • bolt12 (string): The bolt12 string representing this offer.
  • used (boolean): Whether the offer has had an invoice paid / payment made.
  • label (string, optional): The label provided when offer was created.

AUTHOR

Rusty Russell <[email protected]> is mainly responsible.

SEE ALSO

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

RESOURCES

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

EXAMPLES

Example 1:

Request:

lightning-cli disableoffer -k "offer_id"="offeridl23000002300000230000023000002300000230000023000002300000"
{
  "id": "example:disableoffer#1",
  "method": "disableoffer",
  "params": {
    "offer_id": "offeridl23000002300000230000023000002300000230000023000002300000"
  }
}

Response:

{
  "offer_id": "offeridl23000002300000230000023000002300000230000023000002300000",
  "active": false,
  "single_use": false,
  "bolt12": "lno1qgsq000bolt230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000",
  "used": false
}

Core Lightning is Blockstream's open-source implementation of the Lightning Network optimised for performance. It is highly customizable through modular expandability.

© 2023 Core Lightning
All rights reserved.

X Twitter Logo Streamline Icon: https://streamlinehq.com

X

The official Core Lightning X(Twitter) handle to follow project updates and announcements.

Github Logo 2 Streamline Icon: https://streamlinehq.com

Github

Github repository for source code, issues, and contributions. Visit our project here to explore or contibute.

Telegram

Community-driven telegram group where most of the node operators hang out. Go to https://t.me/lightningd to join.

Discord

Community-driven discord server where the devs flock together. Go to https://discord.gg/V6ay9yNhBQ to join.