Struct MacroAssembler

pub struct MacroAssembler {
    pub(crate) asm: Assembler,
}

EVM MacroAssembler.

Fields

asm: Assembler

Low level assembler.

Implementations

impl MacroAssembler

pub fn _ge(&mut self) -> Result<()>

Greater than or equal comparison.

a b ge -> a b-1 gt(lt)

Using lt due to order of stack.

pub fn _sge(&mut self) -> Result<()>

Greater than or equal comparison.

a b sge -> a b-1 sgt(slt)

Using lt due to order of stack.

pub fn _sle(&mut self) -> Result<()>

Greater than or equal comparison.

a b sge -> a b-1 sgt(slt)

Using lt due to order of stack.

pub fn _le(&mut self) -> Result<()>

Greater than or equal comparison.

a b le -> a b-1 lt(gt)

Using gt due to order of stack.

pub fn _sgt(&mut self) -> Result<()>

Greater than and equal comparison.

Using slt due to order of stack.

pub fn _gt(&mut self) -> Result<()>

Greater than comparison.

Using lt due to order of stack.

pub fn _lt(&mut self) -> Result<()>

less than comparison.

Using gt due to order of stack.

pub fn _slt(&mut self) -> Result<()>

less than or equal comparison.

Using gt due to order of stack.

pub fn _ne(&mut self) -> Result<()>

Sign-agnostic compare unequal.

pub fn _eqz(&mut self) -> Result<()>

Simple not operator

impl MacroAssembler

pub fn _sstore(&mut self) -> Result<()>

Function sstore from EVM which is not available in WASM.

pub fn _sload(&mut self) -> Result<()>

Function sload from EVM which is not available in WASM.

impl MacroAssembler

pub fn _max(&mut self) -> Result<()>

Maximum of two values

pub fn _min(&mut self) -> Result<()>

Minimum of two values

pub fn _ceil(&mut self) -> Result<()>

Ceiling operator

pub fn _floor(&mut self) -> Result<()>

Floor operator

pub fn _nearest(&mut self) -> Result<()>

Round to nearest integer, ties to even.

pub fn _sqrt(&mut self) -> Result<()>

Square root

pub fn _abs(&mut self) -> Result<()>

Absolute value

pub fn _neg(&mut self) -> Result<()>

Negation

pub fn _copysign(&mut self) -> Result<()>

If z1 and z2 have the same sign, return z1, otherwise return z1 with negated sign.

pub fn _convert_i32_s(&mut self) -> Result<()>

Convert a signed 32-bit integer to a (32-bit/64-bit) float

pub fn _convert_i32_u(&mut self) -> Result<()>

Convert an unsigned 32-bit integer to a (32-bit/64-bit) float

pub fn _convert_i64_s(&mut self) -> Result<()>

Convert a signed 32-bit integer to a (32-bit/64-bit) float

pub fn _convert_i64_u(&mut self) -> Result<()>

Convert a unsigned 32-bit integer to a (32-bit/64-bit) float

pub fn _trunc(&mut self) -> Result<()>

Round to nearest integer towards zero

impl MacroAssembler

pub fn _sub(&mut self) -> Result<()>

Sub two numbers.

pub fn _i32_const(&mut self, value: i32) -> Result<()>

Push a 32-bit integer value on the stack.

pub fn _i64_const(&mut self, value: i64) -> Result<()>

Push a 64-bit integer value on the stack.

pub fn _f32_const(&mut self, _value: Ieee32) -> Result<()>

Push a 32-bit float value on the stack.

pub fn _f64_const(&mut self, _value: Ieee64) -> Result<()>

Push a 64-bit float value on the stack.

pub fn _i32_wrap_i64(&mut self) -> Result<()>

wrap a 64-bit integer to a 32-bit integer.

pub fn _i64_extend_i32_s(&mut self) -> Result<()>

Extend a signed 32-bit integer to a 64-bit integer.

pub fn _i64_extend_i32_u(&mut self) -> Result<()>

Extend an unsigned 32-bit integer to a 64-bit integer.

pub fn _f32_demote_f64(&mut self) -> Result<()>

Truncate a 64-bit float to a signed 32-bit integer.

pub fn _f64_promote_f32(&mut self) -> Result<()>

Truncate a 64-bit float to an unsigned 32-bit integer.

