Block Collider & Borderless Markets

Documentation, market information and support for Miners and Market Makers.

Get Started Forum & Support Developer API

Tutorial: Block Collider Miner

Whether you are new to mining a blockchain or are an experienced pro, mining the Block Collider network is easy and this guide serves as the recommended method of getting started.

Mining Block Collider is the main way to earn rewards (NRG tokens) from the network, as well as the only way to access the Borderless Marketplace.

For a quick refresher on what it means to mine a blockchain, review Sections 1 & 2 on this site.


System Requirements

Software

  • Windows: Windows 8 Pro (hypervisor support) through Windows 10 (hypervisor support)
  • Linux: Ubuntu 16.04 LTS or greater up to Ubuntu 19.04
  • Mac: OSX 10.8+

Hardware

- 22 GB HDD, 8GB RAM (minimum 6GB)


To begin mining, proceed with the following steps:

1. Create Your Wallet: Store It Someplace Safe

In order to mine Block Collider you will need to assign an account (AKA: 'wallet') to your miner so any potential rewards from mining have a place to be stored. The specific account ('wallet') you will need is a Block Collider wallet, for the Block Collider currency: NRG.

Making a wallet is very simple, you can follow the steps below to generate your Block Collider wallet!

Create Your Wallet

This process has a few steps but is very straight forward, and will be familiar to those who have created blockchain wallets in the past.

First go to this page:
Borderless Wallet Website

Then click the box labelled "Generate BSEC Wallet":

Save That File!

You now have a file that has everything you need to mine! Next, you need to save it to your computer. Click "Just Download Wallet". This will automatically save a wallet file (.json) to your computer. The file can be opened in Text Editor or similar programs and contains your Public and Private keys.

❗️

IMPORTANT:

You MUST save your wallet file (wallet.json) or you will not be able to access your wallet in the future.

This should worry you.

While cryptocurrencies provide unparalleled technological security, the cost of this security is that there is no "undo" button or "password reset" for your wallet. If you lose your Private Key, there is no failsafe.

We recommend taking the security and privacy of your wallet very seriously. Rule of thumb is do everything as slow as possible, especially the first time.

Here is a video with some popular ways of ensuring that your wallet (that new file) is secure: https://www.youtube.com/watch?v=Dtsmrb4Gyck

In the screen above, there is a string of text that is labelled Address:

Address:
<YOUR_PUBLIC_ADDRESS>

Copy that text of the "<YOUR_PUBLIC_ADDRESS>" on that page, or leave it open and available to copy, because you will need to paste the <YOUR_PUBLIC_ADDRESS> into a command later that will start your miner and give you credit for using your computer to run the network.

2. Install "Docker": Time To Download

Starting up the Block Collider miner from scratch is very useful for advanced users. In order to level the playing field for users just getting started, a tool called "Docker" will help take care of the complicated bits and allow us to run our miner using one command!

"Install "Docker"

The steps to download Docker Community Edition are straightforward. Depending on your computer's operating system, click the correct link below:

*Older versions of Mac or Windows may not be able to use Docker Desktop and may consider trying Docker Toolbox. However, while some individuals running on old machines have successfully used Docker Toolbox, this is not officially supported.

"Docker for Mac" download page. Click Get Docker to download and get started.

Once the Docker application is installed, all that is necessary to begin mining is to run the command that gets your computer started!

3. Start Your Miner

If you are using a Windows machine open the pre-installed program called Command Prompt (may also be called "CMD Prompt").
If you are using a Mac or Linux computer then open the application called Terminal (pre-installed on all Mac/Linux machines).

The command below is the recommended template for your "start running my miner" command. You only need to update one thing:

  • Replace <YOUR_PUBLIC_ADDRESS> in the command below with the Public Address you copied earlier in step #1 when you created your wallet.
