Мерчант TRON TRC20

Инструкция по настройке мерчанта TRON TRC20

Описание

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

Глоссарий

• Прокси адрес - адрес для депозита токена TRC20, сгенерированный для заявки. На данный адрес будет отправлены токены TRC20 для оплаты заявки со стороны клиента обменного пункта.

• Мастер адрес - адрес кошелька на который будут отправляться токены TRC20 при сборе средств с прокси адреса. Обычно это адрес вашего холодного/горячего кошелька, к примеру, можно использовать адрес, который вы сгенерировали и храните в аппаратном кошельке Ledger.

• Сервисный кошелек - адрес кошелька, который будет использоваться для активации прокси адреса и сбора токенов с прокси адреса на мастер адрес.

• Staked Energy - сбор токенов за счет Energy от стейкинга TRX на сервисном кошельке.

• Burn TRX - сбор токенов за счет сжигания TRX с сервисного кошелька.

Сбор средств

На сервисном кошельке должно быть минимум 100 TRX для работы сбора токенов с прокси адреса на мастер адрес. В противном случае, сбор не будет запущен и токены останутся на прокси адресе.

Staked Energy

1. Отправка токенов TRC20 на прокси адрес (одноразовый адрес), который сгенерирован под текущую заявку.

2. Активация прокси адреса с помощью отправки 0.000001 TRX с сервисного кошелька на прокси адрес. При этом в качестве комиссии, с сервисного кошелька спишется 1 TRX за активацию адреса и будет использовано 100 Bandwidth*.

3. Делегирование Energy (с сервисного кошелька на прокси адрес), которая будет использована для оплаты комиссии сети при сборе токенов с прокси адреса на мастер адрес. В качестве комиссии сети, с сервисного кошелька будет использовано ~255-300 Bandwith*.

4. Сбор токенов с прокси адреса на мастер адрес. При этом, в качестве комиссии будет использована Energy из прокси адреса, которая была ранее делегирована на шаге 3.

5. Reclaim (возврат Energy) с прокси адреса на сервисный кошелек. В качестве комиссии сети с сервисного кошелька будет использовано ~280-300 Bandwidth*. *либо если Bandwith недостаточно, то будет сжигание TRX из расчёта 1 TRX ~ 1000 Bandwidth

Аренда Energy на сервисный кошелек

В случае, если вы арендуете Energy на сервисный кошелек, для того чтобы использовать эту Energy для сбора токенов с прокси адреса на мастер адрес, необходимо учитывать алгоритм работы системы и нюансы, описанные ниже.

Важные моменты:

• Система сможет делегировать только объем Energy, полученный от стейнкинга TRX.

• Нельзя делегировать арендованную энергию, но можно заменить использованную энергию стейкинга арендованной после reclaim.

Общий алгоритм:

1. Проверка количества Energy от стейкинга на сервисном кошельке.

2. Делегирование необходимого объёма Energy на прокси-адрес.

3. Использование Energy на прокси-адресе.

4. Вызов reclaim для освобождения объема использованной Energy.

5. Заполнение освобожденного объема Energy от аренды.

6. Повторение цикла.

Burn TRX

1. Отправка токенов TRC20 на прокси адрес, который сгенерирован под текущую заявку.

2. Отправка TRX с сервисного кошелька на прокси адрес для а) Активации адреса. При этом в качестве комиссии, с сервисного кошелька спишется 1 TRX за активацию адреса и будет использовано 100 Bandwidth*. б) Использовальзования TRX для сжигания при сборе токенов на шаге 3. При этом сумма TRX, которая будет использования для сжигания расчитывается в момент сбора токенов, учитывая загруженность сети TRON и контракт токена.

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

*либо если Bandwith недостаточно, то будет сжигание TRX из расчет 1 TRX ~ 1000 Bandwidth

Установка мерчанта

Используя параметры ниже, установите мерчант через функционал "Install plugin" по инструкции Install plugin.

Параметры для Install Plugin

Plugin type: Merchant module

Plugin URL: @boxexchanger-plugins/merchant-tron_trc_20

Directory path: tron_trc_20

Auth: (Deploy token): оставляем пустым

Package tag: latest

Настройка мерчанта

Использование публичных нод недоступно.

Для настройки мерчанта вам необходима собственная нода TRON TRC20. Мануал по установке ноды TRON TRC20: Tron Node

