forge-guard 0.3.6

Pre-deployment smart contract auditing framework for Foundry
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

use thiserror::Error;

/// Unified error type for all forge-guard operations.
#[derive(Error, Debug)]
pub enum ForgeGuardError {
    // ── I/O & Filesystem ──────────────────────────────────────────
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

    #[error("File not found: {0}")]
    FileNotFound(String),

    #[error("Invalid path: {0}")]
    InvalidPath(String),

    // ── Parsing ──────────────────────────────────────────────────
    #[error("Parse error: {0}")]
    Parse(String),

    #[error("TOML parse error: {0}")]
    Toml(#[from] toml::de::Error),

    #[error("JSON parse error: {0}")]
    Json(#[from] serde_json::Error),

    #[error("Regex error: {0}")]
    Regex(#[from] regex::Error),

    // ── Security ─────────────────────────────────────────────────
    #[error("Security check failed: {0}")]
    SecurityCheck(String),

    #[error("Critical vulnerability found: {0}")]
    CriticalVulnerability(String),

    #[error("Deployment blocked: {0}")]
    DeploymentBlocked(String),

    // ── Analysis ─────────────────────────────────────────────────
    #[error("Analysis error: {0}")]
    Analysis(String),

    #[error("AST parsing error: {0}")]
    AstParse(String),

    #[error("Bytecode analysis error: {0}")]
    BytecodeAnalysis(String),

    // ── Chain ────────────────────────────────────────────────────
    #[error("Unsupported chain: {0}")]
    UnsupportedChain(String),

    #[error("RPC error: {0}")]
    Rpc(String),

    // ── Plugin ───────────────────────────────────────────────────
    #[error("Plugin error: {0}")]
    Plugin(String),

    #[error("Plugin not found: {0}")]
    PluginNotFound(String),

    #[error("Plugin load error: {0}")]
    PluginLoad(String),

    // ── Configuration ────────────────────────────────────────────
    #[error("Configuration error: {0}")]
    Config(String),

    #[error("Environment error: {0}")]
    Env(String),

    // ── Cache ────────────────────────────────────────────────────
    #[error("Cache error: {0}")]
    Cache(String),

    // ── History ──────────────────────────────────────────────────
    #[error("SQLite error: {0}")]
    Sqlite(#[from] rusqlite::Error),

    // ── Execution ────────────────────────────────────────────────
    #[error("Command execution error: {0}")]
    Command(String),

    #[error("Subprocess error: {0}")]
    Subprocess(String),

    #[error("Timeout: {0}")]
    Timeout(String),

    // ── Internal ─────────────────────────────────────────────────
    #[error("Internal error: {0}")]
    Internal(String),

    #[error("Not implemented: {0}")]
    NotImplemented(String),

    #[error("{0}")]
    Anyhow(#[from] anyhow::Error),
}

/// Convenience alias.
pub type Result<T> = std::result::Result<T, ForgeGuardError>;