O que é um hash da transação (TXID) e como consultar um?

1. O que é um hash da transação?

Uma transação de blockchain é um pequeno bloco de dados: quem paga, quem recebe, quanto, qual taxa e uma assinatura. Passe esses dados pela função de hash da rede e o resultado é um número de tamanho fixo. Esse número é o hash da transação. Qualquer mudança nos dados produz um número diferente, então o hash funciona como uma impressão digital: ele identifica exatamente uma transação e nenhuma outra.

Nós, carteiras e explorers usam o hash como chave de consulta. Quando você transmite uma transação, o nó que a aceita devolve o hash. Quando sua carteira mostra "pendente", ela está consultando a rede por esse hash. Quando uma exchange pede prova de um depósito, é o hash que ela verifica. É a única referência de que você precisa para acompanhar um pagamento da transmissão até a confirmação.

O hash em si não prova nada. Ele é uma chave de consulta, e a prova é o que o explorer mostra quando você o abre.

2. Hash da transação é o mesmo que ID da transação?

Sim. Hash da transação, ID da transação, TXID, tx hash, txn hash e hash ID se referem todos à mesma string. O vocabulário depende de onde você está: o software do Bitcoin diz txid, as ferramentas do Ethereum dizem transaction hash ou txn hash, e as exchanges costumam dizer TXID ou hash ID nas telas de saque. A Solana é o único lugar em que o termo difere de fato. O ID da transação ali é a primeira assinatura da transação, e não um hash da transação inteira, por isso a documentação diz "signature" (assinatura).

Duas coisas costumam ser confundidas com ele e não são a mesma coisa. Um endereço de carteira identifica uma conta, não um pagamento (no Bitcoin ele começa com 1, 3 ou bc1). Um hash de bloco identifica um bloco inteiro, com muitas transações. Se uma exchange rejeitar a string que você colou, confira se não copiou um desses.

3. Como é um hash da transação?

O formato depende da rede, e normalmente basta para saber a que rede um hash pertence:

O exemplo do Bitcoin é a primeira transação já registrada, a coinbase do bloco gênese minerado em 3 de janeiro de 2009; você pode abri-la no mempool.space. O exemplo do Ethereum é o usado na documentação para desenvolvedores do ethereum.org. Os dois são 32 bytes escritos em hexadecimal, e por isso têm 64 caracteres; o prefixo 0x é a convenção do Ethereum para "isto é hexadecimal". Litecoin, Dogecoin e Bitcoin Cash herdam o formato do Bitcoin, e toda rede EVM herda o do Ethereum, então uma transação na Polygon ou na Base é exatamente igual a uma na mainnet do Ethereum.

O ID de uma transação na Solana é a assinatura da transação: 64 bytes de assinatura Ed25519 codificados em base58 em vez de hexadecimal, e por isso é mais longo e contém letras maiúsculas e minúsculas. Os hashes do XRP Ledger são os mesmos 256 bits do Bitcoin, escritos em maiúsculas por convenção.

4. Como o hash da transação é gerado?

Cada rede aplica o hash à sua própria serialização da transação assinada, e as diferenças explicam algumas coisas com que você vai esbarrar.

Bitcoin, Litecoin, Dogecoin, Bitcoin Cash

O txid é o SHA-256 duplo da transação na serialização tradicional, que deixa de fora os dados de witness (assinatura) das entradas SegWit; o witness é coberto por um segundo identificador, o wtxid. É assim que o BIP 141 o define, e é por isso que uma transação que gasta apenas saídas SegWit não pode ter o txid alterado por terceiros antes da confirmação.

Ethereum e redes EVM

O hash é o Keccak-256 da transação assinada e serializada, então ele só existe depois que a transação é assinada: bibliotecas como o ethers devolvem null para o hash de uma transação não assinada. O nó devolve o hash de 32 bytes como resultado de eth_sendRawTransaction, e é esse mesmo valor que você passa para eth_getTransactionByHash e eth_getTransactionReceipt.

