engine-model 0.1.1

Shared data models for the Stylus Debug Suite execution engine.
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

use serde::{Deserialize, Serialize};

/// Core execution event emitted by the Stylus debug engine.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ExecutionEvent {
    pub step: u64,
    pub opcode: String,
    /// Gas consumed by this individual operation.
    pub gas_used: u64,
    pub stack: Vec<Value>,
    pub memory: MemorySnapshot,
    pub storage_diff: Vec<StorageChange>,
    pub source_line: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Value {
    pub hex: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MemorySnapshot {
    pub bytes: Vec<u8>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct StorageChange {
    pub key: String,
    pub old: Option<String>,
    pub new: Option<String>,
}

/// High‑level debug session configuration.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DebugConfig {
    pub contract_path: String,
    pub entrypoint: String,
    /// Optional breakpoints expressed as "file:line" or symbolic form.
    pub breakpoints: Vec<String>,
}