What TronWeb version is required?

TronWeb 6.x or later. Install via npm install tronweb. Note that the import is destructured: const { TronWeb } = require("tronweb").

Why does the signature have to come from the same wallet that sent TRX?

It is the API's only proof that you authorized the delegation. Without it, anyone watching the chain could claim energy for any payment.

Інтеграція TronWeb

Повна інтеграція Node.js за допомогою TronWeb . Кожен крок – це окремий блок коду, який можна скопіювати у свій проєкт. Повний приклад наведено внизу.

Передумови: Node.js 18+, tronweb встановлено (npm install tronweb), фінансований гаманець Tron .

Потік

Без ключа API . Без реєстрації. Ваш код надсилає TRX у мережі на платіжну адресу TronEnergy , підписує повідомлення, що підтверджує право власності, а потім вимагає делегування. Energy надходить приблизно через 3 секунди. Потім ваш код надсилає USDT , використовуючи делеговану енергію.

Ціноутворення лінійне: 16 250 Energy за TRX . Мінімальне замовлення 4 TRX (65 000 Energy — один стандартний переказ USDT ), максимальне 1000 TRX (16,25 млн Energy ). Сума, яку ви надсилаєте, визначає, скільки Energy точно повернеться — немає рівнів чи пакетів. Для одного стандартного переказу надішліть 4. Для переказу на новий гаманець надішліть 8. Для пакетної роботи надішліть більше. Код нижче використовує trxAmount змінна, щоб ви могли змінити її в одному місці.

Крок за кроком

1. Налаштування

налаштування

    const { TronWeb } = require('tronweb'); // destructured: the default import is broken in v6
    
    const tronWeb = new TronWeb({
      fullHost: 'https://api.trongrid.io',
      privateKey: process.env.TRON_PRIVATE_KEY,
    });
    
    const API  = 'https://api.tronnrg.com';
    const ADDR = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx'; // API payment address
    const USDT = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
  

2. Надішліть TRX

надіслати платіж

    const TRX_AMOUNT = 4; // Linear: 16,250 energy per TRX. Min 4, max 1000.
    // 4 → 65k (standard) · 8 → 130k (new wallet) · 40 → 650k (10 transfers)
    
    const payment = await tronWeb.trx.sendTransaction(ADDR, TRX_AMOUNT * 1e6);
    
    console.log('Payment tx:', payment.txid);

3. Заявіть на делегування

делегування претензій

    // Sign: proves you are the sender
    const msg = `${payment.txid}:${tronWeb.defaultAddress.base58}`;
    const sig = await tronWeb.trx.signMessageV2(msg);

    const delegation = await fetch(`${API}/delegate`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        tx_hash: payment.txid,
        delegate_to: tronWeb.defaultAddress.base58,
        signature: sig,
      }),
    }).then(r => r.json());
    
    if (delegation.error) {
      throw new Error(delegation.message);
    }
    
    console.log('Energy delegated:', delegation.energy); // TRX_AMOUNT × 16,250
  

4. Надішліть USDT

відправити долар США

    const contract = await tronWeb.contract().at(USDT);
    const tx = await contract.transfer(
      recipientAddress, Math.round(usdtAmount * 1e6)
    ).send({ feeLimit: 50_000_000 });
    
    console.log('USDT sent:', tx);
  

Обробка помилок

помилки обробки

    const result = await fetch(`${API}/delegate`, { ... })
      .then(r => r.json());
    
    if (result.error) {
      switch (result.error) {
        case 'payment_verification_failed':
          // Payment not yet indexed on-chain. Wait 3s and retry.
          break;
        case 'hash_already_used':
          // Already claimed. Don't retry.
          break;
        case 'signature_mismatch':
          // Sender of TRX != signer of the message. Sign with the same key.
          break;
        case 'delegation_failed':
          // Provider could not deliver. Retry or contact support with result.ref.
          break;
      }
    }
  

Повний приклад

Скопіюйте це у файл, встановіть змінні середовища та запустіть. Скрипт надсилає TRX , підписує повідомлення, вимагає делегування з повторною спробою, а потім надсилає USDT .

delegate-energy.js

const { TronWeb } = require('tronweb'); // destructured: default import is broken in v6

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

const API  = 'https://api.tronnrg.com';
const ADDR = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx';
const USDT = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';

async function claimWithRetry(txHash, delegateTo, signature, retries = 3) {
  for (let i = 0; i < retries; i++) {
    const res = await fetch(`${API}/delegate`, {
      method:  'POST',
      headers: { 'Content-Type': 'application/json' },
      body:    JSON.stringify({ tx_hash: txHash, delegate_to: delegateTo, signature }),
    }).then(r => r.json());

    if (!res.error) return res;
    if (res.error !== 'payment_verification_failed') throw new Error(res.message);
    await new Promise(r => setTimeout(r, 3000));
  }
  throw new Error('Transaction not found after retries');
}

async function main() {
  const recipient  = 'TRecipientWallet';
  const trxAmount = 4; // min 4, max 1000 — you get trxAmount × 16,250 energy

  // 1. Send TRX (linear pricing: 16,250 energy per TRX)
  const payment = await tronWeb.trx.sendTransaction(ADDR, trxAmount * 1e6);
  console.log('Payment:', payment.txid);

  // 2. Claim delegation
  // Sign: proves you are the sender
  const message = `${payment.txid}:${recipient}`;
  const signature = await tronWeb.trx.signMessageV2(message);

  const result = await claimWithRetry(payment.txid, recipient, signature);
  console.log('Delegated:', result.energy, 'energy');
  console.log('Delegation tx:', result.delegations[0].tx);  // verify on TronScan
  console.log('Ref:', result.ref);

  // 3. Send USDT
  const contract = await tronWeb.contract().at(USDT);
  const tx = await contract.transfer(recipient, 10 * 1e6).send();
  console.log('USDT sent:', tx);
}

main().catch(console.error);

Завжди додавайте підпис. Це доводить, що саме ви є гаманцем, який надіслав TRX . Без цього API відхиляє запит із missing_signature.