Skip to content

Detailed Guides

Practical, step-by-step guides for integrating and deploying the Web3Authn SDK. Each guide focuses on a specific task or component.

Core Integration

Start here if you're building a new application:

  • Installation - Install the SDK, configure the wallet iframe origin, and wire up TatchiPasskeyProvider.

  • Registration & Login Progress Events - Handle onEvent callbacks for registration, login, and transaction flows to drive custom progress UI.

  • Plugin Configuration - Configure framework plugins (Vite/Next) for headers, wallet-service routes, and SDK asset serving.

  • Chain Signatures - Sign and relay transactions on external chains using NEAR MPC.

Advanced Features

Enhance your integration with these features:

  • Device Linking - Add new devices to existing accounts via QR codes. No seed phrases or manual secret sharing required.

  • Signing Sessions - Reduce repeated prompts: backend auth (JWT/cookie) and warm local signing sessions.

  • VRF Sessions - Reduce repeated prompts for local signing with short-lived “warm” sessions in the VRF worker.

  • Email Recovery (Passkey + Email) - Recover an account by sending a verified recovery email and registering a new passkey-derived device key.

  • Offline Key Export - Export private keys while completely offline using a cached PWA. Works in airplane mode with zero network requests.

Deployment

Deploy your application and optional backend services: