Récupération
Dans les apps VaultKeepR, la récupération fragmentée utilise par défaut 3 fragments sur 5. Le SDK actuel utilise aussi ce défaut, défini par FRAGMENTED_DEFAULT_THRESHOLD, FRAGMENTED_DEFAULT_TOTAL et DEFAULT_FRAGMENTED_CONFIG.
La récupération de votre propre coffre et l’héritage numérique sont deux flux distincts, dans les paquets open source @vaultkeepr/recovery et @vaultkeepr/legacy.
Récupération fragmentée
Section intitulée « Récupération fragmentée »Le flux utilise le partage de secret de Shamir. createFragmentedVault génère une clé maître aléatoire avec generateMasterKey, chiffre le coffre avec cette clé, puis la découpe en cinq fragments avec un seuil de trois. encryptFragmentsForStorage chiffre les fragments destinés au stockage à l’aide de l’identifiant de récupération. Le seuil est configurable dans le SDK ; pour un coffre existant, utilisez la valeur enregistrée dans son manifeste.
La configuration nomme cinq canaux : appareil, IPFS, contact, smart contract et API. Cela ne certifie pas que tous sont disponibles : vérifiez les canaux réellement configurés et la possibilité de retrouver vos fragments.
Conservez séparément les éléments nécessaires :
- L’identifiant de récupération secret (
generateRecoveryId), qui permet notamment de déchiffrer les fragments stockés.computeLookupIdHashcalcule la référence utilisée pour retrouver le manifeste. - Le manifeste, avec le CID du coffre chiffré, le seuil et les emplacements des fragments, ainsi qu’un accès au coffre chiffré lui-même. Les fragments ne remplacent pas les données du coffre.
- Au moins trois fragments valides et distincts pour la configuration par défaut. Le recovery ID seul ne reconstitue pas la clé.
combineFragmentsAndDecrypt reconstitue la clé depuis le quorum de fragments déchiffrés, puis déchiffre le coffre. Ce n’est pas une nouvelle dérivation de clé à partir d’un mot de passe et d’une signature wallet. Le client enregistre ensuite le coffre restauré avec le mot de passe demandé par son formulaire de récupération.
Le README de récupération cité plus bas contient encore un ancien exemple 2-sur-3. Ce n’est pas le défaut courant du SDK ni celui des apps ; référez-vous aux constantes et au code de récupération liés ci-dessous.
Pas de reset central
Section intitulée « Pas de reset central »Nous ne pouvons pas réinitialiser votre mot de passe maître ni déchiffrer votre coffre à votre place. La récupération nécessite l’identifiant, le coffre chiffré accessible et le quorum de fragments valides. Si ces éléments sont perdus ou indisponibles, la récupération peut échouer ; le support ne dispose pas d’une clé de remplacement.
Avant de compter sur la récupération fragmentée pour un coffre de production, faites un essai complet avec un coffre de test : répartissez les fragments, vérifiez que le seuil restaure l’accès et confirmez que vous retrouvez l’identifiant de récupération. N’effacez pas le coffre principal tant que le flux n’a pas fonctionné de bout en bout.
Héritage numérique
Section intitulée « Héritage numérique »@vaultkeepr/legacy implémente un héritage verrouillé dans le temps, adossé au contrat VaultKeeperLegacy sur Base L2. Le propriétaire enregistre une liste de bénéficiaires, un délai et une période de grâce en jours. La clé maître ne voyage que dans des enveloppes ECIES chiffrées vers la clé publique de chaque bénéficiaire ; la chaîne stocke les pointeurs, la liste des bénéficiaires et les délais, jamais les clés.
Un mécanisme de heartbeat (preuve de vie) repousse l’échéance tant que le propriétaire reste actif. Après l’échéance, un bénéficiaire peut appeler claimLegacy et recevoir la clé maître et le CID du coffre depuis le paquet d’enveloppes sur IPFS. Le propriétaire peut révoquer le dispositif à tout moment avec revokeLegacy.
Fichiers sources
Section intitulée « Fichiers sources »- packages/core/src/types.ts
- packages/recovery/src/fragmented-vault.ts
- packages/recovery/README.md
- packages/legacy/README.md
- docs/THREAT_MODEL.md — lignes fragments de récupération et héritage du tableau des biens