Настройка RPC-эндпоинтов

Последнее обновление: 7 сентября 2026 г.

У приложения нет бэкенда. Оно обращается к сетям напрямую, а значит, каждой сети нужен источник данных: либо официальный публичный API, либо RPC-адрес узла, который предоставите вы. Здесь описано, как его указать и что делать, если он не отвечает.

Указать эндпоинт

1. Настройки (⚙ вверху главного экрана) → Сети.
2. Выберите сеть. Подпись уже сообщает, какой источник используется — или что сеть не настроена.
3. Нажмите Настроить RPC-узел / Изменить эндпоинт и введите адрес. Он должен начинаться с http:// или https://.
4. Если узел требует аутентификации, укажите имя пользователя и пароль в том же диалоге.
5. Нажмите Проверить соединение: приложение запросит высоту цепочки и покажет «OK» либо точную ошибку.
6. Сбросить возвращает значение по умолчанию: официальный адрес там, где он есть, и пустое поле в остальных сетях.

Где хранятся учётные данные

Имя пользователя и пароль RPC записываются в Android Keystore / связку ключей iOS, отдельной записью на каждую сеть. Они никогда не попадают в настройки, в файл резервной копии, в журналы и в сборку приложения.

• Пароль больше не показывается. Если открыть диалог заново и оставить поле пустым, сохранённые данные останутся.
• Удалить учётные данные стирает их из защищённого хранилища.
• Экспортированная копия содержит только адреса RPC — никогда пароль и никогда имя пользователя.

Свой собственный узел

Эти сети — форки Bitcoin или Dash: RPC настраивается в конфигурационном файле демона. Нужные параметры везде одинаковы.

server=1
rpcuser=<имя пользователя>
rpcpassword=<длинный случайный пароль>
rpcbind=0.0.0.0                  # слушать сеть, а не только localhost
rpcallowip=<доверенный-ip>/32    # ограничить, кто может вызывать RPC
# rpcport=...                    # оставьте порт сети по умолчанию, если нет причин менять

Демон, конфигурационный файл, порт по умолчанию и вызываемый метод — по сетям:

Сети, которых нет в таблице — Cosanta, Neoxa и Flux, — читаются через публичный обозреватель или API, а не через RPC-узел. Открывать для них RPC-порт не нужно: вы меняете только адрес.

HTTPS и обратный прокси

Демон отдаёт незашифрованный HTTP, и приложение принимает его во всех четырнадцати сетях: ни один демон мастерноды не отдаёт TLS, а наблюдаемая нода часто доступна только в локальной сети, где публично доверенный сертификат не имеет смысла. Однако по HTTP всё идёт открытым текстом — ответы демона и, главное, пароль RPC, если он есть. Как только канал перестаёт быть доверенным, поставьте перед RPC обратный прокси с TLS — Caddy, Nginx или Traefik — и укажите приложению адрес прокси. С Caddy это две строки, а сертификат выпускается автоматически:

rpc.example.com {
    reverse_proxy 127.0.0.1:9998
}

Basic-аутентификацию тоже можно возложить на прокси вместо демона. В обоих случаях приложение передаёт учётные данные по TLS, никогда в открытом виде.

Особенности сетей

Сети, работающие сразу

Beldex, Firo, Cosanta и Neoxa поставляются с официальным публичным источником и не требуют никакой настройки. Две вещи всё же стоит знать:

• Beldex — единственная сеть, где можно указать несколько эндпоинтов. Они перебираются по порядку, так что второй адрес — это автоматическое переключение при сбое.
• Firo предлагает два режима. Публичный обозреватель работает сразу, но не отдаёт числовой показатель PoSe: наказанный узел выглядит здоровым вплоть до бана. Ваш собственный firod его отдаёт — и откатывается на публичный обозреватель, если ваш узел упадёт.

Сети, которым нужен ваш собственный узел

PIVX, Dash, Syscoin, Divi, Raptoreum, SmartCash, SwiftCash, BitCore, Flux и Terracoin стартуют ненастроенными. Это осознанный выбор, а не упущение, и причин две. У первых восьми нет официального публичного эндпоинта со списком мастернод, и мы предпочитаем оставить поле пустым, чем пускать ваш трафик через коммерческий шлюз, который вы не выбирали. Flux и Terracoin — другой случай: официальный источник существует и отвечает безупречно, но его оператор не разрешает приложению обращаться к нему; оба убраны из значений по умолчанию 2026-08-25.

• Аутентификация обязательна везде, кроме PIVX, где она необязательна: публичный узел может её не требовать, ваш собственный pivxd — потребует.
• Шлюзы с ключом API (NOWNodes, GetBlock и подобные) работать не будут: приложение не отправляет заголовок api-key. Публичные шлюзы без ключа подойдут, если разрешают методы получения списка мастернод — многие обслуживают только запросы блоков.
• Их обозреватели не работают или закрыты намеренно. Если вы знаете надёжный публичный эндпоинт, просто вставьте его.
• Flux не требует учётных данных — его API публичный и только на чтение — и каждый FluxNode отдаёт тот же самый API на порту 16127 по незашифрованному HTTP: укажите http://ваш-ip:16127. Два соседних порта — тупики: 16126 это веб-интерфейс, а 16128 тот же API за самоподписанным сертификатом, который телефон отвергает.

Сеть, о которой стоит предупредить

Безопасность

• Никогда не выставляйте RPC без аутентификации в открытый интернет. Открытый RPC — это узел, а иногда и кошелёк, во власти первого встречного. Используйте rpcallowip, межсетевой экран, VPN или обратный прокси с аутентификацией.
• Ставьте длинный случайный пароль. RPC — машинный интерфейс, вводить его руками дважды никому не придётся.
• Никогда не вводите приватный ключ в поле добавления узла. Для мониторинга нужны только публичные данные. В нескольких сетях приложение отклоняет приватный ключ уже по формату, до того как хоть один запрос покинет устройство.
• Учётные данные остаются на устройстве, в защищённом хранилище системы — не в настройках, не в резервной копии, не в журнале.

Устранение неполадок

Всё ещё не работает? Пришлите нам название сети, точную ошибку из Проверить соединение и версию демона — см. поддержку. Учётные данные не присылайте никогда.