Слогер Создать блог
Разработка

Интеграция Monero в Node.js: RPC, подадреса и продакшн

Полное руководство по подключению криптовалюты Monero к Node.js-приложению: от настройки кошелька и RPC-сервера до генерации подадресов и мониторинга платежей.

Подготовка окружения

Для интеграции Monero в Node.js-проект потребуется установленный демон Monero и кошелёк с поддержкой RPC. Убедитесь, что у вас есть доступ к узлу сети (mainnet или testnet) и создан файл кошелька. Настройка начинается с запуска демона и кошелька в режиме RPC.

Запуск кошелька Monero в режиме RPC

Кошелёк Monero может работать как RPC-сервер, к которому будет обращаться ваше Node.js-приложение. Для тестирования можно запустить его вручную с параметрами подключения к тестовой сети:

./monero-wallet-rpc \ --wallet-file /var/lib/monero/wallets/myzubster \ --password "STRONG_PASSWORD_HERE" \ --rpc-bind-port 18083 \ --rpc-bind-ip 127.0.0.1 \ --daemon-address testnet.community:28081 \ --testnet \ --disable-rpc-login \ --log-level 0 \ --non-interactive

Проверить, что RPC работает, можно через curl-запрос метода get_version. В ответе должен прийти JSON с версией.

Создание systemd-сервиса для продакшна

Для стабильной работы в production лучше оформить запуск кошелька как системный сервис. Создайте файл /etc/systemd/system/monero-wallet-rpc.service с описанием юнита, указав ExecStart с теми же параметрами. Включите автозапуск и проверьте статус сервиса.

Node.js-сервис для работы с Monero

Установите axios для HTTP-запросов и создайте модуль moneroService.js. Он будет инкапсулировать все RPC-вызовы к кошельку. Основные функции:

  • rpc(method, params) — универсальный метод для JSON-RPC запросов;
  • generateSubaddress(label) — создание подадреса для конкретного заказа;
  • getBalance(accountIndex) — получение баланса;
  • checkPayment(address, amount, confirmations) — проверка поступления платежа на подадрес;
  • sendPayment(destination, amount) — отправка XMR;
  • getTransaction(txid) — детали транзакции;
  • getSubaddresses() — список всех подадресов.

Все суммы конвертируются из атомарных единиц (1 XMR = 1e12 атомарных единиц).

Генерация подадресов для заказов

При создании заказа вызывается generateSubaddress с меткой, содержащей ID заказа. Полученный подадрес сохраняется в модели Order. Это позволяет отслеживать платежи по каждому заказу отдельно.

Мониторинг входящих платежей

Фоновый процесс (paymentMonitor.js) периодически опрашивает кошелёк на предмет новых транзакций по активным подадресам. При обнаружении платежа статус заказа меняется на «detected», а после достижения нужного числа подтверждений — на «confirmed». Интервал опроса настраивается через переменную окружения.

Переменные окружения

Все настройки выносятся в .env: URL RPC, адрес кошелька, количество подтверждений, таймауты и т.д. Это упрощает конфигурирование под разные среды.

Тестирование интеграции

Проверьте генерацию подадреса прямым RPC-запросом:

curl -X POST http://127.0.0.1:18083/json_rpc \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":"0","method":"create_address","params":{"label":"test-order"}}'

Затем протестируйте полный цикл создания заказа, оплаты и подтверждения через API вашего приложения.

Возможные проблемы

Если RPC-сервер не видит демон, проверьте доступность узла и параметры подключения. Ошибка «no connection to daemon» решается проверкой сети и перезапуском сервисов. Также стоит убедиться, что порты не заблокированы фаерволом.

Интеграция Monero через RPC и подадреса даёт надёжный механизм приёма платежей с минимальными задержками и полным контролем на стороне сервера.

По материалам: dev.to. Текст переработан редакцией Слогера.

← На главную

Рекламное место — Конец поста
Реклама · Слогер

Комментарии (0)

Войдите, чтобы комментировать.

