diff --git a/content/docs/cross-chain/teleporter/teleporter-on-devnet.mdx b/content/docs/cross-chain/teleporter/teleporter-on-devnet.mdx index 4b5e743d68a..3b4fc5e6b27 100644 --- a/content/docs/cross-chain/teleporter/teleporter-on-devnet.mdx +++ b/content/docs/cross-chain/teleporter/teleporter-on-devnet.mdx @@ -22,17 +22,17 @@ Note: the tutorial uses AWS hosts, but Devnets can also be created and operated Create Subnets Configurations[​](#create-subnets-configurations "Direct link to heading") ----------------------------------------------------------------------------------------- -For this section we will follow this [steps](/tooling/cross-chain/teleporter-local-network#create-subnets-configurations), to create two Teleporter-enabled Subnets, `` and ``. +For this section we will follow this [steps](/tooling/cross-chain/teleporter-local-network#create-subnets-configurations), to create two Teleporter-enabled Subnets, `` and ``. Create a Devnet and Deploy a Subnet in It[​](#create-a-devnet-and-deploy-a-subnet-in-it "Direct link to heading") ----------------------------------------------------------------------------------------------------------------- -Let's use the `devnet wiz` command to create a devnet `` and deploy `` in it. +Let's use the `devnet wiz` command to create a devnet `` and deploy `` in it. The devnet will be created in the `us-east-1` region of AWS, and will consist of 5 validators only. ``` -avalanche node devnet wiz --aws --node-type default --region us-east-1 --num-validators 5 --num-apis 0 --enable-monitoring=false --default-validator-params +avalanche node devnet wiz --aws --node-type default --region us-east-1 --num-validators 5 --num-apis 0 --enable-monitoring=false --default-validator-params Creating the devnet... @@ -61,7 +61,7 @@ updating configuration file ~/.avalanche-cli/nodes/i-0f1815c016b555fcc/services/ Devnet is successfully created and is now validating subnet subnet1! -Subnet RPC URL: http://67.202.23.231:9650/ext/bc/fqcM24LNb3kTV7KD1mAvUJXYy5XunwP8mrE44YuNwPjgZHY6p/rpc +Subnet RPC URL: http://67.202.23.231:9650/ext/bc/fqcM24LNb3kTV7KD1mAvUJXYy5XunwP8mrE44YuNwPjgZHY6p/rpc ✓ Cluster information YAML file can be found at ~/.avalanche-cli/nodes/inventories//clusterInfo.yaml at local host ``` @@ -127,12 +127,12 @@ Apr 05 14:15:08 ip-172-31-47-187 awm-relayer[6886]: {"level":"info","timestamp": Deploying the Second Subnet[​](#deploying-the-second-subnet "Direct link to heading") ------------------------------------------------------------------------------------- -Let's use the `devnet wiz` command again to deploy ``. +Let's use the `devnet wiz` command again to deploy ``. -When deploying Subnet ``, the two Teleporter contracts will not be deployed to C-Chain in Local Network as they have already been deployed when we deployed the first Subnet. +When deploying Subnet ``, the two Teleporter contracts will not be deployed to C-Chain in Local Network as they have already been deployed when we deployed the first Subnet. ``` -avalanche node devnet wiz --default-validator-params +avalanche node devnet wiz --default-validator-params Adding subnet into existing devnet ... ... @@ -158,7 +158,7 @@ updating configuration file ~/.avalanche-cli/nodes/i-0f1815c016b555fcc/services/ Devnet is now validating subnet subnet2 -Subnet RPC URL: http://67.202.23.231:9650/ext/bc/7gKt6evRnkA2uVHRfmk9WrH3dYZH9gEVVxDAknwtjvtaV3XuQ/rpc +Subnet RPC URL: http://67.202.23.231:9650/ext/bc/7gKt6evRnkA2uVHRfmk9WrH3dYZH9gEVVxDAknwtjvtaV3XuQ/rpc ✓ Cluster information YAML file can be found at ~/.avalanche-cli/nodes/inventories//clusterInfo.yaml at local host ``` @@ -191,7 +191,7 @@ Obtaining Information on Teleporter Deploys[​](#obtaining-information-on-telep ### Obtaining Subnet Information[​](#obtaining-subnet-information "Direct link to heading") -By executing `subnet describe` on a Teleporter enabled Subnet, the following relevant information can be found: +By executing `blockchain describe` on a Teleporter enabled Subnet, the following relevant information can be found: - Blockchain RPC URL - Blockchain ID in cb58 format @@ -199,10 +199,10 @@ By executing `subnet describe` on a Teleporter enabled Subnet, the following rel - Teleporter Messenger address - Teleporter Registry address -Let's get the information for ``: +Let's get the information for ``: ``` -avalanche blockchain describe +avalanche blockchain describe _____ _ _ _ | __ \ | | (_) | diff --git a/content/docs/cross-chain/teleporter/teleporter-on-local-network.mdx b/content/docs/cross-chain/teleporter/teleporter-on-local-network.mdx index a7bc8d60619..3ff5e49fb27 100644 --- a/content/docs/cross-chain/teleporter/teleporter-on-local-network.mdx +++ b/content/docs/cross-chain/teleporter/teleporter-on-local-network.mdx @@ -15,14 +15,14 @@ Note that currently only [Subnet-EVM](https://github.com/ava-labs/subnet-evm) an Create Subnet Configurations[​](#create-subnet-configurations "Direct link to heading") --------------------------------------------------------------------------------------- -Let's create a Subnet called `` with the latest Subnet-EVM version, a chain ID of 1, TOKEN1 as the token name, and with default Subnet-EVM parameters (more information regarding Subnet creation can be found [here](/subnets/build-first-subnet#create-your-subnet-configuration)): +Let's create a Subnet called `` with the latest Subnet-EVM version, a chain ID of 1, TOKEN1 as the token name, and with default Subnet-EVM parameters (more information regarding Subnet creation can be found [here](/subnets/build-first-subnet#create-your-subnet-configuration)): ``` -avalanche blockchain create --evm --latest\ +avalanche blockchain create --evm --latest\ --evm-chain-id 1 --evm-token TOKEN1 --evm-defaults -creating genesis for -configuring airdrop to stored key "subnet__airdrop" with address 0x0EF8151A3e6ad1d4e17C8ED4128b20EB5edc58B1 +creating genesis for +configuring airdrop to stored key "subnet__airdrop" with address 0x0EF8151A3e6ad1d4e17C8ED4128b20EB5edc58B1 loading stored key "cli-teleporter-deployer" for teleporter deploys (evm address, genesis balance) = (0xE932784f56774879e03F3624fbeC6261154ec711, 600000000000000000000) using latest teleporter version (v1.0.0) @@ -35,14 +35,14 @@ To disable Teleporter in your Subnet, use the flag `--teleporter=false` when cre To disable Relayer in your Subnet, use the flag `--relayer=false` when creating the Subnet. -Now let's create a second Subnet called ``, with similar settings: +Now let's create a second Subnet called ``, with similar settings: ``` -avalanche blockchain create --evm --latest\ - --evm-chain-id 2 --evm-token TOKEN2 --evm-defaults +avalanche blockchain create --evm --latest\ + --evm-chain-id 2 --evm-token TOKEN1 --evm-defaults -creating genesis for -configuring airdrop to stored key "subnet__airdrop" with address 0x0EF815FFFF6ad1d4e17C8ED4128b20EB5edAABBB +creating genesis for +configuring airdrop to stored key "subnet__airdrop" with address 0x0EF815FFFF6ad1d4e17C8ED4128b20EB5edAABBB loading stored key "cli-teleporter-deployer" for teleporter deploys (evm address, genesis balance) = (0xE932784f56774879e03F3624fbeC6261154ec711, 600000000000000000000) using latest teleporter version (v1.0.0) @@ -52,12 +52,13 @@ using latest teleporter version (v1.0.0) Deploy the Subnets to Local Network[​](#deploy-the-subnets-to-local-network "Direct link to heading") ----------------------------------------------------------------------------------------------------- -Let's deploy ``: +Let's deploy ``: ``` -avalanche blockchain deploy --local +avalanche blockchain deploy --local -Deploying [] to Local Network + +Deploying [] to Local Network Backend controller started, pid: 149427, output at: ~/.avalanche-cli/runs/server_20240229_165923/avalanche-cli-backend.log Booting Network. Wait until healthy... @@ -69,8 +70,8 @@ Deploying Blockchain. Wait until network acknowledges... Teleporter Messenger successfully deployed to c-chain (0xF7cBd95f1355f0d8d659864b92e2e9fbfaB786f7) Teleporter Registry successfully deployed to c-chain (0x17aB05351fC94a1a67Bf3f56DdbB941aE6c63E25) -Teleporter Messenger successfully deployed to (0xF7cBd95f1355f0d8d659864b92e2e9fbfaB786f7) -Teleporter Registry successfully deployed to (0x9EDc4cB4E781413b1b82CC3A92a60131FC111F58) +Teleporter Messenger successfully deployed to (0xF7cBd95f1355f0d8d659864b92e2e9fbfaB786f7) +Teleporter Registry successfully deployed to (0x9EDc4cB4E781413b1b82CC3A92a60131FC111F58) Using latest awm-relayer version (v1.1.0) Executing AWM-Relayer... @@ -79,21 +80,21 @@ Blockchain ready to use. Local network node endpoints: +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ | NODE | VM | URL | ALIAS URL | +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ -| node1 | | http://127.0.0.1:9650/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9650/ext/bc//rpc | +| node1 | | http://127.0.0.1:9650/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9650/ext/bc//rpc | +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ -| node2 | | http://127.0.0.1:9652/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9652/ext/bc//rpc | +| node2 | | http://127.0.0.1:9652/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9652/ext/bc//rpc | +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ -| node3 | | http://127.0.0.1:9654/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9654/ext/bc//rpc | +| node3 | | http://127.0.0.1:9654/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9654/ext/bc//rpc | +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ -| node4 | | http://127.0.0.1:9656/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9656/ext/bc//rpc | +| node4 | | http://127.0.0.1:9656/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9656/ext/bc//rpc | +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ -| node5 | | http://127.0.0.1:9658/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9658/ext/bc//rpc | +| node5 | | http://127.0.0.1:9658/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9658/ext/bc//rpc | +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ Browser Extension connection details (any node URL from above works): RPC URL: http://127.0.0.1:9650/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc Funded address: 0x0EF8151A3e6ad1d4e17C8ED4128b20EB5edc58B1 with 1000000 (10^18) - private key: 16289399c9466912ffffffdc093c9b51124f0dc54ac7a766b2bc5ccf558d8eee -Network name: +Network name: Chain ID: 1 Currency Symbol: TOKEN1 ``` @@ -106,19 +107,19 @@ Notice some details here: CLI configures the Relayer to enable every Subnet to send messages to all other Subnets. If you add more Subnets, the Relayer will be automatically reconfigured. -When deploying Subnet ``, the two Teleporter contracts will not be deployed to C-Chain in Local Network as they have already been deployed when we deployed the first Subnet. +When deploying Subnet ``, the two Teleporter contracts will not be deployed to C-Chain in Local Network as they have already been deployed when we deployed the first Subnet. ``` -avalanche blockchain deploy --local +avalanche blockchain deploy --local -Deploying [] to Local Network +Deploying [] to Local Network Deploying Blockchain. Wait until network acknowledges... Teleporter Messenger has already been deployed to c-chain -Teleporter Messenger successfully deployed to (0xF7cBd95f1355f0d8d659864b92e2e9fbfaB786f7) -Teleporter Registry successfully deployed to (0x9EDc4cB4E781413b1b82CC3A92a60131FC111F58) +Teleporter Messenger successfully deployed to (0xF7cBd95f1355f0d8d659864b92e2e9fbfaB786f7) +Teleporter Registry successfully deployed to (0x9EDc4cB4E781413b1b82CC3A92a60131FC111F58) Using latest awm-relayer version (v1.1.0) Executing AWM-Relayer... @@ -127,31 +128,31 @@ Blockchain ready to use. Local network node endpoints: +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ | NODE | VM | URL | ALIAS URL | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node1 | | http://127.0.0.1:9650/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9650/ext/bc//rpc | +| node1 | | http://127.0.0.1:9650/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9650/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node1 | | http://127.0.0.1:9650/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9650/ext/bc//rpc | +| node1 | | http://127.0.0.1:9650/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9650/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node2 | | http://127.0.0.1:9652/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9652/ext/bc//rpc | +| node2 | | http://127.0.0.1:9652/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9652/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node2 | | http://127.0.0.1:9652/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9652/ext/bc//rpc | +| node2 | | http://127.0.0.1:9652/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9652/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node3 | | http://127.0.0.1:9654/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9654/ext/bc//rpc | +| node3 | | http://127.0.0.1:9654/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9654/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node3 | | http://127.0.0.1:9654/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9654/ext/bc//rpc | +| node3 | | http://127.0.0.1:9654/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9654/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node4 | | http://127.0.0.1:9656/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9656/ext/bc//rpc | +| node4 | | http://127.0.0.1:9656/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9656/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node4 | | http://127.0.0.1:9656/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9656/ext/bc//rpc | +| node4 | | http://127.0.0.1:9656/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9656/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node5 | | http://127.0.0.1:9658/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9658/ext/bc//rpc | +| node5 | | http://127.0.0.1:9658/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9658/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node5 | | http://127.0.0.1:9658/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9658/ext/bc//rpc | +| node5 | | http://127.0.0.1:9658/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9658/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ Browser Extension connection details (any node URL from above works): RPC URL: http://127.0.0.1:9650/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc Funded address: 0x0EF815FFFF6ad1d4e17C8ED4128b20EB5edAABBB with 1000000 (10^18) - private key: 56289e99c94b6912bfc12adc093c9b51124f0dc54ac7a766b2bc5ccf558d8027 -Network name: +Network name: Chain ID: 2 Currency Symbol: TOKEN2 ``` @@ -162,18 +163,18 @@ Verify Teleporter Is Successfully Set Up[​](#verify-teleporter-is-successfully To verify that Teleporter is successfully, let's send a couple of cross messages: ``` -avalanche teleporter msg C-Chain subnet1 "Hello World" --local +avalanche teleporter msg C-Chain chain1 "Hello World" --local Delivering message "this is a message" to source subnet "C-Chain" -Waiting for message to be received at destination subnet subnet "subnet1" +Waiting for message to be received at destination subnet subnet "chain1" Message successfully Teleported! ``` ``` -avalanche teleporter msg subnet2 subnet1 "Hello World" --local +avalanche teleporter msg chain2 chain1 "Hello World" --local -Delivering message "this is a message" to source subnet "subnet2" -Waiting for message to be received at destination subnet subnet "subnet1" +Delivering message "this is a message" to source subnet "chain2" +Waiting for message to be received at destination subnet subnet "chain1" Message successfully Teleported! ``` @@ -186,7 +187,7 @@ Obtaining Information on Teleporter Deploys[​](#obtaining-information-on-telep ### Obtaining Subnet Information[​](#obtaining-subnet-information "Direct link to heading") -By executing `subnet describe` on a Teleporter enabled Subnet, the following relevant information can be found: +By executing `blockchain describe` on a Teleporter enabled Subnet, the following relevant information can be found: - Blockchain RPC URL - Blockchain ID in cb58 format @@ -194,10 +195,10 @@ By executing `subnet describe` on a Teleporter enabled Subnet, the following rel - Teleporter Messenger address - Teleporter Registry address -Let's get the information for ``: +Let's get the information for ``: ``` -avalanche blockchain describe +avalanche blockchain describe _____ _ _ _ | __ \ | | (_) | @@ -208,7 +209,7 @@ avalanche blockchain describe +--------------------------------+-------------------------------------------------------------------------------------+ | PARAMETER | VALUE | +--------------------------------+-------------------------------------------------------------------------------------+ -| Subnet Name | subnet1 | +| Subnet Name | chain1 | +--------------------------------+-------------------------------------------------------------------------------------+ | ChainID | 1 | +--------------------------------+-------------------------------------------------------------------------------------+ diff --git a/content/docs/subnets/avalanche-cli-subnets.mdx b/content/docs/subnets/avalanche-cli-subnets.mdx index 61d68be38a4..48216648a9b 100644 --- a/content/docs/subnets/avalanche-cli-subnets.mdx +++ b/content/docs/subnets/avalanche-cli-subnets.mdx @@ -51,11 +51,11 @@ Subnet[​](#subnet "Direct link to heading") The `subnet` command suite provides a collection of tools for developing and deploying Subnets. -To get started, use the `subnet create` command wizard to walk through the configuration of your very first Subnet. Then, go ahead and deploy it with the `subnet deploy` command. You can use the rest of the commands to manage your Subnet configurations and live deployments. +To get started, use the `blockchain create` command wizard to walk through the configuration of your very first Subnet. Then, go ahead and deploy it with the `blockchain deploy` command. You can use the rest of the commands to manage your Subnet configurations and live deployments. ### Subnet AddValidator[​](#subnet-addvalidator "Direct link to heading") -The `subnet addValidator` command whitelists a primary network validator to validate the provided deployed Subnet. +The `blockchain addValidator` command whitelists a primary network validator to validate the provided deployed Subnet. To add the validator to the Subnet's allow list, you first need to provide the subnetName and the validator's unique NodeID. The command then prompts for the validation start time, duration, and stake weight. You can bypass these prompts by providing the values with flags. @@ -64,7 +64,7 @@ This command currently only works on Subnets deployed to either the Fuji Testnet **Usage**: ```bash -avalanche subnet addValidator [subnetName] [flags] +avalanche blockchain addValidator [subnetName] [flags] ``` **Flags**: @@ -97,7 +97,7 @@ This command removes a node as a validator in a Subnet. **Usage**: ```bash -avalanche subnet removeValidator [subnetName] [flags] +avalanche blockchain removeValidator [subnetName] [flags] ``` **Flags**: @@ -117,12 +117,12 @@ avalanche subnet removeValidator [subnetName] [flags] ### Subnet Change Owner[​](#subnet-change-owner "Direct link to heading") -The `subnet changeOwner` changes the owner of the deployed Subnet. This command currently only works on Subnets deployed to Devnet, Fuji or Mainnet. +The `blockchain changeOwner` changes the owner of the deployed Subnet. This command currently only works on Subnets deployed to Devnet, Fuji or Mainnet. **Usage**: ```bash -avalanche subnet changeOwner [subnetName] [flags] +avalanche blockchain changeOwner [subnetName] [flags] ``` **Flags**: @@ -153,7 +153,7 @@ AvalancheGo nodes support several different configuration files. Subnets have th **Usage**: ```bash -avalanche subnet configure [subnetName] [flags] +avalanche blockchain configure [subnetName] [flags] ``` **Flags**: @@ -167,7 +167,7 @@ avalanche subnet configure [subnetName] [flags] ### Subnet Create[​](#subnet-create "Direct link to heading") -The `subnet create` command builds a new genesis file to configure your Subnet. By default, the command runs an interactive wizard. It walks you through all the steps you need to create your first Subnet. +The `blockchain create` command builds a new genesis file to configure your Subnet. By default, the command runs an interactive wizard. It walks you through all the steps you need to create your first Subnet. The tool supports deploying Subnet-EVM and custom VMs. You can create a custom, user-generated genesis with a custom VM by providing the path to your genesis and VM binaries with the `--genesis` and `--vm` flags. @@ -204,12 +204,12 @@ avalanche blockchain create [subnetName] [flags] ### Subnet Delete[​](#subnet-delete "Direct link to heading") -The `subnet delete` command deletes an existing Subnet configuration. +The `blockchain delete` command deletes an existing Subnet configuration. **Usage**: ```bash -avalanche subnet delete [flags] +avalanche blockchain delete [flags] ``` **Flags**: @@ -220,7 +220,7 @@ avalanche subnet delete [flags] ### Subnet Deploy[​](#subnet-deploy "Direct link to heading") -The `subnet deploy` command deploys your Subnet configuration locally, to Fuji Testnet, or to Mainnet. +The `blockchain deploy` command deploys your Subnet configuration locally, to Fuji Testnet, or to Mainnet. At the end of the call, the command prints the RPC URL you can use to interact with the Subnet. @@ -259,7 +259,7 @@ avalanche blockchain deploy [subnetName] [flags] ### Subnet Describe[​](#subnet-describe "Direct link to heading") -The `subnet describe` command prints the details of a Subnet configuration to the console. By default, the command prints a summary of the configuration. By providing the `--genesis` flag, the command instead prints out the raw genesis file. +The `blockchain describe` command prints the details of a Subnet configuration to the console. By default, the command prints a summary of the configuration. By providing the `--genesis` flag, the command instead prints out the raw genesis file. **Usage**: @@ -276,12 +276,12 @@ avalanche blockchain describe [subnetName] [flags] ### Subnet Export[​](#subnet-export "Direct link to heading") -The `subnet export` command write the details of an existing Subnet deploy to a file. The command prompts for an output path. You can also provide one with the `--output` flag. +The `blockchain export` command write the details of an existing Subnet deploy to a file. The command prompts for an output path. You can also provide one with the `--output` flag. **Usage**: ```bash -avalanche subnet export [subnetName] [flags] +avalanche blockchain export [subnetName] [flags] ``` **Flags**: @@ -293,7 +293,7 @@ avalanche subnet export [subnetName] [flags] ### Subnet Import[​](#subnet-import "Direct link to heading") -The `subnet import` command imports configurations into Avalanche-CLI. +The `blockchain import` command imports configurations into Avalanche-CLI. This command supports importing from a file created on another computer, or importing from Subnets running public networks (for example, created manually or with the deprecated Subnet-CLI) @@ -304,7 +304,7 @@ To import from a file, you can optionally provide the path as a command-line arg **Usage**: ```bash -avalanche subnet import file [subnetPath] [flags] +avalanche blockchain import file [subnetPath] [flags] ``` **Flags**: @@ -319,14 +319,14 @@ avalanche subnet import file [subnetPath] [flags] #### Import from a Public Network[​](#import-from-a-public-network "Direct link to heading") -The `subnet import public` command imports a Subnet configuration from a running network. +The `blockchain import public` command imports a Subnet configuration from a running network. The genesis file should be available from the disk for this to work. By default, an imported Subnet doesn't overwrite an existing Subnet with the same name. To allow overwrites, provide the `--force` flag. **Usage**: ```bash -avalanche subnet import public [subnetPath] [flags] +avalanche blockchain import public [subnetPath] [flags] ``` **Flags**: @@ -347,7 +347,7 @@ avalanche subnet import public [subnetPath] [flags] ### Subnet Join[​](#subnet-join "Direct link to heading") -The `subnet join` command configures your validator node to begin validating a new Subnet. +The `blockchain join` command configures your validator node to begin validating a new Subnet. To complete this process, you must have access to the machine running your validator. If the CLI is running on the same machine as your validator, it can generate or update your node's config file automatically. Alternatively, the command can print the necessary instructions to update your node manually. To complete the validation process, the Subnet's admins must add the NodeID of your validator to the Subnet's allow list by calling `addValidator` with your NodeID. @@ -358,7 +358,7 @@ This command currently only supports Subnets deployed on the Fuji Testnet and Ma **Usage**: ```bash -avalanche subnet join [subnetName] [flags] +avalanche blockchain join [subnetName] [flags] ``` **Flags**: @@ -380,12 +380,12 @@ avalanche subnet join [subnetName] [flags] ### Subnet List[​](#subnet-list "Direct link to heading") -The `subnet list` command prints the names of all created Subnet configurations. Without any flags, it prints some general, static information about the Subnet. With the `--deployed` flag, the command shows additional information including the VMID, BlockchainID and SubnetID. +The `blockchain list` command prints the names of all created Subnet configurations. Without any flags, it prints some general, static information about the Subnet. With the `--deployed` flag, the command shows additional information including the VMID, BlockchainID and SubnetID. **Usage**: ```bash -avalanche subnet list [flags] +avalanche blockchain list [flags] ``` **Flags**: @@ -397,12 +397,12 @@ avalanche subnet list [flags] ### Subnet Publish[​](#subnet-publish "Direct link to heading") -The `subnet publish` command publishes the Subnet's VM to a repository. +The `blockchain publish` command publishes the Subnet's VM to a repository. **Usage**: ```bash -avalanche subnet publish [subnetName] [flags] +avalanche blockchain publish [subnetName] [flags] ``` **Flags**: @@ -419,12 +419,12 @@ avalanche subnet publish [subnetName] [flags] ### Subnet Stats[​](#subnet-stats "Direct link to heading") -The `subnet stats` command prints validator statistics for the given Subnet. +The `blockchain stats` command prints validator statistics for the given Subnet. **Usage**: ```bash -avalanche subnet stats [subnetName] [flags] +avalanche blockchain stats [subnetName] [flags] ``` **Flags**: @@ -438,12 +438,12 @@ avalanche subnet stats [subnetName] [flags] ### Subnet VMID[​](#subnet-vmid "Direct link to heading") -The `subnet vmid` command prints the virtual machine ID (VMID) for the given Subnet. +The `blockchain vmid` command prints the virtual machine ID (VMID) for the given Subnet. **Usage**: ```bash -avalanche subnet vmid [subnetName] +avalanche blockchain vmid [subnetName] ``` Elastic Subnet[​](#elastic-subnet "Direct link to heading") @@ -456,7 +456,7 @@ This command transforms your permissioned Subnet into an Elastic Subnet (NOTE: t **Usage**: ```bash -avalanche subnet elastic [subnetName] [flags] +avalanche blockchain elastic [subnetName] [flags] ``` **Flags**: @@ -489,7 +489,7 @@ This command adds a node as a permissionless validator in an Elastic Subnet. **Usage**: ```bash -avalanche subnet join [subnetName] --elastic [flags] +avalanche blockchain join [subnetName] --elastic [flags] ``` **Flags**: @@ -515,7 +515,7 @@ This command delegates stake to a permissionless validator in an Elastic Subnet. **Usage**: ```bash -avalanche subnet addPermissionlessDelegator [subnetName] [flags] +avalanche blockchain addPermissionlessDelegator [subnetName] [flags] ``` **Flags**: @@ -537,7 +537,7 @@ avalanche subnet addPermissionlessDelegator [subnetName] [flags] Subnet Upgrade[​](#subnet-upgrade "Direct link to heading") ----------------------------------------------------------- -The `subnet upgrade` command suite provides a collection of tools for updating your developmental and deployed Subnets. +The `blockchain upgrade` command suite provides a collection of tools for updating your developmental and deployed Subnets. ### Subnet Upgrade Apply[​](#subnet-upgrade-apply "Direct link to heading") @@ -550,7 +550,7 @@ After you update your validator's configuration, you need to restart your valida **Usage**: ```bash -avalanche subnet upgrade apply [subnetName] [flags] +avalanche blockchain upgrade apply [subnetName] [flags] ``` **Flags**: @@ -574,7 +574,7 @@ Export the upgrade bytes file to a location of choice on disk. **Usage**: ```bash -avalanche subnet upgrade export [subnetName] [flags] +avalanche blockchain upgrade export [subnetName] [flags] ``` **Flags**: @@ -587,12 +587,12 @@ avalanche subnet upgrade export [subnetName] [flags] ### Subnet Upgrade Generate[​](#subnet-upgrade-generate "Direct link to heading") -The `subnet upgrade generate` command builds a new upgrade.json file to customize your Subnet. It guides the user through the process using an interactive wizard. +The `blockchain upgrade generate` command builds a new upgrade.json file to customize your Subnet. It guides the user through the process using an interactive wizard. **Usage**: ```bash -avalanche subnet upgrade generate [subnetName] [flags] +avalanche blockchain upgrade generate [subnetName] [flags] ``` **Flags**: @@ -608,7 +608,7 @@ Import the upgrade bytes file into the local environment. **Usage**: ```bash -avalanche subnet upgrade import [subnetName] [flags] +avalanche blockchain upgrade import [subnetName] [flags] ``` **Flags**: @@ -625,7 +625,7 @@ Print the upgrade.json file content. **Usage**: ```bash -avalanche subnet upgrade print [subnetName] [flags] +avalanche blockchain upgrade print [subnetName] [flags] ``` **Flags**: @@ -636,14 +636,14 @@ avalanche subnet upgrade print [subnetName] [flags] ### Subnet Upgrade VM[​](#subnet-upgrade-vm "Direct link to heading") -The `subnet upgrade vm` command enables the user to upgrade their Subnet's VM binary. The command can upgrade both local Subnets and publicly deployed Subnets on Fuji and Mainnet. +The `blockchain upgrade vm` command enables the user to upgrade their Subnet's VM binary. The command can upgrade both local Subnets and publicly deployed Subnets on Fuji and Mainnet. The command walks the user through an interactive wizard. The user can skip the wizard by providing command line flags. **Usage**: ```bash -avalanche subnet upgrade export [subnetName] [flags] +avalanche blockchain upgrade export [subnetName] [flags] ``` **Flags**: @@ -874,7 +874,7 @@ avalanche node stop [clusterName] [flags] (ALPHA Warning) This command is currently in experimental mode. -The `node sync` command enables all nodes in a cluster to be bootstrapped to a Subnet. You can check the Subnet bootstrap status by calling avalanche `node status --subnet ` +The `node sync` command enables all nodes in a cluster to be bootstrapped to a Subnet. You can check the Subnet bootstrap status by calling avalanche `node status --subnet ` **Usage**: @@ -902,7 +902,7 @@ The `node update` command suite provides a collection of commands for nodes to u (ALPHA Warning) This command is currently in experimental mode. -The `node update subnet` command updates all nodes in a cluster with latest Subnet configuration and You can check the updated Subnet bootstrap status by calling avalanche `node status --subnet ` +The `node update subnet` command updates all nodes in a cluster with latest Subnet configuration and You can check the updated Subnet bootstrap status by calling avalanche `node status --subnet ` **Usage**: @@ -958,7 +958,7 @@ avalanche node validate primary [clusterName] [flags] (ALPHA Warning) This command is currently in experimental mode. -The `node validate subnet` command enables all nodes in a cluster to be validators of a Subnet. If the command is run before the nodes are Primary Network validators, the command will first make the nodes Primary Network validators before making them Subnet validators. If The command is run before the nodes are bootstrapped on the Primary Network, the command will fail. You can check the bootstrap status by calling `avalanche node status `. If The command is run before the nodes are synced to the Subnet, the command will fail. You can check the Subnet sync status by calling `avalanche node status --subnet `. +The `node validate subnet` command enables all nodes in a cluster to be validators of a Subnet. If the command is run before the nodes are Primary Network validators, the command will first make the nodes Primary Network validators before making them Subnet validators. If The command is run before the nodes are bootstrapped on the Primary Network, the command will fail. You can check the bootstrap status by calling `avalanche node status `. If The command is run before the nodes are synced to the Subnet, the command will fail. You can check the Subnet sync status by calling `avalanche node status --subnet `. **Usage**: @@ -1084,7 +1084,7 @@ Network[​](#network "Direct link to heading") The `network` command suite provides a collection of tools for managing local Subnet deployments. -When you deploy a Subnet locally, it runs on a local, multi-node Avalanche network. The `subnet deploy` command starts this network in the background. This command suite allows you to shutdown, restart, and clear that network. +When you deploy a Subnet locally, it runs on a local, multi-node Avalanche network. The `blockchain deploy` command starts this network in the background. This command suite allows you to shutdown, restart, and clear that network. This network currently supports multiple, concurrently deployed Subnets. diff --git a/content/docs/subnets/build-first-subnet.mdx b/content/docs/subnets/build-first-subnet.mdx index dd1b5246ab7..dc711b4c2d7 100644 --- a/content/docs/subnets/build-first-subnet.mdx +++ b/content/docs/subnets/build-first-subnet.mdx @@ -35,10 +35,10 @@ This tutorials teaches you how to create an Ethereum Virtual Machine (EVM) based The Subnet command suite provides a collection of tools for developing and deploying Subnets. -The Subnet Creation Wizard walks you through the process of creating your Subnet. To get started, first pick a name for your Subnet. This tutorial uses `mySubnet`, but feel free to substitute that with any name you like. Once you've picked your name, run: +The Subnet Creation Wizard walks you through the process of creating your Subnet. To get started, first pick a name for your Subnet. This tutorial uses `myblockchain`, but feel free to substitute that with any name you like. Once you've picked your name, run: ```bash -avalanche blockchain create mySubnet +avalanche blockchain create myblockchain ``` The following sections walk through each question in the wizard. @@ -91,10 +91,10 @@ Deploying Subnets Locally[​](#deploying-subnets-locally "Direct link to headin To deploy your Subnet, run: ```bash -avalanche blockchain deploy mySubnet +avalanche blockchain deploy myblockchain ``` -Make sure to substitute the name of your Subnet if you used a different one than `mySubnet`. +Make sure to substitute the name of your Subnet if you used a different one than `myblockchain`. Next, select `Local Network`. @@ -105,11 +105,11 @@ Note: If you run `bash` on your shell and are running Avalanche-CLI on ARM64 on If all works as expected, the command output should look something like this: ```bash -avalanche blockchain deploy mySubnet +avalanche blockchain deploy myblockchain # output ✔ Local Network -Deploying [mySubnet] to Local Network +Deploying [myblockchain] to Local Network Installing subnet-evm-v0.4.3... subnet-evm-v0.4.3 installation successful Backend controller started, pid: 93928, output at: /Users/subnet-developer/.avalanche-cli/runs/server_20221122_173138/avalanche-cli-backend @@ -124,21 +124,21 @@ Network ready to use. Local network node endpoints: +-------+----------+------------------------------------------------------------------------------------+ | NODE | VM | URL | +-------+----------+------------------------------------------------------------------------------------+ -| node2 | mySubnet | http://127.0.0.1:9652/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node2 | myblockchain | http://127.0.0.1:9652/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node3 | mySubnet | http://127.0.0.1:9654/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node3 | myblockchain | http://127.0.0.1:9654/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node4 | mySubnet | http://127.0.0.1:9656/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node4 | myblockchain | http://127.0.0.1:9656/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node5 | mySubnet | http://127.0.0.1:9658/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node5 | myblockchain | http://127.0.0.1:9658/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node1 | mySubnet | http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node1 | myblockchain | http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ Browser Extension connection details (any node URL from above works): RPC URL: http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc Funded address: 0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC with 1000000 (10^18) - private key: 56289e99c94b6912bfc12adc093c9b51124f0dc54ac7a766b2bc5ccf558d8027 -Network name: mySubnet +Network name: myblockchain Chain ID: 54325 Currency Symbol: TUTORIAL ``` @@ -158,7 +158,7 @@ To allow API calls from other machines, use `--http-host=0.0.0.0` in the config. Browser Extension connection details (any node URL from above works): RPC URL: http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc Funded address: 0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC with 1000000 (10^18) - private key: 56289e99c94b6912bfc12adc093c9b51124f0dc54ac7a766b2bc5ccf558d8027 -Network name: mySubnet +Network name: myblockchain Chain ID: 54325 Currency Symbol: TUTORIAL ``` diff --git a/content/docs/subnets/deploy-a-subnet/avalanche-mainnet.mdx b/content/docs/subnets/deploy-a-subnet/avalanche-mainnet.mdx index 35308b60e27..0f8cfd3ba07 100644 --- a/content/docs/subnets/deploy-a-subnet/avalanche-mainnet.mdx +++ b/content/docs/subnets/deploy-a-subnet/avalanche-mainnet.mdx @@ -217,7 +217,7 @@ See [here](/nodes/validate/node-validator#add-a-validator-with-core-extension) o First, request permission to validate by running the `join` command along with the Subnet name: ```bash -avalanche subnet join testsubnet +avalanche blockchain join testsubnet ``` Note: Running `join` does not guarantee that your node is a validator of the Subnet! The owner of the Subnet must approve your node to be a validator afterwards by calling `addValidator` as described in the next section. @@ -334,7 +334,7 @@ Now that the node has joined the Subnet, a Subnet control key holder must call ` To whitelist a node as a recognized validator on the Subnet, run: ```bash -avalanche subnet addValidator testsubnet +avalanche blockchain addValidator testsubnet ``` You need to repeat this process for every validator you add to the network. @@ -488,7 +488,7 @@ Subnet Export[​](#subnet-export "Direct link to heading") Because you need to setup multiple validators on multiple different machines, you need to export your Subnet's configuration and import it on each validator. ```bash -avalanche subnet export testsubnet +avalanche blockchain export testsubnet ✔ Enter file path to write export data to: /tmp/testsubnet-export.dat ``` @@ -500,14 +500,14 @@ Subnet Import[​](#subnet-import "Direct link to heading") To import a VM configuration, move the file you exported in the previous section to your desired machine and issue the `import` command with the path to the file. ```bash -avalanche subnet import /tmp/testsubnet-export.dat +avalanche blockchain import /tmp/testsubnet-export.dat Subnet imported successfully ``` After this the whole Subnet configuration should be available on the target machine: ```bash -avalanche subnet list +avalanche blockchain list +---------------+---------------+----------+-----------+----------+ | SUBNET | CHAIN | CHAIN ID | TYPE | DEPLOYED | +---------------+---------------+----------+-----------+----------+ diff --git a/content/docs/subnets/deploy-a-subnet/custom-virtual-machine.mdx b/content/docs/subnets/deploy-a-subnet/custom-virtual-machine.mdx index e46f15ca48e..2bc7f6e4f7f 100644 --- a/content/docs/subnets/deploy-a-subnet/custom-virtual-machine.mdx +++ b/content/docs/subnets/deploy-a-subnet/custom-virtual-machine.mdx @@ -104,10 +104,10 @@ timestamp when you create your genesis file. Create the Subnet Configuration[​](#create-the-subnet-configuration "Direct link to heading") --------------------------------------------------------------------------------------------- -Now that you have your binary, it's time to create the Subnet configuration. This tutorial uses `myCustomSubnet` as it Subnet name. Invoke the Subnet Creation Wizard with this command: +Now that you have your binary, it's time to create the Subnet configuration. This tutorial uses `myblockchain` as it Subnet name. Invoke the Subnet Creation Wizard with this command: ```bash -avalanche blockchain create myCustomSubnet +avalanche blockchain create myblockchain ``` ### Choose Your VM[​](#choose-your-vm "Direct link to heading") @@ -146,9 +146,10 @@ Now it's time to deploy it. Deploy the Subnet Locally[​](#deploy-the-subnet-locally "Direct link to heading") --------------------------------------------------------------------------------- -To deploy your Subnet, run: `avalanche blockchain deploy myCustomSubnet` +To deploy your Subnet, run: `avalanche blockchain deploy myblockchain` -Make sure to substitute the name of your Subnet if you used a different one than `myCustomSubnet`. + +Make sure to substitute the name of your Subnet if you used a different one than `myblockchain`. Next, select `Local Network`: @@ -165,9 +166,10 @@ This command boots a five node Avalanche network on your machine. It needs to do If all works as expected, the command output should look something like this: ```bash -> avalanche blockchain deploy myCustomSubnet +> avalanche blockchain deploy myblockchain + ✔ Local Network -Deploying [myCustomSubnet] to Local Network +Deploying [myblockchain] to Local Network Backend controller started, pid: 26110, output at: /home/fm/.avalanche-cli/runs/server_20230816_131014/avalanche-cli-backend.log Installing avalanchego-v1.10.8... avalanchego-v1.10.8 installation successful @@ -181,15 +183,15 @@ Network ready to use. Local network node endpoints: +-------+----------------+------------------------------------------------------------------------------------+-------------------------------------------------+ | NODE | VM | URL | ALIAS URL | +-------+----------------+------------------------------------------------------------------------------------+-------------------------------------------------+ -| node1 | myCustomSubnet | http://127.0.0.1:9650/ext/bc/z9a7L6XmFYskbaHuuLFCxThByKg4xqsYYbaqT5ke6xVutDQTp/rpc | http://127.0.0.1:9650/ext/bc/myCustomSubnet/rpc | +| node1 | myblockchain | http://127.0.0.1:9650/ext/bc/z9a7L6XmFYskbaHuuLFCxThByKg4xqsYYbaqT5ke6xVutDQTp/rpc | http://127.0.0.1:9650/ext/bc/myblockchain/rpc | +-------+----------------+------------------------------------------------------------------------------------+-------------------------------------------------+ -| node2 | myCustomSubnet | http://127.0.0.1:9652/ext/bc/z9a7L6XmFYskbaHuuLFCxThByKg4xqsYYbaqT5ke6xVutDQTp/rpc | http://127.0.0.1:9652/ext/bc/myCustomSubnet/rpc | +| node2 | myblockchain | http://127.0.0.1:9652/ext/bc/z9a7L6XmFYskbaHuuLFCxThByKg4xqsYYbaqT5ke6xVutDQTp/rpc | http://127.0.0.1:9652/ext/bc/myblockchain/rpc | +-------+----------------+------------------------------------------------------------------------------------+-------------------------------------------------+ -| node3 | myCustomSubnet | http://127.0.0.1:9654/ext/bc/z9a7L6XmFYskbaHuuLFCxThByKg4xqsYYbaqT5ke6xVutDQTp/rpc | http://127.0.0.1:9654/ext/bc/myCustomSubnet/rpc | +| node3 | myblockchain | http://127.0.0.1:9654/ext/bc/z9a7L6XmFYskbaHuuLFCxThByKg4xqsYYbaqT5ke6xVutDQTp/rpc | http://127.0.0.1:9654/ext/bc/myblockchain/rpc | +-------+----------------+------------------------------------------------------------------------------------+-------------------------------------------------+ -| node4 | myCustomSubnet | http://127.0.0.1:9656/ext/bc/z9a7L6XmFYskbaHuuLFCxThByKg4xqsYYbaqT5ke6xVutDQTp/rpc | http://127.0.0.1:9656/ext/bc/myCustomSubnet/rpc | +| node4 | myblockchain | http://127.0.0.1:9656/ext/bc/z9a7L6XmFYskbaHuuLFCxThByKg4xqsYYbaqT5ke6xVutDQTp/rpc | http://127.0.0.1:9656/ext/bc/myblockchain/rpc | +-------+----------------+------------------------------------------------------------------------------------+-------------------------------------------------+ -| node5 | myCustomSubnet | http://127.0.0.1:9658/ext/bc/z9a7L6XmFYskbaHuuLFCxThByKg4xqsYYbaqT5ke6xVutDQTp/rpc | http://127.0.0.1:9658/ext/bc/myCustomSubnet/rpc | +| node5 | myblockchain | http://127.0.0.1:9658/ext/bc/z9a7L6XmFYskbaHuuLFCxThByKg4xqsYYbaqT5ke6xVutDQTp/rpc | http://127.0.0.1:9658/ext/bc/myblockchain/rpc | +-------+----------------+------------------------------------------------------------------------------------+-------------------------------------------------+ Browser Extension connection details (any node URL from above works): @@ -245,7 +247,7 @@ Your results may be slightly different, but you can see that in addition to the If you used the default genesis, your custom VM has a prefunded address. You can verify its balance with a curl command. Make sure to substitute the command's URL with the `RPC URL` from your deployment output. ```bash -curl --location --request POST 'http://127.0.0.1:9650/ext/bc/myCustomSubnet/rpc' \ +curl --location --request POST 'http://127.0.0.1:9650/ext/bc/myblockchain/rpc' \ --header 'Content-Type: application/json' \ --data-raw '{ "jsonrpc": "2.0", diff --git a/content/docs/subnets/deploy-a-subnet/fuji-testnet.mdx b/content/docs/subnets/deploy-a-subnet/fuji-testnet.mdx index fa9c2e7533e..b49a90466e4 100644 --- a/content/docs/subnets/deploy-a-subnet/fuji-testnet.mdx +++ b/content/docs/subnets/deploy-a-subnet/fuji-testnet.mdx @@ -178,7 +178,7 @@ Create an EVM Subnet[​](#create-an-evm-subnet "Direct link to heading") Creating a Subnet with `Avalanche-CLI` for `Fuji` works the same way as with a local network. In fact, the `create` commands only creates a specification of your Subnet on the local file system. Afterwards the Subnet needs to be _deployed_. This allows to reuse configs, by creating the config with the `create` command, then first deploying to a local network and successively to `Fuji` - and eventually to `Mainnet`. -To create an EVM Subnet, run the `subnet create` command with a name of your choice: +To create an EVM Subnet, run the `blockchain create` command with a name of your choice: ```bash avalanche blockchain create testsubnet @@ -345,7 +345,7 @@ No precompiles set Also you can list the available Subnets: ```bash -avalanche subnet list +avalanche blockchain list go run main.go subnet list +-------------+-------------+----------+---------------------------------------------------+------------+-----------+ | SUBNET | CHAIN | CHAIN ID | VM ID | TYPE | FROM REPO | @@ -357,7 +357,7 @@ go run main.go subnet list List deployed information: ```bash -avalanche subnet list --deployed +avalanche blockchain list --deployed go run main.go subnet list --deployed +-------------+-------------+---------------------------------------------------+---------------+-----------------------------------------------------------------+---------+ | SUBNET | CHAIN | VM ID | LOCAL NETWORK | FUJI (TESTNET) | MAINNET | @@ -478,7 +478,7 @@ See [here](/nodes/validate/node-validator#add-a-validator-with-core-extension) o First, request permission to validate by running the `join` command along with the Subnet name: ```bash -avalanche subnet join testsubnet +avalanche blockchain join testsubnet ``` Note: Running `join` does not guarantee that your node is a validator of the Subnet! The owner of the Subnet must approve your node to be a validator afterwards by calling `addValidator` as described in the next section. @@ -580,7 +580,7 @@ Now that the node has joined the Subnet, a Subnet control key holder must call ` To whitelist a node as a recognized validator on the Subnet, run: ```bash -avalanche subnet addValidator testsubnet +avalanche blockchain addValidator testsubnet ``` As this operation involves a new transaction, you will need to specify which private key to use: @@ -680,7 +680,7 @@ Subnet Export[​](#subnet-export "Direct link to heading") This tool is most useful on the machine where a validator is or is going to be running. In order to allow a VM to run on a different machine, you can export the configuration. Just need to provide a path to where to export the data: ```bash -avalanche subnet export testsubnet +avalanche blockchain export testsubnet ✔ Enter file path to write export data to: /tmp/testsubnet-export.dat ``` @@ -692,14 +692,14 @@ Subnet Import[​](#subnet-import "Direct link to heading") To import a VM specification exported in the previous section, just issue the `import` command with the path to the file after having copied the file over: ```bash -avalanche subnet import /tmp/testsubnet-export.dat +avalanche blockchain import /tmp/testsubnet-export.dat Subnet imported successfully ``` After this the whole Subnet configuration should be available on the target machine: ```bash -avalanche subnet list +avalanche blockchain list +---------------+---------------+----------+-----------+----------+ | SUBNET | CHAIN | CHAIN ID | TYPE | DEPLOYED | +---------------+---------------+----------+-----------+----------+ diff --git a/content/docs/subnets/deploy-a-subnet/local-network.mdx b/content/docs/subnets/deploy-a-subnet/local-network.mdx index 560084a0c80..f93fc9866ac 100644 --- a/content/docs/subnets/deploy-a-subnet/local-network.mdx +++ b/content/docs/subnets/deploy-a-subnet/local-network.mdx @@ -10,18 +10,18 @@ description: This guide focuses on taking an already created Subnet configuratio ## Deploying Subnets Locally -In the following commands, make sure to substitute the name of your Subnet configuration for ``. +In the following commands, make sure to substitute the name of your Subnet configuration for ``. To deploy your Subnet, run ```bash -avalanche blockchain deploy +avalanche blockchain deploy ``` and, select `Local Network` to deploy on. Alternatively, you can bypass this prompt by providing the `--local` flag. For example: ```bash -avalanche blockchain deploy --local +avalanche blockchain deploy --local ``` The command may take a couple minutes to run. @@ -35,9 +35,10 @@ If you run `bash` on your shell and are running Avalanche-CLI on ARM64 on Mac, y If all works as expected, the command output should look something like this: ```bash -> avalanche blockchain deploy mySubnet +> avalanche blockchain deploy myblockchain + ✔ Local Network -Deploying [mySubnet] to Local Network +Deploying [myblockchain] to Local Network Installing subnet-evm-v0.4.3... subnet-evm-v0.4.3 installation successful Backend controller started, pid: 93928, output at: /Users/subnet-developer/.avalanche-cli/runs/server_20221122_173138/avalanche-cli-backend @@ -52,21 +53,21 @@ Network ready to use. Local network node endpoints: +-------+----------+------------------------------------------------------------------------------------+ | NODE | VM | URL | +-------+----------+------------------------------------------------------------------------------------+ -| node2 | mySubnet | http://127.0.0.1:9652/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node2 | myblockchain | http://127.0.0.1:9652/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node3 | mySubnet | http://127.0.0.1:9654/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node3 | myblockchain | http://127.0.0.1:9654/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node4 | mySubnet | http://127.0.0.1:9656/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node4 | myblockchain | http://127.0.0.1:9656/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node5 | mySubnet | http://127.0.0.1:9658/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node5 | myblockchain | http://127.0.0.1:9658/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node1 | mySubnet | http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node1 | myblockchain | http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ Browser Extension connection details (any node URL from above works): RPC URL: http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc Funded address: 0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC with 1000000 (10^18) - private key: 56289e99c94b6912bfc12adc093c9b51124f0dc54ac7a766b2bc5ccf558d8027 -Network name: mySubnet +Network name: myblockchain Chain ID: 54325 Currency Symbol: TUTORIAL ``` @@ -86,5 +87,5 @@ To redeploy the Subnet, you first need to wipe the Subnet state. This permanentl You are now free to redeploy your Subnet with: ```bash -avalanche blockchain deploy --local +avalanche blockchain deploy --local ``` diff --git a/content/docs/subnets/deploy-a-subnet/multisig-auth.mdx b/content/docs/subnets/deploy-a-subnet/multisig-auth.mdx index a97e7ea70d2..d5192171a54 100644 --- a/content/docs/subnets/deploy-a-subnet/multisig-auth.mdx +++ b/content/docs/subnets/deploy-a-subnet/multisig-auth.mdx @@ -303,7 +303,7 @@ Add Validators Using the Multisig[​](#add-validators-using-the-multisig "Direc The `addValidator` command also requires use of the multisig. Before starting, make sure to connect, unlock, and run the Avalanche Ledger app. ```bash -avalanche subnet addValidator testsubnet +avalanche blockchain addValidator testsubnet ``` ### Select Network[​](#select-network "Direct link to heading") diff --git a/content/docs/subnets/elastic-subnets/make-subnet-permissionless.mdx b/content/docs/subnets/elastic-subnets/make-subnet-permissionless.mdx index 75c9ffd7aea..8117d476098 100644 --- a/content/docs/subnets/elastic-subnets/make-subnet-permissionless.mdx +++ b/content/docs/subnets/elastic-subnets/make-subnet-permissionless.mdx @@ -15,12 +15,12 @@ This how-to guide focuses on taking an already created permissioned Subnet and t Getting Started[​](#getting-started "Direct link to heading") ------------------------------------------------------------- -In the following commands, make sure to substitute the name of your Subnet configuration for ``. +In the following commands, make sure to substitute the name of your Subnet configuration for ``. To transform your permissioned Subnet into an Elastic Subnet (NOTE: this action is irreversible), run: ```bash -avalanche subnet elastic +avalanche subnet elastic ``` and, select the network that you want to transform the Subnet on. Alternatively, you can bypass this prompt by providing the `--local`, `--fuji`, or `--mainnet` flag. @@ -50,12 +50,12 @@ You can use the output details such as the Asset ID and Elastic Subnet ID to con Adding Permissionless Validators to Elastic Subnet[​](#adding-permissionless-validators-to-elastic-subnet "Direct link to heading") ----------------------------------------------------------------------------------------------------------------------------------- -If you are running this command on local network, you will need to first remove permissioned validators (by running `avalanche subnet removeValidator `) so that you can have a list of local nodes to choose from to be added as a permissionless validator in the Elastic Subnet. +If you are running this command on local network, you will need to first remove permissioned validators (by running `avalanche subnet removeValidator `) so that you can have a list of local nodes to choose from to be added as a permissionless validator in the Elastic Subnet. To add permissionless validators to an Elastic Subnet, run: ```bash -avalanche subnet join --elastic +avalanche subnet join --elastic ``` You will be prompted with which node you would like to add as a permissionless validator. You can skip this prompt by using `--nodeID` flag. @@ -70,7 +70,7 @@ Adding Permissionless Delegator to a Permissionless Validator in Elastic Subnet[ To add permissionless delegators, run: ```bash -avalanche subnet addPermissionlessDelegator +avalanche subnet addPermissionlessDelegator ``` You will be prompted with which Subnet validator you would like to delegate to. You can skip this prompt by using `--nodeID` flag. diff --git a/content/docs/subnets/maintain/delete-subnet.mdx b/content/docs/subnets/maintain/delete-subnet.mdx index 03f244ca806..39a01841564 100644 --- a/content/docs/subnets/maintain/delete-subnet.mdx +++ b/content/docs/subnets/maintain/delete-subnet.mdx @@ -9,7 +9,7 @@ Deleting a Subnet Configuration[​](#deleting-a-subnet-configuration "Direct li To delete a created Subnet configuration, run: ```bash -avalanche subnet delete +avalanche blockchain delete ``` Deleting a Deployed Subnet[​](#deleting-a-deployed-subnet "Direct link to heading") diff --git a/content/docs/subnets/maintain/pause-resume.mdx b/content/docs/subnets/maintain/pause-resume.mdx index b75de9ce27e..98a1abeb21b 100644 --- a/content/docs/subnets/maintain/pause-resume.mdx +++ b/content/docs/subnets/maintain/pause-resume.mdx @@ -32,15 +32,15 @@ Network ready to use. Local network node endpoints: +-------+----------+------------------------------------------------------------------------------------+ | NODE | VM | URL | +-------+----------+------------------------------------------------------------------------------------+ -| node5 | mySubnet | http://127.0.0.1:9658/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node5 | myblockchain | http://127.0.0.1:9658/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node1 | mySubnet | http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node1 | myblockchain | http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node2 | mySubnet | http://127.0.0.1:9652/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node2 | myblockchain | http://127.0.0.1:9652/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node3 | mySubnet | http://127.0.0.1:9654/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node3 | myblockchain | http://127.0.0.1:9654/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node4 | mySubnet | http://127.0.0.1:9656/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node4 | myblockchain | http://127.0.0.1:9656/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ ``` diff --git a/content/docs/subnets/maintain/view-subnets.mdx b/content/docs/subnets/maintain/view-subnets.mdx index f2b1e6a6562..3a95b206f99 100644 --- a/content/docs/subnets/maintain/view-subnets.mdx +++ b/content/docs/subnets/maintain/view-subnets.mdx @@ -4,7 +4,7 @@ description: Learn how to view Subnets deployed using Avalanche-CLI. --- ```bash -avalanche subnet list +avalanche blockchain list # output +-------------+-------------+----------+---------------------------------------------------+------------+-----------+ @@ -17,7 +17,7 @@ avalanche subnet list To see detailed information about your deployed Subnets, add the `--deployed` flag: ```bash -avalanche subnet list --deployed +avalanche blockchain list --deployed # output +-------------+-------------+---------------------------------------------------+---------------+-----------------------------------------------------------------+---------+ @@ -30,7 +30,7 @@ avalanche subnet list --deployed ``` ```bash -avalanche blockchain describe firstsubnet +avalanche blockchain describe myblockchain #output _____ _ _ _ @@ -42,7 +42,7 @@ avalanche blockchain describe firstsubnet +----------------------------+----------------------------------------------------+ | PARAMETER | VALUE | +----------------------------+----------------------------------------------------+ -| Subnet Name | firstsubnet | +| Subnet Name | myblockchain | +----------------------------+----------------------------------------------------+ | ChainID | 12345 | +----------------------------+----------------------------------------------------+ @@ -117,7 +117,7 @@ No precompiles set If you'd like to see the raw genesis file, supply the `--genesis` flag to the describe command: ```bash -avalanche blockchain describe firstsubnet --genesis +avalanche blockchain describe myblockchain --genesis # output { diff --git a/content/docs/subnets/troubleshooting.mdx b/content/docs/subnets/troubleshooting.mdx index 70d1ec73587..1210bddd08f 100644 --- a/content/docs/subnets/troubleshooting.mdx +++ b/content/docs/subnets/troubleshooting.mdx @@ -9,9 +9,10 @@ Deployment Times Out[​](#deployment-times-out "Direct link to heading") During a local deployment, your network may fail to start. Your error may look something like this: ```bash -[~]$ avalanche blockchain deploy mySubnet +[~]$ avalanche blockchain deploy myblockchain + ✔ Local Network -Deploying [mySubnet] to Local Network +Deploying [myblockchain] to Local Network Backend controller started, pid: 26388, output at: /Users/user/.avalanche-cli/runs/server_20221231_111605/avalanche-cli-backend VMs ready. Starting network... @@ -47,9 +48,10 @@ Incompatible RPC Version for Custom VM[​](#incompatible-rpc-version-for-custom If you're locally deploying a custom VM, you may run into this error message. ```bash -[~]$ avalanche blockchain deploy mySubnet +[~]$ avalanche blockchain deploy myblockchain + ✔ Local Network -Deploying [mySubnet] to Local Network +Deploying [myblockchain] to Local Network Backend controller started, pid: 26388, output at: /Users/user/.avalanche-cli/runs/server_20221231_111605/avalanche-cli-backend VMs ready. Starting network... @@ -82,7 +84,7 @@ This error occurs when the RPCChainVM protocol version used by VMs like Subnet-E If your VM has an RPC version mismatch, you have two options: 1. Update the version of AvalancheGo you use in your VM. This is the correct long-term approach. -2. Use Avalanche-CLI to deploy an older version of AvalancheGo by using the `--avalanchego-version` flag. Both the [`subnet deploy`](/tooling/avalanche-cli#subnet-deploy) and [`network start`](/tooling/avalanche-cli#network-start) commands support setting the AvalancheGo version explicitly. +2. Use Avalanche-CLI to deploy an older version of AvalancheGo by using the `--avalanchego-version` flag. Both the [`blockchain deploy`](/tooling/avalanche-cli#subnet-deploy) and [`network start`](/tooling/avalanche-cli#network-start) commands support setting the AvalancheGo version explicitly. Although it's very important to keep your version of AvalancheGo up-to-date, this workaround helps you avoid broken builds in the short term. diff --git a/content/docs/subnets/upgrade/subnet-precompile-config.mdx b/content/docs/subnets/upgrade/subnet-precompile-config.mdx index 03f8b1925a1..20c4fd3085b 100644 --- a/content/docs/subnets/upgrade/subnet-precompile-config.mdx +++ b/content/docs/subnets/upgrade/subnet-precompile-config.mdx @@ -23,13 +23,13 @@ The [Precompiles](/subnets/upgrade/customize-subnet#network-upgrades-enabledisab To generate a valid `upgrade.json` file, run: ```bash -avalanche subnet upgrade generate testSubnet +avalanche blockchain upgrade generate testSubnet ``` If you didn't create `testSubnet` yet, you would see this result: ```bash -avalanche subnet upgrade generate testSubnet +avalanche blockchain upgrade generate testSubnet The provided subnet name "testSubnet" does not exist ``` @@ -38,7 +38,7 @@ Again, it makes no sense to try the upgrade command if the Subnet doesn't exist. If the Subnet definition exists, the tool launches a wizard. It may feel a bit redundant, but you first see some warnings, to draw focus to the dangers involved: ```bash -avalanche subnet upgrade generate testSubnet +avalanche blockchain upgrade generate testSubnet Performing a network upgrade requires coordinating the upgrade network-wide. A network upgrade changes the rule set used to process and verify blocks, such that any node that upgrades incorrectly or fails to upgrade by the time that upgrade goes into effect may become @@ -229,16 +229,16 @@ If the preceding requirements aren't met, the network upgrade command fails. Therefore, to apply your generated or imported upgrade configuration: ```bash -avalanche subnet upgrade apply testSubnet +avalanche blockchain upgrade apply testSubnet ``` A number of checks run. For example, if you created the Subnet but didn't deploy it locally: ```bash -avalanche subnet upgrade apply testSubnet +avalanche blockchain upgrade apply testSubnet Error: no deployment target available Usage: - avalanche subnet upgrade apply [subnetName] [flags] + avalanche blockchain upgrade apply [subnetName] [flags] Flags: --avalanchego-chain-config-dir string avalanchego's chain config file directory (default "/home/fabio/.avalanchego/chains") @@ -259,7 +259,7 @@ Go ahead and [deploy](/subnets/deploy-a-subnet/local-network) first your Subnet If you already had deployed the Subnet instead, you see something like this: ```bash -avalanche subnet upgrade apply testSubnet +avalanche blockchain upgrade apply testSubnet Use the arrow keys to navigate: ↓ ↑ → ← ? What deployment would you like to upgrade: ▸ Existing local deployment @@ -299,7 +299,7 @@ For this scenario to work, you should also have deployed the Subnet to the publi Assuming the Subnet has been already deployed to Fuji, when running the `apply` command, the tool notices the deployment: ```bash -avalanche subnet upgrade apply testSubnet +avalanche blockchain upgrade apply testSubnet Use the arrow keys to navigate: ↓ ↑ → ← ? What deployment would you like to upgrade: Existing local deployment @@ -317,7 +317,7 @@ If this is the case, the tool tries to install the upgrade file at the expected If you are _not_ using default paths, you can configure the path by providing the flag `--avalanchego-chain-config-dir` to the tool. For example: ```bash -avalanche subnet upgrade apply testSubnet --avalanchego-chain-config-dir /path/to/your/chains +avalanche blockchain upgrade apply testSubnet --avalanchego-chain-config-dir /path/to/your/chains ``` Make sure to identify correctly where your chain config dir is, or the node might fail to find it. @@ -325,7 +325,7 @@ Make sure to identify correctly where your chain config dir is, or the node migh If all is correct, the file gets installed: ```bash -avalanche subnet upgrade apply testSubnet +avalanche blockchain upgrade apply testSubnet ✔ Fuji The chain config dir avalanchego uses is set at /home/fabio/.avalanchego/chains Trying to install the upgrade files at the provided /home/fabio/.avalanchego/chains path @@ -337,7 +337,7 @@ If however the node is _not_ running on this same machine where you are executin To see the instructions about how to go about this, add the `--print` flag: ```bash -avalanche subnet upgrade apply testSubnet --print +avalanche blockchain upgrade apply testSubnet --print ✔ Fuji To install the upgrade file on your validator: @@ -377,14 +377,14 @@ Export the Upgrade File[​](#export-the-upgrade-file "Direct link to heading") If you have generated the upgrade file, you can export it: ```bash -avalanche subnet upgrade export testSubnet +avalanche blockchain upgrade export testSubnet ✔ Provide a path where we should export the file to: /tmp/testSubnet-upgrade.json ``` Just provide a valid path to the prompt, and the tool exports the file there. ```bash -avalanche subnet upgrade export testSubnet +avalanche blockchain upgrade export testSubnet Provide a path where we should export the file to: /tmp/testSubnet-upgrade.json Writing the upgrade bytes file to "/tmp/testSubnet-upgrade.json"... File written successfully. @@ -400,7 +400,7 @@ You or someone else might have generated the file elsewhere, or on another machi You can import the file: ```bash -avalanche subnet upgrade import testSubnet +avalanche blockchain upgrade import testSubnet Provide the path to the upgrade file to import: /tmp/testSubnet-upgrade.json ``` diff --git a/content/docs/subnets/upgrade/subnet-virtual-machine.mdx b/content/docs/subnets/upgrade/subnet-virtual-machine.mdx index 28646b28346..58f1066cb0d 100644 --- a/content/docs/subnets/upgrade/subnet-virtual-machine.mdx +++ b/content/docs/subnets/upgrade/subnet-virtual-machine.mdx @@ -17,10 +17,10 @@ Next, you need to select the new VM to run your Subnet on. If you're running a S Start the upgrade wizard with: ```bash -avalanche subnet upgrade vm +avalanche blockchain upgrade vm ``` -where you replace `` with the name of the Subnet you would like to upgrade. +where you replace `` with the name of the Subnet you would like to upgrade. ### Selecting a VM Deployment to Upgrade[​](#selecting-a-vm-deployment-to-upgrade "Direct link to heading") diff --git a/content/docs/tooling/avalanche-cli.mdx b/content/docs/tooling/avalanche-cli.mdx index cb7bbffc914..7ab8edfd155 100644 --- a/content/docs/tooling/avalanche-cli.mdx +++ b/content/docs/tooling/avalanche-cli.mdx @@ -49,11 +49,11 @@ Subnet[​](#subnet "Direct link to heading") The `subnet` command suite provides a collection of tools for developing and deploying Subnets. -To get started, use the `subnet create` command wizard to walk through the configuration of your very first Subnet. Then, go ahead and deploy it with the `subnet deploy` command. You can use the rest of the commands to manage your Subnet configurations and live deployments. +To get started, use the `blockchain create` command wizard to walk through the configuration of your very first Subnet. Then, go ahead and deploy it with the `blockchain deploy` command. You can use the rest of the commands to manage your Subnet configurations and live deployments. ### Subnet AddValidator -The `subnet addValidator` command whitelists a primary network validator to validate the provided deployed Subnet. +The `blockchain addValidator` command whitelists a primary network validator to validate the provided deployed Subnet. To add the validator to the Subnet's allow list, you first need to provide the subnetName and the validator's unique NodeID. The command then prompts for the validation start time, duration, and stake weight. You can bypass these prompts by providing the values with flags. @@ -62,7 +62,7 @@ This command currently only works on Subnets deployed to either the Fuji Testnet **Usage**: ```bash -avalanche subnet addValidator [subnetName] [flags] +avalanche blockchain addValidator [subnetName] [flags] ``` **Flags**: @@ -95,7 +95,7 @@ This command removes a node as a validator in a Subnet. **Usage**: ```bash -avalanche subnet removeValidator [subnetName] [flags] +avalanche blockchain removeValidator [subnetName] [flags] ``` **Flags**: @@ -115,14 +115,14 @@ avalanche subnet removeValidator [subnetName] [flags] ### Subnet Change Owner -The `subnet changeOwner` changes the owner of the deployed Subnet. +The `blockchain changeOwner` changes the owner of the deployed Subnet. This command currently only works on Subnets deployed to Devnet, Fuji or Mainnet. **Usage**: ```bash -avalanche subnet changeOwner [subnetName] [flags] +avalanche blockchain changeOwner [subnetName] [flags] ``` **Flags**: @@ -153,7 +153,7 @@ AvalancheGo nodes support several different configuration files. Subnets have th **Usage**: ```bash -avalanche subnet configure [subnetName] [flags] +avalanche blockchain configure [subnetName] [flags] ``` **Flags**: @@ -167,7 +167,7 @@ avalanche subnet configure [subnetName] [flags] ### Subnet Create -The `subnet create` command builds a new genesis file to configure your Subnet. By default, the command runs an interactive wizard. It walks you through all the steps you need to create your first Subnet. +The `blockchain create` command builds a new genesis file to configure your Subnet. By default, the command runs an interactive wizard. It walks you through all the steps you need to create your first Subnet. The tool supports deploying Subnet-EVM and custom VMs. You can create a custom, user-generated genesis with a custom VM by providing the path to your genesis and VM binaries with the `--genesis` and `--vm` flags. @@ -206,12 +206,12 @@ avalanche blockchain create [subnetName] [flags] ### Subnet Delete -The `subnet delete` command deletes an existing Subnet configuration. +The `blockchain delete` command deletes an existing Subnet configuration. **Usage**: ```bash -avalanche subnet delete [flags] +avalanche blockchain delete [flags] ``` **Flags**: @@ -222,7 +222,7 @@ avalanche subnet delete [flags] ### Subnet Deploy -The `subnet deploy` command deploys your Subnet configuration locally, to Fuji Testnet, or to Mainnet. +The `blockchain deploy` command deploys your Subnet configuration locally, to Fuji Testnet, or to Mainnet. At the end of the call, the command prints the RPC URL you can use to interact with the Subnet. @@ -261,7 +261,7 @@ avalanche blockchain deploy [subnetName] [flags] ### Subnet Describe -The `subnet describe` command prints the details of a Subnet configuration to the console. By default, the command prints a summary of the configuration. By providing the `--genesis` flag, the command instead prints out the raw genesis file. +The `blockchain describe` command prints the details of a Subnet configuration to the console. By default, the command prints a summary of the configuration. By providing the `--genesis` flag, the command instead prints out the raw genesis file. **Usage**: @@ -278,14 +278,14 @@ avalanche blockchain describe [subnetName] [flags] ### Subnet Export -The `subnet export` command write the details of an existing Subnet deploy to a file. +The `blockchain export` command write the details of an existing Subnet deploy to a file. The command prompts for an output path. You can also provide one with the `--output` flag. **Usage**: ```bash -avalanche subnet export [subnetName] [flags] +avalanche blockchain export [subnetName] [flags] ``` **Flags**: @@ -297,7 +297,7 @@ avalanche subnet export [subnetName] [flags] ### Subnet Import -The `subnet import` command imports configurations into Avalanche-CLI. +The `blockchain import` command imports configurations into Avalanche-CLI. This command supports importing from a file created on another computer, or importing from Subnets running public networks (for example, created manually or with the deprecated Subnet-CLI) @@ -308,7 +308,7 @@ To import from a file, you can optionally provide the path as a command-line arg **Usage**: ```bash -avalanche subnet import file [subnetPath] [flags] +avalanche blockchain import file [subnetPath] [flags] ``` **Flags**: @@ -323,14 +323,14 @@ avalanche subnet import file [subnetPath] [flags] #### Import from a Public Network -The `subnet import public` command imports a Subnet configuration from a running network. +The `blockchain import public` command imports a Subnet configuration from a running network. The genesis file should be available from the disk for this to work. By default, an imported Subnet doesn't overwrite an existing Subnet with the same name. To allow overwrites, provide the `--force` flag. **Usage**: ```bash -avalanche subnet import public [subnetPath] [flags] +avalanche blockchain import public [subnetPath] [flags] ``` **Flags**: @@ -351,7 +351,7 @@ avalanche subnet import public [subnetPath] [flags] ### Subnet Join -The `subnet join` command configures your validator node to begin validating a new Subnet. +The `blockchain join` command configures your validator node to begin validating a new Subnet. To complete this process, you must have access to the machine running your validator. If the CLI is running on the same machine as your validator, it can generate or update your node's config file automatically. Alternatively, the command can print the necessary instructions to update your node manually. To complete the validation process, the Subnet's admins must add the NodeID of your validator to the Subnet's allow list by calling `addValidator` with your NodeID. @@ -362,7 +362,7 @@ This command currently only supports Subnets deployed on the Fuji Testnet and Ma **Usage**: ```bash -avalanche subnet join [subnetName] [flags] +avalanche blockchain join [subnetName] [flags] ``` **Flags**: @@ -384,12 +384,12 @@ avalanche subnet join [subnetName] [flags] ### Subnet List -The `subnet list` command prints the names of all created Subnet configurations. Without any flags, it prints some general, static information about the Subnet. With the `--deployed` flag, the command shows additional information including the VMID, BlockchainID and SubnetID. +The `blockchain list` command prints the names of all created Subnet configurations. Without any flags, it prints some general, static information about the Subnet. With the `--deployed` flag, the command shows additional information including the VMID, BlockchainID and SubnetID. **Usage**: ```bash -avalanche subnet list [flags] +avalanche blockchain list [flags] ``` **Flags**: @@ -401,12 +401,12 @@ avalanche subnet list [flags] ### Subnet Publish -The `subnet publish` command publishes the Subnet's VM to a repository. +The `blockchain publish` command publishes the Subnet's VM to a repository. **Usage**: ```bash -avalanche subnet publish [subnetName] [flags] +avalanche blockchain publish [subnetName] [flags] ``` **Flags**: @@ -423,12 +423,12 @@ avalanche subnet publish [subnetName] [flags] ### Subnet Stats -The `subnet stats` command prints validator statistics for the given Subnet. +The `blockchain stats` command prints validator statistics for the given Subnet. **Usage**: ```bash -avalanche subnet stats [subnetName] [flags] +avalanche blockchain stats [subnetName] [flags] ``` **Flags**: @@ -442,12 +442,12 @@ avalanche subnet stats [subnetName] [flags] ### Subnet VMID -The `subnet vmid` command prints the virtual machine ID (VMID) for the given Subnet. +The `blockchain vmid` command prints the virtual machine ID (VMID) for the given Subnet. **Usage**: ```bash -avalanche subnet vmid [subnetName] +avalanche blockchain vmid [subnetName] ``` Elastic Subnet[​](#elastic-subnet "Direct link to heading") @@ -460,7 +460,7 @@ This command transforms your permissioned Subnet into an Elastic Subnet (NOTE: t **Usage**: ```bash -avalanche subnet elastic [subnetName] [flags] +avalanche blockchain elastic [subnetName] [flags] ``` **Flags**: @@ -493,7 +493,7 @@ This command adds a node as a permissionless validator in an Elastic Subnet. **Usage**: ```bash -avalanche subnet join [subnetName] --elastic [flags] +avalanche blockchain join [subnetName] --elastic [flags] ``` **Flags**: @@ -519,7 +519,7 @@ This command delegates stake to a permissionless validator in an Elastic Subnet. **Usage**: ```bash -avalanche subnet addPermissionlessDelegator [subnetName] [flags] +avalanche blockchain addPermissionlessDelegator [subnetName] [flags] ``` **Flags**: @@ -541,7 +541,7 @@ avalanche subnet addPermissionlessDelegator [subnetName] [flags] Subnet Upgrade[​](#subnet-upgrade "Direct link to heading") ----------------------------------------------------------- -The `subnet upgrade` command suite provides a collection of tools for updating your developmental and deployed Subnets. +The `blockchain upgrade` command suite provides a collection of tools for updating your developmental and deployed Subnets. ### Subnet Upgrade Apply @@ -554,7 +554,7 @@ After you update your validator's configuration, you need to restart your valida **Usage**: ```bash -avalanche subnet upgrade apply [subnetName] [flags] +avalanche blockchain upgrade apply [subnetName] [flags] ``` **Flags**: @@ -578,7 +578,7 @@ Export the upgrade bytes file to a location of choice on disk. **Usage**: ```bash -avalanche subnet upgrade export [subnetName] [flags] +avalanche blockchain upgrade export [subnetName] [flags] ``` **Flags**: @@ -591,12 +591,12 @@ avalanche subnet upgrade export [subnetName] [flags] ### Subnet Upgrade Generate -The `subnet upgrade generate` command builds a new upgrade.json file to customize your Subnet. It guides the user through the process using an interactive wizard. +The `blockchain upgrade generate` command builds a new upgrade.json file to customize your Subnet. It guides the user through the process using an interactive wizard. **Usage**: ```bash -avalanche subnet upgrade generate [subnetName] [flags] +avalanche blockchain upgrade generate [subnetName] [flags] ``` **Flags**: @@ -612,7 +612,7 @@ Import the upgrade bytes file into the local environment. **Usage**: ```bash -avalanche subnet upgrade import [subnetName] [flags] +avalanche blockchain upgrade import [subnetName] [flags] ``` **Flags**: @@ -629,21 +629,21 @@ Print the upgrade.json file content. **Usage**: ```bash -avalanche subnet upgrade print [subnetName] [flags] +avalanche blockchain upgrade print [subnetName] [flags] ``` **Flags**: ### Subnet Upgrade VM -The `subnet upgrade vm` command enables the user to upgrade their Subnet's VM binary. The command can upgrade both local Subnets and publicly deployed Subnets on Fuji and Mainnet. +The `blockchain upgrade vm` command enables the user to upgrade their Subnet's VM binary. The command can upgrade both local Subnets and publicly deployed Subnets on Fuji and Mainnet. The command walks the user through an interactive wizard. The user can skip the wizard by providing command line flags. **Usage**: ```bash -avalanche subnet upgrade export [subnetName] [flags] +avalanche blockchain upgrade export [subnetName] [flags] ``` **Flags**: @@ -864,7 +864,7 @@ avalanche node stop [clusterName] [flags] (ALPHA Warning) This command is currently in experimental mode. -The `node sync` command enables all nodes in a cluster to be bootstrapped to a Subnet. You can check the Subnet bootstrap status by calling avalanche `node status --subnet ` +The `node sync` command enables all nodes in a cluster to be bootstrapped to a Subnet. You can check the Subnet bootstrap status by calling avalanche `node status --subnet ` **Usage**: @@ -886,7 +886,7 @@ The `node update` command suite provides a collection of commands for nodes to u (ALPHA Warning) This command is currently in experimental mode. -The `node update subnet` command updates all nodes in a cluster with latest Subnet configuration and You can check the updated Subnet bootstrap status by calling avalanche `node status --subnet ` +The `node update subnet` command updates all nodes in a cluster with latest Subnet configuration and You can check the updated Subnet bootstrap status by calling avalanche `node status --subnet ` **Usage**: @@ -944,7 +944,7 @@ avalanche node validate primary [clusterName] [flags] (ALPHA Warning) This command is currently in experimental mode. -The `node validate subnet` command enables all nodes in a cluster to be validators of a Subnet. If the command is run before the nodes are Primary Network validators, the command will first make the nodes Primary Network validators before making them Subnet validators. If The command is run before the nodes are bootstrapped on the Primary Network, the command will fail. You can check the bootstrap status by calling `avalanche node status `. If The command is run before the nodes are synced to the Subnet, the command will fail. You can check the Subnet sync status by calling `avalanche node status --subnet `. +The `node validate subnet` command enables all nodes in a cluster to be validators of a Subnet. If the command is run before the nodes are Primary Network validators, the command will first make the nodes Primary Network validators before making them Subnet validators. If The command is run before the nodes are bootstrapped on the Primary Network, the command will fail. You can check the bootstrap status by calling `avalanche node status `. If The command is run before the nodes are synced to the Subnet, the command will fail. You can check the Subnet sync status by calling `avalanche node status --subnet `. **Usage**: @@ -1075,7 +1075,7 @@ Network[​](#network "Direct link to heading") The `network` command suite provides a collection of tools for managing local Subnet deployments. -When you deploy a Subnet locally, it runs on a local, multi-node Avalanche network. The `subnet deploy` command starts this network in the background. This command suite allows you to shutdown, restart, and clear that network. +When you deploy a Subnet locally, it runs on a local, multi-node Avalanche network. The `blockchain deploy` command starts this network in the background. This command suite allows you to shutdown, restart, and clear that network. This network currently supports multiple, concurrently deployed Subnets. diff --git a/content/docs/tooling/create-avalanche-nodes/deploy-custom-vm.mdx b/content/docs/tooling/create-avalanche-nodes/deploy-custom-vm.mdx index 58ae8351372..ae48f71c35f 100644 --- a/content/docs/tooling/create-avalanche-nodes/deploy-custom-vm.mdx +++ b/content/docs/tooling/create-avalanche-nodes/deploy-custom-vm.mdx @@ -85,10 +85,10 @@ Save it into a file with path `` (for example `~/morpheusvm_genesis Create the Subnet[​](#create-the-subnet "Direct link to heading") ----------------------------------------------------------------- -Let's create a Subnet called ``, with custom VM binary and genesis. +Let's create a Subnet called ``, with custom VM binary and genesis. ```bash -avalanche blockchain create +avalanche blockchain create ``` Choose custom @@ -131,7 +131,7 @@ Successfully created subnet configuration For this example, we will deploy the Subnet and blockchain on Fuji. Run: ```bash -avalanche blockchain deploy +avalanche blockchain deploy ``` Choose Fuji: @@ -181,7 +181,7 @@ Now creating blockchain... +--------------------+----------------------------------------------------+ | DEPLOYMENT RESULTS | | +--------------------+----------------------------------------------------+ -| Chain Name | subnetName | +| Chain Name | blockchainName | +--------------------+----------------------------------------------------+ | Subnet ID | RU72cWmBmcXber6ZBPT7R5scFFuVSoFRudcS3vayf3L535ZE3 | +--------------------+----------------------------------------------------+ @@ -244,7 +244,7 @@ into a file with path `` (for example `~/morpheusvm_avago.json`) Then set the Subnet to use it by executing: ```bash -avalanche subnet configure subnetName +avalanche blockchain configure blockchainName ``` Select node-config.json: @@ -307,7 +307,7 @@ in a known file path (for example `~/morpheusvm_chain.json`): Then set the Subnet to use it by executing: ```bash -avalanche subnet configure subnetName +avalanche blockchain configure blockchainName ``` Select chain.json: @@ -352,7 +352,7 @@ in a known path (for example `~/morpheusvm_subnet.json`): Then set the Subnet to use it by executing: ```bash -avalanche subnet configure subnetName +avalanche blockchain configure blockchainName ``` Select `subnet.json`: @@ -389,7 +389,7 @@ Save the following content (currently with no network upgrades) in a known path Then set the Subnet to use it by executing: ```bash -avalanche subnet upgrade import subnetName +avalanche blockchain upgrade import blockchainName ``` Provide the path to the network upgrades file: @@ -404,7 +404,7 @@ Deploy Our Custom VM[​](#deploy-our-custom-vm "Direct link to heading") To deploy our Custom VM, run: ```bash -avalanche node sync +avalanche node sync ``` ```bash @@ -413,4 +413,4 @@ Node(s) successfully started syncing with Subnet! Your custom VM is successfully deployed! -You can also use `avalanche node update subnet ` to reinstall the binary when the branch is updated, or update the config files. \ No newline at end of file +You can also use `avalanche node update blockchain ` to reinstall the binary when the branch is updated, or update the config files. \ No newline at end of file diff --git a/content/docs/tooling/create-avalanche-nodes/run-loadtest.mdx b/content/docs/tooling/create-avalanche-nodes/run-loadtest.mdx index 1ab073104d5..a3cef1edcb7 100644 --- a/content/docs/tooling/create-avalanche-nodes/run-loadtest.mdx +++ b/content/docs/tooling/create-avalanche-nodes/run-loadtest.mdx @@ -25,7 +25,7 @@ choice. To start load test, run: ```bash -avalanche node loadtest start +avalanche node loadtest start ``` Next, you will need to provide the load test Git repository URL, load test Git Branch, the command diff --git a/content/docs/tooling/create-avalanche-nodes/setup-devnet.mdx b/content/docs/tooling/create-avalanche-nodes/setup-devnet.mdx index d67c6c3d157..1888b8b8964 100644 --- a/content/docs/tooling/create-avalanche-nodes/setup-devnet.mdx +++ b/content/docs/tooling/create-avalanche-nodes/setup-devnet.mdx @@ -40,11 +40,11 @@ Let's go through several examples with the full command (with flags) provided. For example, to spin up a Devnet with 5 validator nodes and 1 API node in 5 regions each (us-west-2,us-east-1,ap-south-1,ap-northeast-1,eu-west-1) in AWS with each node having spec of -c7g.8xlarge AWS EC2 instance type and io2 volume type, with Subnet `` deployed +c7g.8xlarge AWS EC2 instance type and io2 volume type, with Subnet `` deployed into the Devnet, we will run : ```bash -avalanche node devnet wiz --authorize-access +avalanche node devnet wiz --authorize-access --aws --num-apis 1,1,1,1,1 --num-validators 5,5,5,5,5 --region us-west-2,us-east-1,ap-south-1,ap-northeast-1,eu-west-1 --default-validator-params --node-type c7g.8xlarge --aws-volume-type=io2 @@ -62,15 +62,15 @@ Setting the nodes as subnet trackers Waiting for node(s) in cluster to be healthy... Nodes healthy after 33 seconds ... -Waiting for node(s) in cluster to be syncing subnet ... -Nodes Syncing after 5 seconds +Waiting for node(s) in cluster to be syncing subnet ... +Nodes Syncing after 5 seconds Adding nodes as subnet validators ... -Waiting for node(s) in cluster to be validating subnet ... -Nodes Validating after 23 seconds +Waiting for node(s) in cluster to be validating subnet ... +Nodes Validating after 23 seconds -Devnet has been created and is validating subnet ! +Devnet has been created and is validating subnet ! ``` ### Create a Devnet and Deploy a Custom VM based Subnet into the Devnet @@ -91,10 +91,10 @@ The following settings will be used: To spin up a Devnet with 5 validator nodes and 1 API node in 5 regions each (us-west-2,us-east-1,ap-south-1,ap-northeast-1,eu-west-1) in AWS with each node having spec of c7g.8xlarge AWS EC2 instance type and io2 volume type, with the Custom VM based Subnet -`` deployed into the Devnet, we will run : +`` deployed into the Devnet, we will run : ```bash -avalanche node devnet wiz --custom-subnet \ +avalanche node devnet wiz --custom-subnet \ --subnet-genesis --custom-vm-repo-url \ --custom-vm-branch --custom-vm-build-script \ --chain-config --subnet-config \ @@ -117,13 +117,13 @@ Setting the nodes as subnet trackers Waiting for node(s) in cluster to be healthy... Nodes healthy after 33 seconds ... -Waiting for node(s) in cluster to be syncing subnet ... -Nodes Syncing after 5 seconds +Waiting for node(s) in cluster to be syncing subnet ... +Nodes Syncing after 5 seconds Adding nodes as subnet validators ... -Waiting for node(s) in cluster to be validating subnet ... -Nodes Validating after 23 seconds +Waiting for node(s) in cluster to be validating subnet ... +Nodes Validating after 23 seconds -Devnet has been created and is validating subnet ! +Devnet has been created and is validating subnet ! ``` \ No newline at end of file diff --git a/content/docs/tooling/create-avalanche-nodes/validate-subnet.mdx b/content/docs/tooling/create-avalanche-nodes/validate-subnet.mdx index 6f2a732bb8b..3321c603e7a 100644 --- a/content/docs/tooling/create-avalanche-nodes/validate-subnet.mdx +++ b/content/docs/tooling/create-avalanche-nodes/validate-subnet.mdx @@ -26,14 +26,14 @@ Before the nodes can be Subnet Validators, the nodes need to first sync with the To have all nodes in cluster `clusterName` sync with Subnet `subnetName`, run: ```bash -avalanche node sync +avalanche node sync ``` All the nodes in cluster `clusterName` will now be syncing to Subnet `subnetName`. Wait until nodes are successfully `Syncing` with the Subnet before running the next commands. -To check sync status, run `avalanche node status --subnet `. Once the node is finished syncing, the response will be: +To check sync status, run `avalanche node status --subnet `. Once the node is finished syncing, the response will be: ```bash All nodes in cluster `clusterName` are synced to Subnet `subnetName` @@ -47,7 +47,7 @@ Once the nodes have synced, we can now have the nodes be Subnet Validators. To have the nodes be Subnet Validators, run: ```bash -avalanche node validate subnet +avalanche node validate subnet ``` **For Fuji Only**: If any of the nodes is not yet a Primary Network Validator, we will first add it as a Primary Network Validator. @@ -78,7 +78,7 @@ Next, choose how long the node will be validating for: Once all the inputs are completed you will see a transaction ID indicating that the node is now a Primary Network Validator. -Note: if you see an error indicating that the transaction is not committed, run `avalanche node validate subnet ` again as it could be due to the validator start time having elapsed. +Note: if you see an error indicating that the transaction is not committed, run `avalanche node validate subnet ` again as it could be due to the validator start time having elapsed. We will then proceed with adding the node as a Subnet Validator. Similar to adding the node as a Primary Network Validator, the wizard will ask you for how you would like to pay for the transaction fee. @@ -94,7 +94,7 @@ Note that for this part, you are not staking actual AVAX in the validator. This Once all input is completed, you will another transaction ID indicating that the node is now scheduled to be a Subnet Validator. -Once the start time that you chose for the node to be a Subnet Validator has elapsed, verify that the node is a Subnet validator by running `avalanche node status --subnet `. +Once the start time that you chose for the node to be a Subnet Validator has elapsed, verify that the node is a Subnet validator by running `avalanche node status --subnet `. You should see: diff --git a/content/docs/tooling/create-deploy-subnets/create-subnet.mdx b/content/docs/tooling/create-deploy-subnets/create-subnet.mdx index c7b0716d749..49176d193af 100644 --- a/content/docs/tooling/create-deploy-subnets/create-subnet.mdx +++ b/content/docs/tooling/create-deploy-subnets/create-subnet.mdx @@ -33,10 +33,10 @@ This tutorials teaches you how to create an Ethereum Virtual Machine (EVM) based The Subnet command suite provides a collection of tools for developing and deploying Subnets. -The Subnet Creation Wizard walks you through the process of creating your Subnet. To get started, first pick a name for your Subnet. This tutorial uses `mySubnet`, but feel free to substitute that with any name you like. Once you've picked your name, run: +The Subnet Creation Wizard walks you through the process of creating your Subnet. To get started, first pick a name for your Subnet. This tutorial uses `myblockchain`, but feel free to substitute that with any name you like. Once you've picked your name, run: ```bash -avalanche blockchain create mySubnet +avalanche blockchain create myblockchain ``` The following sections walk through each question in the wizard. @@ -89,10 +89,10 @@ Deploying Subnets Locally[​](#deploying-subnets-locally "Direct link to headin To deploy your Subnet, run: ```bash -avalanche blockchain deploy mySubnet +avalanche blockchain deploy myblockchain ``` -Make sure to substitute the name of your Subnet if you used a different one than `mySubnet`. +Make sure to substitute the name of your Subnet if you used a different one than `myblockchain`. Next, select `Local Network`. @@ -103,9 +103,10 @@ Note: If you run `bash` on your shell and are running Avalanche-CLI on ARM64 on If all works as expected, the command output should look something like this: ```bash -> avalanche blockchain deploy mySubnet +> avalanche blockchain deploy myblockchain + ✔ Local Network -Deploying [mySubnet] to Local Network +Deploying [myblockchain] to Local Network Installing subnet-evm-v0.4.3... subnet-evm-v0.4.3 installation successful Backend controller started, pid: 93928, output at: /Users/subnet-developer/.avalanche-cli/runs/server_20221122_173138/avalanche-cli-backend @@ -120,21 +121,21 @@ Network ready to use. Local network node endpoints: +-------+----------+------------------------------------------------------------------------------------+ | NODE | VM | URL | +-------+----------+------------------------------------------------------------------------------------+ -| node2 | mySubnet | http://127.0.0.1:9652/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node2 | myblockchain | http://127.0.0.1:9652/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node3 | mySubnet | http://127.0.0.1:9654/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node3 | myblockchain | http://127.0.0.1:9654/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node4 | mySubnet | http://127.0.0.1:9656/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node4 | myblockchain | http://127.0.0.1:9656/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node5 | mySubnet | http://127.0.0.1:9658/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node5 | myblockchain | http://127.0.0.1:9658/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node1 | mySubnet | http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node1 | myblockchain | http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ Browser Extension connection details (any node URL from above works): RPC URL: http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc Funded address: 0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC with 1000000 (10^18) - private key: 56289e99c94b6912bfc12adc093c9b51124f0dc54ac7a766b2bc5ccf558d8027 -Network name: mySubnet +Network name: myblockchain Chain ID: 54325 Currency Symbol: TUTORIAL ``` @@ -154,7 +155,7 @@ To allow API calls from other machines, use `--http-host=0.0.0.0` in the config. Browser Extension connection details (any node URL from above works): RPC URL: http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc Funded address: 0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC with 1000000 (10^18) - private key: 56289e99c94b6912bfc12adc093c9b51124f0dc54ac7a766b2bc5ccf558d8027 -Network name: mySubnet +Network name: myblockchain Chain ID: 54325 Currency Symbol: TUTORIAL ``` diff --git a/content/docs/tooling/create-deploy-subnets/deploy-locally.mdx b/content/docs/tooling/create-deploy-subnets/deploy-locally.mdx index 93a7786c39a..38bf2dc70a6 100644 --- a/content/docs/tooling/create-deploy-subnets/deploy-locally.mdx +++ b/content/docs/tooling/create-deploy-subnets/deploy-locally.mdx @@ -13,18 +13,18 @@ This how-to guide focuses on taking an already created Subnet configuration and Deploying Subnets Locally[​](#deploying-subnets-locally "Direct link to heading") --------------------------------------------------------------------------------- -In the following commands, make sure to substitute the name of your Subnet configuration for ``. +In the following commands, make sure to substitute the name of your Subnet configuration for ``. To deploy your Subnet, run: ```bash -avalanche blockchain deploy +avalanche blockchain deploy ``` and select `Local Network` to deploy on. Alternatively, you can bypass this prompt by providing the `--local` flag. For example: ```bash -avalanche blockchain deploy --local +avalanche blockchain deploy --local ``` The command may take a couple minutes to run. @@ -36,9 +36,10 @@ Note: If you run `bash` on your shell and are running Avalanche-CLI on ARM64 on If all works as expected, the command output should look something like this: ```bash -> avalanche blockchain deploy mySubnet +> avalanche blockchain deploy myblockchain + ✔ Local Network -Deploying [mySubnet] to Local Network +Deploying [myblockchain] to Local Network Installing subnet-evm-v0.4.3... subnet-evm-v0.4.3 installation successful Backend controller started, pid: 93928, output at: /Users/subnet-developer/.avalanche-cli/runs/server_20221122_173138/avalanche-cli-backend @@ -53,21 +54,21 @@ Network ready to use. Local network node endpoints: +-------+----------+------------------------------------------------------------------------------------+ | NODE | VM | URL | +-------+----------+------------------------------------------------------------------------------------+ -| node2 | mySubnet | http://127.0.0.1:9652/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node2 | myblockchain | http://127.0.0.1:9652/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node3 | mySubnet | http://127.0.0.1:9654/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node3 | myblockchain | http://127.0.0.1:9654/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node4 | mySubnet | http://127.0.0.1:9656/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node4 | myblockchain | http://127.0.0.1:9656/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node5 | mySubnet | http://127.0.0.1:9658/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node5 | myblockchain | http://127.0.0.1:9658/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ -| node1 | mySubnet | http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +| node1 | myblockchain | http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc | +-------+----------+------------------------------------------------------------------------------------+ Browser Extension connection details (any node URL from above works): RPC URL: http://127.0.0.1:9650/ext/bc/SPqou41AALqxDquEycNYuTJmRvZYbfoV9DYApDJVXKXuwVFPz/rpc Funded address: 0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC with 1000000 (10^18) - private key: 56289e99c94b6912bfc12adc093c9b51124f0dc54ac7a766b2bc5ccf558d8027 -Network name: mySubnet +Network name: myblockchain Chain ID: 54325 Currency Symbol: TUTORIAL ``` @@ -88,5 +89,5 @@ To redeploy the Subnet, you first need to wipe the Subnet state. This permanentl You are now free to redeploy your Subnet with ```bash -avalanche blockchain deploy --local +avalanche blockchain deploy --local ``` diff --git a/content/docs/tooling/create-deploy-subnets/deploy-on-fuji-testnet.mdx b/content/docs/tooling/create-deploy-subnets/deploy-on-fuji-testnet.mdx index fa79dc2fe25..197ba401ff4 100644 --- a/content/docs/tooling/create-deploy-subnets/deploy-on-fuji-testnet.mdx +++ b/content/docs/tooling/create-deploy-subnets/deploy-on-fuji-testnet.mdx @@ -178,7 +178,7 @@ Create an EVM Subnet[​](#create-an-evm-subnet "Direct link to heading") Creating a Subnet with `Avalanche-CLI` for `Fuji` works the same way as with a local network. In fact, the `create` commands only creates a specification of your Subnet on the local file system. Afterwards the Subnet needs to be _deployed_. This allows to reuse configs, by creating the config with the `create` command, then first deploying to a local network and successively to `Fuji` - and eventually to `Mainnet`. -To create an EVM Subnet, run the `subnet create` command with a name of your choice: +To create an EVM Subnet, run the `blockchain create` command with a name of your choice: ```bash avalanche blockchain create testsubnet @@ -345,7 +345,7 @@ No precompiles set Also you can list the available Subnets: ```bash -avalanche subnet list +avalanche blockchain list go run main.go subnet list +-------------+-------------+----------+---------------------------------------------------+------------+-----------+ | SUBNET | CHAIN | CHAIN ID | VM ID | TYPE | FROM REPO | @@ -357,7 +357,7 @@ go run main.go subnet list List deployed information: ```bash -avalanche subnet list --deployed +avalanche blockchain list --deployed go run main.go subnet list --deployed +-------------+-------------+---------------------------------------------------+---------------+-----------------------------------------------------------------+---------+ | SUBNET | CHAIN | VM ID | LOCAL NETWORK | FUJI (TESTNET) | MAINNET | @@ -472,7 +472,7 @@ See [here](/nodes/validate/node-validator#add-a-validator-with-core-extension) o First, request permission to validate by running the `join` command along with the Subnet name: ```bash -avalanche subnet join testsubnet +avalanche blockchain join testsubnet ``` Note: Running `join` does not guarantee that your node is a validator of the Subnet! The owner of the Subnet must approve your node to be a validator afterwards by calling `addValidator` as described in the next section. @@ -574,7 +574,7 @@ Now that the node has joined the Subnet, a Subnet control key holder must call ` To whitelist a node as a recognized validator on the Subnet, run: ```bash -avalanche subnet addValidator testsubnet +avalanche blockchain addValidator testsubnet ``` As this operation involves a new transaction, you will need to specify which private key to use: @@ -676,7 +676,7 @@ Subnet Export[​](#subnet-export "Direct link to heading") This tool is most useful on the machine where a validator is or is going to be running. In order to allow a VM to run on a different machine, you can export the configuration. Just need to provide a path to where to export the data: ```bash -avalanche subnet export testsubnet +avalanche blockchain export testsubnet ✔ Enter file path to write export data to: /tmp/testsubnet-export.dat ``` @@ -688,14 +688,14 @@ Subnet Import[​](#subnet-import "Direct link to heading") To import a VM specification exported in the previous section, just issue the `import` command with the path to the file after having copied the file over: ```bash -avalanche subnet import /tmp/testsubnet-export.dat +avalanche blockchain import /tmp/testsubnet-export.dat Subnet imported successfully ``` After this the whole Subnet configuration should be available on the target machine: ```bash -avalanche subnet list +avalanche blockchain list +---------------+---------------+----------+-----------+----------+ | SUBNET | CHAIN | CHAIN ID | TYPE | DEPLOYED | +---------------+---------------+----------+-----------+----------+ diff --git a/content/docs/tooling/create-deploy-subnets/deploy-on-mainnet.mdx b/content/docs/tooling/create-deploy-subnets/deploy-on-mainnet.mdx index 837c51fdb9b..f9dbd269f9b 100644 --- a/content/docs/tooling/create-deploy-subnets/deploy-on-mainnet.mdx +++ b/content/docs/tooling/create-deploy-subnets/deploy-on-mainnet.mdx @@ -218,7 +218,7 @@ See [here](/nodes/validate/node-validator#add-a-validator-with-core-extension) o First, request permission to validate by running the `join` command along with the Subnet name: ```bash -avalanche subnet join testsubnet +avalanche blockchain join testsubnet ``` Note: Running `join` does not guarantee that your node is a validator of the Subnet! The owner of the Subnet must approve your node to be a validator afterwards by calling `addValidator` as described in the next section. @@ -335,7 +335,7 @@ Now that the node has joined the Subnet, a Subnet control key holder must call ` To whitelist a node as a recognized validator on the Subnet, run: ```bash -avalanche subnet addValidator testsubnet +avalanche blockchain addValidator testsubnet ``` You need to repeat this process for every validator you add to the network. @@ -489,7 +489,7 @@ Subnet Export[​](#subnet-export "Direct link to heading") Because you need to setup multiple validators on multiple different machines, you need to export your Subnet's configuration and import it on each validator. ```bash -avalanche subnet export testsubnet +avalanche blockchain export testsubnet ✔ Enter file path to write export data to: /tmp/testsubnet-export.dat ``` @@ -501,14 +501,14 @@ Subnet Import[​](#subnet-import "Direct link to heading") To import a VM configuration, move the file you exported in the previous section to your desired machine and issue the `import` command with the path to the file. ```bash -avalanche subnet import /tmp/testsubnet-export.dat +avalanche blockchain import /tmp/testsubnet-export.dat Subnet imported successfully ``` After this the whole Subnet configuration should be available on the target machine: ```bash -avalanche subnet list +avalanche blockchain list +---------------+---------------+----------+-----------+----------+ | SUBNET | CHAIN | CHAIN ID | TYPE | DEPLOYED | +---------------+---------------+----------+-----------+----------+ diff --git a/content/docs/tooling/create-deploy-subnets/view-subnets.mdx b/content/docs/tooling/create-deploy-subnets/view-subnets.mdx index f8fd85f91fb..b513d575e20 100644 --- a/content/docs/tooling/create-deploy-subnets/view-subnets.mdx +++ b/content/docs/tooling/create-deploy-subnets/view-subnets.mdx @@ -5,12 +5,12 @@ description: CLI commands for viewing subnets. ## List Subnet Configurations -You can list the Subnets you've created with: `avalanche subnet list` +You can list the Subnets you've created with: `avalanche blockchain list` Example: ```bash -> avalanche subnet list +> avalanche blockchain list +-------------+-------------+----------+---------------------------------------------------+------------+-----------+ | SUBNET | CHAIN | CHAIN ID | VM ID | TYPE | FROM REPO | +-------------+-------------+----------+---------------------------------------------------+------------+-----------+ @@ -21,7 +21,7 @@ Example: To see detailed information about your deployed Subnets, add the `--deployed` flag: ```bash -> avalanche subnet list --deployed +> avalanche blockchain list --deployed +-------------+-------------+---------------------------------------------------+---------------+-----------------------------------------------------------------+---------+ | SUBNET | CHAIN | VM ID | LOCAL NETWORK | FUJI (TESTNET) | MAINNET | +-------------+-------------+---------------------------------------------------+---------------+-----------------------------------------------------------------+---------+ @@ -34,12 +34,12 @@ To see detailed information about your deployed Subnets, add the `--deployed` fl ## Describe Subnet Configurations -To see the details of a specific configuration, run: `avalanche blockchain describe ` +To see the details of a specific configuration, run: `avalanche blockchain describe ` Example: ```bash -> avalanche blockchain describe firstsubnet +> avalanche blockchain describe myblockchain _____ _ _ _ | __ \ | | (_) | @@ -50,7 +50,7 @@ Example: +----------------------------+----------------------------------------------------+ | PARAMETER | VALUE | +----------------------------+----------------------------------------------------+ -| Subnet Name | firstsubnet | +| Subnet Name | myblockchain | +----------------------------+----------------------------------------------------+ | ChainID | 12345 | +----------------------------+----------------------------------------------------+ @@ -123,12 +123,13 @@ No precompiles set ## Viewing a Genesis File -If you'd like to see the raw genesis file, supply the `--genesis` flag to the describe command: `avalanche blockchain describe --genesis` +If you'd like to see the raw genesis file, supply the `--genesis` flag to the describe command: `avalanche blockchain describe --genesis` Example: ```bash -> avalanche blockchain describe firstsubnet --genesis +> avalanche blockchain describe myblockchain --genesis + { "config": { "chainId": 12345, diff --git a/content/docs/tooling/cross-chain/teleporter-devnet.mdx b/content/docs/tooling/cross-chain/teleporter-devnet.mdx index fb51ecccea3..f3e2aedabd6 100644 --- a/content/docs/tooling/cross-chain/teleporter-devnet.mdx +++ b/content/docs/tooling/cross-chain/teleporter-devnet.mdx @@ -22,24 +22,24 @@ Note: the tutorial uses AWS hosts, but Devnets can also be created and operated Create Subnets Configurations[​](#create-subnets-configurations "Direct link to heading") ----------------------------------------------------------------------------------------- -For this section we will follow this [steps](/tooling/cross-chain/teleporter-local-network#create-subnets-configurations), to create two Teleporter-enabled Subnets, `` and ``. +For this section we will follow this [steps](/tooling/cross-chain/teleporter-local-network#create-subnets-configurations), to create two Teleporter-enabled Subnets, `` and ``. Create a Devnet and Deploy a Subnet in It[​](#create-a-devnet-and-deploy-a-subnet-in-it "Direct link to heading") ----------------------------------------------------------------------------------------------------------------- -Let's use the `devnet wiz` command to create a devnet `` and deploy `` in it. +Let's use the `devnet wiz` command to create a devnet `` and deploy `` in it. The devnet will be created in the `us-east-1` region of AWS, and will consist of 5 validators only. ```bash -avalanche node devnet wiz --aws --node-type default --region us-east-1 --num-validators 5 --num-apis 0 --enable-monitoring=false --default-validator-params +avalanche node devnet wiz --aws --node-type default --region us-east-1 --num-validators 5 --num-apis 0 --enable-monitoring=false --default-validator-params Creating the devnet... Creating new EC2 instance(s) on AWS... ... -Deploying [subnet1] to Cluster +Deploying [chain1] to Cluster ... configuring AWM RElayer on host i-0f1815c016b555fcc @@ -49,19 +49,19 @@ Setting the nodes as subnet trackers Setting up teleporter on subnet -Teleporter Messenger successfully deployed to subnet1 (0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf) -Teleporter Registry successfully deployed to subnet1 (0xb623C4495220C603D0A939D32478F55891a61750) +Teleporter Messenger successfully deployed to chain1 (0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf) +Teleporter Registry successfully deployed to chain1 (0xb623C4495220C603D0A939D32478F55891a61750) Teleporter Messenger successfully deployed to c-chain (0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf) Teleporter Registry successfully deployed to c-chain (0x5DB9A7629912EBF95876228C24A848de0bfB43A9) Starting AWM Relayer Service -setting AWM Relayer on host i-0f1815c016b555fcc to relay subnet subnet1 +setting AWM Relayer on host i-0f1815c016b555fcc to relay subnet chain1 updating configuration file ~/.avalanche-cli/nodes/i-0f1815c016b555fcc/services/awm-relayer/awm-relayer-config.json -Devnet is successfully created and is now validating subnet subnet1! +Devnet is successfully created and is now validating subnet chain1! -Subnet RPC URL: http://67.202.23.231:9650/ext/bc/fqcM24LNb3kTV7KD1mAvUJXYy5XunwP8mrE44YuNwPjgZHY6p/rpc +Subnet RPC URL: http://67.202.23.231:9650/ext/bc/fqcM24LNb3kTV7KD1mAvUJXYy5XunwP8mrE44YuNwPjgZHY6p/rpc ✓ Cluster information YAML file can be found at ~/.avalanche-cli/nodes/inventories//clusterInfo.yaml at local host ``` @@ -127,17 +127,17 @@ Apr 05 14:15:08 ip-172-31-47-187 awm-relayer[6886]: {"level":"info","timestamp": Deploying the Second Subnet[​](#deploying-the-second-subnet "Direct link to heading") ------------------------------------------------------------------------------------- -Let's use the `devnet wiz` command again to deploy ``. +Let's use the `devnet wiz` command again to deploy ``. -When deploying Subnet ``, the two Teleporter contracts will not be deployed to C-Chain in Local Network as they have already been deployed when we deployed the first Subnet. +When deploying Subnet ``, the two Teleporter contracts will not be deployed to C-Chain in Local Network as they have already been deployed when we deployed the first Subnet. ```bash -avalanche node devnet wiz --default-validator-params +avalanche node devnet wiz --default-validator-params Adding subnet into existing devnet ... ... -Deploying [subnet2] to Cluster +Deploying [chain2] to Cluster ... Stopping AWM Relayer Service @@ -147,18 +147,18 @@ Setting the nodes as subnet trackers Setting up teleporter on subnet -Teleporter Messenger successfully deployed to subnet2 (0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf) -Teleporter Registry successfully deployed to subnet2 (0xb623C4495220C603D0A939D32478F55891a61750) +Teleporter Messenger successfully deployed to chain2 (0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf) +Teleporter Registry successfully deployed to chain2 (0xb623C4495220C603D0A939D32478F55891a61750) Teleporter Messenger has already been deployed to c-chain Starting AWM Relayer Service -setting AWM Relayer on host i-0f1815c016b555fcc to relay subnet subnet2 +setting AWM Relayer on host i-0f1815c016b555fcc to relay subnet chain2 updating configuration file ~/.avalanche-cli/nodes/i-0f1815c016b555fcc/services/awm-relayer/awm-relayer-config.json -Devnet is now validating subnet subnet2 +Devnet is now validating subnet chain2 -Subnet RPC URL: http://67.202.23.231:9650/ext/bc/7gKt6evRnkA2uVHRfmk9WrH3dYZH9gEVVxDAknwtjvtaV3XuQ/rpc +Subnet RPC URL: http://67.202.23.231:9650/ext/bc/7gKt6evRnkA2uVHRfmk9WrH3dYZH9gEVVxDAknwtjvtaV3XuQ/rpc ✓ Cluster information YAML file can be found at ~/.avalanche-cli/nodes/inventories//clusterInfo.yaml at local host ``` @@ -169,18 +169,18 @@ Verify Teleporter Is Successfully Set Up[​](#verify-teleporter-is-successfully To verify that Teleporter is successfully, let's send a couple of cross messages: ```bash -avalanche teleporter msg C-Chain subnet1 "Hello World" --cluster +avalanche teleporter msg C-Chain chain1 "Hello World" --cluster Delivering message "this is a message" to source subnet "C-Chain" (2EfJg86if9Ka5Ag73JRfoqWz4EGuFwtemaNf4XiBBpUW4YngS6) -Waiting for message to be received at destination subnet subnet "subnet1" (fqcM24LNb3kTV7KD1mAvUJXYy5XunwP8mrE44YuNwPjgZHY6p) +Waiting for message to be received at destination subnet subnet "chain1" (fqcM24LNb3kTV7KD1mAvUJXYy5XunwP8mrE44YuNwPjgZHY6p) Message successfully Teleported! ``` ```bash -avalanche teleporter msg subnet2 subnet1 "Hello World" --cluster +avalanche teleporter msg chain2 chain1 "Hello World" --cluster -Delivering message "this is a message" to source subnet "subnet2" (29WP91AG7MqPUFEW2YwtKnsnzVrRsqcWUpoaoSV1Q9DboXGf4q) -Waiting for message to be received at destination subnet subnet "subnet1" (fqcM24LNb3kTV7KD1mAvUJXYy5XunwP8mrE44YuNwPjgZHY6p) +Delivering message "this is a message" to source subnet "chain2" (29WP91AG7MqPUFEW2YwtKnsnzVrRsqcWUpoaoSV1Q9DboXGf4q) +Waiting for message to be received at destination subnet subnet "chain1" (fqcM24LNb3kTV7KD1mAvUJXYy5XunwP8mrE44YuNwPjgZHY6p) Message successfully Teleported! ``` @@ -191,7 +191,7 @@ Obtaining Information on Teleporter Deploys[​](#obtaining-information-on-telep ### Obtaining Subnet Information[​](#obtaining-subnet-information "Direct link to heading") -By executing `subnet describe` on a Teleporter enabled Subnet, the following relevant information can be found: +By executing `blockchain describe` on a Teleporter enabled Subnet, the following relevant information can be found: - Blockchain RPC URL - Blockchain ID in cb58 format @@ -199,10 +199,10 @@ By executing `subnet describe` on a Teleporter enabled Subnet, the following rel - Teleporter Messenger address - Teleporter Registry address -Let's get the information for ``: +Let's get the information for ``: ```bash -avalanche blockchain describe +avalanche blockchain describe _____ _ _ _ | __ \ | | (_) | @@ -214,7 +214,7 @@ avalanche blockchain describe +--------------------------------+----------------------------------------------------------------------------------------+ | PARAMETER | VALUE | +--------------------------------+----------------------------------------------------------------------------------------+ -| Subnet Name | subnet1 | +| Subnet Name | chain1 | +--------------------------------+----------------------------------------------------------------------------------------+ | ChainID | 1 | +--------------------------------+----------------------------------------------------------------------------------------+ diff --git a/content/docs/tooling/cross-chain/teleporter-local-network.mdx b/content/docs/tooling/cross-chain/teleporter-local-network.mdx index 2aaba5b2639..eb503c2f10e 100644 --- a/content/docs/tooling/cross-chain/teleporter-local-network.mdx +++ b/content/docs/tooling/cross-chain/teleporter-local-network.mdx @@ -18,14 +18,14 @@ Note that currently only [Subnet-EVM](https://github.com/ava-labs/subnet-evm) an Create Subnet Configurations[​](#create-subnet-configurations "Direct link to heading") --------------------------------------------------------------------------------------- -Let's create a Subnet called `` with the latest Subnet-EVM version, a chain ID of 1, TOKEN1 as the token name, and with default Subnet-EVM parameters (more information regarding Subnet creation can be found [here](/subnets/build-first-subnet#create-your-subnet-configuration)): +Let's create a Subnet called `` with the latest Subnet-EVM version, a chain ID of 1, TOKEN1 as the token name, and with default Subnet-EVM parameters (more information regarding Subnet creation can be found [here](/subnets/build-first-subnet#create-your-subnet-configuration)): ```bash -avalanche blockchain create --evm --latest\ +avalanche blockchain create --evm --latest\ --evm-chain-id 1 --evm-token TOKEN1 --evm-defaults -creating genesis for -configuring airdrop to stored key "subnet__airdrop" with address 0x0EF8151A3e6ad1d4e17C8ED4128b20EB5edc58B1 +creating genesis for +configuring airdrop to stored key "subnet__airdrop" with address 0x0EF8151A3e6ad1d4e17C8ED4128b20EB5edc58B1 loading stored key "cli-teleporter-deployer" for teleporter deploys (evm address, genesis balance) = (0xE932784f56774879e03F3624fbeC6261154ec711, 600000000000000000000) using latest teleporter version (v1.0.0) @@ -38,14 +38,14 @@ To disable Teleporter in your Subnet, use the flag `--teleporter=false` when cre To disable Relayer in your Subnet, use the flag `--relayer=false` when creating the Subnet. -Now let's create a second Subnet called ``, with similar settings: +Now let's create a second Subnet called ``, with similar settings: ```bash -avalanche blockchain create --evm --latest\ +avalanche blockchain create --evm --latest\ --evm-chain-id 2 --evm-token TOKEN2 --evm-defaults -creating genesis for -configuring airdrop to stored key "subnet__airdrop" with address 0x0EF815FFFF6ad1d4e17C8ED4128b20EB5edAABBB +creating genesis for +configuring airdrop to stored key "subnet__airdrop" with address 0x0EF815FFFF6ad1d4e17C8ED4128b20EB5edAABBB loading stored key "cli-teleporter-deployer" for teleporter deploys (evm address, genesis balance) = (0xE932784f56774879e03F3624fbeC6261154ec711, 600000000000000000000) using latest teleporter version (v1.0.0) @@ -55,12 +55,12 @@ using latest teleporter version (v1.0.0) Deploy the Subnets to Local Network[​](#deploy-the-subnets-to-local-network "Direct link to heading") ----------------------------------------------------------------------------------------------------- -Let's deploy ``: +Let's deploy ``: ```bash -avalanche blockchain deploy --local +avalanche blockchain deploy --local -Deploying [] to Local Network +Deploying [] to Local Network Backend controller started, pid: 149427, output at: ~/.avalanche-cli/runs/server_20240229_165923/avalanche-cli-backend.log Booting Network. Wait until healthy... @@ -72,8 +72,8 @@ Deploying Blockchain. Wait until network acknowledges... Teleporter Messenger successfully deployed to c-chain (0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf) Teleporter Registry successfully deployed to c-chain (0x17aB05351fC94a1a67Bf3f56DdbB941aE6c63E25) -Teleporter Messenger successfully deployed to (0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf) -Teleporter Registry successfully deployed to (0x9EDc4cB4E781413b1b82CC3A92a60131FC111F58) +Teleporter Messenger successfully deployed to (0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf) +Teleporter Registry successfully deployed to (0x9EDc4cB4E781413b1b82CC3A92a60131FC111F58) Using latest awm-relayer version (v1.1.0) Executing AWM-Relayer... @@ -82,21 +82,21 @@ Blockchain ready to use. Local network node endpoints: +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ | NODE | VM | URL | ALIAS URL | +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ -| node1 | | http://127.0.0.1:9650/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9650/ext/bc//rpc | +| node1 | | http://127.0.0.1:9650/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9650/ext/bc//rpc | +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ -| node2 | | http://127.0.0.1:9652/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9652/ext/bc//rpc | +| node2 | | http://127.0.0.1:9652/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9652/ext/bc//rpc | +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ -| node3 | | http://127.0.0.1:9654/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9654/ext/bc//rpc | +| node3 | | http://127.0.0.1:9654/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9654/ext/bc//rpc | +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ -| node4 | | http://127.0.0.1:9656/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9656/ext/bc//rpc | +| node4 | | http://127.0.0.1:9656/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9656/ext/bc//rpc | +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ -| node5 | | http://127.0.0.1:9658/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9658/ext/bc//rpc | +| node5 | | http://127.0.0.1:9658/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9658/ext/bc//rpc | +-------+-----------+------------------------------------------------------------------------------------+--------------------------------------------+ Browser Extension connection details (any node URL from above works): RPC URL: http://127.0.0.1:9650/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc Funded address: 0x0EF8151A3e6ad1d4e17C8ED4128b20EB5edc58B1 with 1000000 (10^18) - private key: 16289399c9466912ffffffdc093c9b51124f0dc54ac7a766b2bc5ccf558d8eee -Network name: +Network name: Chain ID: 1 Currency Symbol: TOKEN1 ``` @@ -109,19 +109,19 @@ Notice some details here: CLI configures the Relayer to enable every Subnet to send messages to all other Subnets. If you add more Subnets, the Relayer will be automatically reconfigured. -When deploying Subnet ``, the two Teleporter contracts will not be deployed to C-Chain in Local Network as they have already been deployed when we deployed the first Subnet. +When deploying Subnet ``, the two Teleporter contracts will not be deployed to C-Chain in Local Network as they have already been deployed when we deployed the first Subnet. ```bash -avalanche blockchain deploy --local +avalanche blockchain deploy --local -Deploying [] to Local Network +Deploying [] to Local Network Deploying Blockchain. Wait until network acknowledges... Teleporter Messenger has already been deployed to c-chain -Teleporter Messenger successfully deployed to (0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf) -Teleporter Registry successfully deployed to (0x9EDc4cB4E781413b1b82CC3A92a60131FC111F58) +Teleporter Messenger successfully deployed to (0x253b2784c75e510dD0fF1da844684a1aC0aa5fcf) +Teleporter Registry successfully deployed to (0x9EDc4cB4E781413b1b82CC3A92a60131FC111F58) Using latest awm-relayer version (v1.1.0) Executing AWM-Relayer... @@ -130,31 +130,31 @@ Blockchain ready to use. Local network node endpoints: +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ | NODE | VM | URL | ALIAS URL | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node1 | | http://127.0.0.1:9650/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9650/ext/bc//rpc | +| node1 | | http://127.0.0.1:9650/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9650/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node1 | | http://127.0.0.1:9650/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9650/ext/bc//rpc | +| node1 | | http://127.0.0.1:9650/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9650/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node2 | | http://127.0.0.1:9652/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9652/ext/bc//rpc | +| node2 | | http://127.0.0.1:9652/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9652/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node2 | | http://127.0.0.1:9652/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9652/ext/bc//rpc | +| node2 | | http://127.0.0.1:9652/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9652/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node3 | | http://127.0.0.1:9654/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9654/ext/bc//rpc | +| node3 | | http://127.0.0.1:9654/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9654/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node3 | | http://127.0.0.1:9654/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9654/ext/bc//rpc | +| node3 | | http://127.0.0.1:9654/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9654/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node4 | | http://127.0.0.1:9656/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9656/ext/bc//rpc | +| node4 | | http://127.0.0.1:9656/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9656/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node4 | | http://127.0.0.1:9656/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9656/ext/bc//rpc | +| node4 | | http://127.0.0.1:9656/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9656/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node5 | | http://127.0.0.1:9658/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9658/ext/bc//rpc | +| node5 | | http://127.0.0.1:9658/ext/bc/MzN4AbtFzQ3eKqPhFaDpwCMJmagciWSCgghkZx6YeC6jRdvb6/rpc | http://127.0.0.1:9658/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ -| node5 | | http://127.0.0.1:9658/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9658/ext/bc//rpc | +| node5 | | http://127.0.0.1:9658/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc | http://127.0.0.1:9658/ext/bc//rpc | +-------+-----------+-------------------------------------------------------------------------------------+--------------------------------------------+ Browser Extension connection details (any node URL from above works): RPC URL: http://127.0.0.1:9650/ext/bc/2tVGwEQmeXtdnFURW1YSq5Yf4jbJPfTBfVcu68KWHdHe5e5gX5/rpc Funded address: 0x0EF815FFFF6ad1d4e17C8ED4128b20EB5edAABBB with 1000000 (10^18) - private key: 56289e99c94b6912bfc12adc093c9b51124f0dc54ac7a766b2bc5ccf558d8027 -Network name: +Network name: Chain ID: 2 Currency Symbol: TOKEN2 ``` @@ -165,18 +165,18 @@ Verify Teleporter Is Successfully Set Up[​](#verify-teleporter-is-successfully To verify that Teleporter is successfully, let's send a couple of cross messages: ```bash -avalanche teleporter msg C-Chain subnet1 "Hello World" --local +avalanche teleporter msg C-Chain chain1 "Hello World" --local Delivering message "this is a message" to source subnet "C-Chain" -Waiting for message to be received at destination subnet subnet "subnet1" +Waiting for message to be received at destination subnet subnet "chain1" Message successfully Teleported! ``` ```bash -avalanche teleporter msg subnet2 subnet1 "Hello World" --local +avalanche teleporter msg chain2 chain1 "Hello World" --local -Delivering message "this is a message" to source subnet "subnet2" -Waiting for message to be received at destination subnet subnet "subnet1" +Delivering message "this is a message" to source subnet "chain2" +Waiting for message to be received at destination subnet subnet "chain1" Message successfully Teleported! ``` @@ -189,7 +189,7 @@ Obtaining Information on Teleporter Deploys[​](#obtaining-information-on-telep ### Obtaining Subnet Information[​](#obtaining-subnet-information "Direct link to heading") -By executing `subnet describe` on a Teleporter enabled Subnet, the following relevant information can be found: +By executing `blockchain describe` on a Teleporter enabled Subnet, the following relevant information can be found: - Blockchain RPC URL - Blockchain ID in cb58 format @@ -197,10 +197,11 @@ By executing `subnet describe` on a Teleporter enabled Subnet, the following rel - Teleporter Messenger address - Teleporter Registry address -Let's get the information for ``: +Let's get the information for ``: ```bash -avalanche blockchain describe +avalanche blockchain describe + _____ _ _ _ | __ \ | | (_) | @@ -211,7 +212,7 @@ avalanche blockchain describe +--------------------------------+-------------------------------------------------------------------------------------+ | PARAMETER | VALUE | +--------------------------------+-------------------------------------------------------------------------------------+ -| Subnet Name | subnet1 | +| Subnet Name | chain1 | +--------------------------------+-------------------------------------------------------------------------------------+ | ChainID | 1 | +--------------------------------+-------------------------------------------------------------------------------------+ diff --git a/content/docs/tooling/guides/import-subnet.mdx b/content/docs/tooling/guides/import-subnet.mdx index 4c5f4c303bd..2ebaa8df426 100644 --- a/content/docs/tooling/guides/import-subnet.mdx +++ b/content/docs/tooling/guides/import-subnet.mdx @@ -27,7 +27,7 @@ For these use cases, Avalanche-CLI now supports the `import public` command. Start the import by issuing ``` -avalanche subnet import public +avalanche blockchain import public ``` The tool prompts for the network from which to import. The invariant assumption here is that the network is a public network, either the Fuji testnet or Mainnet. In other words, importing from a local network isn't supported.