added Working with contracts

composer.json

@@ -19,7 +19,7 @@
     ],
 
     "require": {
-        "php": "^7.2",
+        "php": "^7.3",
         "guzzlehttp/guzzle": "^7.0",
         "iexbase/web3.php": "^2.0.1",
         "kornrunner/secp256k1": "^0.1.2",

examples/contract.php

@@ -0,0 +1,32 @@
+<?php
+
+include_once '../vendor/autoload.php';
+
+use IEXBase\TronAPI\Tron;
+
+
+try {
+    $fullNode = new \IEXBase\TronAPI\Provider\HttpProvider('https://api.trongrid.io');
+    $solidityNode = new \IEXBase\TronAPI\Provider\HttpProvider('https://api.trongrid.io');
+    $eventServer = new \IEXBase\TronAPI\Provider\HttpProvider('https://api.trongrid.io');
+} catch (\IEXBase\TronAPI\Exception\TronException $e) {
+    echo $e->getMessage();
+}
+
+
+try {
+    $tron = new Tron($fullNode, $solidityNode, $eventServer, null, true);
+    $contract = $tron->contract('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t');  // Tether USDT https://tronscan.org/#/token20/TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
+
+
+    // Data
+    echo $contract->name();
+    echo $contract->symbol();
+    echo $contract->balanceOf();
+    echo $contract->totalSupply();
+    //echo  $contract->transfer('to', 'amount', 'from');
+
+
+} catch (\IEXBase\TronAPI\Exception\TronException $e) {
+    echo $e->getMessage();
+}

src/Exception/TRC20Exception.php

@@ -0,0 +1,5 @@
+<?php
+namespace IEXBase\TronAPI\Exception;
+
+class TRC20Exception extends TronException {
+}

src/TRC20Contract.php

@@ -0,0 +1,253 @@
+<?php
+
+/**
+ * TronAPI
+ *
+ * @author  Shamsudin Serderov <steein.shamsudin@gmail.com>
+ * @license https://github.com/iexbase/tron-api/blob/master/LICENSE (MIT License)
+ * @version 1.3.4
+ * @link    https://github.com/iexbase/tron-api
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace IEXBase\TronAPI;
+
+use IEXBase\TronAPI\Exception\TRC20Exception;
+
+class TRC20Contract
+{
+    const TRX_TO_SUN = 1000000;
+    const SUN_TO_TRX = 0.000001;
+
+    /***
+     * Maximum decimal supported by the Token
+     *
+     * @var integer
+    */
+    private $decimals;
+
+    /**
+     * The smart contract which issued TRC20 Token
+     *
+     * @var string
+    */
+    private $contractAddress;
+
+    /**
+     * ABI Data
+     *
+     * @var string
+    */
+    private $abiData;
+
+    /**
+     * Fee Limit
+     *
+     * @var integer
+     */
+    private $feeLimit = 10;
+
+    /**
+     * Base Tron object
+     *
+     * @var Tron
+     */
+    protected $tron;
+
+    /**
+     * Create Trc20 Contract
+     *
+     * @param Tron $tron
+     * @param string $contractAddress
+     * @param string|null $abi
+     */
+    public function __construct(Tron $tron, string $contractAddress, string $abi = null)
+    {
+        $this->tron = $tron;
+
+        // If abi is absent, then it takes by default
+        if(is_null($abi)) {
+            $abi = file_get_contents(__DIR__.'/trc20.json');
+        }
+
+        $this->abiData = json_decode($abi, true);
+        $this->contractAddress = $contractAddress;
+    }
+
+    /**
+     * Get contract name
+     *
+     * @return string
+     * @throws \IEXBase\TronAPI\Exception\TronException
+     */
+    public function name()
+    {
+        return $this->trigger('name', null, [])[0];
+    }
+
+    /**
+     * Get symbol name
+     *
+     * @return string
+     * @throws \IEXBase\TronAPI\Exception\TronException
+     */
+    public function symbol()
+    {
+        return $this->trigger('symbol', null, [])[0];
+    }
+
+    /**
+     * Balance TRC20 contract
+     *
+     * @param string|null $address
+     * @return string
+     * @throws TRC20Exception
+     * @throws \IEXBase\TronAPI\Exception\TronException
+     */
+    public function balanceOf(string $address = null)
+    {
+        if(is_null($address))
+            $address = $this->tron->address['base58'];
+
+        $result = $this->trigger('balanceOf', $address, [
+            str_pad($this->tron->address2HexString($address), 64, "0", STR_PAD_LEFT)
+        ]);
+
+        $balance = $result[0]->toString();
+        if (!is_numeric($balance))
+            throw new TRC20Exception('Token balance not found');
+
+        return bcdiv($balance, bcpow("10", $this->decimals()), $this->decimals());
+    }
+
+    /**
+     * Send TRC20 contract
+     *
+     * @param string $to
+     * @param float $amount
+     * @param string|null $from
+     * @return string
+     * @throws TRC20Exception
+     * @throws \IEXBase\TronAPI\Exception\TronException
+     */
+    public function transfer(string $to, float $amount, string $from = null)
+    {
+        if($from == null) {
+            $from = $this->tron->address['base58'];
+        }
+
+        $feeLimitInSun = bcmul($this->feeLimit, self::TRX_TO_SUN);
+
+        if (!is_numeric($this->feeLimit) OR $this->feeLimit <= 0) {
+            throw new TRC20Exception('fee_limit is required.');
+        } else if($this->feeLimit > 1000) {
+            throw new TRC20Exception('fee_limit must not be greater than 1000 TRX.');
+        }
+
+        $tokenAmount = bcmul($amount, bcpow("10", $this->decimals(), 0), 0);
+        $transfer = $this->tron->getTransactionBuilder()
+            ->triggerSmartContract(
+                $this->abiData,
+                $this->tron->address2HexString($this->contractAddress),
+                'transfer',
+                [$this->tron->address2HexString($to),$tokenAmount],
+                $feeLimitInSun,
+                $this->tron->address2HexString($from)
+            )
+        ;
+        $signedTransaction = $this->tron->signTransaction($transfer);
+        $response = $this->tron->sendRawTransaction($signedTransaction);
+
+        return array_merge($response, $signedTransaction);
+    }
+
+    /**
+     * The total number of tokens issued on the main network
+     *
+     * @return string
+     * @throws TRC20Exception
+     * @throws \IEXBase\TronAPI\Exception\TronException
+     */
+    public function totalSupply()
+    {
+        $result      = $this->trigger('totalSupply', null, []);
+        $totalSupply = $result[0]->toString();
+
+        if (!is_numeric($totalSupply))
+            throw new TRC20Exception("Token totalSupply not found");
+
+        $totalSupply = bcdiv($totalSupply, bcpow("10", $this->decimals()), $this->decimals());
+        return $totalSupply;
+    }
+
+
+    /**
+     * Maximum decimal supported by the Token
+     *
+     * @throws TRC20Exception
+     * @throws \IEXBase\TronAPI\Exception\TronException
+     */
+    public function decimals()
+    {
+        if (!is_null($this->decimals))
+            return $this->decimals;
+
+
+        $result   = $this->trigger('decimals', null, []);
+        $decimals = $result[0]->toString();
+
+        if (!is_numeric($decimals)) {
+            throw new TRC20Exception("Token decimals not found");
+        }
+
+        $this->decimals = $decimals;
+        return $this->decimals;
+    }
+
+    /**
+     *  TRC20 All transactions
+     *
+     * @param string $address
+     * @param int $limit
+     * @return array
+     *
+     * @throws \IEXBase\TronAPI\Exception\TronException
+     */
+    public function getTransactions(string $address, $limit = 100)
+    {
+        return $this->tron->getManager()
+            ->request("v1/accounts/{$address}/transactions/trc20?limit={$limit}&contract_address={$this->contractAddress}", [], 'get');
+    }
+
+    /**
+     *  Find transaction
+     *
+     * @param string $transaction_id
+     * @return array
+     * @throws \IEXBase\TronAPI\Exception\TronException
+     */
+    public function getTransaction(string $transaction_id)
+    {
+        return $this->tron->getManager()
+            ->request('/wallet/gettransactioninfobyid', ['value' => $transaction_id], 'post');
+    }
+
+    /**
+     * Config trigger
+     *
+     * @param $function
+     * @param null $address
+     * @param array $params
+     * @return mixed
+     * @throws \IEXBase\TronAPI\Exception\TronException
+     */
+    private function trigger($function, $address = null, $params = [])
+    {
+        $owner_address = is_null($address) ? '410000000000000000000000000000000000000000' : $this->tron->address2HexString($address);
+
+        return $this->tron->getTransactionBuilder()
+            ->triggerConstantContract($this->abiData, $this->tron->address2HexString($this->contractAddress), $function, $params, $owner_address);
+    }
+}

src/TransactionBuilder.php

@@ -38,7 +38,7 @@ public function __construct(Tron $tron)
      */
     public function sendTrx($to, $amount, string $from = null)
     {
-        if (!is_float($amount) || $amount < 0) {
+        if ($amount < 0) {
             throw new TronException('Invalid amount provided');
         }