Skip to content

Commit a4b308f

Browse files
authoredApr 25, 2019
Update README.md
1 parent 10d79d9 commit a4b308f

File tree

1 file changed

+41
-8
lines changed

1 file changed

+41
-8
lines changed
 

‎README.md

+41-8
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,17 @@
22
# version: 1.2
33
# Table of Contents
44
1. [Reporting bugs and technical support](#reporting-bugs-and-technical-support)
5-
1. [Payment](#payment)
5+
1. [Dev fee](#dev-fee)
66
1. [Setup](#setup)
77
1. [Log Files](#log-files)
88
1. [Remote Monitoring](#remote-monitoring)
99
1. [Automatic Restart Function](#automatic-restart-function)
1010
1. [Parameters](#parameters)
1111
1. [Configuration File](#configuration-file)
12+
1. [Launching from command line](#launching-from-command-line)
1213
1. [Examples of Configuration Files](#examples-of-configuration-files)
1314

14-
**nanominer** is a program product developed by nanopool to create structural cryptocurrency units on the framework of the Ethash, Ubqhash, CryptoNight (v6, v7, v8, CryptoNightR, Reverse Waltz), Cuckaroo29 and RandomHash algorithms. The present version of **nanominer** was made to work with every cryptocurrency based on these algorithms, including Ethereum, Ethereum Classic, Ubiq, Monero, Graft, PascalCoin, GrinCoin and many others. This version of **nanominer** runs on Windows or Linux with AMD or Nvidia graphics cards with the following exceptions:
15+
**nanominer** is a program product developed by nanopool to create structural cryptocurrency units on the framework of the Ethash, Ubqhash, CryptoNight (v6, v7, v8, CryptoNightR, Reverse Waltz), Cuckaroo29 and RandomHash algorithms. The present version of **nanominer** was made to work with every cryptocurrency based on these algorithms, including Ethereum, Ethereum Classic, QuarkChain, Ubiq, Monero, Graft, PascalCoin, GrinCoin and many others. This version of **nanominer** runs on Windows or Linux with AMD or Nvidia graphics cards with the following exceptions:
1516
* CryptoNightR and Reverse Waltz algorithms run on Nvidia GPUs only.
1617
* Cuckaroo29 algorithm is supported only on AMD cards with 8+ GB of memory.
1718
* The RandomHash algorithm is supported only on CPU.
@@ -20,16 +21,16 @@ In order to work with Nvidia GPUs **nanominer** needs Nvidia driver **410.48 and
2021

2122
In order to begin mining Ethereum with nanominer, ***it's enough to simply input your wallet*** in the configuration file.
2223

23-
Testing on **nanominer** demonstrated high performance working with Ethereum, Ethereum Classic, Ubiq, Monero, Graft, PascalCoin, GrinCoin and other currencies. As a result of the research carried out, it was found that **nanominer** performs on par with, and sometimes better than, competing program products. Independently of this, **nanominer** stands out with its high stability and simple setup.
24+
Testing on **nanominer** demonstrated high performance working with Ethereum, Ethereum Classic, QuarkChain, Ubiq, Monero, Graft, PascalCoin, GrinCoin and other currencies. As a result of the research carried out, it was found that **nanominer** performs on par with, and sometimes better than, competing program products. Independently of this, **nanominer** stands out with its high stability and simple setup.
2425

2526
## Reporting bugs and technical support
2627
For reporting bugs, technical support, feature requests and community discussions feel free to use the following communication channels:
27-
* Support email: support@miner.nanopool.org
28+
* Support email: support@nanominer.org
2829
* GitHub issues tracker: https://github.com/nanopool/nanominer/issues
2930
* Community chat in telegram (developers read it too): https://t.me/nanominer_en
3031
* Our Discord channel https://discord.gg/eyWkqG3
3132

32-
## Payment
33+
## Dev fee
3334
Payment for the use of **nanominer** takes the form of a commission from mining to its wallets once per 2 hours of runtime. The commission is:
3435
- 1% of total mining time for Ethash, Ubqhash and CryptoNight algorithms (72 seconds per 2 hours);
3536
- 2% for Cuckaroo29 algorithm (144 seconds per 2 hours);
@@ -108,7 +109,7 @@ payment number in addition to their wallet.
108109
### coin
109110
Optional algorithm parameter.
110111
This chooses the default coin for the pool. The default pool is [nanopool.org](https://nanopool.org/).
111-
The coin parameter accepts one of three values: ETH (or Ethereum), ETC (or Ethereum Classic), XMR (or Monero), GRIN (or GrinCoin), PASC (or PascalCoin). When a coin is specified and equals one of the values mentioned above, **nanominer** automatically tries to determine the pool necessary for it to function if none have been provided in a separate parameter. If a coin is specified but **nanominer** cannot recognize it, then the name of the coin is used only for logging. If a coin is not specified, **nanominer** will use the default coin for the corresponding algorithm (Ethereum or Monero). Moreover, if [nanopool.org](https://nanopool.org/) is specified in the configuration file for Ethereum, Ethereum Classic, Monero or GrinCoin, **nanominer** will determine the coin from the pool's settings.
112+
The coin parameter accepts one of three values: ETH (or Ethereum), ETC (or Ethereum Classic), QKC (or QuarkChain), UBQ (or Ubiq), XMR (or Monero), GRIN (or GrinCoin), PASC (or PascalCoin). When a coin is specified and equals one of the values mentioned above, **nanominer** automatically tries to determine the pool necessary for it to function if none have been provided in a separate parameter. If a coin is specified but **nanominer** cannot recognize it, then the name of the coin is used only for logging. If a coin is not specified, **nanominer** will use the default coin for the corresponding algorithm (Ethereum or Monero). Moreover, if [nanopool.org](https://nanopool.org/) is specified in the configuration file for Ethereum, Ethereum Classic, Monero or GrinCoin, **nanominer** will determine the coin from the pool's settings.
112113

113114
*Important*: when using **nanominer** to mine Ethereum Classic on the default pool, it is necessary to define the coin (coin=ETC). In that case the pools will be determined automatically.
114115

@@ -175,7 +176,7 @@ The script must be written by the user.
175176

176177
### coreClocks, memClocks
177178
Optional common parameters.
178-
Can be used to overclock/underclock NVIDIA GPU's. Absolute (e.g. 4200) as well as relative (e.g. +200, -150) values in megabytes are accepted. The values must be separated by a comma or space (first value is for GPU0, second is for GPU1, and so on). For example, if it is set as
179+
Can be used to overclock/underclock NVIDIA GPU's. Absolute (e.g. 4200) as well as relative (e.g. +200, -150) values in MHz are accepted. The values must be separated by a comma or space (first value is for GPU0, second is for GPU1, and so on). For example, if it is set as
179180
```
180181
coreClocks=+200,-150
181182
memClocks=+300,3900
@@ -220,6 +221,10 @@ Default value: -3333 (This means that the miner blocks management through API an
220221
Optional common parameter.
221222
Your password for monitoring with EthMan and other utilities that support the same network API.
222223

224+
### shard
225+
Optional algorithm parameter.
226+
Can be used to set a shard ID for QuarkChain solo mining. Only shards using Ethash algorithm are supported. This parameter should be specified in hex, e.g. 0x1, 0x10001, 0x10002, etc. For more information on shards, visit [this](https://github.com/QuarkChain/pyquarkchain/wiki/Address,-Shard-Key,-Chain-Id,-Shard-Id) and [this](https://github.com/quarkChain/pyquarkchain/releases/latest) link.
227+
223228
### cpuThreads
224229
Optional algorithm parameter for CPU mining.
225230
Specifies the number of concurrent CPU threads to use for mining. All threads are used by default.
@@ -246,7 +251,19 @@ coin=ETC
246251
In this case **nanominer** will use pools corresponding to Ethereum Classic.
247252

248253
## IMPORTANT!
249-
For coins that run on the Ethash algorithm but are not supported by [nanopool.org](https://nanopool.org/), **you must** specify a **wallet** and pools (**pool1...**). In this case **nanominer** will function as if it were working with Ethereum, but the results of its operations will be determined by tasks from the corresponding pools specified in the configuration file.
254+
For coins that are not supported by [nanopool.org](https://nanopool.org/), **you must** specify a **wallet** and pools (**pool1...**).
255+
256+
## Launching from command line
257+
A batch/shell file can be created to launch **nanominer** with command line arguments. This file must call the <i>cmdline_launcher</i> script (<i>cmdline_launcher.bat</i> on Windows, <i>cmdline_launcher.sh</i> on Linux), which converts the command line into a config called <i>config_cmdline.ini</i> and launches the miner with it. At least one algorithm and wallet must be passed to the <i>cmdline_launcher</i> script. All common config parameters in the command line must be specified before the first "algo" parameter. Here are some examples of command lines for launching Ethereum and PascalCoin:
258+
259+
Windows:
260+
```
261+
cmdline_launcher -algo ethash -wallet YOUR_ETH_WALLET -coin eth -rigName YOUR_ETH_WORKER -email YOUR_EMAIL -algo randomhash -wallet YOUR_PASC_WALLET -coin pasc -rigName YOUR_PASC_WORKER -email YOUR_EMAIL
262+
```
263+
Linux:
264+
```
265+
./cmdline_launcher.sh -algo ethash -wallet YOUR_ETH_WALLET -coin eth -rigName YOUR_ETH_WORKER -email YOUR_EMAIL -algo randomhash -wallet YOUR_PASC_WALLET -coin pasc -rigName YOUR_PASC_WORKER -email YOUR_EMAIL
266+
```
250267

251268
## Examples of Configuration Files
252269
Example of a configuration file for Ethereum and PascalCoin:
@@ -328,6 +345,22 @@ Example of a minimum file for Ethereum Classic:
328345
wallet=0xffffffffffffffffffffffffffffffffffffffff
329346
coin=Etc
330347
```
348+
Example of a complete configuration file for solo QuarkChain mining:
349+
```
350+
[Ethash]
351+
wallet=0 ;placeholder wallet for solo mining
352+
shard=1
353+
coin=Qkc
354+
pool1=localhost:38391
355+
protocol=getwork
356+
```
357+
Example of a minimum file for solo QuarkChain mining:
358+
```
359+
[Ethash]
360+
wallet=0 ;placeholder wallet for solo mining
361+
coin=Qkc
362+
pool1=localhost:38391
363+
```
331364
Example of a configuration file for Ubiq:
332365
```
333366
[Ubqhash]

0 commit comments

Comments
 (0)
Please sign in to comment.