Інтеграція з Privy

Privy Інтеграція

Privy — це бібліотека для onboarding користувачів у Web3 застосунки без вимоги мати крипто гаманець. Користувач входить через email, Google, Twitter, Discord або номер телефону — Privy створює для нього embedded wallet за кулісами. Crypto-native користувачі підключають MetaMask, Coinbase Wallet, WalletConnect як зазвичай. Обидві групи працюють в одному застосунку.

Ключове рішення Privy: embedded wallet зберігається в браузері користувача через threshold encryption, де один shard у Privy (в їхньому HSM), один у користувача (в localStorage, захищений passprase). Приватний ключ не покидає клієнт у plaintext, Privy не має доступу до коштів.

Швидка інтеграція

Встановлення та базова настройка:

npm install @privy-io/react-auth

import { PrivyProvider } from '@privy-io/react-auth'

export default function App() {
    return (
        <PrivyProvider
            appId="your-privy-app-id"
            config={{
                loginMethods: ['email', 'google', 'wallet'],
                appearance: { theme: 'dark', accentColor: '#6366f1' },
                embeddedWallets: {
                    createOnLogin: 'users-without-wallets', // автостворення для email/social users
                    noPromptOnSignature: false,
                },
                defaultChain: base,
                supportedChains: [mainnet, base, arbitrum],
            }}
        >
            {children}
        </PrivyProvider>
    )
}

import { usePrivy, useWallets } from '@privy-io/react-auth'

function WalletButton() {
    const { login, authenticated, user, logout } = usePrivy()
    const { wallets } = useWallets()

    if (!authenticated) return <button onClick={login}>Увійти</button>

    const embeddedWallet = wallets.find(w => w.walletClientType === 'privy')
    const externalWallet = wallets.find(w => w.walletClientType !== 'privy')

    return <div>{user.email?.address} — {embeddedWallet?.address}</div>
}

Коли використовувати Privy

Privy оптимальний для застосунків, де цільова аудиторія — не crypto-native користувачі. Gaming, social apps, loyalty програми, NFT маркетплейси для масової аудиторії. Якщо аудиторія — DeFi трейдери або developers — стандартного WalletConnect достатньо.

Обмеження: Privy — централізований сервіс ($0 до 100 MAU, далі платно). Embedded wallet залежить від доступності Privy інфраструктури. Для застосунків з вимогою до decentralization — потрібні альтернативи (Dynamic.xyz, Web3Auth, Turnkey).

Інтеграція Privy у існуючий React проект — 1–3 дні. Кастомний UI та backend верифікація користувачів — ще 2–5 днів.