Гайды · документация
Релеи и антиспам
открывает подробности ведёт к полному разбору
Релеи — это как почтовые отделения в общей сети: они принимают события и отдают их тем, кто подписан. Приложению всё равно, сколько их и какие именно, — важно, чтобы хотя бы один был доступен для записи. Полосы разделяют публичное и приватное.
Две полосы
| Полоса | Что через неё идёт | Кто может читать |
|---|---|---|
| Публичная (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— только адресату. - Поставьте галочки чтения и записи. Только чтение — нормально для больших публичных релеев.
- Проверьте статус: узел покажет, отвечает ли релей и за сколько.
технически команды управления релеями
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 | ключ под модерацией |
| таймаут | релей недоступен или медленный |
Что релей видит и чего не видит
- Публичная карточка — видит целиком, это её работа.
- Заявка и доступ — видит конверт: адресата и время. Содержимое зашифровано.
- Чат — то же самое: конверт, а не текст.
- Файлы — если файл лежит в открытом хранилище или на своём сервере, релей вообще не участвует; адрес и ключ идут пропуском.