neo-decompiler 0.7.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

use std::io::Write as _;
use std::path::PathBuf;

use crate::decompiler::Decompiler;
use crate::error::Result;
use crate::nef::NefParser;
use crate::util;

use super::super::args::{Cli, DisasmFormat};
use super::super::reports::{DisasmReport, InstructionReport};

impl Cli {
    pub(super) fn run_disasm(
        &self,
        path: &PathBuf,
        format: DisasmFormat,
        fail_on_unknown_opcodes: bool,
    ) -> Result<()> {
        let handling = Self::unknown_handling(fail_on_unknown_opcodes);
        let decompiler = Decompiler::with_unknown_handling(handling);
        let result = decompiler.disassemble_file(path)?;
        // Parse the NEF a second time only when emitting JSON, so the
        // text path stays cheap. Both parses have already succeeded
        // by this point (disassemble_file ran the same parser
        // internally), so this is just to recover the script hash for
        // the report.
        let script_hash = if matches!(format, DisasmFormat::Json) {
            let bytes = Self::read_nef_bytes(path)?;
            Some(NefParser::new().parse(&bytes)?.script_hash())
        } else {
            None
        };
        match format {
            DisasmFormat::Text => {
                self.write_stdout(|out| {
                    for instruction in &result.instructions {
                        match instruction.operand {
                            Some(ref operand) => {
                                writeln!(
                                    out,
                                    "{:04X}: {:<10} {}",
                                    instruction.offset, instruction.opcode, operand
                                )?;
                            }
                            None => {
                                writeln!(
                                    out,
                                    "{:04X}: {}",
                                    instruction.offset, instruction.opcode
                                )?;
                            }
                        }
                    }
                    Self::write_warnings(out, &result.warnings)
                })?;
            }
            DisasmFormat::Json => {
                let instructions: Vec<InstructionReport> = result
                    .instructions
                    .iter()
                    .map(InstructionReport::from)
                    .collect();
                let script_hash = script_hash.expect("script_hash computed for JSON path");
                let report = DisasmReport {
                    file: path.display().to_string(),
                    script_hash_le: util::format_hash(&script_hash),
                    script_hash_be: util::format_hash_be(&script_hash),
                    instructions,
                    warnings: result.warnings.iter().map(ToString::to_string).collect(),
                };
                self.print_json(&report)?;
            }
        }
        Ok(())
    }
}