GetTransaction

GetTransaction returns details for a transaction found in the wallet.

Source: walletrpc/walletkit.proto

gRPC

rpc GetTransaction (GetTransactionRequest) returns (Transaction);

REST

HTTP Method	Path
GET	/v2/wallet/tx

Code Samples

gRPC

Javascript

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

const GRPC_HOST = 'localhost:10009'
const MACAROON_PATH = 'LND_DIR/data/chain/bitcoin/regtest/admin.macaroon'
const TLS_PATH = 'LND_DIR/tls.cert'

const loaderOptions = {
  keepCase: true,
  longs: String,
  enums: String,
  defaults: true,
  oneofs: true,
};
const packageDefinition = protoLoader.loadSync(['lightning.proto', 'walletrpc/walletkit.proto'], loaderOptions);
const walletrpc = grpc.loadPackageDefinition(packageDefinition).walletrpc;
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 walletrpc.WalletKit(GRPC_HOST, creds);
let request = {
  txid: <string>,
};
client.getTransaction(request, function(err, response) {
  console.log(response);
});
// Console output:
//  {
//    "tx_hash": <string>,
//    "amount": <int64>,
//    "num_confirmations": <int32>,
//    "block_hash": <string>,
//    "block_height": <int32>,
//    "time_stamp": <int64>,
//    "total_fees": <int64>,
//    "dest_addresses": <string>,
//    "output_details": <OutputDetail>,
//    "raw_tx_hex": <string>,
//    "label": <string>,
//    "previous_outpoints": <PreviousOutPoint>,
//  }

Python

import codecs, grpc, os
# Generate the following 2 modules by compiling the walletrpc/walletkit.proto with the grpcio-tools.
# See https://github.com/lightningnetwork/lnd/blob/master/docs/grpc/python.md for instructions.
import walletkit_pb2 as walletrpc, walletkit_pb2_grpc as walletkitstub

GRPC_HOST = 'localhost:10009'
MACAROON_PATH = 'LND_DIR/data/chain/bitcoin/regtest/admin.macaroon'
TLS_PATH = 'LND_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 = walletkitstub.WalletKitStub(channel)
request = walletrpc.GetTransactionRequest(
  txid=<string>,
)
response = stub.GetTransaction(request)
print(response)
# {
#    "tx_hash": <string>,
#    "amount": <int64>,
#    "num_confirmations": <int32>,
#    "block_hash": <string>,
#    "block_height": <int32>,
#    "time_stamp": <int64>,
#    "total_fees": <int64>,
#    "dest_addresses": <string>,
#    "output_details": <OutputDetail>,
#    "raw_tx_hex": <string>,
#    "label": <string>,
#    "previous_outpoints": <PreviousOutPoint>,
# }

REST

Javascript

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

const REST_HOST = 'localhost:8080'
const MACAROON_PATH = 'LND_DIR/data/chain/bitcoin/regtest/admin.macaroon'

let options = {
  url: `https://${REST_HOST}/v2/wallet/tx`,
  // 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:
//  {
//    "tx_hash": <string>, // <string> 
//    "amount": <string>, // <int64> 
//    "num_confirmations": <integer>, // <int32> 
//    "block_hash": <string>, // <string> 
//    "block_height": <integer>, // <int32> 
//    "time_stamp": <string>, // <int64> 
//    "total_fees": <string>, // <int64> 
//    "dest_addresses": <array>, // <string> 
//    "output_details": <array>, // <OutputDetail> 
//    "raw_tx_hex": <string>, // <string> 
//    "label": <string>, // <string> 
//    "previous_outpoints": <array>, // <PreviousOutPoint> 
//  }

Python

import base64, codecs, json, requests

REST_HOST = 'localhost:8080'
MACAROON_PATH = 'LND_DIR/data/chain/bitcoin/regtest/admin.macaroon'
TLS_PATH = 'LND_DIR/tls.cert'

url = f'https://{REST_HOST}/v2/wallet/tx'
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())
# {
#    "tx_hash": <string>,
#    "amount": <int64>,
#    "num_confirmations": <int32>,
#    "block_hash": <string>,
#    "block_height": <int32>,
#    "time_stamp": <int64>,
#    "total_fees": <int64>,
#    "dest_addresses": <string>,
#    "output_details": <OutputDetail>,
#    "raw_tx_hex": <string>,
#    "label": <string>,
#    "previous_outpoints": <PreviousOutPoint>,
# }

Shell

$ lncli wallet gettx --help

NAME:
   lncli wallet gettx - Returns details of a transaction.

USAGE:
   lncli wallet gettx txid

DESCRIPTION:
   
  Query the transaction using the given transaction id and return its 
  details. An error is returned if the transaction is not found.
  

Messages

walletrpc.GetTransactionRequest

Source: walletrpc/walletkit.proto

Field	gRPC Type	REST Type	REST Placement
txid The txid of the transaction.	string	string	query

lnrpc.Transaction

Source: lightning.proto

Field	gRPC Type	REST Type
tx_hash The transaction hash	string	string
amount The transaction amount, denominated in satoshis	int64	string
num_confirmations The number of confirmations	int32	integer
block_hash The hash of the block this transaction was included in	string	string
block_height The height of the block this transaction was included in	int32	integer
time_stamp Timestamp of this transaction	int64	string
total_fees Fees paid for this transaction	int64	string
dest_addressesdeprecated Addresses that received funds for this transaction. Deprecated as it is now incorporated in the output_details field.	string[]	array
output_details Outputs that received funds for this transaction	OutputDetail[]	array
raw_tx_hex The raw transaction hex.	string	string
label A label that was optionally set on transaction broadcast.	string	string
previous_outpoints PreviousOutpoints/Inputs of this transaction.	PreviousOutPoint[]	array

Nested Messages

lnrpc.OutputDetail

Field	gRPC Type	REST Type
output_type The type of the output	OutputScriptType	string
address The address	string	string
pk_script The pkscript in hex	string	string
output_index The output index used in the raw transaction	int64	string
amount The value of the output coin in satoshis	int64	string
is_our_address Denotes if the output is controlled by the internal wallet	bool	boolean

lnrpc.PreviousOutPoint

Field	gRPC Type	REST Type
outpoint The outpoint in format txid:n.	string	string
is_our_output Denotes if the outpoint is controlled by the internal wallet. The flag will only detect p2wkh, np2wkh and p2tr inputs as its own.	bool	boolean

Enums

lnrpc.OutputScriptType

Name	Number
SCRIPT_TYPE_PUBKEY_HASH	0
SCRIPT_TYPE_SCRIPT_HASH	1
SCRIPT_TYPE_WITNESS_V0_PUBKEY_HASH	2
SCRIPT_TYPE_WITNESS_V0_SCRIPT_HASH	3
SCRIPT_TYPE_PUBKEY	4
SCRIPT_TYPE_MULTISIG	5
SCRIPT_TYPE_NULLDATA	6
SCRIPT_TYPE_NON_STANDARD	7
SCRIPT_TYPE_WITNESS_UNKNOWN	8
SCRIPT_TYPE_WITNESS_V1_TAPROOT	9