README

一个用于访问常见加密货币余额、区块计数和难度的库，由 Openclerk 使用，并在 CryptFolio 上运行。

这扩展了 openclerk/currencies 提供的抽象货币定义。

安装

在项目的 composer.json 中将 openclerk/cryptocurrencies 作为需求，并运行 composer update 将其安装到您的项目中

{
  "require": {
    "openclerk/cryptocurrencies": "dev-master"
  }
}

需要 PHP 5.4.6+，因为某些 API 由于 POODLE SSL 漏洞需要 cURL 7.24+。

• 支持的货币
• 支持的服务

使用

获取特定地址的余额

use \Monolog\Logger;

$logger = new Logger("log");

$currency = new \Cryptocurrencies\Dogecoin();
$balance = $currency->getBalance("D64vbPp9TvqQ67xc6we5GnEtcKqiTXfp1S", $logger);

获取具有多个确认次数的特定地址的余额

$currency = new \Cryptocurrencies\Bitcoin();
$balance = $currency->getBalanceWithConfirmations("17eTMdqaFRSttfBYB9chKEzHubECZPTS6p", 6, $logger);

获取给定加密货币的当前难度

$currency = new \Cryptocurrencies\Litecoin();
$balance = $currency->getDifficulty($logger);

检查给定地址是否有效

$currency = new \Cryptocurrencies\Bitcoin();
return $currency->isValid("17eTMdqaFRSttfBYB9chKEzHubECZPTS6p");

测试

每个加密货币都附带一组测试，用于检查每个相关服务。

composer install
vendor/bin/phpunit

运行单个货币的测试

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

要获取测试的调试输出（如 CURL 请求和解码后的输出），请在您的 vendor/bin/phpunit 命令中添加 --debug 开关。

资产

每个加密货币的资产，例如与货币和相关服务关联的图标，提供在 css/ 和 images/ 中。

这些可以通过 asset-discovery 包含到您的项目中，并提供混合，例如

@each $code in $currency-codes {
  .currency_name.currency_#{$code}, .currency_name_#{$code} {
    padding-left: 20px;
    @include currency-label-background($code);
    background-position: 0 0;
    background-repeat: no-repeat;
    background-size: 16px 16px;
  }
}

捐赠

捐赠受到欢迎.

贡献

欢迎贡献包含新货币、服务或 API 的拉取请求。

对于新货币，请确保您还提供了一个相关的 CurrencyTest，以便货币可以自动测试。

待办事项

1. 自动生成 README 列表中的货币/服务
2. 为每个加密货币提供 32x32 图标
3. 链接到 CryptFolio 上的实时 API
4. CI 构建服务器和测试结果链接