Интеграция с Galxe (quest-платформа)
Galxe — крупнейшая Web3 quest-платформа с 20+ миллионами пользователей. Используется для on-chain верификации выполнения задач: подписка на Twitter, участие в governance голосованиях, использование протокола, холдинг токенов. Интеграция нужна проектам, которые хотят раздать OAT (On-chain Achievement Token) или credential своим пользователям через стандартную инфраструктуру, а не строить собственную.
Два режима интеграции
Subgraph-based верификация — Galxe сам читает данные из subgraph, который вы деплоите на The Graph. Подходит для on-chain действий: транзакции, swap'ы, liquidity provision. Вы пишете GraphQL-схему и маппинги, деплоите subgraph, передаёте его URL в настройках кампании в Galxe Dashboard.
API-based верификация — вы предоставляете HTTPS endpoint, который Galxe вызывает с адресом кошелька пользователя. Ответ: {"is_eligible": true/false}. Подходит для любой кастомной логики — off-chain данные, комбинированные условия, whitelist-файлы. Endpoint должен быть доступен публично и отвечать за <5 секунд.
// Пример верификационного endpoint (Express)
app.get('/galxe/verify', async (req, res) => {
const { address } = req.query;
const eligible = await checkEligibility(address as string);
res.json({ is_eligible: eligible });
});
Galxe не передаёт никакой авторизации в запросе — если нужна защита от прямого опроса, добавляйте shared secret через query param или IP whitelist (Galxe предоставляет список своих IP).
Credential и OAT
После верификации Galxe выпускает Credential — off-chain запись о достижении пользователя. На его основе можно настроить выдачу OAT (Soul-bound NFT на Galxe Chain) или допуск к следующим квестам.
Для кастомных NFT-наград вместо OAT используется интеграция через Galxe Smart Contract — контракт вашего проекта деплоится, Galxe вызывает claim() от имени пользователя по завершению квеста. Это требует отдельной настройки в Galxe Business Dashboard и верификации контракта.
Практические моменты
Galxe Dashboard достаточно интуитивен для настройки базовых кампаний без API. Разработка нужна в двух случаях: кастомный верификационный endpoint и интеграция Galxe Points / Galxe ID в собственный фронтенд через Galxe GraphQL API (https://graphigo.prd.galaxy.eco/query). API позволяет читать данные о пользователе, его credential'ах и достижениях для отображения в вашем dApp.