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.

Pagsasama ng PHP | TronEnergy Docs

Ganap na integrasyon ng PHP gamit ang iexbase/tron-api library. Ang bawat hakbang ay isang standalone na code block na maaari mong kopyahin sa iyong proyekto. Gumagana sa anumang PHP framework o plain PHP.

Mga Kinakailangan: PHP 7.4+, pinagana ang Composer, ext-gmp at ext-bcmath, isang pinondohan na Tron wallet.

Tungkol sa pag-sign in sa PHP: Ang TronEnergy API ay nangangailangan ng isang wallet signature gamit ang tronWeb.trx.signMessageV2()Ang iexbase/tron-api Hindi inilalantad ng library ang eksaktong signing primitive na ito, kaya gumagamit ang gabay na ito ng isang maliit na Node.js helper para sa hakbang ng pag-sign. Ang lahat ng iba pa (pagpapadala ng TRX , pagtawag sa API , pagpapadala USDT ) ay nananatili sa PHP. Kung mayroon kang pure-PHP signing solution na gumagawa ng isang wastong signMessageV2 signature, maaari mong palitan ang helper nang hindi binabago ang anumang iba pang hakbang.

Ang Daloy

Walang API key. Walang pag-sign-up. Ipapadala ng iyong code TRX on-chain sa TronEnergy payment address, pipirma ng mensaheng nagpapatunay ng pagmamay-ari, pagkatapos ay kinukumpisal ang delegasyon. Darating Energy sa loob ng humigit-kumulang 3 segundo. Pagkatapos, ipapadala ng iyong code USDT gamit ang itinalagang enerhiya.

Ipadala TRX

Magpadala ng 4 o higit pang TRX sa payment address na on-chain (minimum na 4, max na 1000).

Karatula

Lagdaan ang tx_hash:delegate_to upang patunayan na ikaw ang nagpadala.

Pag-angkin

POST /delegate na may tx hash at lagda. Energy ay dumarating sa loob ng ~3 segundo.

Linear ang presyo: 16,250 Energy bawat TRX . Minimum na order: 4 TRX (65,000 Energy — isang karaniwang USDT transfer), maximum na 1,000 TRX (16.25M Energy ). Ang halagang ipapadala mo ang eksaktong magtatakda kung gaano karaming Energy ang ibabalik — walang mga tier, walang mga pakete. Para sa isang karaniwang transfer, gamitin ang $trxAmount = 4Para sa paglilipat ng bagong wallet, gamitin ang 8Para sa batch work, gumamit ng more. Ang code sa ibaba ay gumagamit ng $trxAmount variable para mabago mo ito sa iisang lugar.

Hakbang-hakbang

1. I-install

kompositor

composer require iexbase/tron-api

2. Pag-setup

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

Huwag kailanman i-hardcode ang mga kredensyal. I-load ang iyong private key mula sa mga environment variable o isang secrets manager. Huwag kailanman mag-commit ng mga secrets sa git.

3. Kunin ang Impormasyon sa Pagbabayad (Opsyonal)

kumuha ng impormasyon sa pagbabayad
// 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. Ipadala TRX

magpadala 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. Pirmahan ang Mensahe

Ang API ay nangangailangan ng lagda na nagpapatunay na ang parehong wallet na nagpadala ng TRX ay humihingi ng delegasyon. Ginagawa natin ito gamit ang isang maliit na Node.js helper. I-save ito bilang sign.js sa tabi ng iyong PHP file:

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); });

I-install TronWeb sa parehong folder: npm install tronwebPagkatapos ay tawagin ito mula sa PHP:

lagda mula sa 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. Angkinin ang Delegasyon

paglalaan ng paghahabol
// $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. Ipadala USDT

magpadala ng usdt
// Energy is now delegated. Send USDT.
$contract = $tron->contract($usdt);
$transfer = $contract->transfer($delegateTo, 10 * pow(10, 6));

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

Paghawak ng Error

I-wrap ang claim call sa isang maliit na retry helper. Ang pinakakaraniwang error ay payment_verification_failed kapag ang tx ay hindi pa naka-index sa chain — maghintay ng ilang segundo at subukan muli nang isang beses.

paghawak ng error
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');
}

Kumpletong Halimbawa

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";
}