howrareis/solana-php-sdk

v0.5.0 2022-09-15 14:30 UTC

This package is auto-updated.

Last update: 2024-09-15 19:10:03 UTC


README

Latest Version on Packagist

⚠️ 这是原始 solana-php-sdk 的一个分支,并非由原始作者或原始包的新维护者维护。为了避免与原始包冲突,项目已移至新命名空间。此分支将与原始项目有所不同,并且不会保持功能一致性。无法将两个项目作为直接替换项使用。

简单的 Solana PHP SDK。

安装

您可以通过 composer 安装此包

composer require howrareis/solana-php-sdk

用法

使用 Solana 简单客户端

您可以使用 Connection 类方便地访问 API 方法。一些方法已在代码中定义

use HowRareIs\SolanaPhpSdk\Connection;
use HowRareIs\SolanaPhpSdk\SolanaRpcClient;

// Using a defined method
$sdk = new Connection(new SolanaRpcClient(SolanaRpcClient::MAINNET_ENDPOINT));
$accountInfo = $sdk->getAccountInfo('4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA');
var_dump($accountInfo);

有关所有可能的方法,请参阅API 文档

直接使用 RPC 客户端

Connection 类只是 RPC 客户端的一个轻量级便利层。如果您愿意,可以直接使用客户端,这允许您使用完整的 Response 对象

use HowRareIs\SolanaPhpSdk\SolanaRpcClient;

$client = new SolanaRpcClient(SolanaRpcClient::MAINNET_ENDPOINT);
$accountInfoResponse = $client->call('getAccountInfo', ['4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA']);
$accountInfoBody = $accountInfoResponse->json();
$accountInfoStatusCode = $accountInfoResponse->getStatusCode();

交易

以下是一个向 Solana 区块链发送转账指令的工作示例

$client = new SolanaRpcClient(SolanaRpcClient::DEVNET_ENDPOINT);
$connection = new Connection($client);
$fromPublicKey = KeyPair::fromSecretKey([...]);
$toPublicKey = new PublicKey('J3dxNj7nDRRqRRXuEMynDG57DkZK4jYRuv3Garmb1i99');
$instruction = SystemProgram::transfer(
    $fromPublicKey->getPublicKey(),
    $toPublicKey,
    6
);

$transaction = new Transaction(null, null, $fromPublicKey->getPublicKey());
$transaction->add($instruction);

$txHash = $connection->sendTransaction($transaction, $fromPublicKey);

注意:此项目处于 alpha 版,生成指令的代码仍在开发中 $instruction = SystemProgram::abc()

路线图

  1. Borsh 序列化和反序列化。
  2. 改进文档。
  3. 构建更多 Connection、SystemProgram、TokenProgram、MetaplexProgram 类。
  4. 改进处理二进制数据的相关抽象。
  5. 优化
    1. 更好地利用 PHP。
    2. 在发送交易时更好地缓存 $recentBlockhash
  6. 有建议吗?请提交 issue 或 PR :D

测试

composer test

贡献

有关详细信息,请参阅 CONTRIBUTING

安全

如果您发现任何与安全相关的问题,请通过电子邮件 security@howrare.is 而不是使用问题跟踪器。

鸣谢

许可协议

MIT 许可协议(MIT)。有关更多信息,请参阅 许可文件