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

Как купить энергию TRON через код: TronSave SDK (Node.js, Python и другие)

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

Если ваше приложение, биржа или бот отправляет USDT (TRC-20) в больших объёмах, покупать энергию вручную неудобно. Официальный TronSave SDK позволяет оценивать, покупать, продлевать и отслеживать заказы энергии прямо из вашего бэкенда — на Node.js, Python, Rust, Java или PHP. Это руководство проведёт вас от установки до первого ончейн-заказа энергии.

Какие есть SDK

Все SDK работают с API v2 и оборачивают одни и те же эндпоинты, поэтому в каждом языке доступны одинаковые операции:

Язык Пакет Установка Требования
TypeScript / JS tronsave-sdk npm install tronsave-sdk Node.js 18+
Python tronsave pip install tronsave Python 3.9+
Rust tronsave cargo add tronsave —
Java io.tronsave:sdk Maven / Gradle —
PHP tronsave/sdk composer require tronsave/sdk PHP 8.1+

Пакеты для Rust, Python, Java и PHP имеют версию 2.0.0. Для Java координаты — io.tronsave:sdk:2.0.0: добавьте зависимость в pom.xml или в build.gradle как implementation 'io.tronsave:sdk:2.0.0'.

Что умеет каждый SDK

Набор функций намеренно компактный. Какой бы язык вы ни выбрали, вы получаете те же семь операций:

  • Estimate Buy Resource — узнать цену покупки до того, как оформить заказ.
  • Buy Resource — разместить заказ на энергию или пропускную способность (bandwidth); возвращает ID заказа.
  • Get Order / Get Orders — получить статус одного заказа или историю заказов.
  • Get Order Book — текущее предложение по ценовым уровням, начиная с самого дешёвого.
  • Get User Info — баланс внутреннего счёта и адрес для пополнения.
  • Get Extendable Delegates — список делегирований, которые можно продлить.
  • Extend Request — продлить существующее делегирование вместо покупки нового заказа.

Последняя пара важнее, чем кажется. Если получателю уже делегирована энергия и нужно лишь, чтобы она действовала дольше, правильный выбор — продление: подробнее в руководстве по функции Extend.

Быстрый старт (Node.js)

Самый быстрый путь — работа через API-ключ: создайте экземпляр SDK, оцените стоимость и разместите заказ. API-ключ можно получить в панели TronSave (см. раздел Аутентификация).

import { TronsaveSDK } from "tronsave-sdk";

const main = async () => {
  const sdk = new TronsaveSDK({ network: "mainnet", apiKey: "your_api_key" });

  const userInfo = await sdk.getUserInfo();

  // Estimate cost for 65,000 ENERGY for 1 hour (one USDT transfer)
  const estimate = await sdk.estimateBuyResource({
    receiver: "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    resourceType: "ENERGY",
    durationSec: 3600,
    resourceAmount: 65000,
  });
  if (estimate.estimateTrx > Number(userInfo.balance)) throw new Error("Insufficient balance");

  const { orderId } = await sdk.buyResource({
    receiver: "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    resourceType: "ENERGY",
    durationSec: 3600,
    resourceAmount: 65000,
  });

  await new Promise((r) => setTimeout(r, 5000)); // wait ~5s to fill
  const order = await sdk.getOrder(orderId);
  console.log(order.fulfilledPercent < 100 ? "Not filled" : "Filled");
};

main();

Совет: используйте network: "testnet" (Nile), чтобы разрабатывать без реальных TRX, а для продакшена переключитесь на "mainnet".

Две детали, которые стоит знать перед запуском. userInfo.balance возвращается в SUN в виде строки (1 TRX = 1 000 000 SUN), поэтому при сравнении значение приводится к числу. А durationSec — необязательный параметр: если его не указать, заказ по умолчанию действует 259 200 секунд, то есть 3 дня.

Та же задача на Python

Пакет для Python устанавливается командой pip install tronsave и даёт тот же сценарий «оценка → покупка → отслеживание»; сигнатуры методов для каждого языка описаны в справочнике SDK. Если хотите видеть, какие именно HTTP-запросы выполняются под капотом, вот та же задача — оценка, покупка и опрос статуса — напрямую через эндпоинты v2:

import time, requests

API = "https://api.tronsave.io"          # testnet: https://api-dev.tronsave.io
HEADERS = {"apikey": "your_api_key", "Content-Type": "application/json"}
ORDER = {
    "receiver": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "resourceType": "ENERGY",
    "resourceAmount": 65000,
    "durationSec": 3600,
    "unitPrice": "MEDIUM",
}

