Shulou(Shulou.com)06/01 Report--

This article mainly introduces "Ripple block chain how to dock PHP development kit". In daily operation, I believe many people have doubts about how to dock Ripple block chain with PHP development kit. The editor consulted all kinds of materials and sorted out simple and easy-to-use operation methods. I hope it will be helpful to answer the doubt of "how to connect Ripple block chain to PHP development kit". Next, please follow the editor to study!

XrpTool can help PHP applications quickly access Ruibo / Ripple block chain, which not only supports the deployment of application scenarios with their own Ripple nodes, but also supports the use of public Ripple nodes to broadcast lightweight deployment scenarios of offline naked transactions.

1. Overview of the development package

XrpTool mainly includes the following features:

Full-featured Ripple node client that supports complete RPC API development interface

Support offline generation of Ripple key pairs and addresses, and support Secp256k1 and Ed25519 cryptographic algorithms

Offline serialization and offline signature supporting Ripple transactions

Support the direct transfer of Ruibo coins / XRP and self-issued tokens, and support a variety of Ripple transactions such as token issuance, currency transactions, cheque issuance, fund escrow and so on.

The XrpTool package runs in the PHP 7.1 + environment, and the current version 1.0.0

2 、 XrpTool

XrpTool is the entry class of the development package that you can use to quickly organize and broadcast a transaction or to access pre-created instance objects of other classes of the development package.

2.1 Organization, signature and broadcast of transactions

In XrpTool, the execution of an Ripple transaction consists of the following:

Organization of transaction data, using associative arrays to organize transaction data

The transaction data is signed and broadcast. The transaction is preprocessed, serialized and signed using the transact () method of the XrpTool instance, and finally submitted to the node for broadcast to the network.

Waiting for confirmation of the transaction

For example, the following code uses XrpTool to complete a direct payment transaction for Rippo currency / XRP:

Use XrpTool\ XrpTool;$tool = new XrpTool ('https://s.altnet.rippletest.net:51234'); / / expose the node using the test chain / / recover the identity certificate in ciphertext $credential = $tool- > restoreCredential (' snT3WxQbGLMAfqPhS9pYHM9gpib79') / / ID certificate of the initiating account / / Organization transaction data $tx = ['TransactionType' = >' Payment', / / transaction type: payment 'Account' = >' rfT5EnW5kfJNyLpUb6X9Do8HoUMvQKDrS8', / / initiating account 'Destination' = >' rnU5a7v51BV6znn8kq8jdGtZNDiMJxojcc' / / receive account 'Amount' = >' 13500' / / number of transactions Unit: drop] / / transaction serialization, signing, submission $txid = $tool- > transact ($tx,$credential); / / broadcast echo "tx hash = >" to the node. $txid. PHP_EOL; / / display transaction hash / / wait for transaction confirmation $validated = $tool- > waitForTx ($txid); / / default timeout: 5 seconds echo "tx validated = >". $validated. PHP_EOL; / / shows whether the balance of the receiving account has been confirmed / / queries the balance of the receiving account $balance = $tool- > getBalance ($tx ['Destination']); / / checks the balance of the receiving account echo "xrp balance = >". $balance- > xrp. PHP_EOL; / / Show XRP balance

2.2 supported deal types

For the types of Ripple transactions currently supported by XrpTool, please see the official website description: http://sc.hubwiz.com/codebag/xrp-php-lib/

2.3 example: token issuance and transfer

The Ripple blockchain allows any user to issue tokens as long as they are trusted, which is what the line of trust / TrustLine is for: Ripple uses a line of trust to represent a limited amount of trust from one user to another.

There are three steps to issuing tokens in the Ripple blockchain:

Enable the DefaultRipple flag of the issuing account

The receiving account sets the line of trust to the issuing account

The issuing account transfers tokens to the receiving account

The following code shows how to use XrpTool to issue custom tokens, where issuer represents the issuing account and receiver represents the token receiving account:

