0Chain
Search…
Get Started
This section covers ZWallet CLI concepts, repository configuration, and installation.
Concepts
Wallet
A wallet is required to hold the tokens. It comes with private and public keys including a secret mnemonic key.
MultiSignature Wallet
A Multisignature Wallet is a wallet for which any transaction from this wallet needs to be voted by T(N) associated signer wallets. To create a Multisignature Wallet, you need to specify the number of signers (N) you want on that wallet and minimum number of votes (T) it needs for a transaction to be approved.
dStorage
Its distributed storage where all the data files are stored.
System requirements
To properly build components, you must have a Machine setup with the following requirements:
- Windows,Linux ,Mac OS (Linux with ubuntu 18.04 preferred)
- 4 vCPU, 8 Gb Memory at minimum
- 50 GB of space to store the ZWallet build components.
We will be building and describing Zbox CLI capabilities on Ubuntu Linux. So If you want to build Zbox CLI on other platforms.
Follow this guide for Windows and other Platforms and move straight to the Creating a Wallet section.
Prerequisites
Installing and running the ZWallet requires deployment-specific dependencies to be preinstalled.
GoLang Binaries
Build-Essential
The build**-**essential package is required to build and make Zbox application. It includes the necessary GCC/g++ compilers and other essential critical libraries and utilities.
Run apt update command to update the packages.
1
sudo apt update
Copied!
Get Build-essential package.
1
sudo apt-get install build-essential
Copied!
Git
Git is required to retrieve and clone the Zbox repository. Install Git by using the command
1
sudo apt install git
Copied!
Building ZWallet
1. Clone the Zbox Repository using the command
1
git clone https://github.com/0chain/zwalletcli.git
Copied!
2. Navigate into Zboxcli directory using
1
cd zwalletcli
Copied!
3. Use the make install command to compile the source code.
1
make install
Copied!
This might take couple of minutes. Sample output after successful compiling:
Configure ZWallet network
Configuration for the 0chain network by default is stored in
network/one.yaml file of the zwallet github repo which we will copy to a new config.yaml file in our local system . The config.yaml file and all the other 0chain components information will be stored in a .zcn folder located in the home directory of the file system.1.Make a new .zcn folder in the home Linux directory using
1
mkdir $HOME/.zcn
Copied!
2. Copy the content from one.yaml to a new config.yaml file using
1
cp network/one.yaml $HOME/.zcn/config.yaml
Copied!
3. To verify whether the config.yaml exists and network configuration is stored properly. Check the config.yaml details using the command
1
nano config.yaml
Copied!
Response :
1
---
2
block_worker: https://one.devnet-0chain.net/dns
3
signature_scheme: bls0chain
4
min_submit: 50
5
min_confirmation: 50
6
confirmation_chain_length: 3
7
max_txn_query: 5
8
query_sleep_time: 5
9
# # OPTIONAL - Uncomment to use/ Add more if you want
10
# preferred_blobbers:
11
# - http://one.devnet-0chain.net:31051
12
# - http://one.devnet-0chain.net:31052
Copied!
Change ZWallet network
- 1.Open the
config.yamlfile located at$HOME/.zcnpath of your system. Theconfig.yamlfile contents should be similar to the code snippet below :
1
---
2
block_worker: https://one.devnet-0chain.net/dns
3
signature_scheme: bls0chain
4
min_submit: 50
5
min_confirmation: 50
6
confirmation_chain_length: 3
7
max_txn_query: 5
8
query_sleep_time: 5
9
# # OPTIONAL - Uncomment to use/ Add more if you want
10
# preferred_blobbers:
11
# - http://one.devnet-0chain.net:31051
12
# - http://one.devnet-0chain.net:31052
13
# - http://one.devnet-0chain.net:31053
Copied!
Zwallet connects to the 0Chain network using the
block_worker field. These network details are automatically fetched from the blockWorker's network API. Preferred Blobbers are also present which you can uncomment for using specified storage providers for handling your files.2. Change the
block_worker field for the desired network. In this case we will change it to beta.0chain.net. After changes it should look similar to the file below:1
---
2
block_worker: https://beta.0chain.net/dns
3
signature_scheme: bls0chain
4
min_submit: 50
5
min_confirmation: 50
6
confirmation_chain_length: 3
7
max_txn_query: 5
8
query_sleep_time: 5
9
# # OPTIONAL - Uncomment to use/ Add more if you want
10
# preferred_blobbers:
11
# - http://beta.0chain.net:31051
12
# - http://beta.0chain.net:31052
13
# - http://beta.0chain.net:31053
Copied!
Starting ZWallet
Start the Zbox by navigating back to ZWalletcli directory using
1
cd zwalletcli
Copied!
and type
1
./zwallet
Copied!
On a successful run you will see a help section like this:
1
Use Zwallet to store, send and execute smart contract on 0Chain platform.
2
Complete documentation is available at https://0chain.net
3
4
Usage:
5
zwallet [command]
6
7
Available Commands:
8
bridge-burn-eth burn eth tokens
9
bridge-burn-zcn burn zcn tokens
10
bridge-client-init init bridge client config (bridge.yaml) in HOME (~/.zcn) folder
11
bridge-get-wzcn-burn get confirmed burn ticket for ethereum burn transaction
12
bridge-get-zcn-burn get the confirmed burn ticket for zcn burn transaction
13
bridge-import-account Import Ethereum account to local key storage (default $HOME/.zcn/wallets)
14
bridge-list-accounts List Ethereum account registered in local key chain
15
bridge-list-auth List authorizers
16
bridge-mint-wzcn mint WZCN tokens using the hash of ZCN burn transaction
17
bridge-mint-zcn mint zcn tokens using the hash of Ethereum burn transaction
18
bridge-owner-init init bridge owner config (owner.yaml) in HOME (~/.zcn) folder
19
bridge-verify verify ethereum transaction
20
completion generate the autocompletion script for the specified shell
21
createmswallet create multisig wallet
22
events List 0chain events.
23
faucet Faucet smart contract
24
fc-config Show facuet configurations.
25
fc-update-config Update the Faucet smart contract
26
getbalance Get balance from sharders
27
getblobbers Get registered blobbers from sharders
28
getid Get Miner or Sharder ID from its URL
29
getlockedtokens Get locked tokens
30
global-config Show global configurations.
31
global-update-config Update global settings
32
help Help about any command
33
ip-config Show interest pool configurations.
34
ip-update-config Update the interest pool configurations.
35
lock Lock tokens
36
lockconfig Get lock configuration
37
ls-miners Get list of all active miners fro Miner SC
38
ls-sharders Get list of all active sharders fro Miner SC
39
mn-config Show miner SC configuration.
40
mn-info Get miner/sharder info from Miner SC.
41
mn-lock Add miner/sharder stake.
42
mn-pool-info Get miner/sharder pool info from Miner SC.
43
mn-unlock Unlock miner/sharder stake.
44
mn-update-config Update the miner smart contract
45
mn-update-node-settings Change miner/sharder settings in Miner SC.
46
mn-update-settings Change miner/sharder settings in Miner SC.
47
mn-user-info Get miner/sharder user pools info from Miner SC.
48
recoverwallet Recover wallet
49
register Registers the wallet with the blockchain
50
sc-config Show storage SC configuration.
51
sc-update-config Update the storage smart contract
52
send Send ZCN tokens to another wallet
53
unlock Unlock tokens
54
verify verify transaction
55
version Prints version information
56
vp-add Add a vesting pool
57
vp-config Check out vesting pool configurations.
58
vp-delete Delete a vesting pool
59
vp-info Check out vesting pool information.
60
vp-list Check out vesting pools list.
61
vp-stop Stop vesting for one of destinations and unlock tokens not vested
62
vp-trigger Trigger a vesting pool work.
63
vp-unlock Unlock tokens of a vesting pool
64
vp-update-config Update the vesting pool configurations.
65
66
Flags:
67
--config string config file (default is config.yaml)
68
--configDir string configuration directory (default is $HOME/.zcn)
69
-h, --help help for zwallet
70
--network string network file to overwrite the network details (if required, default is network.yaml)
71
--silent Do not print sdk logs in stderr (prints by default)
72
--wallet string wallet file (default is wallet.json)
73
74
Use "zwallet [command] --help" for more information about a command.
Copied!
Creating a Wallet
As you can see from the help menu, ZWallet CLI provides a long list of commands to use. Lets begin with creation of wallet on 0Chain decentralized network.
For creating a wallet using ZWallet. Simply run any
zwallet command and it will create a wallet if none exist yet.Here is a sample with
faucet command which will create a wallet with test tokens at default location~/.zcn/wallet.json1
./zwallet faucet --methodName pour --input "new wallet"
Copied!
Verify the content of wallet using cat command:
1
cat ~/.zcn/wallet.json
Copied!
Checking the wallet balance
To check whether the wallet is successfully created, verify the token balance in ZWallet using
1
./zwallet getbalance
Copied!
Note that by default ZWallet checks balance for the wallet specified in
wallet.json file located in the zcn folder in linux home directory.Successful Response for
./zwallet getbalance command:1
Balance: 1 (1.17 USD)
2
Copied!
Getting tokens into the wallet
If getting
Get balance failed.error when running ./zwallet getbalance command. Run the ./zwallet faucet --methodName pour --input "{Pay day}" command and then check the balance again.The
faucet command will get test tokens into the wallet for transactional purposes and make the wallet usable. Successful Response of the faucetcommand:1
Execute faucet smart contract success
Copied!
Now you have a wallet with available ZCN tokens, which can be used with 0chain blockchain and decentralized storage services.
Last modified 1mo ago