← Блог
10 мин чтения
|
Опубликовано
|
Обновлено

Комиссии Tron: пропускная способность, энергия и fee_limit

Как списываются комиссии Tron: пропускная способность, энергия, порядок сжигания TRX, fee_limit и динамическая модель энергии для загруженных контрактов.

Главы
C
Chaingateway Team
Эксперты по блокчейну

Проверил(а) Maurice Sobiera

Комиссия Tron — это стоимость ресурсов транзакции, которая оплачивается пропускной способностью за её размер и энергией за выполнение смарт-контракта. Если на вашем аккаунте мало нужного ресурса, сеть сжигает TRX, чтобы покрыть разницу. В этой статье объясняется порядок списания, fee_limit, который ограничивает вызов контракта, и динамическая модель энергии, которая меняет стоимость.

Зачем нужны комиссии Tron?

Каждая транзакция, кроме запроса на чтение, расходует пропускную способность, поэтому у каждой транзакции есть цена в ограниченном ресурсе. Модель ресурсов TRON определяет пропускную способность как размер транзакции в байтах. Энергия измеряет вычисления в виртуальной машине TRON и применяется только при развёртывании или вызове контракта.

Аккаунты получают ресурсы, застейкав TRX, или получая делегированные ресурсы. Каждый аккаунт также получает бесплатный лимит пропускной способности 600 в день. Всё, что сверх него, оплачивается сожжённым TRX. Ставки и лимиты — параметры сети, которые могут менять предложения управления, поэтому берите актуальные значения из блокчейна, а не зашивайте их в код. Эндпоинт Chaingateway GET /api/v2/tron/chainparameters возвращает их.

В каком порядке списываются комиссии?

Сеть сначала списывает застейканные ресурсы, а TRX сжигает последним. Порядок для пропускной способности и энергии немного различается.

ШагПропускная способность (обычная транзакция)Энергия (вызов контракта)
1Застейканная или делегированная пропускная способностьЗастейканная или делегированная энергия
2Бесплатный дневной лимит 600Сжигание TRX по 100 sun за единицу
3Сжигание TRX по 1 000 sun за байтНет

У энергии нет бесплатного лимита, поэтому вызов контракта с аккаунта без застейканной энергии всегда сжигает TRX. Транзакции, которые создают новый аккаунт, подчиняются другим правилам. Они не используют бесплатный лимит и сжигают 0,1 TRX, если застейканной пропускной способности не хватает. Перевод токена TRC10 может также оплачиваться предоплаченной пропускной способностью эмитента токена.

Пример расчёта: транзакция размером 265 байт требует 265 единиц пропускной способности. Размер включает подпись, кодирование protobuf и резерв 64 байта на результат, как их определяют java-tron и правила кодирования protobuf. Если у отправителя нет застейканной пропускной способности и он уже израсходовал бесплатные 600, сжигание стоит 265 × 1 000 sun, то есть 0,265 TRX. Руководство по комиссиям TRON показывает, как узнать размер в байтах.

Как узнать остаток ресурсов аккаунта?

Запросите у ноды эндпоинт wallet/getaccountresource и вычтите использованное из лимита. В документе о модели ресурсов приведены формулы. Отсутствующие поля считаются нулём.

Remaining free bandwidth = freeNetLimit - freeNetUsed
Remaining staked bandwidth = NetLimit - NetUsed
Remaining energy = EnergyLimit - EnergyUsed

Ресурсы восстанавливаются в течение 24 часов после использования. Кошелёк, который отправляет несколько переводов в день, может уложиться в бесплатную пропускную способность, а любой вызов контракта требует застейканной или делегированной энергии, иначе сжигается TRX. Проверяйте баланс перед каждой серией отправок, а не полагайтесь на предыдущее состояние.

Что такое fee_limit?

fee_limit — это максимальная сумма TRX в sun, которую вызов контракта может сжечь. Он защищает от неожиданно высокого расхода энергии. В документе о модели ресурсов он описан как значение от 0 до 15 000 000 000 sun, то есть 15 000 TRX. Верхняя граница — тоже параметр сети. Ответ Chaingateway с параметрами цепи называет её getMaxFeeLimit.

В документе приведён пример оценки. Контракту понадобилось не более 20 000 единиц энергии. По 100 sun за единицу это 2 000 000 sun, или 2 TRX. Если разработчик контракта взял на себя 90 процентов энергии, доля вызывающего составляет 200 000 sun, и именно это значение нужно задать как fee_limit.

Чтобы получить оценку энергии, вызовите у ноды метод estimateenergy до отправки вызова. Нода должна работать с vm.estimateEnergy=true.

Сколько стоит неудачная транзакция?

Стоимость неудачного вызова контракта зависит от того, как он завершился. Если контракт останавливается с REVERT, вы платите только за инструкции, которые выполнились до этого. Если он падает из-за ошибки или таймаута, сеть списывает всю энергию, разрешённую для транзакции. Этот итог включает вашу застейканную энергию, долю разработчика и сожжённый TRX до fee_limit.

Поэтому низкий fee_limit — это не просто ограничение расходов. Если лимит ниже потребности вызова, исполнение завершается ошибкой, и уже израсходованная энергия не возвращается.

Почему стоимость энергии контракта меняется?

Популярные контракты могут стоить больше энергии из-за динамической модели энергии. Документ о модели ресурсов описывает её как механизм балансировки. Если базовый расход энергии контракта превышает порог в пределах периода обслуживания, вызовы этого контракта в следующем периоде стоят дороже. Текущий период обслуживания составляет 6 часов.

У каждого контракта есть energy_factor, который начинается с 0. Энергия вызова равна базовой энергии, умноженной на 1 + energy_factor. В mainnet документ указывает increase_factor равным 0,2 и max_factor равным 3,4. Контракт на максимуме, таким образом, стоит в 4,4 раза дороже своей базовой энергии. Фактор снова снижается, когда использование контракта падает до порога или ниже него. Текущий фактор контракта можно прочитать вызовом ноды getcontractinfo.

Для платежей это значит, что оценка энергии за прошлую неделю сегодня может оказаться слишком низкой. Оценивайте перед каждой отправкой или добавляйте запас к fee_limit. Пример с USDT и зависящей от получателя разницей в энергии см. в руководстве по комиссиям TRON.

Как мы пишем эти статьи

Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API Tron для полного справочника по эндпоинтам.

C
Chaingateway Team
Эксперты по блокчейну

Команда Chaingateway стремится упростить интеграцию блокчейна для разработчиков по всему миру.