{ "swagger": "2.0", "info": { "title": "rpc.proto", "version": "version not set" }, "schemes": [ "http", "https" ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "paths": { "/v1/balance/blockchain": { "get": { "summary": "* lncli: `walletbalance`\nWalletBalance returns total unspent outputs(confirmed and unconfirmed), all\nconfirmed unspent outputs and all unconfirmed unspent outputs under control\nof the wallet.", "operationId": "WalletBalance", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcWalletBalanceResponse" } } }, "tags": [ "Lightning" ] } }, "/v1/balance/channels": { "get": { "summary": "* lncli: `channelbalance`\nChannelBalance returns the total funds available across all open channels\nin satoshis.", "operationId": "ChannelBalance", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcChannelBalanceResponse" } } }, "tags": [ "Lightning" ] } }, "/v1/changepassword": { "post": { "summary": "* lncli: `changepassword`\nChangePassword changes the password of the encrypted wallet. This will\nautomatically unlock the wallet database if successful.", "operationId": "ChangePassword", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcChangePasswordResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcChangePasswordRequest" } } ], "tags": [ "WalletUnlocker" ] } }, "/v1/channels": { "get": { "summary": "* lncli: `listchannels`\nListChannels returns a description of all the open channels that this node\nis a participant in.", "operationId": "ListChannels", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcListChannelsResponse" } } }, "parameters": [ { "name": "active_only", "in": "query", "required": false, "type": "boolean", "format": "boolean" }, { "name": "inactive_only", "in": "query", "required": false, "type": "boolean", "format": "boolean" }, { "name": "public_only", "in": "query", "required": false, "type": "boolean", "format": "boolean" }, { "name": "private_only", "in": "query", "required": false, "type": "boolean", "format": "boolean" } ], "tags": [ "Lightning" ] }, "post": { "summary": "*\nOpenChannelSync is a synchronous version of the OpenChannel RPC call. This\ncall is meant to be consumed by clients to the REST proxy. As with all\nother sync calls, all byte slices are intended to be populated as hex\nencoded strings.", "operationId": "OpenChannelSync", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcChannelPoint" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcOpenChannelRequest" } } ], "tags": [ "Lightning" ] } }, "/v1/channels/abandon/{channel_point.funding_txid_str}/{channel_point.output_index}": { "delete": { "summary": "* lncli: `abandonchannel`\nAbandonChannel removes all channel state from the database except for a\nclose summary. This method can be used to get rid of permanently unusable\nchannels due to bugs fixed in newer versions of lnd. Only available\nwhen in debug builds of lnd.", "operationId": "AbandonChannel", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcAbandonChannelResponse" } } }, "parameters": [ { "name": "channel_point.funding_txid_str", "description": "*\nHex-encoded string representing the byte-reversed hash of the funding\ntransaction.", "in": "path", "required": true, "type": "string" }, { "name": "channel_point.output_index", "description": "/ The index of the output of the funding transaction", "in": "path", "required": true, "type": "integer", "format": "int64" }, { "name": "channel_point.funding_txid_bytes", "description": "*\nTxid of the funding transaction. When using REST, this field must be\nencoded as base64.", "in": "query", "required": false, "type": "string", "format": "byte" } ], "tags": [ "Lightning" ] } }, "/v1/channels/backup": { "get": { "summary": "*\nExportAllChannelBackups returns static channel backups for all existing\nchannels known to lnd. A set of regular singular static channel backups for\neach channel are returned. Additionally, a multi-channel backup is returned\nas well, which contains a single encrypted blob containing the backups of\neach channel.", "operationId": "ExportAllChannelBackups", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcChanBackupSnapshot" } } }, "tags": [ "Lightning" ] } }, "/v1/channels/backup/restore": { "post": { "summary": "* lncli: `restorechanbackup`\nRestoreChannelBackups accepts a set of singular channel backups, or a\nsingle encrypted multi-chan backup and attempts to recover any funds\nremaining within the channel. If we are able to unpack the backup, then the\nnew channel will be shown under listchannels, as well as pending channels.", "operationId": "RestoreChannelBackups", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcRestoreBackupResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcRestoreChanBackupRequest" } } ], "tags": [ "Lightning" ] } }, "/v1/channels/backup/verify": { "post": { "summary": "*\nVerifyChanBackup allows a caller to verify the integrity of a channel backup\nsnapshot. This method will accept either a packed Single or a packed Multi.\nSpecifying both will result in an error.", "operationId": "VerifyChanBackup", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcVerifyChanBackupResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcChanBackupSnapshot" } } ], "tags": [ "Lightning" ] } }, "/v1/channels/backup/{chan_point.funding_txid_str}/{chan_point.output_index}": { "get": { "summary": "* lncli: `exportchanbackup`\nExportChannelBackup attempts to return an encrypted static channel backup\nfor the target channel identified by it channel point. The backup is\nencrypted with a key generated from the aezeed seed of the user. The\nreturned backup can either be restored using the RestoreChannelBackup\nmethod once lnd is running, or via the InitWallet and UnlockWallet methods\nfrom the WalletUnlocker service.", "operationId": "ExportChannelBackup", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcChannelBackup" } } }, "parameters": [ { "name": "chan_point.funding_txid_str", "description": "*\nHex-encoded string representing the byte-reversed hash of the funding\ntransaction.", "in": "path", "required": true, "type": "string" }, { "name": "chan_point.output_index", "description": "/ The index of the output of the funding transaction", "in": "path", "required": true, "type": "integer", "format": "int64" }, { "name": "chan_point.funding_txid_bytes", "description": "*\nTxid of the funding transaction. When using REST, this field must be\nencoded as base64.", "in": "query", "required": false, "type": "string", "format": "byte" } ], "tags": [ "Lightning" ] } }, "/v1/channels/closed": { "get": { "summary": "* lncli: `closedchannels`\nClosedChannels returns a description of all the closed channels that\nthis node was a participant in.", "operationId": "ClosedChannels", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcClosedChannelsResponse" } } }, "parameters": [ { "name": "cooperative", "in": "query", "required": false, "type": "boolean", "format": "boolean" }, { "name": "local_force", "in": "query", "required": false, "type": "boolean", "format": "boolean" }, { "name": "remote_force", "in": "query", "required": false, "type": "boolean", "format": "boolean" }, { "name": "breach", "in": "query", "required": false, "type": "boolean", "format": "boolean" }, { "name": "funding_canceled", "in": "query", "required": false, "type": "boolean", "format": "boolean" }, { "name": "abandoned", "in": "query", "required": false, "type": "boolean", "format": "boolean" } ], "tags": [ "Lightning" ] } }, "/v1/channels/pending": { "get": { "summary": "* lncli: `pendingchannels`\nPendingChannels returns a list of all the channels that are currently\nconsidered \"pending\". A channel is pending if it has finished the funding\nworkflow and is waiting for confirmations for the funding txn, or is in the\nprocess of closure, either initiated cooperatively or non-cooperatively.", "operationId": "PendingChannels", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcPendingChannelsResponse" } } }, "tags": [ "Lightning" ] } }, "/v1/channels/transactions": { "post": { "summary": "*\nSendPaymentSync is the synchronous non-streaming version of SendPayment.\nThis RPC is intended to be consumed by clients of the REST proxy.\nAdditionally, this RPC expects the destination's public key and the payment\nhash (if any) to be encoded as hex strings.", "operationId": "SendPaymentSync", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcSendResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcSendRequest" } } ], "tags": [ "Lightning" ] } }, "/v1/channels/transactions/route": { "post": { "summary": "*\nSendToRouteSync is a synchronous version of SendToRoute. It Will block\nuntil the payment either fails or succeeds.", "operationId": "SendToRouteSync", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcSendResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcSendToRouteRequest" } } ], "tags": [ "Lightning" ] } }, "/v1/channels/{channel_point.funding_txid_str}/{channel_point.output_index}": { "delete": { "summary": "* lncli: `closechannel`\nCloseChannel attempts to close an active channel identified by its channel\noutpoint (ChannelPoint). The actions of this method can additionally be\naugmented to attempt a force close after a timeout period in the case of an\ninactive peer. If a non-force close (cooperative closure) is requested,\nthen the user can specify either a target number of blocks until the\nclosure transaction is confirmed, or a manual fee rate. If neither are\nspecified, then a default lax, block confirmation target is used.", "operationId": "CloseChannel", "responses": { "200": { "description": "A successful response.(streaming responses)", "schema": { "$ref": "#/x-stream-definitions/lnrpcCloseStatusUpdate" } } }, "parameters": [ { "name": "channel_point.funding_txid_str", "description": "*\nHex-encoded string representing the byte-reversed hash of the funding\ntransaction.", "in": "path", "required": true, "type": "string" }, { "name": "channel_point.output_index", "description": "/ The index of the output of the funding transaction", "in": "path", "required": true, "type": "integer", "format": "int64" }, { "name": "channel_point.funding_txid_bytes", "description": "*\nTxid of the funding transaction. When using REST, this field must be\nencoded as base64.", "in": "query", "required": false, "type": "string", "format": "byte" }, { "name": "force", "description": "/ If true, then the channel will be closed forcibly. This means the current commitment transaction will be signed and broadcast.", "in": "query", "required": false, "type": "boolean", "format": "boolean" }, { "name": "target_conf", "description": "/ The target number of blocks that the closure transaction should be confirmed by.", "in": "query", "required": false, "type": "integer", "format": "int32" }, { "name": "sat_per_byte", "description": "/ A manual fee rate set in sat/byte that should be used when crafting the closure transaction.", "in": "query", "required": false, "type": "string", "format": "int64" }, { "name": "delivery_address", "description": "An optional address to send funds to in the case of a cooperative close.\nIf the channel was opened with an upfront shutdown script and this field\nis set, the request to close will fail because the channel must pay out\nto the upfront shutdown addresss.", "in": "query", "required": false, "type": "string" } ], "tags": [ "Lightning" ] } }, "/v1/chanpolicy": { "post": { "summary": "* lncli: `updatechanpolicy`\nUpdateChannelPolicy allows the caller to update the fee schedule and\nchannel policies for all channels globally, or a particular channel.", "operationId": "UpdateChannelPolicy", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcPolicyUpdateResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcPolicyUpdateRequest" } } ], "tags": [ "Lightning" ] } }, "/v1/fees": { "get": { "summary": "* lncli: `feereport`\nFeeReport allows the caller to obtain a report detailing the current fee\nschedule enforced by the node globally for each channel.", "operationId": "FeeReport", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcFeeReportResponse" } } }, "tags": [ "Lightning" ] } }, "/v1/genseed": { "get": { "summary": "*\nGenSeed is the first method that should be used to instantiate a new lnd\ninstance. This method allows a caller to generate a new aezeed cipher seed\ngiven an optional passphrase. If provided, the passphrase will be necessary\nto decrypt the cipherseed to expose the internal wallet seed.", "description": "Once the cipherseed is obtained and verified by the user, the InitWallet\nmethod should be used to commit the newly generated seed, and create the\nwallet.", "operationId": "GenSeed", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcGenSeedResponse" } } }, "parameters": [ { "name": "aezeed_passphrase", "description": "*\naezeed_passphrase is an optional user provided passphrase that will be used\nto encrypt the generated aezeed cipher seed. When using REST, this field\nmust be encoded as base64.", "in": "query", "required": false, "type": "string", "format": "byte" }, { "name": "seed_entropy", "description": "*\nseed_entropy is an optional 16-bytes generated via CSPRNG. If not\nspecified, then a fresh set of randomness will be used to create the seed.\nWhen using REST, this field must be encoded as base64.", "in": "query", "required": false, "type": "string", "format": "byte" } ], "tags": [ "WalletUnlocker" ] } }, "/v1/getinfo": { "get": { "summary": "* lncli: `getinfo`\nGetInfo returns general information concerning the lightning node including\nit's identity pubkey, alias, the chains it is connected to, and information\nconcerning the number of open+pending channels.", "operationId": "GetInfo", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcGetInfoResponse" } } }, "tags": [ "Lightning" ] } }, "/v1/graph": { "get": { "summary": "* lncli: `describegraph`\nDescribeGraph returns a description of the latest graph state from the\npoint of view of the node. The graph information is partitioned into two\ncomponents: all the nodes/vertexes, and all the edges that connect the\nvertexes themselves. As this is a directed graph, the edges also contain\nthe node directional specific routing policy which includes: the time lock\ndelta, fee information, etc.", "operationId": "DescribeGraph", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcChannelGraph" } } }, "parameters": [ { "name": "include_unannounced", "description": "*\nWhether unannounced channels are included in the response or not. If set,\nunannounced channels are included. Unannounced channels are both private\nchannels, and public channels that are not yet announced to the network.", "in": "query", "required": false, "type": "boolean", "format": "boolean" } ], "tags": [ "Lightning" ] } }, "/v1/graph/edge/{chan_id}": { "get": { "summary": "* lncli: `getchaninfo`\nGetChanInfo returns the latest authenticated network announcement for the\ngiven channel identified by its channel ID: an 8-byte integer which\nuniquely identifies the location of transaction's funding output within the\nblockchain.", "operationId": "GetChanInfo", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcChannelEdge" } } }, "parameters": [ { "name": "chan_id", "description": "*\nThe unique channel ID for the channel. The first 3 bytes are the block\nheight, the next 3 the index within the block, and the last 2 bytes are the\noutput index for the channel.", "in": "path", "required": true, "type": "string", "format": "uint64" } ], "tags": [ "Lightning" ] } }, "/v1/graph/info": { "get": { "summary": "* lncli: `getnetworkinfo`\nGetNetworkInfo returns some basic stats about the known channel graph from\nthe point of view of the node.", "operationId": "GetNetworkInfo", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcNetworkInfo" } } }, "tags": [ "Lightning" ] } }, "/v1/graph/node/{pub_key}": { "get": { "summary": "* lncli: `getnodeinfo`\nGetNodeInfo returns the latest advertised, aggregated, and authenticated\nchannel information for the specified node identified by its public key.", "operationId": "GetNodeInfo", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcNodeInfo" } } }, "parameters": [ { "name": "pub_key", "description": "/ The 33-byte hex-encoded compressed public of the target node", "in": "path", "required": true, "type": "string" }, { "name": "include_channels", "description": "/ If true, will include all known channels associated with the node.", "in": "query", "required": false, "type": "boolean", "format": "boolean" } ], "tags": [ "Lightning" ] } }, "/v1/graph/routes/{pub_key}/{amt}": { "get": { "summary": "* lncli: `queryroutes`\nQueryRoutes attempts to query the daemon's Channel Router for a possible\nroute to a target destination capable of carrying a specific amount of\nsatoshis. The returned route contains the full details required to craft and\nsend an HTLC, also including the necessary information that should be\npresent within the Sphinx packet encapsulated within the HTLC.", "operationId": "QueryRoutes", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcQueryRoutesResponse" } } }, "parameters": [ { "name": "pub_key", "description": "/ The 33-byte hex-encoded public key for the payment destination", "in": "path", "required": true, "type": "string" }, { "name": "amt", "description": "*\nThe amount to send expressed in satoshis.\n\nThe fields amt and amt_msat are mutually exclusive.", "in": "path", "required": true, "type": "string", "format": "int64" }, { "name": "amt_msat", "description": "*\nThe amount to send expressed in millisatoshis.\n\nThe fields amt and amt_msat are mutually exclusive.", "in": "query", "required": false, "type": "string", "format": "int64" }, { "name": "final_cltv_delta", "description": "*\nAn optional CLTV delta from the current height that should be used for the\ntimelock of the final hop. Note that unlike SendPayment, QueryRoutes does\nnot add any additional block padding on top of final_ctlv_delta. This\npadding of a few blocks needs to be added manually or otherwise failures may\nhappen when a block comes in while the payment is in flight.", "in": "query", "required": false, "type": "integer", "format": "int32" }, { "name": "fee_limit.fixed", "description": "*\nThe fee limit expressed as a fixed amount of satoshis.\n\nThe fields fixed and fixed_msat are mutually exclusive.", "in": "query", "required": false, "type": "string", "format": "int64" }, { "name": "fee_limit.fixed_msat", "description": "*\nThe fee limit expressed as a fixed amount of millisatoshis.\n\nThe fields fixed and fixed_msat are mutually exclusive.", "in": "query", "required": false, "type": "string", "format": "int64" }, { "name": "fee_limit.percent", "description": "/ The fee limit expressed as a percentage of the payment amount.", "in": "query", "required": false, "type": "string", "format": "int64" }, { "name": "ignored_nodes", "description": "*\nA list of nodes to ignore during path finding. When using REST, these fields\nmust be encoded as base64.", "in": "query", "required": false, "type": "array", "items": { "type": "string", "format": "byte" }, "collectionFormat": "multi" }, { "name": "source_pub_key", "description": "*\nThe source node where the request route should originated from. If empty,\nself is assumed.", "in": "query", "required": false, "type": "string" }, { "name": "use_mission_control", "description": "*\nIf set to true, edge probabilities from mission control will be used to get\nthe optimal route.", "in": "query", "required": false, "type": "boolean", "format": "boolean" }, { "name": "cltv_limit", "description": "* \nAn optional maximum total time lock for the route. If the source is empty or\nourselves, this should not exceed lnd's `--max-cltv-expiry` setting. If\nzero, then the value of `--max-cltv-expiry` is used as the limit.", "in": "query", "required": false, "type": "integer", "format": "int64" }, { "name": "outgoing_chan_id", "description": "*\nThe channel id of the channel that must be taken to the first hop. If zero,\nany channel may be used.", "in": "query", "required": false, "type": "string", "format": "uint64" }, { "name": "last_hop_pubkey", "description": "*\nThe pubkey of the last hop of the route. If empty, any hop may be used.", "in": "query", "required": false, "type": "string", "format": "byte" }, { "name": "dest_features", "description": "*\nFeatures assumed to be supported by the final node. All transitive feature\ndependencies must also be set properly. For a given feature bit pair, either\noptional or remote may be set, but not both. If this field is nil or empty,\nthe router will try to load destination features from the graph as a\nfallback.", "in": "query", "required": false, "type": "array", "items": { "type": "string", "enum": [ "DATALOSS_PROTECT_REQ", "DATALOSS_PROTECT_OPT", "INITIAL_ROUING_SYNC", "UPFRONT_SHUTDOWN_SCRIPT_REQ", "UPFRONT_SHUTDOWN_SCRIPT_OPT", "GOSSIP_QUERIES_REQ", "GOSSIP_QUERIES_OPT", "TLV_ONION_REQ", "TLV_ONION_OPT", "EXT_GOSSIP_QUERIES_REQ", "EXT_GOSSIP_QUERIES_OPT", "STATIC_REMOTE_KEY_REQ", "STATIC_REMOTE_KEY_OPT", "PAYMENT_ADDR_REQ", "PAYMENT_ADDR_OPT", "MPP_REQ", "MPP_OPT" ] }, "collectionFormat": "multi" } ], "tags": [ "Lightning" ] } }, "/v1/initwallet": { "post": { "summary": "* \nInitWallet is used when lnd is starting up for the first time to fully\ninitialize the daemon and its internal wallet. At the very least a wallet\npassword must be provided. This will be used to encrypt sensitive material\non disk.", "description": "In the case of a recovery scenario, the user can also specify their aezeed\nmnemonic and passphrase. If set, then the daemon will use this prior state\nto initialize its internal wallet.\n\nAlternatively, this can be used along with the GenSeed RPC to obtain a\nseed, then present it to the user. Once it has been verified by the user,\nthe seed can be fed into this RPC in order to commit the new wallet.", "operationId": "InitWallet", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcInitWalletResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcInitWalletRequest" } } ], "tags": [ "WalletUnlocker" ] } }, "/v1/invoice/{r_hash_str}": { "get": { "summary": "* lncli: `lookupinvoice`\nLookupInvoice attempts to look up an invoice according to its payment hash.\nThe passed payment hash *must* be exactly 32 bytes, if not, an error is\nreturned.", "operationId": "LookupInvoice", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcInvoice" } } }, "parameters": [ { "name": "r_hash_str", "description": "*\nThe hex-encoded payment hash of the invoice to be looked up. The passed\npayment hash must be exactly 32 bytes, otherwise an error is returned.\nDeprecated now that the REST gateway supports base64 encoding of bytes\nfields.", "in": "path", "required": true, "type": "string" }, { "name": "r_hash", "description": "*\nThe payment hash of the invoice to be looked up. When using REST, this field\nmust be encoded as base64.", "in": "query", "required": false, "type": "string", "format": "byte" } ], "tags": [ "Lightning" ] } }, "/v1/invoices": { "get": { "summary": "* lncli: `listinvoices`\nListInvoices returns a list of all the invoices currently stored within the\ndatabase. Any active debug invoices are ignored. It has full support for\npaginated responses, allowing users to query for specific invoices through\ntheir add_index. This can be done by using either the first_index_offset or\nlast_index_offset fields included in the response as the index_offset of the\nnext request. By default, the first 100 invoices created will be returned.\nBackwards pagination is also supported through the Reversed flag.", "operationId": "ListInvoices", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcListInvoiceResponse" } } }, "parameters": [ { "name": "pending_only", "description": "*\nIf set, only invoices that are not settled and not canceled will be returned\nin the response.", "in": "query", "required": false, "type": "boolean", "format": "boolean" }, { "name": "index_offset", "description": "*\nThe index of an invoice that will be used as either the start or end of a\nquery to determine which invoices should be returned in the response.", "in": "query", "required": false, "type": "string", "format": "uint64" }, { "name": "num_max_invoices", "description": "/ The max number of invoices to return in the response to this query.", "in": "query", "required": false, "type": "string", "format": "uint64" }, { "name": "reversed", "description": "*\nIf set, the invoices returned will result from seeking backwards from the\nspecified index offset. This can be used to paginate backwards.", "in": "query", "required": false, "type": "boolean", "format": "boolean" } ], "tags": [ "Lightning" ] }, "post": { "summary": "* lncli: `addinvoice`\nAddInvoice attempts to add a new invoice to the invoice database. Any\nduplicated invoices are rejected, therefore all invoices *must* have a\nunique payment preimage.", "operationId": "AddInvoice", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcAddInvoiceResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcInvoice" } } ], "tags": [ "Lightning" ] } }, "/v1/invoices/subscribe": { "get": { "summary": "*\nSubscribeInvoices returns a uni-directional stream (server -\u003e client) for\nnotifying the client of newly added/settled invoices. The caller can\noptionally specify the add_index and/or the settle_index. If the add_index\nis specified, then we'll first start by sending add invoice events for all\ninvoices with an add_index greater than the specified value. If the\nsettle_index is specified, the next, we'll send out all settle events for\ninvoices with a settle_index greater than the specified value. One or both\nof these fields can be set. If no fields are set, then we'll only send out\nthe latest add/settle events.", "operationId": "SubscribeInvoices", "responses": { "200": { "description": "A successful response.(streaming responses)", "schema": { "$ref": "#/x-stream-definitions/lnrpcInvoice" } } }, "parameters": [ { "name": "add_index", "description": "*\nIf specified (non-zero), then we'll first start by sending out\nnotifications for all added indexes with an add_index greater than this\nvalue. This allows callers to catch up on any events they missed while they\nweren't connected to the streaming RPC.", "in": "query", "required": false, "type": "string", "format": "uint64" }, { "name": "settle_index", "description": "*\nIf specified (non-zero), then we'll first start by sending out\nnotifications for all settled indexes with an settle_index greater than\nthis value. This allows callers to catch up on any events they missed while\nthey weren't connected to the streaming RPC.", "in": "query", "required": false, "type": "string", "format": "uint64" } ], "tags": [ "Lightning" ] } }, "/v1/macaroon": { "post": { "summary": "* lncli: `bakemacaroon`\nBakeMacaroon allows the creation of a new macaroon with custom read and\nwrite permissions. No first-party caveats are added since this can be done\noffline.", "operationId": "BakeMacaroon", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcBakeMacaroonResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcBakeMacaroonRequest" } } ], "tags": [ "Lightning" ] } }, "/v1/newaddress": { "get": { "summary": "* lncli: `newaddress`\nNewAddress creates a new address under control of the local wallet.", "operationId": "NewAddress", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcNewAddressResponse" } } }, "parameters": [ { "name": "type", "description": "/ The address type.", "in": "query", "required": false, "type": "string", "enum": [ "WITNESS_PUBKEY_HASH", "NESTED_PUBKEY_HASH", "UNUSED_WITNESS_PUBKEY_HASH", "UNUSED_NESTED_PUBKEY_HASH" ], "default": "WITNESS_PUBKEY_HASH" } ], "tags": [ "Lightning" ] } }, "/v1/payments": { "get": { "summary": "* lncli: `listpayments`\nListPayments returns a list of all outgoing payments.", "operationId": "ListPayments", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcListPaymentsResponse" } } }, "parameters": [ { "name": "include_incomplete", "description": "*\nIf true, then return payments that have not yet fully completed. This means\nthat pending payments, as well as failed payments will show up if this\nfield is set to True.", "in": "query", "required": false, "type": "boolean", "format": "boolean" } ], "tags": [ "Lightning" ] }, "delete": { "summary": "*\nDeleteAllPayments deletes all outgoing payments from DB.", "operationId": "DeleteAllPayments", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcDeleteAllPaymentsResponse" } } }, "tags": [ "Lightning" ] } }, "/v1/payreq/{pay_req}": { "get": { "summary": "* lncli: `decodepayreq`\nDecodePayReq takes an encoded payment request string and attempts to decode\nit, returning a full description of the conditions encoded within the\npayment request.", "operationId": "DecodePayReq", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcPayReq" } } }, "parameters": [ { "name": "pay_req", "description": "/ The payment request string to be decoded", "in": "path", "required": true, "type": "string" } ], "tags": [ "Lightning" ] } }, "/v1/peers": { "get": { "summary": "* lncli: `listpeers`\nListPeers returns a verbose listing of all currently active peers.", "operationId": "ListPeers", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcListPeersResponse" } } }, "tags": [ "Lightning" ] }, "post": { "summary": "* lncli: `connect`\nConnectPeer attempts to establish a connection to a remote peer. This is at\nthe networking level, and is used for communication between nodes. This is\ndistinct from establishing a channel with a peer.", "operationId": "ConnectPeer", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcConnectPeerResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcConnectPeerRequest" } } ], "tags": [ "Lightning" ] } }, "/v1/peers/{pub_key}": { "delete": { "summary": "* lncli: `disconnect`\nDisconnectPeer attempts to disconnect one peer from another identified by a\ngiven pubKey. In the case that we currently have a pending or active channel\nwith the target peer, then this action will be not be allowed.", "operationId": "DisconnectPeer", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcDisconnectPeerResponse" } } }, "parameters": [ { "name": "pub_key", "description": "/ The pubkey of the node to disconnect from", "in": "path", "required": true, "type": "string" } ], "tags": [ "Lightning" ] } }, "/v1/signmessage": { "post": { "summary": "* lncli: `signmessage`\nSignMessage signs a message with this node's private key. The returned\nsignature string is `zbase32` encoded and pubkey recoverable, meaning that\nonly the message digest and signature are needed for verification.", "operationId": "SignMessage", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcSignMessageResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcSignMessageRequest" } } ], "tags": [ "Lightning" ] } }, "/v1/switch": { "post": { "summary": "* lncli: `fwdinghistory`\nForwardingHistory allows the caller to query the htlcswitch for a record of\nall HTLCs forwarded within the target time range, and integer offset\nwithin that time range. If no time-range is specified, then the first chunk\nof the past 24 hrs of forwarding history are returned.", "description": "A list of forwarding events are returned. The size of each forwarding event\nis 40 bytes, and the max message size able to be returned in gRPC is 4 MiB.\nAs a result each message can only contain 50k entries. Each response has\nthe index offset of the last entry. The index offset can be provided to the\nrequest to allow the caller to skip a series of records.", "operationId": "ForwardingHistory", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcForwardingHistoryResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcForwardingHistoryRequest" } } ], "tags": [ "Lightning" ] } }, "/v1/transactions": { "get": { "summary": "* lncli: `listchaintxns`\nGetTransactions returns a list describing all the known transactions\nrelevant to the wallet.", "operationId": "GetTransactions", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcTransactionDetails" } } }, "tags": [ "Lightning" ] }, "post": { "summary": "* lncli: `sendcoins`\nSendCoins executes a request to send coins to a particular address. Unlike\nSendMany, this RPC call only allows creating a single output at a time. If\nneither target_conf, or sat_per_byte are set, then the internal wallet will\nconsult its fee model to determine a fee for the default confirmation\ntarget.", "operationId": "SendCoins", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcSendCoinsResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcSendCoinsRequest" } } ], "tags": [ "Lightning" ] } }, "/v1/transactions/fee": { "get": { "summary": "* lncli: `estimatefee`\nEstimateFee asks the chain backend to estimate the fee rate and total fees\nfor a transaction that pays to multiple specified outputs.", "operationId": "EstimateFee", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcEstimateFeeResponse" } } }, "parameters": [ { "name": "target_conf", "description": "/ The target number of blocks that this transaction should be confirmed by.", "in": "query", "required": false, "type": "integer", "format": "int32" } ], "tags": [ "Lightning" ] } }, "/v1/unlockwallet": { "post": { "summary": "* lncli: `unlock`\nUnlockWallet is used at startup of lnd to provide a password to unlock\nthe wallet database.", "operationId": "UnlockWallet", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcUnlockWalletResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcUnlockWalletRequest" } } ], "tags": [ "WalletUnlocker" ] } }, "/v1/utxos": { "get": { "summary": "* lncli: `listunspent`\nListUnspent returns a list of all utxos spendable by the wallet with a\nnumber of confirmations between the specified minimum and maximum.", "operationId": "ListUnspent", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcListUnspentResponse" } } }, "parameters": [ { "name": "min_confs", "description": "/ The minimum number of confirmations to be included.", "in": "query", "required": false, "type": "integer", "format": "int32" }, { "name": "max_confs", "description": "/ The maximum number of confirmations to be included.", "in": "query", "required": false, "type": "integer", "format": "int32" } ], "tags": [ "Lightning" ] } }, "/v1/verifymessage": { "post": { "summary": "* lncli: `verifymessage`\nVerifyMessage verifies a signature over a msg. The signature must be\nzbase32 encoded and signed by an active node in the resident node's\nchannel database. In addition to returning the validity of the signature,\nVerifyMessage also returns the recovered pubkey from the signature.", "operationId": "VerifyMessage", "responses": { "200": { "description": "A successful response.", "schema": { "$ref": "#/definitions/lnrpcVerifyMessageResponse" } } }, "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "$ref": "#/definitions/lnrpcVerifyMessageRequest" } } ], "tags": [ "Lightning" ] } } }, "definitions": { "ChannelCloseSummaryClosureType": { "type": "string", "enum": [ "COOPERATIVE_CLOSE", "LOCAL_FORCE_CLOSE", "REMOTE_FORCE_CLOSE", "BREACH_CLOSE", "FUNDING_CANCELED", "ABANDONED" ], "default": "COOPERATIVE_CLOSE" }, "ChannelEventUpdateUpdateType": { "type": "string", "enum": [ "OPEN_CHANNEL", "CLOSED_CHANNEL", "ACTIVE_CHANNEL", "INACTIVE_CHANNEL", "PENDING_OPEN_CHANNEL" ], "default": "OPEN_CHANNEL" }, "HTLCAttemptHTLCStatus": { "type": "string", "enum": [ "IN_FLIGHT", "SUCCEEDED", "FAILED" ], "default": "IN_FLIGHT" }, "InvoiceInvoiceState": { "type": "string", "enum": [ "OPEN", "SETTLED", "CANCELED", "ACCEPTED" ], "default": "OPEN" }, "PaymentPaymentStatus": { "type": "string", "enum": [ "UNKNOWN", "IN_FLIGHT", "SUCCEEDED", "FAILED" ], "default": "UNKNOWN" }, "PeerEventEventType": { "type": "string", "enum": [ "PEER_ONLINE", "PEER_OFFLINE" ], "default": "PEER_ONLINE" }, "PeerSyncType": { "type": "string", "enum": [ "UNKNOWN_SYNC", "ACTIVE_SYNC", "PASSIVE_SYNC" ], "default": "UNKNOWN_SYNC", "description": " - UNKNOWN_SYNC: *\nDenotes that we cannot determine the peer's current sync type.\n - ACTIVE_SYNC: *\nDenotes that we are actively receiving new graph updates from the peer.\n - PASSIVE_SYNC: *\nDenotes that we are not receiving new graph updates from the peer." }, "PendingChannelsResponseClosedChannel": { "type": "object", "properties": { "channel": { "$ref": "#/definitions/PendingChannelsResponsePendingChannel", "title": "/ The pending channel to be closed" }, "closing_txid": { "type": "string", "title": "/ The transaction id of the closing transaction" } } }, "PendingChannelsResponseForceClosedChannel": { "type": "object", "properties": { "channel": { "$ref": "#/definitions/PendingChannelsResponsePendingChannel", "title": "/ The pending channel to be force closed" }, "closing_txid": { "type": "string", "title": "/ The transaction id of the closing transaction" }, "limbo_balance": { "type": "string", "format": "int64", "title": "/ The balance in satoshis encumbered in this pending channel" }, "maturity_height": { "type": "integer", "format": "int64", "title": "/ The height at which funds can be swept into the wallet" }, "blocks_til_maturity": { "type": "integer", "format": "int32", "description": "Remaining # of blocks until the commitment output can be swept.\nNegative values indicate how many blocks have passed since becoming\nmature." }, "recovered_balance": { "type": "string", "format": "int64", "title": "/ The total value of funds successfully recovered from this channel" }, "pending_htlcs": { "type": "array", "items": { "$ref": "#/definitions/lnrpcPendingHTLC" } } } }, "PendingChannelsResponsePendingChannel": { "type": "object", "properties": { "remote_node_pub": { "type": "string" }, "channel_point": { "type": "string" }, "capacity": { "type": "string", "format": "int64" }, "local_balance": { "type": "string", "format": "int64" }, "remote_balance": { "type": "string", "format": "int64" }, "local_chan_reserve_sat": { "type": "string", "format": "int64", "description": "/ The minimum satoshis this node is required to reserve in its balance." }, "remote_chan_reserve_sat": { "type": "string", "format": "int64", "description": "*\nThe minimum satoshis the other node is required to reserve in its\nbalance." } } }, "PendingChannelsResponsePendingOpenChannel": { "type": "object", "properties": { "channel": { "$ref": "#/definitions/PendingChannelsResponsePendingChannel", "title": "/ The pending channel" }, "confirmation_height": { "type": "integer", "format": "int64", "title": "/ The height at which this channel will be confirmed" }, "commit_fee": { "type": "string", "format": "int64", "description": "*\nThe amount calculated to be paid in fees for the current set of\ncommitment transactions. The fee amount is persisted with the channel\nin order to allow the fee amount to be removed and recalculated with\neach channel state update, including updates that happen after a system\nrestart." }, "commit_weight": { "type": "string", "format": "int64", "title": "/ The weight of the commitment transaction" }, "fee_per_kw": { "type": "string", "format": "int64", "description": "*\nThe required number of satoshis per kilo-weight that the requester will\npay at all times, for both the funding transaction and commitment\ntransaction. This value can later be updated once the channel is open." } } }, "PendingChannelsResponseWaitingCloseChannel": { "type": "object", "properties": { "channel": { "$ref": "#/definitions/PendingChannelsResponsePendingChannel", "title": "/ The pending channel waiting for closing tx to confirm" }, "limbo_balance": { "type": "string", "format": "int64", "title": "/ The balance in satoshis encumbered in this channel" } } }, "lnrpcAbandonChannelResponse": { "type": "object" }, "lnrpcAddInvoiceResponse": { "type": "object", "properties": { "r_hash": { "type": "string", "format": "byte" }, "payment_request": { "type": "string", "description": "*\nA bare-bones invoice for a payment within the Lightning Network. With the\ndetails of the invoice, the sender has all the data necessary to send a\npayment to the recipient." }, "add_index": { "type": "string", "format": "uint64", "description": "*\nThe \"add\" index of this invoice. Each newly created invoice will increment\nthis index making it monotonically increasing. Callers to the\nSubscribeInvoices call can use this to instantly get notified of all added\ninvoices with an add_index greater than this one." } } }, "lnrpcAddressType": { "type": "string", "enum": [ "WITNESS_PUBKEY_HASH", "NESTED_PUBKEY_HASH", "UNUSED_WITNESS_PUBKEY_HASH", "UNUSED_NESTED_PUBKEY_HASH" ], "default": "WITNESS_PUBKEY_HASH", "description": "- `p2wkh`: Pay to witness key hash (`WITNESS_PUBKEY_HASH` = 0)\n- `np2wkh`: Pay to nested witness key hash (`NESTED_PUBKEY_HASH` = 1)", "title": "* \n`AddressType` has to be one of:" }, "lnrpcBakeMacaroonRequest": { "type": "object", "properties": { "permissions": { "type": "array", "items": { "$ref": "#/definitions/lnrpcMacaroonPermission" }, "description": "/ The list of permissions the new macaroon should grant." } } }, "lnrpcBakeMacaroonResponse": { "type": "object", "properties": { "macaroon": { "type": "string", "description": "/ The hex encoded macaroon, serialized in binary format." } } }, "lnrpcChain": { "type": "object", "properties": { "chain": { "type": "string", "title": "/ The blockchain the node is on (eg bitcoin, litecoin)" }, "network": { "type": "string", "title": "/ The network the node is on (eg regtest, testnet, mainnet)" } } }, "lnrpcChanBackupSnapshot": { "type": "object", "properties": { "single_chan_backups": { "$ref": "#/definitions/lnrpcChannelBackups", "description": "*\nThe set of new channels that have been added since the last channel backup\nsnapshot was requested." }, "multi_chan_backup": { "$ref": "#/definitions/lnrpcMultiChanBackup", "description": "*\nA multi-channel backup that covers all open channels currently known to\nlnd." } } }, "lnrpcChanPointShim": { "type": "object", "properties": { "amt": { "type": "string", "format": "int64", "description": "*\nThe size of the pre-crafted output to be used as the channel point for this\nchannel funding." }, "chan_point": { "$ref": "#/definitions/lnrpcChannelPoint", "description": "/ The target channel point to refrence in created commitment transactions." }, "local_key": { "$ref": "#/definitions/lnrpcKeyDescriptor", "description": "/ Our local key to use when creating the multi-sig output." }, "remote_key": { "type": "string", "format": "byte", "description": "/ The key of the remote party to use when creating the multi-sig output." }, "pending_chan_id": { "type": "string", "format": "byte", "description": "*\nIf non-zero, then this will be used as the pending channel ID on the wire\nprotocol to initate the funding request. This is an optional field, and\nshould only be set if the responder is already expecting a specific pending\nchannel ID." } } }, "lnrpcChangePasswordRequest": { "type": "object", "properties": { "current_password": { "type": "string", "format": "byte", "description": "*\ncurrent_password should be the current valid passphrase used to unlock the\ndaemon. When using REST, this field must be encoded as base64." }, "new_password": { "type": "string", "format": "byte", "description": "*\nnew_password should be the new passphrase that will be needed to unlock the\ndaemon. When using REST, this field must be encoded as base64." } } }, "lnrpcChangePasswordResponse": { "type": "object" }, "lnrpcChannel": { "type": "object", "properties": { "active": { "type": "boolean", "format": "boolean", "title": "/ Whether this channel is active or not" }, "remote_pubkey": { "type": "string", "title": "/ The identity pubkey of the remote node" }, "channel_point": { "type": "string", "description": "*\nThe outpoint (txid:index) of the funding transaction. With this value, Bob\nwill be able to generate a signature for Alice's version of the commitment\ntransaction." }, "chan_id": { "type": "string", "format": "uint64", "description": "*\nThe unique channel ID for the channel. The first 3 bytes are the block\nheight, the next 3 the index within the block, and the last 2 bytes are the\noutput index for the channel." }, "capacity": { "type": "string", "format": "int64", "title": "/ The total amount of funds held in this channel" }, "local_balance": { "type": "string", "format": "int64", "title": "/ This node's current balance in this channel" }, "remote_balance": { "type": "string", "format": "int64", "title": "/ The counterparty's current balance in this channel" }, "commit_fee": { "type": "string", "format": "int64", "description": "*\nThe amount calculated to be paid in fees for the current set of commitment\ntransactions. The fee amount is persisted with the channel in order to\nallow the fee amount to be removed and recalculated with each channel state\nupdate, including updates that happen after a system restart." }, "commit_weight": { "type": "string", "format": "int64", "title": "/ The weight of the commitment transaction" }, "fee_per_kw": { "type": "string", "format": "int64", "description": "*\nThe required number of satoshis per kilo-weight that the requester will pay\nat all times, for both the funding transaction and commitment transaction.\nThis value can later be updated once the channel is open." }, "unsettled_balance": { "type": "string", "format": "int64", "title": "/ The unsettled balance in this channel" }, "total_satoshis_sent": { "type": "string", "format": "int64", "description": "*\nThe total number of satoshis we've sent within this channel." }, "total_satoshis_received": { "type": "string", "format": "int64", "description": "*\nThe total number of satoshis we've received within this channel." }, "num_updates": { "type": "string", "format": "uint64", "description": "*\nThe total number of updates conducted within this channel." }, "pending_htlcs": { "type": "array", "items": { "$ref": "#/definitions/lnrpcHTLC" }, "description": "*\nThe list of active, uncleared HTLCs currently pending within the channel." }, "csv_delay": { "type": "integer", "format": "int64", "description": "*\nThe CSV delay expressed in relative blocks. If the channel is force closed,\nwe will need to wait for this many blocks before we can regain our funds." }, "private": { "type": "boolean", "format": "boolean", "description": "/ Whether this channel is advertised to the network or not." }, "initiator": { "type": "boolean", "format": "boolean", "description": "/ True if we were the ones that created the channel." }, "chan_status_flags": { "type": "string", "description": "/ A set of flags showing the current state of the channel." }, "local_chan_reserve_sat": { "type": "string", "format": "int64", "description": "/ The minimum satoshis this node is required to reserve in its balance." }, "remote_chan_reserve_sat": { "type": "string", "format": "int64", "description": "*\nThe minimum satoshis the other node is required to reserve in its balance." }, "static_remote_key": { "type": "boolean", "format": "boolean", "description": "*\nIf true, then this channel uses the modern commitment format where the key\nin the output of the remote party does not change each state. This makes\nback up and recovery easier as when the channel is closed, the funds go\ndirectly to that key." }, "lifetime": { "type": "string", "format": "int64", "description": "*\nThe number of seconds that the channel has been monitored by the channel\nscoring system. Scores are currently not persisted, so this value may be\nless than the lifetime of the channel [EXPERIMENTAL]." }, "uptime": { "type": "string", "format": "int64", "description": "*\nThe number of seconds that the remote peer has been observed as being online\nby the channel scoring system over the lifetime of the channel [EXPERIMENTAL]." }, "close_address": { "type": "string", "description": "*\nClose address is the address that we will enforce payout to on cooperative\nclose if the channel was opened utilizing option upfront shutdown. This\nvalue can be set on channel open by setting close_address in an open channel\nrequest. If this value is not set, you can still choose a payout address by\ncooperatively closing with the delivery_address field set." } } }, "lnrpcChannelAcceptRequest": { "type": "object", "properties": { "node_pubkey": { "type": "string", "format": "byte", "description": "/ The pubkey of the node that wishes to open an inbound channel." }, "chain_hash": { "type": "string", "format": "byte", "description": "/ The hash of the genesis block that the proposed channel resides in." }, "pending_chan_id": { "type": "string", "format": "byte", "description": "/ The pending channel id." }, "funding_amt": { "type": "string", "format": "uint64", "description": "/ The funding amount in satoshis that initiator wishes to use in the channel." }, "push_amt": { "type": "string", "format": "uint64", "description": "/ The push amount of the proposed channel in millisatoshis." }, "dust_limit": { "type": "string", "format": "uint64", "description": "/ The dust limit of the initiator's commitment tx." }, "max_value_in_flight": { "type": "string", "format": "uint64", "description": "/ The maximum amount of coins in millisatoshis that can be pending in this channel." }, "channel_reserve": { "type": "string", "format": "uint64", "description": "/ The minimum amount of satoshis the initiator requires us to have at all times." }, "min_htlc": { "type": "string", "format": "uint64", "description": "/ The smallest HTLC in millisatoshis that the initiator will accept." }, "fee_per_kw": { "type": "string", "format": "uint64", "description": "/ The initial fee rate that the initiator suggests for both commitment transactions." }, "csv_delay": { "type": "integer", "format": "int64", "description": "*\nThe number of blocks to use for the relative time lock in the pay-to-self output\nof both commitment transactions." }, "max_accepted_htlcs": { "type": "integer", "format": "int64", "description": "/ The total number of incoming HTLC's that the initiator will accept." }, "channel_flags": { "type": "integer", "format": "int64", "description": "/ A bit-field which the initiator uses to specify proposed channel behavior." } } }, "lnrpcChannelBackup": { "type": "object", "properties": { "chan_point": { "$ref": "#/definitions/lnrpcChannelPoint", "description": "*\nIdentifies the channel that this backup belongs to." }, "chan_backup": { "type": "string", "format": "byte", "description": "*\nIs an encrypted single-chan backup. this can be passed to\nRestoreChannelBackups, or the WalletUnlocker Init and Unlock methods in\norder to trigger the recovery protocol. When using REST, this field must be\nencoded as base64." } } }, "lnrpcChannelBackups": { "type": "object", "properties": { "chan_backups": { "type": "array", "items": { "$ref": "#/definitions/lnrpcChannelBackup" }, "description": "*\nA set of single-chan static channel backups." } } }, "lnrpcChannelBalanceResponse": { "type": "object", "properties": { "balance": { "type": "string", "format": "int64", "title": "/ Sum of channels balances denominated in satoshis" }, "pending_open_balance": { "type": "string", "format": "int64", "title": "/ Sum of channels pending balances denominated in satoshis" } } }, "lnrpcChannelCloseSummary": { "type": "object", "properties": { "channel_point": { "type": "string", "description": "/ The outpoint (txid:index) of the funding transaction." }, "chan_id": { "type": "string", "format": "uint64", "description": "/ The unique channel ID for the channel." }, "chain_hash": { "type": "string", "description": "/ The hash of the genesis block that this channel resides within." }, "closing_tx_hash": { "type": "string", "description": "/ The txid of the transaction which ultimately closed this channel." }, "remote_pubkey": { "type": "string", "description": "/ Public key of the remote peer that we formerly had a channel with." }, "capacity": { "type": "string", "format": "int64", "description": "/ Total capacity of the channel." }, "close_height": { "type": "integer", "format": "int64", "description": "/ Height at which the funding transaction was spent." }, "settled_balance": { "type": "string", "format": "int64", "title": "/ Settled balance at the time of channel closure" }, "time_locked_balance": { "type": "string", "format": "int64", "title": "/ The sum of all the time-locked outputs at the time of channel closure" }, "close_type": { "$ref": "#/definitions/ChannelCloseSummaryClosureType", "description": "/ Details on how the channel was closed." } } }, "lnrpcChannelCloseUpdate": { "type": "object", "properties": { "closing_txid": { "type": "string", "format": "byte" }, "success": { "type": "boolean", "format": "boolean" } } }, "lnrpcChannelEdge": { "type": "object", "properties": { "channel_id": { "type": "string", "format": "uint64", "description": "*\nThe unique channel ID for the channel. The first 3 bytes are the block\nheight, the next 3 the index within the block, and the last 2 bytes are the\noutput index for the channel." }, "chan_point": { "type": "string" }, "last_update": { "type": "integer", "format": "int64" }, "node1_pub": { "type": "string" }, "node2_pub": { "type": "string" }, "capacity": { "type": "string", "format": "int64" }, "node1_policy": { "$ref": "#/definitions/lnrpcRoutingPolicy" }, "node2_policy": { "$ref": "#/definitions/lnrpcRoutingPolicy" } }, "description": "*\nA fully authenticated channel along with all its unique attributes.\nOnce an authenticated channel announcement has been processed on the network,\nthen an instance of ChannelEdgeInfo encapsulating the channels attributes is\nstored. The other portions relevant to routing policy of a channel are stored\nwithin a ChannelEdgePolicy for each direction of the channel." }, "lnrpcChannelEdgeUpdate": { "type": "object", "properties": { "chan_id": { "type": "string", "format": "uint64", "description": "*\nThe unique channel ID for the channel. The first 3 bytes are the block\nheight, the next 3 the index within the block, and the last 2 bytes are the\noutput index for the channel." }, "chan_point": { "$ref": "#/definitions/lnrpcChannelPoint" }, "capacity": { "type": "string", "format": "int64" }, "routing_policy": { "$ref": "#/definitions/lnrpcRoutingPolicy" }, "advertising_node": { "type": "string" }, "connecting_node": { "type": "string" } } }, "lnrpcChannelEventUpdate": { "type": "object", "properties": { "open_channel": { "$ref": "#/definitions/lnrpcChannel" }, "closed_channel": { "$ref": "#/definitions/lnrpcChannelCloseSummary" }, "active_channel": { "$ref": "#/definitions/lnrpcChannelPoint" }, "inactive_channel": { "$ref": "#/definitions/lnrpcChannelPoint" }, "pending_open_channel": { "$ref": "#/definitions/lnrpcPendingUpdate" }, "type": { "$ref": "#/definitions/ChannelEventUpdateUpdateType" } } }, "lnrpcChannelFeeReport": { "type": "object", "properties": { "chan_point": { "type": "string", "description": "/ The channel that this fee report belongs to." }, "base_fee_msat": { "type": "string", "format": "int64", "description": "/ The base fee charged regardless of the number of milli-satoshis sent." }, "fee_per_mil": { "type": "string", "format": "int64", "description": "/ The amount charged per milli-satoshis transferred expressed in millionths of a satoshi." }, "fee_rate": { "type": "number", "format": "double", "description": "/ The effective fee rate in milli-satoshis. Computed by dividing the fee_per_mil value by 1 million." } } }, "lnrpcChannelGraph": { "type": "object", "properties": { "nodes": { "type": "array", "items": { "$ref": "#/definitions/lnrpcLightningNode" }, "title": "/ The list of `LightningNode`s in this channel graph" }, "edges": { "type": "array", "items": { "$ref": "#/definitions/lnrpcChannelEdge" }, "title": "/ The list of `ChannelEdge`s in this channel graph" } }, "description": "/ Returns a new instance of the directed channel graph." }, "lnrpcChannelOpenUpdate": { "type": "object", "properties": { "channel_point": { "$ref": "#/definitions/lnrpcChannelPoint" } } }, "lnrpcChannelPoint": { "type": "object", "properties": { "funding_txid_bytes": { "type": "string", "format": "byte", "description": "*\nTxid of the funding transaction. When using REST, this field must be\nencoded as base64." }, "funding_txid_str": { "type": "string", "description": "*\nHex-encoded string representing the byte-reversed hash of the funding\ntransaction." }, "output_index": { "type": "integer", "format": "int64", "title": "/ The index of the output of the funding transaction" } } }, "lnrpcCloseStatusUpdate": { "type": "object", "properties": { "close_pending": { "$ref": "#/definitions/lnrpcPendingUpdate" }, "chan_close": { "$ref": "#/definitions/lnrpcChannelCloseUpdate" } } }, "lnrpcClosedChannelUpdate": { "type": "object", "properties": { "chan_id": { "type": "string", "format": "uint64", "description": "*\nThe unique channel ID for the channel. The first 3 bytes are the block\nheight, the next 3 the index within the block, and the last 2 bytes are the\noutput index for the channel." }, "capacity": { "type": "string", "format": "int64" }, "closed_height": { "type": "integer", "format": "int64" }, "chan_point": { "$ref": "#/definitions/lnrpcChannelPoint" } } }, "lnrpcClosedChannelsResponse": { "type": "object", "properties": { "channels": { "type": "array", "items": { "$ref": "#/definitions/lnrpcChannelCloseSummary" } } } }, "lnrpcConnectPeerRequest": { "type": "object", "properties": { "addr": { "$ref": "#/definitions/lnrpcLightningAddress", "title": "/ Lightning address of the peer, in the format `\u003cpubkey\u003e@host`" }, "perm": { "type": "boolean", "format": "boolean", "description": "* If set, the daemon will attempt to persistently connect to the target\npeer. Otherwise, the call will be synchronous." } } }, "lnrpcConnectPeerResponse": { "type": "object" }, "lnrpcDebugLevelResponse": { "type": "object", "properties": { "sub_systems": { "type": "string" } } }, "lnrpcDeleteAllPaymentsResponse": { "type": "object" }, "lnrpcDisconnectPeerResponse": { "type": "object" }, "lnrpcEdgeLocator": { "type": "object", "properties": { "channel_id": { "type": "string", "format": "uint64", "description": "/ The short channel id of this edge." }, "direction_reverse": { "type": "boolean", "format": "boolean", "description": "*\nThe direction of this edge. If direction_reverse is false, the direction\nof this edge is from the channel endpoint with the lexicographically smaller\npub key to the endpoint with the larger pub key. If direction_reverse is\nis true, the edge goes the other way." } } }, "lnrpcEstimateFeeResponse": { "type": "object", "properties": { "fee_sat": { "type": "string", "format": "int64", "description": "/ The total fee in satoshis." }, "feerate_sat_per_byte": { "type": "string", "format": "int64", "description": "/ The fee rate in satoshi/byte." } } }, "lnrpcFeature": { "type": "object", "properties": { "name": { "type": "string" }, "is_required": { "type": "boolean", "format": "boolean" }, "is_known": { "type": "boolean", "format": "boolean" } } }, "lnrpcFeatureBit": { "type": "string", "enum": [ "DATALOSS_PROTECT_REQ", "DATALOSS_PROTECT_OPT", "INITIAL_ROUING_SYNC", "UPFRONT_SHUTDOWN_SCRIPT_REQ", "UPFRONT_SHUTDOWN_SCRIPT_OPT", "GOSSIP_QUERIES_REQ", "GOSSIP_QUERIES_OPT", "TLV_ONION_REQ", "TLV_ONION_OPT", "EXT_GOSSIP_QUERIES_REQ", "EXT_GOSSIP_QUERIES_OPT", "STATIC_REMOTE_KEY_REQ", "STATIC_REMOTE_KEY_OPT", "PAYMENT_ADDR_REQ", "PAYMENT_ADDR_OPT", "MPP_REQ", "MPP_OPT" ], "default": "DATALOSS_PROTECT_REQ" }, "lnrpcFeeLimit": { "type": "object", "properties": { "fixed": { "type": "string", "format": "int64", "description": "*\nThe fee limit expressed as a fixed amount of satoshis.\n\nThe fields fixed and fixed_msat are mutually exclusive." }, "fixed_msat": { "type": "string", "format": "int64", "description": "*\nThe fee limit expressed as a fixed amount of millisatoshis.\n\nThe fields fixed and fixed_msat are mutually exclusive." }, "percent": { "type": "string", "format": "int64", "description": "/ The fee limit expressed as a percentage of the payment amount." } } }, "lnrpcFeeReportResponse": { "type": "object", "properties": { "channel_fees": { "type": "array", "items": { "$ref": "#/definitions/lnrpcChannelFeeReport" }, "description": "/ An array of channel fee reports which describes the current fee schedule for each channel." }, "day_fee_sum": { "type": "string", "format": "uint64", "description": "/ The total amount of fee revenue (in satoshis) the switch has collected over the past 24 hrs." }, "week_fee_sum": { "type": "string", "format": "uint64", "description": "/ The total amount of fee revenue (in satoshis) the switch has collected over the past 1 week." }, "month_fee_sum": { "type": "string", "format": "uint64", "description": "/ The total amount of fee revenue (in satoshis) the switch has collected over the past 1 month." } } }, "lnrpcForwardingEvent": { "type": "object", "properties": { "timestamp": { "type": "string", "format": "uint64", "description": "/ Timestamp is the time (unix epoch offset) that this circuit was completed." }, "chan_id_in": { "type": "string", "format": "uint64", "description": "/ The incoming channel ID that carried the HTLC that created the circuit." }, "chan_id_out": { "type": "string", "format": "uint64", "description": "/ The outgoing channel ID that carried the preimage that completed the circuit." }, "amt_in": { "type": "string", "format": "uint64", "description": "/ The total amount (in satoshis) of the incoming HTLC that created half the circuit." }, "amt_out": { "type": "string", "format": "uint64", "description": "/ The total amount (in satoshis) of the outgoing HTLC that created the second half of the circuit." }, "fee": { "type": "string", "format": "uint64", "description": "/ The total fee (in satoshis) that this payment circuit carried." }, "fee_msat": { "type": "string", "format": "uint64", "description": "/ The total fee (in milli-satoshis) that this payment circuit carried." }, "amt_in_msat": { "type": "string", "format": "uint64", "description": "/ The total amount (in milli-satoshis) of the incoming HTLC that created half the circuit." }, "amt_out_msat": { "type": "string", "format": "uint64", "description": "/ The total amount (in milli-satoshis) of the outgoing HTLC that created the second half of the circuit." } } }, "lnrpcForwardingHistoryRequest": { "type": "object", "properties": { "start_time": { "type": "string", "format": "uint64", "description": "/ Start time is the starting point of the forwarding history request. All records beyond this point will be included, respecting the end time, and the index offset." }, "end_time": { "type": "string", "format": "uint64", "description": "/ End time is the end point of the forwarding history request. The response will carry at most 50k records between the start time and the end time. The index offset can be used to implement pagination." }, "index_offset": { "type": "integer", "format": "int64", "description": "/ Index offset is the offset in the time series to start at. As each response can only contain 50k records, callers can use this to skip around within a packed time series." }, "num_max_events": { "type": "integer", "format": "int64", "description": "/ The max number of events to return in the response to this query." } } }, "lnrpcForwardingHistoryResponse": { "type": "object", "properties": { "forwarding_events": { "type": "array", "items": { "$ref": "#/definitions/lnrpcForwardingEvent" }, "description": "/ A list of forwarding events from the time slice of the time series specified in the request." }, "last_offset_index": { "type": "integer", "format": "int64", "description": "/ The index of the last time in the set of returned forwarding events. Can be used to seek further, pagination style." } } }, "lnrpcFundingShim": { "type": "object", "properties": { "chan_point_shim": { "$ref": "#/definitions/lnrpcChanPointShim" } } }, "lnrpcFundingShimCancel": { "type": "object", "properties": { "pending_chan_id": { "type": "string", "format": "byte", "description": "/ The pending channel ID of the channel to cancel the funding shim for." } } }, "lnrpcFundingStateStepResp": { "type": "object" }, "lnrpcGenSeedResponse": { "type": "object", "properties": { "cipher_seed_mnemonic": { "type": "array", "items": { "type": "string" }, "description": "*\ncipher_seed_mnemonic is a 24-word mnemonic that encodes a prior aezeed\ncipher seed obtained by the user. This field is optional, as if not\nprovided, then the daemon will generate a new cipher seed for the user.\nOtherwise, then the daemon will attempt to recover the wallet state linked\nto this cipher seed." }, "enciphered_seed": { "type": "string", "format": "byte", "description": "*\nenciphered_seed are the raw aezeed cipher seed bytes. This is the raw\ncipher text before run through our mnemonic encoding scheme." } } }, "lnrpcGetInfoResponse": { "type": "object", "properties": { "version": { "type": "string", "description": "/ The version of the LND software that the node is running." }, "identity_pubkey": { "type": "string", "description": "/ The identity pubkey of the current node." }, "alias": { "type": "string", "title": "/ If applicable, the alias of the current node, e.g. \"bob\"" }, "color": { "type": "string", "title": "/ The color of the current node in hex code format" }, "num_pending_channels": { "type": "integer", "format": "int64", "title": "/ Number of pending channels" }, "num_active_channels": { "type": "integer", "format": "int64", "title": "/ Number of active channels" }, "num_inactive_channels": { "type": "integer", "format": "int64", "title": "/ Number of inactive channels" }, "num_peers": { "type": "integer", "format": "int64", "title": "/ Number of peers" }, "block_height": { "type": "integer", "format": "int64", "title": "/ The node's current view of the height of the best block" }, "block_hash": { "type": "string", "title": "/ The node's current view of the hash of the best block" }, "best_header_timestamp": { "type": "string", "format": "int64", "title": "/ Timestamp of the block best known to the wallet" }, "synced_to_chain": { "type": "boolean", "format": "boolean", "title": "/ Whether the wallet's view is synced to the main chain" }, "synced_to_graph": { "type": "boolean", "format": "boolean", "description": "Whether we consider ourselves synced with the public channel graph." }, "testnet": { "type": "boolean", "format": "boolean", "title": "* \nWhether the current node is connected to testnet. This field is \ndeprecated and the network field should be used instead" }, "chains": { "type": "array", "items": { "$ref": "#/definitions/lnrpcChain" }, "title": "/ A list of active chains the node is connected to" }, "uris": { "type": "array", "items": { "type": "string" }, "description": "/ The URIs of the current node." }, "features": { "type": "object", "additionalProperties": { "$ref": "#/definitions/lnrpcFeature" }, "description": "Features that our node has advertised in our init message, node\nannouncements and invoices." } } }, "lnrpcGraphTopologyUpdate": { "type": "object", "properties": { "node_updates": { "type": "array", "items": { "$ref": "#/definitions/lnrpcNodeUpdate" } }, "channel_updates": { "type": "array", "items": { "$ref": "#/definitions/lnrpcChannelEdgeUpdate" } }, "closed_chans": { "type": "array", "items": { "$ref": "#/definitions/lnrpcClosedChannelUpdate" } } } }, "lnrpcHTLC": { "type": "object", "properties": { "incoming": { "type": "boolean", "format": "boolean" }, "amount": { "type": "string", "format": "int64" }, "hash_lock": { "type": "string", "format": "byte" }, "expiration_height": { "type": "integer", "format": "int64" } } }, "lnrpcHTLCAttempt": { "type": "object", "properties": { "status": { "$ref": "#/definitions/HTLCAttemptHTLCStatus", "description": "/ The status of the HTLC." }, "route": { "$ref": "#/definitions/lnrpcRoute", "description": "/ The route taken by this HTLC." }, "attempt_time_ns": { "type": "string", "format": "int64", "description": "/ The time in UNIX nanoseconds at which this HTLC was sent." }, "resolve_time_ns": { "type": "string", "format": "int64", "description": "*\nThe time in UNIX nanoseconds at which this HTLC was settled or failed.\nThis value will not be set if the HTLC is still IN_FLIGHT." } } }, "lnrpcHop": { "type": "object", "properties": { "chan_id": { "type": "string", "format": "uint64", "description": "*\nThe unique channel ID for the channel. The first 3 bytes are the block\nheight, the next 3 the index within the block, and the last 2 bytes are the\noutput index for the channel." }, "chan_capacity": { "type": "string", "format": "int64" }, "amt_to_forward": { "type": "string", "format": "int64" }, "fee": { "type": "string", "format": "int64" }, "expiry": { "type": "integer", "format": "int64" }, "amt_to_forward_msat": { "type": "string", "format": "int64" }, "fee_msat": { "type": "string", "format": "int64" }, "pub_key": { "type": "string", "description": "*\nAn optional public key of the hop. If the public key is given, the payment\ncan be executed without relying on a copy of the channel graph." }, "tlv_payload": { "type": "boolean", "format": "boolean", "description": "* \nIf set to true, then this hop will be encoded using the new variable length\nTLV format. Note that if any custom tlv_records below are specified, then\nthis field MUST be set to true for them to be encoded properly." }, "mpp_record": { "$ref": "#/definitions/lnrpcMPPRecord", "description": "*\nAn optional TLV record tha singals the use of an MPP payment. If present,\nthe receiver will enforce that that the same mpp_record is included in the\nfinal hop payload of all non-zero payments in the HTLC set. If empty, a\nregular single-shot payment is or was attempted." }, "custom_records": { "type": "object", "additionalProperties": { "type": "string", "format": "byte" }, "description": "*\nAn optional set of key-value TLV records. This is useful within the context\nof the SendToRoute call as it allows callers to specify arbitrary K-V pairs\nto drop off at each hop within the onion." } } }, "lnrpcHopHint": { "type": "object", "properties": { "node_id": { "type": "string", "description": "/ The public key of the node at the start of the channel." }, "chan_id": { "type": "string", "format": "uint64", "description": "/ The unique identifier of the channel." }, "fee_base_msat": { "type": "integer", "format": "int64", "description": "/ The base fee of the channel denominated in millisatoshis." }, "fee_proportional_millionths": { "type": "integer", "format": "int64", "description": "*\nThe fee rate of the channel for sending one satoshi across it denominated in\nmillionths of a satoshi." }, "cltv_expiry_delta": { "type": "integer", "format": "int64", "description": "/ The time-lock delta of the channel." } } }, "lnrpcInitWalletRequest": { "type": "object", "properties": { "wallet_password": { "type": "string", "format": "byte", "description": "*\nwallet_password is the passphrase that should be used to encrypt the\nwallet. This MUST be at least 8 chars in length. After creation, this\npassword is required to unlock the daemon. When using REST, this field\nmust be encoded as base64." }, "cipher_seed_mnemonic": { "type": "array", "items": { "type": "string" }, "description": "*\ncipher_seed_mnemonic is a 24-word mnemonic that encodes a prior aezeed\ncipher seed obtained by the user. This may have been generated by the\nGenSeed method, or be an existing seed." }, "aezeed_passphrase": { "type": "string", "format": "byte", "description": "*\naezeed_passphrase is an optional user provided passphrase that will be used\nto encrypt the generated aezeed cipher seed. When using REST, this field\nmust be encoded as base64." }, "recovery_window": { "type": "integer", "format": "int32", "description": "*\nrecovery_window is an optional argument specifying the address lookahead\nwhen restoring a wallet seed. The recovery window applies to each\nindividual branch of the BIP44 derivation paths. Supplying a recovery\nwindow of zero indicates that no addresses should be recovered, such after\nthe first initialization of the wallet." }, "channel_backups": { "$ref": "#/definitions/lnrpcChanBackupSnapshot", "description": "*\nchannel_backups is an optional argument that allows clients to recover the\nsettled funds within a set of channels. This should be populated if the\nuser was unable to close out all channels and sweep funds before partial or\ntotal data loss occurred. If specified, then after on-chain recovery of\nfunds, lnd begin to carry out the data loss recovery protocol in order to\nrecover the funds in each channel from a remote force closed transaction." } } }, "lnrpcInitWalletResponse": { "type": "object" }, "lnrpcInvoice": { "type": "object", "properties": { "memo": { "type": "string", "description": "*\nAn optional memo to attach along with the invoice. Used for record keeping\npurposes for the invoice's creator, and will also be set in the description\nfield of the encoded payment request if the description_hash field is not\nbeing used." }, "r_preimage": { "type": "string", "format": "byte", "description": "*\nThe hex-encoded preimage (32 byte) which will allow settling an incoming\nHTLC payable to this preimage. When using REST, this field must be encoded\nas base64." }, "r_hash": { "type": "string", "format": "byte", "description": "*\nThe hash of the preimage. When using REST, this field must be encoded as\nbase64." }, "value": { "type": "string", "format": "int64", "description": "The fields value and value_msat are mutually exclusive.", "title": "*\nThe value of this invoice in satoshis" }, "value_msat": { "type": "string", "format": "int64", "description": "The fields value and value_msat are mutually exclusive.", "title": "*\nThe value of this invoice in millisatoshis" }, "settled": { "type": "boolean", "format": "boolean", "title": "/ Whether this invoice has been fulfilled" }, "creation_date": { "type": "string", "format": "int64", "title": "/ When this invoice was created" }, "settle_date": { "type": "string", "format": "int64", "title": "/ When this invoice was settled" }, "payment_request": { "type": "string", "description": "*\nA bare-bones invoice for a payment within the Lightning Network. With the\ndetails of the invoice, the sender has all the data necessary to send a\npayment to the recipient." }, "description_hash": { "type": "string", "format": "byte", "description": "*\nHash (SHA-256) of a description of the payment. Used if the description of\npayment (memo) is too long to naturally fit within the description field\nof an encoded payment request. When using REST, this field must be encoded\nas base64." }, "expiry": { "type": "string", "format": "int64", "description": "/ Payment request expiry time in seconds. Default is 3600 (1 hour)." }, "fallback_addr": { "type": "string", "description": "/ Fallback on-chain address." }, "cltv_expiry": { "type": "string", "format": "uint64", "description": "/ Delta to use for the time-lock of the CLTV extended to the final hop." }, "route_hints": { "type": "array", "items": { "$ref": "#/definitions/lnrpcRouteHint" }, "description": "*\nRoute hints that can each be individually used to assist in reaching the\ninvoice's destination." }, "private": { "type": "boolean", "format": "boolean", "description": "/ Whether this invoice should include routing hints for private channels." }, "add_index": { "type": "string", "format": "uint64", "description": "*\nThe \"add\" index of this invoice. Each newly created invoice will increment\nthis index making it monotonically increasing. Callers to the\nSubscribeInvoices call can use this to instantly get notified of all added\ninvoices with an add_index greater than this one." }, "settle_index": { "type": "string", "format": "uint64", "description": "*\nThe \"settle\" index of this invoice. Each newly settled invoice will\nincrement this index making it monotonically increasing. Callers to the\nSubscribeInvoices call can use this to instantly get notified of all\nsettled invoices with an settle_index greater than this one." }, "amt_paid": { "type": "string", "format": "int64", "description": "/ Deprecated, use amt_paid_sat or amt_paid_msat." }, "amt_paid_sat": { "type": "string", "format": "int64", "description": "*\nThe amount that was accepted for this invoice, in satoshis. This will ONLY\nbe set if this invoice has been settled. We provide this field as if the\ninvoice was created with a zero value, then we need to record what amount\nwas ultimately accepted. Additionally, it's possible that the sender paid\nMORE that was specified in the original invoice. So we'll record that here\nas well." }, "amt_paid_msat": { "type": "string", "format": "int64", "description": "*\nThe amount that was accepted for this invoice, in millisatoshis. This will\nONLY be set if this invoice has been settled. We provide this field as if\nthe invoice was created with a zero value, then we need to record what\namount was ultimately accepted. Additionally, it's possible that the sender\npaid MORE that was specified in the original invoice. So we'll record that\nhere as well." }, "state": { "$ref": "#/definitions/InvoiceInvoiceState", "description": "*\nThe state the invoice is in." }, "htlcs": { "type": "array", "items": { "$ref": "#/definitions/lnrpcInvoiceHTLC" }, "description": "/ List of HTLCs paying to this invoice [EXPERIMENTAL]." }, "features": { "type": "object", "additionalProperties": { "$ref": "#/definitions/lnrpcFeature" }, "description": "/ List of features advertised on the invoice." }, "is_keysend": { "type": "boolean", "format": "boolean", "description": "*\nIndicates if this invoice was a spontaneous payment that arrived via keysend\n[EXPERIMENTAL]." } } }, "lnrpcInvoiceHTLC": { "type": "object", "properties": { "chan_id": { "type": "string", "format": "uint64", "description": "/ Short channel id over which the htlc was received." }, "htlc_index": { "type": "string", "format": "uint64", "description": "/ Index identifying the htlc on the channel." }, "amt_msat": { "type": "string", "format": "uint64", "description": "/ The amount of the htlc in msat." }, "accept_height": { "type": "integer", "format": "int32", "description": "/ Block height at which this htlc was accepted." }, "accept_time": { "type": "string", "format": "int64", "description": "/ Time at which this htlc was accepted." }, "resolve_time": { "type": "string", "format": "int64", "description": "/ Time at which this htlc was settled or canceled." }, "expiry_height": { "type": "integer", "format": "int32", "description": "/ Block height at which this htlc expires." }, "state": { "$ref": "#/definitions/lnrpcInvoiceHTLCState", "description": "/ Current state the htlc is in." }, "custom_records": { "type": "object", "additionalProperties": { "type": "string", "format": "byte" }, "description": "/ Custom tlv records." }, "mpp_total_amt_msat": { "type": "string", "format": "uint64", "description": "/ The total amount of the mpp payment in msat." } }, "title": "/ Details of an HTLC that paid to an invoice" }, "lnrpcInvoiceHTLCState": { "type": "string", "enum": [ "ACCEPTED", "SETTLED", "CANCELED" ], "default": "ACCEPTED" }, "lnrpcKeyDescriptor": { "type": "object", "properties": { "raw_key_bytes": { "type": "string", "format": "byte", "description": "*\nThe raw bytes of the key being identified." }, "key_loc": { "$ref": "#/definitions/lnrpcKeyLocator", "description": "* \nThe key locator that identifies which key to use for signing." } } }, "lnrpcKeyLocator": { "type": "object", "properties": { "key_family": { "type": "integer", "format": "int32", "description": "/ The family of key being identified." }, "key_index": { "type": "integer", "format": "int32", "description": "/ The precise index of the key being identified." } } }, "lnrpcLightningAddress": { "type": "object", "properties": { "pubkey": { "type": "string", "title": "/ The identity pubkey of the Lightning node" }, "host": { "type": "string", "title": "/ The network location of the lightning node, e.g. `69.69.69.69:1337` or `localhost:10011`" } } }, "lnrpcLightningNode": { "type": "object", "properties": { "last_update": { "type": "integer", "format": "int64" }, "pub_key": { "type": "string" }, "alias": { "type": "string" }, "addresses": { "type": "array", "items": { "$ref": "#/definitions/lnrpcNodeAddress" } }, "color": { "type": "string" }, "features": { "type": "object", "additionalProperties": { "$ref": "#/definitions/lnrpcFeature" } } }, "description": "*\nAn individual vertex/node within the channel graph. A node is\nconnected to other nodes by one or more channel edges emanating from it. As the\ngraph is directed, a node will also have an incoming edge attached to it for\neach outgoing edge." }, "lnrpcListChannelsResponse": { "type": "object", "properties": { "channels": { "type": "array", "items": { "$ref": "#/definitions/lnrpcChannel" }, "title": "/ The list of active channels" } } }, "lnrpcListInvoiceResponse": { "type": "object", "properties": { "invoices": { "type": "array", "items": { "$ref": "#/definitions/lnrpcInvoice" }, "description": "*\nA list of invoices from the time slice of the time series specified in the\nrequest." }, "last_index_offset": { "type": "string", "format": "uint64", "description": "*\nThe index of the last item in the set of returned invoices. This can be used\nto seek further, pagination style." }, "first_index_offset": { "type": "string", "format": "uint64", "description": "*\nThe index of the last item in the set of returned invoices. This can be used\nto seek backwards, pagination style." } } }, "lnrpcListPaymentsResponse": { "type": "object", "properties": { "payments": { "type": "array", "items": { "$ref": "#/definitions/lnrpcPayment" }, "title": "/ The list of payments" } } }, "lnrpcListPeersResponse": { "type": "object", "properties": { "peers": { "type": "array", "items": { "$ref": "#/definitions/lnrpcPeer" }, "title": "/ The list of currently connected peers" } } }, "lnrpcListUnspentResponse": { "type": "object", "properties": { "utxos": { "type": "array", "items": { "$ref": "#/definitions/lnrpcUtxo" }, "title": "/ A list of utxos" } } }, "lnrpcMPPRecord": { "type": "object", "properties": { "payment_addr": { "type": "string", "format": "byte", "description": "*\nA unique, random identifier used to authenticate the sender as the intended\npayer of a multi-path payment. The payment_addr must be the same for all\nsubpayments, and match the payment_addr provided in the receiver's invoice.\nThe same payment_addr must be used on all subpayments." }, "total_amt_msat": { "type": "string", "format": "int64", "description": "*\nThe total amount in milli-satoshis being sent as part of a larger multi-path\npayment. The caller is responsible for ensuring subpayments to the same node\nand payment_hash sum exactly to total_amt_msat. The same\ntotal_amt_msat must be used on all subpayments." } } }, "lnrpcMacaroonPermission": { "type": "object", "properties": { "entity": { "type": "string", "description": "/ The entity a permission grants access to." }, "action": { "type": "string", "description": "/ The action that is granted." } } }, "lnrpcMultiChanBackup": { "type": "object", "properties": { "chan_points": { "type": "array", "items": { "$ref": "#/definitions/lnrpcChannelPoint" }, "description": "*\nIs the set of all channels that are included in this multi-channel backup." }, "multi_chan_backup": { "type": "string", "format": "byte", "description": "*\nA single encrypted blob containing all the static channel backups of the\nchannel listed above. This can be stored as a single file or blob, and\nsafely be replaced with any prior/future versions. When using REST, this\nfield must be encoded as base64." } } }, "lnrpcNetworkInfo": { "type": "object", "properties": { "graph_diameter": { "type": "integer", "format": "int64" }, "avg_out_degree": { "type": "number", "format": "double" }, "max_out_degree": { "type": "integer", "format": "int64" }, "num_nodes": { "type": "integer", "format": "int64" }, "num_channels": { "type": "integer", "format": "int64" }, "total_network_capacity": { "type": "string", "format": "int64" }, "avg_channel_size": { "type": "number", "format": "double" }, "min_channel_size": { "type": "string", "format": "int64" }, "max_channel_size": { "type": "string", "format": "int64" }, "median_channel_size_sat": { "type": "string", "format": "int64" }, "num_zombie_chans": { "type": "string", "format": "uint64", "description": "The number of edges marked as zombies." } } }, "lnrpcNewAddressResponse": { "type": "object", "properties": { "address": { "type": "string", "title": "/ The newly generated wallet address" } } }, "lnrpcNodeAddress": { "type": "object", "properties": { "network": { "type": "string" }, "addr": { "type": "string" } } }, "lnrpcNodeInfo": { "type": "object", "properties": { "node": { "$ref": "#/definitions/lnrpcLightningNode", "description": "*\nAn individual vertex/node within the channel graph. A node is\nconnected to other nodes by one or more channel edges emanating from it. As\nthe graph is directed, a node will also have an incoming edge attached to\nit for each outgoing edge." }, "num_channels": { "type": "integer", "format": "int64", "description": "/ The total number of channels for the node." }, "total_capacity": { "type": "string", "format": "int64", "description": "/ The sum of all channels capacity for the node, denominated in satoshis." }, "channels": { "type": "array", "items": { "$ref": "#/definitions/lnrpcChannelEdge" }, "description": "/ A list of all public channels for the node." } } }, "lnrpcNodePair": { "type": "object", "properties": { "from": { "type": "string", "format": "byte", "description": "*\nThe sending node of the pair. When using REST, this field must be encoded as\nbase64." }, "to": { "type": "string", "format": "byte", "description": "*\nThe receiving node of the pair. When using REST, this field must be encoded\nas base64." } } }, "lnrpcNodeUpdate": { "type": "object", "properties": { "addresses": { "type": "array", "items": { "type": "string" } }, "identity_key": { "type": "string" }, "global_features": { "type": "string", "format": "byte" }, "alias": { "type": "string" }, "color": { "type": "string" } } }, "lnrpcOpenChannelRequest": { "type": "object", "properties": { "node_pubkey": { "type": "string", "format": "byte", "description": "*\nThe pubkey of the node to open a channel with. When using REST, this field\nmust be encoded as base64." }, "node_pubkey_string": { "type": "string", "description": "*\nThe hex encoded pubkey of the node to open a channel with. Deprecated now\nthat the REST gateway supports base64 encoding of bytes fields." }, "local_funding_amount": { "type": "string", "format": "int64", "title": "/ The number of satoshis the wallet should commit to the channel" }, "push_sat": { "type": "string", "format": "int64", "title": "/ The number of satoshis to push to the remote side as part of the initial commitment state" }, "target_conf": { "type": "integer", "format": "int32", "description": "/ The target number of blocks that the funding transaction should be confirmed by." }, "sat_per_byte": { "type": "string", "format": "int64", "description": "/ A manual fee rate set in sat/byte that should be used when crafting the funding transaction." }, "private": { "type": "boolean", "format": "boolean", "description": "/ Whether this channel should be private, not announced to the greater network." }, "min_htlc_msat": { "type": "string", "format": "int64", "description": "/ The minimum value in millisatoshi we will require for incoming HTLCs on the channel." }, "remote_csv_delay": { "type": "integer", "format": "int64", "description": "/ The delay we require on the remote's commitment transaction. If this is not set, it will be scaled automatically with the channel size." }, "min_confs": { "type": "integer", "format": "int32", "description": "/ The minimum number of confirmations each one of your outputs used for the funding transaction must satisfy." }, "spend_unconfirmed": { "type": "boolean", "format": "boolean", "description": "/ Whether unconfirmed outputs should be used as inputs for the funding transaction." }, "close_address": { "type": "string", "description": "Close address is an optional address which specifies the address to which\nfunds should be paid out to upon cooperative close. This field may only be\nset if the peer supports the option upfront feature bit (call listpeers\nto check). The remote peer will only accept cooperative closes to this\naddress if it is set.\n\nNote: If this value is set on channel creation, you will *not* be able to\ncooperatively close out to a different address." }, "funding_shim": { "$ref": "#/definitions/lnrpcFundingShim", "description": "*\nFunding shims are an optional argument that allow the caller to intercept\ncertain funding functionality. For example, a shim can be provided to use a\nparticular key for the commitment key (ideally cold) rather than use one\nthat is generated by the wallet as normal, or signal that signing will be\ncarried out in an interactive manner (PSBT based)." } } }, "lnrpcOpenStatusUpdate": { "type": "object", "properties": { "chan_pending": { "$ref": "#/definitions/lnrpcPendingUpdate" }, "chan_open": { "$ref": "#/definitions/lnrpcChannelOpenUpdate" }, "pending_chan_id": { "type": "string", "format": "byte", "description": "*\nThe pending channel ID of the created channel. This value may be used to\nfurther the funding flow manually via the FundingStateStep method." } } }, "lnrpcOutPoint": { "type": "object", "properties": { "txid_bytes": { "type": "string", "format": "byte", "description": "/ Raw bytes representing the transaction id." }, "txid_str": { "type": "string", "description": "/ Reversed, hex-encoded string representing the transaction id." }, "output_index": { "type": "integer", "format": "int64", "description": "/ The index of the output on the transaction." } } }, "lnrpcPayReq": { "type": "object", "properties": { "destination": { "type": "string" }, "payment_hash": { "type": "string" }, "num_satoshis": { "type": "string", "format": "int64" }, "timestamp": { "type": "string", "format": "int64" }, "expiry": { "type": "string", "format": "int64" }, "description": { "type": "string" }, "description_hash": { "type": "string" }, "fallback_addr": { "type": "string" }, "cltv_expiry": { "type": "string", "format": "int64" }, "route_hints": { "type": "array", "items": { "$ref": "#/definitions/lnrpcRouteHint" } }, "payment_addr": { "type": "string", "format": "byte" }, "num_msat": { "type": "string", "format": "int64" }, "features": { "type": "object", "additionalProperties": { "$ref": "#/definitions/lnrpcFeature" } } } }, "lnrpcPayment": { "type": "object", "properties": { "payment_hash": { "type": "string", "title": "/ The payment hash" }, "value": { "type": "string", "format": "int64", "description": "/ Deprecated, use value_sat or value_msat." }, "creation_date": { "type": "string", "format": "int64", "title": "/ Deprecated, use creation_time_ns" }, "path": { "type": "array", "items": { "type": "string" }, "description": "/ The path this payment took." }, "fee": { "type": "string", "format": "int64", "description": "/ Deprecated, use fee_sat or fee_msat." }, "payment_preimage": { "type": "string", "title": "/ The payment preimage" }, "value_sat": { "type": "string", "format": "int64", "title": "/ The value of the payment in satoshis" }, "value_msat": { "type": "string", "format": "int64", "title": "/ The value of the payment in milli-satoshis" }, "payment_request": { "type": "string", "description": "/ The optional payment request being fulfilled." }, "status": { "$ref": "#/definitions/PaymentPaymentStatus", "description": "The status of the payment." }, "fee_sat": { "type": "string", "format": "int64", "title": "/ The fee paid for this payment in satoshis" }, "fee_msat": { "type": "string", "format": "int64", "title": "/ The fee paid for this payment in milli-satoshis" }, "creation_time_ns": { "type": "string", "format": "int64", "description": "/ The time in UNIX nanoseconds at which the payment was created." }, "htlcs": { "type": "array", "items": { "$ref": "#/definitions/lnrpcHTLCAttempt" }, "description": "/ The HTLCs made in attempt to settle the payment [EXPERIMENTAL]." } } }, "lnrpcPeer": { "type": "object", "properties": { "pub_key": { "type": "string", "title": "/ The identity pubkey of the peer" }, "address": { "type": "string", "title": "/ Network address of the peer; eg `127.0.0.1:10011`" }, "bytes_sent": { "type": "string", "format": "uint64", "title": "/ Bytes of data transmitted to this peer" }, "bytes_recv": { "type": "string", "format": "uint64", "title": "/ Bytes of data transmitted from this peer" }, "sat_sent": { "type": "string", "format": "int64", "title": "/ Satoshis sent to this peer" }, "sat_recv": { "type": "string", "format": "int64", "title": "/ Satoshis received from this peer" }, "inbound": { "type": "boolean", "format": "boolean", "title": "/ A channel is inbound if the counterparty initiated the channel" }, "ping_time": { "type": "string", "format": "int64", "title": "/ Ping time to this peer" }, "sync_type": { "$ref": "#/definitions/PeerSyncType", "description": "The type of sync we are currently performing with this peer." }, "features": { "type": "object", "additionalProperties": { "$ref": "#/definitions/lnrpcFeature" }, "description": "/ Features advertised by the remote peer in their init message." } } }, "lnrpcPeerEvent": { "type": "object", "properties": { "pub_key": { "type": "string", "description": "/ The identity pubkey of the peer." }, "type": { "$ref": "#/definitions/PeerEventEventType" } } }, "lnrpcPendingChannelsResponse": { "type": "object", "properties": { "total_limbo_balance": { "type": "string", "format": "int64", "title": "/ The balance in satoshis encumbered in pending channels" }, "pending_open_channels": { "type": "array", "items": { "$ref": "#/definitions/PendingChannelsResponsePendingOpenChannel" }, "title": "/ Channels pending opening" }, "pending_closing_channels": { "type": "array", "items": { "$ref": "#/definitions/PendingChannelsResponseClosedChannel" }, "title": "/ Channels pending closing" }, "pending_force_closing_channels": { "type": "array", "items": { "$ref": "#/definitions/PendingChannelsResponseForceClosedChannel" }, "title": "/ Channels pending force closing" }, "waiting_close_channels": { "type": "array", "items": { "$ref": "#/definitions/PendingChannelsResponseWaitingCloseChannel" }, "title": "/ Channels waiting for closing tx to confirm" } } }, "lnrpcPendingHTLC": { "type": "object", "properties": { "incoming": { "type": "boolean", "format": "boolean", "title": "/ The direction within the channel that the htlc was sent" }, "amount": { "type": "string", "format": "int64", "title": "/ The total value of the htlc" }, "outpoint": { "type": "string", "title": "/ The final output to be swept back to the user's wallet" }, "maturity_height": { "type": "integer", "format": "int64", "title": "/ The next block height at which we can spend the current stage" }, "blocks_til_maturity": { "type": "integer", "format": "int32", "description": "*\nThe number of blocks remaining until the current stage can be swept.\nNegative values indicate how many blocks have passed since becoming\nmature." }, "stage": { "type": "integer", "format": "int64", "title": "/ Indicates whether the htlc is in its first or second stage of recovery" } } }, "lnrpcPendingUpdate": { "type": "object", "properties": { "txid": { "type": "string", "format": "byte" }, "output_index": { "type": "integer", "format": "int64" } } }, "lnrpcPolicyUpdateRequest": { "type": "object", "properties": { "global": { "type": "boolean", "format": "boolean", "description": "/ If set, then this update applies to all currently active channels." }, "chan_point": { "$ref": "#/definitions/lnrpcChannelPoint", "description": "/ If set, this update will target a specific channel." }, "base_fee_msat": { "type": "string", "format": "int64", "description": "/ The base fee charged regardless of the number of milli-satoshis sent." }, "fee_rate": { "type": "number", "format": "double", "description": "/ The effective fee rate in milli-satoshis. The precision of this value goes up to 6 decimal places, so 1e-6." }, "time_lock_delta": { "type": "integer", "format": "int64", "description": "/ The required timelock delta for HTLCs forwarded over the channel." }, "max_htlc_msat": { "type": "string", "format": "uint64", "description": "/ If set, the maximum HTLC size in milli-satoshis. If unset, the maximum HTLC will be unchanged." }, "min_htlc_msat": { "type": "string", "format": "uint64", "description": "/ The minimum HTLC size in milli-satoshis. Only applied if min_htlc_msat_specified is true." }, "min_htlc_msat_specified": { "type": "boolean", "format": "boolean", "description": "/ If true, min_htlc_msat is applied." } } }, "lnrpcPolicyUpdateResponse": { "type": "object" }, "lnrpcQueryRoutesResponse": { "type": "object", "properties": { "routes": { "type": "array", "items": { "$ref": "#/definitions/lnrpcRoute" }, "description": "*\nThe route that results from the path finding operation. This is still a\nrepeated field to retain backwards compatibility." }, "success_prob": { "type": "number", "format": "double", "title": "*\nThe success probability of the returned route based on the current mission\ncontrol state. [EXPERIMENTAL]" } } }, "lnrpcRestoreBackupResponse": { "type": "object" }, "lnrpcRestoreChanBackupRequest": { "type": "object", "properties": { "chan_backups": { "$ref": "#/definitions/lnrpcChannelBackups", "description": "*\nThe channels to restore as a list of channel/backup pairs." }, "multi_chan_backup": { "type": "string", "format": "byte", "description": "*\nThe channels to restore in the packed multi backup format. When using\nREST, this field must be encoded as base64." } } }, "lnrpcRoute": { "type": "object", "properties": { "total_time_lock": { "type": "integer", "format": "int64", "description": "*\nThe cumulative (final) time lock across the entire route. This is the CLTV\nvalue that should be extended to the first hop in the route. All other hops\nwill decrement the time-lock as advertised, leaving enough time for all\nhops to wait for or present the payment preimage to complete the payment." }, "total_fees": { "type": "string", "format": "int64", "description": "*\nThe sum of the fees paid at each hop within the final route. In the case\nof a one-hop payment, this value will be zero as we don't need to pay a fee\nto ourselves." }, "total_amt": { "type": "string", "format": "int64", "description": "*\nThe total amount of funds required to complete a payment over this route.\nThis value includes the cumulative fees at each hop. As a result, the HTLC\nextended to the first-hop in the route will need to have at least this many\nsatoshis, otherwise the route will fail at an intermediate node due to an\ninsufficient amount of fees." }, "hops": { "type": "array", "items": { "$ref": "#/definitions/lnrpcHop" }, "description": "*\nContains details concerning the specific forwarding details at each hop." }, "total_fees_msat": { "type": "string", "format": "int64", "description": "*\nThe total fees in millisatoshis." }, "total_amt_msat": { "type": "string", "format": "int64", "description": "*\nThe total amount in millisatoshis." } }, "description": "*\nA path through the channel graph which runs over one or more channels in\nsuccession. This struct carries all the information required to craft the\nSphinx onion packet, and send the payment along the first hop in the path. A\nroute is only selected as valid if all the channels have sufficient capacity to\ncarry the initial payment amount after fees are accounted for." }, "lnrpcRouteHint": { "type": "object", "properties": { "hop_hints": { "type": "array", "items": { "$ref": "#/definitions/lnrpcHopHint" }, "description": "*\nA list of hop hints that when chained together can assist in reaching a\nspecific destination." } } }, "lnrpcRoutingPolicy": { "type": "object", "properties": { "time_lock_delta": { "type": "integer", "format": "int64" }, "min_htlc": { "type": "string", "format": "int64" }, "fee_base_msat": { "type": "string", "format": "int64" }, "fee_rate_milli_msat": { "type": "string", "format": "int64" }, "disabled": { "type": "boolean", "format": "boolean" }, "max_htlc_msat": { "type": "string", "format": "uint64" }, "last_update": { "type": "integer", "format": "int64" } } }, "lnrpcSendCoinsRequest": { "type": "object", "properties": { "addr": { "type": "string", "title": "/ The address to send coins to" }, "amount": { "type": "string", "format": "int64", "title": "/ The amount in satoshis to send" }, "target_conf": { "type": "integer", "format": "int32", "description": "/ The target number of blocks that this transaction should be confirmed by." }, "sat_per_byte": { "type": "string", "format": "int64", "description": "/ A manual fee rate set in sat/byte that should be used when crafting the transaction." }, "send_all": { "type": "boolean", "format": "boolean", "description": "*\nIf set, then the amount field will be ignored, and lnd will attempt to\nsend all the coins under control of the internal wallet to the specified\naddress." } } }, "lnrpcSendCoinsResponse": { "type": "object", "properties": { "txid": { "type": "string", "title": "/ The transaction ID of the transaction" } } }, "lnrpcSendManyResponse": { "type": "object", "properties": { "txid": { "type": "string", "title": "/ The id of the transaction" } } }, "lnrpcSendRequest": { "type": "object", "properties": { "dest": { "type": "string", "format": "byte", "description": "*\nThe identity pubkey of the payment recipient. When using REST, this field\nmust be encoded as base64." }, "dest_string": { "type": "string", "description": "*\nThe hex-encoded identity pubkey of the payment recipient. Deprecated now\nthat the REST gateway supports base64 encoding of bytes fields." }, "amt": { "type": "string", "format": "int64", "description": "*\nThe amount to send expressed in satoshis.\n\nThe fields amt and amt_msat are mutually exclusive." }, "amt_msat": { "type": "string", "format": "int64", "description": "*\nThe amount to send expressed in millisatoshis.\n\nThe fields amt and amt_msat are mutually exclusive." }, "payment_hash": { "type": "string", "format": "byte", "description": "*\nThe hash to use within the payment's HTLC. When using REST, this field\nmust be encoded as base64." }, "payment_hash_string": { "type": "string", "description": "*\nThe hex-encoded hash to use within the payment's HTLC. Deprecated now\nthat the REST gateway supports base64 encoding of bytes fields." }, "payment_request": { "type": "string", "description": "*\nA bare-bones invoice for a payment within the Lightning Network. With the\ndetails of the invoice, the sender has all the data necessary to send a\npayment to the recipient." }, "final_cltv_delta": { "type": "integer", "format": "int32", "description": "*\nThe CLTV delta from the current height that should be used to set the\ntimelock for the final hop." }, "fee_limit": { "$ref": "#/definitions/lnrpcFeeLimit", "description": "*\nThe maximum number of satoshis that will be paid as a fee of the payment.\nThis value can be represented either as a percentage of the amount being\nsent, or as a fixed amount of the maximum fee the user is willing the pay to\nsend the payment." }, "outgoing_chan_id": { "type": "string", "format": "uint64", "description": "*\nThe channel id of the channel that must be taken to the first hop. If zero,\nany channel may be used." }, "last_hop_pubkey": { "type": "string", "format": "byte", "description": "*\nThe pubkey of the last hop of the route. If empty, any hop may be used." }, "cltv_limit": { "type": "integer", "format": "int64", "description": "* \nAn optional maximum total time lock for the route. This should not exceed\nlnd's `--max-cltv-expiry` setting. If zero, then the value of\n`--max-cltv-expiry` is enforced." }, "dest_custom_records": { "type": "object", "additionalProperties": { "type": "string", "format": "byte" }, "description": "* \nAn optional field that can be used to pass an arbitrary set of TLV records\nto a peer which understands the new records. This can be used to pass\napplication specific data during the payment attempt. Record types are\nrequired to be in the custom range \u003e= 65536. When using REST, the values\nmust be encoded as base64." }, "allow_self_payment": { "type": "boolean", "format": "boolean", "description": "/ If set, circular payments to self are permitted." }, "dest_features": { "type": "array", "items": { "$ref": "#/definitions/lnrpcFeatureBit" }, "description": "*\nFeatures assumed to be supported by the final node. All transitive feature\ndependencies must also be set properly. For a given feature bit pair, either\noptional or remote may be set, but not both. If this field is nil or empty,\nthe router will try to load destination features from the graph as a\nfallback." } } }, "lnrpcSendResponse": { "type": "object", "properties": { "payment_error": { "type": "string" }, "payment_preimage": { "type": "string", "format": "byte" }, "payment_route": { "$ref": "#/definitions/lnrpcRoute" }, "payment_hash": { "type": "string", "format": "byte" } } }, "lnrpcSendToRouteRequest": { "type": "object", "properties": { "payment_hash": { "type": "string", "format": "byte", "description": "*\nThe payment hash to use for the HTLC. When using REST, this field must be\nencoded as base64." }, "payment_hash_string": { "type": "string", "description": "*\nAn optional hex-encoded payment hash to be used for the HTLC. Deprecated now\nthat the REST gateway supports base64 encoding of bytes fields." }, "route": { "$ref": "#/definitions/lnrpcRoute", "description": "/ Route that should be used to attempt to complete the payment." } } }, "lnrpcSignMessageRequest": { "type": "object", "properties": { "msg": { "type": "string", "format": "byte", "description": "*\nThe message to be signed. When using REST, this field must be encoded as\nbase64." } } }, "lnrpcSignMessageResponse": { "type": "object", "properties": { "signature": { "type": "string", "title": "/ The signature for the given message" } } }, "lnrpcStopResponse": { "type": "object" }, "lnrpcTransaction": { "type": "object", "properties": { "tx_hash": { "type": "string", "title": "/ The transaction hash" }, "amount": { "type": "string", "format": "int64", "title": "/ The transaction amount, denominated in satoshis" }, "num_confirmations": { "type": "integer", "format": "int32", "title": "/ The number of confirmations" }, "block_hash": { "type": "string", "title": "/ The hash of the block this transaction was included in" }, "block_height": { "type": "integer", "format": "int32", "title": "/ The height of the block this transaction was included in" }, "time_stamp": { "type": "string", "format": "int64", "title": "/ Timestamp of this transaction" }, "total_fees": { "type": "string", "format": "int64", "title": "/ Fees paid for this transaction" }, "dest_addresses": { "type": "array", "items": { "type": "string" }, "title": "/ Addresses that received funds for this transaction" }, "raw_tx_hex": { "type": "string", "description": "/ The raw transaction hex." } } }, "lnrpcTransactionDetails": { "type": "object", "properties": { "transactions": { "type": "array", "items": { "$ref": "#/definitions/lnrpcTransaction" }, "description": "/ The list of transactions relevant to the wallet." } } }, "lnrpcUnlockWalletRequest": { "type": "object", "properties": { "wallet_password": { "type": "string", "format": "byte", "description": "*\nwallet_password should be the current valid passphrase for the daemon. This\nwill be required to decrypt on-disk material that the daemon requires to\nfunction properly. When using REST, this field must be encoded as base64." }, "recovery_window": { "type": "integer", "format": "int32", "description": "*\nrecovery_window is an optional argument specifying the address lookahead\nwhen restoring a wallet seed. The recovery window applies to each\nindividual branch of the BIP44 derivation paths. Supplying a recovery\nwindow of zero indicates that no addresses should be recovered, such after\nthe first initialization of the wallet." }, "channel_backups": { "$ref": "#/definitions/lnrpcChanBackupSnapshot", "description": "*\nchannel_backups is an optional argument that allows clients to recover the\nsettled funds within a set of channels. This should be populated if the\nuser was unable to close out all channels and sweep funds before partial or\ntotal data loss occurred. If specified, then after on-chain recovery of\nfunds, lnd begin to carry out the data loss recovery protocol in order to\nrecover the funds in each channel from a remote force closed transaction." } } }, "lnrpcUnlockWalletResponse": { "type": "object" }, "lnrpcUtxo": { "type": "object", "properties": { "type": { "$ref": "#/definitions/lnrpcAddressType", "title": "/ The type of address" }, "address": { "type": "string", "title": "/ The address" }, "amount_sat": { "type": "string", "format": "int64", "title": "/ The value of the unspent coin in satoshis" }, "pk_script": { "type": "string", "title": "/ The pkscript in hex" }, "outpoint": { "$ref": "#/definitions/lnrpcOutPoint", "title": "/ The outpoint in format txid:n" }, "confirmations": { "type": "string", "format": "int64", "title": "/ The number of confirmations for the Utxo" } } }, "lnrpcVerifyChanBackupResponse": { "type": "object" }, "lnrpcVerifyMessageRequest": { "type": "object", "properties": { "msg": { "type": "string", "format": "byte", "description": "*\nThe message over which the signature is to be verified. When using REST,\nthis field must be encoded as base64." }, "signature": { "type": "string", "title": "/ The signature to be verified over the given message" } } }, "lnrpcVerifyMessageResponse": { "type": "object", "properties": { "valid": { "type": "boolean", "format": "boolean", "title": "/ Whether the signature was valid over the given message" }, "pubkey": { "type": "string", "title": "/ The pubkey recovered from the signature" } } }, "lnrpcWalletBalanceResponse": { "type": "object", "properties": { "total_balance": { "type": "string", "format": "int64", "title": "/ The balance of the wallet" }, "confirmed_balance": { "type": "string", "format": "int64", "title": "/ The confirmed balance of a wallet(with \u003e= 1 confirmations)" }, "unconfirmed_balance": { "type": "string", "format": "int64", "title": "/ The unconfirmed balance of a wallet(with 0 confirmations)" } } }, "protobufAny": { "type": "object", "properties": { "type_url": { "type": "string" }, "value": { "type": "string", "format": "byte" } } }, "runtimeStreamError": { "type": "object", "properties": { "grpc_code": { "type": "integer", "format": "int32" }, "http_code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "http_status": { "type": "string" }, "details": { "type": "array", "items": { "$ref": "#/definitions/protobufAny" } } } } }, "x-stream-definitions": { "lnrpcChanBackupSnapshot": { "type": "object", "properties": { "result": { "$ref": "#/definitions/lnrpcChanBackupSnapshot" }, "error": { "$ref": "#/definitions/runtimeStreamError" } }, "title": "Stream result of lnrpcChanBackupSnapshot" }, "lnrpcChannelAcceptRequest": { "type": "object", "properties": { "result": { "$ref": "#/definitions/lnrpcChannelAcceptRequest" }, "error": { "$ref": "#/definitions/runtimeStreamError" } }, "title": "Stream result of lnrpcChannelAcceptRequest" }, "lnrpcChannelEventUpdate": { "type": "object", "properties": { "result": { "$ref": "#/definitions/lnrpcChannelEventUpdate" }, "error": { "$ref": "#/definitions/runtimeStreamError" } }, "title": "Stream result of lnrpcChannelEventUpdate" }, "lnrpcCloseStatusUpdate": { "type": "object", "properties": { "result": { "$ref": "#/definitions/lnrpcCloseStatusUpdate" }, "error": { "$ref": "#/definitions/runtimeStreamError" } }, "title": "Stream result of lnrpcCloseStatusUpdate" }, "lnrpcGraphTopologyUpdate": { "type": "object", "properties": { "result": { "$ref": "#/definitions/lnrpcGraphTopologyUpdate" }, "error": { "$ref": "#/definitions/runtimeStreamError" } }, "title": "Stream result of lnrpcGraphTopologyUpdate" }, "lnrpcInvoice": { "type": "object", "properties": { "result": { "$ref": "#/definitions/lnrpcInvoice" }, "error": { "$ref": "#/definitions/runtimeStreamError" } }, "title": "Stream result of lnrpcInvoice" }, "lnrpcOpenStatusUpdate": { "type": "object", "properties": { "result": { "$ref": "#/definitions/lnrpcOpenStatusUpdate" }, "error": { "$ref": "#/definitions/runtimeStreamError" } }, "title": "Stream result of lnrpcOpenStatusUpdate" }, "lnrpcPeerEvent": { "type": "object", "properties": { "result": { "$ref": "#/definitions/lnrpcPeerEvent" }, "error": { "$ref": "#/definitions/runtimeStreamError" } }, "title": "Stream result of lnrpcPeerEvent" }, "lnrpcSendResponse": { "type": "object", "properties": { "result": { "$ref": "#/definitions/lnrpcSendResponse" }, "error": { "$ref": "#/definitions/runtimeStreamError" } }, "title": "Stream result of lnrpcSendResponse" }, "lnrpcTransaction": { "type": "object", "properties": { "result": { "$ref": "#/definitions/lnrpcTransaction" }, "error": { "$ref": "#/definitions/runtimeStreamError" } }, "title": "Stream result of lnrpcTransaction" } } }