The Specifics of Wealth: Using `gettxout`

12. The Specifics of Wealth: Using gettxout

While gettxoutsetinfo gives you the big picture, sometimes you need to look at a "Specific Bill" in the global wallet. You want to know: "Is this specific output still unspent? Is it real?" The command for this is gettxout. It is the "Verifier of Individual Bills," the "Microscope of the Bridge."

Analyzing the "Coin Retrieval" Code

In the source code (src/rpc/blockchain.cpp), the node looks directly into its "Active Cache" to see if a coin exists.

/**
 * This function retrieves a single "Unspent Output."
 */
static RPCMethod gettxout()
{
    // ... (Arguments omitted)
    [](const RPCMethod& self, const JSONRPCRequest& request) -> UniValue
{
    uint256 hash(ParseHashV(request.params[0], "txid"));
    int n = request.params[1].getInt<int>();

    ChainstateManager& chainman = EnsureAnyChainman(request.context);
    CCoinsViewCache& view = chainman.ActiveChainstate().CoinsTip();

    // We look for the "Coin" in the cache.
    Coin coin;
    if (view.GetCoin(COutPoint(hash, n), coin)) {
        UniValue obj(UniValue::VOBJ);
        obj.pushKV("value", ValueFromAmount(coin.out.nValue));
        obj.pushKV("confirmations", chainman.ActiveChain().Height() - coin.nHeight + 1);
        return obj;
    }

    return UniValue::VNULL; // Coin was spent!
}

Explaining the Bill to a Non-Coder

• COutPoint: In Bitcoin, you don't "Have an Address Balance." Instead, you own "Specific Outputs" from previous transactions. A COutPoint is the "Serial Number" of a specific digital bill. It's the Transaction ID plus the Index (n). It is the "Atomic Unit of Wealth."

• confirmations: This is the "Age of the Bill." If a coin was created 10 blocks ago, it has 10 confirmations. The older a coin is, the more "Solid" it becomes. It is the "Burial of the Past."

The "Spent" vs "Unspent" Reality

If gettxout returns null, it means the money has already been "Spent." This is the primary tool for preventing "Double Spending." When a merchant receives a payment, they can use this command to ensure the money they are being sent actually exists in the "Active Vault." It is the "Verification of Truth" at the point of sale.