Skip to main content

Creating an EVM Chain

EVM chains run inside IOTA Smart Contracts chains. So in order to start an EVM chain, you will first need to follow the steps to start an IOTA Smart Contracts chain, or use an existing IOTA Smart Contracts chain to start the EVM chain on.


An IOTA Smart Contracts chain can only contain 1 EVM chain contract. If your IOTA Smart Contracts chain already has an EVM chain contract, you should use that chain contract instead of creating a new one.

1. Create the IOTA Smart Contracts Chain

If you don't have an IOTA Smart Contracts chain, you should create one. To do so, follow the instructions on setting up a chain.

2. Fund Your Account on Your IOTA Smart Contracts Chain

In order to deploy the EVM chain contract, you need to have some IOTA locked on your newly created chain to fund that action. To do this, run:

wasp-cli chain deposit IOTA:10000

This locks 10000 IOTA into your name on your chain, which can be used on to pay for the creation of the EVM Chain contract.

3. Deploy the EVM Chain Contract

In order to deploy the EVM Chain contract, you need to make sure that the token that will be used on that chain is supplied right at its inception to a given address. You will have to generate a compatible address with a private key file.

The most intuitive way to do this is by using Metamask. In MetaMask, you can create a wallet (it does not matter what chain it is connected to). Once a wallet is generated, you will see a wallet address under its name. You can copy this to your clipboard. This is the address that will receive the full supply of tokens on that chain.


Once you have this, you are ready to deploy the EVM chain with the following command:

wasp-cli chain evm deploy -a mychain --alloc 0x63c00c65BE86463491167eE26958a5A599BEbD2c:1000000000000000000000000
  • The -a parameter indicates the name of the chain that you want to deploy your EVM chain on top of. mychain in this case.
  • The --alloc parameter is the address that you copied from metamask(0x63c00c65BE86463491167eE26958a5A599BEbD2c in this case), followed by a :, and the value of Smart Contract Tokens that you want to be available to for use on EVM(1000000 tokens in this case, followed by 18 decimal zeroes).

Once this command has been executed successfully your EVM chain is up and running, and ready to be used.

You can verify the chain has been deployed by visiting the wasp dashboard and checking the smart contracts deployed on the chain. You should be able to see an evm contract over there.

Running the JSON-RPC Interface

In order to communicate with the EVM contract, you will need to run an additional server application that is compatible with how interactions usually takes place on other networks. This allows you to use other tools from those ecosystems like MetaMask and Hardhat to connect to our EVM chain.

To run this server, run the following command:

wasp-cli chain evm jsonrpc --chainid 1074

This will start the JSON-RPC server on port 8545 for you with Chain ID 1074. You can now point MetaMask or Hardhat to that server's address on port 8545, and interact with it like any other EVM based chain.


Re-using an existing Chain ID is not recommended, and can be a security risk. For any serious chain you will be running make sure you register a unique Chain ID on Chainlist and use that instead of the default.


The current implementation uses the wasp-cli's saves the account to pay for any fees in IOTA while using the JSON-RPC interface. This is of course not ideal in a normal usage scenario. Upcoming releases will address this in a more user-friendly way.

Video Tutorial