Представьте: игрок в хардкорный экшен должен в разгар битвы открыть MetaMask и подтвердить транзакцию на покупку зелья. В 80% случаев он либо провалит миссию, либо разочаруется в процессе. Наша задача — убрать этот разрыв, сделав криптотранзакции невидимыми для геймплея. Мы интегрировали блокчейн-кошельки в более чем 50 игровых проектов — от инди до AAA, с 6-летним опытом в GameFi. Пользователи приходят играть, а не разбираться с gas, approve и seed phrases. Разберём конкретные паттерны для разных типов игр: от WebGL на Unity до мобильных билдов с WalletConnect.
Как выбрать метод интеграции блокчейн-кошелька?
Внешние кошельки (MetaMask, Phantom)
Стандарт для аудитории, уже знакомой с криптой. Через Wagmi (React) или WalletConnect AppKit подключение выглядит так:
import { useConnect, useAccount } from "wagmi"; import { injected, walletConnect } from "wagmi/connectors"; function WalletConnect() { const { connect, connectors } = useConnect(); const { address, isConnected } = useAccount(); if (isConnected) return <GameLobby address={address} />; return ( <div> <button onClick={() => connect({ connector: injected() })}>MetaMask</button> <button onClick={() => connect({ connector: walletConnect({ projectId: WC_PROJECT_ID }) })}>WalletConnect</button> </div> ); } Embedded wallets — для массовой аудитории
Для casual игр — пользователи не хотят устанавливать расширения. Embedded wallet создаётся автоматически при регистрации через Google/Apple, используя SDK вроде Web3Auth или Privy. Игра получает готовый адрес без установки кошелька. Это снижает конверсию потери на 40% по сравнению с требованием установки расширения.
Session keys: взаимодействие без подписи каждый раз
Главная UX-проблема GameFi — каждое действие требует подписи в MetaMask. Session keys решают это: пользователь один раз авторизует сессионный ключ, игра использует его для транзакций автоматически. На практике мы реализовали это через ZeroDev SDK для пошаговой RPG — количество подписей на игрока снизилось с 10 до 1 за сессию (в 10 раз быстрее).
import { createKernelAccountClient, toPermissionValidator, toCallPolicy } from "@zerodev/sdk"; const sessionPrivateKey = generatePrivateKey(); const sessionAccount = privateKeyToAccount(sessionPrivateKey); const callPolicy = toCallPolicy({ permissions: [{ target: GAME_CONTRACT_ADDRESS, functionName: "claimReward", }, { target: GAME_CONTRACT_ADDRESS, functionName: "useItem", }] }); const permissionValidator = await toPermissionValidator(publicClient, { signer: sessionAccount, policies: [callPolicy], validUntil: Math.floor(Date.now() / 1000) + 3600, }); const kernelClient = await createKernelAccountClient({ account: kernelAccount }); Unity интеграция: WebGL и Mobile
WebGL: JSLib bridge
В Unity WebGL нет прямого доступа к MetaMask — нужен JavaScript bridge. Мы используем готовую обёртку для вызова ethereum API:
// Plugins/WebGL/wallet.jslib mergeInto(LibraryManager.library, { ConnectWallet: async function() { if (typeof window.ethereum === 'undefined') alert('MetaMask not installed'); const accounts = await window.ethereum.request({ method: 'eth_requestAccounts' }); unityInstance.SendMessage('WalletManager', 'OnWalletConnected', accounts[0]); }, SignMessage: async function(messagePtr) { const message = UTF8ToString(messagePtr); const accounts = await window.ethereum.request({ method: 'eth_accounts' }); const signature = await window.ethereum.request({ method: 'personal_sign', params: [message, accounts[0]] }); unityInstance.SendMessage('WalletManager', 'OnMessageSigned', signature); } }); На стороне C# достаточно обернуть это в MonoBehaviour:
using System.Runtime.InteropServices; public class WalletManager : MonoBehaviour { [DllImport("__Internal")] private static extern void ConnectWallet(); [DllImport("__Internal")] private static extern void SignMessage(string message); public string ConnectedAddress { get; private set; } public void Connect() { #if UNITY_WEBGL && !UNITY_EDITOR ConnectWallet(); #endif } public void OnWalletConnected(string address) { ConnectedAddress = address; GameEvents.WalletConnected?.Invoke(address); } } Mobile: WalletConnect deep links
На мобильном Unity используем WalletConnect Sharp для открытия приложения кошелька через deep link. Это протестировано на iOS и Android — пользователь переходит в MetaMask или Trust Wallet и возвращается в игру после подписи.
Почему важна обработка транзакций в игровом контексте?
Optimistic UI updates
Ждать finality транзакции (10–30 секунд на L2, минуты на mainnet) в игре неприемлемо. Мы применяем optimistic updates: показываем результат немедленно, откатываем если транзакция фейлится. Это стандарт в нашей практике — ни один игрок не должен видеть "Pending..." дольше 2 секунд.
Account Abstraction бьёт батчингом
Account Abstraction позволяет отправить несколько операций в одной транзакции. Вместо approve + buy (2 подписи) — один multicall. Средняя экономия на gas составляет 30-50%:
const txHash = await smartAccountClient.sendUserOperation({ calls: [ { to: TOKEN_ADDRESS, abi: erc20Abi, functionName: "approve", args: [MARKETPLACE_ADDRESS, price] }, { to: MARKETPLACE_ADDRESS, abi: marketplaceAbi, functionName: "buyItem", args: [itemId] }, ], }); Сравнение: session keys vs стандартные подписи
| Параметр | Стандартная подпись | Session keys |
|---|---|---|
| Количество кликов на операцию | 2-3 (popup + confirm) | 0 (автоматически) |
| UX в быстрой игре | Катастрофа (отвлекает) | Плавный |
| Безопасность | Полный доступ | Ограниченный (scope) |
| Время настройки | Минуты | Часы (конфигурация политик) |
Session keys — выбор для Action/RPG с высокой частотой транзакций. Для кэжуал (одна транзакция в час) достаточно embedded wallet.
Что такое session keys и как они работают?
Session keys — это механизм, при котором пользователь подписывает сессионный ключ с ограниченными правами (например, только на функции claimReward и useItem). Ключ хранится в игре и используется для автоматической отправки транзакций в течение заданного времени. В нашем кейсе с RPG время настройки политик заняло 2 дня, но результат — 10-кратное ускорение взаимодействия.
Как мы это делаем: процесс интеграции за 4 шага
- Анализ архитектуры — выбираем метод подключения под платформу (WebGL, mobile, desktop) с учётом целевой аудитории.
- Реализация подключения — интеграция Wagmi/WalletConnect или embedded SDK.
- Настройка session keys — если требуется частая отправка транзакций, конфигурируем политики и срок действия ключей.
- UI/UX для транзакций — optimistic updates, pending-индикаторы, recovery после ошибок. Тестируем все кейсы: отказ, network switch, gas failure.
Что входит в интеграцию
- Разработка API-обёрток для взаимодействия с кошельками
- Документация по интеграции SDK и конфигурации
- Обучение команды заказчика (2-3 рабочих дня)
- Тестовая среда с mock транзакциями
- Поддержка в течение 2 недель после релиза
Сроки — от 2 недель (базовая интеграция) до 2 месяцев (полный цикл с session keys и account abstraction). Стоимость рассчитывается индивидуально. Свяжитесь с нами для предварительной оценки вашего проекта. Закажите интеграцию — получите игру, где криптотранзакции стали невидимыми.
Мы сталкивались с типичными проблемами: закрытие MetaMask popup, ошибки gas estimation, несоответствие сети и отклонение транзакции. Для каждой есть решение: очередь транзакций, статические лимиты газа с fallback RPC, автоматическое переключение сети через wallet_switchEthereumChain и корректная обработка отмены. Ключевой принцип: блокчейн асинхронен, игра — синхронна. Мы проектируем UI так, чтобы pending состояние было явным, а failure — recoverable. Получите консультацию по вашей игре — сделаем ваш GameFi проект дружелюбным для миллионов игроков.