Passkeys et compte intelligent

VaultKeepR remplace l’inscription classique email et mot de passe par une passkey et un compte intelligent ERC-4337. Cette page décrit comment les pièces s’assemblent, d’après le paquet public @vaultkeepr/smart-account.

Passkeys

Quand vous enregistrez une passkey biométrique, l’application crée un compte intelligent en arrière-plan. Vous ne fournissez pas d’adresse e-mail et vous ne connectez pas de wallet externe comme MetaMask. La passkey (WebAuthn) reste sur votre appareil et signe les opérations qui comptent.

Le compte intelligent

Le paquet @vaultkeepr/smart-account implémente un compte intelligent Kernel avec un paymaster Pimlico, partagé par les clients web, extension, iOS et Android. L’identité provient de l’une des deux sources :

initIdentityFromPassword(password, salt) : l’identité est dérivée sur l’appareil depuis votre mot de passe maître, sans exposition de phrase secrète.
initIdentityFromSigner(signer) : pour un wallet que vous avez déjà connecté.

getIdentityAddress renvoie l’adresse du compte intelligent. clearIdentity efface l’état en mémoire. Les signatures pour les écritures on-chain passent par le compte intelligent de l’utilisateur.

Frais de gas

Tous les frais de réseau nécessaires pour enregistrer ou réclamer votre coffre sont sponsorisés par le paymaster Pimlico. L’usage de la blockchain Base L2 ne coûte rien directement ; il n’y a pas de facture de gas pour l’utilisateur.

Signatures wallet et délégations

Pour les utilisateurs qui lient un wallet ou une clé matérielle NFC, l’authentification fonctionne par preuve du contrôle d’une adresse via une signature sur un message fixe (schémas EIP-4361, dans @vaultkeepr/wallet-messages). Lorsqu’une puce NFC est configurée, son empreinte dérive sur l’appareil un portefeuille caché qui agit comme un smart wallet sans dialoguer avec une application tierce.

Les délégations optionnelles mettent en cache une signature pour une durée courte, pour que le déverrouillage ou l’autosave ne sollicite pas le wallet à chaque action. Pendant qu’une délégation est active, considérez l’appareil comme digne de confiance : quiconque accède à la session ouverte, ou un malware sur l’appareil, peut utiliser ces identifiants.

Ce que cette page ne couvre pas

Le flux passkey est implémenté dans les clients privés, donc les écrans d’enrôlement et les réglages exacts vivent là-bas. Le paquet public documente le cycle de vie de l’identité (identity.ts), le compte Kernel (kernel.ts), la dérivation du signer (owner.ts, secretKey.ts), les écritures on-chain du pointeur de coffre (onChainSync.ts) et les liaisons au VaultKeeperCidRegistry (cidRegistry.ts). Le paquet est livré en source TypeScript et se consomme via un bundler.