Пока нет комментариев. Будьте первым.

Личный опыт

Как довести до конца одно незаконченное дело: метод одной даты

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

Слогер 19.11.2026 ▲ 0
Карьера

Как автоматизировать отклики на вакансии: разбор автозаполнения заявок на Greenhouse, Lever и Ashby

Расширение для Chrome берёт на себя формы, которые вы заполняете десятый раз подряд, — но работает только на трёх системах найма и требует собственных ответов. Разбираем механику, цену и границы.

Слогер 18.11.2026 ▲ 0
Карьера

Как выбрать между двумя офферами на стажировку: разбор по шагам

Два оффера одновременно — хорошая проблема, которая всё равно выматывает. Вот порядок действий: приоритеты, реальные задачи, деньги после аренды, разговор с бывшим стажёром и честная просьба об отсрочке.

Слогер 18.11.2026 ▲ 0
Fluxs lenta
Реклама · fluxs.ru
Стартапы

Fluxs включён в реестр российского ПО Минцифры России

🇷🇺 **Fluxs официально включён в реестр российского ПО!** Наша платформа для управления бизнесом вошла в Единый реестр российских программ Минцифры России. Это важный этап развития Fluxs и новые возможности для сотрудничества с российскими компаниями, банками и организациями, заинтересованными в импортозамещении.

Слогер 17.11.2026 ▲ 0
Разработка

Как получить от клиента согласование сайта на staging: чек-лист приёмки

Устное «выглядит хорошо» в мессенджере не защищает никого: через месяц не вспомнить, что именно смотрели и на какой версии. Вот как превратить просмотр staging в нормальную запись о приёмке.

Слогер 17.11.2026 ▲ 0
Карьера

WARN Act: как работает закон о сокращениях и что делать, если уведомление не пришло

Федеральный WARN Act обязывает крупных работодателей предупреждать о закрытии предприятия или массовом сокращении за 60 дней. Разбираем пороги, исключения и порядок действий — на примере отрасли вывоза и переработки отходов, где сокращения легко пропустить.

Слогер 17.11.2026 ▲ 0
Fluxs lenta
Реклама · fluxs.ru
Карьера

Как читать WARN-уведомления о сокращениях: разбор календаря увольнений на 2027 год

Пересчёт уведомлений с датами вступления в силу в 2027 году дал 4 950 человек вместо 2 882 — и это всё ещё нижняя граница. Разбираем, откуда берётся разница в 42% и как не обмануться такой статистикой.

Слогер 17.11.2026 ▲ 0
Разработка

Заменит ли ИИ программиста: что показывают исследования и как выбрать между ИИ и разработчиком

Вопрос «зачем платить разработчику, если ИИ пишет код» построен на неверном представлении о работе программиста. Разбираем два исследования, цену такого заблуждения и практический чек-лист.

Слогер 17.11.2026 ▲ 0
Стартапы

Почему сотрудники забывают задачи и как это исправить | FLUXS

📌 **Почему сотрудники забывают поручения, даже когда всё записано?** Задача поставлена. Сотрудник записал. Срок прошёл. Результата нет. Такая ситуация встречается часто, и часто проблема не в дисциплине, а в отсутствии прозрачной системы управления задачами. Кто исполнитель? Какой срок? На каком этапе работа? 🚀 **FLUXS помогает управлять поручениями и выстраивать бизнес-процессы под правила вашей компании.** А встроенный ИИ-ассистент помогает создавать и настраивать процессы выполнения задач. 👉 Попробуйте конструктор бизнес-модели: https://fluxs.ru/konstruktor-biznes-modeli #FLUXS #УправлениеЗадачами #АвтоматизацияБизнеса #БизнесПроцессы

Слогер 16.11.2026 ▲ 1
Fluxs lenta
Реклама · fluxs.ru
Карьера

Как делиться опытом, если вы не эксперт: ловушка «об этом уже написали» и рабочие форматы

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

Слогер 16.11.2026 ▲ 0