Скачать solana php sdk - solana php sdk Source Code Скачать

Solana PHP SDK

GitHub проверяет статус действия

    ____  __  ______     _____ ____  __    ___    _   _____       _____ ____  __ __
   / __  / / / / __    / ___ // __ / /   /   |  / | / /   |     / ___// __ / //_/
  / / _ / / / _ / / / _ / /    __  / / / / /   / / | | /  | / / / | |     __ / / / / ,<   
 / ____ / __  / ____ /   ___ / / / _ / / / ___ / ___ | / / |  / ___ |    ___ / / / _ / / / | |  
/ _ /   / _ / / _ / _ /       / ____ / _ ___ / _____ / _ /  | _ / _ / | _ / _ /  | _ |   / ____ / _____ / _ / | _ |

Простой PHP SDK для взаимодействия с транзакциями, подписями, сериализацией/десериализацией Borsh и RPC

Раздвоенный от репо Verze: Verze-app/solana-php-sdk

Мотивы

Для защиты клавиш RPC API выступают в качестве прокси -сервера.
Чтобы включить обработку фоновых данных.
Чтобы включить рассекализованные данные и кэширование запросов.
Чтобы расширить возможности PHP -приложения для взаимодействия с сетью Solana
Чтобы включить асинхронные работы и запросы в фоновом режиме.
Чтобы включить детралализованные веб -токи (push -уведомления и подписки)
Чтобы уменьшить опрос RPC на сайте клиента, стремясь к переоборудованию Mainnet и Devnets.

Установка

Вы можете установить пакет через композитор:

composer require attestto/solana-php-sdk

Из этого хранилища

git clone https://github.com/Attestto-com/solana-php-sdk.git

cd solana-php-sdk

composer install

С докером

Dockerfile
Compose-Dev.yaml

docker build -t solana-php-sdk .

затем

docker run -it solana-php-sdk /bin/bash

Использование

Использование Solana Simple Client

Вы можете использовать класс Connection для удобного доступа к методам API. Некоторые определены в коде:

 use Attestto  SolanaPhpSdk  Connection ;
use Attestto  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 Attestto  SolanaPhpSdk  SolanaRpcClient ;

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

Транзакции

Вот рабочий пример отправки инструкции по переводу в блокчейн Solana, вы можете пережить конечную точку с помощью пользовательской конечной точки RPC.:

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

Borsh Deserialize & Deserialize

Для сериализации Borsh/Deseralization для работы, объект Class :: Schema, отражающий структуры программы, на основе программы IDL должен быть передан или определен. например

 class DidData
{

    use BorshObject; //trait
    public $ keyData ;

    public const SCHEMA = [
        VerificationMethodStruct::class => VerificationMethodStruct:: SCHEMA [VerificationMethodStruct::class],
        ServiceStruct::class => ServiceStruct:: SCHEMA [ServiceStruct::class],
        self ::class => [
            ' kind ' => ' struct ' ,
            ' fields ' => [
                [ ' offset ' , ' u64 ' ],
                [ ' version ' , ' u8 ' ],
                [ ' bump ' , ' u8 ' ],
                [ ' nonce ' , ' u64 ' ],
                [ ' initialVerificationMethod ' , ' string ' ],
                [ ' flags ' , ' u16 ' ],
                [ ' methodType ' , ' u8 ' ],
                [ ' keyData ' , [ ' u8 ' ]],
                [ ' verificationMethods ' , [VerificationMethodStruct::class]],
                [ ' services ' , [ServiceStruct::class]],
                [ ' nativeControllers ' , [ ' pubKey ' ]],
                [ ' otherControllers ' , [ ' string ' ]],
            ],
        ],
    ];

    public static function fromBuffer ( array $ buffer ): self
    {
        return Borsh:: deserialize ( self :: SCHEMA , self ::class, $ buffer );
    }
}

Использование Borsh (реализация PHP)

Чтобы лучше понять реализацию и использование, обратитесь к следующим ссылкам:

PHP Borsh Test
PHP Borsh Class
PHP Borsh Черта

Пример использования (это будет улучшено, WIP) :

 /**
     * deserializeDidData
     *
     * @param string $dataBase64 The base64 encoded data of the DID data account
     * @return DidData The deserialized DID data object
     * @example DidSolProgram::deserializeDidData('TVjvjfsd7fMA/gAAAA...');
     */
    static function deserializeDidData ( $ dataBase64 )
    {

        $ base64String = base64_decode ( $ dataBase64 );
        $ uint8Array = array_values ( unpack ( ' C* ' , $ base64String ));
        $ didData = DidData:: fromBuffer ( $ uint8Array ); // See above code block

        $ keyData = $ didData -> keyData ;

        $ binaryString = pack ( ' C* ' , ... $ keyData );

        $ b58 = new Base58 ();
        $ base58String = $ b58 -> encode ( $ binaryString );
        $ didData -> keyData = $ base58String ;
        return $ didData ;
    }

Примечания:

Большая часть магии сделана в черте BorshdeSealizable.php.
Этот проект в Альфе, код для генерации инструкций все еще работает на $instruction = SystemProgram::abc()
Этот проект поддерживается одним разработчиком, поэтому любые отзывы, идеи, комментарии ценятся.

Дорожная карта (WIP)

Borsh Serialize и Deserialize. Готово - Тест (ы) - покрытие
Улучшенная документация. WIP-этот документ + индекс документации (https://github.com/attestto-com/solana-php-sdk/tree/master/docs)
Создайте больше соединения, сообщения, системной программы, токенопрограммы, классов MetAplexprogram. WIP - Тесты - покрытие 4. [] Connection :: Класс 5. ] Программа Spl -Token 10. [] getorCreateAssociatedTokenAccount () 11. [] getAssociatedTokenDdressSync () 12. [] createassociatedTokenAccountInstruction () 11. [] createSyncnatiinsdruction () - [test] [охват].
Улучшение абстракций вокруг работы с бинарными данными. Сделанный? - Тест (ы) - покрытие
Оптимизации:
1. Рыждайте PHP больше.
2. Лучший кэш $recentBlockhash при отправке транзакций.
Предложения? Откройте проблему или запрос на вытягивание: D

Тестирование и покрытие кода

WIP - Работа над покрытием и ослаблением. См. Отчет о покрытии.

Конфигурация phpunit.xml
Composer.json

   "scripts" : {
        "test" : " vendor/bin/phpunit tests --coverage-clover=coverage.xml --coverage-filter src/ " ,
        "format" : " vendor/bin/php-cs-fixer fix --allow-risk=yes "
    },

GitHub проверяет статус действия

composer test

ИЛИ

/verdor/bin/phpunit tests [options]

Вклад - да, пожалуйста! :-P

Пожалуйста, смотрите для получения подробной информации.
Я смену свой профиль, как только мы получим 2-й Mantainer на борту :-)

Безопасность

Если вы обнаружите какие -либо проблемы, связанные с безопасностью, пожалуйста, отправьте электронное письмо со стороны сопровождающих (см. Composer.json) вместо использования трекера выпуска.