Solana

Não há um hash separado. A primeira assinatura Ed25519 da transação, 64 bytes mostrados como uma string base58, é usada como ID.

XRP Ledger

Um hash SHA-512Half (os primeiros 256 bits de um SHA-512) da forma binária da transação assinada, com os bytes TXN como prefixo antes do hash, escrito como 64 caracteres hexadecimais em maiúsculas.

As definições estão no BIP 141, na especificação JSON-RPC do Ethereum, na página de terminologia da Solana e na referência de tipos de dados do XRP Ledger.

O que todas têm em comum: o hash é calculado por quem assina a transação, antes de ela chegar à rede. Sua carteira sabe o hash no instante em que você toca em enviar, e é por isso que consegue mostrá-lo enquanto a transação ainda não foi confirmada.

5. Onde encontro o hash da minha transação?

Depende de quem enviou a transação.

Carteira de autocustódia (MetaMask, Ledger, Trust Wallet, Phantom, Electrum)

Abra a transação na lista de atividade ou histórico da carteira. A tela de detalhes mostra o hash, normalmente com um botão de copiar e um link "ver no explorer" que o abre para você.

Saque de exchange

Vá ao histórico de saques. Depois que a exchange transmite a transação, a linha mostra um TXID, muitas vezes como link. Se a linha ainda diz "processando", o hash ainda não existe, porque nada foi assinado.

Alguém pagou você

Peça o hash à pessoa, ou abra seu endereço de recebimento em um block explorer: toda transação que passou pelo endereço aparece listada com seu hash.

Seu próprio código

A chamada de transmissão o devolve. Com o SDK da ChainGate ele é o campo transactionId no resultado de signAndBroadcast(), tanto no Bitcoin quanto no Ethereum (veja a seção 10).

Copie a string inteira. As exchanges rejeitam hashes com um caractere faltando ou um espaço a mais, e um txid do Bitcoin colado em um explorer do Ethereum simplesmente não será encontrado.

6. Como consultar uma transação pelo hash?

Cole o hash em um block explorer da rede em que a transação foi enviada. O explorer mostra se a transação está pendente ou confirmada, quantas confirmações tem, o bloco que a incluiu, o remetente e o destinatário, o valor, a taxa paga e, no Ethereum, se a execução teve sucesso ou falhou.

Leia o status primeiro. "Pending" ou "unconfirmed" significa que a rede tem a transação, mas nenhum bloco a incluiu ainda. "Success" com uma ou mais confirmações significa que o dinheiro foi transferido. "Fail" ou "dropped" significa que não foi, e no Ethereum a taxa foi paga mesmo assim. Para saber o que significa cada campo da página de uma transação no Ethereum, leia o guia do Etherscan.

7. Por que não encontro minha transação no explorer?

Uma página de "transação não encontrada" é quase sempre um destes casos:

Rede errada

O hash é de uma rede diferente da do explorer. Um saque de USDT pode viajar por Ethereum, Tron, BNB Smart Chain ou Polygon, e cada uma tem seu próprio explorer. Use o explorer da rede que você escolheu no saque.

Cedo demais

Uma transação leva alguns segundos para se propagar, e a exchange pode mostrar o TXID um instante antes de os explorers o indexarem. Espere um minuto e atualize a página.

Nunca foi para a blockchain

Transferências entre duas contas da mesma exchange, e pagamentos com cartão ou transferência bancária, são registrados no banco de dados da empresa, não em uma blockchain, então não há hash para encontrar. Só envios on-chain recebem um.

Foi substituída

Se a transação foi acelerada, cancelada ou teve a taxa aumentada com replace-by-fee, a substituta tem um hash novo e a rede descarta a antiga. A próxima seção explica por quê.

Expirou

