# Privy Privy provides authentication, embedded wallets, external wallet connections, and programmable wallet controls for apps built on crypto rails. This file maps the documentation so AI agents can find the right page for any integration task. ## Additional agent resources - Agent skill (structured workflows and common mistakes): `npx skills add https://docs.privy.io` - MCP server (live documentation search): `https://docs.privy.io/mcp` - Full agent index (all 700+ pages with descriptions): https://docs.privy.io/llms-full.txt - OpenAPI spec (REST API schema): https://api.privy.io/v1/openapi.json - Sitemap: https://docs.privy.io/sitemap.xml - Setup instructions: https://docs.privy.io/basics/get-started/using-llms ## Choosing an integration path - Use Privy authentication plus a client SDK for the fastest path to user onboarding and embedded wallets. - Use JWT-based authentication if you already have auth and only want Privy wallets. - Use external wallet connectors if users should bring MetaMask, Phantom, or other existing wallets. - Use a server SDK or the REST API with authorization keys and policies for backend automation, treasury systems, and agent wallets. ## Start here - [About Privy](https://docs.privy.io/basics/get-started/about): Overview of authentication and wallet infrastructure. - [Key concepts](https://docs.privy.io/basics/key-concepts): How authentication, wallets, and controls fit together. - [Platforms](https://docs.privy.io/basics/get-started/platforms): Supported platforms and SDKs. ## Quickstarts - [React](https://docs.privy.io/basics/react/quickstart): Authenticate users, create embedded wallets, send transactions. - [React setup](https://docs.privy.io/basics/react/setup): Initialize `PrivyProvider`, configure app IDs, enable automatic wallet creation. - [React Native](https://docs.privy.io/basics/react-native/quickstart): Embedded wallets in React Native apps. - [Swift](https://docs.privy.io/basics/swift/quickstart): Native iOS authentication and embedded wallets. - [Android](https://docs.privy.io/basics/android/quickstart): Native Android authentication and embedded wallets. - [Flutter](https://docs.privy.io/basics/flutter/quickstart): Flutter integration for authentication and wallets. - [Unity](https://docs.privy.io/basics/unity/quickstart): Unity integration for games and XR apps. - [Node.js](https://docs.privy.io/basics/nodeJS/quickstart): Backend wallets, signing, and transactions with `@privy-io/node`. - [Go](https://docs.privy.io/basics/go/quickstart): Go server SDK for wallet operations. - [Ruby](https://docs.privy.io/basics/ruby/quickstart): Ruby server SDK for wallet operations. - [Rust](https://docs.privy.io/basics/rust/quickstart): Rust server SDK for wallet operations. - [Java](https://docs.privy.io/basics/java/quickstart): Java server SDK for wallet operations. - [REST API](https://docs.privy.io/basics/rest-api/quickstart): HTTP-based integration for any language. ## Authentication - [Authentication overview](https://docs.privy.io/authentication/overview): Login methods, auth flows, and API authentication. - [Authentication state](https://docs.privy.io/authentication/user-authentication/authentication-state): `ready`, `authenticated`, and client-side lifecycle. - [Auth tokens](https://docs.privy.io/authentication/user-authentication/tokens): Session and auth token concepts. - [Access tokens](https://docs.privy.io/authentication/user-authentication/access-tokens): Backend validation of authenticated users. - [Login methods — email](https://docs.privy.io/authentication/user-authentication/login-methods/email): Email-based login. - [MFA overview](https://docs.privy.io/authentication/user-authentication/mfa/overview): Multi-factor authentication setup and enrollment. - [JWT-based auth overview](https://docs.privy.io/authentication/user-authentication/jwt-based-auth/overview): Use your existing auth provider with Privy wallets. - [JWT setup](https://docs.privy.io/authentication/user-authentication/jwt-based-auth/setup): Configure Privy to trust your external auth provider. - [JWT usage](https://docs.privy.io/authentication/user-authentication/jwt-based-auth/usage): Client and backend JWT integration. ## Wallets - [Wallets overview](https://docs.privy.io/wallets/overview): All wallet types, capabilities, and transaction flows. - [Wallet types](https://docs.privy.io/wallets/overview/types): Embedded, server, and external wallet models. - [Embedded wallets](https://docs.privy.io/wallets/overview/embedded): User-facing embedded wallet experience. - [Flexible custody](https://docs.privy.io/wallets/overview/flexible-custody): Custody model options. - [Supported chains](https://docs.privy.io/wallets/overview/chains): Networks supported across wallet infrastructure. - [Create a wallet](https://docs.privy.io/wallets/wallets/create/create-a-wallet): Wallet creation for user-owned and application-controlled wallets. - [Server-side wallet access](https://docs.privy.io/wallets/wallets/server-side-access): Use wallets from your backend. - [Update a wallet](https://docs.privy.io/wallets/wallets/update-a-wallet): Change ownership, policies, or configuration. - [Import a wallet (private key)](https://docs.privy.io/wallets/wallets/import-a-wallet/private-key): Import existing wallets. - [Import HD wallets](https://docs.privy.io/wallets/wallets/import-a-wallet/hd-wallets): Import hierarchical deterministic wallets. - [Export a wallet](https://docs.privy.io/wallets/wallets/export): Let users export their private key. - [Programmatic export](https://docs.privy.io/wallets/wallets/programmatic-export): Export wallet keys programmatically. ### Using wallets - [Using wallets overview](https://docs.privy.io/wallets/using-wallets/overview): Signing, sending, and interacting with wallets. - [RPC requests](https://docs.privy.io/wallets/using-wallets/rpc): Send arbitrary RPC calls through wallets. - [EVM — send a transaction](https://docs.privy.io/wallets/using-wallets/ethereum/send-a-transaction): Send Ethereum transactions. - [EVM — sign a message](https://docs.privy.io/wallets/using-wallets/ethereum/sign-a-message): Sign messages on EVM chains. - [EVM — sign typed data](https://docs.privy.io/wallets/using-wallets/ethereum/sign-typed-data): EIP-712 typed data signing. - [EVM — Ethereum provider](https://docs.privy.io/wallets/using-wallets/ethereum/ethereum-provider): Access the injected provider. - [EVM — web3 integrations](https://docs.privy.io/wallets/using-wallets/ethereum/web3-integrations): Use with wagmi, viem, ethers. - [Solana — send a transaction](https://docs.privy.io/wallets/using-wallets/solana/send-a-transaction): Send Solana transactions. - [Solana — sign a message](https://docs.privy.io/wallets/using-wallets/solana/sign-a-message): Sign messages on Solana. - [Bitcoin — sign transaction inputs](https://docs.privy.io/wallets/using-wallets/bitcoin/sign-transaction-inputs): Bitcoin PSBT signing. - [UI components](https://docs.privy.io/wallets/using-wallets/ui-components): Prebuilt UI for funding, sending, and managing wallets. - [Smart wallets overview](https://docs.privy.io/wallets/using-wallets/evm-smart-wallets/overview): ERC-4337 smart account wallets. ### Signers (delegated access) - [Signers overview](https://docs.privy.io/wallets/using-wallets/signers/overview): Grant limited wallet access to backends or agents. - [Signers quickstart](https://docs.privy.io/wallets/using-wallets/signers/quickstart): Fastest path to delegated signing. - [Configure signers](https://docs.privy.io/wallets/using-wallets/signers/configure-signers): Assign permissions and wallet access. - [Use signers](https://docs.privy.io/wallets/using-wallets/signers/use-signers): Execute actions through delegated access. - [Delegate a wallet](https://docs.privy.io/wallets/using-wallets/signers/delegate-wallet): Full delegation flow. ### External wallet connectors - [Connectors overview](https://docs.privy.io/wallets/connectors/overview): Connect MetaMask, Phantom, and other wallets. - [Connecting external wallets](https://docs.privy.io/wallets/connectors/usage/connecting-external-wallets): Core connection flow. - [Authenticate external wallets](https://docs.privy.io/wallets/connectors/usage/authenticate): Use connected wallets for auth. - [wagmi integration](https://docs.privy.io/wallets/connectors/ethereum/integrations/wagmi): Use with wagmi. - [viem integration](https://docs.privy.io/wallets/connectors/ethereum/integrations/viem): Use with viem. - [ethers integration](https://docs.privy.io/wallets/connectors/ethereum/integrations/ethers): Use with ethers.js. ### Funding - [Funding overview](https://docs.privy.io/wallets/funding/overview): Options for funding user wallets. - [Fiat onramp](https://docs.privy.io/wallets/funding/fiat-onramp): Buy crypto with fiat. - [Bank deposits](https://docs.privy.io/wallets/funding/bank-deposits): Fund from bank accounts. - [Crypto deposit addresses](https://docs.privy.io/wallets/funding/crypto-deposit-addresses): Deposit crypto from external sources. ### Gas and asset management - [Gas and assets overview](https://docs.privy.io/wallets/gas-and-asset-management/overview): Sponsorship, tracking, and webhooks. - [Gas sponsorship — EVM](https://docs.privy.io/wallets/gas-and-asset-management/gas/ethereum): Sponsor gas on EVM chains. - [Gas sponsorship — Solana](https://docs.privy.io/wallets/gas-and-asset-management/gas/solana): Sponsor gas on Solana. - [Fetch balances](https://docs.privy.io/wallets/gas-and-asset-management/assets/fetch-balance): Query wallet balances. - [Transaction event webhooks](https://docs.privy.io/wallets/gas-and-asset-management/assets/transaction-event-webhooks): Observe transaction lifecycle. - [Balance event webhooks](https://docs.privy.io/wallets/gas-and-asset-management/assets/balance-event-webhooks): Observe deposits and withdrawals. ## Controls and policies - [Controls overview](https://docs.privy.io/controls/overview): Owners, signers, shared control, and policy guardrails. - [Authorization keys overview](https://docs.privy.io/controls/authorization-keys/owners/overview): Backend-controlled wallets and multi-party approvals. - [Create an authorization key](https://docs.privy.io/controls/authorization-keys/keys/create/key): Key material for backend control. - [Key quorum overview](https://docs.privy.io/controls/key-quorum/overview): Multi-party approval requirements. - [Key quorum quickstart](https://docs.privy.io/controls/key-quorum/create): Set up quorum-based approvals. - [Policies overview](https://docs.privy.io/controls/policies/overview): Policy engine, rule structure, default-deny behavior. - [Create a policy](https://docs.privy.io/controls/policies/create-a-policy): Build wallet guardrails. - [Example policies — Ethereum](https://docs.privy.io/controls/policies/example-policies/ethereum): Common EVM policy patterns. - [Example policies — Solana](https://docs.privy.io/controls/policies/example-policies/solana): Common Solana policy patterns. - [Stateful policies](https://docs.privy.io/controls/policies/stateful-policies): Policies with state (rate limits, counters). - [Condition sets](https://docs.privy.io/controls/policies/condition-sets): Reusable policy conditions. - [Intents and approvals](https://docs.privy.io/controls/dashboard/intents): Intent lifecycle and webhook-driven approvals. ## User management - [User management overview](https://docs.privy.io/user-management/overview): Managing users, accounts, and identity. - [The user object](https://docs.privy.io/user-management/users/the-user-object): User data model and fields. - [Linking accounts](https://docs.privy.io/user-management/users/linking-accounts): Link additional login methods. - [Unlinking accounts](https://docs.privy.io/user-management/users/unlinking-accounts): Remove linked login methods. - [Custom metadata](https://docs.privy.io/user-management/users/custom-metadata): Store custom data on users. - [Querying users](https://docs.privy.io/user-management/users/managing-users/querying-users): Search and filter users. - [Migrating users](https://docs.privy.io/user-management/migrating-users-to-privy/overview): Import users from another system. ## Transaction management - [Transaction management overview](https://docs.privy.io/transaction-management/overview): Transaction lifecycle, retries, and monitoring. ## Security - [Security overview](https://docs.privy.io/security/overview): Non-custodial model, enclaves, key sharding, audits. - [Wallet architecture](https://docs.privy.io/security/wallet-infrastructure/architecture): Wallet security model. - [Secure enclaves](https://docs.privy.io/security/wallet-infrastructure/secure-enclaves): Enclave-backed signing and isolation. - [Security checklist](https://docs.privy.io/security/implementation-guide/security-checklist): Production readiness checklist. - [Content security policy](https://docs.privy.io/security/implementation-guide/content-security-policy): CSP configuration for Privy. ## Recipes and build patterns ### Agent integrations - [Agent integrations overview](https://docs.privy.io/recipes/agent-integrations/overview): Patterns for autonomous agents. - [Agentic wallets](https://docs.privy.io/recipes/agent-integrations/agentic-wallets): Backend-controlled wallets for agents with policy design. - [OpenClaw agent wallets](https://docs.privy.io/recipes/agent-integrations/openclaw-agentic-wallets): OpenClaw framework integration. - [Agent CLI](https://docs.privy.io/recipes/agent-integrations/agent-cli): CLI tool for agent wallet management. - [x402 payments](https://docs.privy.io/recipes/agent-integrations/x402): HTTP 402 payment protocol for agents. ### Wallet patterns - [Treasury wallets](https://docs.privy.io/recipes/wallets/treasury-overview): Wallet fleet and approval patterns. - [Business wallets](https://docs.privy.io/recipes/wallets/business-wallets): Operational wallet management. - [Server-side user wallets](https://docs.privy.io/recipes/wallets/server-side-user-wallets): Backend access on behalf of users. - [User and server signers](https://docs.privy.io/recipes/wallets/user-and-server-signers): Mixed control models. - [Two-of-two server-in-the-loop](https://docs.privy.io/recipes/wallets/two-of-two-server-in-the-loop): Dual-approval patterns. - [Execution wallets](https://docs.privy.io/recipes/wallets/execution-wallets): Hot wallets for automated execution. ### EVM recipes - [EVM recipes overview](https://docs.privy.io/recipes/evm/overview): Common EVM integration patterns. - [Account abstraction](https://docs.privy.io/recipes/account-abstraction/wagmi): Smart accounts with wagmi. - [EIP-7702](https://docs.privy.io/recipes/react/eip-7702): EIP-7702 account delegation. - [Batch transactions](https://docs.privy.io/recipes/batch-transactions): Send multiple transactions atomically. - [Swap with 0x](https://docs.privy.io/recipes/swap-with-0x): Token swaps using 0x protocol. ### Solana recipes - [Solana overview](https://docs.privy.io/recipes/solana/overview): Common Solana patterns. - [Getting started with Solana](https://docs.privy.io/recipes/solana/getting-started-with-privy-and-solana): Solana + Privy basics. - [Send SOL](https://docs.privy.io/recipes/solana/send-sol): Transfer native SOL. - [Send SPL tokens](https://docs.privy.io/recipes/solana/send-spl-tokens): Transfer SPL tokens. ### Yield and DeFi - [Yield overview](https://docs.privy.io/recipes/yield/overview): Yield integration patterns. - [Aave guide](https://docs.privy.io/recipes/yield/aave-guide): Aave lending integration. - [Ethena guide](https://docs.privy.io/recipes/yield/ethena-guide): Ethena integration. - [Kamino guide](https://docs.privy.io/recipes/yield/kamino-guide): Kamino (Solana) integration. ### Hyperliquid - [Hyperliquid — client-side usage](https://docs.privy.io/recipes/hyperliquid/client-side-usage): Frontend trading integration. - [Hyperliquid — agents and subaccounts](https://docs.privy.io/recipes/hyperliquid/agents-and-subaccounts): Automated trading agents. - [Hyperliquid — policies and offline actions](https://docs.privy.io/recipes/hyperliquid/policies-and-offline-actions): Policy-gated trading. ### Other recipes - [Farcaster mini apps](https://docs.privy.io/recipes/farcaster/mini-apps): Build Farcaster frame-based apps. - [World mini apps](https://docs.privy.io/recipes/world/mini-apps): Build World App mini apps. - [Telegram bot](https://docs.privy.io/recipes/telegram-bot): Telegram bot with Privy wallets. - [Chrome extension](https://docs.privy.io/recipes/react/chrome-extension): Browser extension integration. - [Pregenerate wallets](https://docs.privy.io/recipes/pregenerate-wallets): Create wallets before user signup. - [HD wallets](https://docs.privy.io/recipes/hd-wallets): Hierarchical deterministic wallet patterns. - [Passkey server wallets](https://docs.privy.io/recipes/passkey-server-wallets): Passkey-secured server wallets. - [Bridge onramp](https://docs.privy.io/recipes/bridge-onramp): Bridge protocol onramp integration. ## API reference - [API reference introduction](https://docs.privy.io/api-reference/introduction): Getting started with the REST API. - [Authorization signatures](https://docs.privy.io/api-reference/authorization-signatures): Securing API requests. - [Idempotency keys](https://docs.privy.io/api-reference/idempotency-keys): Making requests idempotent. - [Webhooks overview](https://docs.privy.io/api-reference/webhooks/overview): Webhook event types and setup. ### Key API endpoints - [Create wallet](https://docs.privy.io/api-reference/wallets/create): Create wallets via REST API. - [Authenticate wallet](https://docs.privy.io/api-reference/wallets/authenticate): Authenticate wallet actions from backend. - [Create policy](https://docs.privy.io/api-reference/policies/create): Create policies programmatically. - [Create key quorum](https://docs.privy.io/api-reference/key-quorums/create): Create multi-party approval groups. - [Create RPC transaction](https://docs.privy.io/api-reference/intents/rpc): Submit arbitrary RPC transactions. - [Create transfer](https://docs.privy.io/api-reference/intents/transfer): Submit token transfers. - [List intents](https://docs.privy.io/api-reference/intents/list): Query transaction intents. ## Dashboard - [Dashboard overview](https://docs.privy.io/basics/get-started/dashboard/overview): Navigating the Privy dashboard. - [Create a new app](https://docs.privy.io/basics/get-started/dashboard/create-new-app): Set up a new Privy application. - [Configure login methods](https://docs.privy.io/basics/get-started/dashboard/configure-login-methods): Enable email, SMS, social, and wallet login. - [App clients](https://docs.privy.io/basics/get-started/dashboard/app-clients): Manage app client IDs and settings. ## SDK changelogs - [Changelogs](https://docs.privy.io/changelogs): Release notes for all Privy SDKs.