Інтеграція Alchemy Account Kit: розумні акаунти за 2 тижні

Проблема: користувач платить газ зі свого гаманця — бар'єр для масового прийняття

Кожного разу, коли новий користувач хоче mint NFT або обміняти токен у вашому dApp, він повинен мати ETH на гаманці для gas. Це відсікає до 80% аудиторії, яка не хоче морочитися з купівлею нативного токена. Alchemy Account Kit вирішує це завдання через Account Abstraction (ERC-4337): користувач може платити за газ у токенах, або ви спонсоруєте gas через Paymaster.

Ми впровадили Account Kit для кількох DeFi-протоколів та ігор. Результат: onboarding скорочується з 5 до 1 кліка, а конверсія реєстрацій зростає на 35-40%. Нижче розберемо, як ми це робимо — з кодом, таблицями та типовими підводними каменями.

Компоненти Alchemy Account Kit

Light Account — мінімалістична реалізація ERC-4337. Дешевша в деплої та використанні, ніж Safe. Підтримує: single owner, session keys, EIP-1271.

Modular Account — розширюваний акаунт на базі ERC-6900 (Modular Smart Account). Дозволяє додавати плагіни: multisig, spending limits, соціальне відновлення.

Gas Manager (Paymaster) — спонсорування газу з політиками: за сумою, за кількістю операцій, за whitelist адрес контрактів.

Alchemy Bundler — вбудований bundler з SLA 99.9% та підтримкою всіх major EVM ланцюгів.

Що вибрати: Light Account чи Modular Account?

Чому варто використовувати вбудований Alchemy Bundler?

Бандлер — найкритичніший компонент: він агрегує user operations, підписує та відправляє в мережу. Alchemy запускає власний bundler з SLA 99.9% та підтримкою всіх major L2 (Polygon, Arbitrum, Optimism, Base). Після налаштування синхронізація з мережею займає хвилини, а не дні. Для продакшену ми рекомендуємо саме його — так ви отримуєте гарантію uptime та пріоритетну підтримку.

Як налаштувати Gas Manager (Paymaster)?

Gas Manager дозволяє спонсорувати газ за допомогою політик. В Alchemy Dashboard ви створюєте policy, задаєте ліміти та отримуєте policyId. Приклад конфігурації:

import { createModularAccountAlchemyClient } from "@alchemy/aa-alchemy";
import { LocalAccountSigner, sepolia } from "@alchemy/aa-core";
import { http } from "viem";

const client = await createModularAccountAlchemyClient({
  apiKey: "YOUR_ALCHEMY_API_KEY",
  chain: sepolia,
  signer: LocalAccountSigner.privateKeyToAccountSigner(privateKey),
  gasManagerConfig: {
    policyId: "YOUR_GAS_POLICY_ID",
  },
});

// Відправка user operation без ETH на гаманці
const { hash } = await client.sendUserOperation({
  uo: {
    target: contractAddress,
    data: encodeFunctionData({ abi, functionName: "mint", args: [] }),
    value: 0n,
  },
});

await client.waitForUserOperationTransaction({ hash });

Після інтеграції користувач не помічає, що транзакція платна — все оплачується за рахунок dApp. Наші клієнти економлять до 40% на газі завдяки оптимальним політикам.

React хуки

Account Kit надає @alchemy/aa-alchemy/react з готовими хуками:

import {
  AlchemyAccountProvider,
  useSmartAccountClient,
  useSendUserOperation,
} from "@alchemy/aa-alchemy/react";

function MintButton() {
  const { client } = useSmartAccountClient({ type: "ModularAccount" });
  const { sendUserOperation, isSendingUserOperation } = useSendUserOperation({
    client,
    waitForTxn: true,
  });

  return (
    <button
      onClick={() =>
        sendUserOperation({
          uo: { target: NFT_ADDRESS, data: mintCalldata, value: 0n },
        })
      }
      disabled={isSendingUserOperation}
    >
      {isSendingUserOperation ? "Minting..." : "Mint NFT"}
    </button>
  );
}

Session Keys

Account Kit підтримує session keys — тимчасові ключі з обмеженими правами. Користувач один раз підтверджує створення session key, потім застосунок може виконувати транзакції без щоразу запитувати підпис:

const sessionKey = await client.createSessionKey({
  expirationTime: Math.floor(Date.now() / 1000) + 3600, // 1 година
  permissions: [
    {
      type: "contract",
      address: GAME_CONTRACT,
      functionSelectors: [MOVE_SELECTOR, ATTACK_SELECTOR], // тільки конкретні функції
    },
  ],
  spendingLimit: parseEther("0.01"), // максимум 0.01 ETH за сесію
});

Це особливо цінно для ігор та застосунків з частими дрібними транзакціями.

Як ми інтегруємо Account Kit: покроковий процес

Весь цикл займає 1-2 тижні. Включаємо документацію з прикладами коду та навчання команди.

