# SocketFi

## Docs

- [authenticate() — SocketFi Client SDK Auth Method](https://docs.socket.fi/api-reference/authenticate.md): Open the SocketFi hosted auth flow, register or sign in with a passkey, and receive a Session with an access token and user profile.
- [SocketFi Error Reference — Client and Server Codes](https://docs.socket.fi/api-reference/errors.md): Complete reference for all SocketFi client and server error codes, their meanings, and recommended handling patterns for production applications.
- [readContract() — SocketFi Read-Only Contract Call](https://docs.socket.fi/api-reference/read-contract.md): Run a read-only Soroban smart contract call with no user approval. Fetch balances, metadata, and on-chain state before submitting transactions.
- [requestTransaction() — SocketFi Client SDK Method](https://docs.socket.fi/api-reference/request-transaction.md): Submit a Soroban smart contract transaction through the user's embedded wallet. Opens an approval popup and returns the transaction hash on success.
- [SocketFi Class — Client SDK Constructor Reference](https://docs.socket.fi/api-reference/socketfi-class.md): Create and configure a SocketFi client instance. The SocketFi constructor is the main entry point for passkey authentication and smart wallet operations.
- [Backend Verification: Validate SocketFi Tokens Server-Side](https://docs.socket.fi/authentication/backend-verification.md): Learn how to verify SocketFi access tokens server-side using @socketfi/server, extract user identity and wallet address, and protect your API endpoints.
- [SocketFi Authentication Overview: Passkeys & Sessions](https://docs.socket.fi/authentication/overview.md): Learn how SocketFi's passkey-based, wallet-aware authentication model works — from identity verification through wallet resolution to session creation.
- [Passkeys in SocketFi: WebAuthn-Powered Authentication](https://docs.socket.fi/authentication/passkeys.md): Understand how passkeys work, why SocketFi uses them instead of passwords or seed phrases, and how the SDK abstracts all WebAuthn complexity for you.
- [Session Management — SocketFi Access Tokens & Storage](https://docs.socket.fi/authentication/sessions.md): Learn how SocketFi sessions work, how to store and use access tokens, manage session expiration, and build a React Context for authenticated state.
- [Sign-In Flow — Returning User Authentication in SocketFi](https://docs.socket.fi/authentication/sign-in-flow.md): How SocketFi authenticates returning users: verifying a passkey challenge, resolving their existing wallet, and issuing a fresh session token.
- [SocketFi Sign-Up Flow: Passkey Registration & Wallet](https://docs.socket.fi/authentication/sign-up-flow.md): How SocketFi registers new users: passkey creation, credential verification, smart wallet deployment, and returning an authenticated session.
- [Embedded Wallets: What They Are and Why They Matter](https://docs.socket.fi/embedded-wallets/overview.md): Learn how SocketFi embedded wallets eliminate seed phrases and wallet extensions, giving every user a non-custodial smart wallet on first sign-up.
- [User Ownership: Non-Custodial Wallets and Asset Control](https://docs.socket.fi/embedded-wallets/user-ownership.md): SocketFi's non-custodial model: users authorize all transactions, SocketFi cannot access funds, and wallet address is the canonical verified identity.
- [Wallet Creation: From Sign-Up to Active Smart Wallet](https://docs.socket.fi/embedded-wallets/wallet-creation.md): How SocketFi automatically handles passkey registration, smart contract deployment, credential binding, and wallet activation in a single SDK call.
- [Wallet Lifecycle: From Creation to Continued Ownership](https://docs.socket.fi/embedded-wallets/wallet-lifecycle.md): Follow a SocketFi wallet through its full lifecycle — creation, activation, daily use, credential updates, recovery, and indefinite continued ownership.
- [Full-Stack SocketFi App: Reference Architecture Guide](https://docs.socket.fi/examples/full-application.md): A reference architecture for a complete SocketFi integration — React frontend, Express backend, authentication, wallet dashboard, and transactions.
- [React Authentication Example with SocketFi Passkeys](https://docs.socket.fi/examples/react-authentication.md): A complete, production-ready React authentication flow using SocketFi passkeys, session persistence, protected routes, and backend token verification.
- [React Transaction Flow and Error Handling with SocketFi](https://docs.socket.fi/examples/react-transactions.md): A complete React transaction flow with form validation, full status lifecycle UI, error handling, and a reusable service layer for SocketFi.
- [Server-Side Token Verification Example with SocketFi](https://docs.socket.fi/examples/server-verification.md): A complete Express backend with SocketFi token verification middleware, TypeScript request augmentation, and multiple protected route patterns.
- [SocketFi SDK Setup: Install, Configure, and Verify](https://docs.socket.fi/getting-started/installation.md): Install @socketfi/react, @socketfi/react-native, or @socketfi/server, configure your Client ID, and verify your setup with a working auth button.
- [SocketFi Overview: Architecture & Key Features](https://docs.socket.fi/getting-started/overview.md): Learn how SocketFi removes wallet friction with passkey authentication, embedded Soroban smart wallets, and a unified SDK across web and mobile.
- [Go Live with SocketFi: Production Readiness Checklist](https://docs.socket.fi/getting-started/production-checklist.md): Verify your SocketFi integration is secure, stable, and correctly configured before switching to MAINNET and opening your app to real users.
- [SocketFi Quick Start: Auth, Wallets & Transactions](https://docs.socket.fi/getting-started/quickstart.md): Go from zero to a working SocketFi integration in under 15 minutes — authenticate a user, load their wallet, read contract state, and submit a transaction.
- [SocketFi Account Recovery for Lost Passkeys and Devices](https://docs.socket.fi/guides/account-recovery.md): Guide to SocketFi account recovery — what is preserved, the 6-step recovery flow, identity verification requirements, and UX best practices.
- [Authenticate Users with SocketFi Passkey Authentication](https://docs.socket.fi/guides/authenticate-users.md): Complete guide to passkey authentication, session management, backend token verification, protected routes, and logout in SocketFi apps.
- [Rotate Passkey Credentials Proactively with SocketFi](https://docs.socket.fi/guides/credential-rotation.md): Guide to proactive credential rotation — moving to a new device, upgrading a passkey, and keeping wallet access secure without account recovery.
- [Integrate SocketFi Wallets into Your React Application](https://docs.socket.fi/guides/integrate-react.md): Step-by-step guide to adding passkey-powered smart wallets to your React app — from SDK install through backend token verification.
- [Integrate SocketFi Wallets into Your React Native App](https://docs.socket.fi/guides/integrate-react-native.md): Step-by-step guide to embedding passkey-powered smart wallets in your Expo/React Native app using deep linking and SecureStore session storage.
- [Read Soroban Smart Contract State with SocketFi SDK](https://docs.socket.fi/guides/read-contracts.md): Guide to reading on-chain data from Soroban contracts — balances, metadata, protocol state — with caching, React Query integration, and error handling.
- [Request Soroban Blockchain Transactions with SocketFi](https://docs.socket.fi/guides/request-transactions.md): Complete guide to requesting Soroban contract transactions — building requests, handling approvals, managing errors, and updating UI state.
- [SocketFi — Embedded Wallet Infrastructure for Apps](https://docs.socket.fi/introduction.md): Add passkey-powered smart wallets to any application — no seed phrases, no browser extensions, no blockchain expertise required from your users.
- [SocketFi Frequently Asked Questions for Developers](https://docs.socket.fi/resources/faq.md): Answers to common questions about SocketFi — covering general concepts, authentication, smart wallets, transactions, recovery, and security.
- [SocketFi Platform Glossary of Key Terms and Concepts](https://docs.socket.fi/resources/glossary.md): An alphabetical reference of key terms used throughout the SocketFi platform — from Access Token and Passkey to Soroban, verifyAuth(), and WebAuthn.
- [SocketFi Supported Platforms, Browsers, and Runtimes](https://docs.socket.fi/resources/supported-platforms.md): Platform and browser support for the SocketFi SDKs — React, React Native, Expo, Node.js, minimum browser versions, and WebAuthn requirements.
- [SocketFi Integration Troubleshooting and Debugging Guide](https://docs.socket.fi/resources/troubleshooting.md): Diagnose and fix common SocketFi integration issues — auth failures, session problems, transaction errors, backend 401s, and React Native deep links.
- [React Native SDK Authentication Guide — SocketFi](https://docs.socket.fi/sdk/react-native/authentication.md): Authenticate users via passkey in a hosted browser, persist sessions with SecureStore, and restore them on app launch with a reusable AuthProvider hook.
- [React Native Deep Linking for SocketFi Authentication](https://docs.socket.fi/sdk/react-native/deep-linking.md): Configure your Expo app scheme and expo-linking listener so SocketFi can redirect users back to your app after passkey authentication.
- [SocketFi React Native SDK: Installation and Config](https://docs.socket.fi/sdk/react-native/installation.md): Install @socketfi/react-native, add Expo browser and linking dependencies, configure your app scheme, and initialize the SocketFi client.
- [SocketFi React Native SDK — Mobile Wallet Overview](https://docs.socket.fi/sdk/react-native/overview.md): Embed passkey-powered smart wallets in any React Native or Expo app — no seed phrases, no external wallet apps, no native blockchain code required.
- [SocketFi React SDK — Passkey Auth Integration Guide](https://docs.socket.fi/sdk/react/authentication.md): Authenticate users with passkeys via a hosted popup, manage sessions with React Context, and protect routes — all with a single authenticate() call.
- [SocketFi React SDK Installation, Setup, and Config](https://docs.socket.fi/sdk/react/installation.md): Install @socketfi/react, configure your Client ID environment variable, and initialize the SocketFi client in your project in minutes.
- [SocketFi React SDK — Embedded Smart Wallet Overview](https://docs.socket.fi/sdk/react/overview.md): Add passkey-powered embedded smart wallets to any React app with a single SDK — no extensions, no seed phrases, no blockchain knowledge required.
- [SocketFi React SDK: Transactions and Contract Reads](https://docs.socket.fi/sdk/react/transactions.md): Submit Soroban contract writes through a hosted approval popup and query on-chain state — all with typed SDK methods and clean UI state management.
- [SocketFi Auth Middleware — Express, Fastify, NestJS](https://docs.socket.fi/sdk/server/middleware.md): Build reusable authentication middleware with verifyAuth(). Complete examples for Express, Fastify, and NestJS with TypeScript type extensions.
- [SocketFi Server SDK — Backend Token Verification](https://docs.socket.fi/sdk/server/overview.md): Verify SocketFi access tokens on your backend with @socketfi/server. Protect authenticated routes in Express, Fastify, NestJS, or serverless functions.
- [verifyAuth() — SocketFi Backend Token Verification](https://docs.socket.fi/sdk/server/verify-auth.md): Cryptographically verify a SocketFi access token on your backend. Returns the authenticated user ID and Stellar wallet address, or a typed error code.
- [Secure SocketFi Integration: Developer Best Practices](https://docs.socket.fi/security/best-practices.md): A practical guide to authentication, backend verification, transaction security, and production readiness for developers integrating SocketFi.
- [SocketFi Security Architecture and Defense in Depth](https://docs.socket.fi/security/overview.md): Understand SocketFi's layered security model — passkey authentication, smart wallet authorization, policy enforcement, and cryptographic replay protection.
- [Passkey Security: WebAuthn-Powered Wallet Authentication](https://docs.socket.fi/security/passkey-security.md): Learn how SocketFi uses WebAuthn passkeys for wallet authentication — private key protection, phishing resistance, and device-bound cryptographic signing.
- [Wallet Authorization: Signatures, Nonces, and Enforcement](https://docs.socket.fi/smart-wallet/authorization.md): How SocketFi wallets verify passkey signatures, use sequential nonces to block replay attacks, and enforce authorization on-chain before any state change.
- [Credential Rotation: Update Your Passkey Proactively](https://docs.socket.fi/smart-wallet/credential-rotation.md): Rotate the passkey bound to your wallet when you get a new device or upgrade security — wallet address, assets, and history stay completely unchanged.
- [Smart Wallets: Programmable On-Chain Accounts on Soroban](https://docs.socket.fi/smart-wallet/overview.md): What makes SocketFi wallets smart — programmable policies, passkey authorization, built-in recovery, fee abstraction, and Soroban contract execution.
- [Wallet Policies: Programmable On-Chain Transaction Rules](https://docs.socket.fi/smart-wallet/policy.md): Configure spending limits, contract restrictions, and time windows that the wallet enforces on-chain — plus recovery controls and fee policies.
- [Account Recovery: Regain Access Without Losing Assets](https://docs.socket.fi/smart-wallet/recovery.md): Restore wallet access after a lost passkey — identity verification replaces the credential while the wallet address, assets, and ownership stay intact.
- [Transaction Failure Handling: Error Codes and UI Patterns](https://docs.socket.fi/transactions/failure-handling.md): Learn how to handle every transaction failure scenario in SocketFi — from user rejections to contract errors — with clear error codes and UI patterns.
- [Fee Abstraction: Pay Fees Without Native Gas Tokens](https://docs.socket.fi/transactions/fee-abstraction.md): Learn how SocketFi abstracts transaction fees so users can transact with USDC, USDT, or XLM — without needing to manage native gas balances.
- [SocketFi Transactions: How Blockchain Actions Work](https://docs.socket.fi/transactions/overview.md): Learn how SocketFi transactions work — from asset transfers and contract calls to the five core principles that govern every on-chain action.
- [requestTransaction(): Execute Soroban Contract Calls](https://docs.socket.fi/transactions/request-transaction.md): Use requestTransaction() to execute any state-changing Soroban contract call through SocketFi's user-approval and smart wallet authorization workflow.
- [Transaction Lifecycle: From Request to Confirmation](https://docs.socket.fi/transactions/transaction-lifecycle.md): Understand every stage a SocketFi transaction passes through, from the initial requestTransaction() call to on-chain confirmation or failure.