GetNodeInfo

GetNodeInfo returns the latest advertised, aggregated, and authenticated channel information for the specified node identified by its public key.

Source: lightning.proto

gRPC

rpc GetNodeInfo (NodeInfoRequest) returns (NodeInfo);

REST

HTTP Method	Path
GET	/v1/graph/node/{pub_key}

Code Samples

gRPC

Javascript

const fs = require('fs');
const grpc = require('@grpc/grpc-js');
const protoLoader = require('@grpc/proto-loader');

const GRPC_HOST = 'localhost:10009'
const MACAROON_PATH = 'LND_DIR/data/chain/bitcoin/regtest/admin.macaroon'
const TLS_PATH = 'LND_DIR/tls.cert'

const loaderOptions = {
  keepCase: true,
  longs: String,
  enums: String,
  defaults: true,
  oneofs: true,
};
const packageDefinition = protoLoader.loadSync('lightning.proto', loaderOptions);
const lnrpc = grpc.loadPackageDefinition(packageDefinition).lnrpc;
process.env.GRPC_SSL_CIPHER_SUITES = 'HIGH+ECDSA';
const tlsCert = fs.readFileSync(TLS_PATH);
const sslCreds = grpc.credentials.createSsl(tlsCert);
const macaroon = fs.readFileSync(MACAROON_PATH).toString('hex');
const macaroonCreds = grpc.credentials.createFromMetadataGenerator(function(args, callback) {
  let metadata = new grpc.Metadata();
  metadata.add('macaroon', macaroon);
  callback(null, metadata);
});
let creds = grpc.credentials.combineChannelCredentials(sslCreds, macaroonCreds);
let client = new lnrpc.Lightning(GRPC_HOST, creds);
let request = {
  pub_key: <string>,
  include_channels: <bool>,
};
client.getNodeInfo(request, function(err, response) {
  console.log(response);
});
// Console output:
//  {
//    "node": <LightningNode>,
//    "num_channels": <uint32>,
//    "total_capacity": <int64>,
//    "channels": <ChannelEdge>,
//  }

Python

import codecs, grpc, os
# Generate the following 2 modules by compiling the lightning.proto with the grpcio-tools.
# See https://github.com/lightningnetwork/lnd/blob/master/docs/grpc/python.md for instructions.
import lightning_pb2 as lnrpc, lightning_pb2_grpc as lightningstub

GRPC_HOST = 'localhost:10009'
MACAROON_PATH = 'LND_DIR/data/chain/bitcoin/regtest/admin.macaroon'
TLS_PATH = 'LND_DIR/tls.cert'

# create macaroon credentials
macaroon = codecs.encode(open(MACAROON_PATH, 'rb').read(), 'hex')
def metadata_callback(context, callback):
  callback([('macaroon', macaroon)], None)
auth_creds = grpc.metadata_call_credentials(metadata_callback)
# create SSL credentials
os.environ['GRPC_SSL_CIPHER_SUITES'] = 'HIGH+ECDSA'
cert = open(TLS_PATH, 'rb').read()
ssl_creds = grpc.ssl_channel_credentials(cert)
# combine macaroon and SSL credentials
combined_creds = grpc.composite_channel_credentials(ssl_creds, auth_creds)
# make the request
channel = grpc.secure_channel(GRPC_HOST, combined_creds)
stub = lightningstub.LightningStub(channel)
request = lnrpc.NodeInfoRequest(
  pub_key=<string>,
  include_channels=<bool>,
)
response = stub.GetNodeInfo(request)
print(response)
# {
#    "node": <LightningNode>,
#    "num_channels": <uint32>,
#    "total_capacity": <int64>,
#    "channels": <ChannelEdge>,
# }

REST

Javascript

const fs = require('fs');
const request = require('request');

const REST_HOST = 'localhost:8080'
const MACAROON_PATH = 'LND_DIR/data/chain/bitcoin/regtest/admin.macaroon'

let options = {
  url: `https://${REST_HOST}/v1/graph/node/{pub_key}`,
  // Work-around for self-signed certificates.
  rejectUnauthorized: false,
  json: true,
  headers: {
    'Grpc-Metadata-macaroon': fs.readFileSync(MACAROON_PATH).toString('hex'),
  },
}
request.get(options, function(error, response, body) {
  console.log(body);
});
// Console output:
//  {
//    "node": <object>, // <LightningNode> 
//    "num_channels": <integer>, // <uint32> 
//    "total_capacity": <string>, // <int64> 
//    "channels": <array>, // <ChannelEdge> 
//  }

