Быстрее всего купить энергию TRON на PHP через официальный TronSave SDK: composer require tronsave/sdk, создайте клиент с API-ключом, оцените стоимость, разместите заказ и опрашивайте его до 100%. Четыре типизированных вызова, никакого «сырого» HTTP и самописных циклов повторов. В этом руководстве — вся интеграция: установка, значения по умолчанию, обработка ошибок и то, как заказ на самом деле оплачивается.
Зачем это PHP-бэкенду
На PHP работает огромная часть коммерческого веба — магазины на WooCommerce, платёжные сервисы на Laravel, самописные биллинговые панели. Как только такой сервис начинает выплачивать или принимать USDT (TRC-20) в сети TRON, он упирается в ту же арифметику, что и все: каждый перевод расходует энергию, а недостающая энергия оплачивается сжиганием TRX по тарифам протокола. Так одна выплата в стейблкоине сжигает около 6,43 TRX, а получателю, у которого никогда не было USDT, — около 13,03 TRX (данные на ноябрь 2026 г.).
Аренда энергии прямо перед пакетом выплат обычно стоит лишь долю от сжигания. Если делать это из кода, сервис пополняет себя сам — никто не следит за дашбордом в 3 часа ночи, ни один пакет не встаёт из-за пустого кошелька. Если сначала хотите посмотреть на уровне эндпоинтов, прочитайте наше руководство по автоматизации через API; эта статья описывает тот же процесс, но с типами PHP вместо «сырых» запросов.

