debug

APIs used to inspect and debug node state and blockchain data at run time.

The namespace debug gives you access to several non-standard RPC methods, which will allow you to inspect, debug and set certain debugging flags at run time.

NOTE Some debug namespace APIs are unsafe/unappropriate to be opened to public. We recommend you to provide the debug namespace APIs to authorized users only. However, if you want to maintain a public EN and provide debug namespace APIs to the public, we strongly recommend you to set the rpc.unsafe-debug.disable flag which will disable APIs that are unsafe/unappropriate to be opened to the public and enable only a subset of the debug namespace APIs. The enabled APIs are as follows:

• VM Tracing APIs, however with limited functionality (only pre-defined tracers are allowed)

• debug_dumpBlock, debug_dumpStateTrie, debug_getBlockRlp, debug_getModifiedAccountsByHash, debug_getModifiedAccountsByNumber, debug_getBadBlocks, debug_getModifiedStorageNodesByNumber

• debug_metrics

Logging

• debug_backtraceAt

• debug_setVMLogTarget

• debug_verbosity

• debug_verbosityByName

• debug_verbosityByID

• debug_vmodule

Profiling

• debug_blockProfile

• debug_cpuProfile

• debug_mutexProfile

• debug_isPProfRunning

• debug_setBlockProfileRate

• debug_startCPUProfile

• debug_stopCPUProfile

• debug_startPProf

• debug_stopPProf

• debug_writeBlockProfile

• debug_writeMemProfile

• debug_writeMutexProfile

Runtime Tracing

• debug_goTrace

• debug_startGoTrace

• debug_stopGoTrace

Runtime Debugging

• debug_freeOSMemory

• debug_gcStats

• debug_memStats

• debug_metrics

• debug_setGCPercent

• debug_stacks

VM Tracing

• debug_traceBadBlock

• debug_traceBlock

• debug_traceBlockByHash

• debug_traceBlockByNumber

• debug_traceBlockByNumberRange

• debug_traceBlockFromFile

• debug_traceTransaction

• debug_traceCall

• debug_traceChain

• Tracing Options

• JavaScript-based Tracing

VM Standard Tracing

• debug_standardTraceBadBlockToFile

• debug_standardTraceBlockToFile

• Standard Tracing Options

Blockchain Inspection

• debug_dumpBlock

• debug_dumpStateTrie

• debug_getBlockRlp

• debug_getModifiedAccountsByHash

• debug_getModifiedAccountsByNumber

• debug_getBadBlocks

• debug_preimage

• debug_printBlock

• debug_setHead

• debug_seedHash

• debug_startWarmUp

• debug_startContractWarmUp

• debug_stopWarmUp

• debug_startCollectingTrieStats