pub fn _i32_reinterpret_f32(&mut self) -> Result<()>

Convert a signed 32-bit integer to a 32-bit float.

pub fn _i64_reinterpret_f64(&mut self) -> Result<()>

Convert a signed 64-bit integer to a 64-bit float.

pub fn _f32_reinterpret_i32(&mut self) -> Result<()>

Convert a 32-bit float to a signed 32-bit integer.

pub fn _f64_reinterpret_i64(&mut self) -> Result<()>

Convert a 64-bit float to a signed 64-bit integer.

pub fn _rotl(&mut self) -> Result<()>

sign-agnostic rotate left

Return the result of rotating i1 left by k bits.

pub fn _rotr(&mut self) -> Result<()>

sign-agnostic rotate right

Return the result of rotating i1 right by k bits.

pub fn _clz(&mut self) -> Result<()>

sign-agnostic count leading zero bits

Return the number of leading zero bits in i, all zero bits are considered leading if the value is zero.

pub fn _ctz(&mut self) -> Result<()>

sign-agnostic count leading zero bits

Return the number of leading zero bits in i, all zero bits are considered trailing if the value is zero.

pub fn _popcnt(&mut self) -> Result<()>

sign-agnostic count number of one bits

Return the count of no zero bits in i.

pub fn _trunc_f32(&mut self) -> Result<()>

Truncate a 32-bit float to an integer

pub fn _trunc_f64(&mut self) -> Result<()>

Truncate a 64-bit float to an integer

impl MacroAssembler

pub(crate) fn _load(&mut self) -> Result<()>

Load n bytes to extend self as another number type.

Just for adapting the WASM instructions, this method makes no sense for EVM since all of the numbers as U256.

pub(crate) fn _load8(&mut self) -> Result<()>

Load 1 byte to extend self as another number type.

Just for adapting the WASM instructions, this method makes no sense for EVM since all of the numbers as U256.

pub(crate) fn _load16(&mut self) -> Result<()>

Load 2 bytes to extend self as another number type.

Just for adapting the WASM instructions, this method makes no sense for EVM since all of the numbers as U256.

pub(crate) fn _load32(&mut self) -> Result<()>

Load 4 bytes to extend self as another number type.

Just for adapting the WASM instructions, this method makes no sense for EVM since all of the numbers as U256.

pub fn _store(&mut self) -> Result<()>

Store n bytes in memory.

pub fn _store8(&mut self) -> Result<()>

Wrap self to i8 and store 1 byte

pub fn _store16(&mut self) -> Result<()>

Wrap self to i16 and store 2 bytes

pub fn _store32(&mut self) -> Result<()>

Wrap self to i32 and store 4 bytes

pub fn _memory_size(&mut self, _: u32, _: u8) -> Result<()>

The memory size instruction returns the current size of memory.

pub fn _memory_grow(&mut self, _: u32, _: u8) -> Result<()>

The memory grow instruction grows memory by a given delta and returns the previous size, or -1 if enough memory cannot be allocated.

impl MacroAssembler

pub(crate) fn handle_empty_return(&mut self) -> Result<()>

Return with nothing.

pub fn main_return(&mut self, results: &[ValType]) -> Result<()>

Handle the end of the main function.

pub fn call_return(&mut self, results: &[ValType]) -> Result<()>

Handle the return of a call.

impl MacroAssembler

pub fn _drop(&mut self) -> Result<()>

The drop instruction simply throw away a single operand.

impl MacroAssembler

pub fn memory_write(&mut self, ty: impl Type) -> Result<MemoryInfo>

Store data in memory with at current memory byte pointer.

pub fn memory_write_bytes(&mut self, bytes: &[u8]) -> Result<MemoryInfo>

Write bytes to memory.

pub fn memory_write_at(&mut self, offset: &[u8]) -> Result<()>

Store data in memory at offset.

Returns the size in the lowest significant bytes.

pub fn pc_offset(&self) -> u16

Get the current program counter offset.

pub fn push(&mut self, bytes: &[u8]) -> Result<()>

Place n bytes on stack.

pub fn mp_offset<F>(&self, f: F) -> Result<SmallVec<[u8; 8]>>

where F: Fn(usize) -> Result<usize>,

Get byte offset of the memory pointer.

