LocalOsmosis (a fork of LocalTerra) is a complete Osmosis testnet and ecosystem containerized with Docker and orchestrated with a simple docker-compose file. It simplifies the way smart-contract developers test their contracts in a sandbox before they deploy them on a testnet or mainnet.
LocalOsmosis comes preconfigured with opinionated, sensible defaults for standard testing environments. If other projects mention testing on LocalOsmosis, they are referring to the settings defined in this repo.
LocalOsmosis has the following advantages over a public testnet:
- Easily modifiable world states
- Quick to reset for rapid iterations
- Simple simulations of different scenarios
- Controllable validator behavior
sudo apt-get remove docker docker-engine docker.io
sudo apt-get update
sudo apt install docker.io -y
sudo apt install docker-compose -y
- Osmosisd
- We will be using osmosisd outside of the Docekr container in order to easily communicate with the local network
- Supported known architecture: x86_64
- 16+ GB of RAM is recommended
- Run the following commands::
git clone https://github.com/czarcas7ic/LocalOsmosis.git
cd LocalOsmosis- Make sure your Docker daemon is running in the background and
docker-composeis installed.
- Start LocalOsmosis:
docker-compose upYour environment now contains:
- osmosisd RPC node running on
tcp://localhost:26657 - LCD running on http://localhost:1317
Stop LocalOsmosis:
$ docker-compose stopReset the world state:
$ docker-compose rmYou can integrate LocalOsmosis in Terra Station, terrad, and the Terra JavaScript and Python SDKs.
-
Ensure the same version of
osmosisdand LocalOsmosis are installed. -
Use
osmosisdto talk to your LocalOsmosisosmosisdnode:
osmosisd statusThis command automatically works because osmosisd connects to localhost:26657 by default.
The following command is the explicit form:
osmosisd status --node=tcp://localhost:26657- Run any of the
osmosisdcommands against your LocalOsmosis network, as shown in the following example:
osmosisd query account osmo1l0jjmvdtj4c3f8cxzzgfhq0zhdzf2x8cgpg056The majority of LocalOsmosis is implemented through a docker-compose.yml file, making it easily customizable. You can use LocalOsmosis as a starting template point for setting up your own local Osmosis testnet with Docker containers.
Out of the box, LocalOsmosis comes preconfigured with opinionated settings such as:
- ports defined for RPC (26657) and LCD (1317)
- standard accounts
You can modify the node configuration of your validator in the config/config.toml and config/app.toml files.
To decrease block time, edit the [consensus] parameters in the config/config.toml file, and specify your own values.
The following example configures all timeouts to 200ms:
##### consensus configuration options #####
[consensus]
wal_file = "data/cs.wal/wal"
- timeout_propose = "3s"
- timeout_propose_delta = "500ms"
- timeout_prevote = "1s"
- timeout_prevote_delta = "500ms"
- timeout_precommit_delta = "500ms"
- timeout_commit = "5s"
+ timeout_propose = "200ms"
+ timeout_propose_delta = "200ms"
+ timeout_prevote = "200ms"
+ timeout_prevote_delta = "200ms"
+ timeout_precommit_delta = "200ms"
+ timeout_commit = "200ms"Additionally, you can use the following single line to configure timeouts:
sed -E -i '/timeout_(propose|prevote|precommit|commit)/s/[0-9]+m?s/200ms/' config/config.tomlYou can change the genesis.json file by altering config/genesis.json. To load your changes, restart your LocalOsmosis.
LocalOsmosis is pre-configured with one validator and 10 accounts with ION and OSMO balances.
| Account | Address | Mnemonic |
|---|---|---|
| validator | osmo1l0jjmvdtj4c3f8cxzzgfhq0zhdzf2x8cgpg056terravaloper1dcegyrekltswvyy0xy69ydgxn9x8x32zdy3ua5 |
artefact coral banana cereal split tower produce topple grow tennis juice fiber health easy song vessel uncover online cycle team struggle pattern spider tomorrow |
| test1 | osmo13wywdhs4pu605ra7f85aczcnmfhdu4xfrphlyp |
salad lecture coach machine enough suffer cost nut gaze clever dismiss castle sustain armed display scheme forget gasp mutual alarm miracle online tomato nature |
| test2 | osmo13vzhfxds5sflq2hsq77z3clztkdxs30mwza78s |
multiply panel hole remind flush chapter scan true one fancy cable combine venture wagon nose fatal there toast middle prison lumber tail empower current |
| test3 | osmo19fzuy7e8cy8y4v9dv6gv0xtpdpqt530sf8ctn9 |
caught dad suit staff come pause trigger bleak economy ostrich food crawl taxi wrong day damage alpha deer humble fault debate they excite scrub |
| test4 | osmo12jlcxnyh0gxjtvy4cdxlwqggw39w5dhg7wq8gh |
flavor receive field puppy mesh tired tone long venture bright truck detail goose they fan slush cram fix gold hire midnight cannon kiwi quit |
| test5 | osmo1gp5yl0x8dcj42xmx7hyjp7j5fwe788ht4keanc |
require lemon mechanic forward team maid kiss escape combine wrist resource jealous spring police couple design fork era lunar crunch resist differ size lounge |
| test6 | osmo1hrt9t9wc7q6htgq3xhss4g9txxn9mchgd5jf0c |
churn long tragic robust under surprise eyebrow whale guilt aerobic bronze again tank cash runway lucky resemble tobacco idea turn ice express churn acoustic |
| test7 | osmo1axxc8sswmvwd5q3hgq6upz9dejj8qadsgw5g53 |
miss middle hover receive weather roof swap lava luxury cloud focus stadium wage hover all purity omit flush message lend fiscal choose rug simple |
| test8 | osmo1hguhwtag9tfsva0n2ejugkhm48txu20eql882z |
april current put adjust point move moment soap hood sun flavor hurdle venue mushroom acquire squeeze win coffee draft urge path roast flame close |
| test9 | osmo1g44fj3swmf3muzh8rd72ffr7pqld8jasu2fmc7 |
average walnut harbor fan arrive culture area night quote wrong magnet depend scene merit blast result paddle original version prefer ice ecology across trigger |
| test10 | osmo1etkjkyrknvue3w6mlv76c6dhm3e00q5xvz5p4c |
control print cruise room rocket excuse lawsuit sniff awake valley achieve cement casino arm produce rubber panda online van loyal myth chaos enact aspect |