Гайды · документация

Релеи и антиспам

открывает подробности ведёт к полному разбору

Релеи — это как почтовые отделения в общей сети: они принимают события и отдают их тем, кто подписан. Приложению всё равно, сколько их и какие именно, — важно, чтобы хотя бы один был доступен для записи. Полосы разделяют публичное и приватное.

Две полосы

ПолосаЧто через неё идётКто может читать
Публичная (public)Карточки, квалификации, публичные оценки, модерациявсе
Приватная (private)Заявки, доступы, чат — только в запечатанном конвертетолько адресат, после авторизации

Держите 3–5 релеев в разных сетях: если один недоступен, публикация и чтение продолжаются через остальные. Приватный релей проекта — wss://private.job.xnpk.ru (белый список ключей), публичный — wss://relay.job.xnpk.ru.

технически события на полосах и авторизация
  • Публичная полоса: карточки (kind 0), квалификации (kind 30081), публичные оценки, модерация.
  • Приватная полоса: заявки (kind 30079), доступы (kind 30080), чат — только NIP-59 gift wrap.
  • Чтение приватной полосы — после NIP-42 AUTH и только для ключей из белого списка.
Экран релеев: адреса, статусы, задержки, полосы public и private, переключатели чтения и записи
Релеи. Статус и задержка видны сразу. Галочки чтения и записи задают роль релея.

Добавить или убрать релей

  1. Откройте «Релеи» и введите адрес в поле «Добавить релей».
  2. Выберите полосу: public — видно всем, private — только адресату.
  3. Поставьте галочки чтения и записи. Только чтение — нормально для больших публичных релеев.
  4. Проверьте статус: узел покажет, отвечает ли релей и за сколько.
технически команды управления релеями
pvctl relays-list pvctl relays-replace --url wss://relay.job.xnpk.ru --lane public pvctl relays-replace --url wss://private.job.xnpk.ru --lane private pvctl relays-replace --lane private --clear # очистить полосу

Ступени таймаутов по умолчанию — 4000 / 3000 / 3000 мс (быстрая ступень и две доборные).

Защита от спама

Релеи проекта требуют небольшой «вычислительной работы» для каждой публикации: 16 единиц сложности для активных ключей и 20 — для новых. Считает её ваш компьютер в фоне, а не сервер. Обычная публикация занимает секунды, а массовый спам становится дорогим: тысяча поддельных карточек требует вычислений, а не одного скрипта.

технически как задаётся сложность

Это NIP-13 proof-of-work: 16 бит для активных ключей, 20 — для новых. Сложность задаётся в карточке: «авто» означает «попробовать без PoW, а при отказе добить нужное число бит и повторить». Кэш добытых событий живёт 10 минут.

Если релей отказывает

Что видноПричинаЧто делать
«не хватает сложности»Релею нужно больше вычислительной работы в событииПоднять сложность до 20 и повторить; для нового ключа это делается сразу
«нужна авторизация»Релей требует вход по ключуДобавить ключ в белый список приватного релея или выбрать другой
«заглушен» / «заблокирован»Ключ под модерациейДождаться снятия или сменить релей; не публиковать без защиты от спама
Ответа нетРелей недоступен или медленныйПроверить сеть, поднять ступени таймаута в «Настройках»
технически точные ответы релеев
Ответ релеяЧто означает
pow: insufficientне хватает бит сложности
auth-requiredнужен NIP-42 AUTH
mute / blockedключ под модерацией
таймаутрелей недоступен или медленный
Настройки таймаутов релеев: ступени опроса и повторные попытки
Таймауты. Ступенчатая схема: быстрая ступень и две доборные. По умолчанию 4000 / 3000 / 3000 мс.

Что релей видит и чего не видит

Релеи взаимозаменяемы. Удаление или выключение любого релея не ломает сервис: карточки остаются на других, а приватные события можно переопубликовать. Именно поэтому «нет центрального сервера» — не лозунг, а свойство архитектуры.