Интеграция с 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 дней.