---
title: Как купить энергию TRON на Rust с TronSave SDK (2026)
description: "Покупка энергии TRON на Rust через официальный крейт TronSave: async-клиент на reqwest, типизированные ошибки, ретраи и rate limiting — четыре вызова."
url: https://blog.tronsave.io/ru/kak-kupit-energiyu-tron-na-rust/
canonical: https://blog.tronsave.io/ru/kak-kupit-energiyu-tron-na-rust/
lang: ru-RU
datePublished: 2026-11-15T13:58:04+00:00
dateModified: 2026-11-15T13:58:04+00:00
author: TronSave
publisher: TronSave (https://tronsave.io/)
categories:
  - Руководства по TRON
keywords: купить энергию TRON на Rust
translations:
  en: https://blog.tronsave.io/how-to-buy-tron-energy-in-rust-sdk-guide/
  es: https://blog.tronsave.io/es/comprar-energia-tron-con-rust/
  pt: https://blog.tronsave.io/pt/comprar-energia-tron-com-rust/
  zh: https://blog.tronsave.io/zh/rust-goumai-bochang-nengliang/
  de: https://blog.tronsave.io/de/tron-energie-mit-rust-kaufen/
---

# Как купить энергию TRON на Rust с TronSave SDK (2026)

Самый быстрый способ **купить энергию 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](https://blog.tronsave.io/ru/kupit-energiyu-tron-cherez-api/); здесь тот же процесс, но с типами Rust и `async`.

![Рынок энергии, на котором сервис на Rust покупает энергию TRON через TronSave SDK](https://blog.tronsave.io/wp-content/uploads/2025/09/Energy-rental-interface-on-Tronsave-copy.png)

SDK размещает заказы на том же рынке энергии, что и веб-интерфейс. Источник: TronSave

## Что такое TronSave Rust SDK?

Это официальный асинхронный клиент на Rust для TronSave API v2, опубликованный на [crates.io как `tronsave`](https://crates.io/crates/tronsave) (версия 2.0.0, лицензия MIT, edition 2021, **MSRV 1.75**). Сгенерированная документация API — на [docs.rs](https://docs.rs/tronsave/latest/tronsave/). Это один из пяти официальных клиентов (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](https://blog.tronsave.io/ru/funkciya-extend-prodlenie-arendy-energii-tron/) рассказано, когда продление — лучший вариант.

## 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](https://blog.tronsave.io/ru/skolko-energii-nuzhno-dlya-perevoda-usdt/). Поскольку минимум должен быть *больше* 64 000, 65 000 — наименьший практичный заказ энергии.

### Отстаёт ли Rust-клиент от остальных?

Нет. Все пять SDK нацелены на v2 одной версии и проходят общий набор тестов на соответствие. Если вы работаете с несколькими языками, тот же процесс описан в [гайде по TypeScript](https://blog.tronsave.io/ru/kupit-energiyu-tron-cherez-kod-tronsave-sdk/) и [гайде по PHP](https://blog.tronsave.io/how-to-buy-tron-energy-in-php-sdk-guide/).

## Итог

Если ваш сервис на Rust переводит USDT в сети TRON, энергия — это постоянная статья расходов, которую можно заметно сократить, арендуя её вместо сжигания TRX, а крейт превращает это в интеграцию из четырёх вызовов, а не в целый проект. Добавьте зависимость, узнайте цену заказа без ключа, покупайте с предоплаченного баланса, чтобы приватный ключ не касался сервиса, делайте match по `ErrorKind` там, где нужна реальная обработка, и опрашивайте статус до 100% перед отправкой.

**Начните интеграцию:** добавьте `tronsave = "2"`, получите ключ в [личном кабинете TronSave](https://tronsave.io/ru) и узнайте цену первого заказа на [живом рынке энергии](https://tronsave.io/ru/market).

*TronSave SDK публикует TronSave — издатель этого блога. Описанные здесь версии, значения по умолчанию и лимиты относятся к крейту 2.0.0 и могут измениться в следующих релизах — перед фиксацией версии проверьте crates.io и docs.rs. Это не финансовый совет.*
