{"id":13566703,"url":"https://github.com/BitCannaGlobal/bcna","last_synced_at":"2025-04-04T00:32:03.526Z","repository":{"id":36304247,"uuid":"388125160","full_name":"BitCannaGlobal/bcna","owner":"BitCannaGlobal","description":"BitCanna Blockchain based on Cosmos SDK","archived":false,"fork":false,"pushed_at":"2024-05-18T17:14:07.000Z","size":158172,"stargazers_count":46,"open_issues_count":9,"forks_count":77,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-05-19T00:35:25.302Z","etag":null,"topics":["blockchain","cannabis","cryptocurrency","decentralized","ledger","p2p","payments"],"latest_commit_sha":null,"homepage":"https://www.bitcanna.io","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BitCannaGlobal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-21T13:26:43.000Z","updated_at":"2024-05-27T13:31:48.654Z","dependencies_parsed_at":"2023-12-05T13:31:05.330Z","dependency_job_id":"6b13be1e-0ece-469b-b3f5-8a885374766a","html_url":"https://github.com/BitCannaGlobal/bcna","commit_stats":null,"previous_names":[],"tags_count":76,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitCannaGlobal%2Fbcna","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitCannaGlobal%2Fbcna/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitCannaGlobal%2Fbcna/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitCannaGlobal%2Fbcna/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BitCannaGlobal","download_url":"https://codeload.github.com/BitCannaGlobal/bcna/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223075372,"owners_count":17083506,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","cannabis","cryptocurrency","decentralized","ledger","p2p","payments"],"created_at":"2024-08-01T13:02:15.006Z","updated_at":"2025-04-04T00:32:03.520Z","avatar_url":"https://github.com/BitCannaGlobal.png","language":"TypeScript","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Warning ⚠️ Project is officially discontinued 😢\n- Read the announcement made on 24th Dec 2024 at: https://www.bitcanna.io\n\n# BitCanna Blockchain\n[![compile bcna](https://github.com/BitCannaGlobal/bcna/actions/workflows/build.yml/badge.svg)](https://github.com/BitCannaGlobal/bcna/actions/workflows/build.yml) [![golangci-lint](https://github.com/BitCannaGlobal/bcna/actions/workflows/golangci-lint.yml/badge.svg)](https://github.com/BitCannaGlobal/bcna/actions/workflows/golangci-lint.yml)\n\nBitCanna provides a decentralized payment network, supply chain and trust network for the legal cannabis industry by utilizing the BCNA coin.\n\n\u003e [Current version (v4.0.1)](https://github.com/BitCannaGlobal/bcna/releases/tag/v4.0.2) of our development uses Cosmos SDK v0.50.10 \u0026 CometBFT v0.38.15 \u0026 IBC-go v8.5.2\n\nThese docs at Github are chain related. For more information about our coin, partners and roadmap visit:\n* Our website: https://www.bitcanna.io\n* Our docs platform: https://docs.bitcanna.io\n\n## Hardware Requirements\nHere are the minimal hardware configs required for running a validator/sentry node:\n\n* 8GB RAM \n* 4vCPUs (8vCPUs is recommended)\n* 200GB - 300GB SSD Disk space per year (NVMe disks are recommended)\n* 400 Mbit/s bandwidth (800Mbit/s - 1Gbit/s recommended)\n\n## Software Requirements\n* Linux server (Ubuntu 20/22 server recommended)\n* Go version v1.23.3\n\n\u003e 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.\n\n## Genesis file\n* [Link to Genesis file](https://raw.githubusercontent.com/BitCannaGlobal/bcna/main/genesis.json)\n\n## Binary / Upgrades table\n\n| Upgrade Date | Upgrade Height | Binary Path | Release GitHub | Release notes |\n| -------- | -------- | -------- | ------- | ------- |\n| 11th Aug 2022 15.00h CET    | 2.092.453    | [v1.3.1](https://github.com/BitCannaGlobal/bcna/releases/download/v.1.3.1/bcnad)    | [Link](https://github.com/BitCannaGlobal/bcna/releases/tag/v.1.3.1) | [-NA-]() |\n| 11th Aug 2022 15.00h CET    | 4.490.420    | [v1.4.1](https://github.com/BitCannaGlobal/bcna/releases/download/v1.4.1/bcna_linux_amd64.tar.gz)    | [Link](https://github.com/BitCannaGlobal/bcna/releases/tag/v1.4.1) | [Doc](https://github.com/BitCannaGlobal/bcna/blob/main/last_upgrade.md#v141-codename-strangebuddheads-halt-chain-on-11th-of-august-2022) |\n| 7th Nov 2022 15.00h CET    | 5.787.420    | [v1.5.3](https://github.com/BitCannaGlobal/bcna/releases/download/v1.5.3/bcna_linux_amd64.tar.gz)    | [Link](https://github.com/BitCannaGlobal/bcna/releases/tag/v1.5.3) | [Doc](https://github.com/BitCannaGlobal/bcna/blob/main/last_upgrade.md#v153-codename-trichomemonster-ica---from-v145) |\n| 2nd Mar 2023 16.20h CET    | 7.467.420   | [v1.6.0-fix](https://github.com/BitCannaGlobal/bcna/releases/download/v1.6.0-fix/bcna_linux_amd64.tar.gz)   |  [Link](https://github.com/BitCannaGlobal/bcna/releases/tag/v1.6.0-fix) | [Doc](https://github.com/BitCannaGlobal/bcna/blob/main/last_upgrade.md#v160-fix-codename-vigorous-grow---from-v153) |\n| 10th Mar 2023 18.40h CET    | 7.585.420   | [v1.6.3](https://github.com/BitCannaGlobal/bcna/releases/download/v1.6.3/bcna_linux_amd64.tar.gz)   |  [Link](https://github.com/BitCannaGlobal/bcna/releases/tag/v1.6.3) | [Doc](https://github.com/BitCannaGlobal/bcna/blob/main/last_upgrade.md#v161-codename-vigorous-grow-fix---from-v161) |\n| 30th May 2023 15.40h CEST    | 8.771.420   | [v1.7.0](https://github.com/BitCannaGlobal/bcna/releases/download/v1.7.0/bcna_linux_amd64.tar.gz)   |  [Link](https://github.com/BitCannaGlobal/bcna/releases/tag/v1.7.0) | [Doc](https://github.com/BitCannaGlobal/bcna/blob/main/last_upgrade.md#v170-codename-vigorous-grow-huckleberry-from-v163) |\n| 29th Jun 2023 16.20h CEST    | 9.209.420   | [v2.0.2](https://github.com/BitCannaGlobal/bcna/releases/download/v2.0.2/bcna_linux_amd64.tar.gz)   |  [Link](https://github.com/BitCannaGlobal/bcna/releases/tag/v2.0.2) | [Doc](https://github.com/BitCannaGlobal/bcna/blob/main/last_upgrade.md) |\n| 25th Jan 2024 16.35h CET    | 12.288.420   | [v3.0.2](https://github.com/BitCannaGlobal/bcna/releases/download/v3.0.2/bcna_linux_amd64.tar.gz)   |  [Link](https://github.com/BitCannaGlobal/bcna/releases/tag/v3.0.2) | [Doc](https://github.com/BitCannaGlobal/bcna/blob/main/last_upgrade.md) |\n| 10th May 2024 16.55h CET    | 13.846.420   | [v3.1.0](https://github.com/BitCannaGlobal/bcna/releases/download/v3.1.0/bcna_linux_amd64.tar.gz)   |  [Link](https://github.com/BitCannaGlobal/bcna/releases/tag/v3.1.0) | [Doc](https://github.com/BitCannaGlobal/bcna/blob/main/last_upgrade.md) |\n| 25th Nov 2024 17.20h CET    | 16.782.000   | [v4.0.1](https://github.com/BitCannaGlobal/bcna/releases/download/v4.0.1/bcnad_linux_amd64.tar.gz)   |  [Link](https://github.com/BitCannaGlobal/bcna/releases/tag/v4.0.1) | [Doc](https://github.com/BitCannaGlobal/bcna/blob/main/last_upgrade.md) |\n\n\u003e Current version: https://github.com/BitCannaGlobal/bcna/releases/tag/v4.0.2\n\n# How to join `bitcanna-1` chain\n\u003e Tip: At the end of this doc, you will find links with important info\n\nThe necessary steps to join to `bitcanna-1` chain are:\n\n## 1. Install / Compile last binary\nCheck this [link](https://github.com/BitCannaGlobal/bcna/blob/main/1.install-compile.md) to find instructions to install or compile our latest release.\n\n##   2. Sync the chain\nYou can sync the chain in your server to run a validator or a simple node/peer.\n**Select one method of the below:**\n###   2.1. Sync using a StateSync snapshot server.\nThis is the recommended option for new nodes/validators.\n\nBy downloading the StateSync script, you will sync the last blocks of the chain from two BitCanna StateSync servers. \n\nThe 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!\n* https://github.com/BitCannaGlobal/bcna/blob/main/2.1.statesync.md\n\n###   2.2. Sync using a snapshot file\nThis is an alternative way to get synced without having to download the entire chain block by block. Recommended for advanced users in Cosmos chains.\n* https://github.com/BitCannaGlobal/bcna/blob/main/2.2.snapshot.md\n\n\n\n##   3. Create a validator\nYour 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/)\n\n**You will need coins:**\nSend 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).\n* https://app.osmosis.zone/\n* https://app.rango.exchange/\n* https://coinmerce.io/\n\n\n\n### 3.1. **Set the chain-id parameter** \n```\n    bcnad config chain-id bitcanna-1\n```\n### 3.2. **MemPool custom settings**\n   \n   Before start you need to set this custom config for MemPool at `.bcna/config/config.toml/` to prevent Spam Storms: (reset the binary to apply)\n   * max_tx_bytes = 524288\n   * max_txs_bytes = 268435456\n     \n```bash\nsed -i 's/^max_tx_bytes =.*/max_tx_bytes = 524288/' $HOME/.bcna/config/config.toml \u0026\u0026 \\\nsed -i 's/^max_txs_bytes =.*/max_txs_bytes = 268435456/' $HOME/.bcna/config/config.toml\n```\n       \n### 3.3.  **Create a wallet**:\nYou 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)\n```\n    bcnad keys add MyFirstAddress\n```\n```\n      name: MyFirstAddress\n      type: local\n      address: bcna14shzreglay98us0hep44hhhuy7dm43snv38plr\n      pubkey: bcnapub1addwnpepqvtpzyugupvcu773rzdcvhele6e22txy2zr235dn7uf8t2mlqcarcyx2gg9\n      mnemonic: \"\"\n      threshold: 0\n      pubkeys: []\n\n    deposit daring slim glide hello dolphin expire stoner cluster vivid orphan work pond section client friend yellow west hamster torch settle island opinion gloom\n```\n\u003e It is very important to write this mnemonic phrase in a safe place.\nIt is the only way to recover your account if you ever forget/lose your password.\n```\n    deposit daring slim glide hello dolphin expire stoner cluster vivid orphan work pond section client friend yellow west hamster torch settle island opinion gloom\n```\n\n### 3.4. **Start the daemon**\nIf you are running the binary as a service use:\n```bash\nsudo service bcnad restart\n```\nIf you are running the binary without a service (note that it is always advised to run the binary as a service):\n```bash\nbcnad stop (or use CTRL + C in the terminal window where the binary is running)\nbcnad start\n```  \n### 3.5. **Send the _Create validator_ TX:**\n\n\u003e We recommend you read the [FAQ Chain's guide](https://github.com/BitCannaGlobal/bcna/blob/main/faq_chain.md) to understand all parameters - be aware that some values are permanent and cannot be changed at a later date.\n\nWhen you have your **node synced** and your **wallet funded with coins**, send the TX to become _validator_ (change _wallet_name_ and _moniker_):\n\u003e You can use quotes to include spaces and more than two words\n`--from \"Royal Queen Seeds\"`\n\n```\nbcnad tx staking create-validator \\\n    --amount 1000000ubcna \\\n    --commission-max-change-rate 0.10 \\\n    --commission-max-rate 0.2 \\\n    --commission-rate 0.1 \\\n    --from WALLET_NAME \\\n    --min-self-delegation 1 \\\n    --moniker YOUR_MONIKER \\\n    --pubkey $(bcnad tendermint show-validator) \\\n    --chain-id bitcanna-1 \\\n    --gas auto \\\n    --gas-adjustment 1.5 \\\n    --gas-prices 0.001ubcna\n```\n\nYou can check the list of validators (also in [Explorer](https://explorer.bitcanna.io/validators)):\n\n```\nbcnad query staking validators --output json| jq\n```\n\n##   4. Backup the keys and config\nMaking a backup of the Validator private keys and node keys is very important. Store them encrypted also.\n### 4.1. Backup your Validator_priv_key:\n\n```\ntar -czvf validator_key.tar.gz .bcna/config/*_key.json \ngpg -o validator_key.tar.gz.gpg -ca validator_key.tar.gz\nrm validator_key.tar.gz\n```\nThis will create a GPG encrypted file with both key files.\nYou can download the `validator_key.tar.gz.gpg`  file to your computer.\n\n### 4.2. Export the wallet key (if you have backup the seeds keys is enough)\n```\nbcnad keys export MyFisrstAddress\n```\n```\nEnter passphrase to encrypt the exported key: passwordForCryptThisKey\nEnter keyring passphrase: TheWalletPassword \n-----BEGIN TENDERMINT PRIVATE KEY-----\nsalt: BEC519DA3C1A3BDFC74D799FE983CA6C\ntype: secp256k1\nkdf: bcrypt\n\ntfguD11614drcOrdnmujAm+c+FbPbAFkYbsHv/qbQ8O9nQjdQCPuXTOZsYLkYopK\nFYgEgITfk980jjUfDTE25BPfJR22csjJM/qzx0Y=\n=vchm\n-----END TENDERMINT PRIVATE KEY-----\n```\nYou can copy\u0026paste the entire text above in a text file. \n\n##   5. Cosmovisor\nCosmovisor is a small process manager for Cosmos SDK application binaries to handle chain upgrades. It works for upgrades that has been approved through governance proposals. In these type of governance proposals the upgrade name and block height is included. If Cosmovisor finds the requirements for this upgrade in the logs of the chain binary, it stops the current binary, switch from the old binary to the new one, and finally restarts the node with the new binary.\n\nFollow this guide to install Cosmovisor on your node. \n* https://github.com/BitCannaGlobal/bcna/blob/main/5.cosmovisor.md\n\n# Links to important info\n\n## Explorers:\n* [BitCanna Explorer](https://explorer.bitcanna.io)\n* [Ping-Pub explorer](https://ping.pub/bitcanna/uptime)\n* [Valopers](https://bitcanna.valopers.com/)\n\n## Wallets\n* [BitCanna web wallet](https://wallet.bitcanna.io)\n* [BitCanna Mobile Android](https://play.google.com/store/search?q=bitcanna\u0026c=apps)\n* [Ping-Pub web wallet](https://ping.pub/wallet/accounts)\n* [Cosmostation iOS](https://apps.apple.com/kr/app/cosmostation/id1459830339)\n* [Cosmostation Android](https://play.google.com/store/apps/details?id=wannabit.io.cosmostaion)\n\n## Genesis file\n* [bitcanna-1](https://raw.githubusercontent.com/BitCannaGlobal/bcna/main/genesis.json)\n\n## Peer, seeds and public service providers\n* [BitCanna Chain Registry](https://github.com/BitCannaGlobal/bcna/blob/main/chain-registry.json) (Mandatory for Team's Delegation Program)\n* [BitCanna DEVET-1 Chain Registry](https://github.com/BitCannaGlobal/bcna/blob/main/devnets/bitcanna-dev-1/chain-registry.json) (Mandatory for Team's Delegation Program)\n* [Cosmos Chain Registry](https://github.com/cosmos/chain-registry/tree/master/bitcanna)\n\n## Archived Guides, FAQs \u0026 docs\n* [BitCanna Docs](https://docs.bitcanna.io)\n* [GitHub Testnet \u0026 DevNet archive](https://github.com/BitCannaGlobal/testnet-bcna-cosmos/tree/main/instructions)\n* [Current DevNet](https://github.com/BitCannaGlobal/bcna/tree/main/devnets/bitcanna-dev-1)\n* [Old Instructions guide](https://github.com/BitCannaGlobal/bcna/blob/main/archived_guides/instructions.md)\n* [How to perform a manual upgrade](https://github.com/BitCannaGlobal/bcna/blob/main/archived_guides/manual_update.md)\n* [How to perform an upgrade with Cosmovisor (v5.0)](https://github.com/BitCannaGlobal/bcna/blob/main/5.cosmovisor.md)\n\n###### tags: `doc` `github`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBitCannaGlobal%2Fbcna","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBitCannaGlobal%2Fbcna","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBitCannaGlobal%2Fbcna/lists"}