debug_getBadBlocks

debug_getBadBlocks reports the invalid blocks that an Avalanche C-Chain node has seen and rejected since it last started. On the C-Chain — the EVM contract chain of Avalanche, where gas is paid in AVAX and the Snowman consensus engine drives fast finality — a "bad block" is one that failed validation against protocol rules and was therefore never applied to the canonical state. Send the request to https://avalanche.therpc.io/YOUR_API_KEY (chain ID 43114, hex 0xa86a). The method returns the running list of these rejected blocks, each with its hash, decoded header, and raw RLP, so you can inspect exactly what the node refused to accept.

Use cases

• Detect consensus violations or malformed C-Chain blocks propagated by misbehaving peers on the Avalanche network.
• Investigate fork events by examining the rejected alternative block that the Snowman engine declined to finalize.
• Audit a client's validation logic by comparing the rejected block's decoded header against the C-Chain protocol rules.

Parameters

Este método não aceita parâmetros. Passe um array vazio [].

Response

Example request

1curl https://avalanche.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "debug_getBadBlocks",
7    "params": [],
8    "id": 1
9  }'

Try it live in the Avalanche playground.

Errors & troubleshooting

Common pitfalls

• The bad-block list lives in memory only and is cleared whenever the Avalanche C-Chain node restarts, so it never reflects history before the current process began.
• A healthy node usually accumulates no bad blocks, so on Avalanche an empty array is the normal, expected response.
• Not every EVM client backing the C-Chain implements this method; some return -32601 Method not found instead of an empty list.

Supported networks

• Mainnet — Chain ID: 43114
• Fuji

See also

• debug_traceBlock
• debug_traceBlockByHash
• debug_traceBlockByNumber

1curl https://avalanche.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"debug_getBadBlocks","params":[]}'