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