Module soldb 

soldb frontend.

Converts a recorded call trace into a soldb transaction trace and the local artifacts’ source maps into soldb debug info, then runs a soldb session over them or writes them as a bundle that soldb’s own tools read.

Re-exports

use alloy_primitives::Address; 🔒

use alloy_primitives::B256; 🔒

use alloy_primitives::Bytes; 🔒

use alloy_primitives::hex; 🔒

use alloy_primitives::hex; 🔒

use alloy_primitives::keccak256; 🔒

use alloy_primitives::map::HashSet; 🔒

use eyre::OptionExt; 🔒

use eyre::Result; 🔒

use foundry_common::ContractsByArtifact; 🔒

use foundry_common::Shell; 🔒

use foundry_common::fs; 🔒

use foundry_common::fs::write_json_file; 🔒

use foundry_compilers::artifacts::sourcemap::Jump; 🔒

use foundry_compilers::artifacts::sourcemap::SourceElement; 🔒

use foundry_compilers::artifacts::sourcemap::SourceMap; 🔒

use foundry_compilers::multi::MultiCompilerLanguage; 🔒

use foundry_evm_core::Breakpoints; 🔒

use foundry_evm_core::ic::PcIcMap; 🔒

use foundry_evm_traces::CallTrace; 🔒

use foundry_evm_traces::CallTraceArena; 🔒

use foundry_evm_traces::CallTraceNode; 🔒

use foundry_evm_traces::CallTraceStep; 🔒

use foundry_evm_traces::TraceMemberOrder; 🔒

use foundry_evm_traces::debug::ArtifactData; 🔒

use foundry_evm_traces::debug::ContractSources; 🔒

use foundry_evm_traces::debug::DebugRecording; 🔒

use foundry_evm_traces::debug::RecordedFrame; 🔒

use foundry_evm_traces::debug::SourceData; 🔒

use foundry_evm_traces::debug::StepConverter; 🔒

use foundry_evm_traces::debug::quantity; 🔒

use revm::bytecode::opcode::OpCode; 🔒

use revm::interpreter::InstructionResult; 🔒

use serde_json::Map; 🔒

use serde_json::Value; 🔒

use serde_json::json; 🔒

use soldb_core::ContractCreation; 🔒

use soldb_core::EvmWord; 🔒

use soldb_core::ExecutionCall; 🔒

use soldb_core::StepRecord; 🔒

use soldb_core::StepTable; 🔒

use soldb_core::TraceArtifacts; 🔒

use soldb_core::TraceCapabilities; 🔒

use soldb_core::TransactionTrace; 🔒

use soldb_debugger::CodeGenerator; 🔒

use soldb_debugger::ContractDebugInfo; 🔒

use soldb_debugger::SourceCache; 🔒

use soldb_debugger::StorageLayout; 🔒

use soldb_ethdebug::EthdebugInfo; 🔒

use soldb_ethdebug::Instruction; 🔒

use soldb_ethdebug::SourceLocation; 🔒

use soldb_ethdebug::SourceMapContext; 🔒

use soldb_ethdebug::SourceMapJump; 🔒

use soldb_repl::BreakpointTarget; 🔒

use soldb_repl::DebuggerCommand; 🔒

use soldb_repl::DebuggerState; 🔒

use soldb_repl::Output; 🔒

use soldb_repl::Renderer; 🔒

use soldb_repl::Session; 🔒

use soldb_tui::Exit; 🔒

use std::borrow::Cow; 🔒

use std::collections::BTreeMap; 🔒

use std::collections::BTreeSet; 🔒

use std::collections::HashMap; 🔒

use std::io; 🔒

use std::io::IsTerminal; 🔒

use std::io::Write; 🔒

use std::ops::Range; 🔒

use std::path::Component; 🔒

use std::path::Path; 🔒

use std::path::PathBuf; 🔒

use std::sync::Arc; 🔒

Structs

CombinedJson 🔒

One contract of a bundle’s combined.json.

ExecutedProgram 🔒

A program the trace executes and the local artifact that describes it.

SoldbDebugger 🔒

A soldb session over the recorded call traces.

TraceBuilder 🔒

Collects the soldb steps, calls, and creations of a trace in execution order.

Enums

Flow 🔒

What the session asks the frontend to do after a command.

Functions

contract_debug_info 🔒

Adapts the source map of program to its instructions, in the ETHDebug shape soldb reads.

emit 🔒

Prints the session’s answers.

executed_programs 🔒

The programs arenas run that local artifacts describe, once per address and environment.

instruction_context 🔒

The ETHDebug context of one source map element: its source range, if the build has the source, and the invoke or return marker of a jump into or out of a function.

open_tui 🔒

Opens the full-screen view until the user leaves it.

recorded_steps 🔒

The step table that holds the steps of recordings, and where each recording’s steps start in it.

status_error 🔒

The error a failed step or call ended with.

transaction_trace 🔒

Converts arenas into a soldb trace: their steps in execution order, with each call and creation recorded at the steps it spans.

write_bundle 🔒

Writes a bundle that soldb’s own tools read, for example soldb profile --trace-file <dir>/trace.json --contracts <dir>/contracts.json.

Type Aliases

BreakpointFrames 🔒

The frames that run a breakpoint location, as the steps they span and their depth.

BreakpointSteps 🔒

The frames that run each breakpoint’s code address and program counter.