filtry.md

description	cover	coverY
Узнайте больше про фильтры как часть рабочих процессов симбиотов	../.gitbook/assets/GrfE.gif	0

🛑 Фильтры

В целом

Роль фильтров на первый взгляд кажется менее значимой чем роль коннекторов или плагинов. Однако, они так же крайне важные так как помогают вам лучше фильтровать входящие данные на ваши ноды.

Как вы уже успели прочитать в прошлых разделах, потоки генерации и валидации блоков - асинхронные и независимы друг от друга. Да, в KLYNTAR блоки могут генерироваться раньше чем проверяться. Благодаря особенностям работы и ставкам пользователей на собственную честность нам и удается добиваться максимумов в производительности и масштабируемости.

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

Набор фильтров обычно идёт в одном паке вместе с репозиторием workflow, так как предполагается что разработчик уже позаботился про минимальный уровень безопасности - учёл доступные транзакции на workflow, лучше разбирается в их подводных камнях и так далее.

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

Где находится или куда помещать собственные фильтры

Фильтры находятся в паке с workflows, то бишь по такому пути

<YOUR_KLYNTAR_DIRECTORY>/KLY_Workflows/<имя рабочего процесса>/filters.js

{% hint style="info" %} Это необязательный путь, потому что разработчик workflow может сменить положение фильтров в иерархии - например разбить на категории, добавить конфигурационный файл и так далее {% endhint %}

Что касается разработчиков KlyntarTeam, то мы для простоты помещаем фильтры сразу. Вот как это выглядит

Что из себя представляют фильтры на уровне кода

Фильтры представляют из себя простой файл с одним объектом на экспорт в котором перечислены различного рода триггеры на приходящие к вам события - транзакции, блокировки, делегации и так далее.

В зависимости от их типа вы уже и принимаете решения - принимать их в мемпул или же нет

{% hint style="warning" %} Рекомендуется всё таки пользоваться фильтрами от разработчиков пака workflow. Это обезопасит вас от того, что вы забудете обработать какое-то событие или же обрабатывать его неправильно.

Разработчикам в свою же очередь рекомендуется вводить некоторый конфигурационный файл на уровне пака рабочего процесса в котором можно будет просто назначать минимальный уровень комиссии, блокировать приходящие события от адресов из чёрных списков и так далее {% endhint %}

Репозиторий с фильтрами

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

{% embed url="https://github.com/KLYN74R/Filters" %}