Add to create an address, check the balance, initiate a transfer, and view transaction information

Author: Fenguoz

.gitignore

@@ -0,0 +1,2 @@
+.idea
+vendor

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Fenguoz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,9 @@
+<h1 align="center">TRON-PHP</h1>
+
+### 安装
+
+```
+composer require fenguoz/tron-php
+```
+
+### 待更新

composer.json

@@ -0,0 +1,34 @@
+{
+    "name": "fenguoz/tron-php",
+    "description": "TRX TRX20",
+    "keywords": [
+        "php",
+        "tron",
+        "trx",
+        "trx20"
+    ],
+    "type": "library",
+    "homepage": "https://github.com/Fenguoz/tron-php",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Fenguoz",
+            "email": "[email protected]"
+        }
+    ],
+    "require": {
+        "guzzlehttp/guzzle": "^6.3",
+        "ionux/phactor": "1.0.8",
+        "kornrunner/keccak": "^1.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "Tron\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Test\\": "tests/"
+        }
+    }
+}

src/Address.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace Tron;
+
+use Tron\Support\Base58Check;
+use Tron\Support\Hash;
+
+class Address
+{
+    public $privateKey,
+        $address,
+        $hexAddress = '';
+
+    const ADDRESS_SIZE = 34;
+    const ADDRESS_PREFIX = "41";
+    const ADDRESS_PREFIX_BYTE = 0x41;
+
+    public function __construct(string $address = '', string $privateKey = '', string $hexAddress = '')
+    {
+        if (strlen($address) === 0) {
+            throw new \InvalidArgumentException('Address can not be empty');
+        }
+
+        $this->privateKey = $privateKey;
+        $this->address = $address;
+        $this->hexAddress = $hexAddress;
+    }
+
+    /**
+     * Dont rely on this. Always use Wallet::validateAddress to double check
+     * against tronGrid.
+     *
+     * @return bool
+     */
+    public function isValid(): bool
+    {
+        if (strlen($this->address) !== Address::ADDRESS_SIZE) {
+            return false;
+        }
+
+        $address = Base58Check::decode($this->address, false, 0, false);
+        $utf8 = hex2bin($address);
+
+        if (strlen($utf8) !== 25) {
+            return false;
+        }
+
+        if (strpos($utf8, self::ADDRESS_PREFIX_BYTE) !== 0) {
+            return false;
+        }
+
+        $checkSum = substr($utf8, 21);
+        $address = substr($utf8, 0, 21);
+
+        $hash0 = Hash::SHA256($address);
+        $hash1 = Hash::SHA256($hash0);
+        $checkSum1 = substr($hash1, 0, 4);
+
+        if ($checkSum === $checkSum1) {
+            return true;
+        }
+
+        return false;
+    }
+}

src/Api.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace Tron;
+
+use GuzzleHttp\Client;
+use Tron\Exceptions\TronErrorException;
+
+class Api
+{
+    private $_client;
+
+    public function __construct(Client $client)
+    {
+        $this->_client = $client;
+    }
+
+    public function getClient(): Client
+    {
+        return $this->_client;
+    }
+
+    /**
+     * Abstracts some common functionality like formatting the post data
+     * along with error handling.
+     *
+     * @throws TronErrorException
+     */
+    public function post(string $endpoint, array $data = [], bool $returnAssoc = false)
+    {
+        if (sizeof($data)) {
+            $data = ['json' => $data];
+        }
+
+        $stream = (string)$this->getClient()->post($endpoint, $data)->getBody();
+        $body = json_decode($stream, $returnAssoc);
+
+        $this->checkForErrorResponse($returnAssoc, $body);
+
+        return $body;
+    }
+
+    /**
+     * Check if the response has an error and throw it.
+     *
+     * @param bool $returnAssoc
+     * @param $body
+     * @throws TronErrorException
+     */
+    private function checkForErrorResponse(bool $returnAssoc, $body)
+    {
+        if ($returnAssoc) {
+            if (isset($body['Error'])) {
+                throw new TronErrorException($body['Error']);
+            } elseif (isset($body['code']) && isset($body['message'])) {
+                throw new TronErrorException($body['code'] . ': ' . hex2bin($body['message']));
+            }
+        }
+
+        if (isset($body->Error)) {
+            throw new TronErrorException($body->Error);
+        } elseif (isset($body->code) && isset($body->message)) {
+            throw new TronErrorException($body->code . ': ' . hex2bin($body->message));
+        }
+    }
+}

src/Block.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Tron;
+
+class Block
+{
+    public $blockID;
+    public $block_header;
+
+    public function __construct(string $blockID, array $block_header)
+    {
+        if (!strlen($blockID)) {
+            throw new \Exception('blockID empty');
+        }
+
+        $this->blockID = $blockID;
+        $this->block_header = $block_header;
+    }
+}

src/Exceptions/TransactionException.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace Tron\Exceptions;
+
+class TransactionException extends \Exception
+{
+}

src/Exceptions/TronErrorException.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace Tron\Exceptions;
+
+class TronErrorException extends \Exception
+{
+}

src/Interfaces/WalletInterface.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Tron\Interfaces;
+
+use Tron\Address;
+use Tron\Block;
+use Tron\Transaction;
+
+interface WalletInterface
+{
+    public function generateAddress(): Address;
+
+    public function validateAddress(Address $address): bool;
+
+    public function balance(Address $address);
+
+    public function transfer(Address $from, Address $to, float $amount): Transaction;
+
+    public function blockNumber(): Block;
+
+    public function transactionReceipt(string $txHash);
+}