UpdateAccount

UpdateAccount updates an existing account in the account database.

Source: lit-accounts.proto

gRPC

rpc UpdateAccount (UpdateAccountRequest) returns (Account);

REST

HTTP Method	Path
POST	/v1/accounts/{id}

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

REST

Javascript

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

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

let requestBody = {
  id: <string>, // <string> 
  account_balance: <unknown>, // <int64> 
  expiration_date: <unknown>, // <int64> 
  label: <unknown>, // <string> 
};
let options = {
  url: `https://${REST_HOST}/v1/accounts/{id}`,
  // Work-around for self-signed certificates.
  rejectUnauthorized: false,
  json: true,
  headers: {
    'Grpc-Metadata-macaroon': fs.readFileSync(MACAROON_PATH).toString('hex'),
  },
  form: JSON.stringify(requestBody),
}
request.post(options, function(error, response, body) {
  console.log(body);
});
// Console output:
//  {
//    "id": <string>, // <string> 
//    "initial_balance": <string>, // <uint64> 
//    "current_balance": <string>, // <int64> 
//    "last_update": <string>, // <int64> 
//    "expiration_date": <string>, // <int64> 
//    "invoices": <array>, // <AccountInvoice> 
//    "payments": <array>, // <AccountPayment> 
//    "label": <string>, // <string> 
//  }

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/{id}'
macaroon = codecs.encode(open(MACAROON_PATH, 'rb').read(), 'hex')
headers = {'Grpc-Metadata-macaroon': macaroon}
data = {
  'id': <string>,
  'account_balance': <int64>,
  'expiration_date': <int64>,
  'label': <string>,
}
r = requests.post(url, headers=headers, data=json.dumps(data), verify=TLS_PATH)
print(r.json())
# {
#    "id": <string>,
#    "initial_balance": <uint64>,
#    "current_balance": <int64>,
#    "last_update": <int64>,
#    "expiration_date": <int64>,
#    "invoices": <AccountInvoice>,
#    "payments": <AccountPayment>,
#    "label": <string>,
# }

Shell

$ litcli accounts update --help

NAME:
   litcli accounts update - Update an existing off-chain account.

USAGE:
   litcli accounts update [command options] [id | label] new_balance [new_expiration_date] [--save_to=]

DESCRIPTION:
   Updates an existing off-chain account and sets either a new balance or new expiration date or both.

OPTIONS:
   --id value                   The ID of the account to update.
   --label value                (optional) The unique label of the account.
   --new_balance value          The new balance of the account; -1 means do not update the balance. (default: -1)
   --new_expiration_date value  The new expiration date of the account expressed in seconds since the unix epoch; -1 means do not update the expiration date; 0 means it does not expire. (default: -1)
   

Messages

litrpc.UpdateAccountRequest

Source: lit-accounts.proto

Field	gRPC Type	REST Type	REST Placement
id The ID of the account to update. Either the ID or the label must be set.	string	string	path
account_balance The new account balance to set. Set to -1 to not update the balance.	int64	unknown	body
expiration_date The new account expiry to set. Set to -1 to not update the expiry. Set to 0 to never expire.	int64	unknown	body
label The label of the account to update. If an account has no label, then the ID must be used instead.	string	unknown	body

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