/ts-api-php

PHP library to interact with the BLOC-GATEWAY Service API

Primary LanguagePHPGNU Affero General Public License v3.0AGPL-3.0

BLOC Service PHP API Interface

This wrapper allows you to easily interact with the BLOC Gateway 0.9.0 API to quickly develop applications that interact with the BLOC.MONEY Network.

Table of Contents

  1. Installation
  2. Intialization
  3. Documentation
  4. Methods

Installation

composer require trtlservices/ts-api-php

Intialization

use BLOCGateway\BLOCGateway;

$config = [
    'token' => 'eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoidGVzdCIsImFwcElkIjo0LCJ1c2VySWQiOjYsInBlcm1pc3Npb25zIjpbImFkZHJlc3M6bmV3Il0sImlhdCI6MTUzNjU4NTM2NywiZXhwIjoxNTM5MTc3MzY3LCJhdWQiOiJ0dXJ0bGV3YWxsZXQuaW8iLCJpc3MiOiJUUlRMIFNlcnZpY2VzIiwianRpIjoiMzMifQ.AEHXmvTo8RfNuZ15Y3IGPRhZPaJxFSmOZvVv2YGN9L4We7bXslIPxhMv_n_5cNW8sIgE2Fr-46OTb5H5AFgpjA',
    'timeout' => 2000
];

$BLOCGATEWAY = new BLOCGateway($config);

Reponse Formattng

// The result field from the RPC response
$response->result();

// RPC response as JSON string
$response->toJson();

// RPC response as an array
$response->toArray();

Documentation

API documentation is available at https://bloc-developer.com/api_bloc-gateway

Methods

createAddress()

Create a new BLOC addresses

$BLOCGATEWAY->createAddress()

getAddress(address)

Get address details by address

$BLOCGATEWAY->getAddress("aBLocuxH78akDMCsXycnU5HjJE6zPCgM4KRNNQSboqh1yiTnvxuhNVUL9tK92j9kurSKdXVHFmjSRkaNBxM6Nb3G8eQGL7aj113A")

deleteAddress(address)

Delete a selected BLOC addresses

$BLOCGATEWAY->deleteAdddress("aBLocuxH78akDMCsXycnU5HjJE6zPCgM4KRNNQSboqh1yiTnvxuhNVUL9tK92j9kurSKdXVHFmjSRkaNBxM6Nb3G8eQGL7aj113A")

getAddresses()

View all addresses.

$BLOCGATEWAY->getAddresses()

scanAddress(address, blockIndex)

Scan an address for transactions between a 100 block range starting from the specified blockIndex.

$BLOCGATEWAY->scanAddress("aBLocuxH78akDMCsXycnU5HjJE6zPCgM4KRNNQSboqh1yiTnvxuhNVUL9tK92j9kurSKdXVHFmjSRkaNBxM6Nb3G8eQGL7aj113A", 899093)

getAddressKeys(address)

Get the public and secret spend key of an address.

$BLOCGATEWAY->getAddressKeys("aBLocuxH78akDMCsXycnU5HjJE6zPCgM4KRNNQSboqh1yiTnvxuhNVUL9tK92j9kurSKdXVHFmjSRkaNBxM6Nb3G8eQGL7aj113A")

integrateAddress(address, paymentId)

Create an integrated address with an address and payment ID.

$BLOCGATEWAY->integrateAddress("aBLocuxH78akDMCsXycnU5HjJE6zPCgM4KRNNQSboqh1yiTnvxuhNVUL9tK92j9kurSKdXVHFmjSRkaNBxM6Nb3G8eQGL7aj113A", "7d89a2d16365a1198c46db5bbe1af03d2b503a06404f39496d1d94a0a46f8804")

getIntegratedAddresses(address)

Get all integrated addresses by address.

$BLOCGATEWAY->getIntegratedAddresses("aBLocuxH78akDMCsXycnU5HjJE6zPCgM4KRNNQSboqh1yiTnvxuhNVUL9tK92j9kurSKdXVHFmjSRkaNBxM6Nb3G8eQGL7aj113A")

getFee(amount)

Calculate the BLOC Services fee for an amount specified in BLOC with two decimal points.

$BLOCGATEWAY->getFee(1092.19)

createTransfer(sender, receiver, amount, fee, paymentId, extra)

Send a BLOC transaction with an address with the amount specified two decimal points.

$BLOCGATEWAY->createTransfer(
  "aBLocuxH78akDMCsXycnU5HjJE6zPCgM4KRNNQSboqh1yiTnvxuhNVUL9tK92j9kurSKdXVHFmjSRkaNBxM6Nb3G8eQGL7aj113A",
  "aBLocGzAzNs1E1RBFhteX56A5353vyHuSJ5AYYQfoN97PNbcMDvwQo4pUWHs7SYpuD9ThvA7AD3r742kwTmWh5o9WFaB9JXH8evP",
  1000.01,
  1.2,
  "7d89a2d16365a1198c46db5bbe1af03d2b503a06404f39496d1d94a0a46f8804",
  "3938f915a11582f62d93f82f710df9203a029f929fd2f915f2701d947f920f99"
)

You can leave the last two fields (paymentId and extra) blank.

getTransfer(address)

Get a transaction details specified by transaction hash.

$BLOCGATEWAY->getTransfer("EohMUzR1DELyeQM9RVVwpmn5Y1DP0lh1b1ZpLQrfXQsgtvGHnDdJSG31nX2yESYZ")

getWallet()

Get wallet container info and health check.

$BLOCGATEWAY->getWallet()

getStatus()

Get the current status of the BLOC Services infrastructure.

$BLOCGATEWAY->getStatus()

License

Copyright (C) 2018 Rashed Mohammed, The TurtleCoin Developers

Please see the included LICENSE file for more information.