Самый быстрый способ купить энергию TRON на Rust — официальный крейт TronSave: добавьте tronsave = "2", создайте клиент, затем оцените стоимость, оформите заказ и опрашивайте его статус. Четыре вызова с await, типизированная ошибка, по которой действительно можно делать match, а ретраи и rate limiting уже реализованы. В этом гайде — вся интеграция: установка, значения по умолчанию, документированные коды ошибок и то, как оплачивается заказ.
Почему энергия важна для сервисов на Rust
Rust встречается именно там, где стейблкоины двигаются большими объёмами: бэкенды бирж, платёжные процессоры, кастодиальные сервисы, высоконагруженные боты. Все они упираются в одну и ту же арифметику сети TRON: каждый перевод USDT (TRC-20) расходует энергию, а энергия, которой у вас нет, оплачивается сжиганием TRX по тарифам протокола. При 100 sun за единицу энергии это около 6,43 TRX за стандартный перевод (по состоянию на ноябрь 2026 г.), и так при каждой отправке.
Аренда энергии непосредственно перед пакетом выплат обходится дешевле сжигания (28 октября 2026 г. — примерно на треть дешевле при аренде на час и примерно на 59% дешевле за перевод при аренде на 30 дней), а если делать это в коде, сервис пополняет себя сам, а не будит дежурного. Если сначала хотите посмотреть на уровень эндпоинтов, прочитайте наш гайд по автоматизации через API; здесь тот же процесс, но с типами Rust и async.

