listoffers

listoffers -- Command for listing offers

SYNOPSIS

listoffers [offer_id] [active_only]

DESCRIPTION

The listoffers RPC command list all offers, or with offer_id, only the offer with that offer_id (if it exists).

  • offer_id (hash, optional): Offer_id to get details for (if it exists).
  • active_only (boolean, optional): If set and is true, only offers with active true are returned.

RETURN VALUE

On success, an object containing offers is returned. It is an array of objects, where each object contains:

  • offer_id (hash): The id of this offer (merkle hash of non-signature fields).
  • active (boolean): Whether this can still be used.
  • single_use (boolean): Whether this expires as soon as it's paid.
  • bolt12 (string): The bolt12 encoding of the offer.
  • used (boolean): True if an associated invoice has been paid.
  • label (string, optional): The (optional) user-specified label.

AUTHOR

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

SEE ALSO

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

RESOURCES

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

EXAMPLES

Example 1:

Request:

lightning-cli listoffers -k "active_only"=True
{
  "id": "example:listoffers#1",
  "method": "listoffers",
  "params": {
    "active_only": true
  }
}

Response:

{
  "offers": [
    {
      "offer_id": "offeridl21000002100000210000021000002100000210000021000002100000",
      "active": true,
      "single_use": false,
      "bolt12": "lno1qgsq000bolt210002100021000210002100021000210002100021000210002100021000210002100021000210002100021000210002100021000210002100021000",
      "used": false
    },
    {
      "offer_id": "offeridl22000002200000220000022000002200000220000022000002200000",
      "active": true,
      "single_use": false,
      "bolt12": "lno1qgsq000bolt220002200022000220002200022000220002200022000220002200022000220002200022000220002200022000220002200022000220002200022000",
      "used": false
    },
    {
      "offer_id": "offeridl23000002300000230000023000002300000230000023000002300000",
      "active": true,
      "single_use": false,
      "bolt12": "lno1qgsq000bolt230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000",
      "used": false
    }
  ]
}

Example 2:

Request:

lightning-cli listoffers "offeridl23000002300000230000023000002300000230000023000002300000"
{
  "id": "example:listoffers#2",
  "method": "listoffers",
  "params": [
    "offeridl23000002300000230000023000002300000230000023000002300000"
  ]
}

Response:

{
  "offers": [
    {
      "offer_id": "offeridl23000002300000230000023000002300000230000023000002300000",
      "active": true,
      "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.