Use XrpTool\ XrpTool;$tool = new XrpTool ('https://s.altnet.rippletest.net:51234'); / / use the test chain to expose the node $issuer_address =' rfT5EnW5kfJNyLpUb6X9Do8HoUMvQKDrS8'; / / issue account address $issuer_secret = 'snT3WxQbGLMAfqPhS9pYHM9gpib79'; / / issue account ciphertext $receiver_address =' rnU5a7v51BV6znn8kq8jdGtZNDiMJxojcc'; / / receive account address $receiver_secret = 'snfjzzfRtq3hPdZ2msjFUxRN1748B' / / receive the account ciphertext / / enable the relevant flag of the issuing account $txi = ['TransactionType' = >' AccountSet', / / transaction type: AccountSet' Account' = > $issuer_address / / transaction initiation account 'SetFlag' = > 8, / / default-ripple / / set the DefaultRipple flag] $txid = $tool- > transactWithSecret ($txi,$issuer_secret); / / submit transaction $tool- > waitForTx ($txid) / / wait for transaction confirmation / / receive account setup trust line $txi = ['TransactionType' = >' TrustSet', / / transaction type: TrustSet' Account' = > $receiver_address / / transaction initiation account 'LimitAmount' = > [' currency' = > 'WIZ', / / trusted token name: WIZ' issuer' = > $issuer_address / / trusted issue account 'value' = >' 1000' / / Trust limit]] $txid = $tool- > transactWithSecret ($txi,$receiver_secret); / / submit transaction $tool- > waitForTx ($txid) / / wait for transaction confirmation / / issue token $txi = ['TransactionType' = >' Payment', / / transaction type: Payment' Account' = > $issuer_address / / transaction initiation account 'Destination' = > $receiver_address, / / token receiving account' Amount' = > [/ / token amount 'currency' = >' WIZ' / / token name 'value' = >' 15', / / token quantity 'issuer' = > $issuer_address / / token issuing account]] $txid = $tool- > transactWithSecret ($txi,$issuer_secret); / submit transaction $tool- > waitForTx ($txid); / / wait for transaction confirmation / / query token balance $balance = $tool- > getBalance ($receiver_address); / / query receiving account token balance foreach ($balance- > issued as $issued) {echo "issuer = >". $issued- > issuer. PHP_EOL; / / token issuing account echo "currency = >". $issued- > currency. PHP_EOL; / / token name echo "balance = >". $issued- > balance. PHP_EOL; / / token balance}

As you can see, in Ripple, both XRP transfer and token transfer use Payment transactions, the only difference is the value type of the Amount field: if the value is an associative array, token transfer is performed; if it is a numeric string, XRP transfer is performed.

3 、 RpcClient

The RpcClient class encapsulates the RPC API interface protocol of the Ripple node, and the XrpTool instance provides a pre-created RpcClient object through the rpcClient attribute, or you can create a RpcClient instance independently.

3.1 instantiation

Instantiating RpcClient requires the RPC API of the specified node to access the URL. For example, the following code creates an instance of RpcClient that connects to the local Ripple node, and subsequent RPC calls are submitted to the node corresponding to that URL:

Use XrpTool\ RpcClient;$client = new RpcClient ('http://localhost:51234'); / / use local node

Note: the access protocol (http | https) and listening port of the RPC API of the Ripple node depend on the configuration file. The above code assumes that the local Ripple node RPC API has been configured with http protocol access and listens on port 51234.

You can also create a RpcClient instance that connects to the public node of the main chain, for example:

$client = new RpcClient ('https://s1.ripple.com:51234'); / / expose nodes using the main chain

Or create a RpcClient instance that connects to the exposed nodes of the test chain, for example:

$client = new RpcClient ('https://s.altnet.rippletest.net:51234'); / / expose nodes using test chain

The official download address of XrpTool is http://sc.hubwiz.com/codebag/xrp-php-lib/.

3.2 call RPC API

The method name of RpcClient corresponds directly to the RPC API name of Ripple. For example, the following code calls server_info API to query Ripple node information:

$ret = $client- > server_info (); / / call RPC API:server_infoecho 'version = >'. $ret- > info- > build_version. PHP_EOL; / / display node software version information

Some RPC API calls need to pass some parameters, such as the account_info call for querying account information. In this case, you need to organize the parameters into an associative array and pass the method of the same name to the RpcClient object:

