sentri_analyzer_soroban/
lib.rs1#![deny(unsafe_code)]
2#![allow(missing_docs)]
3
4pub mod analyzer;
8pub mod detectors;
10pub mod semantic_model;
12pub mod soroban_model;
14pub mod soroban_parser;
16
17pub use analyzer::SorobanAnalyzer;
18pub use detectors::*;
19pub use semantic_model::build_semantic_model;
20pub use soroban_model::ContractFunction;
21pub use soroban_parser::parse_contract_functions;
22
23pub fn run_all_detectors(source: &str, file_path: &str) -> Vec<sentri_core::Finding> {
29 let functions = match parse_contract_functions(source) {
30 Ok(functions) => functions,
31 Err(_) => return Vec::new(),
35 };
36
37 let mut findings = detectors::detect_all(&functions, file_path);
38
39 if let Ok(model) = build_semantic_model(source, file_path) {
42 findings.extend(sentri_ir::rules::find_unauthorized_privileged_mutations(
43 &model,
44 ));
45 }
46
47 let mut seen = std::collections::HashSet::new();
48 findings.retain(|f| seen.insert(f.dedup_key()));
49
50 findings.sort_by(|a, b| match b.severity.cmp(&a.severity) {
51 std::cmp::Ordering::Equal => a.line.cmp(&b.line),
52 other => other,
53 });
54
55 findings
56}
57
58#[cfg(test)]
59mod tests {
60 use super::*;
61
62 const VULNERABLE: &str = r#"
63#[contract]
64pub struct VaultContract;
65
66#[contractimpl]
67impl VaultContract {
68 pub fn initialize(env: Env, admin: Address) {
69 env.storage().instance().set(&DataKey::Admin, &admin);
70 }
71
72 pub fn withdraw(env: Env, to: Address, amount: i128) {
73 let balance: i128 = env.storage().persistent().get(&DataKey::Balance(to.clone())).unwrap();
74 let new_balance = balance - amount;
75 env.storage().persistent().set(&DataKey::Balance(to), &new_balance);
76 }
77}
78"#;
79
80 #[test]
81 fn run_all_detectors_includes_shared_and_chain_specific_findings() {
82 let findings = run_all_detectors(VULNERABLE, "vault.rs");
83 let ids: std::collections::HashSet<_> =
84 findings.iter().map(|f| f.invariant_id.as_str()).collect();
85
86 assert!(ids.contains("sor_missing_require_auth"));
87 assert!(ids.contains("sor_reinitialization"));
88 assert!(ids.contains(sentri_ir::rules::UNAUTHORIZED_PRIVILEGED_MUTATION));
89 }
90
91 #[test]
92 fn run_all_detectors_never_panics_on_unparseable_source() {
93 let findings = run_all_detectors("this is not valid rust {{{", "bad.rs");
94 assert!(findings.is_empty());
95 }
96}