Uma transação de Bitcoin com taxa baixa demais é removida da mempool dos nós depois de cerca de duas semanas. As moedas voltam a ficar disponíveis e o txid antigo não se refere a nada.

O guia de taxas do Bitcoin explica como escolher uma taxa que confirma e o que fazer quando uma transação fica travada.

8. O hash de uma transação pode mudar?

O hash de uma transação confirmada nunca muda: ele faz parte do bloco, e alterá-lo alteraria o bloco. Antes da confirmação, o hash pode ser superado por outra transação, o que, visto de fora, parece uma mudança.

No Ethereum e nas outras redes EVM, acelerar ou cancelar uma transação pendente significa assinar uma transação nova com o mesmo nonce e uma taxa maior, como descreve a página de ajuda da MetaMask. A rede fica com a que for minerada e descarta a outra. A transação nova tem um hash novo, então o que sua carteira mostrou primeiro vira um link morto. O mesmo vale para o replace-by-fee do Bitcoin (BIP 125): a substituta é uma transação diferente, com um txid diferente.

As transações antigas do Bitcoin tinham mais um problema, a maleabilidade de transações: um terceiro podia ajustar a codificação da assinatura de uma transação não confirmada e dar a ela um txid diferente sem mudar para onde o dinheiro ia. O Segregated Witness (BIP 141, ativo desde 2017) tirou as assinaturas dos dados que o txid cobre, o que eliminou o problema para transações que gastam saídas SegWit. Se sua carteira usa endereços que começam com bc1, isso não afeta você.

9. É seguro compartilhar o hash da transação?

Sim. O hash não contém chaves, senhas nem nada que permita a alguém mover seus fundos. Quem o tiver pode ver o que o explorer mostra: os endereços envolvidos, o valor e a hora. Essa informação já é pública, porque a blockchain é pública; o hash só facilita encontrá-la.

O único ponto de privacidade: dar a alguém o hash de um pagamento revela qual endereço é seu, e a partir dele todas as outras transações desse endereço. Se isso importa, use um endereço de recebimento novo para cada pagamento, o que a maioria das carteiras de Bitcoin faz por padrão.

10. Como obter o hash em código

Se o seu aplicativo envia transações, guarde o hash que a chamada de transmissão devolve: ele é a chave para verificações de status, tickets de suporte e conciliação. Com o SDK da ChainGate as mesmas linhas funcionam em Bitcoin, Litecoin, Dogecoin, Bitcoin Cash e em qualquer rede EVM:

import { ChainGate, importWallet } from 'chaingate';

const cg = new ChainGate({ apiKey: process.env.CHAINGATE_API_KEY });
const wallet = importWallet({ phrase: process.env.MNEMONIC });
const eth = cg.connect(cg.networks.ethereum, wallet);

const tx = await eth.transfer(cg.networks.ethereum.amount('0.01'), '0x...');
tx.setFee(tx.recommendedFees().normal);

const sent = await tx.signAndBroadcast();
console.log(sent.transactionId); // 0x... on EVM chains, 64 hex chars on Bitcoin

sent.onConfirmed((details) => {
  console.log('mined in block', details.blockHeight, details.transactionId);
});

O tutorial para enviar cripto em JavaScript cobre carteiras, taxas e tratamento de erros, e a documentação de transferências lista todos os campos do resultado da transmissão, incluindo o callback onConfirmed() usado acima.

11. Por onde continuar

Agora você consegue ler um hash do jeito que um explorer lê: qual rede, qual transação e se ela é final. Para entender a linha da taxa nessa página do explorer, leia o que são gas fees no Ethereum e como funcionam as taxas do Bitcoin, e para ver quanto custa enviar agora em cada rede, abra o gas tracker. Se quiser que a transmissão, os callbacks de confirmação e os IDs de transação sejam resolvidos em Bitcoin e nas redes EVM a partir de uma única biblioteca TypeScript, a ChainGate faz isso.

Perguntas frequentes