Definitions and implementations of mining pools in Openclerk
PHP
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
test
.gitignore
README.md
accounts.json
composer.json
composer.lock
phpunit.xml

README.md

openclerk/mining-pools

A library for accessing live balances and hashrate data for accounts on many different mining pools, used by Openclerk and live on CryptFolio.

This extends on the abstract currency definitions provided by openclerk/currencies and the abstract account definitions provided by openclerk/accounts.

Installing

Include openclerk/mining-pools as a requirement in your project composer.json, and run composer update to install it into your project:

{
  "require": {
    "openclerk/mining-pools": "dev-master"
  }
}

Using

First, define a way to load Currency instances from three-character codes, according to openclerk/currencies:

use \DiscoveredComponents\Currencies;
use \Openclerk\Currencies\Currency;
use \Openclerk\Currencies\CurrencyFactory;

class DiscoveredCurrencyFactory implements CurrencyFactory {

  /**
   * @return a {@link Currency} for the given currency code, or {@code null}
   *   if none could be found
   */
  public function loadCurrency($cur) {
    if (Currencies::hasKey($cur)) {
      return Currencies::getInstance($cur);
    }
    return null;
  }

}

Get the currencies supported by a mining pool:

use \Monolog\Logger;

$logger = new Logger("log");
$factory = new DiscoveredCurrencyFactory();

$instance = new Account\MiningPool\Slush();
print_r($instance->fetchSupportedCurrencies($factory, $logger));
// returns ['btc', 'nmc']

Get the current balances (confirmed, unconfirmed, estimated) and hashrates for a mining pool account:

use \Monolog\Logger;

$logger = new Logger("log");
$factory = new DiscoveredCurrencyFactory();

$instance = new Account\MiningPool\Slush();

$account = array(
  'api_token' => '270245-e26365e4ca8f97ddde8c76a23ec18758',
);

$balances = $instance->fetchBalances($account, $factory, $logger);
echo $balances['btc']['confirmed'];     // in BTC
echo $balances['btc']['unconfirmed'];
echo $balances['btc']['estimated'];
echo $balances['btc']['hashrate'];      // in MH/s
echo $balances['nmc']['confirmed'];     // in NMC
echo $balances['nmc']['unconfirmed'];
echo $balances['nmc']['estimated'];
echo $balances['nmc']['hashrate'];      // in MH/s

Tests

Each mining pool comes with a suite of tests to check each associated service.

composer install
vendor/bin/phpunit

To run the tests for a single mining pool:

vendor/bin/phpunit --bootstrap "vendor/autoload.php" test/SlushTest

To get debug output for the tests (such as CURL requests and decoded output), add the --debug switch to your vendor/bin/phpunit command.

Donate

Donations are appreciated.

Contributing

Pull requests that contribute new mining pools are welcome.

Make sure that you also provide an associated Test suite so that the mining pool is automatically testable.

TODO

  1. Generate README list of mining pools automatically
  2. Link to live APIs on CryptFolio
  3. CI build server and link to test results