foxrp/rippled-php

A PHP library for communication with rippled. (The XRP Ledger)

rippled-php

, _(*1)

This is a PHP library for communicating with the XRP Ledger., _(*2)

In addition to wrapping the rippled API, it validates method/transaction parameters and normalizes responses., _(*3)

Refer to the API Documentation in the Ripple Developer Portal for methods, parameters, and expected responses., _(*4)

Dependencies

This project implements PSR-7 via the use of HTTPLUG so the developer can select the HTTP Client best suited for their architecture., _(*5)

If you do not have a preference, simply run the command below and proceed to the installation section., _(*6)

composer require php-http/guzzle6-adapter php-http/message

Installation

composer require foxrp/rippled-php

QuickStart

Retrieve Balance

<?php

use FOXRP\Rippled\Client;

$client = new Client('https://s1.ripple.com:51234');

$balance = null;

$response = $client->send('account_info', [
    'account' => 'rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn'
]);

// Set balance if successful.
if ($response->isSuccess()) {
    $data = $response->getResult();
    $balance = $data['account_data']['Balance'];
}

See Exception Handling for more control over handling errors., _(*7)

Documentation

• API Requests
• Transactions
• Exception Handling

Unit Testing

Run the unit test suite:, _(*8)

make test

Run test coverage:, _(*9)

make cov

Once you run the coverage command, open tests/coverage/index.html to view the report., _(*10)

Functional Testing

Functional tests run code against a live server. Of course this should be run against a test server., _(*11)

If you don't already have test accounts, create 2 and note the account id and secret for each., _(*12)

https://developers.ripple.com/xrp-test-net-faucet.html, _(*13)

The functional test suite loads endpoint and account info from .env.test., _(*14)

If you haven't already, copy .env.test.dist to .env.test and add your account info., _(*15)

FOXRP_ACCT_1_ID requires 100 XRP for the tests., _(*16)

Use the following command to run the functional test suite., _(*17)

make testf

Contribute

PRs & New Issues are welcome!, _(*18)

XRP Tip Jar: rwSZu5vAgPEdoDpYx9qZtqtHRDcFwCooqw, _(*19)