soldb-ethdebug 0.4.4

ETHDebug artifact loading, legacy source-map parsing, and ABI/event decoding for SolDB
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

//! Loading and interpreting compiler-generated Solidity debug information.
//!
//! This is the metadata half of an ETHDebug-first debugger: it turns `solc` artifacts
//! into the program-counter, source-location, variable, and ABI lookups the rest of the
//! workspace needs. Nothing here touches the network.
//!
//! - [`metadata`] models ETHDebug artifacts: instructions, their source spans, live
//!   variable locations, and the `address:name:dir` contract specs used on the command
//!   line.
//! - [`source_map`] reads the legacy `srcmap` format for compiler and tooling
//!   interoperability when ETHDebug programs are unavailable, naming its instructions
//!   through [`opcodes`].
//! - [`abi`] encodes calldata and parses function signatures, including tuples and
//!   arrays, and carries the keccak-256 implementation used to derive selectors.
//! - [`events`] decodes logs against event ABIs.
//!
//! Everything decoded here comes from files or from chain data, so it is untrusted:
//! offsets and lengths read out of an artifact or a log payload are validated rather
//! than trusted to be in range.

pub mod abi;
pub mod artifacts;
pub mod events;
pub mod metadata;
pub mod opcodes;
pub mod source_map;
pub mod storage_layout;

pub use abi::{
    canonical_abi_input_type, encode_abi_arguments, encode_function_call, function_selector,
    keccak256, match_abi_types, match_single_type, parse_signature, parse_tuple_arg, AbiInput,
    FunctionSignature,
};
pub use artifacts::{
    contract_name_from_program_path, ethdebug_resources_from_metadata, find_ethdebug_metadata,
    find_program_ethdebug, load_contract_mapping, load_debug_program,
    load_debug_program_with_sources, load_storage_layout, load_transient_storage_layout,
    parse_contract_mapping, read_debug_source, read_json_file, source_candidates, CodeGenerator,
    ContractMapping, DebugProgram,
};
pub use events::{
    event_signature, event_topic, parse_event_abis, DecodedEvent, DecodedEventArg, EventAbi,
    EventParam, EventRegistry, EventRegistryEntry,
};
pub use metadata::{
    parse_compilation_sources, parse_ethdebug_spec, parse_multi_contract_spec,
    parse_single_contract_spec, parse_variable_locations, read_compilation_source, source_range,
    EthdebugInfo, EthdebugSpec, FunctionExit, FunctionIdentity, Instruction, SourceLocation,
    SourceMapContext, SourceMapJump, VariableLocation,
};
pub use source_map::{
    build_pc_to_instruction_map, is_legacy_compiler, load_source_map_program,
    load_source_map_program_with_sources, parse_srcmap, SourceMapEntry, SourceMapEnvironment,
    SourceMapInfo, SourceMapProgram,
};
pub use storage_layout::{
    add_word, decode_value, element_place, mapping_slot, parse_path, parse_word, word_hex,
    word_to_decimal, DecodedStorage, PathSegment, StorageEncoding, StorageLayout, StorageMember,
    StorageRef, StorageType, StorageVariable, Word,
};