PendingChannels - 查询对端节点
PendingChannels 返回当前被视为”待确认“的所有通道。一个通道如果完成了存款流程,正在 等待存款交易的确认,或者处于关闭过程中,那么该通道将被视为处于”待确认“状态。
gRPC请求 - PendingChannelsRequest
无字段。
gRPC响应 - PendingChannelsResponse
字段如下:
- total_limbo_balance:待定通道中的余额, int64,单位:satoshi
- pending_open_channels:等待开启的通道对象数组
- pending_closing_channels:等待关闭的通道对象数组
- pending_force_closing_channels:等待强制关闭的通道对象数组
- waiting_close_channels:等待关闭交易确认的通道数组
示例代码
Python示例代码
>>> import codecs, grpc, os
>>> import rpc_pb2 as ln, rpc_pb2_grpc as lnrpc
>>> macaroon = codecs.encode(open('LND_DIR/data/chain/bitcoin/simnet/admin.macaroon', 'rb').read(), 'hex')
>>> os.environ['GRPC_SSL_CIPHER_SUITES'] = 'HIGH+ECDSA'
>>> cert = open('LND_DIR/tls.cert', 'rb').read()
>>> ssl_creds = grpc.ssl_channel_credentials(cert)
>>> channel = grpc.secure_channel('localhost:10009', ssl_creds)
>>> stub = lnrpc.LightningStub(channel)
>>> request = ln.PendingChannelsRequest()
>>> response = stub.PendingChannels(request)
>>> print(response)
{
"total_limbo_balance": <int64>,
"pending_open_channels": <array PendingOpenChannel>,
"pending_closing_channels": <array ClosedChannel>,
"pending_force_closing_channels": <array ForceClosedChannel>,
"waiting_close_channels": <array WaitingCloseChannel>,
}
JavaScript示例代码
> var fs = require('fs');
> var grpc = require('grpc');
> var lnrpc = grpc.load('rpc.proto').lnrpc;
> process.env.GRPC_SSL_CIPHER_SUITES = 'HIGH+ECDSA'
> var lndCert = fs.readFileSync('LND_DIR/tls.cert');
> var sslCreds = grpc.credentials.createSsl(lndCert);
> var macaroonCreds = grpc.credentials.createFromMetadataGenerator(function(args, callback) {
var macaroon = fs.readFileSync("LND_DIR/data/chain/bitcoin/simnet/admin.macaroon").toString('hex');
var metadata = new grpc.Metadata()
metadata.add('macaroon', macaroon);
callback(null, metadata);
});
> var creds = grpc.credentials.combineChannelCredentials(sslCreds, macaroonCreds);
> var lightning = new lnrpc.Lightning('localhost:10009', creds);
> var request = {}
> lightning.pendingChannels(request, function(err, response) {
console.log(response);
})
{
"total_limbo_balance": <int64>,
"pending_open_channels": <array PendingOpenChannel>,
"pending_closing_channels": <array ClosedChannel>,
"pending_force_closing_channels": <array ForceClosedChannel>,
"waiting_close_channels": <array WaitingCloseChannel>,
}