recordskeeper/recordskeepersdk

library for PHP package recordskeeper-php-sdk.

dev-master 2018-09-14 07:25 UTC

This package is not auto-updated.

Last update: 2024-10-06 15:48:07 UTC


README

It is an infrastructure to build RecordsKeeper blockchain-based applications, products and is used to work around applications that are built on top of this blockchain platform.

Note: If you're looking for the RecordsKeeper PHP Library please see: RecordsKeeper PHP Library

Getting Started

Before you begin you need to setup PHP Development Environment.

Creating Connection

Entry point for accessing Address class resources.

Make Config file to import config parameters.

Import config file.

$config = include('config.php');

Import values from config file:

   $chain = $config['chain'];
   $url = $config['url'];
   $port = $config['port'];

Node Authentication

Importing user name and password values from config file to authenticate the node:

  • User name: The rpc user is used to call the APIs.
  • Password: The rpc password is used to authenticate the APIs.
   $username = $config['rkuser'];
   $pass = $config['passwd'];

Libraries

  • Addresses Library to work with RecordsKeeper addresses. You can generate new address, check all addresses, check address validity, check address permissions, check address balance by using Address class. You just have to pass parameters to invoke the pre-defined functions.

  • Assets Library to work with RecordsKeeper assets. You can create new assets and list all assets by using Assets class. You just have to pass parameters to invoke the pre-defined functions.

  • Block Library to work with RecordsKeeper block informaion. You can collect block information by using block class. You just have to pass parameters to invoke the pre-defined functions.

  • blockchain Library to work with RecordsKeeper block informaion. You can collect block information by using block class. You just have to pass parameters to invoke the pre-defined functions.

  • Permissions Library to work with RecordsKeeper permissions. You can grant and revoke permissions like connect, send, receive, create, issue, mine, activate, admin by using Assets class. You just have to pass parameters to invoke the pre-defined functions.

  • Stream Library to work with RecordsKeeper streams. You can publish, retrieve and verify stream data by using stream class. You just have to pass parameters to invoke the pre-defined functions.

  • Transaction Library to work with RecordsKeeper transactions. You can send transaction, create raw transaction, sign raw transaction, send raw transaction, send signed transaction, retrieve transaction information and calculate transaction's fees by using transaction class. You just have to pass parameters to invoke the pre-defined functions.

  • Wallet Library to work with RecordsKeeper wallet functionalities. You can create wallet, dump wallet into a file, backup wallet into a file, import wallet from a file, lock wallet, unlock wallet, change wallet's password, retrieve private key, retrieve wallet's information, sign and verify message by using wallet class. You just have to pass parameters to invoke the pre-defined functions.

Unit Tests

Under recordskeeper_php_lib/test using test data from testconfig_sample file.

  • To run all the test cases:
phpunit tests_dir
  • To run a particular test case file:
phpunit test_file_name

Documentation

The complete docs are here: RecordsKeeper php library documentation.