solana php sdk Download - solana php sdk Quellcode Download

Solana PHP SDK

GitHub -Tests Aktionsstatus

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

Einfache PHP -SDK zum Interagieren mit den Transaktionen, Signaturen, Borsh -Serialisierung/Deserialisierung und RPCs

Aus dem Verze Repo gegabelt: verze-App/Solana-Php-SDK

Motivationen

Zum Schutz der RPC -API -Schlüssel, die als gehostete Proxy fungieren.
Um die Hintergrunddatenverarbeitung zu aktivieren.
Desconisierte Daten und Abfrage -Caching ermöglichen.
Um PHP -Anwendungen zu stärken, um mit dem Solana -Netzwerk zu interagieren
Um asynchronisierte Jobs und Abfragen im Hintergrund zu ermöglichen.
So aktivieren Sie deetralisierte Websockets (Push -Benachrichtigungen und Abonnements).
Reduzierung von RPC-Umfragen von Client-Size, um das Mainnet und Devnets zu entlasten.

Installation

Sie können das Paket über Komponist installieren:

composer require attestto/solana-php-sdk

Aus diesem Repository

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

cd solana-php-sdk

composer install

Mit Docker

Dockerfile
compose-dev.yaml

docker build -t solana-php-sdk .

Dann

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

Verwendung

Verwenden des Solana Simple Clients

Sie können die Connection für einen bequemen Zugriff auf API -Methoden verwenden. Einige sind im Code definiert:

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

Bei allen möglichen Methoden siehe die API -Dokumentation.

Direkt mit dem RPC -Client verwenden

Die Connection ist nur eine leichte Komfortschicht über dem RPC -Client. Wenn Sie möchten, können Sie den Client direkt verwenden, sodass Sie mit dem vollständigen Response arbeiten können:

 use Attestto  SolanaPhpSdk  SolanaRpcClient ;

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

Transaktionen

Hier ist ein Beispiel für das Senden einer Übertragungsanweisung an die Solana -Blockchain. Sie können den Endpunkt mit einem benutzerdefinierten RPC -Endpunkt:::::::

 $ 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

Damit die Borsh -Serialisierung/-Deseralisierung zur Arbeit ist, muss ein Klasse :: Schema -Objekt, das die Programmstrukturen widerspiegelt, basierend auf dem Programm IDL übergeben oder definiert werden. z.B

 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 -Nutzung (PHP -Implementierung)

Um die Implementierung und Verwendung besser zu verstehen, finden Sie die folgenden Referenzen:

PHP -Borsh -Test
PHP Borsh -Klasse
PHP Borsh Merkmal

Beispiel Verwendung (dies wird verbessert, 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 ;
    }

Anmerkungen:

Der größte Teil der Magie erfolgt im Merkmal von Borshdesealizable.php.
Dieses Projekt befindet sich in Alpha. Der Code zum Generieren von Anweisungen wird weiterhin auf $instruction = SystemProgram::abc() bearbeitet.
Dieses Projekt wird von einem einzigen Entwickler gepflegt, sodass alle Feedback, Ideen, Kommentare geschätzt werden.

Roadmap (WIP)

Borsh Serialize und Deserialisieren. Fertig - Test (s) - Abdeckung
Verbesserte Dokumentation. WIP-Dieser Dokument + Dokumentationsindex (https://github.com/attesto-com/solana-php-sdk/tree/master/docs)
Erstellen Sie mehr Verbindungen, Meldungen, Systemprogramme, Tokenprogramme, MetaplexProgram -Klassen. WIP - Tests - Abdeckung 4. [] Verbindung :: Klasse 5. [x] GetLatestblokChash :: Klasse [Quelle] - [Test] - [Berichterstattung] 6. [] GetMinimumbalanceForrentExemption () 7. [] GetToken Accountbalance () 6. SPL -TOOKE -Programm 10. [] GetOrCreateAsociatedTokenAccount () 11. [] GetAsociatedTokenaddressSync () 12. [] CreateasSociatedTokenAccountinstruction () 11. [] createSyncnativeInstruction () - [Test] [Abdeckung]
Verbesserung der Abstraktionen zur Arbeit mit binären Daten. Erledigt? - Test (s) - Abdeckung
Optimierungen:
1. Nutzen Sie mehr PHP.
2. Besserem Cache $recentBlockhash beim Senden von Transaktionen.
Vorschläge? Eine Ausgabe öffnen oder Anfrage anziehen: D.

Test- und Codeabdeckung

WIP - Arbeiten an Deckung und Abschreibungen. Siehe Deckungsbericht.

Konfiguration 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 -Tests Aktionsstatus

composer test

ODER

/verdor/bin/phpunit tests [options]

Beitrag - ja bitte! :-P

Weitere Informationen finden Sie unter Beitrag.
Ich werde mein Profilbild ändern, sobald wir einen 2. Mantainer an Bord bekommen :-)

Sicherheit

Wenn Sie sicherheitsrelevante Probleme entdecken, senden Sie bitte eine E -Mail an die Betreuer (siehe Composer.json), anstatt den Ausgabe -Tracker zu verwenden.