lnd.xprv/lnrpc/rpc.swagger.json
Olaoluwa Osuntokun 6e6b5ac9af
lnrpc: remove the revocation_delay field from the HTLC proto
This commit removes the revocation_delay field from the HTLC proto as
we no longer need this field since the switch to 2-layer HTLC’s. The
2-layer HTLC construction no longer has the CSV delay directly in the
HTLC script itself.
2017-09-12 18:03:17 +02:00

1883 lines
56 KiB
JSON

{
"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 the sum of all confirmed unspent outputs under control\nby the wallet. This method can be modified by having the request specify\nonly witness outputs should be factored into the final output sum.",
"operationId": "WalletBalance",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/lnrpcWalletBalanceResponse"
}
}
},
"parameters": [
{
"name": "witness_only",
"description": "/ If only witness outputs should be considered when calculating the wallet's balance.",
"in": "query",
"required": false,
"type": "boolean",
"format": "boolean"
}
],
"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": "",
"schema": {
"$ref": "#/definitions/lnrpcChannelBalanceResponse"
}
}
},
"tags": [
"Lightning"
]
}
},
"/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": "",
"schema": {
"$ref": "#/definitions/lnrpcListChannelsResponse"
}
}
},
"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": "",
"schema": {
"$ref": "#/definitions/lnrpcChannelPoint"
}
}
},
"parameters": [
{
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/lnrpcOpenChannelRequest"
}
}
],
"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": "",
"schema": {
"$ref": "#/definitions/lnrpcPendingChannelResponse"
}
}
},
"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": "",
"schema": {
"$ref": "#/definitions/lnrpcSendResponse"
}
}
},
"parameters": [
{
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/lnrpcSendRequest"
}
}
],
"tags": [
"Lightning"
]
}
},
"/v1/channels/{channel_point.funding_txid}/{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.",
"operationId": "CloseChannel",
"responses": {
"200": {
"description": "(streaming responses)",
"schema": {
"$ref": "#/definitions/lnrpcCloseStatusUpdate"
}
}
},
"parameters": [
{
"name": "channel_point.funding_txid",
"in": "path",
"required": true,
"type": "string",
"format": "byte"
},
{
"name": "channel_point.output_index",
"in": "path",
"required": true,
"type": "integer",
"format": "int64"
}
],
"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": "",
"schema": {
"$ref": "#/definitions/lnrpcFeeReportResponse"
}
}
},
"tags": [
"Lightning"
]
},
"post": {
"summary": "* lncli: `updatefees`\nUpdateFees allows the caller to update the fee schedule for all channels\nglobally, or a particular channel.",
"operationId": "UpdateFees",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/lnrpcFeeUpdateResponse"
}
}
},
"parameters": [
{
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/lnrpcFeeUpdateRequest"
}
}
],
"tags": [
"Lightning"
]
}
},
"/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": "",
"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": "",
"schema": {
"$ref": "#/definitions/lnrpcChannelGraph"
}
}
},
"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": "",
"schema": {
"$ref": "#/definitions/lnrpcChannelEdge"
}
}
},
"parameters": [
{
"name": "chan_id",
"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": "",
"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": "",
"schema": {
"$ref": "#/definitions/lnrpcNodeInfo"
}
}
},
"parameters": [
{
"name": "pub_key",
"in": "path",
"required": true,
"type": "string"
}
],
"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 retuned 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 encapsualted within the HTLC.",
"operationId": "QueryRoutes",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/lnrpcQueryRoutesResponse"
}
}
},
"parameters": [
{
"name": "pub_key",
"in": "path",
"required": true,
"type": "string"
},
{
"name": "amt",
"in": "path",
"required": true,
"type": "string",
"format": "int64"
}
],
"tags": [
"Lightning"
]
}
},
"/v1/invoices": {
"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": "",
"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 (sever -\u003e client) for\nnotifying the client of newly added/settled invoices.",
"operationId": "SubscribeInvoices",
"responses": {
"200": {
"description": "(streaming responses)",
"schema": {
"$ref": "#/definitions/lnrpcInvoice"
}
}
},
"tags": [
"Lightning"
]
}
},
"/v1/invoices/{pending_only}": {
"get": {
"summary": "* lncli: `listinvoices`\nListInvoices returns a list of all the invoices currently stored within the\ndatabase. Any active debug invoices are ignored.",
"operationId": "ListInvoices",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/lnrpcListInvoiceResponse"
}
}
},
"parameters": [
{
"name": "pending_only",
"in": "path",
"required": true,
"type": "boolean",
"format": "boolean"
}
],
"tags": [
"Lightning"
]
}
},
"/v1/invoices/{r_hash_str}": {
"get": {
"summary": "* lncli: `lookupinvoice`\nLookupInvoice attemps 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": "",
"schema": {
"$ref": "#/definitions/lnrpcInvoice"
}
}
},
"parameters": [
{
"name": "r_hash_str",
"in": "path",
"required": true,
"type": "string"
},
{
"name": "r_hash",
"description": "/ The payment hash of the invoice to be looked up.",
"in": "query",
"required": false,
"type": "string",
"format": "byte"
}
],
"tags": [
"Lightning"
]
}
},
"/v1/newaddress": {
"get": {
"summary": "*\nNewWitnessAddress creates a new witness address under control of the local wallet.",
"operationId": "NewWitnessAddress",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/lnrpcNewAddressResponse"
}
}
},
"tags": [
"Lightning"
]
}
},
"/v1/payments": {
"get": {
"summary": "* lncli: `listpayments`\nListPayments returns a list of all outgoing payments.",
"operationId": "ListPayments",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/lnrpcListPaymentsResponse"
}
}
},
"tags": [
"Lightning"
]
},
"delete": {
"summary": "*\nDeleteAllPayments deletes all outgoing payments from DB.",
"operationId": "DeleteAllPayments",
"responses": {
"200": {
"description": "",
"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": "",
"schema": {
"$ref": "#/definitions/lnrpcPayReq"
}
}
},
"parameters": [
{
"name": "pay_req",
"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": "",
"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": "",
"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": "",
"schema": {
"$ref": "#/definitions/lnrpcDisconnectPeerResponse"
}
}
},
"parameters": [
{
"name": "pub_key",
"in": "path",
"required": true,
"type": "string"
}
],
"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": "",
"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.",
"operationId": "SendCoins",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/lnrpcSendCoinsResponse"
}
}
},
"parameters": [
{
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/lnrpcSendCoinsRequest"
}
}
],
"tags": [
"Lightning"
]
}
}
},
"definitions": {
"PendingChannelResponseClosedChannel": {
"type": "object",
"properties": {
"channel": {
"$ref": "#/definitions/PendingChannelResponsePendingChannel",
"title": "/ The pending channel to be closed"
},
"closing_txid": {
"type": "string",
"title": "/ The transaction id of the closing transaction"
}
}
},
"PendingChannelResponseForceClosedChannel": {
"type": "object",
"properties": {
"channel": {
"$ref": "#/definitions/PendingChannelResponsePendingChannel",
"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 sweeped into the wallet"
},
"blocks_til_maturity": {
"type": "integer",
"format": "int64",
"title": "/ Remaining # of blocks until funds can be sweeped into the wallet"
}
}
},
"PendingChannelResponsePendingChannel": {
"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"
}
}
},
"PendingChannelResponsePendingOpenChannel": {
"type": "object",
"properties": {
"channel": {
"$ref": "#/definitions/PendingChannelResponsePendingChannel",
"title": "/ The pending channel"
},
"confirmation_height": {
"type": "integer",
"format": "int64",
"title": "/ The height at which this channel will be confirmed"
},
"blocks_till_open": {
"type": "integer",
"format": "int64",
"title": "/ The number of blocks until this channel is open"
},
"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."
}
}
},
"lnrpcActiveChannel": {
"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."
}
}
},
"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."
}
}
},
"lnrpcChannelBalanceResponse": {
"type": "object",
"properties": {
"balance": {
"type": "string",
"format": "int64",
"title": "/ Sum of channels balances denominated in satoshis"
}
}
},
"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 a 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"
}
}
},
"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": {
"type": "string",
"format": "byte",
"title": "/ Txid of the funding transaction"
},
"funding_txid_str": {
"type": "string",
"title": "/ Hex-encoded string representing the funding transaction"
},
"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"
},
"confirmation": {
"$ref": "#/definitions/lnrpcConfirmationUpdate"
},
"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"
}
}
},
"lnrpcConfirmationUpdate": {
"type": "object",
"properties": {
"block_sha": {
"type": "string",
"format": "byte"
},
"block_height": {
"type": "integer",
"format": "int32"
},
"num_confs_left": {
"type": "integer",
"format": "int64"
}
}
},
"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",
"properties": {
"peer_id": {
"type": "integer",
"format": "int32",
"title": "/ The id of the newly connected peer"
}
}
},
"lnrpcDebugLevelResponse": {
"type": "object",
"properties": {
"sub_systems": {
"type": "string"
}
}
},
"lnrpcDeleteAllPaymentsResponse": {
"type": "object"
},
"lnrpcDisconnectPeerResponse": {
"type": "object"
},
"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."
}
}
},
"lnrpcFeeUpdateRequest": {
"type": "object",
"properties": {
"global": {
"type": "boolean",
"format": "boolean",
"description": "/ If set, then this fee update applies to all currently active channels."
},
"chan_point": {
"$ref": "#/definitions/lnrpcChannelPoint",
"description": "/ If set, this fee 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."
}
}
},
"lnrpcFeeUpdateResponse": {
"type": "object"
},
"lnrpcGetInfoResponse": {
"type": "object",
"properties": {
"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\""
},
"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_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"
},
"synced_to_chain": {
"type": "boolean",
"format": "boolean",
"title": "/ Whether the wallet's view is synced to the main chain"
},
"testnet": {
"type": "boolean",
"format": "boolean",
"title": "/ Whether the current node is connected to testnet"
},
"chains": {
"type": "array",
"items": {
"type": "string"
},
"title": "/ A list of active chains the node is connected to"
}
}
},
"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"
}
}
},
"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"
}
}
},
"lnrpcInvoice": {
"type": "object",
"properties": {
"memo": {
"type": "string",
"title": "/ An optional memo to attach along with the invoice"
},
"receipt": {
"type": "string",
"format": "byte",
"title": "/ An optional cryptographic receipt of payment"
},
"r_preimage": {
"type": "string",
"format": "byte",
"title": "*\nThe hex-encoded preimage (32 byte) which will allow settling an incoming\nHTLC payable to this preimage"
},
"r_hash": {
"type": "string",
"format": "byte",
"title": "/ The hash of the preimage"
},
"value": {
"type": "string",
"format": "int64",
"title": "/ The value of this invoice in satoshis"
},
"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."
}
}
},
"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"
}
}
},
"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/lnrpcActiveChannel"
},
"title": "/ The list of active channels"
}
}
},
"lnrpcListInvoiceResponse": {
"type": "object",
"properties": {
"invoices": {
"type": "array",
"items": {
"$ref": "#/definitions/lnrpcInvoice"
}
}
}
},
"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"
}
}
},
"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"
}
}
},
"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"
},
"total_capacity": {
"type": "string",
"format": "int64"
}
}
},
"lnrpcNodeUpdate": {
"type": "object",
"properties": {
"addresses": {
"type": "array",
"items": {
"type": "string"
}
},
"identity_key": {
"type": "string"
},
"global_features": {
"type": "string",
"format": "byte"
},
"alias": {
"type": "string"
}
}
},
"lnrpcOpenChannelRequest": {
"type": "object",
"properties": {
"target_peer_id": {
"type": "integer",
"format": "int32",
"title": "/ The peer_id of the node to open a channel with"
},
"node_pubkey": {
"type": "string",
"format": "byte",
"title": "/ The pubkey of the node to open a channel with"
},
"node_pubkey_string": {
"type": "string",
"title": "/ The hex encorded pubkey of the node to open a channel with"
},
"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"
}
}
},
"lnrpcOpenStatusUpdate": {
"type": "object",
"properties": {
"chan_pending": {
"$ref": "#/definitions/lnrpcPendingUpdate"
},
"confirmation": {
"$ref": "#/definitions/lnrpcConfirmationUpdate"
},
"chan_open": {
"$ref": "#/definitions/lnrpcChannelOpenUpdate"
}
}
},
"lnrpcPayReq": {
"type": "object",
"properties": {
"destination": {
"type": "string"
},
"payment_hash": {
"type": "string"
},
"num_satoshis": {
"type": "string",
"format": "int64"
}
}
},
"lnrpcPayment": {
"type": "object",
"properties": {
"payment_hash": {
"type": "string",
"title": "/ The payment hash"
},
"value": {
"type": "string",
"format": "int64",
"title": "/ The value of the payment in satoshis"
},
"creation_date": {
"type": "string",
"format": "int64",
"title": "/ The date of this payment"
},
"path": {
"type": "array",
"items": {
"type": "string"
},
"title": "/ The path this payment took"
},
"fee": {
"type": "string",
"format": "int64",
"title": "/ The fee paid for this payment in satoshis"
}
}
},
"lnrpcPeer": {
"type": "object",
"properties": {
"pub_key": {
"type": "string",
"title": "/ The identity pubkey of the peer"
},
"peer_id": {
"type": "integer",
"format": "int32",
"title": "/ The peer's id from the local point of view"
},
"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"
}
}
},
"lnrpcPendingChannelResponse": {
"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/PendingChannelResponsePendingOpenChannel"
},
"title": "/ Channels pending opening"
},
"pending_closing_channels": {
"type": "array",
"items": {
"$ref": "#/definitions/PendingChannelResponseClosedChannel"
},
"title": "/ Channels pending closing"
},
"pending_force_closing_channels": {
"type": "array",
"items": {
"$ref": "#/definitions/PendingChannelResponseForceClosedChannel"
},
"title": "/ Channels pending force closing"
}
}
},
"lnrpcPendingUpdate": {
"type": "object",
"properties": {
"txid": {
"type": "string",
"format": "byte"
},
"output_index": {
"type": "integer",
"format": "int64"
}
}
},
"lnrpcQueryRoutesResponse": {
"type": "object",
"properties": {
"routes": {
"type": "array",
"items": {
"$ref": "#/definitions/lnrpcRoute"
}
}
}
},
"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\nit ourself."
},
"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."
}
},
"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."
},
"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"
}
}
},
"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"
}
}
},
"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",
"title": "/ The identity pubkey of the payment recipient"
},
"dest_string": {
"type": "string",
"title": "/ The hex-encoded identity pubkey of the payment recipient"
},
"amt": {
"type": "string",
"format": "int64",
"description": "/ Number of satoshis to send."
},
"payment_hash": {
"type": "string",
"format": "byte",
"title": "/ The hash to use within the payment's HTLC"
},
"payment_hash_string": {
"type": "string",
"title": "/ The hex-encoded hash to use within the payment's HTLC"
},
"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."
}
}
},
"lnrpcSendResponse": {
"type": "object",
"properties": {
"payment_error": {
"type": "string"
},
"payment_preimage": {
"type": "string",
"format": "byte"
},
"payment_route": {
"$ref": "#/definitions/lnrpcRoute"
}
}
},
"lnrpcSetAliasResponse": {
"type": "object"
},
"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 ammount, 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"
}
}
},
"lnrpcTransactionDetails": {
"type": "object",
"properties": {
"transactions": {
"type": "array",
"items": {
"$ref": "#/definitions/lnrpcTransaction"
},
"description": "/ The list of transactions relevant to the wallet."
}
}
},
"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": {
"balance": {
"type": "string",
"format": "int64",
"title": "/ The balance of the wallet"
}
}
}
}
}