neo-decompiler 0.10.2

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

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

use crate::decompiler::{Decompiler, OutputFormat};
use crate::error::Result;

use super::super::args::Cli;

impl Cli {
    pub(super) fn run_cfg(&self, path: &Path, fail_on_unknown_opcodes: bool) -> Result<()> {
        let handling = Self::unknown_handling(fail_on_unknown_opcodes);
        let decompiler = Decompiler::with_unknown_handling(handling);
        // Load the manifest when present so the CFG's graph label
        // shows the contract name alongside the script hash —
        // useful when dumping multiple contracts to a single
        // graphviz canvas.
        let data = Self::read_nef_bytes(path)?;
        let manifest = self.load_manifest(path)?;
        // CFG is built regardless of output format; pick the cheapest
        // (`Pseudocode`) so we don't pay for high-level / C# rendering
        // we'll never use.
        let result =
            decompiler.decompile_bytes_with_manifest(&data, manifest, OutputFormat::Pseudocode)?;

        self.write_stdout(|out| out.write_all(result.cfg_to_dot().as_bytes()))?;

        // Surface disassembly warnings (e.g. an unknown opcode that may have
        // desynchronized the instruction stream the CFG is built on). stdout
        // carries the DOT graph and must stay valid graphviz, so the
        // `Warnings:` block goes to stderr; the other disassembling commands
        // (`disasm`, `decompile`) surface these warnings too.
        Self::write_warnings(&mut std::io::stderr(), &result.warnings)?;
        Ok(())
    }
}