pantaovay/solana-php-sdk

Solana PHP SDK

v0.3.1 2022-02-23 19:26 UTC

Requires

• php: ^7.4 || ~8.0
• ext-sodium: *
• guzzlehttp/guzzle: ^7.3
• illuminate/http: ~8.0 || ~9.0
• illuminate/support: ^8.0 || ~9.0
• stephenhill/base58: ^1.1

Requires (Dev)

• mockery/mockery: ^1.4
• orchestra/testbench: ^6.0
• phpunit/phpunit: ^9.0
• squizlabs/php_codesniffer: ^3.5
• tightenco/tlint: ^5.0

MIT

• Matt Stauffer
• Zach Vander Velden

• php
• sdk
• blockchain
• sol
• tightenco
• solana-php-sdk
• solana

README

⚠️ This is an alpha release; functionality may change.

Simple PHP SDK for Solana.

Installation

You can install the package via composer:

composer require tightenco/solana-php-sdk

Usage

Using the Solana simple client

You can use the Connection class for convenient access to API methods. Some are defined in the code:

use Tighten\SolanaPhpSdk\Connection;
use Tighten\SolanaPhpSdk\SolanaRpcClient;

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

For all the possible methods, see the API documentation.

Directly using the RPC client

The Connection class is just a light convenience layer on top of the RPC client. You can, if you want, use the client directly, which allows you to work with the full Response object:

use Tighten\SolanaPhpSdk\SolanaRpcClient;

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

Transactions

Here is working example of sending a transfer instruction to the Solana blockchain:

$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);

Note: This project is in alpha, the code to generate instructions is still being worked on $instruction = SystemProgram::abc()

Roadmap

1. Borsh serialize and deserialize.
2. Improved documentation.
3. Build out more of the Connection, SystemProgram, TokenProgram, MetaplexProgram classes.
4. Improve abstractions around working with binary data.
5. Optimizations:
   1. Leverage PHP more.
   2. Better cache $recentBlockhash when sending transactions.
6. Suggestions? Open an issue or PR :D

Testing

composer test

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Matt Stauffer
• Zach Vander Velden
• All Contributors

License

The MIT License (MIT). Please see License File for more information.