neo-decompiler 0.8.0

Neo N3 NEF decompiler: parse, disassemble, lift bytecode to high-level pseudocode and C# skeletons, with a CLI, JSON reports, and optional WebAssembly bindings.
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117

use super::*;

#[test]
fn contract_name_is_sanitized_with_manifest() {
    let nef_bytes = sample_nef();
    let manifest = ContractManifest::from_json_str(
        r#"
            {
                "name": "  Weird Name! ",
                "abi": {
                    "methods": [
                        { "name": "main", "parameters": [], "returntype": "Void", "offset": 0 }
                    ],
                    "events": []
                },
                "permissions": [],
                "trusts": "*"
            }
            "#,
    )
    .expect("manifest parsed");

    let decompilation = Decompiler::new()
        .decompile_bytes_with_manifest(&nef_bytes, Some(manifest), OutputFormat::All)
        .expect("decompile succeeds");

    assert!(
        decompilation
            .high_level
            .as_deref()
            .expect("high-level output")
            .contains("contract Weird_Name"),
        "contract name should be sanitized"
    );
}

#[test]
fn high_level_sanitizes_manifest_method_and_parameter_names() {
    let nef_bytes = sample_nef();
    let manifest = ContractManifest::from_json_str(
        r#"
            {
                "name": "Sanitized",
                "abi": {
                    "methods": [
                        {
                            "name": "deploy-contract",
                            "parameters": [{ "name": "owner-name", "type": "Hash160" }],
                            "returntype": "Void",
                            "offset": 0
                        }
                    ],
                    "events": []
                },
                "permissions": [],
                "trusts": "*"
            }
            "#,
    )
    .expect("manifest parsed");

    let decompilation = Decompiler::new()
        .decompile_bytes_with_manifest(&nef_bytes, Some(manifest), OutputFormat::All)
        .expect("decompile succeeds");

    assert!(
        decompilation
            .high_level
            .as_deref()
            .expect("high-level output")
            .contains("fn deploy_contract(owner_name: hash160) {"),
        "high-level signature should sanitize identifiers"
    );
}

#[test]
fn sanitize_identifier_handles_edge_cases() {
    assert_eq!(
        sanitize_identifier(" 123 hello-world__"),
        "_123_hello_world"
    );
    assert_eq!(sanitize_identifier("9lives"), "_9lives");
    assert_eq!(sanitize_identifier("!!!"), "param");
}

#[test]
fn high_level_disambiguates_colliding_method_names() {
    let nef_bytes = sample_nef();
    let manifest = ContractManifest::from_json_str(
        r#"
            {
                "name": "Collisions",
                "abi": {
                    "methods": [
                        { "name": "foo-bar", "parameters": [], "returntype": "Void", "offset": 0 },
                        { "name": "foo bar", "parameters": [], "returntype": "Void", "offset": 1 }
                    ],
                    "events": []
                },
                "permissions": [],
                "trusts": "*"
            }
            "#,
    )
    .expect("manifest parsed");

    let decompilation = Decompiler::new()
        .decompile_bytes_with_manifest(&nef_bytes, Some(manifest), OutputFormat::All)
        .expect("decompile succeeds");

    let output = decompilation
        .high_level
        .as_deref()
        .expect("high-level output");
    assert!(output.contains("fn foo_bar("));
    assert!(output.contains("fn foo_bar_1("));
}