Command-Line Interface (CLI)
Smart Contracts & Junod Development
Junod Local Dev Setup
🖥🛠
These settings are only for development use of Juno on a local machine.
Want to use
junod locally for development, or to work with smart contracts? You're in the right place. Running locally is a much easier solution than interacting with a testnet.This guide focusses on running the chain. If you want to build the binary or develop in go, then check out:
Using the Seed User
Juno ships with an unsafe seed user in dev mode when you run the prebuilt docker container below, or one of the options that uses
docker-compose. You can import this user into the CLI by using the mnemonic from the Juno repo, i.e.:1
junod keys add <unsafe-test-key-name> --recover
Copied!
When prompted, add the mnemonic:
1
clip hire initial neck maid actor venue client foam budget lock catalog sweet steak waste crater broccoli pipe steak sister coyote moment obvious choose
Copied!
You will then be returned an address to use:
juno16g2rahf5846rxzp3fwlswy08fz8ccuwk03k57yRun Juno
There is a prebuilt docker image for you to use. This will start a container with a seeded user. The address and mnemonic used here can be found in the
docker/ directory of the repo. When you're done, you can use ctrl+c to stop the container running.Always pick a tagged version to run, ideally one that matches mainnet. The example below may be outdated as Juno releases frequently - you should check the Juno GitHub repository to see which is current for you.
1
docker run -it \
2
--name juno_node_1 \
3
-p 26656:26656 \
4
-p 26657:26657 \
5
-e STAKE_TOKEN=ujunox \
6
-e UNSAFE_CORS=true \
7
ghcr.io/cosmoscontracts/juno:v5.0.1 \
8
./setup_and_run.sh juno16g2rahf5846rxzp3fwlswy08fz8ccuwk03k57y
Copied!
Quick(est) start dev build
The quickest way to get up-and-running for development purposes, as is documented in the main repo, is to run:
1
STAKE_TOKEN=ujunox UNSAFE_CORS=true docker-compose up
Copied!
This builds and runs the node and:
- Creates and initialises a validator
- Adds a default user with a known address (
juno16g2rahf5846rxzp3fwlswy08fz8ccuwk03k57y)
To use a specific version of Juno, check out a tag before running docker compose.
Interacting with Juno in Docker
To call Juno inside a container, use
docker exec like so:1
# compile wasm - run this in your smart contract folder
2
docker run --rm -v "$(pwd)":/code \
3
--mount type=volume,source="$(basename "$(pwd)")_cache",target=/code/target \
4
--mount type=volume,source=registry_cache,target=/usr/local/cargo/registry \
5
cosmwasm/rust-optimizer:0.12.6
6
7
# copy wasm to container
8
docker cp artifacts/your_compiled.wasm juno_node_1:/your_compiled.wasm
9
10
# store wasm
11
docker exec -i juno_node_1 \
12
junod tx wasm store "/your_compiled.wasm" \
13
--gas-prices 0.1ujunox --gas auto --gas-adjustment 1.3 \
14
-y -b block --chain-id testing \
15
--from validator --output json
Copied!
Quickstart on the testnet with a public node
If you don't want to go through the process of setting up a node and just want to experiment with the Juno uni testnet:
- 1.Get a public node's RPC address.
- 2.In
~/.juno/config/client.tomlsetnode="<public node RCP address>"andchain-id="uni-2". - 3.Create a key to use by running
junod keys add <key-name>. - 4.Get that key's public address by running
junod keys show <key-name> -a. - 5.Get some test Juno by sending
$request <key-address>in the #faucet Discord channel.
You can then verify that you have funds by running
junod query bank balances <key-address>. Happy hacking!