Примеры кода для работы с TRON Energy

Что важно понять по теме «Примеры кода для работы с TRON Energy»

Любой код, который работает с TRON Energy, сводится к трём базовым операциям: узнать, сколько Energy сейчас на кошельке, посчитать, сколько нужно для конкретной транзакции, и отправить запрос на аренду. Вся остальная логика — это обвязка вокруг этих трёх действий.

Представьте, что вы управляете складом электроэнергии. Вам нужно уметь смотреть показания счётчика, рассчитывать расход на конкретный прибор и оформлять договор на подпитку. Код делает ровно то же самое, только через API сети TRON.

Для работы с примерами ниже используется tronweb — основная библиотека для взаимодействия с сетью TRON из JavaScript и Node.js. Аналогичные операции можно выполнить через HTTP-запросы к нодам напрямую, но tronweb берёт на себя подпись транзакций и кодирование данных, поэтому на практике почти никто не пишет raw-запросы руками.

Вот базовая настройка, которая нужна для всех примеров:

const TronWeb = require('tronweb');
const tronWeb = new TronWeb({
  fullHost: 'https://api.trongrid.io',
  privateKey: 'ваш_приватный_ключ'
});

Private key здесь — это ключ кошелька, с которого будут списываться TRX на оплату аренды или комиссию. В продакшене ключ никогда не хранят в коде, а берут из переменных окружения или хранилища секретов.

Практические особенности и варианты применения

Проверка текущего баланса Energy

Прежде чем что-то делать, нужно понять, есть ли на кошельке бесплатная Energy. Она появляется каждый день в зависимости от стейкинга TRX и тратится в первую очередь.

async function getEnergyBalance(address) {
  const resource = await tronWeb.trx.getAccountResource(address);
  return resource.EnergyLimit - resource.EnergyUsed;
}

getEnergyBalance('TYourAddress').then(balance => {
  console.log('Доступно Energy:', balance);
});

Формула простая: EnergyLimit — это дневной лимит, а EnergyUsed — уже потраченная часть. Разница — это то, что можно использовать прямо сейчас. Если результат отрицательный или нулевой, бесплатной Energy нет.

Расчёт стоимости перевода USDT

Количество Energy для перевода USDT не фиксировано. Оно зависит от текущей загруженности сети и параметров смарт-контракта USDT. Единственный надёжный способ узнать точную цифру — эмулировать транзакцию без реальной отправки.

async function estimateUSDTTransferEnergy(fromAddress, toAddress, amount) {
  const usdtContract = await tronWeb.contract().at('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t');
  try {
    await usdtContract.transfer(toAddress, amount).send({
      from: fromAddress,
      callValue: 0,
      tokenValue: amount,
      feeLimit: 1000000000
    });
  } catch (err) {
    if (err.includes('Energy')) {
      const match = err.match(/Energy\s*(\d+)/);
      if (match) return parseInt(match[1]);
    }
  }
  return null;
}

Здесь мы намеренно вызываем send без реального выполнения. Транзакция падает на этапе оценки ресурсов, и в ошибке содержится точное число необходимой Energy. Это хак, но он стабильно работает и повсеместно используется.

Аренда Energy через смарт-контракт

Когда бесплатной Energy не хватает, её арендуют. Прямой вызов контракта аренды выглядит так:

async function rentEnergy(receiverAddress, energyAmount, trxAmount) {
  const resourceContract = await tronWeb.contract().at('TJYeasTPa6gpVh7ZsAPDfnBrGQ9KZEmkJn');
  const tx = await resourceContract.buyEnergy(receiverAddress, energyAmount).send({
    callValue: trxAmount,
    feeLimit: 100000000
  });
  return tx;
}

callValue — это количество TRX (в sun, где 1 TRX = 1 000 000 sun), которое вы готовы заплатить. Адрес контракта TJYeasTPa6gpVh7ZsAPDfnBrGQ9KZEmkJn — это официальный ресурсный контракт TRON. На практике чаще арендуют через сторонние сервисы, потому что они дают лучшую цену за единицу Energy, но если нужен прямой путь без посредников — это он.

Полный цикл: проверка, расчёт, аренда, отправка

Реальный сценарий выглядит как цепочка: проверили баланс, поняли, что не хватает, посчитали сколько нужно, арендовали, подождали подтверждения, отправили USDT.

async function sendUSDTWithEnergyCheck(from, to, amount) {
  const available = await getEnergyBalance(from);
  const needed = await estimateUSDTTransferEnergy(from, to, amount);

  if (available >= needed) {
    console.log('Достаточно бесплатной Energy');
  } else {
    const deficit = needed - available;
    const pricePerEnergy = 100; // пример: 100 sun за единицу
    const cost = deficit * pricePerEnergy;
    console.log('Арендуем', deficit, 'Energy за', cost / 1000000, 'TRX');
    await rentEnergy(from, deficit, cost);
    await new Promise(r => setTimeout(r, 3000)); // ждём подтверждение
  }

  const usdtContract = await tronWeb.contract().at('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t');
  const result = await usdtContract.transfer(to, amount).send({
    feeLimit: 1000000000
  });
  return result;
}

Обратите внимание на setTimeout после аренды. Транзакция аренды должна попасть в блок, прежде чем вы сможете использовать полученную Energy. Без этой паузы отправка USDT почти гарантированно упадёт с ошибкой нехватки ресурсов.

Ошибки, ограничения и что учитывать на практике

feeLimit и почему транзакции падают

Параметр feeLimit — это максимальная сумма в sun, которую вы готовы потратить на комиссию. Если реальная стоимость превысит этот лимит, транзакция отклонится до выполнения. Для перевода USDT обычно ставят 1 000 TRX (1 000 000 000 sun) — это с запасом. Но если поставить слишком мало, вы получите ошибку "Fee limit is not enough", даже если на кошельке достаточно TRX.

Срок жизни арендованной Energy

Арендованная Energy живёт 24 часа. Если вы арендовали 65 000 единиц, а через сутки не использовали — они сгорят. Код должен учитывать это: не стоит арендовать «на всякий случай» заранее. Оптимально — арендовать непосредственно перед транзакцией и ровно нужный объём.

Порядок списания ресурсов

Сеть всегда сначала тратит бесплатную Energy, потом арендованную, и только в последнюю очередь сжигает TRX. Это значит, что в коде не нужно разделять логику «платим бесплатной» и «платим арендованной». Вы просто проверяете, хватает ли суммарного баланса, и если нет — арендуете недостающее. Сеть сама разберётся, откуда брать.

Числа в контрактах — только целые

USDT в сети TRON имеет 6 десятичных знаков. Чтобы отправить 100 USDT, в код нужно передать 100000000 (100 × 10⁶). Если передать 100 как есть, контракт отправит 0.0001 USDT. Это классическая ошибка, на которой сжигают реальные деньги на комиссиях.

Асинхронность и гонка состояний

Если ваш код обрабатывает несколько переводов параллельно с одного кошелька, возникает проблема: первый запрос проверил баланс, увидел 30 000 Energy, второй запрос тоже увидел 30 000, и оба решили, что ресурсов хватает. На деле хватит только на одну транзакцию. Решение — сериализовать операции с одним кошельком или использовать мьютекс на уровне приложения.

Обработка ошибок контракта

Ошибки из смарт-контрактов TRON приходят в виде строк, а не структурированных объектов. Приходится парсить текст ошибки регулярными выражениями, как в примере с оценкой Energy. Это неэлегантно, но альтернативы нет — так устроено API. В продакшене стоит обернуть этот парсинг в отдельную утилиту и покрыть тестами, потому что формат ошибок иногда меняется при обновлениях сети.