decoderawtransaction

decoderawtransaction "hexstring" ( iswitness ) Return a JSON object representing the serialized, hex-encoded transaction. Arguments: 1. hexstring (string, required) The transaction hex string 2. iswitness (boolean, optional, default=depends on heuristic tests) Whether the transaction hex is a serialized witness transaction. If iswitness is not present, heuristic tests will be used in decoding. If true, only witness deserialization will be tried. If false, only non-witness deserialization will be tried. This boolean should reflect whether the transaction has inputs (e.g. fully valid, or on-chain transactions), if known by the caller. Result: { (json object) "txid" : "hex", (string) The transaction id "hash" : "hex", (string) The transaction hash (differs from txid for witness transactions) "size" : n, (numeric) The serialized transaction size "vsize" : n, (numeric) The virtual transaction size (differs from size for witness transactions) "weight" : n, (numeric) The transaction's weight (between vsize*4-3 and vsize*4) "version" : n, (numeric) The version "locktime" : xxx, (numeric) The lock time "vin" : [ (json array) { (json object) "coinbase" : "hex", (string, optional) The coinbase value (only if coinbase transaction) "txid" : "hex", (string, optional) The transaction id (if not coinbase transaction) "vout" : n, (numeric, optional) The output number (if not coinbase transaction) "scriptSig" : { (json object, optional) The script (if not coinbase transaction) "asm" : "str", (string) Disassembly of the signature script "hex" : "hex" (string) The raw signature script bytes, hex-encoded }, "txinwitness" : [ (json array, optional) "hex", (string) hex-encoded witness data (if any) ... ], "sequence" : n (numeric) The script sequence number }, ... ], "vout" : [ (json array) { (json object) "value" : n, (numeric) The value in BTC "n" : n, (numeric) index "scriptPubKey" : { (json object) "asm" : "str", (string) Disassembly of the output script "desc" : "str", (string) Inferred descriptor for the output "hex" : "hex", (string) The raw output script bytes, hex-encoded "address" : "str", (string, optional) The Bitcoin address (only if a well-defined address exists) "type" : "str" (string) The type (one of: nonstandard, anchor, pubkey, pubkeyhash, scripthash, multisig, nulldata, witness_v0_scripthash, witness_v0_keyhash, witness_v1_taproot, witness_v2_taproot, witness_unknown) }, "outext" : "hex" (string, optional) Output extension TLV (hex), if present }, ... ] } Examples: > bitcoin-cli decoderawtransaction "hexstring" > curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "decoderawtransaction", "params": ["hexstring"]}' -H 'content-type: application/json' http://127.0.0.1:8332/

Signature

decoderawtransaction(hexstring: string, iswitness?: boolean) → any

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"decoderawtransaction","params":["\"<hexstring>\"",false]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli decoderawtransaction "hexstring"

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "decoderawtransaction", "params": ["hexstring"]}' -H 'content-type: application/json' http://127.0.0.1:8332/

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "decoderawtransaction",
        "params": ["\"<hexstring>\"", false],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "decoderawtransaction",
    params: ["\"<hexstring>\"",false],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
hexstring	`string`	yes	The transaction hex string
iswitness	`boolean`	—	Whether the transaction hex is a serialized witness transaction. If iswitness is not present, heuristic tests will be used in decoding. If true, only witness deserialization will be tried. If false, only non-witness deserialization will be tried. This boolean should reflect whether the transaction has inputs (e.g. fully valid, or on-chain transactions), if known by the caller.

Result

Type: any

{ "txid" : "hex", "hash" : "hex", "size" : n, "vsize" : n, "weight" : n, "version" : n, "locktime" : xxx, "vin" : [ { "coinbase" : "hex", "txid" : "hex", "vout" : n, "scriptSig" : { "asm" : "str", "hex" : "hex" }, "txinwitness" : [ "hex", ... ], "sequence" : n }, ... ], "vout" : [ { "value" : n, "n" : n, "scriptPubKey" : { "asm" : "str", "desc" : "str", "hex" : "hex", "address" "type" : "str" }, "outext" : "hex" }, ... ] } (json object) (string) The transaction id (string) The transaction hash (differs from txid for witness transactions) (numeric) The serialized transaction size (numeric) The virtual transaction size (differs from size for witness transactions) (numeric) The transaction's weight (between vsize*4-3 and vsize*4) (numeric) The version (numeric) The lock time (json array) (json object) (string, optional) The coinbase value (only if coinbase transaction) (string, optional) The transaction id (if not coinbase transaction) (numeric, optional) The output number (if not coinbase transaction) (json object, optional) The script (if not coinbase transaction) (string) Disassembly of the signature script (string) The raw signature script bytes, hex-encoded (json array, optional) (string) hex-encoded witness data (if any) (numeric) The script sequence number (json array) (json object) (numeric) The value in BTC (numeric) index (json object) (string) Disassembly of the output script (string) Inferred descriptor for the output (string) The raw output script bytes, hex-encoded : "str", (string, optional) The Bitcoin address (only if a well-defined address exists) (string) The type (one of: nonstandard, anchor, pubkey, pubkeyhash, scripthash, multisig, nulldata, witness_v0_scripthash, witness_v0_keyhash, witness_v1_taproot, witness_v2_taproot, witness_unknown) (string, optional) Output extension TLV (hex), if present

Source: services/core-node/bcore/src/rpc/rawtransaction.cpp:3112

C++ symbol: decoderawtransaction

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"decoderawtransaction","params":["\"<hexstring>\"",false]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli decoderawtransaction "hexstring"

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "decoderawtransaction", "params": ["hexstring"]}' -H 'content-type: application/json' http://127.0.0.1:8332/

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "decoderawtransaction",
        "params": ["\"<hexstring>\"", false],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "decoderawtransaction",
    params: ["\"<hexstring>\"",false],
  }),
});
console.log(await res.json());