package invoicesrpc

Get desktop application:
View/edit binary Protocol Buffers messages

Invoices is a service that can be used to create, accept, settle and cancel invoices.

• rpc SubscribeSingleInvoice (SubscribeSingleInvoiceRequest, stream lnrpc.Invoice)

  invoices.proto:36

  SubscribeSingleInvoice returns a uni-directional stream (server -> client) to notify the client of state transitions of the specified invoice. Initially the current invoice state is always sent out.

  message SubscribeSingleInvoiceRequest

  invoices.proto:159

  • bytes r_hash = 2

    Hash corresponding to the (hold) invoice to subscribe to. When using REST, this field must be encoded as base64url.

• rpc CancelInvoice (CancelInvoiceMsg, CancelInvoiceResp)

  invoices.proto:44

  lncli: `cancelinvoice` CancelInvoice cancels a currently open invoice. If the invoice is already canceled, this call will succeed. If the invoice is already settled, it will fail.

  message CancelInvoiceMsg

  invoices.proto:65

  • bytes payment_hash = 1

    Hash corresponding to the (hold) invoice to cancel. When using REST, this field must be encoded as base64.

  message CancelInvoiceResp

  invoices.proto:70

  (message has no fields)

• rpc AddHoldInvoice (AddHoldInvoiceRequest, AddHoldInvoiceResp)

  invoices.proto:50

  lncli: `addholdinvoice` AddHoldInvoice creates a hold invoice. It ties the invoice to the hash supplied in the request.

  message AddHoldInvoiceRequest

  invoices.proto:73

  • string memo = 1

    An optional memo to attach along with the invoice. Used for record keeping purposes for the invoice's creator, and will also be set in the description field of the encoded payment request if the description_hash field is not being used.

  • bytes hash = 2

    The hash of the preimage

  • int64 value = 3

    The value of this invoice in satoshis The fields value and value_msat are mutually exclusive.

  • int64 value_msat = 10

    The value of this invoice in millisatoshis The fields value and value_msat are mutually exclusive.

  • bytes description_hash = 4

    Hash (SHA-256) of a description of the payment. Used if the description of payment (memo) is too long to naturally fit within the description field of an encoded payment request.

  • int64 expiry = 5

    Payment request expiry time in seconds. Default is 86400 (24 hours).

  • string fallback_addr = 6

    Fallback on-chain address.

  • uint64 cltv_expiry = 7

    Delta to use for the time-lock of the CLTV extended to the final hop.

  • repeated lnrpc.RouteHint route_hints = 8

    Route hints that can each be individually used to assist in reaching the invoice's destination.

  • bool private = 9

    Whether this invoice should include routing hints for private channels.

  message AddHoldInvoiceResp

  invoices.proto:125

  • string payment_request = 1

    A bare-bones invoice for a payment within the Lightning Network. With the details of the invoice, the sender has all the data necessary to send a payment to the recipient.

  • uint64 add_index = 2

    The "add" index of this invoice. Each newly created invoice will increment this index making it monotonically increasing. Callers to the SubscribeInvoices call can use this to instantly get notified of all added invoices with an add_index greater than this one.

  • bytes payment_addr = 3

    The payment address of the generated invoice. This is also called the payment secret in specifications (e.g. BOLT 11). This value should be used in all payments for this invoice as we require it for end to end security.

• rpc SettleInvoice (SettleInvoiceMsg, SettleInvoiceResp)

  invoices.proto:56

  lncli: `settleinvoice` SettleInvoice settles an accepted invoice. If the invoice is already settled, this call will succeed.

  message SettleInvoiceMsg

  invoices.proto:150

  • bytes preimage = 1

    Externally discovered pre-image that should be used to settle the hold invoice.

  message SettleInvoiceResp

  invoices.proto:156

  (message has no fields)

• rpc LookupInvoiceV2 (LookupInvoiceMsg, lnrpc.Invoice)

  invoices.proto:62

  LookupInvoiceV2 attempts to look up at invoice. An invoice can be refrenced using either its payment hash, payment address, or set ID.

  message LookupInvoiceMsg

  invoices.proto:186

  • oneof invoice_ref

    • bytes payment_hash = 1

      When using REST, this field must be encoded as base64.

    • bytes payment_addr = 2

    • bytes set_id = 3

  • LookupModifier lookup_modifier = 4

Used in: LookupInvoiceMsg

• DEFAULT = 0

  The default look up modifier, no look up behavior is changed.

• HTLC_SET_ONLY = 1

  Indicates that when a look up is done based on a set_id, then only that set of HTLCs related to that set ID should be returned.

• HTLC_SET_BLANK = 2

  Indicates that when a look up is done using a payment_addr, then no HTLCs related to the payment_addr should be returned. This is useful when one wants to be able to obtain the set of associated setIDs with a given invoice, then look up the sub-invoices "projected" by that set ID.