Fuel ASM

Instruction set for the FuelVM.

Compile features

• std: Unless set, the crate will link to the core-crate instead of the std-crate. More info here.
• serde: Add support for serde for the types exposed by this crate.

Example

```rust use fuel_asm::*;

// A sample program to perform ecrecover let program = vec![ op::move(0x10, 0x01), // set r[0x10] := $one op::slli(0x20, 0x10, 5), // set r[0x20] := r[0x10] << 5 == 32 op::slli(0x21, 0x10, 6), // set r[0x21] := r[0x10] << 6 == 64 op::aloc(0x21), // alloc r[0x21] == 64 to the heap op::addi(0x10, 0x07, 1), // set r[0x10] := $hp + 1 (allocated heap) op::move(0x11, 0x04), // set r[0x11] := $ssp op::add(0x12, 0x04, 0x20), // set r[0x12] := $ssp + r[0x20] op::ecr(0x10, 0x11, 0x12), // recover public key in memory[r[0x10], 64] op::ret(0x01), // return 1 ];

// Convert program to bytes representation let bytes: Vec = program.iter().copied().collect();

// A program can be reconstructed from an iterator of bytes let restored: Result, > = fuelasm::frombytes(bytes).collect(); asserteq!(program, restored.unwrap());

// Every instruction can be described as u32 big-endian bytes let halfwords: Vec = program.iter().copied().collect(); let bytes = halfwords.iter().copied().map(u32::tobebytes).flatten(); let restored: Result, > = fuelasm::frombytes(bytes).collect(); asserteq!(program, restored.unwrap());

// We can also reconstruct the instructions individually let restored: Result, > = fuelasm::fromu32s(halfwords).collect(); asserteq!(program, restored.unwrap());

// An instruction is composed by the opcode representation, register IDs and immediate value. let instruction = program[1]; asserteq!(instruction.opcode(), Opcode::SLLI); let slli = match instruction { Instruction::SLLI(slli) => slli, _ => panic!("unexpected instruction"), }; let (ra, rb, imm) = slli.unpack(); asserteq!(u8::from(ra), 0x20); asserteq!(u8::from(rb), 0x10); asserteq!(u32::from(imm), 5); ```