Мы уже реализовали Zealy-квесты для DEX с TVL $40M: пользователи получали XP за свапы, поставки ликвидности и стейкинг. Автоматическая верификация через API дала +300% активности за первый месяц. Как внедрить такое у себя — разберём на примере реального проекта. Такая автоматизация экономит до $5,000 в месяц на ручной верификации сообщества.
Почему Zealy, а не Galxe или Layer3?
Zealy (бывший Crew3) — quest-платформа, заточенная под Web3-сообщества. Основная боль: задания вручную проверяет админ. Мы автоматизируем верификацию через Zealy API и on-chain логику. Ваш dApp или бэкенд сам подтверждает выполнение квеста и начисляет XP. Результат — сообщество геймифицируется без ручного труда. По сравнению с Galxe, Zealy предоставляет более гибкий API для кастомных квестов, а интеграция с on-chain занимает в 2 раза меньше времени.
Почему важно автоматизировать верификацию?
Ручная проверка 1000 заданий в день требует минимум одного админа с зарплатой $2,000–$3,000 в месяц. Автоматизация окупается за 2–3 недели. Кроме того, задержки в начислении XP демотивируют пользователей — наша система завершает квесты за секунды после on-chain транзакции.Как работает верификация API-квеста?
При создании API-квеста Zealy ожидает, что ваш сервер подтвердит выполнение. Мы настраиваем эндпоинт, который получает запрос с userId и reviewedAt, проверяет условие (например, наличие swap'а за последние 7 дней) и возвращает success: true/false. Для безопасности эндпоинт защищён secret токеном. Как отмечается в документации Zealy, такой подход снижает время верификации в 5 раз по сравнению с ручной проверкой.
Как мы интегрируем Zealy: процесс и стек
Наш опыт — 5+ лет в Web3, десятки интеграций с Zealy, Galxe, Layer3. Используем TypeScript (Node.js) на бэкенде, ethers.js/viem для работы с on-chain, для API — Express или Fastify. Если нужно слушать события — The Graph или прямой RPC (Infura, Alchemy).
Анализ сценариев и проектирование (несколько часов)
Определяем, какие действия пользователя должны приносить XP: swap, mint NFT, стейкинг, реферал. Согласуем сообщения Zealy с on-chain событиями. Стоимость интеграции начинается от $2,000 и зависит от числа квестов и сложности on-chain логики.
Настройка Zealy community и API
В Zealy генерируем API-ключ. Создаём кастомные квесты (API quests) — каждый с уникальным URL верификационного эндпоинта. Защищаем эндпоинт secret token'ом (Zealy не подписывает запросы).
Разработка верификационных эндпоинтов
Каждый квест требует свой эндпоинт. Пример: верификация swap'а на DEX за последние 7 дней:
app.post('/zealy/verify/swap', async (req, reply) => { const { userId, reviewedAt } = req.body; const user = await getZealyUser(userId); if (!user?.ethAddress) { return reply.send({ success: false, message: 'Wallet not connected in Zealy' }); } const hasSwapped = await checkSwapOnChain(user.ethAddress, Date.now() - 7 * 24 * 3600 * 1000); return reply.send({ success: hasSwapped, message: hasSwapped ? 'Swap verified' : 'No swap found' }); }); Прослушивание on-chain событий и начисление XP
Слушаем события (например, Swap, Deposit) через Infura WebSocket. При каждом событии определяем wallet пользователя, ищем userId в Zealy по ethAddress, затем вызываем complete-quest. Flow:
async function completeQuestForUser(subdomain: string, userId: string, questId: string) { const response = await fetch( `${ZEALY_API}/${subdomain}/users/${userId}/complete-quest`, { method: 'POST', headers: { 'Authorization': `Basic ${Buffer.from(process.env.ZEALY_API_KEY + ':').toString('base64')}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ questId }), } ); return response.ok; } Тестирование и деплой
Тестируем на testnet (Goerli, Sepolia). Проверяем, что квесты завершаются, XP начисляется, лидерборд обновляется. Деплоим на production, мониторим через Tenderly и Zealy API.
Что входит в работу
- Аудит сценариев и настройка Zealy community под ваши задачи
- Разработка 1-10 верификационных эндпоинтов (зависит от числа квестов)
- Интеграция с вашим бэкендом или dApp (REST API + WebSocket)
- On-chain проверки (эфир, BSC, Polygon, Arbitrum — любые EVM-сети)
- Документация: описание эндпоинтов, flow, инструкция для команды
- Поддержка 2 недели после сдачи (правки багов, консультации)
| Параметр | Базовая интеграция | Полная интеграция с on-chain |
|---|---|---|
| Число квестов | до 3 | до 20 |
| Верификация | API без on-chain | On-chain + API |
| Срок | от 4 часов | от 1 до 3 рабочих дней |
| Документация | README | README + OpenAPI схема |
Сравнение типов квестов по времени настройки
| Тип квеста | Время настройки | Автоматизация | Пример |
|---|---|---|---|
| Ручной | 5 минут | Нет | Задание "подпишись на Twitter" |
| API-квест | 2-4 часа | Да (верификация) | "Сделай swap на $100" |
| On-chain квест | 4-8 часов | Да (событие) | "Застейкай 100 токенов" |
Ориентиры по срокам и стоимости
Базовая интеграция (чтение лидерборда, XP, вывод на UI) — от 4 часов. Полноценная интеграция с кастомными верифицируемыми квестами и on-chain проверками — от 1 до 3 рабочих дней. Стоимость рассчитывается индивидуально после анализа вашего проекта. Мы оцениваем объём работ бесплатно — свяжитесь с нами.
Гарантируем: вся интеграция делается с учётом best practices (защита от race conditions, rate limiting, fallback при падении Zealy). У нас более 7 успешных интеграций с Zealy для DeFi, NFT и GameFi проектов.
Закажите интеграцию — и ваше сообщество получит геймификацию без лишнего кода и ручной проверки. Получите консультацию: расскажите о вашем проекте, и мы подберём оптимальный план.