Skip to main content
Use thru-cli debug when the task is diagnosis rather than normal transaction submission.

Commands

CommandUse it for
re-execute <signature>Re-run a transaction in a simulated environment.
resolve —elf <elf> (—response <file> or —signature <sig>)Resolve DWARF debug info into a source-level report.

High-Signal Flags

FlagApplies toWhy it matters
--include-state-beforere-executeInclude account state snapshots before execution.
--include-state-afterre-executeInclude account state snapshots after execution.
--include-account-datare-executeInclude full account data in snapshots.
—output-trace <FILE>re-executeSave VM execution trace to a file.
--include-memory-dumpre-executeInclude stack and heap dump data.
—elf <PATH>resolvePoint to a program ELF with DWARF info.
--response / --signatureresolveChoose either a saved response or a live signature lookup.

Minimal Patterns

thru-cli debug re-execute ts...[signature] --include-state-after
thru-cli debug resolve --elf ./build/thruvm/bin/my_program_c.elf --signature ts...[signature]

Notes

  • Use resolve only when you have a debug-built ELF with DWARF info available.
  • This family is the right place to go after a failing transaction when plain CLI errors are not enough.