Miningcore is a high-performance Mining-Pool Engine that runs on Linux and Windows and supports a variety of crypto-currencies.
Clone or download
Latest commit ec14fba Oct 11, 2018
Permalink
Failed to load latest commit information.
examples Dev (#427) Oct 11, 2018
libs Dev (#422) Oct 9, 2018
src Dev (#427) Oct 11, 2018
.gitattributes Fixed line endings in .gitattributes Aug 28, 2017
.gitignore Dev (#419) Oct 7, 2018
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md Mar 24, 2018
LICENSE fix license formatting (#142) Jan 1, 2018
README.md Update README.md Oct 7, 2018
appveyor.yml Update appveyor.yml Oct 7, 2018

README.md

Build status Docker Build Statu Docker Stars Docker Pulls license

Features

  • Supports clusters of pools each running individual currencies
  • Ultra-low-latency, multi-threaded Stratum implementation using asynchronous I/O
  • Adaptive share difficulty ("vardiff")
  • PoW validation (hashing) using native code for maximum performance
  • Session management for purging DDoS/flood initiated zombie workers
  • Payment processing
  • Banning System for banning peers that are flooding with invalid shares
  • Live Stats API on Port 4000
  • POW (proof-of-work) & POS (proof-of-stake) support
  • Detailed per-pool logging to console & filesystem
  • Runs on Linux and Windows

Coins

Coin Implemented Tested Planned Notes
Bitcoin Yes Yes
Bitcoin Cash Yes Yes
Bitcoin Gold Yes Yes
Bitcoin Diamond Yes Yes
Bitcoin Private Yes Yes
Litecoin Yes Yes
ZCash Yes Yes
Monero Yes Yes
Bittube Yes Yes
Ethereum Yes Yes Requires Parity
Ethereum Classic Yes Yes Requires Parity
DASH Yes Yes
Vertcoin Yes Yes
Monacoin Yes Yes
Groestlcoin Yes Yes
Dogecoin Yes No
DigiByte Yes Yes
Namecoin Yes No
Viacoin Yes No
Peercoin Yes No
Ravencoin Yes Yes
MoonCoin Yes Yes

Refer to this file for a complete list.

Ethereum

Miningcore implements the Ethereum stratum mining protocol authored by NiceHash. This protocol is implemented by all major Ethereum miners.

  • Claymore Miner must be configured to communicate using this protocol by supplying the -esm 3 command line option
  • Genoil's ethminer must be configured to communicate using this protocol by supplying the -SP 2 command line option

ZCash

  • Pools needs to be configured with both a t-addr and z-addr (new configuration property "z-address" of the pool configuration element)
  • First configured zcashd daemon needs to control both the t-addr and the z-addr (have the private key)
  • To increase the share processing throughput it is advisable to increase the maximum number of concurrent equihash solvers through the new configuration property "equihashMaxThreads" of the cluster configuration element. Increasing this value by one increases the peak memory consumption of the pool cluster by 1 GB.
  • Miners may use both t-addresses and z-addresses when connecting to the pool

Donations

This software comes with a built-in donation of 0.1% per block-reward to support the ongoing development of this project. You can also send donations directly to the following accounts:

  • BTC: 17QnVor1B6oK1rWnVVBrdX9gFzVkZZbhDm
  • LTC: LTK6CWastkmBzGxgQhTTtCUjkjDA14kxzC
  • DOGE: DGDuKRhBewGP1kbUz4hszNd2p6dDzWYy9Q
  • ETH: 0xcb55abBfe361B12323eb952110cE33d5F28BeeE1
  • ETC: 0xF8cCE9CE143C68d3d4A7e6bf47006f21Cfcf93c0
  • DASH: XqpBAV9QCaoLnz42uF5frSSfrJTrqHoxjp
  • ZEC: t1YHZHz2DGVMJiggD2P4fBQ2TAPgtLSUwZ7
  • BTG: GQb77ZuMCyJGZFyxpzqNfm7GB1rQreP4n6
  • XMR: 475YVJbPHPedudkhrcNp1wDcLMTGYusGPF5fqE7XjnragVLPdqbCHBdZg3dF4dN9hXMjjvGbykS6a77dTAQvGrpiQqHp2eH

Runtime Requirements on Windows

Runtime Requirements on Linux

Running pre-built Release Binaries on Windows

  • Download miningcore-win-x64.zip from the latest Release
  • Extract the Archive
  • Setup the database as outlined below
  • Create a configuration file config.json as described here
  • Run dotnet Miningcore.dll -c config.json

PostgreSQL Database setup

Create the database:

$ createuser miningcore
$ createdb miningcore
$ psql (enter the password for postgres)

Run the query after login:

alter user miningcore with encrypted password 'some-secure-password';
grant all privileges on database miningcore to miningcore;

Import the database schema:

$ wget https://raw.githubusercontent.com/coinfoundry/miningcore/master/src/Miningcore/Persistence/Postgres/Scripts/createdb.sql
$ psql -d miningcore -U miningcore -f createdb.sql

Configuration

API

Building from Source

Building on Ubuntu 16.04

$ wget -q https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb
$ sudo dpkg -i packages-microsoft-prod.deb
$ sudo apt-get update -y
$ sudo apt-get install apt-transport-https -y
$ sudo apt-get update -y
$ sudo apt-get -y install dotnet-sdk-2.1 git cmake build-essential libssl-dev pkg-config libboost-all-dev libsodium-dev libzmq5
$ git clone https://github.com/coinfoundry/miningcore
$ cd miningcore/src/Miningcore
$ dotnet publish -c Release --framework netcoreapp2.1  -o ../../build

Building on Windows

Download and install the .Net Core 2.1 SDK

> git clone https://github.com/coinfoundry/miningcore
> cd miningcore/src/Miningcore
> dotnet publish -c Release --framework netcoreapp2.1  -o ..\..\build

Building on Windows - Visual Studio

After successful build

Create a configuration file config.json as described here

cd ../../build
dotnet Miningcore.dll -c config.json

Running a production pool

A public production pool requires a web-frontend for your users to check their hashrate, earnings etc. Miningcore does not include such frontend but there are several community projects that can be used as starting point.