evmil 0.4.8

An low-level immediate language for compiling to EVM bytecode
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

# Overview

This is a library and tool for working with [EVM
bytecode](https://ethereum.org/en/developers/docs/evm/).  The tool
allows you to disassemble contracts into assembly language, and
assemble them back again.  The tool also supports a primitive
intermediate language which can be compiled into bytecode.

## Assembler / Disassembler

To illustrate the tool, we will first disassemble the bytecode
contract `0x60006000511161000f5760016000525b`.  We can do this as
follows:

```
evmil disassemble --code 0x60006000511161000f5760016000525b
```

This should produce the following output:

```
.code
        push 0x00
        push 0x00
        mload
        gt
        push 0x000f
        jumpi
        push 0x01
        push 0x00
        mstore
_0x000f:
        jumpdest
```

If we store this into a file `test.asm`, we can then assemble it back
as follows:

```
evmil assemble test.asm
```

And we should see our original bytecode being output:

```
0x60006000511161000f5760016000525b
```

Finally, when writing assembly language we can use labels for
simplicity.  For example, the above could be rewritten as follows:

```
.code
        push 0x00
        push 0x00
        mload
        gt
        push lab
        jumpi
        push 0x01
        push 0x00
        mstore
lab:
        jumpdest
```

This just makes writing the assembly language a bit easier.