AccountInfo

AccountInfo returns the account with the given ID or label.

Source: lit-accounts.proto

gRPC

rpc AccountInfo (AccountInfoRequest) returns (Account);

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 = {
  id: <string>,
  label: <string>,
};
client.accountInfo(request, function(err, response) {
  console.log(response);
});
// Console output:
//  {
//    "id": <string>,
//    "initial_balance": <uint64>,
//    "current_balance": <int64>,
//    "last_update": <int64>,
//    "expiration_date": <int64>,
//    "invoices": <AccountInvoice>,
//    "payments": <AccountPayment>,
//    "label": <string>,
//  }

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.AccountInfoRequest(
  id=<string>,
  label=<string>,
)
response = stub.AccountInfo(request)
print(response)
# {
#    "id": <string>,
#    "initial_balance": <uint64>,
#    "current_balance": <int64>,
#    "last_update": <int64>,
#    "expiration_date": <int64>,
#    "invoices": <AccountInvoice>,
#    "payments": <AccountPayment>,
#    "label": <string>,
# }

Shell

$ litcli accounts info --help

NAME:
   litcli accounts info - Show information about a single off-chain account.

USAGE:
   litcli accounts info [command options] [id | label]

DESCRIPTION:
   Returns a single account entry from the account database.

OPTIONS:
   --id value     The ID of the account.
   --label value  (optional) The unique label of the account.
   

Messages

litrpc.AccountInfoRequest

Source: lit-accounts.proto

Field	gRPC Type	REST Type	REST Placement
id The hexadecimal ID of the account to remove. Either the ID or the label must be set.	string	unknown	unknown
label The label of the account to remove. If an account has no label, then the ID must be used instead.	string	unknown	unknown

litrpc.Account

Source: lit-accounts.proto

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

Nested Messages

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