Awesome

What is localbostrom?

Localbostrom is a complete bostrom testnet 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.

Localbostrom comes preconfigured with opinionated, sensible defaults for standard testing environments. It also comes with pre-configured cyberindex to allow fast and easy data manipulation and analysis.

Localbostrom has the following advantages over a public testnet:

• Quick to reset for rapid iterations
• Simple simulations of different scenarios
• Controllable validator behavior

Prerequisites

• Docker
• docker-compose
• Supported known architecture: x86_64
• 8+ GB of RAM is recommended

Get localbostrom

1. Run the following commands::

$ git clone https://github.com/cybercongress/localbostrom
$ cd localbostrom

Start, stop, and reset

• Start localbostrom with cyberindex:

$ docker-compose up --detach

Your environment now contains:

• cyber RPC node running on http://localhost:26657

• GRPC endpoint at http://localhost:9090

• LCD running on http://localhost:1317 with swagger at http://localhost:1317/swagger

• GraphQL endpoint on http://localhost:8090

• Start only localbostrom:

$ docker-compose up -d cyber --detach

• Stop localbostrom:

$ docker-compose stop

• Reset the state:

$ docker-compose rm

cyber

1. Ensure the same version of cyber daemon and localbostrom are installed.

2. Use cyber to talk to your localbostrom cyber node:

$ cyber status

This command automatically works because cyber connects to localhost:26657 by default

The following command is the explicit form:

$ cyber status --node=http://localhost:26657

3. Run any of the cyber commands against your localbostrom network, as shown in the following example:

$ cyber query account bostrom1phaxpevm5wecex2jyaqty2a4v02qj7qm5n94ug

4. If you want to hard restart the network (drop state and start from the genesis) you can use hard_restart.sh script

./hard_restart.sh

Cyber SDK for Python

Connect to the chain through localbostrom's LCD server:

from cyber_sdk.client.lcd import LCDClient
cyber = LCDClient("localbostrom", "http://localhost:1317")

Configure localbostrom

The majority of localbostrom is implemented through a docker-compose.yml file, making it easily customizable. You can use localbostrom as a starting template point for setting up your own local Terra testnet with Docker containers.

Out of the box, localbostrom comes preconfigured with opinionated settings such as:

• ports defined for RPC (26657), LCD (1317) and FCD (3060)
• standard accounts
• index config(postgress db params, hasura access params etc.)

Modifying node configuration

You can modify the node configuration of your validator in the config/config.toml and config/app.toml files.

Modifying cyberindex configuration

To modify cyberindex params - edit config, posgtres params could be altered in docker-compose.yml. Changing postgres params require container and ./cyberindex/postgres folder termination and rebuild with:

docker-compose down postgres
rm -rf cyberindex/postgres
edit what you need in `cyberindex/config.yaml`
docker-compose up -d postgres --detach

Modifying genesis

TODO

Accounts

localbostrom is pre-configured with one validator and 10 accounts with boot balances.

Whole setup architecture

.
├── bostrom_config          `folder wich typically is .cyber/config, containd all node configs and params`
│   ├── addrbook.json
│   ├── app.toml
│   ├── client.toml
│   ├── config.toml
│   ├── genesis.json
│   ├── node_key.json
│   └── priv_validator_key.json
├── cyberindex               `folder containing everything relayted to cyberindex`
│   ├── config.yaml          `cyberindex config`
│   ├── postgres             `folder contains postgress db`
│   └── schema               `folder with sql views for db, add yours here to be initiated during postgres startup`
│       ├── 00-cosmos.sql
│       ├── 01-auth.sql
│       ├── 02-bank.sql
│       ├── 03-modules.sql
│       ├── 04-graph.sql
│       ├── 05-grid.sql
│       ├── 06-resources.sql
│       └── 07-wasm.sql
├── data                      `contain all chain data`
│   └── priv_validator_state.json
├── docker-compose.yml
├── hard_restart.sh
└── README.md