[Case] ​​Self-hosted crypto gateway for accepting deposits in crypto

Быстрый, современный, автономный и легковесный крипто-шлюз, который устанавливается на сервер без каких-либо привязок, идеально подойдет для криптобирж, казино, обменников, и других финансовых проектов в крипто-сфере, принимающих оплату в крипте. Аналог WestWallet или Cryptomus, полностью под собственным управлением.

Логика работы
В этом шлюзе есть разделение: корневые кошельки и адреса для депозитов.
1. Генерируемые адреса для депозита служат для принятия депозита соответственно.
2. Корневые кошельки генерируются в панели на основе одной сидки, ее можно либо сгенерировать, либо импортировать из своего кошелька (формат BIP39, 12 слов). На них приходят средства со сгенерированных адресов для депозита, эти же кошельки оплачивают комиссию сети, если на сгенерированный адрес пришел депозит в токене.

Поддерживаемые монеты
Нативные: AVAX (+токены), BASE (+токены), BCH, BNB (+токены), BTC, CELO (+токены), DOGE, ETH (+токены), LTC, MATIC (+токены), OP (+токены), SOL, TON, TRX (+токены), XRP
Токены: USDT, DAI, USDC, SHIBA (в будущих обновлениях можно будет добавлять свои токены).

Описание базового функционала
— Вся генерация сидок/приватных ключей/адресов происходит строго локально, никакие приватные данные не утекают провайдерам, нет никаких проверок на AML / блокировок средств. Сам шлюз работает через подключения к платным RPC нодам, работает на официальных библиотеках, что позволяет отправлять средства нативно, а в будущем позволит менять сами RPC ноды. Это самый эффективный в соотношении цена/качество вариант и идеально подходит для контроля и сохранности средств.
— Простое и понятное API, единый эндпоинт для генерации адресов, единый формат вебхуков.
— Выводит все под ноль со сгенерированных адресов.
— Визуализация через удобную и современную панель управления с адаптивом, для просмотра и управления данными, полностью написана на API шлюза, позволяющая детально просматривать всю необходимую информацию, настраивать проект под себя, и упрвалять им. Так же есть уведомления в ТГ при генерации адреса и депозитах, они тоже настраиваются.
— Есть возможность генерировать одинаковый адрес для всех EVM сетей, передавая идентификатор (ID) при генерации. В таком случае, если клиент сервиса ошибется в выборе сети, депозит все равно выведется и отстучит. Данный способ генерации не вызывает проблем с обычной генерацией адресов.
— Если сгенерирован депозит в сети, где принимаются токены и был сгенерирован адрес, например, для ETH, а клиент сервиса депнул в USDT ERC-20, шлюз все равно выведет эти средства, отправит вебхуки и уведомления в ТГ.
— Есть возможность по API/в панели вручную выводить средства со сгенерированных адресов.
— Есть возможность в панели/по API отправлять с корневых кошельков монеты на нужный адрес с подсчетом комиссии.
— Реализована встроенная система автоматических двойных бэкапов базы данных: локальное сохранение и на удаленном сервере, можно самостоятельно задавать частоту создания бэкапов.
— Все необходимые данные в БД зашифрованы, сам шлюз работает в изолированной на сервере сети, БД полностью изолирована от внешнего подключения, в локальную или публичную (можно настроить) сеть выходит только его API и панель управления.
— Есть возможность настраивать период вывода средств со сгенерированного кошелька. Сделано для того, например, если депнут в USDT TRC-20 несколько раз за 40 минут, то при заданном периоде в час, движок выведет несколько депозитов спустя час после первого депозита разом все средства для экономии средств на комиссиях.
— Множество необходимых настроек в панели и много чего еще.

Стек разработки
Фронтенд написан на React, TypeScript, shadcn, TanStack (router, table, query), Framer.
Бекенд разработан на NestJS, TypeScript, PostgreSQL, эндпоинты задокументированы для OpenAPI через Swagger.
Весь проект разработан как монорепо на Turborepo + pnpm.
Собирается и запускается через Docker в одну команду.

Примеры вебхуков
Обнаружение депозита: этот вебхук приходит, когда депозит был обнаружен на сгенерированном адресе:

{ "id": 155, "type": "DEPOSIT_DETECTED", "coin": { "id": 25, - Pastebin.com

Pastebin.com is the number one paste tool since 2002. Pastebin is a website where you can store text online for a set period of time.

pastebin.com

Подтверждение депозита: приходит, когда депозит был выведен со сгенерированного адреса на корневой кошелек (после получения этого вебхука можно через API вывести монеты себе и своим партнерам на их адреса):

{ "id": 194, "type": "DEPOSIT_CONFIRMED", "coin": { "id": 25, - Pastebin.co...

Pastebin.com is the number one paste tool since 2002. Pastebin is a website where you can store text online for a set period of time.

pastebin.com

Вывод/трансфер: приходит, когда происходит вывод/трансфер средств с корневых кошельков:

{ "id": 198, "type": "TRANSFER", "coin": { "id": 25, "symbol" - Pastebin.co...

Pastebin.com is the number one paste tool since 2002. Pastebin is a website where you can store text online for a set period of time.

pastebin.com

Помимо вебхуков, еще приходят уведомления в ТГ.

Демонстрация
Ссылка: https://nexus-core-wallet.sbs
Логин: admin
Пароль: admin123admin
API документация: https://nexus-core-wallet.sbs/docs/
Из-за общего доступа, некоторые данные в панели могут быть изменены.

Мои проекты
Nexus Core Gambling - самый большой движок для скам-казино
Nexus Core Wallet - Self-hosted крипто-шлюз для приема депозитов в крипте
Nexus Core Sweeper - Self-hosted мониторинг адресов и автоматический вывод, кстомные правила деривации, 17 сетей
Качественная разработка от реального стронг миддла с большим продакшн-опытом ​