docker run --rm --name bcnode \
--memory-reservation="6900m" \
-p 3000:3000 -p 16060:16060 -p 16061:16061 -p 36061:36061 -p 36060:36060 \
-e BC_MINER_KEY="<YOUR_PUBLIC_ADDRESS>" \
-e BC_NETWORK="main" \
-e BC_FORCE_MINE=true \
-e MIN_HEALTH_NET=true \
-e NODE_OPTIONS=--max_old_space_size=6096 \
blockcollider/bcnode:latest \
start --rovers --rpc --ws --ui --node --scookie "scookie" 2>&1

👍

NOTE: WINDOWS USERS

A few users have reported the backslash "" does not work in some windows shells. If so replace the <YOUR_PUBLIC_ADDRESS> with your Public Address in the following single line command.

docker run --rm --name bcnode --memory-reservation="6900m" -p 3000:3000 -p 16060:16060 -p 16061:16061 -p 36061:36061 -p 36060:36060 -e BC_MINER_KEY="<YOUR_PUBLIC_ADDRESS>" -e BC_NETWORK="main" -e BC_FORCE_MINE=true -e MIN_HEALTH_NET=true -e NODE_OPTIONS=--max_old_space_size=6096 blockcollider/bcnode:latest start --rovers --rpc --ws --ui --node --scookie "scookie" 2>&1

Copy and paste that command, with the updated text, into your Terminal or Command Prompt.

Hit the return/enter key and that’s it!

You are officially powering up Block Collider on your machine.

It may take 20 or 30 minutes for everything to sync between you and the network. Once complete, you are officially mining Block Collider!!

Congratulations!

👍

NOTE: Enable BC_DEV_MODE to speed up sync time

By adding the variable -e BC_DEV_MODE=true \ to your run command, miners can skip the process of waiting to sync the entire chain and use snapshots of the Block Collider chain to accomplish a majority of the heavy lifting to achieve initial sync. This is to be used with the understanding that this snapshot functionality is for the purposes of continued testing and is not a recommended feature.

👍

NOTE: Change "scookie" for advanced RPC calls or use of Portfolio.

For the purposes of mining, "scookie" in the commands above can be left as is. However, if you want to use the more advanced features of Block Collider like using the RPC API calls or viewing balances on the Portfolio page, "scookie" will need to be a unique value that only you know (can be changed each time you run the miner).

👍

NOTE: Ngrok Tunnel for Portfolio

For users who wish to see their balances in the Portfolio Website, adding the variable -e BC_TUNNEL_HTTPS=true \ to the command, will create an ngrok* https tunnel to your docker containers server. The tunnel of the address is logged during the startup in the app log (SCREENSHOT). This URL should replace "localhost" in the BC Miner Hostname input in the settings section of the Portfolio. You can also view the tunnel address by making the RPC call "getSettings". You can read more about that here.

*ngrok is a third party service and miners should use it at their own discretion

What's Next?: Check Your NRG Balance

Now that you’re mining the Block Collider, you are being rewarded in NRG!

📘

Helpful Link:

For more information on NRG, refer to this document.

You can view your accumulated NRG balance by visiting https://multiverse.blockcollider.org and searching for your "YOUR_PUBLIC_ADDRESS" that you copied earlier.

An alternative method of checking your balance can be achieved by going to the Borderless Wallet Page and viewing the NRG balances section from the wallet you created before. If your session has ended (and you are taken to the "Generate BSEC Wallet" page from earlier) simply select the Import option and then upload the .json file you downloaded and saved from earlier.

What's Next?: View Your Own Multiverse

By running your own Block Collider node, you can view detailed information about the multichain you are now contributing to!

You can do this by navigating to http://localhost:3000/ once you begin syncing. This will take you to your own "multiverse" that is getting created through the process of syncing with the network. Obviously until a miner achieves full sync there will be differences between your multiverse and the one found on multiverse.blockcollider.org.

👍

NOTE: Cross check your multiverse with the Multiverse web page

A good way to verify that your miner is running as expected is to visit multiverse.blockcollider.org and check block height (for BC chain and other child chains) and cross reference them with your localhost version.

Updated 3 months ago


Next

For Mining FAQs, continue to the following page.

Mining: FAQs

Tutorial: Block Collider Miner


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.