Enum fuel_vm::prelude::Opcode

pub enum Opcode {
    ADD(usize, usize, usize),
    ADDI(usize, usize, u16),
    AND(usize, usize, usize),
    ANDI(usize, usize, u16),
    DIV(usize, usize, usize),
    DIVI(usize, usize, u16),
    EQ(usize, usize, usize),
    EXP(usize, usize, usize),
    EXPI(usize, usize, u16),
    GT(usize, usize, usize),
    LT(usize, usize, usize),
    MLOG(usize, usize, usize),
    MROO(usize, usize, usize),
    MOD(usize, usize, usize),
    MODI(usize, usize, u16),
    MOVE(usize, usize),
    MUL(usize, usize, usize),
    MULI(usize, usize, u16),
    NOT(usize, usize),
    OR(usize, usize, usize),
    ORI(usize, usize, u16),
    SLL(usize, usize, usize),
    SLLI(usize, usize, u16),
    SRL(usize, usize, usize),
    SRLI(usize, usize, u16),
    SUB(usize, usize, usize),
    SUBI(usize, usize, u16),
    XOR(usize, usize, usize),
    XORI(usize, usize, u16),
    CIMV(usize, usize, usize),
    CTMV(usize, usize),
    JI(u32),
    JNEI(usize, usize, u16),
    RET(usize),
    RETD(usize, usize),
    CFEI(u32),
    CFSI(u32),
    LB(usize, usize, u16),
    LW(usize, usize, u16),
    ALOC(usize),
    MCL(usize, usize),
    MCLI(usize, u32),
    MCP(usize, usize, usize),
    MCPI(usize, usize, u16),
    MEQ(usize, usize, usize, usize),
    SB(usize, usize, u16),
    SW(usize, usize, u16),
    BAL(usize, usize, usize),
    BHSH(usize, usize),
    BHEI(usize),
    BURN(usize),
    CALL(usize, usize, usize, usize),
    CCP(usize, usize, usize, usize),
    CROO(usize, usize),
    CSIZ(usize, usize),
    CB(usize),
    LDC(usize, usize, usize),
    LOG(usize, usize, usize, usize),
    LOGD(usize, usize, usize, usize),
    MINT(usize),
    RVRT(usize),
    SLDC(usize, usize, usize),
    SRW(usize, usize),
    SRWQ(usize, usize),
    SWW(usize, usize),
    SWWQ(usize, usize),
    TR(usize, usize, usize),
    TRO(usize, usize, usize, usize),
    ECR(usize, usize, usize),
    K256(usize, usize, usize),
    S256(usize, usize, usize),
    XIL(usize, usize),
    XIS(usize, usize),
    XOL(usize, usize),
    XOS(usize, usize),
    XWL(usize, usize),
    XWS(usize, usize),
    NOOP,
    FLAG(usize),
    GM(usize, u32),
    Undefined,
}

Instruction representation for the interpreter.

Memory Opcodes

All these opcodes advance the program counter $pc by 4 after performing their operation. Every instruction is guaranteed to fit in u32 representation.

Arithmetic/Logic (ALU) Opcodes

All these opcodes advance the program counter $pc by 4 after performing their operation.

If the F_UNSAFEMATH flag is unset, an operation that would have set $err to true is instead a panic.

If the F_WRAPPING flag is unset, an operation that would have set $of to a non-zero value is instead a panic. ## Contract Opcodes

All these opcodes advance the program counter $pc by 4 after performing their operation, except for CALL and REVERT.

Cryptographic Opcodes

All these opcodes advance the program counter $pc by 4 after performing their operation.

Variants

ADD(usize, usize, usize)

Adds two registers.

ADDI(usize, usize, u16)

Adds a register and an immediate value.

AND(usize, usize, usize)

Bitwise ANDs two registers.

ANDI(usize, usize, u16)

Bitwise ANDs a register and an immediate value.

DIV(usize, usize, usize)

Divides two registers.

DIVI(usize, usize, u16)

Divides a register and an immediate value.

EQ(usize, usize, usize)

Compares two registers for equality.

EXP(usize, usize, usize)

Raises one register to the power of another.

EXPI(usize, usize, u16)

Raises one register to the power of an immediate value.

GT(usize, usize, usize)

Compares two registers for greater-than.

LT(usize, usize, usize)

Compares two registers for less-than.

MLOG(usize, usize, usize)

The integer logarithm of a register.

MROO(usize, usize, usize)

The integer root of a register.

MOD(usize, usize, usize)

Modulo remainder of two registers.

