diff --git a/public/images/mining-windows-popup.png b/public/images/mining-windows-popup.png new file mode 100644 index 00000000..5452ca3e Binary files /dev/null and b/public/images/mining-windows-popup.png differ diff --git a/public/images/mining-windows.png b/public/images/mining-windows.png new file mode 100644 index 00000000..ea2c6ec4 Binary files /dev/null and b/public/images/mining-windows.png differ diff --git a/src/pages/mining.md b/src/pages/mining.md index ccdd923b..50c166d4 100644 --- a/src/pages/mining.md +++ b/src/pages/mining.md @@ -22,7 +22,7 @@ Make sure you've followed the [Running testnet node](/stacks-blockchain/running- First, we need to generate a keychain. With this keychain, we'll get some testnet BTC from a faucet, and then use that BTC to start mining. -To get a keychain, the simplest way is to use the `blockstack-cli`. We'll use the `make_keychain` command, and pass `-t` to indicate that we want a testnet keychain. +To get a keychain, the simplest way is to use the `stacks-cli`. We'll use the `make_keychain` command, and pass `-t` to indicate that we want a testnet keychain. ```bash npx @stacks/cli make_keychain -t 2>/dev/null @@ -128,11 +128,15 @@ BLOCKSTACK_DEBUG=1 stacks-node krypton ## Running a miner in Windows +### Prerequisites + +Make sure you've followed the [Running the testnet node on Windows](stacks-blockchain/running-testnet-node#running-the-testnet-node-on-windows) tutorial before starting this tutorial. + ### Generate keychain and get testnet tokens in Windows To setup the miner, first, we need to generate a keychain. With this keychain, we'll get some testnet BTC from a faucet, and then use that BTC to start mining. -To get a keychain, the simplest way is to use the `stacks-cli`.We'll use the `stx make-keychain` command,and pass -t to indicate that we want a testnet keychain. +To get a keychain, the simplest way is to use the `stacks-cli`. We'll use the `stx make-keychain` command, and pass `-t` to indicate that we want a testnet keychain. Generate a keychain: @@ -158,7 +162,10 @@ After this runs, you'll probably see some installation logs, and at the end you Request BTC from faucet: -We need to get some testnet BTC to that address. Grab the btcAddress field, and call the BTC faucet: +We need to get some testnet BTC to that address. Grab the `btcAddress` field, and call the BTC faucet: + +-> Note: The below command needs curl. If you are on Windows 10, version 1803 or later, your OS ships with a copy of curl, already set up and ready to use. +If not, [download and install curl](https://curl.se/windows/). ```bash # replace with `btcAddress` property from your keychain @@ -169,7 +176,7 @@ You'll be sent 0.5 testnet BTC to that address. Don't lose this information - we ### Create configuration file -Now, we need to configure our node to use this Bitcoin keychain. In the `folder where your binary is extracted`, create a new file called `testnet-miner-conf.toml`. +Now, we need to configure our node to use this Bitcoin keychain. In the **folder where your binary is extracted**, create a new file called `testnet-miner-conf.toml`. Paste in the following configuration: diff --git a/src/pages/stacks-blockchain/running-testnet-node.md b/src/pages/stacks-blockchain/running-testnet-node.md index 36a68926..1b9f3c41 100644 --- a/src/pages/stacks-blockchain/running-testnet-node.md +++ b/src/pages/stacks-blockchain/running-testnet-node.md @@ -108,17 +108,23 @@ Before you begin, check that you have the below necessary softwares installed on ### Download the Binary and run the follower node -First, download the binary using the below link: +-> Note: Please make sure to download the new Binary and follow the below steps as and when a [new release build](https://github.com/blockstack/stacks-blockchain/releases/latest) is available. - +First, Visit the [Stacks Github releases repo](https://github.com/blockstack/stacks-blockchain/releases/latest). From the various binary list, click to download the Windows binary.Refer the image below. +![BinaryList](/images/mining-windows.png) -Extract the binary .Open the command prompt from the folder where binary is extracted and execute the below command: +Next, click on save file and Press **Ok** in the popup window. +![Windowspopup](/images/mining-windows-popup.png) + +Once saved, Extract the binary. Open the command prompt **from the folder where binary is extracted** and execute the below command: ```bash stacks-node krypton # This command will start the testnet follower node. ``` +-> Note : Sometimes windows might pop up a message to allow access. If so, allow access to keep on running the node. + To execute Stacks node with extra debugging enabled, run: ```bash