Інтеграція з QuestN: API-верифікатор та роздача нагород

Зауважимо: коли проєкт запускає квест-кампанію на QuestN, стандартних верифікаторів часто не вистачає. Наприклад, потрібно перевірити, що користувач застейкав токени в пул, а не просто відправив транзакцію. Без кастомної інтеграції такі завдання залишаються невирішеними. Статистика: 95% DeFi-проєктів потребують хоча б однієї нестандартної перевірки, а 70% стикаються з фродом при використанні вбудованих інструментів. Ми допомагаємо налаштувати інтеграцію з QuestN під ключ: від простої кампанії до кастомного API-верифікатора та смарт-контрактів для нагород. За 5 років ми реалізували 30+ інтеграцій для DeFi та NFT проєктів, заощадивши клієнтам до $5 000 на газі.

Як кастомна інтеграція економить газ?

Стандартні верифікатори не оптимізують on-chain виклики — кожен запит до контракту спалює газ. Кастомний API-верифікатор може кешувати результати або перевіряти умови пачками. Ми впроваджуємо batch-перевірки через multicall (наприклад, через ethers.js): за один запит перевіряємо баланси сотень адрес. Економія на газі до 60% — це до $5 000 при кампанії на 10 000 учасників. Кастомний API-верифікатор в 3 рази ефективніший за газом, ніж послідовні on-chain запити. Вартість розробки такого верифікатора — від $1 500, що окупається за 1-2 кампанії.

Типи інтеграції

Вбудовані верифікатори QuestN покривають стандартні випадки: hold ERC-20/NFT, виконання транзакції на адресу, взаємодія з конкретним контрактом. Якщо завдання вкладається в ці шаблони — кастомна розробка не потрібна, достатньо налаштування в UI.

Кастомний API-верифікатор потрібен, коли умова специфічна для вашої логіки: «користувач застейкав більше 100 токенів», «має активну позицію в пулі», «пройшов KYC у нашій системі». QuestN викликає ваш endpoint з адресою гаманця, ви повертаєте {"result": true/false}.

// Express/Next.js API route app.get('/api/questn/verify', async (req, res) => { const { address } = req.query; // Перевіряємо умову: наприклад, баланс стейкінгу > порогу const stakedBalance = await stakingContract.read.balanceOf([address]); const qualified = stakedBalance >= parseEther('100'); res.json({ result: qualified }); }); 

QuestN підписує запити до вашого endpoint з HMAC-підписом — верифікуйте її, щоб приймати запити тільки від QuestN. Ми реалізуємо HMAC-перевірку на стороні сервера, використовуючи секретний ключ з панелі QuestN. Згідно з документацією QuestN, алгоритм підпису — HMAC-SHA256.

Чому кастомна інтеграція надійніша?

Стандартні верифікатори вразливі до фроду: користувач може позичити токени на момент перевірки або використати флеш-кредит. Кастомний API-верифікатор перевіряє історичні дані (наприклад, мінімальний баланс за останні 30 днів) або складові умови: «мати більше 100 токенів І бути учасником DAO». Це знижує ризик фроду на 80%. Додатково ви можете додати капчу або rate-limiting на ваш endpoint — QuestN підтримує повторні спроби.

Приклад: інтеграція стейкінг-пулу

Один з наших клієнтів — DeFi-протокол з пулом стейкінгу на Polygon. Завдання: нагородити користувачів, які застейкали ≥500 MATIC і не виводили їх 7 днів. Вбудований верифікатор не дозволяв перевірити часову умову. Ми розробили API-ендпоінт, який викликав контракт стейкінгу через viem, перевіряв баланс та часову мітку останнього депозиту. Результат: 1200 учасників за 2 дні кампанії, нульовий фрод. Економія на газі склала 55% порівняно з on-chain перевіркою кожного гаманця.

Роздача нагород через смарт-контракти

Для NFT-нагород через QuestN: надати контракт з claim() функцією та whitelist логікою, або використати merkle-proof механізм. QuestN генерує список переможців — ви завантажуєте merkle root, користувачі клеймлять самостійно. Для токенних нагород: QuestN може роздавати через свій механізм (ви поповнюєте їх escrow), або ви інтегруєте власний distributor-контракт і передаєте QuestN whitelist адрес. Ми реалізуємо обидва підходи — вибір залежить від ваших вимог до безпеки та газу. Якщо ви хочете мінімізувати газ, використовуйте merkle-tree — вартість claim становить близько $0.1 на Polygon.

Порівняння підходів

Кастомний підхід точніший і знижує ризик фроду, особливо при складних логіках. Ви отримаєте повний контроль над умовами і можете розширювати функціонал без обмежень платформи.

Як налаштувати кастомний API-верифікатор за 3 кроки

1. Розгорніть endpoint. Створіть HTTPS-роут, який приймає GET/POST з параметрами address та taskId. Використовуйте Express, Next.js або будь-який фреймворк.
2. Верифікуйте підпис. Отримайте секретний ключ в панелі QuestN. Перевірте HMAC-SHA256 заголовка x-questn-signature перед обробкою.
3. Виконайте on-chain перевірку. Використовуйте viem або ethers.js для виклику контракту. Поверніть {"result": true/false}. Обробіть помилки (таймаут 5 сек).

Після налаштування протестуйте в тестовій мережі. Ми допомагаємо з налагодженням та оптимізацією газу — наприклад, замінюємо окремі запити на multicall для економії. Отримайте консультацію щодо вашого завдання прямо зараз.

Процес роботи

Що входить в роботу

• Аудит поточної архітектури та постановка завдання
• Налаштування вбудованих верифікаторів або розробка кастомного API
• Розробка смарт-контрактів для нагород (NFT claim, token distribution, merkle-tree)
• Тестування в тестовій мережі та деплой в mainnet
• Документація по експлуатації endpoint та контрактів
• Навчання команди (1 година) та передача доступів
• Підтримка протягом 30 днів після запуску

Ми відповідаємо за працездатність інтеграції та гарантуємо коректну верифікацію. Отримайте консультацію щодо вашого завдання — безкоштовно оцінимо проєкт за 1 день. Замовте налаштування кампанії або кастомної інтеграції з QuestN.

Орієнтири за термінами

Налаштування кампанії з вбудованими верифікаторами: кілька годин. Кастомний API верифікатор + деплой: 1-3 дні. Терміни уточнюються після аналізу — для складних сценаріїв може знадобитися до 5 днів.