stormpat/blockr-php

Blockr.io API的PHP包装器。支持比特币、莱特币和数字币。

dev-master 2014-02-26 08:11 UTC

This package is not auto-updated.

Last update: 2024-09-14 15:07:02 UTC


README

#BlockrPHP

###亮点

  • 支持比特币、莱特币和数字币
  • 简单易用的API。
  • 易于与其他项目和框架集成。

###要求

###关于

轻松获取不同区块链的数据。支持区块、地址和交易。

###安装

Composer

// in composer.json

"require": {
    "stormpat/blockr-php": "dev-master"
}

// from command line

composer require stormpat/blockr-php:dev-master

设置

require_once __DIR__ . '/vendor/autoload.php';

use BlockrPHP\Api;

$coin = new Api('Litecoin');

现在您可以在$coin实例上调用方法。

###文档

首先选择您的货币。当您创建对象时,告诉Api类您想使用哪种货币。

支持以下货币:比特币、莱特币和数字币

// create new instance with Litecoin.
$coin = new Api('Litecoin');

技巧 为了更快地获取数据(减少HTTP调用),您可以在一次调用中链式查询参数。因此,如果您想获取关于地址(从区块链随机获取)LTrRaX2KMN27cigK9QiCmJGk3qYww45ahnLUZp5GbpxfwykA6PieSApkhAyRbPeyE6KE的信息,您可以将它们一起链式调用。

// chain two addresses and get data in a single http call.
$coin->address('LTrRaX2KMN27cigK9QiCmJGk3qYww45ahn, LUZp5GbpxfwykA6PieSApkhAyRbPeyE6KE');

方法

$coin->coinInfo()

提供有关货币的信息,包括硬币名称、缩写、标志和主页URL的基本硬币信息;- 交易量信息:在供应中的硬币数量以及将永远存在的硬币数量。- 最后一个区块信息:最长链中最新的区块信息。- 下一个难度重新调整的时间和大小。

$coin->blockInfo($block)

其中$block可以是整数(例如:223212)。要获取最新区块信息,传入字符串last - 这将始终返回最新区块信息。

$coin->blockTx($block)

返回给定区块中所有交易的简短信息。

$coin->blockRaw($block)

以bitcoind格式返回原始区块数据。

$coin->transaction($transaction)

返回交易数据。某些字段已归一化 - 'vin'以地址的形式呈现,而不是以前的事务哈希。'vins'和'vouts'呈现实际交易价值,而不是整个交易金额。如果您需要精确的交易表示,请使用原始API调用。

$coin->transactionRaw($transaction)

返回给定交易的原始数据。

$coin->address($address)

返回基本地址数据,日期,区块以及该地址首次出现和最后交易数据。

$coin->address($address, 10)

可选参数为确认次数。必须是整数。

如果设置,API将仅包括具有此数量确认的交易。例如,如果某个地址在最新区块中的某个交易中获得10个硬币,并且您将确认次数设置为2,则该最后交易将不会包括在余额中。

如果有6个或更多确认的交易,则假定交易是安全的(有效的)。

$coin->balance($balance)

此API调用可用于快速请求给定地址的余额。您可以在API调用中添加多个地址。

$coin->balance($balance, 10)

添加确认次数。

$coin->addressTx($address)

返回给定地址的交易。仅显示最近的200笔交易。如果您需要更多,请联系我们。您可以在API调用中添加多个地址。

$coin->addressUnspent($address)

返回给定地址的未花费交易。未花费交易是仍有价值的交易。这些交易的价值尚未被花费。您可以在API调用中添加多个地址。

示例

$coin = new Api('Litecoin');

$block = $coin->blockInfo('497250');

if ($block->code === 200)
{
    echo 'Block number ' . $block->data->nb . '<br>';
    echo 'Block hash ' .   $block->data->hash . '<br>';
    echo 'Version ' . $block->data->version . '<br>';
    echo 'Block confirmations ' . $block->data->confirmations . '<br>';
    echo 'Block timestamp UTC) ' . $block->data->time_utc . '<br>';
    echo 'Block transactions ' . $block->data->nb_txs . '<br>';
    echo 'Block merkleroot ' . $block->data->merkleroot . '<br>';
    echo 'Next block id ' . $block->data->next_block_nb . '<br>';
    echo 'Previous block id ' . $block->data->prev_block_nb . '<br>';
    echo 'Next block hash ' . $block->data->next_block_hash . '<br>';
    echo 'Previous block hash ' . $block->data->prev_block_hash . '<br>';
    echo 'Block fee ' . $block->data->fee . '<br>';
    echo 'Block vout sum ' . $block->data->vout_sum . '<br>';
    echo 'Block size ' . $block->data->size . '<br>';
    echo 'Block difficulty ' . $block->data->difficulty . '<br>';
    echo 'Block message ' . $block->message . '<br>';

}

###许可证

MIT许可证(MIT)

版权所有(c)2014 Patrik Storm

本文件特此授予任何人获取本软件及其相关文档文件(以下简称“软件”)的副本,免费使用该软件,不受限制,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利,并允许向提供软件的人士进行此类操作,但须遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“原样”提供,不提供任何形式的保证,无论是明示的还是默示的,包括但不限于适销性、特定用途的适用性和非侵权性保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论该责任是因合同、侵权或其他原因产生,与软件或软件的使用或其他处理方式有关。

### 阅读

请记住也要查看Blockr 文档