Verifica una TXID con tu nodo Bitcoin: mempool, bloque y salida

Verifica una TXID desde tu Bitcoin Core: distingue mempool, transacciones confirmadas y salidas UTXO, con las limitaciones del txindex y la poda.

🐥 Tutorial · Verificación con nodo

Verifica una TXID con tu nodo Bitcoin: mempool, bloque y salida

Un explorador puede darte la TXID y un estado, pero también puedes comprobar desde tu propio Bitcoin Core qué conoce su mempool, si una transacción está en un bloque y si una salida sigue sin gastarse. Aprende a interpretar también las respuestas que no aparecen.

⏱ 20–35 min🌱 Intermedio🧪 Solo consultas locales
ANTES DEL COMANDO

Qué pregunta responde cada herramienta

getmempoolentry busca una transacción en la mempool de ese nodo. Si falla, puede haberse confirmado, haber sido reemplazada, haber sido expulsada o simplemente no haberse recibido. No concluyas que el emisor nunca la difundió.

getrawtransaction permite obtener datos de transacciones cuando están en la mempool o cuando tu nodo dispone del índice/bloque necesario. En un nodo sin txindex, consultar una confirmada por TXID sola puede fallar; cuando conoces su hash de bloque, el argumento correspondiente puede permitir localizarla si el bloque permanece almacenado.

gettxout examina una salida concreta identificada por TXID y posición (vout) dentro del conjunto UTXO; que no aparezca puede significar que está gastada o que no es visible en el estado consultado. No devuelve una prueba universal de «esa dirección nunca recibió dinero».

REQUISITOS

Necesitas una TXID pública conocida y un nodo listo

Utiliza una TXID de laboratorio o de una operación propia que ya hayas decidido analizar. No necesitas palabras de recuperación, xpub ni claves. El nodo debe estar conectado y razonablemente sincronizado; si todavía está en descarga inicial, comienza por el diagnóstico general de transacciones pendientes y revisa primero el estado del nodo.

Accede a bitcoin-cli localmente en el entorno administrativo de Bitcoin Core. Ejecutar comandos en una shell de un servicio gestionado puede requerir herramientas distintas; si no tienes acceso autorizado, no publiques el RPC para resolverlo.

Antes de interpretar resultados, confirma que el nodo está al día con la práctica de sincronización de Bitcoin Core.

RECORRIDO EN SEIS PASOS

Desde una TXID hasta la evidencia verificable

  1. PASO 1 · Red correcta: ejecuta bitcoin-cli getblockchaininfo y comprueba chain, blocks e IBD. Una TXID de signet no se verificará como si fuera una operación mainnet.
  2. PASO 2 · Mempool: prueba bitcoin-cli getmempoolentry TU_TXID. Si devuelve datos, tu nodo la conoce como pendiente; observa comisión y tamaño que informa, sin atribuirle confirmaciones.
  3. PASO 3 · Datos de transacción: prueba bitcoin-cli getrawtransaction TU_TXID true. Si la operación está accesible, revisa vin, vout, importes y, para una confirmada, los campos de bloque y confirmación disponibles.
  4. PASO 4 · Si falla: no cambies configuración inmediatamente. Comprueba si la TXID podría estar confirmada y si dispones de su hash de bloque. En un nodo que retiene ese bloque, consulta bitcoin-cli getrawtransaction TU_TXID true HASH_DEL_BLOQUE.
  5. PASO 5 · Salida concreta: identifica la posición n de la salida relevante y ejecuta bitcoin-cli gettxout TU_TXID n cuando tenga sentido verificar si pertenece al conjunto UTXO. Por defecto tiene en cuenta la mempool: si esa salida ya se está gastando en una transacción pendiente, no aparecerá aunque siga sin gastar en la cadena. El resultado no demuestra identidad del propietario.
  6. PASO 6 · Comparación: anota estado observado, fuente y hora. Si comparas con un explorador público, recuerda que su mempool puede diferir de la tuya por políticas, propagación y tiempo.

Los comandos se muestran como ejemplos: sustituye TU_TXID, HASH_DEL_BLOQUE y n por valores públicos reales. No ejecutes la secuencia dentro de un servicio web que te pida credenciales RPC.

TRES PREGUNTAS, TRES RESULTADOS

Qué puedes afirmar sin pasarte

MEMPOOL

Mi nodo la acepta

Es una señal local de que tu nodo la tiene pendiente. No obliga a otros nodos a conservarla ni confirma que vaya a incluirse pronto.

