Playbooks

Why is a transaction not being included in blocks?

Problems with the transaction

• Nonce is not correct (there is a missing nonce from the account, so transactions with later nonces cannot be processed
• Transaction is problematic
  • Trying to deploy a contract with the same name as an existing contract
• Fee is not competitive (the mempool is full and the fee-rate for this transaction is low, so it is not being prioritized by the miners)

Problems with the network

• Transaction has not propagated to the miners
  • Check with publicly available nodes if they have the transaction in their mempools:

    curl -s http://1.2.3.4:20443/v2/transactions/unconfirmed/:txid
    

• Review logs from miners to check if the transaction is attempted while mining a block
  • Check txid or tx_id fields for the transaction's ID (without 0x prefix)
  • Look for debug log "Consider mempool transaction"
  • Look for info log "Tx processing skipped"
  • Look for info log "Tx processing problematic"
  • Look for info log "Tx successfully processed."