forc 0.66.3

Fuel Orchestrator.
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

use anyhow::anyhow;
use clap::Parser;
use forc_util::ForcResult;
use std::fs::{self, File};
use std::io::Read;
use term_table::row::Row;
use term_table::table_cell::{Alignment, TableCell};
use tracing::info;

forc_util::cli_examples! {
    crate::cli::Opt {
        [Parse bytecode => "forc parse-bytecode <PATH>"]
    }
}

/// Parse bytecode file into a debug format.
#[derive(Debug, Parser)]
#[clap(bin_name = "forc parse-bytecode", version, after_help = help())]
pub(crate) struct Command {
    file_path: String,
}

pub(crate) fn exec(command: Command) -> ForcResult<()> {
    let mut f = File::open(&command.file_path)
        .map_err(|_| anyhow!("{}: file not found", command.file_path))?;
    let metadata = fs::metadata(&command.file_path)
        .map_err(|_| anyhow!("{}: file not found", command.file_path))?;
    let mut buffer = vec![0; metadata.len() as usize];
    f.read_exact(&mut buffer).expect("buffer overflow");

    let instructions = fuel_asm::from_bytes(buffer.iter().cloned())
        .zip(buffer.chunks(fuel_asm::Instruction::SIZE));

    let mut table = term_table::Table::new();
    table.separate_rows = false;
    table.add_row(Row::new(vec![
        TableCell::new("half-word"),
        TableCell::new("byte"),
        TableCell::new("op"),
        TableCell::new("raw"),
        TableCell::new("notes"),
    ]));
    table.style = term_table::TableStyle::empty();
    for (word_ix, (result, raw)) in instructions.enumerate() {
        use fuel_asm::Instruction;
        let notes = match result {
            Ok(Instruction::JI(ji)) => format!("jump to byte {}", u32::from(ji.imm24()) * 4),
            Ok(Instruction::JNEI(jnei)) => {
                format!("conditionally jump to byte {}", u32::from(jnei.imm12()) * 4)
            }
            Ok(Instruction::JNZI(jnzi)) => {
                format!("conditionally jump to byte {}", u32::from(jnzi.imm18()) * 4)
            }
            Err(fuel_asm::InvalidOpcode) if word_ix == 2 || word_ix == 3 => {
                let parsed_raw = u32::from_be_bytes([raw[0], raw[1], raw[2], raw[3]]);
                format!(
                    "data section offset {} ({})",
                    if word_ix == 2 { "lo" } else { "hi" },
                    parsed_raw
                )
            }
            Err(fuel_asm::InvalidOpcode) if word_ix == 4 || word_ix == 5 => {
                let parsed_raw = u32::from_be_bytes([raw[0], raw[1], raw[2], raw[3]]);
                format!(
                    "configurables offset {} ({})",
                    if word_ix == 4 { "lo" } else { "hi" },
                    parsed_raw
                )
            }
            Ok(_) | Err(fuel_asm::InvalidOpcode) => "".into(),
        };
        table.add_row(Row::new(vec![
            TableCell::builder(word_ix)
                .col_span(1)
                .alignment(Alignment::Right)
                .build(),
            TableCell::new(word_ix * 4),
            TableCell::new(match result {
                Ok(inst) => format!("{inst:?}"),
                Err(err) => format!("{err:?}"),
            }),
            TableCell::new(format!(
                "{:02x} {:02x} {:02x} {:02x}",
                raw[0], raw[1], raw[2], raw[3],
            )),
            TableCell::new(notes),
        ]));
    }

    info!("{}", table.render());

    Ok(())
}