Migrating to v4
This guide helps you migrate from Passkeys v3.x to v4.x.
Package Structure Changes
In v4, we’ve separated functionality into multiple packages to reduce bundle size:
@passkeys/core: Core functionality, including wallet creation and providers@passkeys/react: React components and hooks- Additional framework-specific adapters (like
@passkeys/wagmi)
- import { createWallet, WalletProvider, WalletWidget } from '@passkeys/sdk';
+ import { createWallet } from '@passkeys/core';
+ import { WalletProvider, WalletWidget } from '@passkeys/react';API Changes
Wallet Creation
The createWallet function now takes a more structured configuration object.
- const wallet = createWallet({
- appId: 'your-app-id',
- ethereum: true,
- solana: true,
- bitcoin: true,
- });
+ const wallet = createWallet({
+ appId: 'your-app-id',
+ providers: {
+ ethereum: true,
+ solana: true,
+ bitcoin: true,
+ },
+ });Integration with Frameworks
Framework-specific adapters are now provided as separate packages.
Wagmi Integration
- import { createPasskeysConnector } from '@passkeys/sdk/wagmi';
+ import { createPasskeysConnector } from '@passkeys/wagmi';Last updated on