Code Monkey home page Code Monkey logo

miningcore's Introduction

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

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.

miningcore's People

Contributors

calvintam236 avatar shtse8 avatar kukks avatar acidtib avatar jgillich avatar konstantin35 avatar jeong760 avatar 21void avatar endogen avatar denismatveev avatar felixonmars avatar interbiznw avatar martin-key avatar rterbush avatar vkynchev avatar bitspill avatar jpb18 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.