Skip to main content

The evm Contract

The evm contract is one of the core contracts on each IOTA Smart Contracts chain.

The evm core contract provides the necessary infrastructure to accept Ethereum transactions and execute EVM code. It also includes the implementation of the ISC Magic contract.


For more information about how ISC supports EVM contracts, refer to the EVM section.

Entry Points

Most entry points of the evm core contract are meant to be accessed through the JSON-RPC service provided automatically by the Wasp node so that the end users can use standard EVM tools like MetaMask. We only list the entry points not exposed through the JSON-RPC interface in this document.


Called automatically when the ISC is deployed.

Some parameters of the evm contract can be specified by passing them to the root contract init entry point:

  • evmg (optional GenesisAlloc): The genesis allocation. The balance of all accounts must be 0.

  • evmgl (optional uint64 - default: 15000000): The EVM block gas limit (EVM gas units)

  • evmbk (optional int32 - default: keep all): Amount of EVM blocks to keep in the state.

  • evmchid (optional uint16 - default: 1074): EVM chain iD


    Re-using an existing Chain ID is not recommended and can be a security risk. For serious usage, register a unique Chain ID on Chainlist and use that instead of the default. It is not possible to change the EVM chain ID after deployment.

  • evmw (optional GasRatio - default: 1:1): The ISC to EVM gas ratio.


Registers an ERC20 contract to act as a proxy for the native tokens, at address 0x107402xxxxxxxx00000000000000000000000000, where xxxxxxxx is the little-endian encoding of the foundry serial number.

Only the foundry owner can call this endpoint.


  • fs (uint32): The foundry serial number
  • n (string): The token name
  • t (string): The ticker symbol
  • d (uint8): The token decimals



GenesisAlloc is encoded as the concatenation of:

  • Amount of accounts n (uint32).
  • n times:
    • Ethereum address ([]byte prefixed with uint32 size).
    • Account code ([]byte prefixed with uint32 size).
    • Amount of storage key/value pairs m(uint32).
    • m times:
      • Key ([]byte prefixed with uint32 size).
      • Value([]byte prefixed with uint32 size).
    • Account balance (must be 0)([]byte prefixed with uint32 size).
    • Account nonce (uint64).
    • Account private key (may be used for tests)(uint64).