MODI(usize, usize, u16)

Modulo remainder of a register and an immediate value.

MOVE(usize, usize)

Copy from one register to another.

MUL(usize, usize, usize)

Multiplies two registers.

MULI(usize, usize, u16)

Multiplies a register and an immediate value.

NOT(usize, usize)

Bitwise NOT a register.

OR(usize, usize, usize)

Bitwise ORs two registers.

ORI(usize, usize, u16)

Bitwise ORs a register and an immediate value.

SLL(usize, usize, usize)

Left shifts a register by a register.

SLLI(usize, usize, u16)

Left shifts a register by an immediate value.

SRL(usize, usize, usize)

Right shifts a register by a register.

SRLI(usize, usize, u16)

Right shifts a register by an immediate value.

SUB(usize, usize, usize)

Subtracts two registers.

SUBI(usize, usize, u16)

Subtracts a register and an immediate value.

XOR(usize, usize, usize)

Bitwise XORs two registers.

XORI(usize, usize, u16)

Bitwise XORs a register and an immediate value.

CIMV(usize, usize, usize)

Check relative timelock.

CTMV(usize, usize)

Check absolute timelock.

JI(u32)

Jump.

JNEI(usize, usize, u16)

Conditional jump.

RET(usize)

Return from context.

RETD(usize, usize)

Return from context with data.

CFEI(u32)

Extend the current call frame’s stack by an immediate value.

CFSI(u32)

Shrink the current call frame’s stack by an immediate value.

LB(usize, usize, u16)

A byte is loaded from the specified address offset by an immediate value.

LW(usize, usize, u16)

A word is loaded from the specified address offset by an immediate value.

ALOC(usize)

Allocate a number of bytes from the heap.

MCL(usize, usize)

Clear a variable number of bytes in memory.

MCLI(usize, u32)

Clear an immediate number of bytes in memory.

MCP(usize, usize, usize)

Copy a variable number of bytes in memory.

MCPI(usize, usize, u16)

Copy an immediate number of bytes in memory.

MEQ(usize, usize, usize, usize)

Compare bytes in memory.

SB(usize, usize, u16)

Write the least significant byte of a register to memory.

SW(usize, usize, u16)

Write a register to memory.

BAL(usize, usize, usize)

Get the balance of contract of an asset ID.

BHSH(usize, usize)

Get block header hash for height.

BHEI(usize)

Get current block height.

BURN(usize)

Burn coins of the current contract’s asset ID.

CALL(usize, usize, usize, usize)

Call a contract.

CCP(usize, usize, usize, usize)

Copy contract code for a contract.

CROO(usize, usize)

Get code root of a contract.

CSIZ(usize, usize)

Get code size of a contract.

CB(usize)

Get current block proposer’s address.

LDC(usize, usize, usize)

Load a contract’s code as executable.

LOG(usize, usize, usize, usize)

Log an event.

LOGD(usize, usize, usize, usize)

Log data.

MINT(usize)

Mint coins of the current contract’s asset ID.

RVRT(usize)

Halt execution, reverting state changes and returning a value.

SLDC(usize, usize, usize)

Load a static contract’s code as executable.

SRW(usize, usize)

Load a word from contract storage.

SRWQ(usize, usize)

Load 32 bytes from contract storage.

SWW(usize, usize)

Store a word in contract storage.

SWWQ(usize, usize)

Store 32 bytes in contract storage.

TR(usize, usize, usize)

Transfer coins to a contract unconditionally.

TRO(usize, usize, usize, usize)

Transfer coins to a variable output.

ECR(usize, usize, usize)

The 64-byte public key (x, y) recovered from 64-byte signature on 32-byte message.

K256(usize, usize, usize)

The keccak-256 hash of a slice.

S256(usize, usize, usize)

The SHA-2-256 hash of a slice.

XIL(usize, usize)

Get the length in bytes of an input.

XIS(usize, usize)

Get the memory addess of the start of an input.

XOL(usize, usize)

Get the length in bytes of an output.

XOS(usize, usize)

Get the memory addess of the start of an output.

XWL(usize, usize)

Get the length in bytes of a witness.

XWS(usize, usize)

Get the memory addess of the start of a witness.

NOOP

Performs no operation.

FLAG(usize)

Set flag register to a register.

GM(usize, u32)

Get metadata from memory.

Undefined

Undefined opcode, potentially from inconsistent serialization.

Implementations

impl Opcode

pub const LEN: usize

Size of the struct when serialized into bytes

pub const fn new(instruction: Instruction) -> Opcode

