Download do solana php sdk - solana php sdk Download do código -fonte

SOLANA PHP SDK

Status da ação dos testes do GitHub

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

SDK PHP simples para interagir com as transações, assinaturas, serialização/deserialização de Borsh e RPCs

Bifurcado do Repo Verze: Verze-App/Solana-Php-SDK

Motivações

Para proteger as teclas da API RPC atuando como um proxy hospedado.
Para ativar o processamento de dados em segundo plano.
Para habilitar dados descentralizados e cache de consultas.
Para capacitar aplicativos PHP para interagir com a rede Solana
Para ativar trabalhos e consultas assíncronas em segundo plano.
Para habilitar Websockets descentralizados (notificações e assinaturas push)
Para reduzir a pesquisa de RPC do cliente-sice, com o objetivo de descongestionando a rede principal e o DevNets.

Instalação

Você pode instalar o pacote via compositor:

composer require attestto/solana-php-sdk

Deste repositório

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

cd solana-php-sdk

composer install

Com Docker

Dockerfile
compor-dev.yaml

docker build -t solana-php-sdk .

então

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

Uso

Usando o cliente simples do Solana

Você pode usar a classe Connection para obter acesso conveniente aos métodos da API. Alguns são definidos no código:

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

Para todos os métodos possíveis, consulte a documentação da API.

Diretamente usando o cliente RPC

A classe Connection é apenas uma camada de conveniência leve sobre o cliente RPC. Você pode, se quiser, usar o cliente diretamente, o que permite trabalhar com o objeto Response completo:

 use Attestto  SolanaPhpSdk  SolanaRpcClient ;

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

Transações

Aqui está o exemplo de envio de uma instrução de transferência para o blockchain Solana, você pode substituir o terminal com um endpoint RPC personalizado:

 $ 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 desaperializando e desaperiados

Para que a serialização/deserdalização de Borsh funcione, um objeto de classe :: Schema reflete as estruturas do programa, com base no IDL do programa deve ser aprovado ou definido. por exemplo

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

Uso Borsh (implementação do PHP)

Para entender melhor a implementação e o uso, consulte as seguintes referências:

Teste PHP Borsh
PHP BORSH CLASS
Traço Php Borsh

Exemplo de uso (isso será melhorado, 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 ;
    }

Notas:

A maior parte da magia é feita no traço BorshdeAlizable.php.
Este projeto está em Alpha, o código para gerar instruções ainda está sendo trabalhado em $instruction = SystemProgram::abc()
Este projeto é mantido por um único dev, portanto, qualquer feedback, idéias e comentários são apreciados.

Roteiro (WIP)

Borsh serializa e desapego. Feito - teste (s) - cobertura
Documentação aprimorada. WIP-Este documento + Índice de Documentação (https://github.com/attestto-coM/solana-php-sdk/tree/master/docs)
Crie mais a conexão, mensagem, programa System, TokenProgram, MetaplexProgram. WIP - Testes - Cobertura 4. [] Conexão :: Classe 5. [x] getLatestblokChash :: Class [fonte] - [teste] - [cobertura] 6. [] getMinimMumbalanceForrentexemption () 7. [] [] getTokenCountBalance () 6. [] transactionMessage::: [] [] [] CompiletCountBalance () 6. ] Programa SPL -TOKEN 10. [] GetorCreAtEASSOCIATTOKENCONTE () 11. [] getassociatedTokenDresfressync () 12. [] CreateAssociatedTokenAcountInstruction () 11. [] CreateSyncnativeInstruction () - [Test] [Cobertura] [Cobertura] [Cobertura]
Melhore as abstrações em torno do trabalho com dados binários. Feito? - Teste (s) - Cobertura
Otimizações:
1. Aproveite o PHP mais.
2. Better Cache $recentBlockhash ao enviar transações.
Sugestões? Abra um problema ou solicitação de tração: D

Teste e cobertura de código

WIP - Trabalhando na cobertura e deprecações. Veja o relatório de cobertura.

Configuração 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 "
    },

Status da ação dos testes do GitHub

composer test

/verdor/bin/phpunit tests [options]

Contribuindo - sim, por favor! :-P

Por favor, consulte a contribuição para obter detalhes.
Vou mudar minha foto de perfil assim que conseguirmos um segundo mantainer a bordo :-)

Segurança

Se você descobrir algum problema relacionado à segurança, envie um email para os mantenedores (consulte Composer.json) em vez de usar o rastreador de problemas.