Ми вже реалізували 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 перевірки (Ethereum, 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 проектів.
Замовте інтеграцію — і ваша спільнота отримає гейміфікацію без зайвого коду та ручної перевірки. Отримайте консультацію: розкажіть про ваш проект, і ми підберемо оптимальний план.