What PHP version is required?

PHP 7.4 or later. The iexbase/tron-api package requires the GMP and bcmath extensions.

Why do I need a Node.js helper for signing?

The iexbase/tron-api PHP library does not expose tronWeb.trx.signMessageV2(), which is what the TronEnergy API requires. The Node.js helper is a small wrapper that does the signing and outputs the signature for PHP to read.

PHP ინტეგრაცია

PHP-ის სრული ინტეგრაცია, რომელიც იყენებს iexbase/tron-api ბიბლიოთეკა. თითოეული ნაბიჯი არის დამოუკიდებელი კოდის ბლოკი, რომლის კოპირებაც შეგიძლიათ თქვენს პროექტში. მუშაობს ნებისმიერ PHP ჩარჩოსთან ან ჩვეულებრივ PHP-თან.

წინაპირობები: PHP 7.4+, Composer, ext-gmp და ext-bcmath-ის მხარდაჭერით, დაფინანსებული Tron საფულე.

PHP-ში შესვლის შესახებ: TronEnergy API საჭიროა საფულის ხელმოწერა tronWeb.trx.signMessageV2(). ის iexbase/tron-api ბიბლიოთეკა არ ავლენს ხელმოწერის ამ კონკრეტულ პრიმიტივს, ამიტომ ეს სახელმძღვანელო ხელმოწერის ეტაპისთვის იყენებს პატარა Node.js დამხმარეს. ყველაფერი დანარჩენი ( TRX გაგზავნა, API გამოძახება, USDT გაგზავნა) PHP-ში რჩება. თუ თქვენ გაქვთ სუფთა PHP ხელმოწერის გადაწყვეტა, რომელიც წარმოქმნის ვალიდურ signMessageV2 ხელმოწერას, შეგიძლიათ შეცვალოთ დამხმარე სხვა ნაბიჯის შეცვლის გარეშე.

ნაკადი

API გასაღები არ არის. რეგისტრაცია არ არის საჭირო. თქვენი კოდი აგზავნის TRX ჯაჭვის მეშვეობით TronEnergy გადახდის მისამართზე, ხელს აწერს საკუთრების დამადასტურებელ შეტყობინებას და შემდეგ აცხადებს დელეგირებას. Energy დაახლოებით 3 წამში მოვა. შემდეგ თქვენი კოდი აგზავნის USDT დელეგირებული ენერგიის გამოყენებით.

TRX გაგზავნა

გაგზავნეთ 4 ან მეტი TRX ჯაჭვზე მითითებულ გადახდის მისამართზე (მინიმუმ 4, მაქს. 1000).

ნიშანი

ხელი მოაწერეთ tx_hash:delegate_to-ს, რათა დაადასტუროთ, რომ თქვენ ხართ გამგზავნი.

მოთხოვნა

POST /delegate tx ჰეშით და ხელმოწერით. Energy მოდის ~3 წამში.

ფასები წრფივია: 16,250 Energy თითო TRX ზე. Minimum order 4 TRX (65,000 Energy — one standard USDT transfer), maximum 1,000 TRX (16.25M Energy). The amount you send determines exactly how much Energy is delegated back — no tiers, no packages. For a single standard transfer, use $trxAmount = 4. For a new-wallet transfer, use 8. For batch work, use more. The code below uses a $trxAmount variable so you can change it in one place.

ეტაპობრივად

1. ინსტალაცია

composer

composer require iexbase/tron-api

2. დაყენება

setup.php
require_once 'vendor/autoload.php';

use IEXBase\TronAPI\Tron;

$tron = new Tron();
$tron->setPrivateKey('YOUR_PRIVATE_KEY');
$tron->setAddress('YOUR_WALLET_ADDRESS');

$api  = 'https://api.tronnrg.com';
$addr = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx'; // API payment address
$usdt = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'; // USDT contract

არასდროს დააკოპიროთ ავტორიზაციის მონაცემები. Use environment variables or a secrets manager. The example above is for illustration only.

3. მიიღეთ გადახდის ინფორმაცია (არასავალდებულო)

get payment info
// Get pricing and payment address (optional, energy is always available)
$supply = json_decode(
    file_get_contents("${api}/supply"),
    true
);

echo "Pay to: " . $supply['pay_to'] . "\n";
echo "Energy per TRX: " . $supply['energy_per_trx'] . "\n";

4. TRX გაგზავნა

send TRX
// Send TRX to the API payment address — pricing is linear.
// 16,250 energy per TRX. Min 4 TRX, max 1,000 TRX.
//   $trxAmount = 4    → 65,000 energy   (standard USDT transfer)
//   $trxAmount = 8    → 130,000 energy  (new wallet transfer)
//   $trxAmount = 40   → 650,000 energy  (10 standard transfers)
//   $trxAmount = 1000 → 16,250,000 energy (max)

$trxAmount = 4;

$payment = $tron->sendTrx($addr, $trxAmount);

if (!isset($payment['result']) || !$payment['result']) {
    throw new Exception('TRX transfer failed');
}

$txHash = $payment['txid'];
echo "Payment sent: ${txHash}\n";

5. ხელი მოაწერეთ შეტყობინებას

API სჭირდება ხელმოწერა, რომელიც ადასტურებს, რომ იგივე საფულე, რომელმაც TRX გაგზავნა, დელეგირებას ითხოვს. ჩვენ ამას პატარა Node.js დამხმარეთი ვაკეთებთ. შეინახეთ როგორც sign.js თქვენი PHP ფაილის გვერდით:

sign.js (run with node)
// Usage: node sign.js <tx_hash> <delegate_to>
// Outputs the signature to stdout. Reads private key from TRON_PRIVATE_KEY env var.
const { TronWeb } = require('tronweb');

const [, , txHash, delegateTo] = process.argv;
const tronWeb = new TronWeb({
  fullHost: 'https://api.trongrid.io',
  privateKey: process.env.TRON_PRIVATE_KEY,
});

tronWeb.trx.signMessageV2(`${txHash}:${delegateTo}`)
  .then(sig => process.stdout.write(sig))
  .catch(e => { console.error(e.message); process.exit(1); });

დააინსტალირეთ TronWeb იმავე საქაღალდეში: npm install tronwebშემდეგ გამოიძახეთ PHP-დან:

sign from PHP
// Both the sender (in $tron) and the signer must be the SAME wallet.
// Make sure TRON_PRIVATE_KEY in your environment matches the wallet that sent the TRX.
$delegateTo = 'TWalletThatNeedsEnergy';

$signature = trim(shell_exec(
    sprintf('node sign.js %s %s',
        escapeshellarg($txHash),
        escapeshellarg($delegateTo)
    )
));

if (!$signature) {
    throw new Exception('Signing failed. Check that node and tronweb are installed and TRON_PRIVATE_KEY is set.');
}

echo "Signed: " . substr($signature, 0, 20) . "...\n";

6. დელეგაციის მოთხოვნა

claim delegation
// $txHash, $delegateTo, and $signature are all defined in the previous steps.
$ch = curl_init("${api}/delegate");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'tx_hash'     => $txHash,
        'delegate_to' => $delegateTo,
        'signature'   => $signature,
    ]),
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);

if (isset($result['error'])) {
    throw new Exception("Delegation failed: " . $result['message']);
}

echo "Delegated: " . $result['energy'] . " energy\n";
echo "Ref: " . $result['ref'] . "\n";

7. USDT გაგზავნა

send USDT
// Send USDT using the delegated energy
$usdtContract = $tron->contract($usdt);

// Amount in smallest unit (6 decimals for USDT)
// 10 USDT = 10 * 1,000,000 = 10000000
$amount    = 10 * pow(10, 6);
$recipient = 'TRecipientAddress';

$transfer = $usdtContract->transfer($recipient, $amount);

echo "USDT sent: " . $transfer . "\n";

შეცდომების დამუშავება

მოთხოვნის გამოძახება შეახვიეთ პატარა ხელახალი ცდის დამხმარეში. ყველაზე გავრცელებული შეცდომაა payment_verification_failed როდესაც tx ჯერ არ არის ინდექსირებული ჯაჭვზე — დაელოდეთ რამდენიმე წამი და სცადეთ ხელახლა.

error handling
function claimDelegation($api, $txHash, $delegateTo, $signature, $retries = 3) {
    for ($i = 0; $i < $retries; $i++) {
        $ch = curl_init("${api}/delegate");
        curl_setopt_array($ch, [
            CURLOPT_POST           => true,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
            CURLOPT_POSTFIELDS     => json_encode([
                'tx_hash'     => $txHash,
                'delegate_to' => $delegateTo,
                'signature'   => $signature,
            ]),
        ]);

        $result = json_decode(curl_exec($ch), true);
        curl_close($ch);

        if (!isset($result['error'])) {
            return $result; // Success
        }

        switch ($result['error']) {
            case 'payment_verification_failed':
                // Most common: tx not yet indexed. Wait and retry.
                sleep(3);
                continue 2;

            case 'hash_already_used':
                throw new Exception('This tx hash has already been claimed');

            case 'signature_mismatch':
                throw new Exception('Signer does not match payment sender. Sign with the same wallet that sent TRX.');

            case 'delegation_failed':
                // Refund queued automatically if payment was verified
                throw new Exception('Delegation failed: ' . $result['message']);

            default:
                throw new Exception($result['message'] ?? 'Unknown error');
        }
    }

    throw new Exception('Transaction not found after retries');
}

სრული მაგალითი

delegate-energy.php
<?php
require_once 'vendor/autoload.php';

use IEXBase\TronAPI\Tron;

$tron = new Tron();
$tron->setPrivateKey(getenv('TRON_PRIVATE_KEY'));
$tron->setAddress(getenv('TRON_WALLET_ADDRESS'));

$api  = 'https://api.tronnrg.com';
$addr = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx';

try {
    $delegateTo = 'TRecipientWallet';
    $trxAmount = 4; // min 4, max 1000 — energy = trxAmount × 16,250

    // 1. Send TRX (linear pricing: 16,250 energy per TRX)
    $payment = $tron->sendTrx($addr, $trxAmount);
    $txHash  = $payment['txid'];
    echo "Payment: ${txHash}\n";

    // 2. Sign via Node helper (see Step 5 above)
    $signature = trim(shell_exec(
        sprintf('node sign.js %s %s',
            escapeshellarg($txHash),
            escapeshellarg($delegateTo)
        )
    ));
    if (!$signature) throw new Exception('Signing failed');

    // 3. Claim delegation (with retry)
    $result = claimDelegation($api, $txHash, $delegateTo, $signature);
    echo "Energy: " . $result['energy'] . "\n";
    echo "Ref: "    . $result['ref'] . "\n";

    // 4. Send USDT (energy is now available)
    $contract = $tron->contract('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t');
    $transfer = $contract->transfer($delegateTo, 10 * pow(10, 6));
    echo "USDT sent: ${transfer}\n";

} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}