Что такое TronSave PHP SDK?
Это официальный PHP-клиент для TronSave API v2, опубликованный в Packagist как tronsave/sdk (версия 2.0.0, лицензия MIT, PHP 8.1+). Рядом с ним есть официальные SDK для TypeScript, Python, Java и Rust — все они оборачивают одни и те же эндпоинты с одинаковым поведением, и это проверяется общим кросс-языковым набором тестов на соответствие, а не вручную.
PHP-клиент небольшой, но рассчитан на продакшен:
- Типизированные результаты. Ответы приходят в виде readonly-классов —
UserInfo,EstimateBuyResource,Order,OrderBookLevel, — а не ассоциативных массивов, по которым приходится гадать. - Настоящие enum.
ResourceType,PriceTier,OrderType,OrderStatusиNetwork— backed enum из PHP 8.1, поэтому опечатка становится фатальной ошибкой в месте вызова, а не ответом 400 от сервера. - Транспорт PSR-18. По умолчанию Guzzle, но можно подставить любой PSR-18-клиент — удобно, если у вашего фреймворка уже есть настроенный HTTP-стек с мониторингом.
- Встроенные повторы и rate limiting. Оба механизма включены по умолчанию и описаны ниже.
Установка и настройка
composer require tronsave/sdk
Затем создайте клиент. Все аргументы конструктора необязательные и именованные, так что задаёте только нужное:
use Tronsave\TronsaveClient;
use Tronsave\Network;
$sdk = new TronsaveClient(
apiKey: getenv('TRONSAVE_API_KEY'),
network: Network::Testnet, // Network::Mainnet to go live
timeoutMs: 30000, // default
maxRetries: 3, // default
);
Network несёт свой базовый URL, поэтому хостнейм в коде не прописывается: Network::Testnet указывает на тестовый API Nile, а Network::Mainnet — на продакшен. Разрабатывайте в тестнете, где ничего не стоит реальных TRX, а затем переключите enum.
Тот же enum предоставляет и fundAddress() — адрес для пополнения вашего предоплаченного баланса. Брать его из enum, а не вставлять строку в конфиг, — более безопасная привычка: адрес для депозита, скопированный из сообщения в чате или из результатов поиска, — классический способ потерять пополнение.
Покупка энергии от начала до конца
Четыре вызова. Первый необязателен, но его стоит добавить в health check.
use Tronsave\TronsaveClient;
use Tronsave\Network;
$sdk = new TronsaveClient(apiKey: getenv('TRONSAVE_API_KEY'), network: Network::Mainnet);
// 1. Who am I, and can I afford this run?
$me = $sdk->getUserInfo();
// $me->id, $me->balance, $me->representAddress, $me->depositAddress
// 2. What will it cost? (no API key required for this call)
$est = $sdk->estimateBuyResource([
'receiver' => 'TFwUFWr3QV376677Z8VWXxGUAMFSrq1MbM',
'resourceType' => 'ENERGY',
'resourceAmount' => 65000,
'durationSec' => 3600,
]);
// $est->estimateTrx, $est->unitPrice, $est->durationSec, $est->availableResource
// 3. Place the order.
$order = $sdk->buyResource(
['receiver' => 'TFwUFWr3QV376677Z8VWXxGUAMFSrq1MbM', 'resourceAmount' => 65000, 'durationSec' => 3600],
['allowPartialFill' => true, 'maxPriceAccepted' => 100],
);
// 4. Poll until the energy is actually delegated.
$status = $sdk->getOrder($order->orderId);
echo $status->fulfilledPercent; // 100 = fully delegated
echo $status->remainAmount; // 0 when nothing is left to fill
foreach ($status->delegates as $d) {
// $d->delegator, $d->amount, $d->txid
}
Две детали в этом фрагменте особенно полезны. estimateBuyResource не требует авторизации — можно узнать цену покупки ещё до получения ключа, а запрос цены в «горячем» участке кода никогда не тратит лимит запросов на авторизацию. А второй аргумент buyResource — это массив опций: allowPartialFill позволяет заполнить заказ от нескольких поставщиков, а не ждать одного крупного, а maxPriceAccepted — ваш потолок в SUN за единицу, та самая граница между устойчивой интеграцией и интеграцией, которая переплачивает во время скачка цен.
Заказ не завершён, когда buyResource возвращает результат, — возвращается orderId. Делегирование приходит через несколько секунд. Опрашивайте getOrder, пока fulfilledPercent не достигнет 100, и только потом отправляйте перевод, которому нужна энергия.
Значения по умолчанию и лимиты, которые стоит знать
| Параметр | Значение |
|---|---|
| Тип ресурса по умолчанию | ENERGY |
| Ценовой уровень по умолчанию | MEDIUM (также FAST, SLOW или цена в SUN) |
| Длительность по умолчанию | 259200 секунд — 3 дня |
| Минимальный заказ энергии | Должен быть больше 64 000 |
| Rate limit на стороне клиента | 15 запросов/с; 1/с для getExtendableDelegates |
| Таймаут / повторы по умолчанию | 30 000 мс / 3 повтора |
Формат extendTo |
Unix-время в секундах |
Минимум в 64 000 проверяется на стороне клиента: слишком маленький заказ выбрасывает исключение ещё до HTTP-запроса, так что ошибочный цикл не потратит лимит запросов, раз за разом получая один и тот же отказ. Rate limiter тоже работает на стороне клиента — он сам распределяет ваши вызовы во времени, не дожидаясь ответа 429 от сервера.
Обработка ошибок, которая выдержит продакшен
Любой сбой — это типизированное исключение, наследующее Tronsave\TronsaveException, с полями ->code, ->status и ->raw:
| Исключение | Когда | Что делать |
|---|---|---|
TronsaveAuthException |
401 | Исправить ключ. Не повторять. |
TronsaveValidationException |
400, неверные параметры | Исправить вызов. Не повторять. |
TronsaveBusinessException |
400, отказ по существу | Прочитать ->code и обработать по ветке. |
TronsaveRateLimitException |
429 | Подождать ->retryAfterMs. |
TronsaveNetworkException |
Сбой транспорта | Можно безопасно повторить. |
use Tronsave\{TronsaveBusinessException, TronsaveRateLimitException};
try {
$order = $sdk->buyResource(['receiver' => $addr, 'resourceAmount' => 65000]);
} catch (TronsaveRateLimitException $e) {
usleep($e->retryAfterMs * 1000);
} catch (TronsaveBusinessException $e) {
$log->warning('order rejected', ['code' => $e->code, 'raw' => $e->raw]);
}
Такое разделение важно: оно без догадок показывает, что можно повторять. SDK уже сам повторяет временные ошибки — 408, 425, 429, 500, 502, 503 и 504 — с экспоненциальной задержкой и jitter, учитывая заголовок Retry-After, если сервер его присылает. То, что доходит до вашего блока catch, уже повторялось, так что исключения выше — именно те, по которым решение должен принять ваш код.
Как оплачивается заказ
Есть два способа оплаты, и SDK выбирает между ними по тому, что вы передаёте:
- Предоплаченный баланс (рекомендуется для серверов). Вызовите
buyResourceбезsignedTx— заказ авторизуется вашим API-ключом и списывается с баланса TronSave. Ваш приватный ключ TRON никогда не попадает в интеграцию — именно то, что нужно на веб-сервере. - Ончейн-оплата каждого заказа. Передайте
signedTx, который вы сами собрали и подписали, и заказ будет оплачен этой транзакцией.
Клиент также предоставляет getSignedTransaction(), который подписывает на стороне сервера. Его собственный docblock советует подписывать локально, и к этому стоит прислушаться: этот вызов отправляет приватный ключ по сети. Для PHP-бэкенда предоплаченный баланс и проще, и безопаснее — используйте его.
Продление вместо повторной покупки
Если уже полученное делегирование скоро истекает, продлить его дешевле, чем купить новый заказ. Вызовите getExtendableDelegates() с получателем и Unix-временем extendTo; он вернёт isAbleToExtend, totalEstimateTrx и payload extendData, который вы сразу передаёте в extendRequest(). Учтите более жёсткий лимит в 1 запрос в секунду для первого вызова — это единственный эндпоинт, который SDK ограничивает строже остальных.
Наше руководство по функции Extend объясняет, когда продление выгоднее повторной покупки.
FAQ
Какая версия PHP нужна?
PHP 8.1 или новее. SDK опирается на backed enum, readonly-свойства и именованные аргументы, которые появились в PHP 8.0 и 8.1.
Нужен ли Guzzle?
Он используется по умолчанию, так что всё работает сразу. Но транспорт построен на PSR-18, поэтому можно подставить любой совместимый клиент — удобно, если в приложении уже есть настроенный клиент со своим логированием, прокси или политикой таймаутов.
Можно ли тестировать, не тратя реальные TRX?
Да. Создайте клиент с Network::Testnet — и вы в тестовой сети Nile с отдельным API-хостом. Там ничего не стоит реальных денег. Для выхода в продакшен поменяйте одно значение enum.
Сколько энергии покупать для перевода USDT?
Примерно 65 000 для получателя, у которого уже есть USDT, и около 130 000 для того, у кого их никогда не было, — см. сколько энергии нужно для перевода USDT. Помните, что минимальный заказ — больше 64 000, так что 65 000 — наименьший практический заказ энергии.
PHP SDK отстаёт от TypeScript-версии?
Нет. Все пять клиентов работают с одним и тем же API v2 одной версии и проходят общий набор тестов на соответствие, так что поведение между языками не расходится. Если вы пишете на нескольких языках, руководства по SDK для TypeScript, Java и Rust описывают тот же процесс.
Что будет, если заказ заполнится только частично?
С включённым allowPartialFill вы получаете то, что смог предложить рынок, а fulfilledPercent показывает, сколько именно. Проверьте его перед отправкой транзакции, которой нужна энергия: частично заполненного заказа может не хватить на ваш перевод.
Итог
Если ваш PHP-сервис переводит USDT в сети TRON, энергия — это постоянная статья расходов, которую можно сократить до 80%, а SDK превращает это в интеграцию из четырёх вызовов, а не в отдельный проект. Установите его, узнайте цену заказа без ключа, покупайте с предоплаченного баланса, чтобы приватный ключ не попадал на веб-сервер, и дождитесь 100% перед отправкой.
Начните интеграцию: выполните composer require tronsave/sdk, получите ключ в панели TronSave и оцените первый заказ на живом рынке энергии.
TronSave SDK публикует TronSave — издатель этого блога. Описанные здесь версии пакета, значения по умолчанию и лимиты соответствуют v2.0.0 и могут измениться в следующих релизах — сверьтесь с официальной документацией SDK, прежде чем фиксировать версию. Это не финансовая рекомендация.


