რომელი PHP ვერსია საჭიროა?

PHP 7.4 ან უფრო ახალი. iexbase/tron-api პაკეტი მოითხოვს GMP და bcmath გაფართოებებს.

რატომ მჭირდება Node.js დამხმარე ხელმოწერისთვის?

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

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-ს აგზავნის on-chain TronEnergy გადახდის მისამართზე, ხელმოწერს შეტყობინებას მფლობელობის დასამტკიცებლად, შემდეგ მოითხოვს ქირაობას. ენერგია ჩამოდის დაახლოებით 3 წამში. შემდეგ თქვენი კოდი USDT აგზავნის ქირაობის ენერგიის გამოყენებით.

TRX-ის გაგზავნა

გაუგზავნეთ 4 ან მეტი TRX გადახდის მისამართზე on-chain (მინ. 4, მაქს. 1000).

ხელმოწერა

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

მოთხოვნა

POST /delegate tx hash-ის და ხელმოწერის ჩასმით. ენერგია ჩამოდის ~3 წამში.

ფასი ხაზოვანია: 16,250 Energy თითო TRX-ზე. მინიმალური შეკვეთა 4 TRX (65,000 Energy — ერთი სტანდარტული USDT გადარიცხვა), მაქსიმალური 1,000 TRX (16.25M Energy). თქვენ მიერ გაგზავნილი თანხა განსაზღვრავს ზუსტად, რამდენი Energy დელეგირებული იქნება უკან — არ არის დონეები, არ არის პაკეტები. ერთი სტანდარტული გადარიცხვის დროს, გამოიყენეთ $trxAmount = 4. ახალი საფულის გადარიცხვის დროს, გამოიყენეთ 8. ბურლივი სამუშაოებისთვის, გამოიყენეთ მეტი. ქვემოთ მოცემული კოდი იყენებს $trxAmount ცვლადს, ასე რომ შეგიძლიათ შეცვალოთ იგი ერთ ადგილზე.

ეტაპი ეტაპის მიხედვით

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

არასოდეს აკოდირეთ უსაფრთხოების ინფორმაცია. ჩატვირთეთ თქვენი პირადი გასაღები გარემო ცვლადებიდან ან საიდუმლოებების მენეჯერიდან. ნდობის გასაიდუმლოება არასოდეს დააკომიტეთ git-ში.

4. გაილი TRX

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
// 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-დან:

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. მოთხოვნა დელეგირებული Energy

დელეგაციის მოთხოვნა
// $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,
    ]),
]);

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

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

7. გაილი USDT

USDT გაგზავნა
// Energy is now delegated. Send USDT.
$contract = $tron->contract($usdt);
$transfer = $contract->transfer($delegateTo, 10 * pow(10, 6));

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

ოპიკების დამუშავება

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

შეცდომების დამუშავება
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";
}