> For the complete documentation index, see [llms.txt](https://manual.boxexchanger.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.boxexchanger.net/obmen/merchant-i-api/merchant-evm-native.md).
# Мерчант EVM Native
Инструкция по настройке мерчанта EVM Native
{% stepper %}
{% step %}
## Описание
Модуль позволяет принимать нативные токены EVM-сетей, например ETH, BNB, MATIC, AVAX и другие, через собственную ноду.
### Глоссарий
* **Прокси-адрес** - адрес для депозита нативной валюты EVM-сети, сгенерированный для заявки. На данный адрес клиент будет отправлять нативную валюту EVM-сети для оплаты заявки.
* Одноразовый прокси-адрес - адрес для депозита нативной валюты EVM-сети, сгенерированный для одной конкретной заявки. Такой адрес будет навсегда закреплен за заявкой и не будет повторно использоваться для других заявок.
* Переиспользуемый прокси-адрес - адрес для депозита нативной валюты EVM-сети, сгенерированный для заявки. Такой адрес будет временно закреплен за заявкой и будет повторно использован для одной из следующих заявок через то количество дней, которое указано в настройках мерчанта.
* **Мастер-адрес** - адрес кошелька на который будет отправляться нативная валюта EVM-сети при сборе средств с прокси-адреса. Обычно это адрес вашего холодного/горячего кошелька, к примеру, можно использовать адрес, который вы сгенерировали и храните в аппаратном кошельке Ledger.
### Сбор средств
{% hint style="warning" %}
При использовании AML-модуля на прием, сбор средств не будет запущен если AML-модуль установит для заявки статус [Статусы заявки](/zayavki/zayavki/statusy-zayavki.md#uderzhana).
{% endhint %}
Сбор нативной валюты с прокси-адреса на мастер-адрес выполняется мерчантом автоматически. Комиссия сети за перевод оплачивается из баланса нативной валюты на прокси-адресе.
{% endstep %}
{% step %}
## Установка мерчанта
Используя параметры ниже, установите мерчант через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin.md).
Параметры для Install Plugin
**Plugin type**: **`Merchant module`**
**Plugin URL**: **`@boxexchanger-plugins/merchant-evm-native`**
**Directory path**: **`evm-native`**
**Auth: (Deploy token)**: оставляем пустым
**Package tag**: **`latest`**
{% hint style="warning" %}
Обратите внимание, один мерчант поддерживает только одну нативную валюту EVM-сети. Для того чтобы принимать через мерчант EVM Native более одной нативной валюты, необходимо дублировать мерчант через функционал Install Plugin (при установке необходимо указывать уникальный Directory Path).\
**Если у вас возникнут вопросы - вы всегда можете обратиться в поддержку BoxExchanger.**
{% endhint %}
{% endstep %}
{% step %}
## Настройка мерчанта
{% hint style="danger" %}
Использование публичных нод недоступно.
{% endhint %}
{% hint style="success" %}
Для настройки мерчанта вам необходима собственная нода EVM-совместимой сети (Ethereum, BSC, Polygon, Arbitrum и т.п).\
Мануал по установке ноды: [Ethereum Node](/dlya-razrabotchikov/ustanovka-node/ethereum-node.md)
Также подойдет сервис, который предоставляет доступ к собственным нодам, например, Quicknode.
{% endhint %}
1. В админ панели скрипта перейдите на страницу "**Мерчант и API"** -> в разделе "**Merchant system**" нажмите на **значок настройки** в блоке мерчанта "**EVM native**".
1. На странице настроек мерчанта в поле "**RPC node URL**" укажите ссылку на ноду -> нажмите "**Save**".
2. В поле "**Synced blocks**" укажите "**0**" (**рекомендуется**) чтобы подтянулся последний замайненный блок в блокчейне либо укажите номер блока, с которого будет начинаться синхронизация -> нажмите "**Save**".
3. Для поля "**Payment with QR-code?**" выберите значение "**Yes**" для того чтобы на шаге оплаты заявки отображался QR-код с адресом для депозита, или **No** чтобы QR-код не отображался -> нажмите "**Save**".
4. В поле "**Wait confirms blocks**" укажите необходимое количество блоков для подтверждения транзакции. Рекомендуем устанавливать `12`-> нажмите "**Save**".
{% hint style="info" %}
К примеру, если в поле "**Wait confirms blocks**" будет установлено значение `12`, то статус заявки будет изменен [Статусы заявки](/zayavki/zayavki/statusy-zayavki.md#na-vyplatu)только после того как транзакция на прокси-адрес наберет 12 подтверждений сети в блокчейне.
{% endhint %}
5. В поле "**Limit blocks per request**" укажите количество блоков, которое будет обрабатываться за один API-запрос. Рекомендуется оставить `50`.
6. В поле "**Re-use address after**" укажите через какое количество дней прокси-адрес будет использован повторно для другой заявки
1. Укажите значение `36500` для того чтобы прокси-адрес не использовался повторно для других заявок.
2. Либо установите количество дней через которое прокси-адрес будет использован повторно для другой заявки.
-> нажмите "**Save**".
7. В поле "**Gas price (in gwei) or auto**" укажите:
1. Значение "**Auto**" (**Рекомендуется**) для того чтобы цена газа высчитывалась автоматически в зависимости от нагрузки сети.
2. Конкретное значение цены газа, которое вам удобно. Однако, необходимо учитывать что при низкой цене газа может не произойти сбор средств с прокси-адреса на мастер-адрес.
-> нажмите "**Save**".
8. В поле "**Minimum payment amount to process**" укажите минимальную сумму поступившего платежа, при которой мерчант может запустить сбор нативной валюты. \
Если поступившая сумма меньше указанного значения, мерчант не будет выполнять сбор.
{% hint style="info" %}
Эта настройка позволяет избежать дополнительных комиссий сети при сборе небольших сумм, которые могут поступить после основного перевода клиента.
{% endhint %}
9. В поле "**Collect token when amount greater than or equal**" укажите минимальный баланс нативной валюты на прокси-адресе, при котором выполняется сбор -> нажмите "**Save**".
10. В поле "**Master address**" укажите адрес кошелька, на который будет происходить сбор средств с прокси-адресов -> нажмите "**Save**".
11. Мерчант настроен, вы можете установить его в качестве модуля приема в валюте/направлении и принимать нативные токены EVM-сетей.
{% endstep %}
{% endstepper %}