BLOQUE

Figura confirmada

Cuando la transacción pertenece a la cadena activa validada por tu nodo, puedes evaluar su profundidad de confirmación y salidas.

SALIDA

UTXO no gastado

El resultado de una consulta de salida se interpreta respecto al conjunto UTXO y al estado local; no revela quién controla las claves.

Una transacción puede tener salidas para varios receptores y otra de cambio del emisor. Inspecciona la salida exacta antes de afirmar que la wallet receptora debería mostrar determinada cantidad.

POR QUÉ CAMBIAN LOS RESULTADOS

Índice de transacciones, poda y bloque conocido

Un nodo Bitcoin Core ordinario no tiene por qué tener txindex=1. Ese índice permite buscar transacciones confirmadas históricas por TXID sin indicar bloque; necesita almacenamiento y tiempo para construirse. No lo habilites impulsivamente solo para pasar un ejemplo.

Si tu nodo utiliza pruning, puede haber eliminado archivos de bloques antiguos después de validarlos. Un hash de bloque conocido no recuperará mágicamente esos datos. En algunos casos necesitarías otro nodo que conserve el historial o revisar estrategias documentadas de reindexación/descarga, con costes reales.

Una wallet Bitcoin Core también ofrece métodos de consulta como gettransaction que requieren que la transacción sea relevante para esa wallet cargada. No equivale a una consulta general de transacciones ajenas. Distinguir el ámbito de cada RPC evita confundir errores con fondos perdidos.

EJEMPLO DE LECTURA

Dos salidas en la misma transacción

Imagina una transacción ficticia con una salida vout=0 de 60.000 sats a un destinatario y vout=1 de 39.500 sats de cambio al emisor, además de 500 sats de comisión. Las cantidades son inventadas; tu nodo mostrará la estructura de la transacción real que consultes.

El ejemplo demuestra por qué una TXID identifica una transacción, pero un outpoint necesita también la posición de salida: TXID + índice. Si la primera salida queda gastada posteriormente, eso no implica que la segunda desaparezca. Un explorador que muestre todas las salidas sin distinguir cambio puede inducir a confundir el importe que recibió una persona.

Practica la lectura visual en Cómo leer una transacción en mempool.space y después contrasta con tu nodo.

CÓMO NO INTERPRETAR UN ERROR

Cuatro diagnósticos separados

🐥 ¿getmempoolentry dice que no existe?

Solo sabes que el nodo no la encuentra en su mempool. Puede estar confirmada, reemplazada, no propagada o descartada. Busca evidencia adicional antes de concluir.

🐥 ¿getrawtransaction falla aunque el explorador dice confirmada?

Podrías carecer de txindex o no haber proporcionado el bloque correcto. Si está podado, quizá no conserves el bloque antiguo. No es necesariamente un desacuerdo de consenso.

🐥 ¿gettxout no devuelve el UTXO esperado?

Consulta el índice correcto, estado de sincronización y si la salida ya fue gastada. La ausencia no demuestra que nunca existió ni que una cartera perdió claves.

🐥 ¿Puedo comprobar una TXID de Lightning aquí?

Los pagos Lightning normales no crean una TXID on-chain por cada operación. Necesitas consultar el estado del pago o de la invoice en tu implementación Lightning, no buscar su hash de pago como transacción de Bitcoin.

RESULTADO COMPROBABLE

¿Qué has demostrado realmente con tu nodo?

  1. Red: sé en qué cadena trabaja mi Bitcoin Core.
  2. Mempool: entiendo la diferencia entre «la conozco» y «está confirmada».
  3. Bloque: reconozco cuándo necesito un hash de bloque o un índice.
  4. Salida: sé usar TXID + vout para hablar de un UTXO concreto.
  5. Privacidad: he evitado entregar claves a un explorador o exponer RPC.
HAS COMPROBADO

Verificar significa formular la pregunta correcta

Conoces los límites de los RPC de consulta y puedes comparar las evidencias de tu nodo con las de un servicio externo sin convertir un error de índice en una conclusión sobre tus fondos.

FUENTES OFICIALES Y SIGUIENTE PASO

No confíes. Comprueba.

Después de verificar una TXID, tendrás una base concreta para interpretar confirmaciones, cambio y disponibilidad de una salida. Siguiente práctica: descarga Bitcoin Core y comprueba sus firmas y su SHA-256.

Pajarito explica cómo verificar una TXID, un bloque y una salida UTXO desde Bitcoin Core.