BCH RPC
How to use it
// yarn add @tatumio/tatum
import { TatumSDK, BitcoinCash, Network } from '@tatumio/tatum'
const tatum = await TatumSDK.init<BitcoinCash>({ network: Network.BITCOIN_CASH })
const result = await tatum.rpc.getRawTransaction(
'c7ad51e46a39d136adc2bb7536a236136cc206ab3c8dabcd4277d4cadcf674f2',
)
await tatum.destroy() // Destroy Tatum SDK - needed for stopping background jobs
Overview
The getrawtransaction
RPC method retrieves a raw transaction from the blockchain or mempool. It returns the serialized (hex-encoded) transaction data. This method can be used to inspect a transaction's content before it's included in a block or to decode the transaction for further analysis.
Parameters
txid
: (string, required) The transaction ID of the transaction to fetch.verbose
: (bool, optional, default=false) If set totrue
, the method returns a JSON object containing information about the transaction.
Return Object
If verbose
is false
, the method returns a hex-encoded string representing the serialized transaction data. If verbose
is true
, the method returns a JSON object with the following fields:
txid
: (string) The transaction ID.hash
: (string) The transaction hash.version
: (numeric) The transaction version.size
: (numeric) The transaction size.vsize
: (numeric) The virtual transaction size.weight
: (numeric) The transaction's weight.locktime
: (numeric) The transaction locktime.vin
: (array) The transaction inputs. Each object within the array has the following properties:txid
: A string representing the transaction ID of the output being spent. This refers to the transaction where the bitcoin spent in the current transaction was received.vout
: An integer representing the index of the output in the transaction specified bytxid
. This is the position of the output in that transaction'svout
array.scriptSig
: An object containing two fields,asm
andhex
, which represent the unlocking script that satisfies the conditions of the spent output's locking script.asm
contains the assembly representation of the script, whilehex
contains the hexadecimal representation.sequence
: A number representing the sequence number of the input. It can be used to signal relative locktime constraints on the transaction.
vout
: (array) The transaction outputs. Each object within the array has the following properties:value
: A decimal number representing the amount sent to the output's address.n
: An integer representing the index of the output in the transaction'svout
array.scriptPubKey
: An object containing information about the locking script used to lock the output. The object has the following fields:asm
: The assembly representation of the locking script.hex
: The hexadecimal representation of the locking script.reqSigs
: The number of required signatures to unlock the output (relevant for multisig addresses).type
: The type of the locking script (e.g., 'pubkeyhash', 'scripthash', 'multisig', etc.).addresses
: An array of addresses associated with the output.
hex
: (string) The serialized transaction data in hex format.blockhash
: (string, optional) The block hash containing the transaction.confirmations
: (numeric, optional) The number of confirmations the transaction has.time
: (numeric, optional) The transaction time in UNIX timestamp format.blocktime
: (numeric, optional) The block time in UNIX timestamp format.
JSON Examples
Request example:
{% code overflow="wrap" lineNumbers="true" %}
{
"jsonrpc": "2.0",
"method": "getrawtransaction",
"params": ["c7ad51e46a39d136adc2bb7536a236136cc206ab3c8dabcd4277d4cadcf674f2", true],
"id": 1
}
{% endcode %}
Response example:
{% code overflow="wrap" lineNumbers="true" %}
{
"result": {
"txid": "c7ad51e46a39d136adc2bb7536a236136cc206ab3c8dabcd4277d4cadcf674f2",
"hash": "c00fc27056ad4305dc65a40a78381a6c923b4311a460ceccd81401016f5c8984",
"version": 2,
"size": 284,
"vsize": 203,
"weight": 809,
"locktime": 0,
"vin": [
{
"txid": "aaeb16390ca5209d8c72a0090a9ca87e6ff6491f239b3496cdb5c99977643583",
"vout": 9,
"scriptSig": {
"asm": "",
"hex": ""
},
"txinwitness": [
"3044022070cc08500b2203b6ebe7c8285295bc1914a9d252504416e1cde4de4a7dc6c3c8022079af2be6db34efcf147e86a4cbf61cf9995106e5b5e95270d47c40b082052c8501",
"03c9f7cff5a1d1a5fc107f37609c99d2e0fd699cacdef9696753b626b7508921c0"
],
"sequence": 4294967294
}
],
"vout": [
{
"value": 0.00112825,
"n": 0,
"scriptPubKey": {
"asm": "0 29a7007eabae2ac56f221aad9c983b77a9f96c3b",
"desc": "addr(bc1q9xnsql4t4c4v2mezr2keexpmw75ljmpm0we75k)#3al0qk8v",
"hex": "001429a7007eabae2ac56f221aad9c983b77a9f96c3b",
"address": "bc1q9xnsql4t4c4v2mezr2keexpmw75ljmpm0we75k",
"type": "witness_v0_keyhash"
}
},
{
"value": 0.0027,
"n": 1,
"scriptPubKey": {
"asm": "0 24007ed98749dbb504fdea2bd07715c94d4c7751",
"desc": "addr(bc1qysq8akv8f8dm2p8aag4aqac4e9x5ca63yq4c88)#2wxgfkqe",
"hex": "001424007ed98749dbb504fdea2bd07715c94d4c7751",
"address": "bc1qysq8akv8f8dm2p8aag4aqac4e9x5ca63yq4c88",
"type": "witness_v0_keyhash"
}
},
{
"value": 0.00104468,
"n": 2,
"scriptPubKey": {
"asm": "0 c4c04e31613e2c3dfadaedde383bbfdd7a107d8a",
"desc": "addr(bc1qcnqyuvtp8ckrm7k6ah0rswalm4apqlv2ku24fa)#5rw0gs2m",
"hex": "0014c4c04e31613e2c3dfadaedde383bbfdd7a107d8a",
"address": "bc1qcnqyuvtp8ckrm7k6ah0rswalm4apqlv2ku24fa",
"type": "witness_v0_keyhash"
}
},
{
"value": 0.41658346,
"n": 3,
"scriptPubKey": {
"asm": "0 b33b0a68aba1d4697d8329f2b7939fb2a46b7332",
"desc": "addr(bc1qkvas569t582xjlvr98et0yulk2jxkuejx27yh4)#savgw9p6",
"hex": "0014b33b0a68aba1d4697d8329f2b7939fb2a46b7332",
"address": "bc1qkvas569t582xjlvr98et0yulk2jxkuejx27yh4",
"type": "witness_v0_keyhash"
}
}
],
"hex": "020000000001018335647799c9b5cd96349b231f49f66f7ea89c0a09a0728c9d20a50c3916ebaa0900000000feffffff04b9b801000000000016001429a7007eabae2ac56f221aad9c983b77a9f96c3bb01e04000000000016001424007ed98749dbb504fdea2bd07715c94d4c77511498010000000000160014c4c04e31613e2c3dfadaedde383bbfdd7a107d8aeaa77b0200000000160014b33b0a68aba1d4697d8329f2b7939fb2a46b733202473044022070cc08500b2203b6ebe7c8285295bc1914a9d252504416e1cde4de4a7dc6c3c8022079af2be6db34efcf147e86a4cbf61cf9995106e5b5e95270d47c40b082052c85012103c9f7cff5a1d1a5fc107f37609c99d2e0fd699cacdef9696753b626b7508921c000000000",
"blockhash": "00000000000000000004c6125026f00b76e7b762e645a0b0b7ecfa7a7dafdba2",
"confirmations": 7,
"time": 1682503076,
"blocktime": 1682503076
},
"error": null,
"id": 1
}
{% endcode %}
\