$params = [/ / use the associative array to declare the RPC API parameter 'account' = >' rG1QQv2nh3gr7RCZ1P8YYcBUKCCN633jCn' / / account: account to be queried]; $ret = $client- > account_info ($params); / / query the details of the specified Ripple account echo 'balance = >'. $ret- > account_data- > Balance. PHP_EOL; / / displays the account balance (in drop3.3) example: transfer XRP using RPC API

If you use your own Ripple node, you can use the Sign-and-Submit mode called by submit to perform transactions such as money transfers. For example, use the following code to pay 0.0123456 XRP from the Alice account to the Bob account:

$alice = "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"; / / Alice account $bob = "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX"; / / Bob account $amount = "123456" / / Unit: drop$params = ["offline" = > false, / / Node signature "secret" = > "s ██" is required / / password for signature "tx_json" = > ["TransactionType": "Payment", / / transaction type: pay "Account" = > $alice, / / initiate account "Destination": $bob / / receive account "Amount" = > $amount / / number of payments Unit: drop]] $ret = $client- > submit ($params); / / sign and broadcast the transaction echo'tx hash = >'. $ret- > tx_json- > hash. PHP_EOL; / / transaction hash

Note: by default, the sign-and-submit mode of submit calls can only be called on node management connections. To execute the above code correctly, you need to create a RpcClient instance using management connections, or enable public signature support for this node. If you execute demo/rpcclient-demo.php, the following exception occurs:

4 、 Credential

Like other blockchains, Ripple uses asymmetric key pairs to identify its identity, but it supports both the classical Secp256k1 algorithm and newer Ed25519 algorithms. The XrpTool development kit uses the CrdlSecp256k1 class and the CrdlEd25519 class to represent the Ripple credentials corresponding to these two algorithms.

You can use the CrdlFacotry factory class to create new Ripple key pairs and addresses offline, or you can use Ripple ciphertext to recover previously created key pairs and addresses. The crdlFactory property of the XrpTool object provides a pre-created CrdlFactory object, or you can create a CrdlFactory object directly with the following code:

Use Xrp\ Crypto\ CrdlFactory;$cf = new CrdlFactory (); / / create identity credential factory object 4.1 create new identity credentials

Use the generate () method to create a new random key pair and derive the corresponding Ripple address. For example, the following code creates a Ripple identity credential using the Secp256k1 algorithm:

$credential = $cf- > generate (); / / create a random identity certificate using the secp256k1 algorithm / / $credential = $cf- > generate ('secp256k1'); / / as above, the secp256k1 algorithm echo' private = >'is used by default. $credential- > private. PHP_EOL; / / displays the private key of the identity certificate echo 'public = >'. $credential- > public. PHP_EOL; / / displays the public key of the identity certificate echo 'address = >'. $credential- > address. PHP_EOL; / / displays the address of the identity credential

Similarly, the following code uses the ed25519 algorithm to create identity credentials:

$credential = $cf- > generate ('ed25519'); / / create a random identity credential echo' address = > 'using the ed25519 algorithm. $credential- > address. PHP_EOL; / / address 4.2 showing identity credentials using Ripple ciphertext to recover identity credentials

If you have the ciphertext of the identity certificate, you can use the fromSecret () method to recover the corresponding Ripple identity certificate. For example:

$secret = 'snfjzzfRtq3hPdZ2msjFUxRN1748B'; / / Ripple credential ciphertext $credential = $cf- > fromSecret ($secret); / / recover the credential echo' address = > 'with a password. $credential- > address. PHP_EOL; / / displays the address of the identity certificate at this point, and the study on "how to connect the Ripple block chain to the PHP development package" is over. I hope to be able to solve your doubts. The collocation of theory and practice can better help you learn, go and try it! If you want to continue to learn more related knowledge, please continue to follow the website, the editor will continue to work hard to bring you more practical articles!

Welcome to subscribe "Shulou Technology Information " to get latest news, interesting things and hot topics in the IT industry, and controls the hottest and latest Internet news, technology news and IT industry trends.