Skip to content

toncoinpool/stratum-miner

Repository files navigation

Ton Coin Pool stratum-miner

Ton Coin Pool mining client based on our fork of the official miner toncoinpool/pow-miner-gpu

Currently only Nvidia and AMD GPUs are supported

Translations

Prerequirements

Usage

Download the appropriate executable for your platform from Releases page:

  • Windows: file with .exe extension or win-headless.zip(recommended) archive containing CLI-only binary. Windows 7 is not supported
  • macOS: .zip archive containing .app file. Last version with macOS support was 1.0.13
  • Linux: .AppImage file with GUI or linux-headless.tar.gz(recommended) archive containing CLI-only binary

GUI Fields

  • Mining binary: select miner based on your GPU manufacturer: Nvidia, AMD or both
  • GPUs: select GPUs, that you want to use for mining
  • Wallet address: correct TON Wallet address. DO NOT USE ANY CRYPTO EXCHANGE SERVICES WALLETS!!!
  • Rig name: rig name for statistics on website. Allowed symbols are latin, numeric, , -, _, max 24 symbols length

MinerstatOS integration

Instructions can be found here

RaveOS integration

Instructions can be found here

HiveOS integration

Instructions can be found here

Headless

In addition to GUI clients, there are also command-line clients, which can be helpful if you need to debug launch issues, view runtime errors in the output and set boost factors(--boost option)

On linux you can download ...-linux-headless.tar.gz release and run it from the terminal like this:

$ ./TON-Stratum-Miner --wallet <your-wallet-address> [--bin <name>] [--boost <boost-factors>] [--exclude-gpus <ids>] [--rig <name>]

On windows you can download ...-win-headless.zip release, extract it, edit the extracted TON-Stratum-Miner.bat file using any text editor and run it. Minimum required windows version is 8.1. You should edit the TON-Stratum-Miner.bat like this:

TON-Stratum-Miner.exe --wallet <your-wallet-address> [--bin <name>] [--boost <boost-factors>] [--exclude-gpus <ids>] [--rig <name>]
pause
  • -w, --wallet: Required. Your TON wallet's address

  • -b, --bin <name>: Name of the miner binary. Can be specified to use only Nvidia or only AMD GPUs. Can be one of:

    Linux:

    • cuda-18
    • cuda-20
    • opencl-18
    • opencl-20

    Windows:

    • cuda.exe
    • opencl.exe

    Defaults to using both Nvidia and AMD

  • -F, --boost <boost-factors>: configure boost factors (pow-miner-gpu docs). Can be a single number to apply to all GPUs or a comma-separated list of <id>:<boost>,<id>:<boost>,... pairs. To list device ids run the client without --wallet argument. Defaults to 2048 for Nvidia(recommended for RTX 2080Ti and above) or 64 for AMD.

    Given the following device list in miner logs:

    CUDA: id 0 boost 512 NVIDIA GeForce RTX 3080
    OpenCL: id 1:0 boost 64 AMD Radeon RX 6600
    

    We can configure boost factor in the following ways:

    • --boost 2048 - will use 2048 for all GPUs
    • --boost 1:0:256 - will use the default value of 512 for 3080 and 256 for 6600
    • --boost 0:1024,1:0:128 - will use 1024 for 3080 and 128 for 6600
  • --exclude-gpus <ids>: disable mining on specific GPUs. A comma-separated list of device ids. To find id of a specific device run the client without --wallet argument. Example: --exclude-gpus 0,1,1:0,1:1

  • -r, --rig: How this client's stats will be seen on toncoinpool.io. Defaults to default

Windows TON-Stratum-Miner.bat example:

TON-Stratum-Miner.exe -w your_wallet -b cuda.exe -F 1024 --exclude-gpus 1 -r myWindowsRig
pause

Ton Coin Pool endpoints

  • [ pplns: wss://pplns.toncoinpool.io/stratum ]

Stratum

Ton Coin Pool is based on Stratum protocol

License

MIT