Самый быстрый способ купить энергию TRON на Java — официальный TronSave SDK: добавьте io.tronsave:sdk из Maven Central, создайте клиент с API-ключом, оцените стоимость и разместите заказ — четыре типизированных вызова, без «сырого» HTTP. В этом руководстве разобрана вся интеграция: от установки до отслеживания исполненного заказа.
Зачем арендовать энергию из Java-кода?
Бэкенд-сервисы, которые отправляют USDT (TRC-20) в любых объёмах, живут по той же арифметике, что и все в сети TRON: каждый перевод расходует энергию, а за недостающую энергию приходится платить сжиганием TRX по ставкам протокола (см. модель ресурсов TRON). Аренда энергии непосредственно перед пакетом выплат обычно стоит лишь малую долю от сжигания, а если делать это из кода, сервис пополняет ресурсы сам — без человека, следящего за панелью. Если сначала хотите разобраться на уровне API, начните с нашего руководства по автоматизации через API; в этой статье тот же процесс, но с Java-типами вместо «сырых» эндпоинтов.
Что такое TronSave Java SDK?
Это официальный Java-клиент, опубликованный в Maven Central как io.tronsave:sdk (версия 2.0.0, работает с актуальным API v2 и требует Java 17+). Рядом с ним есть официальные SDK для TypeScript, Rust, Python и PHP — все они оборачивают одни и те же эндпоинты, согласно официальной документации SDK.
Java-клиент компактный, но готов к продакшену: результаты возвращаются в виде типизированных record-классов (EstimateBuyResource, Order, UserInfo), ошибки оформлены полноценной иерархией исключений (авторизация, валидация, rate limit, сеть, бизнес-логика), а у клиента есть встроенный ограничитель частоты запросов, плюс в билдере настраиваются таймаут и повторы.

