gettxout

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.getTxOut("c7ad51e46a39d136adc2bb7536a236136cc206ab3c8dabcd4277d4cadcf674f2", 1)

await tatum.destroy() // Destroy Tatum SDK - needed for stopping background jobs

Overview

The gettxout RPC method returns details about an unspent transaction output (UTXO). This method can be used to check if a specific transaction output is still unspent and obtain its details such as the value and scriptPubKey.

Parameters

txid (string, required): The transaction ID of the output.
n (numeric, required): The index of the output within the transaction (vout).
include_mempool (boolean, optional, default=true): Whether to include the mempool. Set to false to only check for outputs confirmed in the blockchain.

Example

txid: "a12345abcdef67890bcdef1234567890abcdef1234567890abcdef1234567890"
n: 1
include_mempool: true

Return Object

The return object contains the following fields:

bestblock: (string) The hash of the block at the tip of the blockchain.
confirmations: (numeric) The number of confirmations for the transaction. -1 if the transaction is not yet confirmed and in the mempool.
value: (numeric) The value of the output.
scriptPubKey: (object) Information about the output's scriptPubKey.
- asm: (string) The assembly representation of the script.
- hex: (string) The hex representation of the script.
- type: (string) The type of the script (e.g., pubkeyhash, scripthash).
- addresses: (array) The addresses associated with this output.
coinbase: (boolean) Whether the transaction is a coinbase transaction.
version: (numeric) The transaction version.
height: (numeric) The height of the block containing this output.

JSON Examples

Request example:

{% code overflow="wrap" lineNumbers="true" %}

{
  "jsonrpc": "2.0",
  "method": "gettxout",
  "params": ["c7ad51e46a39d136adc2bb7536a236136cc206ab3c8dabcd4277d4cadcf674f2", 1],
  "id": 1
}

{% endcode %}

Response example:

{% code overflow="wrap" lineNumbers="true" %}

{
    "result": {
        "bestblock": "00000000000000000000bb252e11a381e2d9ee948dd8f2c9df9b7cb41adc40b2",
        "confirmations": 5,
        "value": 0.0027,
        "scriptPubKey": {
            "asm": "0 24007ed98749dbb504fdea2bd07715c94d4c7751",
            "desc": "addr(bc1qysq8akv8f8dm2p8aag4aqac4e9x5ca63yq4c88)#2wxgfkqe",
            "hex": "001424007ed98749dbb504fdea2bd07715c94d4c7751",
            "address": "bc1qysq8akv8f8dm2p8aag4aqac4e9x5ca63yq4c88",
            "type": "witness_v0_keyhash"
        },
        "coinbase": false
    },
    "error": null,
    "id": 1
}

{% endcode %}