TRC10 и TRC20: различия и стоимость
TRC10 — нативный токен Tron без смарт-контракта, TRC20 — токен на контракте. Сравнение выпуска, комиссий, десятичных знаков, поиска баланса и вызовов API.
Проверил(а) Maurice Sobiera
TRC10 и TRC20 — два стандарта токенов в Tron. Токен TRC10 представляет собой нативный актив, который фиксирует протокол, без смарт-контракта. Токен TRC20 представляет собой смарт-контракт в виртуальной машине Tron (TVM), который следует интерфейсу ERC-20 из Ethereum. Они различаются выпуском, стоимостью переводов и поиском баланса.
Что такое токен TRC10?
Токен TRC10 — это актив на уровне протокола. Его выпускают системным контрактом AssetIssueContract, и никакой код контракта не разворачивается. Балансы держателей хранятся в самом аккаунте. Вызов getaccount возвращает их в поле assetV2, как описано в документации TRON по getaccount.
Выпуск токена TRC10 не бесплатен. Значение комиссии за выпуск актива по умолчанию в эталонном клиенте java-tron составляет 1 024 TRX (1024000000 sun), как задано в его DynamicPropertiesStore. Это параметр цепи, поэтому проверьте текущее значение перед выпуском токена. Endpoint Chaingateway GET /api/v2/tron/chainparameters возвращает его как getAssetIssueFee, а пример в спецификации API показывает 1024000000.
Объём предложения фиксируется при выпуске. В списке системных контрактов есть операции для выпуска, перевода и обновления токена TRC10, а также для разблокировки его начального предложения. UpdateAssetContract меняет только описание, URL и квоты бесплатной пропускной способности. Ни одна из операций не увеличивает общее предложение.
Что такое токен TRC20?
Токен TRC20 представляет собой смарт-контракт, который реализует интерфейс из TIP-20. TIP-20 выведен из ERC-20, а TVM совместима с виртуальной машиной Ethereum. Обязательные функции: totalSupply, balanceOf, transfer, transferFrom, approve и allowance. Контракт обязан создавать события Transfer и Approval.
Функции name, symbol и decimals в стандарте необязательны. Код, который читает токен, не должен предполагать, что они существуют. Поскольку логика находится в коде контракта, токен TRC20 может добавлять правила, такие как выпуск, сжигание или чёрные списки. Сам стандарт их не определяет.
Чем TRC10 и TRC20 отличаются?
TRC10 дешевле в переводе и проще для чтения, а TRC20 гибче и использует вызовы контрактов. Таблица сравнивает пункты, которые важны для интеграции.
| Пункт | TRC10 | TRC20 |
|---|---|---|
| Реализация | Нативный актив протокола | Смарт-контракт в TVM |
| Идентификатор | Числовой ID токена, например 1004920 | Адрес контракта |
| Ресурс, который тратит перевод | Пропускная способность | Пропускная способность и энергия |
| Десятичные знаки | precision от 0 до 6 | Необязательная функция decimals(), тип uint8 |
| Поиск баланса | Поле assetV2 аккаунта | Вызов balanceOf контракта |
| Изменение предложения | Фиксировано при выпуске | Определяется кодом контракта |
| Пользовательская логика | Нет | Всё, что реализует контракт |
Чем различаются комиссии за перевод?
Переводы TRC10 требуют только пропускной способности, а переводы TRC20 требуют также энергии. Модель ресурсов Tron определяет пропускную способность как размер транзакции в байтах. Энергия измеряет работу TVM и расходуется только тогда, когда смарт-контракт разворачивают или запускают.
Если на аккаунте недостаточно ресурса, сеть вместо этого сжигает TRX. Согласно тому же документу, текущие цены составляют 1 000 sun за байт пропускной способности и 100 sun за единицу энергии. Транзакция в 200 байт расходует 200 единиц пропускной способности, или 0,2 TRX, если их приходится сжигать. Энергия вызова контракта зависит от контракта, поэтому измеряйте её тестовым переводом. Фиксированного соотношения между двумя комиссиями нет.
Чем различаются десятичные знаки?
У токена TRC10 точность не может превышать 6. Валидация java-tron отклоняет большее значение с ошибкой «precision cannot exceed 6». Токен TRC20 возвращает свои десятичные знаки из необязательной функции decimals(), тип возврата которой допускает значения до 255. Всегда читайте десятичные знаки, а не предполагайте значение, потому что сырая сумма в сети — это целое число в наименьшей единице.
Как отправить любой из токенов через API Chaingateway?
Используйте POST /api/v2/tron/transactions/trc10 для TRC10 и POST /api/v2/tron/transactions/trc20 для TRC20. Запрос TRC10 требует from, to, tokenId и amount. Запрос TRC20 требует from, to, contractaddress и amount. В обоих случаях передаётся либо пароль кошелька password, либо privatekey.
curl -X POST https://app.chaingateway.io/api/v2/tron/transactions/trc10 \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "from": "TLkkCeNdJKPNUwucdro84WjswkzM62LCTH", "to": "TUwmZghA7u2GxGxKaxM1mkCmsTF4wHs4vp", "tokenId": "1004920", "amount": 1, "password": "your-wallet-password" }'Вызов TRC20 имеет ту же форму. Замените tokenId на contractaddress. Адреса и ID токена выше — примеры значений из спецификации OpenAPI. Полный список endpoint-ов Tron см. в справочнике API Tron. Чтобы принимать депозиты, читайте как принимать платежи TRC20. Планирование комиссий описано в руководстве по комиссиям Tron.
Какой стандарт выбрать?
Используйте TRC20, если нужна логика контракта или вы хотите, чтобы ваш токен вёл себя как токены ERC-20 в других сетях. Используйте TRC10, если нужен простой актив с фиксированным предложением, дешёвыми переводами и без контракта, который нужно поддерживать. Если вы принимаете платежи в уже существующем токене, выбор за вас делает эмитент токена. Проверьте, какой стандарт использует токен, и настройте кошелёк и обработку вебхуков под этот стандарт.
Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API Tron для полного справочника по эндпоинтам.