Как установить SDK?
Maven (pom.xml):
<dependency>
<groupId>io.tronsave</groupId>
<artifactId>sdk</artifactId>
<version>2.0.0</version>
</dependency>
Gradle (build.gradle):
implementation 'io.tronsave:sdk:2.0.0'
Как получить API-ключ?
Создайте его в личном кабинете TronSave (см. документацию по аутентификации). При работе через API-ключ заказы оплачиваются с вашего предоплаченного баланса TronSave — идеально для бэкенд-сервисов, ведь приватный ключ TRON вообще не участвует в интеграции. Разрабатывайте на Network.TESTNET (тестовая сеть Nile, без реальных TRX), а для запуска в бою просто переключите enum на Network.MAINNET.
Как купить энергию TRON на Java: полный пример
import io.tronsave.sdk.Network;
import io.tronsave.sdk.TronsaveClient;
import io.tronsave.sdk.model.BuyResourceResult;
import io.tronsave.sdk.model.EstimateBuyResource;
import io.tronsave.sdk.model.Order;
import java.util.Map;
public class BuyEnergy {
public static void main(String[] args) {
TronsaveClient client = TronsaveClient.builder()
.apiKey(System.getenv("TRONSAVE_API_KEY"))
.network(Network.TESTNET) // Network.MAINNET in production
.build();
Map<String, Object> request = Map.of(
"receiver", "TAk6jzZqHwNUkUcbvMyAE1YAoUPk7r2T6h",
"resourceType", "ENERGY",
"resourceAmount", 65_000,
"durationSec", 3_600);
// 1. Estimate before you commit
EstimateBuyResource estimate = client.estimateBuyResource(request);
System.out.println("Estimated cost (TRX): " + estimate.estimateTrx());
// 2. Place the order, paid from your TronSave balance
BuyResourceResult result = client.buyResource(request);
// 3. Track it until the delegation lands
Order order = client.getOrder(result.orderId());
System.out.println(order.status() + " — " + order.fulfilledPercent() + "% filled");
}
}
Обратите внимание на три момента. Вызов оценки возвращает не только итог в TRX, но и цену за единицу и доступную ликвидность, так что покупку можно ставить в зависимость от цены. Покупка сразу возвращает orderId — исполнение асинхронное, поэтому опрашивайте getOrder, пока status и fulfilledPercent не покажут ожидаемое делегирование. И 65 000 энергии на один час в примере рассчитаны на один перевод USDT; масштабируйте resourceAmount и durationSec под свой пакет.
Что ещё умеет клиент?
| Метод | Что делает |
|---|---|
getUserInfo() |
Данные аккаунта и предоплаченный баланс |
estimateBuyResource(...) |
Оценка стоимости покупки до заказа |
buyResource(...) |
Покупка энергии или пропускной способности (bandwidth) |
getOrder(id) / getOrders(page, size) |
Детали заказа и история |
getOrderBook(...) |
Текущая глубина рынка |
getExtendableDelegates(...) / extendRequest(...) |
Список и продление активных делегирований |
Билдер также принимает timeoutMs(...), maxRetries(...) и baseUrl(...) для тонкой настройки.
Как обрабатывать ошибки в продакшене?
Все исключения клиента наследуются от TronsaveException, но подтипы требуют разной обработки. TronsaveValidationException означает, что неверен сам запрос — некорректный адрес получателя, неправильная сумма, — поэтому повторять его бессмысленно: залогируйте и исправьте входные данные. TronsaveRateLimitException означает, что вы обращаетесь чаще, чем позволяет ваш ключ: сделайте паузу и повторите (у клиента также есть внутренний ограничитель частоты, который сглаживает всплески ещё до отправки запросов). TronsaveNetworkException покрывает временные сбои транспорта — как раз то, для чего в билдере есть maxRetries. Ошибки авторизации обычно означают отсутствующий или отозванный ключ — проверьте, что переменная окружения действительно дошла до процесса.
В сервисах выплат особенно окупаются две привычки: вызывайте getUserInfo() при старте и поднимайте тревогу, когда предоплаченный баланс опускается ниже оценочной стоимости следующего запуска, и используйте estimateBuyResource как предохранитель — если котировка estimateTrx() превышает разумный порог, отложите запуск, а не покупайте на ценовом всплеске.
FAQ
Какая версия Java нужна?
Java 17 или новее — модели SDK реализованы как record-классы (возможность Java 16+), а опубликованный байт-код собран под 17.
Можно ли тестировать, не тратя реальные TRX?
Да. Network.TESTNET направляет клиент в тестовую сеть Nile, где весь процесс работает точно так же, но с тестовыми средствами.
Покидает ли мой приватный ключ TRON сервер?
В показанном здесь варианте с API-ключом он вообще не используется — заказы оплачиваются с предоплаченного баланса TronSave. Если вы предпочитаете платить напрямую с аккаунта TRON, есть отдельный вариант с приватным ключом; см. официальные примеры кода.
Можно ли купить и пропускную способность?
Да — тем же вызовом buyResource с "resourceType": "BANDWIDTH".
А как насчёт других языков?
Официальные SDK есть для TypeScript, Rust, Python и PHP. У нас есть пошаговые руководства для TypeScript, Python, PHP и Rust.
Обязательно ли использовать SDK, чтобы купить энергию TRON на Java?
Нет — SDK оборачивает документированный HTTP API v2, поэтому эндпоинты можно вызывать напрямую любым HTTP-клиентом. SDK лишь избавляет вас от обвязки запросов, повторов, ограничения частоты и типизации ответов — именно того кода, который меньше всего хочется поддерживать самому в платёжном контуре.
Строите сервис выплат? Добавьте io.tronsave:sdk, получите API-ключ в личном кабинете TronSave — и ваш бэкенд будет сам арендовать себе энергию: оценка, покупка, отслеживание, готово.
TronSave SDK и API управляются TronSave — издателем этого блога. Протестируйте интеграцию в Nile, прежде чем направлять её на средства в mainnet.


