README
¶
BitCanna Blockchain
BitCanna provides a decentralized payment network, supply chain and trust network for the legal cannabis industry by utilizing the BCNA coin.
Current version is v1.4.2 - strangeBuddheads (https://github.com/BitCannaGlobal/bcna/blob/main/last_upgrade.md)
Last version (v1.4.2 strangeBuddheads) of our development uses Cosmos SDK v0.45.8 & Tendermint v0.34.21 & IBC-go v3.2.0
These docs at Github are chain related. For more information about our coin, partners and roadmap visit:
- Our website: https://www.bitcanna.io
- Our docs platform: https://docs.bitcanna.io
Hardware Requirements
Here are the minimal hardware configs required for running a validator/sentry node:
- 8GB RAM
- 4vCPUs (8vCPUs is recommended)
- 200GB - 300GB SSD Disk space per year (NVMe disks are recommended)
- 400 Mbit/s bandwidth
Software Requirements
- Linux server (Ubuntu 20/22 server recommended)
- go version go1.18.5
Please avoid cheap VPS providers as a main validator (we suggest using it as a cheap backup). We advise to use a shared dedicated server or a high-end NVMe VPS.
How to join bitcanna-1 chain
Tip: At the end of this doc, you will find links with important info
The necessary steps to join to bitcanna-1 chain are:
1. Install / Compile last binary
Check this link to find instructions to install or compile our latest release.
2. Sync the chain
You can sync the chain in your server to run a validator or a simple node/peer. Select one method of the below:
2.1. Sync using a StateSync snapshot server.
This is the recommended option for new nodes/validators.
By downloading the StateSync script, you will sync the last blocks of the chain from two BitCanna StateSync servers.
The script will setup your folder and config if you start a fresh install. If your node/validator exist will make a backup, syncing and restoring the backup at the end of the script. Choose the best that fits you!
2.2. Sync using a snapshot file
This is an alternative way to get synced without having to download the entire chain block by block. Recommended for advanced users in Cosmos chains.
2.3. Sync the whole chain using cosmovisor
Start to sync from block 1. Automate the upgrades with Cosmovisor by putting the right binaries in the appropriate folder.
3. Create a validator
Your node must be fully synced in order to send the TX of validator creation and start to validate the network. You can check if your node has fully synced by comparing your logs and the latest block in the explorer (https://explorer.bitcanna.io/)
You will need coins: Send coins to your new address, you will need roughly 2 BCNA to run the validator (1 BCNA for self-delegation and a bit more for transactions).
- Set the chain-id parameter
bcnad config chain-id bitcanna-1
- Create a wallet:
You may create a wallet with one or more keys (addresses) using
bcnad; you can choose a name of your own liking (we strongly advice you use one word)
bcnad keys add MyFirstAddress
name: MyFirstAddress
type: local
address: bcna14shzreglay98us0hep44hhhuy7dm43snv38plr
pubkey: bcnapub1addwnpepqvtpzyugupvcu773rzdcvhele6e22txy2zr235dn7uf8t2mlqcarcyx2gg9
mnemonic: ""
threshold: 0
pubkeys: []
deposit daring slim glide hello dolphin expire stoner cluster vivid orphan work pond section client friend yellow west hamster torch settle island opinion gloom
It is very important to write this mnemonic phrase in a safe place. It is the only way to recover your account if you ever forget/lose your password.
deposit daring slim glide hello dolphin expire stoner cluster vivid orphan work pond section client friend yellow west hamster torch settle island opinion gloom
- Send the Create validator TX:
We recommend you read the FAQ Chain's guide to understand all parameters - be aware that some values are permanent and cannot be changed at a later date.
When you have your node synced and your wallet funded with coins, send the TX to become validator (change wallet_name and moniker):
You can use quotes to include spaces and more than two words
--from "Royal Queen Seeds"
bcnad tx staking create-validator \
--amount 1000000ubcna \
--commission-max-change-rate 0.10 \
--commission-max-rate 0.2 \
--commission-rate 0.1 \
--from WALLET_NAME \
--min-self-delegation 1 \
--moniker YOUR_MONIKER \
--pubkey $(bcnad tendermint show-validator) \
--chain-id bitcanna-1 \
--gas auto \
--gas-adjustment 1.5 \
--gas-prices 0.001ubcna
You can check the list of validators (also in Explorer):
bcnad query staking validators --output json| jq
4. Backup the keys and config
Making a backup of the Validator private keys and node keys is very important. Store them encrypted also.
- Backup your Validator_priv_key:
tar -czvf validator_key.tar.gz .bcna/config/*_key.json
gpg -o validator_key.tar.gz.gpg -ca validator_key.tar.gz
rm validator_key.tar.gz
This will create a GPG encrypted file with both key files.
You can download the validator_key.tar.gz.gpg file to your computer.
- Export the wallet key (if you have backup the seeds keys is enough)
bcnad keys export MyFisrstAddress
Enter passphrase to encrypt the exported key: passwordForCryptThisKey
Enter keyring passphrase: TheWalletPassword
-----BEGIN TENDERMINT PRIVATE KEY-----
salt: BEC519DA3C1A3BDFC74D799FE983CA6C
type: secp256k1
kdf: bcrypt
tfguD11614drcOrdnmujAm+c+FbPbAFkYbsHv/qbQ8O9nQjdQCPuXTOZsYLkYopK
FYgEgITfk980jjUfDTE25BPfJR22csjJM/qzx0Y=
=vchm
-----END TENDERMINT PRIVATE KEY-----
You can copy&paste the entire text above in a text file.
Links to important info
How to upgrade to v.1.4.2 (strangeBuddheads codename)
Explorers:
- BitCanna based on Forbole
- MintScan based on Cosmostation
- Ping-Pub explorer
- Old chain explorer
- ATOMScan explorer
Wallets
Genesis file
Peer, seeds and public service providers
Archived Guides, FAQs & docs
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
testutil
|
|
|
nullify
Package nullify provides methods to init nil values structs for test assertion.
|
Package nullify provides methods to init nil values structs for test assertion. |
|
x
|
|
|
bcna/types
Package types is a reverse proxy.
|
Package types is a reverse proxy. |