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.

Intégration PHP | TronEnergy Docs

Intégration PHP complète utilisant iexbase/tron-api Bibliothèque. Chaque étape est un bloc de code indépendant que vous pouvez copier dans votre projet. Compatible avec tous les frameworks PHP et le PHP natif.

Prérequis : PHP 7.4+, Composer, ext-gmp et ext-bcmath activés, un portefeuille Tron approvisionné.

À propos de la connexion en PHP : L' API TronEnergy nécessite une signature de portefeuille utilisant tronWeb.trx.signMessageV2(). Le iexbase/tron-api La bibliothèque n'expose pas cette primitive de signature exacte ; ce guide utilise donc une petite fonction utilitaire Node.js pour l'étape de signature. Tout le reste (envoi TRX , appel de l' API , envoi USDT ) reste en PHP. Si vous disposez d'une solution de signature entièrement en PHP qui génère une signature signMessageV2 valide, vous pouvez remplacer la fonction utilitaire sans modifier aucune autre étape.

Le flux

Aucune clé API . Aucune inscription. Votre code envoie TRX sur la blockchain à l'adresse de paiement TronEnergy , signe un message prouvant la propriété, puis revendique la délégation. Energy arrive en environ 3 secondes. Ensuite, votre code envoie USDT en utilisant l'énergie déléguée.

Envoyer TRX

Envoyez 4 TRX ou plus à l'adresse de paiement sur la chaîne (min 4, max 1000).

Signe

Signez tx_hash:delegate_to pour prouver que vous êtes l'expéditeur.

Réclamer

Envoyez une requête POST à /delegate avec le hachage et la signature de la transaction. Energy arrive en environ 3 secondes.

La tarification est linéaire : 16 250 Energy par 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.

Pas à pas

1. Installation

composer

composer require iexbase/tron-api

2. Configuration

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

Ne jamais coder en dur les identifiants. Use environment variables or a secrets manager. The example above is for illustration only.

3. Obtenir les informations de paiement (facultatif)

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. Envoyer 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. Signez le message

L' API requiert une signature prouvant que le portefeuille ayant envoyé les TRX demande la délégation. Nous utilisons pour cela un petit script Node.js. Enregistrez-le sous le nom suivant : sign.js à côté de votre fichier 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); });

Installez TronWeb dans le même dossier : npm install tronwebAppelez-la ensuite depuis 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. Réclamez la délégation

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. Envoyer 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";

Gestion des erreurs

Encapsulez l'appel de revendication dans une petite fonction d'assistance de nouvelle tentative. L'erreur la plus courante est payment_verification_failed Si la transaction n'est pas encore indexée sur la chaîne, patientez quelques secondes et réessayez.

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

Exemple complet

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