ReferralGateway — white-label реферальная программа для Web3
Готовый продукт: смарт-контракт, Go API, Next.js UI и мониторинг. Запуск за 2–4 недели вместо 6–9 месяцев разработки с нуля.
О продукте
ReferralGateway — набор компонентов для запуска реферальной (партнёрской / CPA) программы в любой EVM-сети. Вы получаете смарт-контракт с защитой от фрода, Go-бэкенд с REST API и индексатором блокчейна, интерфейс Next.js с дашбордами для рефереров, продавцов и администраторов, мониторинг Prometheus + Grafana и CI/CD. Из коробки: BNB Chain, Polygon, zkSync Era и другие EVM-сети.
Для кого
Те же сегменты, что в коммерческом предложении: от маркетплейсов до интеграторов.
Web3 маркетплейсы и DeFi
Реферальная программа с прозрачными on-chain выплатами: без ручных расчётов и Excel — начисления и вывод через смарт-контракт.
Биржи, кошельки, Web3-финтех
Партнёрская программа с holdTime, арбитражем спорных начислений и поддержкой ERC-20 (USDT, USDC и др.).
Агентства и интеграторы
White-label под ключ: брендирование, документация, runbooks и CI/CD для перепродажи клиентам.
Бизнес-ценность
Сравнение с самостоятельной разработкой — ориентиры из практики внедрения.
| Критерий | Разработка с нуля | ReferralGateway |
|---|---|---|
| Срок запуска | 6–9 месяцев | 2–4 недели |
| Ориентир по бюджету | $150,000–350,000 | $25,000–50,000 (внедрение) / выкуп от $50,000 |
| Анти-фрод | Проектировать с нуля | holdTime + арбитраж встроены |
| Аудит контракта | Отдельный контракт и сроки | Проверенный код; внешний аудит — по запросу |
| Мониторинг и тесты | Зависит от команды | Prometheus/Grafana; покрытие контракта, E2E, k6 |
Варианты поставки
Лицензия + внедрение
$25,000 – $50,000
Развёртывание в вашей инфраструктуре (Docker Compose / Kubernetes)
Деплой контракта в выбранные сети, брендирование UI, мониторинг и алерты
Документация DEPLOYMENT.md, runbooks; 3 месяца поддержки Standard
Полный выкуп исходников (IP buyout)
$50,000 – $100,000
Полный исходный код: contract / backend / frontend
Права без ограничений на модификацию и перепродажу
1 месяц поддержки при передаче
Выкуп + запуск у вас
$65,000 – $120,000
Всё из варианта B
Production rollout и онбординг вашей команды
Снижение рисков при передаче эксплуатации
Этапы внедрения
Неделя 1: квалификация, fit/no-fit, НДА, выбор варианта поставки
Недели 2–3: деплой в testnet, прогон сценариев, приёмка
Недели 4–6: production rollout, мониторинг, домены, SSL
Неделя 7: smoke-тест, передача runbooks, запуск
Итого: ориентир 4–7 недель до production — зависит от числа сетей и кастомизации UI.
Поддержка после запуска
После внедрения доступны типовые уровни Standard и Business; детали фиксируются в договоре.
- Standard (DeFi/NFT): 8×5, реакция P1 до 1 ч, цель восстановления до 8 ч — ориентир $1,500–$2,500 / мес
- Business (биржи/финтех): 12×7, P1 до 1 ч, цель восстановления до 12 ч — ориентир $3,000–$5,000 / мес
24×7 on-call и внешний аудит смарт-контракта обсуждаются отдельно. Исключения SLA: сеть, RPC, кошельки — как в коммерческом предложении.
Сильные стороны
Полный контур: смарт‑контракт, Go REST API с SIWE/JWT, Next.js UI, iframe‑виджет, Discord/Slack уведомления.
On-chain логика: офферы с фиксированной ценой, автоматическое распределение продавец / реферер / протокол, любые ERC-20.
Безопасность: ReentrancyGuard, SafeERC20, timelock на комиссию (24ч) и смену арбитров (48ч), Slither в CI.
Производительность: индексатор ~3 с, Redis-кэш, SingleFlight, семафор RPC, цель 1000+ одновременных пользователей; k6 SLO в репозитории.
Качество и готовность
Контракт: 100% покрытие (Hardhat), fuzz Foundry, инвариант solvency seller + referrer + protocol == price.
Бэкенд: E2E полный цикл createOffer → buy → dispute → vote → claim; unit по auth, API, storage.
Фронтенд: Playwright smoke (логин, оффер, метаданные); WalletConnect + MetaMask (Wagmi/Viem).
Инфраструктура: Docker Compose, Nginx, GitLab CI; Prometheus /metrics изолирован от публичного доступа.
Локальный стенд для команды (~10–15 минут)
После передачи продукта ваши разработчики могут поднять цепочку: контракт → API через compose → Next.js.
Контракт: установить зависимости, поднять локальную сеть и задеплоить контракт (Hardhat/Makefile).
Backend: в папке backend выполнить `make docker-up`, проверить `GET http://localhost:8096/health`.
Backend: при необходимости — накатить миграции (`make install-migrate && make migrate-up`).
Frontend: в папке frontend `npm i`, скопировать `.env.example` → `.env.local`, запустить `npm run dev` (порт 3200).
Опционально: подключить прокси фронтенда на backend (`NEXT_PUBLIC_API_PROXY_TARGET=http://localhost:8096`).
Архитектура решения
Smart Contracts (Solidity)
Solidity 0.8.x: офферы, buy/claim, арбитраж, пагинированный вывод наград, Multicall; Foundry + Hardhat Ignition.
Backend API (Go)
Gin, GORM, PostgreSQL 15, Redis 7, go-ethereum; индексатор событий, rate limit, zerolog, OpenTelemetry.
Multi-chain Design
BNB Chain, Polygon, zkSync Era из коробки; новая EVM-сеть — через конфиг (RPC, адрес контракта, лимиты).
Ключевые возможности
Hold time и арбитраж
Vesting награды, оспаривание начислений продавцом, голосование арбитров; pause только для арбитража — покупки и клейм работают.
Распределение и комиссия протокола
Автоматическое распределение между продавцом, реферером и протоколом; обновление комиссии с задержкой (timelock).
Gas и нагрузка
Пагинация и лимиты для claim, защита от исчерпания gas; кэш, SingleFlight, k6-сценарии с SLO в репозитории.
BNB Chain, Polygon, zkSync Era и любые EVM-сети (config-driven)
Оптимизированный контракт; таблица оценки gas по операциям в документации
holdTime, арбитраж, ReentrancyGuard, SafeERC20