Інтеграція 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 та поточної мобільної архітектури. Отримайте консультацію — ми безкоштовно оцінимо ваш проєкт та підберемо оптимальне рішення. Зв'яжіться з нами, щоб обговорити деталі інтеграції.