pub fn sp(&self) -> u8

Get the stack pointer.

pub fn swap(&mut self, index: u8) -> Result<()>

Swap memory by target index.

pub fn dup(&mut self, index: u8) -> Result<()>

Duplicate stack item by target index.

pub fn shift_stack(&mut self, count: u8, from_top: bool) -> Result<()>

Shift the program counter to the bottom or the top of the parameters. This is used by the callee function for jumping back to the caller function.

pub fn _return(&mut self) -> Result<()>

Return zero or more values from the function.

The return instruction is a shortcut for an unconditional branch to the outermost block, which implicitly is the body of the current function.

NOTE: This return could be different from the return in the EVM.

Methods from Deref<Target = Assembler>

pub fn buffer(&self) -> &[u8]

Buffer of the assembler.

pub fn buffer_mut(&mut self) -> &mut Buffer

Mutable buffer of the assembler.

pub fn increment_gas(&mut self, gas: u128)

Increment the gas counter.

TODO: use number bigger than u256 for throwing proper errors. (#21)

pub fn increment_sp(&mut self, items: u8) -> Result<()>

Increment stack pointer

pub fn decrement_sp(&mut self, items: u8) -> Result<()>

Decrement stack pointer

pub fn increment_mp(&mut self, offset: usize) -> Result<()>

Increment memory pointer

pub fn decrement_mp(&mut self, offset: usize) -> Result<()>

Decrement memory pointer

pub fn emit(&mut self, byte: u8)

Emit a byte.

pub fn emitn(&mut self, bytes: &[u8])

Emit n bytes.

pub fn emit_op(&mut self, opcode: OpCode) -> Result<()>

Emit a single opcode.

Mock the stack input and output for checking the stack usages.

pub fn _stop(&mut self) -> Result<()>

Emit STOP

pub fn _add(&mut self) -> Result<()>

Emit ADD

pub fn _mul(&mut self) -> Result<()>

Emit MUL

pub fn _sub(&mut self) -> Result<()>

Emit SUB

pub fn _div(&mut self) -> Result<()>

Emit DIV

pub fn _sdiv(&mut self) -> Result<()>

Emit SDIV

pub fn _mod(&mut self) -> Result<()>

Emit MOD

pub fn _smod(&mut self) -> Result<()>

Emit SMOD

pub fn _addmod(&mut self) -> Result<()>

Emit ADDMOD

pub fn _mulmod(&mut self) -> Result<()>

Emit MULMOD

pub fn _exp(&mut self) -> Result<()>

Emit EXP

pub fn _signextend(&mut self) -> Result<()>

Emit SIGNEXTEND

pub fn _lt(&mut self) -> Result<()>

Emit LT

pub fn _gt(&mut self) -> Result<()>

Emit GT

pub fn _slt(&mut self) -> Result<()>

Emit SLT

pub fn _sgt(&mut self) -> Result<()>

Emit SGT

pub fn _eq(&mut self) -> Result<()>

Emit EQ

pub fn _iszero(&mut self) -> Result<()>

Emit ISZERO

pub fn _and(&mut self) -> Result<()>

Emit AND

pub fn _or(&mut self) -> Result<()>

Emit OR

pub fn _xor(&mut self) -> Result<()>

Emit XOR

pub fn _not(&mut self) -> Result<()>

Emit NOT

pub fn _byte(&mut self) -> Result<()>

Emit BYTE

pub fn _shl(&mut self) -> Result<()>

Emit SHL

pub fn _shr(&mut self) -> Result<()>

Emit SHR

pub fn _sar(&mut self) -> Result<()>

Emit SAR

pub fn _keccak256(&mut self) -> Result<()>

Emit KECCAK256

pub fn _address(&mut self) -> Result<()>

Emit ADDRESS

pub fn _balance(&mut self) -> Result<()>

Emit BALANCE

pub fn _origin(&mut self) -> Result<()>

Emit ORIGIN

pub fn _caller(&mut self) -> Result<()>

Emit CALLER

pub fn _callvalue(&mut self) -> Result<()>

Emit CALLVALUE

pub fn _calldataload(&mut self) -> Result<()>

Emit CALLDATALOAD

pub fn _calldatasize(&mut self) -> Result<()>

Emit CALLDATASIZE

pub fn _calldatacopy(&mut self) -> Result<()>

Emit CALLDATACOPY

pub fn _codesize(&mut self) -> Result<()>

Emit CODESIZE

pub fn _codecopy(&mut self) -> Result<()>

Emit CODECOPY

pub fn _gasprice(&mut self) -> Result<()>

Emit GASPRICE

pub fn _extcodesize(&mut self) -> Result<()>

Emit EXTCODESIZE

pub fn _extcodecopy(&mut self) -> Result<()>

Emit EXTCODECOPY

pub fn _returndatasize(&mut self) -> Result<()>

Emit RETURNDATASIZE

pub fn _returndatacopy(&mut self) -> Result<()>

Emit RETURNDATACOPY

pub fn _blockhash(&mut self) -> Result<()>

Emit BLOCKHASH

pub fn _coinbase(&mut self) -> Result<()>

Emit COINBASE

pub fn _timestamp(&mut self) -> Result<()>

Emit TIMESTAMP

pub fn _number(&mut self) -> Result<()>

Emit NUMBER

pub fn _difficulty(&mut self) -> Result<()>

Emit DIFFICULTY

pub fn _gaslimit(&mut self) -> Result<()>

Emit GASLIMIT

pub fn _pop(&mut self) -> Result<()>

Emit POP

pub fn _mload(&mut self) -> Result<()>

Emit MLOAD

pub fn _mstore(&mut self) -> Result<()>

Emit MSTORE

pub fn _mstore8(&mut self) -> Result<()>

Emit MSTORE8

pub fn _sload(&mut self) -> Result<()>

Emit SLOAD

pub fn _sstore(&mut self) -> Result<()>

Emit SSTORE

pub fn _jump(&mut self) -> Result<()>

Emit JUMP

pub fn _jumpi(&mut self) -> Result<()>

Emit JUMPI

pub fn _pc(&mut self) -> Result<()>

Emit PC

pub fn _msize(&mut self) -> Result<()>

Emit MSIZE

pub fn _gas(&mut self) -> Result<()>

Emit GAS

pub fn _jumpdest(&mut self) -> Result<()>

Emit JUMPDEST

pub fn _push0(&mut self) -> Result<()>

Emit PUSH0

pub fn _push1(&mut self) -> Result<()>

Emit PUSH1

pub fn _push2(&mut self) -> Result<()>

Emit PUSH2

pub fn _push3(&mut self) -> Result<()>

Emit PUSH3

pub fn _push4(&mut self) -> Result<()>

Emit PUSH4

pub fn _push5(&mut self) -> Result<()>

Emit PUSH5

pub fn _push6(&mut self) -> Result<()>

Emit PUSH6

pub fn _push7(&mut self) -> Result<()>

Emit PUSH7

pub fn _push8(&mut self) -> Result<()>

Emit PUSH8

pub fn _push9(&mut self) -> Result<()>

Emit PUSH9

pub fn _push10(&mut self) -> Result<()>

Emit PUSH10

pub fn _push11(&mut self) -> Result<()>

Emit PUSH11

pub fn _push12(&mut self) -> Result<()>

Emit PUSH12

pub fn _push13(&mut self) -> Result<()>

Emit PUSH13

pub fn _push14(&mut self) -> Result<()>

Emit PUSH14

pub fn _push15(&mut self) -> Result<()>

Emit PUSH15

pub fn _push16(&mut self) -> Result<()>

Emit PUSH16

pub fn _push17(&mut self) -> Result<()>

Emit PUSH17

pub fn _push18(&mut self) -> Result<()>

Emit PUSH18

pub fn _push19(&mut self) -> Result<()>

Emit PUSH19

pub fn _push20(&mut self) -> Result<()>

Emit PUSH20

pub fn _push21(&mut self) -> Result<()>

Emit PUSH21

pub fn _push22(&mut self) -> Result<()>

Emit PUSH22

pub fn _push23(&mut self) -> Result<()>

Emit PUSH23

pub fn _push24(&mut self) -> Result<()>

Emit PUSH24

pub fn _push25(&mut self) -> Result<()>

Emit PUSH25

pub fn _push26(&mut self) -> Result<()>

Emit PUSH26

pub fn _push27(&mut self) -> Result<()>

Emit PUSH27

pub fn _push28(&mut self) -> Result<()>

Emit PUSH28

pub fn _push29(&mut self) -> Result<()>

Emit PUSH29

pub fn _push30(&mut self) -> Result<()>

Emit PUSH30

pub fn _push31(&mut self) -> Result<()>

Emit PUSH31

pub fn _push32(&mut self) -> Result<()>

Emit PUSH32

pub fn _dup1(&mut self) -> Result<()>

Emit DUP1

pub fn _dup2(&mut self) -> Result<()>

Emit DUP2

pub fn _dup3(&mut self) -> Result<()>

Emit DUP3

pub fn _dup4(&mut self) -> Result<()>

Emit DUP4

pub fn _dup5(&mut self) -> Result<()>

Emit DUP5

pub fn _dup6(&mut self) -> Result<()>

Emit DUP6

pub fn _dup7(&mut self) -> Result<()>

Emit DUP7

pub fn _dup8(&mut self) -> Result<()>

Emit DUP8

pub fn _dup9(&mut self) -> Result<()>

Emit DUP9

pub fn _dup10(&mut self) -> Result<()>

Emit DUP10

pub fn _dup11(&mut self) -> Result<()>

Emit DUP11

pub fn _dup12(&mut self) -> Result<()>

Emit DUP12

pub fn _dup13(&mut self) -> Result<()>

Emit DUP13

pub fn _dup14(&mut self) -> Result<()>

Emit DUP14

pub fn _dup15(&mut self) -> Result<()>

Emit DUP15

pub fn _dup16(&mut self) -> Result<()>

Emit DUP16

pub fn _swap1(&mut self) -> Result<()>

Emit SWAP1

pub fn _swap2(&mut self) -> Result<()>

Emit SWAP2

pub fn _swap3(&mut self) -> Result<()>

Emit SWAP3

pub fn _swap4(&mut self) -> Result<()>

Emit SWAP4

pub fn _swap5(&mut self) -> Result<()>

Emit SWAP5

pub fn _swap6(&mut self) -> Result<()>

Emit SWAP6

pub fn _swap7(&mut self) -> Result<()>

Emit SWAP7

pub fn _swap8(&mut self) -> Result<()>

Emit SWAP8

pub fn _swap9(&mut self) -> Result<()>

Emit SWAP9

pub fn _swap10(&mut self) -> Result<()>

Emit SWAP10

pub fn _swap11(&mut self) -> Result<()>

Emit SWAP11

pub fn _swap12(&mut self) -> Result<()>

Emit SWAP12

pub fn _swap13(&mut self) -> Result<()>

Emit SWAP13

pub fn _swap14(&mut self) -> Result<()>

Emit SWAP14

pub fn _swap15(&mut self) -> Result<()>

Emit SWAP15

pub fn _swap16(&mut self) -> Result<()>

Emit SWAP16

pub fn _log0(&mut self) -> Result<()>

Emit LOG0

pub fn _log1(&mut self) -> Result<()>

Emit LOG1

pub fn _log2(&mut self) -> Result<()>

Emit LOG2

pub fn _log3(&mut self) -> Result<()>

Emit LOG3

pub fn _log4(&mut self) -> Result<()>

Emit LOG4

pub fn _create(&mut self) -> Result<()>

Emit CREATE

pub fn _call(&mut self) -> Result<()>

Emit CALL

pub fn _callcode(&mut self) -> Result<()>

Emit CALLCODE

pub fn _return(&mut self) -> Result<()>

Emit RETURN

pub fn _delegatecall(&mut self) -> Result<()>

Emit DELEGATECALL

pub fn _create2(&mut self) -> Result<()>

Emit CREATE2

pub fn _staticcall(&mut self) -> Result<()>

Emit STATICCALL

pub fn _revert(&mut self) -> Result<()>

Emit REVERT

pub fn _invalid(&mut self) -> Result<()>

Emit INVALID

pub fn _selfdestruct(&mut self) -> Result<()>

Emit SELFDESTRUCT

Trait Implementations

impl Clone for MacroAssembler

fn clone(&self) -> MacroAssembler

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MacroAssembler

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

Formats the value using the given formatter.

impl Default for MacroAssembler

fn default() -> MacroAssembler

Returns the “default value” for a type.

impl Deref for MacroAssembler

type Target = Assembler

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for MacroAssembler

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.