Що входить в послугу

• Вибір та кастомізація smart account (Light або Modular) — під ключ
• Налаштування Gas Manager з політиками спонсорування
• Інтеграція з існуючим auth (email, social, Web3)
• Адаптація React UI під хуки Account Kit
• Тестування на testnet та mainnet
• Документація та сторібук компонентів

Ми виконали десятки інтеграцій для DeFi-протоколів та NFT-маркетплейсів. Alchemy Account Kit — зрілий інструмент, але вимагає глибокого розуміння ERC-4337. Оцінимо ваш проєкт безкоштовно — напишіть нам.

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

При інтеграції важливо уникати: використання LocalAccountSigner в production небезпечно — замініть на Web3Auth або WalletConnect; не забувайте про nonce management, відмінний від EOA; обов'язково тестуйте політики газ-менеджера, щоб уникнути перевищення бюджету. Ми враховуємо ці моменти в кожному проєкті.

Замовте інтеграцію вже сьогодні, щоб підвищити конверсію вашого dApp. Зв'яжіться з нами — обговоримо деталі.

Ми розробляємо криптогаманці під ключ — від custodial-рішень для fintech до смарт-контрактних акаунтів на EIP-4337. 5+ років на ринку блокчейн-розробки, 40+ реалізованих проектів. Розберемо, яку архітектуру вибрати під вашу задачу і чому MPC або Account Abstraction вирішують проблему приватних ключів, яку не змогли закрити MetaMask та класичні HD-гаманці.

Як обрати архітектуру гаманця?

Чому класичні гаманці небезпечні для бізнесу?

Seed-фраза у браузерному розширенні — єдиний спосіб відновити доступ. Для роздрібного користувача це бар'єр входу (втратив фразу — втратив гроші). Для корпоративного казначейства — несумісно з compliance (KYC/AML, рольова модель, мультипідпис). Будь-який витік одного ключа компрометує всі кошти. Ці ризики закладені в архітектуру, а не в поганий UX.

Ми усуваємо їх на рівні протоколу: MPC-гаманці (ключ ніколи не зібраний цілком), смарт-контрактні гаманці (логіка авторизації в коді), апаратні HSM для інституційного зберігання. Нижче — деталі.

Custodial vs Non-custodial: у чому реальна різниця

Custodial — провайдер зберігає приватний ключ. Користувач аутентифікується через email/password/OAuth. Відновлення тривіальне, KYC/AML вбудовані. Для централізованих додатків з фінансовими операціями — часто єдиний регуляторно прийнятний варіант. Ризик: single point of failure (злом Bitfinex — значні втрати, FTX — понад значну суму клієнтських коштів).

Non-custodial — ключі у користувача. Провайдер не має доступу до коштів. Відповідальність за зберігання лягає на користувача. Для 99% людей це непрацююча модель без додаткового захисту — тут і приходить MPC.

MPC-гаманці: ключ, якого немає

Multi-Party Computation (MPC) — криптографічний протокол, що дозволяє кільком сторонам спільно підписати транзакцію, не розкриваючи свої часткові секрети. Приватний ключ ніколи не існує в зібраному вигляді.

Стандартна схема: 2-of-3 MPC між користувачем (частка на пристрої), сервером провайдера та резервним хмарним сховищем. Транзакція підписується двома будь-якими з трьох сторін. Телефон втрачено — відновлення через сервер + хмару. Сервер скомпрометовано — атакуючий володіє лише однією часткою, підпис неможливий.

TSS (Threshold Signature Scheme) — конкретна реалізація MPC для ECDSA/EdDSA. Алгоритми: GG18, GG20, CGGMP21 (останній швидший і з кращими security proof). Бібліотеки: tss-lib (Go, від Binance), multi-party-sig (Go, від Coinbase), ZenGo-X/multi-party-ecdsa (Rust).

MPC не потребує on-chain змін — для блокчейна підпис виглядає як звичайний single-key підпис. Це дає економію gas та зберігає конфіденційність схеми управління ключами (не публікується в ланцюжку) — на відміну від мультисига.

Account Abstraction (EIP-4337): смарт-контракт як гаманець

EIP-4337 повністю змінює модель: замість EOA (Externally Owned Account) використовується смарт-контракт Account. Логіка авторизації — в коді контракту, а не в криптографії протоколу. Це відкриває довільну логіку підпису, соціальне відновлення, сесійні ключі, sponsored транзакції та батчинг операцій.

User → UserOperation → Bundler → EntryPoint contract → Account contract
                                          ↑
                                    Paymaster (optional, pays gas)

UserOperation — новий тип об'єкта (не L1-транзакція). Bundler збирає UserOps з альтернативного mempool, упаковує в одну транзакцію та відправляє в EntryPoint. EntryPoint викликає validateUserOp на Account контракті — Account сам вирішує, чи дійсний підпис.

Практичні можливості:

