https://quilt.github.io/etk/

evm toolkit
https://quilt.github.io/etk/

assembler cryptocurrency ethereum evm

Last synced: about 1 month ago
JSON representation

evm toolkit

• Host: GitHub
• URL: https://quilt.github.io/etk/
• Owner: quilt
• License: apache-2.0
• Created: 2021-02-08T17:39:46.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2024-06-21T14:03:45.000Z (6 months ago)
• Last Synced: 2024-10-29T15:47:49.671Z (about 2 months ago)
• Topics: assembler, cryptocurrency, ethereum, evm
• Language: Rust
• Homepage:
• Size: 39.6 MB
• Stars: 358
• Watchers: 11
• Forks: 49
• Open Issues: 41
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

• awesome-web3-tools-and-dapps - EVM Toolkit - Discover powerful tools that allow you to easily create and analyze smart contract programs on the Ethereum Virtual Machine. (dApps directory / Assemblers)

README

        
# EVM Toolkit (`etk`)

[![license](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue)](https://github.com/quilt/etk)

[![chat](https://img.shields.io/badge/chat-telegram-informational)](https://t.me/joinchat/c-Cusp7Zh1tiM2Vh)

[![ci status](https://github.com/lightclient/eipv/workflows/ci/badge.svg)](https://github.com/quilt/etk/actions)

`etk` is a collection of tools for writing, reading, and analyzing EVM bytecode.

## Documentation

The [`etk` book](https://quilt.github.io/etk) is the most comprehensive guide to using `etk`.

* [Introduction](https://quilt.github.io/etk)

* [Usage](https://quilt.github.io/etk/ch01-cli/index.html)

    * [`eas`](https://quilt.github.io/etk/ch01-cli/ch01-eas.html)

    * [`disease`](https://quilt.github.io/etk/ch01-cli/ch02-disease.html)

* [Language & Syntax](https://quilt.github.io/etk/ch02-lang/index.html)

There are also several examples in the [`etk-asm/tests/asm`](etk-asm/tests/asm) directory. For further questions, join us on [Telegram](https://t.me/joinchat/c-Cusp7Zh1tiM2Vh).

## Quickstart

### Installation

`etk` requires the latest `rustc` from the stable channel.

```console

cargo install --features cli etk-asm etk-dasm

```

#### Project Templates

* [`etk`-Foundry Template](https://github.com/quilt/etk-foundry-template)

#### Syntax Highlighting

* [`vim-etk`](https://github.com/quilt/vim-etk)

### Usage

`contract.etk`:

```asm

push1 42

push1 13

add

pop

```

```console

$ eas contract.etk out.hex

$ disease --hex-file out.hex

   0:   push1 0x2a

   2:   push1 0x0d

   4:   add

   5:   pop

```

### Dependencies

`ecfg` requires z3 to build

Ubuntu Installation Instructions (example):

```console

sudo apt-get update -y

sudo apt-get install -y z3

sudo apt-get install -y libz3-dev

```

Check the system logs to confirm that there are no related errors.