How to Create an EVM-Based Subnet Configuration
To create an Ethereum Virtual Machine (EVM) compatible Subnet, Metal-CLI runs Subnet-EVM as its virtual machine.
Using the Subnet Creation Wizard
The Subnet Creation Wizard walks you through the process of creating your Subnet. To get started, pick a name for your Subnet and run
metal subnet create <subnetName>
The following sections walk through each question in the wizard.
Choose Your VM
Enter Your Subnet's ChainID
Choose a unique positive integer for your EVM-style ChainID. Visit chainlist to verify that your selection is indeed unique.
Enter a string to name your Subnet's native token. The token symbol doesn't necessarily need to be unique. Example token symbols are METAL, JOE, and BTC.
Use latest version.
Gas Fee Configuration
Select your fee configuration. The Ava Labs team highly recommends
Low disk use / Low Throughput 1.5 mil gas/s (C-Chain's setting).
For development Subnets, select
Airdrop 1 million tokens to the default address (do not use in production).
When you are ready to start more mature testing, select
Customize your airdrop to distribute
funds to additional addresses.
If you'd like to add precompiles to customize your Subnet, select
If you don't or don't know what that means, select
If the command works successfully, it prints
Successfully created subnet configuration.
Using a Custom Genesis
The Subnet Creation Wizard won't customize every aspect of the Subnet-EVM genesis for you. If you'd like complete control, you can specify a custom genesis by providing a path to the file you'd like to use. This bypasses most of the wizard's prompts. Run with:
metal subnet create <subnetName> --file <filepath>
Overwriting an Existing Subnet Config
By default, creating a Subnet configuration with the same
subnetName as one that already exists
fails. To overwrite an existing config, use the
-f force flag:
metal subnet create <existingSubnetName> -f