GetLsatTokens

GetLsatTokens returns all LSAT tokens the daemon ever paid for.

Source: poolrpc/trader.proto

gRPC

rpc GetLsatTokens (TokensRequest) returns (TokensResponse);

REST

HTTP Method	Path
GET	/v1/pool/lsat/tokens

Code Samples

gRPC

Javascript

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

const GRPC_HOST = 'localhost:12010'
const MACAROON_PATH = 'POOL_DIR/regtest/pool.macaroon'
const TLS_PATH = 'POOL_DIR/tls.cert'

const loaderOptions = {
  keepCase: true,
  longs: String,
  enums: String,
  defaults: true,
  oneofs: true,
};
const packageDefinition = protoLoader.loadSync('poolrpc/trader.proto', loaderOptions);
const poolrpc = grpc.loadPackageDefinition(packageDefinition).poolrpc;
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 poolrpc.Trader(GRPC_HOST, creds);
let request = {};
client.getLsatTokens(request, function(err, response) {
  console.log(response);
});
// Console output:
//  {
//    "tokens": <LsatToken>,
//  }

Python

import codecs, grpc, os
# Generate the following 2 modules by compiling the poolrpc/trader.proto with the grpcio-tools.
# See https://github.com/lightningnetwork/lnd/blob/master/docs/grpc/python.md for instructions.
import trader_pb2 as poolrpc, trader_pb2_grpc as traderstub

GRPC_HOST = 'localhost:12010'
MACAROON_PATH = 'POOL_DIR/regtest/pool.macaroon'
TLS_PATH = 'POOL_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 = traderstub.TraderStub(channel)
request = poolrpc.TokensRequest()
response = stub.GetLsatTokens(request)
print(response)
# {
#    "tokens": <LsatToken>,
# }

REST

Javascript

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

const REST_HOST = 'localhost:8281'
const MACAROON_PATH = 'POOL_DIR/regtest/pool.macaroon'

let options = {
  url: `https://${REST_HOST}/v1/pool/lsat/tokens`,
  // 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:
//  {
//    "tokens": <array>, // <LsatToken> 
//  }

Python

import base64, codecs, json, requests

REST_HOST = 'localhost:8281'
MACAROON_PATH = 'POOL_DIR/regtest/pool.macaroon'
TLS_PATH = 'POOL_DIR/tls.cert'

url = f'https://{REST_HOST}/v1/pool/lsat/tokens'
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())
# {
#    "tokens": <LsatToken>,
# }

Shell

$ pool listauth --help

NAME:
   pool listauth - list all LSAT tokens

USAGE:
   pool listauth [arguments...]

DESCRIPTION:
   Shows a list of all LSAT tokens that poold has paid for

Messages

poolrpc.TokensRequest

Source: poolrpc/trader.proto

note

This request has no parameters.

poolrpc.TokensResponse

Source: poolrpc/trader.proto

Field	gRPC Type	REST Type
tokens List of all tokens the daemon knows of, including old/expired tokens.	LsatToken[]	array

Nested Messages

poolrpc.LsatToken

Field	gRPC Type	REST Type
base_macaroon The base macaroon that was baked by the auth server.	bytes	string
payment_hash The payment hash of the payment that was paid to obtain the token.	bytes	string
payment_preimage The preimage of the payment hash, knowledge of this is proof that the payment has been paid. If the preimage is set to all zeros, this means the payment is still pending and the token is not yet fully valid.	bytes	string
amount_paid_msat The amount of millisatoshis that was paid to get the token.	int64	string
routing_fee_paid_msat The amount of millisatoshis paid in routing fee to pay for the token.	int64	string
time_created The creation time of the token as UNIX timestamp in seconds.	int64	string
expired Indicates whether the token is expired or still valid.	bool	boolean
storage_name Identifying attribute of this token in the store. Currently represents the file name of the token where it's stored on the file system.	string	string