Instant, zero-config Terra blockchain and ecosystem.
What is LocalTerra?
LocalTerra is a complete Terra testnet and ecosystem containerized with Docker and orchestrated with a simple docker-compose file, designed to make it easy for smart contract developers to test out their contracts on a sandboxed environment before moving to a live testnet or mainnet.
LocalTerra comes pre-configured with opinionated, sensible defaults for a standard testing environment. If other projects mention testing on LocalTerra, they are referring to the settings defined in this repo.
The advantages of LocalTerra over a public testnet are that:
- world state is easily modifiable
- quick to reset for quick iterations
- easy to simulate different scenarios
- validator behavior is controllable
Requirements
- Docker installed and configured on your system
docker-compose- Supported known architecture: x86_64
Usage
$ git clone https://www.github.com/terra-project/LocalTerra
$ cd LocalTerraMake sure your Docker daemon is running in the background and docker-compose is installed. Then start LocalTerra:
$ docker-compose upYou should now have an environment with the following:
- terrad RPC node running on
tcp://localhost:26657 - LCD running on http://localhost:1317
- FCD running on http://localhost:3060
- an oracle feeder feeding live prices from mainnet, trailing by 1 vote period
If you need to turn off LocalTerra:
$ docker-compose downTo reset the world state, issue the following:
$ docker-compose rmLocalTerra and...
Terra Station
Terra Station has built-in support for LocalTerra, which enables you to interact with your LocalTerra. Open up station and switch to the Localterra network:
terracli
Make sure you have the same version of terracli installed as LocalTerra. Then, you can use terracli to talk to your LocalTerra terrad node:
$ terracli statusThis automatically works because terracli connects to localhost:26657 by default. More explicitly:
$ terracli status --node=tcp://localhost:26657You should now be able to issue normal commands with terracli against your LocalTerra network:
$ terracli query account terra1dcegyrekltswvyy0xy69ydgxn9x8x32zdtapd8Jigu
You can connect to the chain through LocalTerra's LCD server.
from jigu import Terra
terra = Terra("localterra", "http://localhost:1317")Terra.js
You can connect to the chain using LCDClient against LocalTerra's LCD server.
import { LCDClient } from "@terra-money/terra.js";
const terra = new LCDClient({
URL: "http://localhost:1317",
chainId: "localterra",
});Configuring LocalTerra
Since the majority of LocalTerra is implemented through a docker-compose.yml file, it is easily customizable and can be considered a starting template point for setting up your own local Terra testnet with Docker containers. Out-of-the-box, LocalTerra comes preconfigured with opinionated settings such as:
- ports defined for RPC (26657), LCD (1317) and FCD (3060)
- standard accounts (shown below)
Modifying Node Configuration
You can modify the node configuration of your validator in config/config.toml and config/app.toml.
Modifying Genesis
If you need to change the genesis.json file, you can alter it in config/genesis.json. This will get loaded when you reset your LocalTerra network.
Accounts
LocalTerra is pre-configured with one validator and 10 accounts with LUNA balances.
| Account | Address | Mnemonic |
|---|---|---|
| validator | terra1dcegyrekltswvyy0xy69ydgxn9x8x32zdtapd8terravaloper1dcegyrekltswvyy0xy69ydgxn9x8x32zdy3ua5 |
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 | terra1x46rqay4d3cssq8gxxvqz8xt6nwlz4td20k38v |
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 | terra17lmam6zguazs5q5u6z5mmx76uj63gldnse2pdp |
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 | terra1757tkx08n0cqrw7p86ny9lnxsqeth0wgp0em95 |
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 | terra199vw7724lzkwz6lf2hsx04lrxfkz09tg8dlp6r |
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 | terra18wlvftxzj6zt0xugy2lr9nxzu402690ltaf4ss |
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 | terra1e8ryd9ezefuucd4mje33zdms9m2s90m57878v9 |
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 | terra17tv2hvwpg0ukqgd2y5ct2w54fyan7z0zxrm2f9 |
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 | terra1lkccuqgj6sjwjn8gsa9xlklqv4pmrqg9dx2fxc |
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 | terra1333veey879eeqcff8j3gfcgwt8cfrg9mq20v6f |
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 | terra1fmcjjt6yc9wqup2r06urnrd928jhrde6gcld6n |
prefer forget visit mistake mixture feel eyebrow autumn shop pair address airport diesel street pass vague innocent poem method awful require hurry unhappy shoulder |
License
This software is licensed under the MIT license.
© 2020 Terraform Labs, PTE.
