跳到主要内容

Simulator User Guide

Intro​

This document will guide you through the process of setting up Chia's Simulator. For additional technical resources, see the following:

备注

It is possible to run the simulator and either Chia's testnet or mainnet simultaneously. This is because the simulator will use its own ports and directories.

Prerequisites​

The simulator is included in the chia-blockchain GitHub repository (the same repository that contains Chia's node, and farmer code). To install this repository, see our instructions to install Chia from source.

After you have installed from source and have activated your virtual environment (you should see (venv) on the left side of your Powershell/terminal window), you are all set to install the simulator.

危险

If you installed Chia from the binary installation file, you cannot use this installation to run the simulator. Instead, follow the instructions linked above to create a new installation from source, then return to this guide.

Install and configure the simulator​

The simulator commands can all be accessed under chia dev sim. For a full list of the simulator commands, see our Simulator CLI Reference.

  1. Install the simulator
chia dev sim create

If you do not already have any keys in your OS keychain, you will be prompted to create one:

No keys in keychain. Press 'q' to quit, or press any other key to generate a new key.

After pressing any key (other than q), a new public/private key pair will be generated:

Generating private key

If you already have one or more keys installed, you will be prompted to select one:

Fingerprints:
If you already used one of these keys, select that fingerprint to skip the plotting process. Otherwise, select any key below.
1) 3339549250
2) 1239193935
3) 378808701
Choose a simulator key [1-3] ('q' to quit, or 'g' to generate a new key): 2

This command will create several k-19 plots. These plots are significantly smaller than the k-32 plots used on mainnet (8 MiB vs 100 GiB). They will take less than a minute to create on most computers.

This command will also install a new version of Chia that contains a config file that is already set up for the simulator to run on its own ports. The last output of this command should look like the following (the path listed will depend on your user ID and OS):

Configuration Wizard Complete.
Starting Simulator now...


Daemon not started yet
Starting daemon
chia_full_node_simulator: started
Please wait, generating genesis block.
Farmed 1 Transaction blocks
Block Height is now: 1
Genesis block generated, exiting.

Make sure your CHIA_ROOT Environment Variable is set to: C:\Users\<user>\.chia\simulator\main

  1. Now that you have the simulator environment set up, you can set the CHIA_ROOT env var to point to this environment. This will enable you to run the simulator from outside of chia-blockchain:

    $env:CHIA_ROOT='~/.chia/simulator/main'

    Note that by setting CHIA_ROOT to the simulator in the current Powershell/terminal window, this enables you to run the simulator in tandem with a full node running on either the testnet or on mainnet. This is because the simulator uses different ports than a normal full node.

Use the simulator​

This section will cover the basic commands for using the simulator.

  1. Start the simulator:
chia start simulator

Result:

Daemon not started yet
Starting daemon
chia_full_node_simulator: started

This command is the equivalent of chia start node on testnet and mainnet.

  1. Start your Chia wallet:
chia start wallet

Result:

chia_wallet: started
  1. Verify that the Chia simulator is running and synced:
chia show -s

The result will show that the network is simulator0 and the block height is 1:

Network: simulator0    Port: 50127   RPC Port: 16872
Node ID: 5e4775f1f7d7db43d9d4b5685a15959b52042e40918112053c5e99f59cb8afb7
Genesis Challenge: eb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7
Current Blockchain Status: Full Node Synced

Peak: Hash: 2d42fe5b2fe275994542a3884e93d0ddd4271f46f61731cc8e523253f3d54474
      Time: Fri May 19 2023 17:24:38 China Standard Time                  Height:          1

Estimated network space: 84.355 MiB
Current difficulty: 1024
Current VDF sub_slot_iters: 1024

  Height: |   Hash:
        1 | b60936d7c4c7583ccbb4ddb173cefcb50ca10f8d49cee1c9bfc2f55337449b66
  1. To obtain the status of the network, along with your farming address and balance (21 million TXCH from the prefarm)
chia dev sim status
Network: simulator0    Port: 50127   RPC Port: 16872
Node ID: 5e4775f1f7d7db43d9d4b5685a15959b52042e40918112053c5e99f59cb8afb7
Genesis Challenge: eb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7
Current Blockchain Status: Full Node Synced

Peak: Hash: 2d42fe5b2fe275994542a3884e93d0ddd4271f46f61731cc8e523253f3d54474
      Time: Fri May 19 2023 17:24:38 China Standard Time                  Height:          1

Estimated network space: 84.355 MiB
Current difficulty: 1024
Current VDF sub_slot_iters: 1024

  Height: |   Hash:
        1 | b60936d7c4c7583ccbb4ddb173cefcb50ca10f8d49cee1c9bfc2f55337449b66

Current Farming address: txch1wn0jp4q6n3eafeee2qj4khw8svdqnvj4hxvzffl9pjrv5wvzf5gsvyz908, with a balance of: 21000000.0 TXCH.
  1. Farm a new block

There are two ways to farm a new block. The simpler solution is with a CLI call:

chia dev sim farm

Result:

Farmed 1 Transaction blocks
Block Height is now: 2

If you want to direct the farming rewards to a specific address, you can call the RPC:

chia rpc full_node farm_block '{"address":"<farming reward address>"}'

Result:

{
    "new_peak_height": 3,
    "success": true
}

For more info on this command, see the RPC documentation.

  1. Edit the simulator's configuration

The simulator's config is stored in ~/.chia/simulator/main/config/config.yaml. Just as with mainnet and testnet, if you make changes to this config, you will need to restart the simulator for the changes to take effect. This will not affect your regular Chia node.

  1. Enable/disable auto farming

By default, as soon as a new spend bundle enters the mempool, a new block will be farmed. In certain cases this may not be the desired behavior. To disable auto farming, run the following command:

chia dev sim autofarm off

Result:

Auto farming is now off

This action will take effect immediately; there is no need to restart the simulator.

To enable auto farming, run:

chia dev sim autofarm on

Result:

Auto farming is now on