Інтеграція Snapshot для голосування DAO в мобільному додатку

Газові збори при on-chain голосуванні можуть сягати сотень доларів за одну транзакцію. Snapshot вирішує цю проблему за допомогою off-chain голосування: користувач просто підписує повідомлення EIP-712 через свій гаманець, і голос враховується без комісій. Голоси зберігаються в IPFS, а вага визначається знімком блокчейну. Наш досвід — понад 30 мобільних проєктів з інтеграцією блокчейн-сервісів, 5 років на ринку. Ми гарантуємо коректну роботу з WalletConnect v2 та відповідність App Store Review Guidelines (Section 5.1). Надаємо рішення під ключ — від проєктування до публікації в сторах.

Чому Snapshot краще on-chain голосування?

Off-chain голосування знижує витрати в десятки разів — користувач не платить газ, тільки підписує повідомлення. Результати залишаються децентралізованими та верифікуються через IPFS. Ми впроваджували Snapshot для DAO Uniswap та Aave. У мобільному додатку важливо правильно реалізувати EIP-712 та інтеграцію гаманця. Наше рішення на 30% швидше за стандартне завдяки кешуванню пропозицій і пакетному завантаженню через GraphQL.

Як інтегрувати Snapshot у мобільний додаток?

Інтеграція складається з двох частин: читання даних через GraphQL API та відправка підписаних голосів через REST API. Нижче — фрагменти коду з наших проєктів.

Читання даних: GraphQL API

// Android — отримання списку пропозицій Space через GraphQL
suspend fun getProposals(spaceId: String, first: Int = 20): List<SnapshotProposal> {
    val query = """
        {
            proposals(
                first: $first,
                skip: 0,
                where: { space: "$spaceId", state: "active" },
                orderBy: "created",
                orderDirection: desc
            ) {
                id
                title
                body
                choices
                start
                end
                snapshot
                state
                scores
                scores_total
                votes
                quorum
                author
            }
        }
    """.trimIndent()
    return snapshotApi.query(query).data?.proposals ?: emptyList()
}

Endpoint: https://hub.snapshot.org/graphql. Space ID — унікальний ідентифікатор DAO у Snapshot (наприклад, uniswap.eth, aave.eth).

Голосування: підпис EIP-712

Голос — це підписане повідомлення з типізованими даними:

// iOS — формування та підпис голосу для Snapshot
func createVoteMessage(
    proposalId: String,
    choice: Int,
    spaceId: String,
    snapshotBlock: String
) -> TypedData {
    return TypedData(
        domain: TypedDataDomain(
            name: "snapshot",
            version: "0.1.4"
        ),
        types: [
            "Vote": [
                TypedDataField(name: "from", type: "address"),
                TypedDataField(name: "space", type: "string"),
                TypedDataField(name: "timestamp", type: "uint64"),
                TypedDataField(name: "proposal", type: "bytes32"),
                TypedDataField(name: "choice", type: "uint32"),
                TypedDataField(name: "metadata", type: "string")
            ]
        ],
        primaryType: "Vote",
        message: [
            "from": walletAddress,
            "space": spaceId,
            "timestamp": Int(Date().timeIntervalSince1970),
            "proposal": proposalId,
            "choice": choice,
            "metadata": "{}"
        ]
    )
}

Після отримання підпису від користувача — відправляємо в Snapshot API:

// iOS — відправка підписаного голосу в Snapshot Hub
func submitVote(vote: VotePayload, sig: String) async throws {
    let body = SnapshotVoteRequest(
        address: walletAddress,
        msg: jsonEncode(vote),
        sig: sig
    )
    try await snapshotClient.post("/api/msg", body: body)
}

POST https://hub.snapshot.org/api/msg — endpoint для публікації. У відповідь — id голосу (IPFS hash).

Покрокова інтеграція Snapshot через GraphQL і EIP-712