Что такое TronSave Rust SDK?
Это официальный асинхронный клиент на Rust для TronSave API v2, опубликованный на crates.io как tronsave (версия 2.0.0, лицензия MIT, edition 2021, MSRV 1.75). Сгенерированная документация API — на docs.rs. Это один из пяти официальных клиентов (TypeScript, Python, Java, PHP и Rust): все они оборачивают одни и те же эндпоинты и проходят общий набор тестов на соответствие, поэтому поведение у них не расходится.
Крейт намеренно сделан тонким:
- Async на
tokio, построен наreqwestиserde. Каждый вызов — этоasync fn, возвращающаяtronsave::Result<T>. - rustls вместо OpenSSL.
reqwestподключён сdefault-features = falseи фичейrustls-tls, поэтому не нужно линковать системный OpenSSL — именно то, что нужно в контейнере на musl, Alpine или distroless. - Типизированные DTO.
UserInfo,EstimateBuyResource,Order,Delegate,OrderBookLevel— простые структурыserde, маппинг camelCase уже сделан за вас. - Небольшое дерево зависимостей.
reqwest,serde,serde_json,thiserror,fastrandиtokio(только фичиtimeиsync).
Установка
[dependencies]
tronsave = "2"
tokio = { version = "1", features = ["full"] }
Затем задайте TRONSAVE_API_KEY в окружении. Network::Testnet направляет клиент на тестовый API Nile, где ничего не стоит реальных TRX; Network::Mainnet работает в боевой сети. Оба варианта сами определяют базовый URL через Network::base_url(), так что в вашей конфигурации никогда нет жёстко прописанного хоста.
Тот же enum предоставляет fund_address() — адрес для депозита в сценарии с подписанной транзакцией. Брать его из enum, а не вставлять строку в конфиг, — более безопасная привычка: адрес депозита, скопированный из сообщения в чате или из поисковой выдачи, — проверенный способ потерять пополнение.
Покупка энергии от начала до конца
use tronsave::{TronsaveClient, Network, models::BuyParams};
#[tokio::main]
async fn main() -> tronsave::Result<()> {
let sdk = TronsaveClient::new(
std::env::var("TRONSAVE_API_KEY").ok(),
Network::Mainnet,
)?;
// 1. Who am I, and can I afford this run?
let me = sdk.get_user_info().await?;
println!("balance: {} SUN", me.balance);
// 2. What will it cost? (no API key needed for this call)
let est = sdk.estimate_buy_resource(BuyParams {
receiver: "TFwUFWr3QV376677Z8VWXxGUAMFSrq1MbM".into(),
resource_amount: 65_000, // ENERGY must be > 64_000
duration_sec: Some(3600),
..Default::default()
}).await?;
println!("estimate: {} SUN", est.estimate_trx);
// 3. Place the order.
let order = sdk.buy_resource(BuyParams {
receiver: "TFwUFWr3QV376677Z8VWXxGUAMFSrq1MbM".into(),
resource_amount: 65_000,
duration_sec: Some(3600),
..Default::default()
}).await?;
// 4. Poll until the energy is actually delegated.
let status = sdk.get_order(&order.order_id).await?;
println!("{}% filled, {} left", status.fulfilled_percent, status.remain_amount);
for d in &status.delegates {
println!(" {} sent {} (tx {})", d.delegator, d.amount, d.txid);
}
Ok(())
}
Здесь стоит отметить три момента.
..Default::default() — вот и вся эргономика. У BuyParams девять полей, но обязательны только два; остальные — Option, которые при сериализации полностью пропускаются, если не заданы. Вы указываете то, что вам нужно, а остальное заполняют значения по умолчанию.
estimate_buy_resource не требует аутентификации. Можно узнать цену заказа ещё до получения ключа, а запрос цены в горячем пути никогда не тратит ваш лимит аутентифицированных запросов.
Заказ не завершён, когда buy_resource вернул результат. Он возвращает order_id; делегирование приходит через несколько секунд. Опрашивайте get_order, пока fulfilled_percent не достигнет 100, прежде чем отправлять перевод, которому нужна энергия, — и действительно проверяйте это, потому что частичного исполнения может не хватить.
Значения по умолчанию и лимиты, которые стоит знать
| Поведение | Значение |
|---|---|
| Тип ресурса по умолчанию | ENERGY |
| Ценовой уровень по умолчанию | MEDIUM (также FAST, SLOW или цена напрямую в SUN) |
| Срок по умолчанию | 259_200 секунд — 3 дня |
| Минимальный заказ энергии | Должен быть больше 64 000 |
| Rate limit на стороне клиента | 15 запросов/с; 1/с для get_extendable_delegates |
| Таймаут / ретраи по умолчанию | 30 000 мс / 3 ретрая |
Формат extend_to |
Unix-время в секундах |
| Размер страницы по умолчанию | 10 |
Минимум 64 000 проверяется до того, как запрос покинет ваш процесс, поэтому ошибочный цикл не потратит лимит запросов, раз за разом получая один и тот же отказ. Rate limiter — это token bucket на каждый эндпоинт, который сам выравнивает темп ваших вызовов, а не ждёт ответа 429. А когда ретрай уместен, backoff экспоненциальный с full jitter: 300 мс с удвоением на каждой попытке, максимум 10 секунд, затем случайное значение в пределах всего этого окна. Последнее важнее, чем кажется: без jitter группа воркеров, одновременно получивших 429, повторяет запросы синхронно и снова перегружает эндпоинт.
Ретраи срабатывают на 408, 425, 429, 500, 502, 503 и 504 и учитывают заголовок Retry-After, если сервер его присылает.
Один тип ошибки, шесть видов
В Rust нет иерархий исключений, и SDK не делает вид, что они есть. Каждый вызов возвращает tronsave::Result<T>, а единственная структура Error содержит kind, документированный code, HTTP-status, retry_after_ms и тело raw для отладки. По ней делается match:
use tronsave::ErrorKind;
match sdk.buy_resource(params).await {
Ok(order) => tracing::info!(order_id = %order.order_id, "energy ordered"),
Err(e) if e.kind == ErrorKind::RateLimit => {
let wait = e.retry_after_ms.unwrap_or(1_000);
tokio::time::sleep(std::time::Duration::from_millis(wait)).await;
}
Err(e) if e.kind == ErrorKind::Business => match e.code.as_str() {
"INTERNAL_BALANCE_ACCOUNT_TOO_LOW" => top_up_and_alert().await,
"PRICE_EXCEED_MAX_PRICE_REQUIRED" => skip_until_price_falls(),
"CANNOT_FULFILLED" => queue_for_retry(),
_ => tracing::warn!(code = %e.code, "order rejected"),
},
Err(e) => tracing::error!(code = %e.code, kind = ?e.kind, status = ?e.status, "buy failed"),
}
kind говорит о классе проблемы. code — о том, что произошло на самом деле, и, в отличие от произвольного текста, это документированное стабильное значение, общее для всех пяти SDK:
| Вид | Коды | Что это значит для вашего кода |
|---|---|---|
Auth |
API_KEY_REQUIRED, INVALID_API_KEY |
Исправьте ключ. Никогда не повторяйте. |
Validation |
MISSING_PARAMS, INVALID_PARAMS, MIN_PRICE_INVALID |
Исправьте вызов. Никогда не повторяйте. |
Business |
INTERNAL_ACCOUNT_NOT_FOUND, INTERNAL_BALANCE_ACCOUNT_TOO_LOW, CANNOT_FULFILLED, MUST_BE_WAIT_PREVIOUS_ORDER_FILLED, PRICE_EXCEED_MAX_PRICE_REQUIRED, SOME_DELEGATE_CANNOT_EXTEND |
Запрос корректен, но отклонён. Ветвитесь по коду. |
RateLimit |
RATE_LIMIT |
Подождите retry_after_ms. |
Network |
NETWORK_ERROR |
Сбой транспорта. Повторять безопасно. |
Unknown |
UNKNOWN |
Нераспознанный ответ. Залогируйте raw. |
Именно к этим бизнес-кодам стоит привязать реальную логику. INTERNAL_BALANCE_ACCOUNT_TOO_LOW — пора пополнить баланс. PRICE_EXCEED_MAX_PRICE_REQUIRED — рынок превысил заданный вами потолок, и лучше подождать, чем вслепую его поднимать. MUST_BE_WAIT_PREVIOUS_ORDER_FILLED — вы отправляете заказы быстрее, чем они исполняются.
Как оплачивается заказ
Клиент выбирает способ оплаты в зависимости от того, что вы передаёте:
- Предоплаченный баланс (рекомендуется для серверов). Оставьте
signed_txравнымNone— заказ аутентифицируется вашим API-ключом и списывается с баланса TronSave. Приватный ключ TRON никогда не попадает в сервис. - Ончейн-оплата каждого заказа. Передайте
signed_tx, которую вы сами собрали и подписали, — эта транзакция и оплатит заказ.
Есть ещё хелпер get_signed_transaction(), который подписывает на стороне сервера. Его собственный doc-комментарий советует подписывать локально, и к этому стоит прислушаться: этот вызов передаёт приватный ключ по сети. Для бэкенд-сервиса путь с предоплаченным балансом и проще, и безопаснее.
Продление вместо повторной покупки
Когда срок уже имеющейся у вас делегации подходит к концу, продлить её выгоднее, чем покупать новый заказ. Вызовите get_extendable_delegates с адресом получателя и Unix-временем extend_to; в ответе будут is_able_to_extend, total_estimate_trx и данные extend_data, которые вы передаёте прямо в extend_request. Учитывайте лимит 1 запрос в секунду для этого первого вызова — это единственный эндпоинт, который SDK ограничивает строже остальных. В нашем гайде по функции Extend рассказано, когда продление — лучший вариант.
FAQ
Какая версия Rust нужна?
1.75 или новее — это заявленная MSRV крейта, edition 2021.
Навязывает ли он конкретный async-рантайм?
Он использует tokio для таймеров и синхронизации, поэтому поддерживаемый рантайм — tokio. Реальными зависимостями подключаются только фичи time и sync; фича full в примере установки нужна лишь для вашего собственного #[tokio::main].
Потянет ли он OpenSSL в мою сборку?
Нет. reqwest настроен с default-features = false и rustls-tls, так что TLS реализован на чистом Rust. Поэтому он без проблем работает на musl и в distroless-образах.
Можно ли тестировать, не тратя реальные TRX?
Да — создайте клиент с Network::Testnet для тестовой сети Nile на отдельном API-хосте. Чтобы перейти в боевую сеть, поменяйте одно значение enum.
Сколько энергии покупать для перевода USDT?
Примерно 65 000, если у получателя уже есть USDT, и около 130 000, если их никогда не было, — см. сколько энергии нужно для перевода USDT. Поскольку минимум должен быть больше 64 000, 65 000 — наименьший практичный заказ энергии.
Отстаёт ли Rust-клиент от остальных?
Нет. Все пять SDK нацелены на v2 одной версии и проходят общий набор тестов на соответствие. Если вы работаете с несколькими языками, тот же процесс описан в гайде по TypeScript и гайде по PHP.
Итог
Если ваш сервис на Rust переводит USDT в сети TRON, энергия — это постоянная статья расходов, которую можно заметно сократить, арендуя её вместо сжигания TRX, а крейт превращает это в интеграцию из четырёх вызовов, а не в целый проект. Добавьте зависимость, узнайте цену заказа без ключа, покупайте с предоплаченного баланса, чтобы приватный ключ не касался сервиса, делайте match по ErrorKind там, где нужна реальная обработка, и опрашивайте статус до 100% перед отправкой.
Начните интеграцию: добавьте tronsave = "2", получите ключ в личном кабинете TronSave и узнайте цену первого заказа на живом рынке энергии.
TronSave SDK публикует TronSave — издатель этого блога. Описанные здесь версии, значения по умолчанию и лимиты относятся к крейту 2.0.0 и могут измениться в следующих релизах — перед фиксацией версии проверьте crates.io и docs.rs. Это не финансовый совет.


