elaheh4/tron-php-wallet-api

This is an implementation of the TRON protocol in PHP using GRPC.

PHP TRON Wallet API

This is an implementation of the TRON protocol in PHP using GRPC.

Documentation

If new to protocol buffers or GRPC start with the following documentation:

1. Google Protocol Buffers documentation
2. GRPC PHP documentation

Examples

List witnesses

$wallet = new \Protocol\WalletClient('47.91.216.69:50051', [
   'credentials' => Grpc\ChannelCredentials::createInsecure()
]);

$emptyMessage = new \Protocol\EmptyMessage();

/* @var \Protocol\WitnessList $witnesses */
list($witnesses, $options) = $wallet->ListWitnesses($emptyMessage)->wait();

$base58 = new Tuupola\Base58;

/* @var \Protocol\Witness $witness */
foreach ($witnesses->getWitnesses() as $witness) {
    var_dump($base58->encode($witness->getAddress()));
}

Scan the blockchain

$wallet = new \Protocol\WalletClient('47.91.216.69:50051', [
    'credentials' => Grpc\ChannelCredentials::createInsecure()
]);

$n = 15523;
do {
    $numberMessage = new \Protocol\NumberMessage();
    $numberMessage->setNum($n--);
    list($block, $meta) = $wallet->GetBlockByNum($numberMessage)->wait();
    /* @var \Protocol\Block $block */
    $transactions = $block->getTransactions();
} while(!$transactions->count());

var_dump(sprintf('block #%d seems to have %d transactions!', $n, $transactions->count()));

Development

To update PHP files according to the TRON protocol install protoc and run

sudo bash ./genphp.sh

Issues

• Encoding and crypto utilities
• Unit tests
• Proper namespacing of protocol and metadata classes e.g. Tron\Protocol\Account instead of Protocol\Account
• Add proper @return tags and type hinting (this is a protoc issue? docblocks could be improved to remove the need for inline typehinting)