Інтеграція з платформою QuestN
QuestN — платформа для Web3 квестових кампаній, де користувачі виконують завдання (підписка в Twitter, транзакція в протоколі, холдинг токена) і отримують награди. Інтеграція потрібна проектам, які хочуть запустити кампанію на QuestN та автоматично верифікувати on-chain дії або розповсюджувати награди через їхні смарт-контракти.
Типи інтеграції
Вбудовані верифікатори QuestN покривають стандартні випадки: холдинг 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.
Розповсюдження наград
Для NFT-наград через QuestN: надайте контракт з функцією claim() та логікою whitelist, або використовуйте механізм merkle-proof. QuestN генерує список переможців — ви завантажуєте merkle root, користувачі робять claim самостійно.
Для токен-наград: QuestN може розповсюджувати через свій механізм (ви поповнюєте їхній escrow), або інтегрувати власний distributor-контракт і передати QuestN список адрес whitelist.
Ориентиры по срокам
Налаштування кампанії з вбудованими верифікаторами: кілька годин. Кастомний API верифікатор + розгортання: 1 день.