[debug] integrate soldb into foundry
Author: djolertrkCreated Sep 2, 2026Updated Sep 3, 2026
Foundry's built-in debugger is an opcode-level stepper; source-level breakpoints remain a pain point (#5765, #5510). soldb is an ETHDebug-first, LLDB-style Solidity debugger (REPL with break/step/print, DAP server, tx trace/simulate, per-line gas profiling) that falls back to legacy source maps, if there is no ETHDebug generated.
Some potential ways to do it:
forge test --debug / forge debughand execution tosoldb, either by linkingsoldb-debugger/soldb-repl(preferred:forge testsrun inrevmorevm2in-process, sosoldbcan consume forge's step traces directly), or by shelling out to the CLI for on-chain txs (cast run)- forge emits ETHDebug/legacy-source-mappings artifacts and auto-builds the
address:Contract:dirmappings from its traces - later:
soldb-dapfor IDE attach
Of course part of the problem is in compiler, so both solar and solc will need to generate proper debug info, so consumers such as soldb can consume it right.
The repo: https://github.com/walnuthq/soldb
Source: foundry-rs/foundry