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. Reverse ink! to EVM mode is also supported but is highly experimental and should be considered as a PoC for now.
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.
すみ (墨) 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.
- Install Sumi using
cargo install --git https://github.com/AstarNetwork/sumi --tag v0.2.0 - 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>.solwith your actual file name. solcshould produce file<input>.abithat 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
Usage: sumi [OPTIONS]
Options:
-i, --input <INPUT> Input filename or stdin if empty
-o, --output <OUTPUT> Output filename or stdout if empty
--module-name <MODULE_NAME> Ink module name to generate
-e, --evm-id <EVM_ID> EVM ID to use in module [default: 0x0F]
-m, --mode <MODE> [default: evm-to-ink] [possible values: evm-to-ink, ink-to-evm]
-h, --help Print help information
You can always use sumi --help to get the same reference.
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.