polycli_fold-trace.md

polycli fold-trace

Auto-generated documentation.

Table of Contents

• Description
• Usage
• Flags
• See Also

Description

Trace an execution trace and fold it for visualization

polycli fold-trace [flags]

Usage

This command is meant to take a transaction op code trace and convert it into a folded output that can be easily visualized with Flamegraph tools.

# First grab a trace from an RPC that supports the debug namespace
cast rpc --rpc-url http://127.0.0.1:18545 debug_traceTransaction 0x12f63f489213f5bd5b88fbfb12960b8248f61e2062a369ba41d8a3c96bb74d57 > trace.json

# Read the trace and use the `fold-trace` command and write the output
polycli fold-trace --metric actualgas < trace.json > folded-trace.out

# Covert the folded trace into a flame graph
flamegraph.pl --title "Gas Profile for 0x7405fc5e254352350bebcadc1392bd06f158aa88e9fb01733389621a29db5f08" --width 1920 --countname folded-trace.out > flame.svg

Flags

      --file string           Provide a filename to read and hash
  -h, --help                  help for fold-trace
      --metric string         Provide a metric name for analysis: gas, count, actualgas (default "gas")
      --root-context string   The name for the top most initial context (default "root context")

The command also inherits flags from parent commands.

      --config string   config file (default is $HOME/.polygon-cli.yaml)
      --pretty-logs     Should logs be in pretty format or JSON (default true)
  -v, --verbosity int   0 - Silent
                        100 Panic
                        200 Fatal
                        300 Error
                        400 Warning
                        500 Info
                        600 Debug
                        700 Trace (default 500)

See also

• polycli - A Swiss Army knife of blockchain tools.