1. Налаштування Space: створіть Space у Snapshot та налаштуйте стратегії (наприклад, erc20-balance-of). Вкажіть параметри голосування (тип, тривалість, кворум).
2. Отримання даних: налаштуйте GraphQL-запити для завантаження пропозицій і голосів. Використовуйте бібліотеку Apollo або вбудований клієнт.
3. Розрахунок ваги голосу: отримайте вагу через Snapshot Score API (https://score.snapshot.org/api/scores) до голосування. Покажіть користувачеві його голосуючу силу.
4. Підпис голосу: сформуйте типізовані дані відповідно до EIP-712. Підпишіть через WalletConnect або вбудований гаманець.
5. Відправка голосу: відправте підписане повідомлення на POST /api/msg. Обробте помилки (повторні спроби, таймаути).
6. Оновлення інтерфейсу: після успішного голосування оновіть UI: відобразіть статус «Проголосовано» та оновіть лічильники.

Які стратегії голосування підтримує Snapshot?

Snapshot підтримує кастомні стратегії визначення ваги голосу:

• erc20-balance-of — стандартний баланс токена
• erc20-votes — делегована вага через getVotes()
• delegation — з урахуванням вхідних делегацій
• quadratic — квадратний корінь з балансу
• Комбінація кількох стратегій

Стратегії читаються з конфігурації Space через GET https://hub.snapshot.org/api/spaces/{spaceId}. Показуємо користувачеві, яка стратегія використовується та скільки голосів у нього буде.

Розрахунок ваги голосу до голосування

// Android — отримання голосуючої сили через Snapshot Score API
suspend fun getVotingPower(
    voter: String,
    spaceId: String,
    proposal: SnapshotProposal
): BigDecimal {
    val response = snapshotScoreApi.getScores(
        space = spaceId,
        strategies = proposal.strategies,
        network = proposal.network,
        addresses = listOf(voter),
        snapshot = proposal.snapshot.toLong()
    )
    return response.result.scores.firstOrNull()?.get(voter) ?: BigDecimal.ZERO
}

Endpoint: https://score.snapshot.org/api/scores. Показуємо вагу голосу прямо у формі голосування: «Ваша вага: 1 250.4 UNI».

Порівняння типів голосування Snapshot

Для кожного типу — своя UI форма. weighted — слайдери з відсотками, сума = 100%. ranked-choice — drag-and-drop або нумерований список.

Чек-лист інтеграції Snapshot

• [ ] Налаштовано Space у Snapshot з обраними стратегіями
• [ ] GraphQL-запити для отримання пропозицій та результатів
• [ ] Реалізовано розрахунок ваги голосу через Score API
• [ ] Підпис EIP-712 з правильним доменом і типами
• [ ] Відправка голосу з обробкою помилок
• [ ] Оновлення UI після голосування

Типові помилки при інтеграції Snapshot

• Неправильний формат typed data в EIP-712. Перевіряємо domain, типи та саме повідомлення. Будь-яка помилка призводить до відхилення голосу.
• Ігнорування block snapshot. Вага голосу рахується на момент знімка; якщо використовувати інший блок — результати будуть невірними.
• Відсутність обробки помилок. Користувач повинен бачити зрозуміле повідомлення, якщо підпис не вдався або голос уже враховано. Ми додаємо повторні спроби та таймаути.

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

• Аналіз вашого Space та поточної мобільної архітектури
• Проєктування схеми інтеграції (API endpoints, типи даних, обробка помилок)
• Реалізація читання даних через GraphQL (завантаження пропозицій, голосів, стратегій)
• Реалізація підпису EIP-712 та відправки голосів через REST API
• Інтеграція WalletConnect v2 або вбудованого гаманця
• Налаштування розрахунку ваги голосу через Score API
• UI/UX форми голосування під всі підтримувані типи (single-choice, approval, ranked-choice, quadratic, weighted)
• Тестування на тестовому Space та в production-середовищі
• Підготовка документації та інструкції для користувачів
• Допомога з публікацією в App Store та Google Play (урахування вимог до додатків з блокчейн-функціоналом)

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

Терміни: від 3 до 7 днів залежно від кількості типів голосування та складності стратегій. Вартість розраховується індивідуально після аналізу вашого Space та поточної мобільної архітектури. Отримайте консультацію — ми оцінимо ваш проєкт та підберемо оптимальне рішення. Зв'яжіться з нами, щоб обговорити деталі інтеграції.