ListAccounts

ListAccounts returns all accounts that are currently stored in the account database.

Source: lit-accounts.proto

gRPC

rpc ListAccounts (ListAccountsRequest) returns (ListAccountsResponse);

REST

HTTP Method	Path
GET	/v1/accounts

Code Samples

gRPC

Javascript

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

const GRPC_HOST = 'localhost:8443'
const MACAROON_PATH = 'LIT_DIR/regtest/lit.macaroon'
const TLS_PATH = 'LIT_DIR/tls.cert'

const loaderOptions = {
  keepCase: true,
  longs: String,
  enums: String,
  defaults: true,
  oneofs: true,
};
const packageDefinition = protoLoader.loadSync('lit-accounts.proto', loaderOptions);
const litrpc = grpc.loadPackageDefinition(packageDefinition).litrpc;
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 litrpc.Accounts(GRPC_HOST, creds);
let request = {};
client.listAccounts(request, function(err, response) {
  console.log(response);
});
// Console output:
//  {
//    "accounts": <Account>,
//  }

Python

import codecs, grpc, os
# Generate the following 2 modules by compiling the lit-accounts.proto with the grpcio-tools.
# See https://github.com/lightningnetwork/lnd/blob/master/docs/grpc/python.md for instructions.
import lit-accounts_pb2 as litrpc, lit-accounts_pb2_grpc as lit-accountsstub

GRPC_HOST = 'localhost:8443'
MACAROON_PATH = 'LIT_DIR/regtest/lit.macaroon'
TLS_PATH = 'LIT_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 = lit-accountsstub.AccountsStub(channel)
request = litrpc.ListAccountsRequest()
response = stub.ListAccounts(request)
print(response)
# {
#    "accounts": <Account>,
# }

REST

Javascript

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

const REST_HOST = 'localhost:8443'
const MACAROON_PATH = 'LIT_DIR/regtest/lit.macaroon'

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

Python

import base64, codecs, json, requests

REST_HOST = 'localhost:8443'
MACAROON_PATH = 'LIT_DIR/regtest/lit.macaroon'
TLS_PATH = 'LIT_DIR/tls.cert'

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

Shell

$ litcli accounts list --help

NAME:
   litcli accounts list - List all off-chain accounts.

USAGE:
   litcli accounts list [arguments...]

DESCRIPTION:
   Returns all accounts that are currently stored in the account database.

Messages

litrpc.ListAccountsRequest

Source: lit-accounts.proto

note

This request has no parameters.

litrpc.ListAccountsResponse

Source: lit-accounts.proto

Field	gRPC Type	REST Type
accounts All accounts in the account database.	Account[]	array

Nested Messages

litrpc.Account

Field	gRPC Type	REST Type
id The ID of the account.	string	string
initial_balance The initial balance in satoshis that was set when the account was created.	uint64	string
current_balance The current balance in satoshis.	int64	string
last_update Timestamp of the last time the account was updated.	int64	string
expiration_date Timestamp of the account's expiration date. Zero means it does not expire.	int64	string
invoices The list of invoices created by the account. An invoice created by an account will credit the account balance if it is settled.	AccountInvoice[]	array
payments The list of payments made by the account. A payment made by an account will debit the account balance if it is settled.	AccountPayment[]	array
label An optional label to identify the account. If this is not empty, then it is guaranteed to be unique.	string	string

litrpc.AccountInvoice

Field	gRPC Type	REST Type
hash The payment hash of the invoice.	bytes	string

litrpc.AccountPayment

Field	gRPC Type	REST Type
hash The payment hash.	bytes	string
state The state of the payment as reported by lnd.	string	string
full_amount The full amount in satoshis reserved for this payment. This includes the routing fee estimated by the fee limit of the payment request. The actual debited amount will likely be lower if the fee is below the limit.	int64	string