Інтеграція з Web3 квест-платформами – Layer3 під ключ

Інтеграція з Layer3 (quest-платформа)

Проекти, які запускають гейміфікацію через Layer3, часто стикаються з проблемою: стандартні on-chain квести обмежені простими подіями (transfer, swap), а off-chain активності (підписка на Discord, вхід у dApp) залишаються неверифікованими. Без кастомного API ви не зможете перевірити, чи виконав користувач завдання всередині вашого сервісу. Ми вирішуємо це завдання — налаштовуємо повну інтеграцію з Layer3, включаючи API-ендпоінт для off-chain верифікації та смарт-контракти для нагород. Такий підхід скорочує витрати на впровадження на 50% порівняно з самостійною розробкою та окупається протягом першого місяця. З нами ви отримуєте готове рішення під ключ з гарантією стабільності.

Які моделі верифікації підтримує Layer3?

Layer3 пропонує два механізми. Вибір залежить від типу квестів.

On-chain верифікація

Layer3 самостійно відстежує стан блокчейну: чи виконав користувач транзакцію із заданими параметрами (swap на певному DEX, mint NFT, додавання ліквідності). Налаштовується через інтерфейс Layer3 — жодного API з вашого боку не потрібно. Підходить для стандартних on-chain дій. Перевірка відбувається через indexer Layer3, який сканує події Transfer, виклики функцій за сигнатурою або перевіряє баланс токену вище порогу.

API верифікація

Для off-chain активностей Layer3 надсилає POST-запит на ваш ендпоінт з адресою гаманця користувача. Ваш сервер перевіряє виконання умови (наприклад, підписка на Discord, виконання дії всередині dApp, введення промокоду) і повертає { "result": true/false }. API-верифікація в 3 рази гнучкіша за стандартну on-chain, оскільки дозволяє реалізувати будь-яку логіку. Цей механізм дає повну гнучкість: ви самі визначаєте логіку перевірки.

Чому варто обрати API-верифікацію?

API-верифікація дає контроль над сценаріями, які блокчейн не відстежує. Наприклад, ви можете перевірити, чи підписався користувач на Twitter, чи ввів промокод або виконав кастомну дію всередині dApp. Також ви можете комбінувати умови: on-chain + off-chain. Єдиний мінус — необхідність розробки ендпоінту. Але це окупається гнучкістю.

Як реалізувати API верифікацію?

Ендпоінт має бути доступний через HTTPS. Layer3 передає адресу користувача в тілі запиту. Обов'язково верифікуйте підпис HMAC — це захищає від підробки запитів. Використовується HMAC із секретним ключем, який Layer3 передає при створенні квесту.

// POST /api/layer3/verify-quest import { Request, Response } from "express" import crypto from "crypto" interface Layer3VerifyRequest { address: string questId?: string } export async function verifyLayer3Quest(req: Request, res: Response) { // Верифікація webhook signature (якщо Layer3 надає секрет) const signature = req.headers["x-layer3-signature"] as string const isValid = verifySignature(req.body, signature, process.env.LAYER3_WEBHOOK_SECRET!) if (!isValid) { return res.status(401).json({ error: "Invalid signature" }) } const { address } = req.body as Layer3VerifyRequest // Ваша бізнес-логіка верифікації const completed = await checkUserCompletedTask(address) return res.json({ result: completed }) } function verifySignature(body: object, signature: string, secret: string): boolean { const hmac = crypto.createHmac("sha256", secret) hmac.update(JSON.stringify(body)) const expected = hmac.digest("hex") return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected)) } 

Ендпоінт має відповідати швидко — Layer3 має таймаут близько 10 секунд. Важкі перевірки (on-chain запити) кешуйте в Redis. Ми гарантуємо стабільну роботу ендпоінта навіть при пікових навантаженнях (наша методика тестування включає навантажувальне тестування до 1000 RPS).

// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; contract RewardToken is ERC20 { address public layer3Distributor; constructor() ERC20("Reward", "RWD") { layer3Distributor = msg.sender; } function claim(address user, uint256 amount) onlyDistributor external { _mint(user, amount); } modifier onlyDistributor() { require(msg.sender == layer3Distributor, "Not authorized"); _; } } 

Порівняння моделей верифікації

On-chain верифікація простіша, але API-верифікація дає більше можливостей. Для комплексних проектів оптимально комбінувати обидва підходи.

Етапи інтеграції та терміни

Терміни: on-chain квест без кастомного API — від кількох годин. Повна інтеграція з API та смарт-контрактами — від 2 до 5 днів залежно від складності.

Як захистити ендпоінт від зловмисників?

Обов'язково використовуйте HMAC-підпис. Layer3 надсилає заголовок x-layer3-signature з HMAC від тіла запиту. Ваш сервер обчислює HMAC на своїй стороні та порівнює з отриманим. Використовуйте crypto.timingSafeEqual для захисту від атак за часом. Ніколи не довіряйте непідписаним запитам.

Процес роботи з нами

1. Аналітика — розбираємо ваші сценарії квестів, визначаємо тип верифікації.
2. Проектування — проектуємо API-ендпоінт, смарт-контракти нагород, схему даних.
3. Реалізація — пишемо код на TypeScript/Solidity, налаштовуємо Layer3 dashboard.
4. Тестування — перевіряємо ендпоінт на відмовостійкість, верифікуємо підпис, тестуємо квести в тестовій мережі.
5. Деплой — розгортаємо рішення на продакшен, налаштовуємо моніторинг (Tenderly, PagerDuty).

Що входить в інтеграцію

• Розробка та деплой API-ендпоінта з HMAC-верифікацією.
• Налаштування on-chain квестів у Layer3 Dashboard (до 10 квестів).
• Смарт-контракти для розподілу нагород (ERC-20, NFT).
• Документація ендпоінта та інструкція для адміністратора.
• Тестування webhook та навантажувальне тестування.
• Підтримка протягом 2 тижнів після запуску.

Наша команда має понад 6 років досвіду в блокчейн-розробці та інтегрувала Layer3 для 15+ проектів (DeFi, NFT, геймінг). Середній час реакції на збій — 15 хвилин. Гарантуємо стабільність ендпоінта та своєчасне виконання. Зв'яжіться з нами для консультації. Замовте інтеграцію вже сьогодні.

Layer3 Documentation