enableoffer -- Command for re-enabling an offer

SYNOPSIS

enableoffer offer_id

DESCRIPTION

Command added in v24.08.

The enableoffer RPC command enables an offer, after it has been disabled.

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 true): Whether the offer can produce invoices/payments.
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.
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:

-32602: Error in given parameters.
1006: offer already enabled.

AUTHOR

Rusty Russell [email protected] is mainly responsible.

RESOURCES

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

EXAMPLES

Example 1:

Request:

lightning-cli enableoffer -k "offer_id"="f26c3b52dc94122dbbff0051ea6bf9a3f99cf127781ea6fc8923ef8428b5fe99"

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

Response:

{
  "offer_id": "f26c3b52dc94122dbbff0051ea6bf9a3f99cf127781ea6fc8923ef8428b5fe99",
  "active": true,
  "single_use": false,
  "bolt12": "lno1qgsqvgnwgcg35z6ee2h3yczraddm72xrfua9uve2rlrm9deu7xyfzrcgqv0gfqq2zp8kven9wgs8gmeqg35hxctzd3j3vggr8pzcqtf9kns8fn8a0nvtxwdyrhr4h7vh3gp5sqzyfdgag2c80xdq",
  "force_paths": false,
  "used": false,
  "description": "Offer to Disable"
}