Create a new Opcode given the internal attributes

pub unsafe fn from_bytes_unchecked(bytes: &[u8]) -> Opcode

Create a Opcode from a slice of bytes

Safety

Reflects the requirements of bytes::from_slice_unchecked

pub fn to_bytes(self) -> [u8; 4]

Convert the opcode to bytes representation

pub const fn registers(&self) -> [Option<usize>; 4]

Transform the Opcode into an optional array of 4 register identifiers

pub const fn immediate(&self) -> Option<u64>

Return the underlying immediate value, if present

impl Opcode

pub fn from_bytes(bytes: &[u8]) -> Result<Opcode, Error>

Create a Opcode from a slice of bytes

This function will fail if the length of the bytes is smaller than Opcode::LEN.

pub fn from_bytes_iter<I>(bytes: I) -> Vec<Opcode, Global> where
    I: IntoIterator<Item = u8>, 

Create a set of Opcode from an iterator of bytes

If not padded to Self::LEN, will consume the unaligned bytes but won’t try to parse an opcode from them.

Trait Implementations

impl Clone for Opcode

fn clone(&self) -> Opcode

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Opcode

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl From<[u8; 4]> for Opcode

fn from(b: [u8; 4]) -> Opcode

Performs the conversion.

impl From<Instruction> for Opcode

fn from(parsed: Instruction) -> Opcode

Performs the conversion.

impl From<InstructionResult> for Opcode

fn from(r: InstructionResult) -> Opcode

Performs the conversion.

impl From<Opcode> for Instruction

fn from(op: Opcode) -> Instruction

Performs the conversion.

impl From<u32> for Opcode

fn from(instruction: u32) -> Opcode

Performs the conversion.

impl Hash for Opcode

fn hash<__H>(&self, state: &mut __H) where
    __H: Hasher, 

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<Opcode> for Opcode

fn eq(&self, other: &Opcode) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Opcode) -> bool

This method tests for !=.

impl Read for Opcode

fn read(&mut self, buf: &mut [u8]) -> Result<usize, Error>

Pull some bytes from this source into the specified buffer, returning how many bytes were read.

fn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>

Like read, except that it reads into a slice of buffers.

fn is_read_vectored(&self) -> bool

🔬 This is a nightly-only experimental API. (can_vector)

Determines if this Reader has an efficient read_vectored implementation.

fn read_to_end(&mut self, buf: &mut Vec<u8, Global>) -> Result<usize, Error>

Read all bytes until EOF in this source, placing them into buf.

fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>

Read all bytes until EOF in this source, appending them to buf.

fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>

Read the exact number of bytes required to fill buf.

fn read_buf(&mut self, buf: &mut ReadBuf<'_>) -> Result<(), Error>

🔬 This is a nightly-only experimental API. (read_buf)

Pull some bytes from this source into the specified buffer.

fn read_buf_exact(&mut self, buf: &mut ReadBuf<'_>) -> Result<(), Error>

🔬 This is a nightly-only experimental API. (read_buf)

Read the exact number of bytes required to fill buf.

fn by_ref(&mut self) -> &mut Self

Creates a “by reference” adaptor for this instance of Read.

fn bytes(self) -> Bytes<Self>

Transforms this Read instance to an Iterator over its bytes.

fn chain<R>(self, next: R) -> Chain<Self, R> where
    R: Read, 

Creates an adapter which will chain this stream with another.

fn take(self, limit: u64) -> Take<Self>

Creates an adapter which will read at most limit bytes from it.

impl Write for Opcode

fn write(&mut self, buf: &[u8]) -> Result<usize, Error>

Write a buffer into this writer, returning how many bytes were written.

fn flush(&mut self) -> Result<(), Error>

Flush this output stream, ensuring that all intermediately buffered contents reach their destination.

fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>

Like write, except that it writes from a slice of buffers.

fn is_write_vectored(&self) -> bool

🔬 This is a nightly-only experimental API. (can_vector)

Determines if this Writer has an efficient write_vectored implementation.

fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>

Attempts to write an entire buffer into this writer.

fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>

🔬 This is a nightly-only experimental API. (write_all_vectored)

Attempts to write multiple buffers into this writer.

fn write_fmt(&mut self, fmt: Arguments<'_>) -> Result<(), Error>

Writes a formatted string into this writer, returning any error encountered.

fn by_ref(&mut self) -> &mut Self

Creates a “by reference” adapter for this instance of Write.

impl Copy for Opcode

impl Eq for Opcode

impl StructuralEq for Opcode

impl StructuralPartialEq for Opcode