fix: adding missing file

Author: praetoriansentry

doc/polycli_fold-trace.md

@@ -0,0 +1,60 @@
+# `polycli fold-trace`
+
+> Auto-generated documentation.
+
+## Table of Contents
+
+- [Description](#description)
+- [Usage](#usage)
+- [Flags](#flags)
+- [See Also](#see-also)
+
+## Description
+
+Trace an execution trace and fold it for visualization
+
+```bash
+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.
+
+```bash
+# 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
+
+```bash
+      --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.
+
+```bash
+      --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](polycli.md) - A Swiss Army knife of blockchain tools.