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.

Integrasi PHP | TronEnergy Docs

Integrasi PHP penuh menggunakan iexbase/tron-api Pustaka. Setiap langkah adalah blok kode mandiri yang dapat Anda salin ke dalam proyek Anda. Bekerja dengan kerangka kerja PHP apa pun atau PHP biasa.

Prasyarat: PHP 7.4+, Composer, ext-gmp dan ext-bcmath diaktifkan, dompet Tron yang didanai.

Tentang masuk ke PHP: API TronEnergy memerlukan tanda tangan dompet menggunakan tronWeb.trx.signMessageV2(). Itu iexbase/tron-api Library ini tidak mengekspos primitif penandatanganan persis seperti ini, jadi panduan ini menggunakan helper Node.js kecil untuk langkah penandatanganan. Semua hal lainnya (mengirim TRX , memanggil API , mengirim USDT ) tetap berada di PHP. Jika Anda memiliki solusi penandatanganan murni PHP yang menghasilkan tanda tangan signMessageV2 yang valid, Anda dapat mengganti helper tersebut tanpa mengubah langkah lainnya.

Alur

Tidak perlu kunci API . Tidak perlu mendaftar. Kode Anda mengirimkan TRX on-chain ke alamat pembayaran TronEnergy , menandatangani pesan yang membuktikan kepemilikan, lalu mengklaim delegasi. Energy tiba dalam waktu sekitar 3 detik. Kemudian kode Anda mengirimkan USDT menggunakan energi yang didelegasikan.

Kirim TRX

Kirim 4 TRX atau lebih ke alamat pembayaran di blockchain (minimal 4, maksimal 1000).

Tanda

Tanda tangani tx_hash:delegate_to untuk membuktikan bahwa Anda adalah pengirimnya.

Mengeklaim

POST /delegate dengan hash transaksi dan tanda tangan. Energy tiba dalam waktu sekitar 3 detik.

Penetapan harga bersifat linier: 16.250 Energy per TRX . Pesanan minimum 4 TRX (65.000 Energy — satu transfer USDT standar), maksimum 1.000 TRX (16,25 juta Energy ). Jumlah yang Anda kirim menentukan berapa banyak Energy yang didelegasikan kembali — tanpa tingkatan, tanpa paket. Untuk satu transfer standar, gunakan $trxAmount = 4Untuk transfer ke dompet baru, gunakan 8Untuk pekerjaan batch, gunakan lebih banyak. Kode di bawah ini menggunakan $trxAmount variabel sehingga Anda dapat mengubahnya di satu tempat.

Langkah demi Langkah

1. Instal

komposer

composer require iexbase/tron-api

2. Pengaturan

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

Jangan pernah memasukkan kredensial secara langsung ke dalam kode. Muat kunci pribadi Anda dari variabel lingkungan atau pengelola rahasia. Jangan pernah melakukan commit rahasia ke git.

3. Dapatkan Informasi Pembayaran (Opsional)

Dapatkan informasi pembayaran
// 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. Kirim TRX

kirim 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. Tandatangani Pesan

API tersebut memerlukan tanda tangan yang membuktikan bahwa dompet yang sama yang mengirim TRX meminta delegasi. Kami melakukan ini dengan bantuan Node.js kecil. Simpan sebagai sign.js di samping file PHP Anda:

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

Instal TronWeb di folder yang sama: npm install tronwebKemudian panggil dari PHP:

tanda dari 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. Klaim Delegasi

delegasi klaim
// $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. Kirim USDT

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

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

Penanganan Kesalahan

Bungkus panggilan klaim dalam fungsi pembantu percobaan ulang kecil. Kesalahan yang paling umum adalah payment_verification_failed Jika transaksi belum terindeks di blockchain, tunggu beberapa detik dan coba lagi.

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

Contoh Lengkap

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