cosmos-sdk/simapp
Csongor Kiss abbed8593e Fix simapp compilation
The WormholeKeeper is just set to nil so we don't incur a circular
dependency. The simapp test doesn't use that keeper anyway
2022-07-22 14:11:24 -05:00
..
helpers fix: defaultGenTxGas to 10 times (#12314) 2022-06-21 09:48:54 -04:00
params fix(CI): add golangci-lint to dependencies (#10112) (#10172) 2021-09-17 00:34:36 +02:00
simd chore: move server.GenerateCoinKey and server.GenerateSaveCoinKey to testutil (#10956) 2022-01-18 15:37:05 +01:00
README.md fix: Added description of how to run the unsafe-reset-all command in simapp README (#11718) (#11719) 2022-04-22 10:28:29 +02:00
app.go Fix simapp compilation 2022-07-22 14:11:24 -05:00
app_test.go test: fix mockgen version (#9127) 2021-05-25 09:18:59 +00:00
config.go Remove dependency of types/module package on x/simulation (#5835) 2020-03-23 12:55:44 +01:00
encoding.go codecs: rename MakeCodecs rename and docs update (#8245) 2021-01-07 21:50:52 +00:00
export.go chore(types): add MustAccAddressFromBech32 util func (backport #12201) (#12205) 2022-06-09 15:01:04 -04:00
genesis.go x/authz: audit updates (#9042) 2021-05-06 18:23:48 +00:00
genesis_account.go x/auth: remove alias.go usage (#6440) 2020-06-17 14:42:27 -04:00
genesis_account_test.go Update tm pubkey references (#7102) 2020-08-28 16:02:38 +00:00
sim_bench_test.go simapp, types: fix benchmarks panics by honoring skip if set (#8763) 2021-03-03 03:54:14 -08:00
sim_test.go x/authz: audit updates (#9042) 2021-05-06 18:23:48 +00:00
state.go SDK Core Audit - simapp updates (#9315) 2021-05-17 15:42:44 +00:00
test_helpers.go SDK Core Audit - simapp updates (#9315) 2021-05-17 15:42:44 +00:00
types.go Add height in exported genesis (#7089) 2020-09-03 10:11:46 +00:00
utils.go codec: Rename codec and marshaler interfaces (#9226) 2021-04-29 10:46:22 +00:00
utils_test.go codec: Rename codec and marshaler interfaces (#9226) 2021-04-29 10:46:22 +00:00

README.md

order
false

simapp

simapp is an application built using the Cosmos SDK for testing and educational purposes.

Running testnets with simd

If you want to spin up a quick testnet with your friends, you can follow these steps. Unless otherwise noted, every step must be done by everyone who wants to participate in this testnet.

  1. From the root directory of the Cosmos SDK repository, run $ make build. This will build the simd binary inside a new build directory. The following instructions are run from inside the build directory.

  2. If you've run simd before, you may need to reset your database before starting a new testnet. You can reset your database with the following command: $ ./simd tendermint unsafe-reset-all.

  3. $ ./simd init [moniker] --chain-id [chain-id]. This will initialize a new working directory at the default location ~/.simapp. You need to provide a "moniker" and a "chain id". These two names can be anything, but you will need to use the same "chain id" in the following steps.

  4. $ ./simd keys add [key_name]. This will create a new key, with a name of your choosing. Save the output of this command somewhere; you'll need the address generated here later.

  5. $ ./simd add-genesis-account [key_name] [amount], where key_name is the same key name as before; and amount is something like 10000000000000000000000000stake.

  6. $ ./simd gentx [key_name] [amount] --chain-id [chain-id]. This will create the genesis transaction for your new chain. Here amount should be at least 1000000000stake. If you provide too much or too little, you will encounter an error when starting your node.

  7. Now, one person needs to create the genesis file genesis.json using the genesis transactions from every participant, by gathering all the genesis transactions under config/gentx and then calling $ ./simd collect-gentxs. This will create a new genesis.json file that includes data from all the validators (we sometimes call it the "super genesis file" to distinguish it from single-validator genesis files).

  8. Once you've received the super genesis file, overwrite your original genesis.json file with the new super genesis.json.

  9. Modify your config/config.toml (in the simapp working directory) to include the other participants as persistent peers:

    # Comma separated list of nodes to keep persistent connections to
    persistent_peers = "[validator_address]@[ip_address]:[port],[validator_address]@[ip_address]:[port]"
    

    You can find validator_address by running $ ./simd tendermint show-node-id. The output will be the hex-encoded validator_address. The default port is 26656.

  10. Now you can start your nodes: $ ./simd start.

Now you have a small testnet that you can use to try out changes to the Cosmos SDK or Tendermint!

NOTE: Sometimes creating the network through the collect-gentxs will fail, and validators will start in a funny state (and then panic). If this happens, you can try to create and start the network first with a single validator and then add additional validators using a create-validator transaction.