estimate = requests.post(f"{API}/v2/estimate-buy-resource", json=ORDER).json()["data"]
print(estimate["estimateTrx"] / 1e6, "TRX", estimate["availableResource"], "available")

order = requests.post(f"{API}/v2/buy-resource", headers=HEADERS,
                      json={**ORDER, "options": {"allowPartialFill": True,
                                                 "maxPriceAccepted": 100}}).json()
order_id = order["data"]["orderId"]

time.sleep(5)
detail = requests.get(f"{API}/v2/order/{order_id}", headers=HEADERS).json()["data"]
print("Filled" if detail["fulfilledPercent"] == 100 else "Not filled")

Те же три шага, те же имена полей, тот же формат ответа. Ценность SDK — в типизации и повторных попытках, а не в каком-то другом API, так что выбирайте то, что удобнее для вашего стека. Более полный скрипт на Python с расчётом объёма по книге заказов и обработкой ошибок — в статье как купить энергию TRON на Python.

Оценка перед покупкой

Запрос оценки заслуживает отдельного абзаца: его ответ сообщает две разные вещи. estimateTrx — стоимость в SUN. availableResource — сколько рынок реально может предоставить прямо сейчас. Если availableResource меньше запрошенного resourceAmount, заказ в этот момент не может быть исполнен полностью, и что делать дальше, вы задаёте через options: allowPartialFill: true — взять то, что есть, или onlyCreateWhenFulfilled: true — отказаться от всего, что меньше полного исполнения. Для ботов с частыми повторами preventDuplicateIncompleteOrders: true не даёт повторному вызову плодить одинаковые открытые заказы.

Ошибки и лимиты

Эндпоинты допускают 15 запросов в секунду; при превышении возвращается HTTP 429 с "Rate limit reached", и достаточно простого backoff 1 с/2 с/4 с. Ошибки приложения приходят как error: true с машиночитаемым кодом внутри message — INVALID_API_KEY, INTERNAL_BALANCE_ACCOUNT_TOO_LOW, PRICE_EXCEED_MAX_PRICE_REQUIRED, CANNOT_FULFILLED. Ветвите логику по коду: формулировка текста может измениться.

Управление TronSave из ИИ-агента

Если ваша интеграция — это агент, а не сервис, TronSave также предоставляет MCP-сервер по адресу https://mcp.tronsave.io/mcp через Streamable HTTP (и https://mcp.tronsave.io/testnet/mcp для тестовой сети). Он предоставляет 53 MCP-инструмента (версия сервера 1.3.0, ноябрь 2026 г.) — tronsave_estimate_buy_resource, tronsave_list_order_books, tronsave_internal_order_create и другие — с сессиями по API-ключу или по подписи кошелька. Подключите к эндпоинту любой MCP-совместимый клиент; наше руководство по MCP-серверу TronSave описывает вход, два семейства инструментов и модель безопасности.

Предпочитаете чистый HTTP? SDK оборачивают те же эндпоинты API — см. наше руководство по автоматизации через API, разбор типов заказов TronSave и, для больших объёмов, оптовую покупку энергии.

FAQ

Нужен ли API-ключ?
Работа через API-ключ — самый простой вариант; также можно подписывать транзакции приватным ключом. Ключ можно получить в панели. Разница — в хранении средств: API-ключ тратит средства с заранее пополненного внутреннего счёта TronSave, а сценарий с подписанными транзакциями оплачивает каждую покупку из вашего собственного кошелька и требует TronWeb.

Какие языки поддерживаются?
Node.js/TypeScript, Python, Rust, Java и PHP — все на API v2. Отдельные пошаговые руководства есть для Python, Java, PHP и Rust.

Сколько энергии нужно на перевод USDT?
Около 65 000 (≈130 000, если у получателя никогда не было USDT). Подробнее — в статье сколько энергии нужно для перевода USDT.

Можно ли тестировать, не тратя реальные TRX?
Да. Укажите network: "testnet" (или направьте базовый URL на https://api-dev.tronsave.io), чтобы работать с Nile. Ключи, балансы и заказы в каждой среде свои, поэтому создайте ключ для Nile на testnet.tronsave.io — ключ от mainnet будет отклонён. Shasta не поддерживается.

TronSave
TronSave

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

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

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