Python

import base64, codecs, json, requests

REST_HOST = 'localhost:8080'
MACAROON_PATH = 'LND_DIR/data/chain/bitcoin/regtest/admin.macaroon'
TLS_PATH = 'LND_DIR/tls.cert'

url = f'https://{REST_HOST}/v1/graph/node/{pub_key}'
macaroon = codecs.encode(open(MACAROON_PATH, 'rb').read(), 'hex')
headers = {'Grpc-Metadata-macaroon': macaroon}
r = requests.get(url, headers=headers, verify=TLS_PATH)
print(r.json())
# {
#    "node": <LightningNode>,
#    "num_channels": <uint32>,
#    "total_capacity": <int64>,
#    "channels": <ChannelEdge>,
# }

Shell

$ lncli getnodeinfo --help

NAME:
   lncli getnodeinfo - Get information on a specific node.

USAGE:
   lncli getnodeinfo [command options] [arguments...]

CATEGORY:
   Graph

DESCRIPTION:
   Prints out the latest authenticated node state for an advertised node

OPTIONS:
   --pub_key value     the 33-byte hex-encoded compressed public of the target node
   --include_channels  if true, will return all known channels associated with the node
   

Messages

lnrpc.NodeInfoRequest

Source: lightning.proto

Field	gRPC Type	REST Type	REST Placement
pub_key The 33-byte hex-encoded compressed public of the target node	string	string	path
include_channels If true, will include all known channels associated with the node.	bool	boolean	query

lnrpc.NodeInfo

Source: lightning.proto

Field	gRPC Type	REST Type
node An individual vertex/node within the channel graph. A node is connected to other nodes by one or more channel edges emanating from it. As the graph is directed, a node will also have an incoming edge attached to it for each outgoing edge.	LightningNode	object
num_channels The total number of channels for the node.	uint32	integer
total_capacity The sum of all channels capacity for the node, denominated in satoshis.	int64	string
channels A list of all public channels for the node.	ChannelEdge[]	array

Nested Messages

lnrpc.ChannelEdge

Field	gRPC Type	REST Type
channel_id The unique channel ID for the channel. The first 3 bytes are the block height, the next 3 the index within the block, and the last 2 bytes are the output index for the channel.	uint64	string
chan_point	string	string
last_update	uint32	integer
node1_pub	string	string
node2_pub	string	string
capacity	int64	string
node1_policy	RoutingPolicy	object
node2_policy	RoutingPolicy	object
custom_records Custom channel announcement tlv records.	CustomRecordsEntry[]	object

lnrpc.ChannelEdge.CustomRecordsEntry

Field	gRPC Type	REST Type
key	uint64	unknown
value	bytes	unknown

lnrpc.Feature

Field	gRPC Type	REST Type
name	string	string
is_required	bool	boolean
is_known	bool	boolean

lnrpc.LightningNode

Field	gRPC Type	REST Type
last_update	uint32	integer
pub_key	string	string
alias	string	string
addresses	NodeAddress[]	array
color	string	string
features	FeaturesEntry[]	object
custom_records Custom node announcement tlv records.	CustomRecordsEntry[]	object

lnrpc.LightningNode.CustomRecordsEntry

Field	gRPC Type	REST Type
key	uint64	unknown
value	bytes	unknown

lnrpc.LightningNode.FeaturesEntry

Field	gRPC Type	REST Type
key	uint32	unknown
value	Feature	unknown

lnrpc.NodeAddress

Field	gRPC Type	REST Type
network	string	string
addr	string	string

lnrpc.RoutingPolicy

Field	gRPC Type	REST Type
time_lock_delta	uint32	integer
min_htlc	int64	string
fee_base_msat	int64	string
fee_rate_milli_msat	int64	string
disabled	bool	boolean
max_htlc_msat	uint64	string
last_update	uint32	integer
custom_records Custom channel update tlv records.	CustomRecordsEntry[]	object
inbound_fee_base_msat	int32	integer
inbound_fee_rate_milli_msat	int32	integer

lnrpc.RoutingPolicy.CustomRecordsEntry

Field	gRPC Type	REST Type
key	uint64	unknown
value	bytes	unknown