Соціальне відновлення. Контракт зберігає список guardian'ів (інші адреси або сервіс). Втрата ключа — guardians голосують за заміну. Argent використовує схему з 2020 року.

Сесійні ключі. Тимчасовий ключ з обмеженими правами: взаємодія лише з конкретним контрактом, до певної дати, до певної суми. Для GameFi та dApps — користувач не підписує кожну мікро-транзакцію.

Paymaster. Сторонній контракт платить газ за користувача. Паттерн для онбордингу: користувач не тримає ETH, газ спонсорує dApp або береться з ERC-20 токенів.

Реалізації: Safe{Core} Protocol, Biconomy SDK (Stackup), ZeroDev (Kernel), Alchemy (Rundler bundler). На Ethereum mainnet, Polygon, Arbitrum, Optimism EntryPoint v0.6/v0.7 задеплоєний та активний. Гарантуємо сумісність з останніми версіями контрактів.

Hardware Security Module для корпоративних гаманців

Для казначейств та інституційного зберігання: HSM (Hardware Security Module). Ключ генерується і ніколи не покидає захищений чип. Підпис — всередині HSM. Підтримується апаратна атестація. Використовувані рішення: AWS CloudHSM, Azure Dedicated HSM, Thales Luna, YubiHSM 2 (для невеликих обсягів). Інтеграція через PKCS#11 або cloud-specific API.

Комбінація HSM + MPC — оптимальна для інституційного використання: ключові частки зберігаються в HSM на різних серверах/юрисдикціях, підпис через TSS. Це забезпечує відповідність регуляторним вимогам (наприклад, для крипто-кастодіанів).

Інтеграція з dApps: WalletConnect та стандарти

Будь-який гаманець повинен вміти взаємодіяти з dApps. Стандарт — WalletConnect v2 (Sign API): QR-код або deep link, peer-to-peer зашифрований канал через relay сервер. Для браузерних розширень — EIP-1193 (Ethereum Provider API).

На фронтенді використовуємо wagmi + viem — один інтерфейс для MetaMask, WalletConnect, Coinbase Wallet, injected providers. Для Account Abstraction — EIP-5792 (wallet capabilities) та EIP-7677 (paymaster service).

Процес розробки

1. Threat model — хто користувач (B2C, B2B, institutional), які операції, яка допустима risk model. Від цього залежить архітектура.
2. Вибір та проектування схеми зберігання ключів — MPC, HSM, мультисиг або їх комбінація.
3. Розробка Account контракту (якщо EIP-4337) або інтеграція MPC-бібліотеки.
4. Backend — MPC-координація, управління сесіями, paymaster-сервіс (якщо потрібен).
5. Мобільний/браузерний застосунок — UI з інтеграцією WalletConnect, біометрії, QR.
6. Інтеграція з dApps — EIP-1193, WalletConnect v2.
7. Аудит контрактів та криптографічних реалізацій — обов'язковий етап. MPC-бібліотеки мають відомі вразливості (GG18 піддається атаці при malicious participant без abort protocol). Використовуємо бібліотеки з актуальними security review (CGGMP21). Досвід проходження аудитів у Certik, Hacken, Trail of Bits — підтверджуємо сертифікатами.

Що входить в роботу (deliverables)

• Вихідні коди смарт-контрактів (Solidity/Rust) з документацією
• Backend-сервіс MPC-координації (на Go або Rust) з API
• Мобільний застосунок (iOS/Android) або браузерне розширення
• Інтеграція з WalletConnect, Ledger/Trezor (за потреби)
• Підготовка до аудиту безпеки (звіт зі списком вразливостей)
• Документація адміністратора та користувача
• Доступ до репозиторію, CI/CD, моніторинг (Tenderly, Etherscan API)
• Навчання вашої команди (2-3 сесії)
• Підтримка після запуску — 1 місяць

Строки та вартість

Вартість розраховується індивідуально під ваш проект. Оцінимо за 1 день — зв'яжіться з нами. Надаємо гарантію на код та timeline.

Типові помилки при розробці криптогаманців (і як їх уникнути)

• Використання застарілих MPC-бібліотек — GG18 без abort protocol. Обираємо CGGMP21 або tss-lib з актуальними audit report.
• Жорстка прив'язка до одного блокчейну — не закладають абстракцію під L2/сайдчейни. Використовуємо viem/wagmi для кросс-чейн.
• Ігнорування MEV-атак — при використанні мультисига без таймлоків. Додаємо tx simulation (Tenderly) та sandwitching protection.
• Відсутність fallback-механізму відновлення — для Account Abstraction не налаштовують social recovery. Закладаємо з першого релізу.

Усуваємо ці граблі на етапі проектування — під кожен проект складаємо threat model та security checklist.

Потрібен надійний гаманець без компромісів? Отримайте консультацію нашого архітектора — розберемо вашу задачу та запропонуємо архітектуру з точним кошторисом. Залишайте заявку — відповімо протягом дня.