/alphaxcore

V2.0

Primary LanguageCMIT LicenseMIT

AlphaxCore

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
  • Live Stats API on Port 4000
  • WebSocket streaming of notable events like Blocks found, Blocks unlocked, Payments and more
  • POW (proof-of-work) & POS (proof-of-stake) support
  • Detailed per-pool logging to console & filesystem
  • Runs on Linux and Windows

Supported Coins

Refer to this file for a complete list.

Ethereum

Alphaxcore 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

You can send donations directly to the following accounts:

  • BTC: 1GXEm97T5iXAeYHBj2GuL3TKKRpkNas4Qt
  • LTC: LWBZWLmjqeQFnMqS9NctcdSx3TEYHyzfGz
  • ETH: 0x52FdE416C1D51525aEA390E39CfD5016dAFC01F7

Runtime Requirements on Linux

  • .Net Core 3.1 SDK
  • PostgreSQL Database
  • Coin Daemon (per pool)
  • Alphaxcore needs to be built from source on Linux and Windows. Refer to the section further down below for instructions.

Runtime Requirements on Windows

Basic PostgreSQL Database setup

Create the database:

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

Inside psql execute:

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

Import the database schema:

$ wget https://raw.githubusercontent.com/AlphaX-Projects/alphaxcore/master/src/Alphaxcore/Persistence/Postgres/Scripts/createdb.sql
$ psql -d alphaxcore -U alphaxcore -f createdb.sql

Advanced PostgreSQL Database setup

If you are planning to run a Multipool-Cluster, the simple setup might not perform well enough under high load. In this case you are strongly advised to use PostgreSQL 11 or higher. After performing the steps outlined in the basic setup above, perform these additional steps:

WARNING: The following step will delete all recorded shares. Do NOT do this on a production pool unless you backup your shares table using pg_backup first!

$ wget https://raw.githubusercontent.com/AlphaX-Projects/alphaxcore/master/src/Alphaxcore/Persistence/Postgres/Scripts/createdb_postgresql_11_appendix.sql
$ psql -d alphaxcore -U alphaxcore -f createdb_postgresql_11_appendix.sql

After executing the command, your shares table is now a list-partitioned table which dramatically improves query performance, since almost all database operations Alphaxcore performs are scoped to a certain pool.

The following step needs to performed once for every new pool you add to your cluster. Be sure to replace all occurences of mypool1 in the statement below with the id of your pool from your Alphaxcore configuration file:

CREATE TABLE shares_mypool1 PARTITION OF shares FOR VALUES IN ('mypool1');

Once you have done this for all of your existing pools you should now restore your shares from backup.

Building from Source

Building on Ubuntu 20.04

$ wget -q https://packages.microsoft.com/config/ubuntu/20.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 -y install dotnet-sdk-3.1 git cmake build-essential libssl-dev pkg-config libboost-all-dev libsodium-dev libzmq5
$ git clone https://github.com/AlphaX-Projects/alphaxcore
$ cd alphaxcore/src/Alphaxcore
$ dotnet publish -c Release --framework netcoreapp3.1  -o ../../build

Building on Windows

Download and install the .Net Core 3.1 SDK

> git clone https://github.com/AlphaX-Projects/alphaxcore
> cd alphaxcore/src/Alphaxcore
> dotnet publish -c Release --framework netcoreapp3.1  -o ..\..\build

Building on Windows - Visual Studio

After successful build

Create a configuration file config.json as described here

cd ../../build
dotnet Alphaxcore.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. Alphaxcore does not include such frontend but there are several community projects that can be used as starting point.