1. В админ панели скрипта перейдите на страницу "Мерчант и API" -> в разделе "Merchant system" нажмите на в блоке мерчанта "TRON TRC20 Token".

2. На странице настроек мерчанта в поле "FullNode URL" укажите ссылку на FullNode в формате http://ip.host:2090/ -> нажмите "Save".

3. В поле "SolidityNode URL" укажите ссылку на SolidityNode в формате http://ip.host:2091/-> нажмите "Save".

4. Поле "RPC API-Key" оставьте пустым.

5. Для поля "Event server provider" выберите "EventServer (your own server)" -> нажмите "Save".

6. В поле "Event server EventServer URL" укажите ссылку на EventServer в формате http://ip.host:2080/-> нажмите "Save".

7. В поле "Limit txs per page" укажите количество транзакций, которое будет парситься с блокчейна за 1 запрос -> нажмите "Save". Рекомендуем оставить значение 200, которое указано по умолчанию.

8. В поле "Address hold for (days)" укажите количество дней, на которое адрес будет закреплен за заявкой -> нажмите "Save".

• Если вы укажите значение 5, то адрес для депозита токена TRC20, который сгенерирован для заявки #1 будет использован снова для другой заявки спустя 5 дней.

• Для того чтобы адреса не использовались повторно - укажите в поле значение 99999.

1. Для поля "Payment with QR-code?" выберите значение "Yes" для того чтобы на шаге оплаты заявки отображался QR-код с адресом для депозита либо значение "No" чтобы QR-код не отображался -> нажмите "Save".

2. В поле "Contract address" укажите адрес контракта токена TRC20, который вы хотите принимать через данный мерчант -> нажмите "Save".

Для того чтобы найти адрес контракта токена, перейдите на страницу https://tronscan.org/#/tokens/list и необходимый токен -> на странице токена в блоке "Basic Info" адрес контракта из поля "Contract".

Обратите внимание, один мерчант поддерживает только один токен TRC20. Для того чтобы принимать через мерчант TRON TRC20 более одного токена, необходимо дублировать мерчант через функционал Install Plugin (при установке необходимо указывать уникальный Directory Path) и в продублированном мерчанте указывать контрактный адрес другого токена TRC20. Если у вас возникнут вопросы - вы всегда можете обратиться в поддержку BoxExchanger.

1. В поле "Contract decimals" укажите значение "Decimal" для токена, который вы будете принимать -> нажмите "Save".

Для того чтобы найти адрес контракта токена, перейдите на страницу https://tronscan.org/#/tokens/list и необходимый токен -> на странице токена в блоке "Basic Info" значение из поля "Decimal".

1. Для поля "Collect method" выберите подходящий способ сбора токенов с сервисного адреса на мастер адрес -> нажмите "Save". Для выбора подходящего для вас метода сбора, ознакомьтесь с разделом Сбор средств.

2. В случае, если для поля "Collect method" вы выбрали "Staked Energy", то у вас будет доступно поле "Delegate extra energy (in %)". В поле "Delegate extra energy (in %)" вы можете указать процент, на который будет увеличено количество Energy делегируемой на прокси адрес для сбора токенов с прокcи адреса на мастер адрес -> нажмите "Save". Рекомендуем устанавливать значение из диапазона 5-10⁣, для того чтобы обеспечить запас Energy при изменении загруженности сети TRON.

3. В поле "Collect token when amount greater than or equal" укажите минимальную сумму токенов для сбора с прокси адреса на мастер адрес -> нажмите "Save".

Для того чтобы сбор средств происходил при любом депозите на прокси адрес - укажите в поле значение 0.

1. В поле "Master address" укажите адрес кошелька на который будет происходить сбор средств с прокси адресов -> нажмите "Save".

2. В поле "PrivateKey service account" укажите приватный ключ от сервисного кошелька. Рекомендуем сгенерировать адрес и ключ самостоятельно. Однако для теста можете использовать наш генератор: https://www.boxexchanger.net/gen-trx.
3. В поле "Synced time" укажите точку времени (в UNIX формате), с которой нода будет синхронизировать транзакции в сети с TRON блокчейном -> нажмите "Save".

Для того чтобы пропустить синхронизацию, к примеру, при первой настройке мерчанта, вы можете скопировать текущее время в UNIX формате из подсказки в заголовке поля "Synced time" и указать в поле "Synced time".