Інтеграція Guild.xyz: ролі за NFT та токенами

Ручна видача ролей у чатах — пекло для модераторів. Користувачі чекають годинами, помиляються з гаманцями, а підтримка тоне в заявках. Ми автоматизуємо це через Guild.xyz: чіпляємо гаманець — і умови перевіряються on-chain за секунди. Тримаєш 100 токенів ERC-20 — отримуєш роль у Discord. Маєш NFT колекції — відкривається Telegram. Жодного ручного вайтлістингу. Найголовніше — безпека: контракти проходять аудит, дані не зберігаються на сторонніх серверах. Guild підтримує крос-чейн верифікацію, що критично для мультимережевих спільнот на кшталт DAO на Arbitrum і Polygon.

Налаштування базового гейта займає від години під ключ. Для нестандартних сценаріїв пишемо кастомні контракти та використовуємо SDK. Нижче — як це працює і що ви отримаєте.

Базове налаштування через Guild UI

Більшість кейсів вирішується без коду. Створюєте Guild, прив'язуєте Discord або Telegram, задаєте умови — і посилання готове. Користувач підключає гаманець, Guild верифікує та видає роль. Підтримувані платформи:

Умови з коробки: ERC-20 balance, ERC-721 ownership, ERC-1155 balance, стейкінг баланси, POAP, Snapshot голосування. Все налаштовується через веб-інтерфейс.

Як налаштувати кастомні умови через Guild API?

Для нестандартних критеріїв — складна логіка, зовнішні дані — використовуємо API. Деплоїмо контракт з методом перевірки, реєструємо його в Guild. Приклад — доступ тільки якщо користувач здійснив >= 5 транзакцій з контрактом:

// Guild Custom Contract Check
// Контракт-верифікатор
contract ActivityChecker {
    mapping(address => uint256) public interactionCount;

    function checkEligibility(address user) external view returns (bool) {
        return interactionCount[user] >= 5;
    }
}

// Конфігурація в Guild:
// {
//   "type": "CONTRACT",
//   "chain": "ETHEREUM",
//   "address": "0x...",
//   "abi": [...],
//   "method": "checkEligibility",
//   "params": ["{user_address}"],
//   "returnIndex": 0,
//   "expected": true
// }

Плейсхолдер {user_address} підставляється автоматично. Так можна перевіряти що завгодно: мінімальний обсяг торгів, участь у стейкінгу, кількість транзакцій.

Приклад: доступ для стейкерів

Якщо потрібно дати роль тільки тим, хто застейкав щонайменше 500 токенів у пулі, контракт перевіряє баланс стейкінгу. Guild підставить адресу користувача та викличе метод stakedBalance(address). Все працює без додаткових дій користувача.

З нашої практики: клієнт — NFT-маркетплейс — хотів давати доступ до пресейл-чату тільки тим, хто зробив мінімум 3 покупки на платформі. Ми написали контракт ActivityChecker, інтегрували через API. Результат — ручна модерація пішла в нуль, час видачі ролі скоротився з 2 годин до 10 секунд.

Чому Guild.xyz зручніший за кастомний access control?

Написати власний контракт-гейт можна, але це тижні розробки + аудит + підтримка. Guild дає коробку: верифікація, логування, масштабування, крос-чейн. Ви платите тільки за підписку Guild (якщо потрібна) і нашу інтеграцію. Економія часу — до 10 разів. Ми маємо великий досвід у таких проєктах і гарантуємо надійність рішення.

Складові умови (AND/OR)

{
  "logic": "AND",
  "requirements": [
    {
      "type": "ERC20",
      "address": "0xTokenAddress",
      "chain": "POLYGON",
      "data": {
        "minAmount": "100"
      }
    },
    {
      "type": "ERC721",
      "address": "0xNFTAddress",
      "chain": "POLYGON"
    }
  ]
}

Це покриває DAO-сценарії: «володіє токеном І membership NFT», «голосував у Snapshot АБО тримає стейк». Можна комбінувати до 10 умов.

Інтеграція через Guild SDK

import { createGuildClient } from "@guildxyz/sdk";

const guild = createGuildClient("my-app-name");

// Створення ролі програмно
const role = await guild.role.create(guildId, signer, {
  name: "Token Holder",
  requirements: [
    {
      type: "ERC20",
      chain: "ETHEREUM",
      address: tokenAddress,
      data: {
        minAmount: "1000"
      }
    }
  ]
});

// Перевірка eligibility користувача
const access = await guild.user.getMemberships(userAddress);

SDK зручний для динаміки: змінюєте умови при зміні tokenomics або milestone-ів без ручного редагування в UI. Детальніше читайте в Guild.xyz SDK documentation.

Типові кейси

Процес роботи

1. Аналіз — розбираємо ваші вимоги: які умови, платформи, кількість користувачів.
2. Проектування — вибираємо схему: UI/API/SDK, пишемо контракти, якщо потрібні кастомні.
3. Реалізація — налаштовуємо Guild, деплоїмо контракти, інтегруємо з вашим ботом або сайтом.
4. Тестування — перевіряємо всі сценарії: позитивні, граничні, reentrancy (для контрактів).
5. Деплой — запускаємо, навчаємо вашу команду, передаємо документацію.

Терміни та орієнтовна вартість

Базовий гейт (1–2 умови, одна платформа) — від 1 дня. Складна інтеграція з кастомними контрактами та SDK — до 5 днів. Точну оцінку даємо після брифу — заповніть форму на сайті, ми розрахуємо за 24 години.

Що входить у роботу

• Налаштування Guild.xyz (акаунт, ролі, платформи)
• Написання та деплой кастомних контрактів (якщо потрібно)
• Інтеграція через SDK (якщо потрібне динамічне керування)
• Тестування всіх умов та сценаріїв
• Документація для вашої команди
• 30 днів підтримки після запуску

Готові автоматизувати доступ? Зв'яжіться з нами — обговоримо ваш проєкт. Отримайте консультацію з token-gating.