Руководства по TRON

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

Автор: TronSave Опубликовано 9 мин чтения
Содержание

Самый быстрый способ купить энергию 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.

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

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

TronSave
TronSave

Команда TronSave создаёт маркетплейс энергии и пропускной способности TRON на tronsave.io и пишет эти руководства по результатам проверок в основной сети TRON.

Похожие статьи

Мы используем Google Analytics, чтобы понимать, какие руководства полезны читателям. Файлы cookie устанавливаются, только если аналитика разрешена. Рекламы в блоге нет. Конфиденциальность