neo-decompiler 0.10.1

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

use super::{BlockId, Terminator};

#[test]
fn throw_creates_exit_block() {
    let instructions = vec![
        super::make_instr(0, super::OpCode::Push0, None),
        super::make_instr(1, super::OpCode::Throw, None),
    ];

    let cfg = super::CfgBuilder::new(&instructions).build();

    assert_eq!(cfg.block_count(), 1);
    let entry = cfg.entry_block().unwrap();
    assert!(matches!(entry.terminator, Terminator::Throw));
    assert!(cfg.exit_blocks().contains(&entry.id));
}

#[test]
fn abort_creates_exit_block() {
    let instructions = vec![
        super::make_instr(0, super::OpCode::Push0, None),
        super::make_instr(1, super::OpCode::Abort, None),
    ];

    let cfg = super::CfgBuilder::new(&instructions).build();

    assert_eq!(cfg.block_count(), 1);
    let entry = cfg.entry_block().unwrap();
    assert!(matches!(entry.terminator, Terminator::Abort));
    assert!(cfg.exit_blocks().contains(&entry.id));
}

#[test]
fn terminator_successors() {
    let ret = Terminator::Return;
    assert!(ret.successors().is_empty());

    let jump = Terminator::Jump {
        target: BlockId::new(1),
    };
    assert_eq!(jump.successors(), vec![BlockId::new(1)]);

    let branch = Terminator::Branch {
        then_target: BlockId::new(1),
        else_target: BlockId::new(2),
    };
    assert_eq!(branch.successors(), vec![BlockId::new(1), BlockId::new(2)]);
}

#[test]
fn terminator_properties() {
    let fallthrough = Terminator::Fallthrough {
        target: BlockId::new(1),
    };
    assert!(fallthrough.can_fallthrough());
    assert!(!fallthrough.is_conditional());

    let branch = Terminator::Branch {
        then_target: BlockId::new(1),
        else_target: BlockId::new(2),
    };
    assert!(!branch.can_fallthrough());
    assert!(branch.is_conditional());
}

#[test]
fn endtry_is_modeled_as_endtry_terminator() {
    let instructions = vec![
        super::make_instr(0, super::OpCode::Push0, None),
        super::make_instr(1, super::OpCode::Endtry, Some(super::Operand::Jump(2))),
        super::make_instr(3, super::OpCode::Push1, None), // dead code
        super::make_instr(4, super::OpCode::Ret, None),
        super::make_instr(5, super::OpCode::Ret, None), // continuation
    ];

    let cfg = super::CfgBuilder::new(&instructions).build();
    let entry = cfg.entry_block().unwrap();
    assert!(matches!(entry.terminator, Terminator::EndTry { .. }));
    assert!(!cfg.unreachable_blocks().is_empty());
}