gegosoft/laravel-rippledrpc

Laravel Rippled RPC 库

v1.1 2018-08-06 12:18 UTC

This package is auto-updated.

Last update: 2024-09-29 04:49:02 UTC


README

Build Status Coverage Status Latest Stable Version Latest Unstable Version

这是一个用于与 XRP 分类账通信的 PHP 库。

除了封装 rippled API,它还验证方法/事务参数并规范化响应。

有关方法、参数和预期响应的详细信息,请参阅API 文档,该文档位于Ripple 开发者门户

依赖关系

该项目通过使用 HTTPLUG 实现 PSR-7,因此开发人员可以选择最适合其架构的 HTTP 客户端

如果您没有偏好,只需运行以下命令,然后进入安装部分。

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

安装

composer require gegosoft/rippled-php

快速入门

检索余额

<?php

use gegosoft\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'];
}

有关更多错误处理控制,请参阅异常处理

文档

单元测试

运行单元测试套件

make test

运行测试覆盖率

make cov

运行覆盖率命令后,打开 tests/coverage/index.html 以查看报告。

功能测试

功能测试将在实时服务器上运行代码。当然,这应该在测试服务器上运行。

如果您还没有测试账户,创建两个并记录每个账户的 id 和密钥。

https://developers.ripple.com/xrp-test-net-faucet.html

功能测试套件从 .env.test 加载端点和账户信息。

如果您尚未这样做,请将 .env.test.dist 复制到 .env.test 并添加您的账户信息。

gegosoft_ACCT_1_ID 需要 100 XRP 进行测试。

使用以下命令运行功能测试套件。

make testf

贡献

欢迎 PR 和新问题!