go-cyber/networks/local.md

π 0.0%

 

An instant, zero-config local cyber blockchain.


What is local network?

Local network is a complete cyber 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.

It 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.

Advantages over a public testnet:

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

Prerequisites

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

Start, stop, and reset

Start with cyberindex:

docker-compose up --build --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 cyber node:

docker-compose up -d cyber --build --detach

Stop:

docker-compose stop

Reset the state:

docker-compose rm

Hard restart (drop state and start from genesis):

./hard_restart.sh

Usage

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

cyber query account bostrom1phaxpevm5wecex2jyaqty2a4v02qj7qm5n94ug

Cyber SDK for Python

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

Configuration

Node configuration

Edit config/config.toml and config/app.toml.

Cyberindex configuration

Edit cyberindex/config.yaml. Postgres params can be altered in docker-compose.yml. Changing postgres params requires container and ./cyberindex/postgres folder removal:

docker-compose down postgres
rm -rf cyberindex/postgres
docker-compose up -d postgres --detach

Accounts

Pre-configured with one validator and 10 accounts with boot balances.

Account Address Mnemonic
validator bostrom1phaxpevm5wecex2jyaqty2a4v02qj7qm5n94ug
bostromvaloper1phaxpevm5wecex2jyaqty2a4v02qj7qmvfz2vt		 satisfy adjust timber high purchase tuition stool faith fine install that you unaware feed domain license impose boss human eager hat rent enjoy dawn
test1 bostrom1cyyzpxplxdzkeea7kwsydadg87357qnau43779 notice oak worry limit wrap speak medal online prefer cluster roof addict wrist behave treat actual wasp year salad speed social layer crew genius
test2 bostrom18s5lynnmx37hq4wlrw9gdn68sg2uxp5rr7deye quality vacuum heart guard buzz spike sight swarm shove special gym robust assume sudden deposit grid alcohol choice devote leader tilt noodle tide penalty
test3 bostrom1qwexv7c6sm95lwhzn9027vyu2ccneaqaxafy7g symbol force gallery make bulk round subway violin worry mixture penalty kingdom boring survey tool fringe patrol sausage hard admit remember broken alien absorb
test4 bostrom14hcxlnwlqtq75ttaxf674vk6mafspg8x9q5suy bounce success option birth apple portion aunt rural episode solution hockey pencil lend session cause hedgehog slender journey system canvas decorate razor catch empty
test5 bostrom12rr534cer5c0vj53eq4y32lcwguyy7nnxrglz7 second render cat sing soup reward cluster island bench diet lumber grocery repeat balcony perfect diesel stumble piano distance caught occur example ozone loyal
test6 bostrom1nt33cjd5auzh36syym6azgc8tve0jlvk5m8a64 spatial forest elevator battle also spoon fun skirt flight initial nasty transfer glory palm drama gossip remove fan joke shove label dune debate quick
test7 bostrom10qfrpash5g2vk3hppvu45x0g860czur8zpn8w6 noble width taxi input there patrol clown public spell aunt wish punch moment will misery eight excess arena pen turtle minimum grain vague inmate
test8 bostrom1f4tvsdukfwh6s9swrc24gkuz23tp8pd3jdyhpg cream sport mango believe inhale text fish rely elegant below earth april wall rug ritual blossom cherry detail length blind digital proof identify ride
test9 bostrom1myv43sqgnj5sm4zl98ftl45af9cfzk7nu6p3gz index light average senior silent limit usual local involve delay update rack cause inmate wall render magnet common feature laundry exact casual resource hundred
test10 bostrom14gs9zqh8m49yy9kscjqu9h72exyf295azqa4qr prefer forget visit mistake mixture feel eyebrow autumn shop pair address airport diesel street pass vague innocent poem method awful require hurry unhappy shoulder

Dimensions

local

Pages in this namespace

Local Graph