Binding generator for EVM and ink!

Dmitry

Last update: Dec 15, 2022

Related tags

Cryptography sumi

Overview

Sumi is a binding generator specifically designed for Astar Network ecosystem with XVM in mind. It takes EVM metadata and converts it to an ink! module that can later be used to call into original EVM smart contract.

Please note that Sumi is not a transpiler, it's a binding generator. If you need to convert your existing Solidity smart contract to ink! please use Sol2ink instead.

Why Sumi?

すみ (墨) is a Japanese word meaning solid ink that is used for calligraphy and fine arts. In this project we're dealing with Solididy and ink!, hence the name.

Quick start guide

Install Sumi using cargo install --git https://github.com/0x7CFE/sumi
Use Solidity compiler (or Remix IDE if in doubt) to obtain smart contract metadata:
solc --pretty-json --abi <input>.sol -o .
Don't forget to replace <input>.sol with your actual file name.
solc should produce file <input>.abi that will contain ABI in JSON format
Use the ABI file to feed Sumi:
sumi --input <input>.abi --output binding.rs --module-name <my_module>

Sumi can also work in pipeline mode. By default it will read from stdin and write to stdout which can be handy for shell processing:

cat IERC20_meta.json | jq '.output.abi ' | sumi -m erc20 -e 0x0F | rustfmt > erc20.rs

Command line reference

Usage: sumi [OPTIONS] --module-name <MODULE_NAME>

Options:
  -i, --input <INPUT>              Input filename or stdin if empty
  -o, --output <OUTPUT>            Output filename or stdout if empty
  -m, --module-name <MODULE_NAME>  Ink module name to generate
  -e, --evm-id <EVM_ID>            EVM ID to use in module [default: 0x0F]
  -h, --help                       Print help information

You can always use sumi --help to get the same reference.

Current limitations

Due to XVM v2 limitations currently Sumi processes only:

functions (events are ignored)
returning a single value (bool) which is currently ignored
altering contract state, so no views

Overloaded functions are supported, but their return type is also ignored for now.

Tiny CLI for submitting large calldata transactions to EVM networks to stress test the networking layer. Main motivation: EIP4844blobs.

stress4844 Tiny CLI for submitting large calldata transactions to EVM networks to stress test the networking layer. Main motivation: EIP4844 blobs. ca

50 Jan 4, 2023

Releases(v0.1.1)

v0.1.1(Dec 13, 2022)

First release meant to be published. The code was cleaned and refactored.
Source code(tar.gz)
Source code(zip)
v0.1(Dec 7, 2022)
First prealpha release.

This release covers everything that was originally planned. But a lot of work is yet to be done, including:

code refactoring and organization

proper error handling and user facing messages

function return types, including overloaded functions

reverse transformation, i.e. ink! → EVM

Source code(tar.gz)
Source code(zip)