Інтеграція з 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.