mmxca / block_io-php
Block.io is the easiest way to create wallets, send, and accept payments through Bitcoin, Litecoin, and Dogecoin. This is its PHP library.
Requires
- php: >=5.4.0
- ext-curl: *
This package is not auto-updated.
Last update: 2024-04-22 11:14:30 UTC
README
Current Release: 1.1.3
01/29/15: Added support for getting Wallet Import Format private keys from custom keys.
01/19/15: Added support for sweeping legacy keys.
01/09/15: Added sweep functionality.
11/03/14: Fix DER signature encoding. Now stable.
18/10/14: Enforcing Determinism in Signatures (RFC6979), also using BIP62 to hinder transaction malleability.
15/10/14: Enforce use of TLSv1, step away from the vulnerable SSLv3.
10/10/14: Added 3 of 4 MultiSig example.
09/28/14: Updated for v2 handling.
PHP wrapper for Block.io for use with Dogecoin, Bitcoin, and Litecoin. API key validation on instantiation, simple abstraction layer on top of existing API interfaces, and automatic JSON decoding on response.
Requirements
This library requires the 'mcrypt', 'gmp', and cURL extensions for PHP. To enable these extensions, see:
Warning
If you're using Windows, beware that SSL will not function properly, and this library will throw errors.
To fix the SSL issue on Windows, please do the following:
Download http://curl.haxx.se/ca/cacert.pem to a directory of your choice
Make PHP use this file to validate Block.io's SSL certificate by adding this line to your php.ini:
curl.cainfo=c:\path\to\cacert.pem
Usage
First, sign up for an account at Block.io and take note of your API key under Account > Dashboard.
Download and include the block_io.php class:
require_once 'path/to/block_io.php';
Or preferably install via Composer
"block_io-php/block_io-php": "1.1.3"
Instantiate the class and set your API key. If the API key is valid the set function will return true otherwise false.
$apiKey = "YOUR API KEY FOR DOGECOIN, BITCOIN, OR LITECOIN";
$pin = "YOUR SECRET PIN";
$version = 2; // the API version to use
$block_io = new BlockIo($apiKey, $pin, $version);
echo "Confirmed Balance: " . $block_io->get_balance()->data->available_balance . "\n";
The wrapper abstracts all methods listed at https://block.io/api/php using the same interface names. For example, to get your current account balance:
$balance = $block_io->get_balance(array('label' => 'default'));
echo $balance->data->available_balance . "\n";
To make requests that require parameters (eg. an address label or address to withdraw to), pass through each parameter in an associative array. For example, the request below will withdraw 50 DOGE to the wallet you specify in place of WALLET-ADDRESS-HERE:
$withdraw = $block_io->withdraw(array('amount' => '50.0', 'to_address' => 'WALLET-ADDRESS-HERE'));
Note: This library throws Exceptions when calls fail. Implement try/catch blocks, and retrieve the Exception message to see details.
Please see Block.io PHP Docs for details on available calls.