Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Мерчант EVM Token

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

Описание

Модуль позволяет принимать токены EVM сетей (Ethereum, BSC, Polygon, Arbitrum и другие) на адреса собственной ноды. Модуль поддерживает сбор средств с использованием функций approve и transferFrom для переиспользуемых прокси-адресов, а также функции transfer для одноразовых прокси-адресов.

Глоссарий

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

    • Одноразовый прокси-адрес - адрес для депозита токена EVM сети, сгенерированный для одной конкретной заявки. Такой адрес будет навсегда закреплен за заявкой и не будет повторно использоваться для других заявок.

    • Переиспользуемый прокси-адрес - адрес для депозита токена EVM сети, сгенерированный для заявки. Такой адрес будет временно закреплен за заявкой и будет повторно использован для одной из следующих заявок через то количество дней, которое указно в настройках мерчанта.

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

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

  • Приватный ключ адреса - уникальный секретный код, который дает полный доступ к криптокошельку и управлению его средствами.

  • Адрес контракта токена - уникальный идентификатор смарт-контракта токена, который используется для взаимодействия с ним в блокчейне. Возможно найти на странице токена, пример: https://bscscan.com/token/0x55d398326f99059ff775485246999027b3197955

  • ABI токена - интерфейс смарт-контракта, описывающий его функции и события, необходимый для взаимодействия с токеном в сети. Возможно найти на странице токена, пример: https://bscscan.com/token/0x55d398326f99059ff775485246999027b3197955#code

Сбор средств

На сервисном кошельке рекомендуется иметь сумму в нативной валюте сети (ETH/BNB/POL и т.д) в эквиваленте 25-100$ для работы сбора токенов с прокси адреса на мастер адрес. В противном случае, сбор не будет запущен и токены останутся на прокси-адресе.

При использовалии AML модуля на прием, сбор средств не будет запущен если AML модуль установит для заявки статус Удержана.

Ниже приведены примеры работы сбора средств с одноразового прокси-адреса (Transfer) и с переиспользуемого прокси-адреса (Allow & TransferFrom) для токена Binance-Peg BSC-USD (USDT BEP20) в сети BSC.

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

  2. Отправка BNB с сервисного кошелька на прокси-адрес для оплаты комиссии сети за сбор токенов на шаге 3. При этом сумма BNB, которая будет использована для оплаты комиссии рассчитывается в момент сбора токенов, учитывая загруженность сети BSC и контракта токена.

  3. Сбор токенов с прокси-адреса на мастер адрес с помощью функции transfer и оплата комиссии сети за вызов функции.

  1. Отправка USDT BSC (BEP20) на переиспользуемый прокси-адрес, который сгенерирован под текущую заявку.

  2. Отправка BNB с сервисного кошелька на прокси-адрес для оплаты комиссии за разрешение сервисному адресу распоряжаться средствами на прокси-адресе и сбор токенов на шаге 3 и 4. При этом сумма BNB, которая будет использована для оплаты комиссии, рассчитывается в момент сбора токенов, учитывая загруженность сети BSC и контракт токена.

  3. Вызов функции approveдля разрешения сервисному адресу распоряжаться средствами на прокси-адресе и оплата комиссии сети за вызов функции.

  4. Сбор токенов с прокси-адреса на мастер адрес с помощью функции transferFrom и оплата комиссии сети за вызов функции.

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

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

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

Plugin type: Merchant module

Plugin URL: @boxexchanger-plugins/merchant-evm-token

Directory path: evm-token

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

Package tag: latest

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

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

Для настройки мерчанта вам необходима собственная нода EVM-совместимой сети (Ethereum, BSC, Polygon, Arbitrum и т.п). Мануал по установке ноды: Ethereum Node

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

  2. На странице настроек мерчанта в поле "RPC node URL" укажите ссылку на ноду -> нажмите "Save".

  3. В поле "Synced blocks" укажите "0" (рекомендуется) чтобы подтянулся последний замайненный блок в блокчейне либо укажите номер блока, с которого будет начинаться синхронизация -> нажмите "Save".

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

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

  6. В поле "Wait confirms blocks" укажите необходимое количество блоков для подтверждения транзакции. Рекомендуем устанавливать 12-> нажмите "Save".

К примеру, если в поле "Wait confirms blocks" будет установлено значение 12, то статус заявки будет изменен На выплатутолько после того как транзакция на прокси-адрес наберет 12 подтверждений сети в блокчейне.

  1. В поле "Limit blocks per request" укажите количество блоков, которое будет парсится за один API запрос. Рекомендуется оставить 50.

  2. В поле "Re-use address after" укажите через сколько дней прокси-адрес будет использован повторно для другой заявки

    1. В случае, если для поля "Collecting tokens Mode" вы выбрали способ сбора "Transfer (for one-time address)", то рекомендуем оставить значение 36500 для того чтобы прокси-адрес не использовался повторно для других заявок.

    2. В случае, если для поля "Collecting tokens Mode" вы выбрали способ сбора "Allow & TransferFrom (for re-usable address)", то установите количество дней через которое прокси-адрес будет использован повторно для другой заявки.

    -> нажмите "Save".

  3. В поле "Gas price (in gwei) or auto" укажите:

    1. Значение "Auto" (Рекомендуется) для того чтобы цена за gas высчитывалась автоматически в зависимости от нагрузки сети.

    2. Конкретное значение цены за gas, которое вам удобно. Однако, необходимо учитывать что при низкой цены за gas может не произойти сбор средств с прокси-адреса на мастер адрес.

    -> нажмите "Save".

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

Для того чтобы найти адрес контракта токена, перейдите на страницу списка токенов в нужном эксплорере (в зависимости от сети), к примеру, для сети BSC https://bscscan.com/tokens и выберите необходимый токен -> на странице токена в блоке "Other Info" скопируйте адрес контракта из поля "Token Contract".

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

Для того чтобы найти ABI токена, на странице токена выберите раздел "Contract" - "Code" - в блоке "Contract ABI" скопируйте код ABI.

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

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

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

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

  2. В поле "PrivateKey service account" укажите приватный ключ от сервисного кошелька. Рекомендуем сгенерировать адрес и ключ самостоятельно. Однако для теста можете использовать наш генератор: https://www.boxexchanger.net/gen-trx.

Last updated