decane-connect-kit 2.21.0 → 2.23.0

package/dist/index.cjs

@@ -3689,6 +3689,29 @@ function clearPersisted(key) {
   } catch {
   }
 }
+function makeLastUserKey(apiKey) {
+  return `${makePersistKey(apiKey)}:last-user`;
+}
+function loadLastUser(key) {
+  try {
+    const raw = typeof localStorage !== "undefined" ? localStorage.getItem(key) : null;
+    return raw ? JSON.parse(raw).userId ?? null : null;
+  } catch {
+    return null;
+  }
+}
+function saveLastUser(key, userId) {
+  try {
+    localStorage.setItem(key, JSON.stringify({ userId }));
+  } catch {
+  }
+}
+function clearLastUser(key) {
+  try {
+    localStorage.removeItem(key);
+  } catch {
+  }
+}
 function sessionPersistKey(apiKey) {
   return `decane:sess:${apiKey.slice(0, 20)}`;
 }
@@ -3727,6 +3750,7 @@ async function createDecaneConnect(config) {
   const rpId = config.rpId ?? (typeof window !== "undefined" ? window.location.hostname : "localhost");
   const rpName = config.rpName ?? "Decane Connect";
   const PERSIST_KEY = makePersistKey(config.apiKey);
+  const LAST_USER_KEY = makeLastUserKey(config.apiKey);
   const teeUrl = config.teeUrl ?? DEFAULT_TEE_URL;
   const events = new EventEmitter();
   const api = new ApiClient(baseUrl, config.apiKey, config.appId);
@@ -3739,8 +3763,10 @@ async function createDecaneConnect(config) {
   );
   let auth = null;
   let persisted = loadPersisted(PERSIST_KEY);
+  let lastUserId = loadLastUser(LAST_USER_KEY);
   let ethProvider = null;
   const persistSession = config.persistSession !== false;
+  const deferDeviceProtection = config.deferDeviceProtection === true;
   const serverAssistedRecovery = true;
   const RECOVERY_OFFER_TIMEOUT_MS = 5 * 6e4;
   const selfHealAttempted = /* @__PURE__ */ new Set();
@@ -3884,6 +3910,10 @@ async function createDecaneConnect(config) {
       const stored = await storage.getShare(persisted.userId);
       return hasPasswordUnlock(stored) ? stored : null;
     }
+    if (lastUserId) {
+      const stored = await storage.getShare(lastUserId);
+      return hasPasswordUnlock(stored) ? stored : null;
+    }
     const candidates = (await storage.listShares()).filter(hasPasswordUnlock);
     return candidates.length === 1 ? candidates[0] : null;
   }
@@ -4048,11 +4078,12 @@ async function createDecaneConnect(config) {
   }
   async function firstTimeSetup(userId, jwt) {
     prewarmAttestation(teeUrl);
-    let unlockMethod;
-    let wrappingKey;
+    let unlockMethod = "password";
+    let wrappingKey = null;
     let meta = {};
     let unlockTokenKey = null;
-    if (isPasskeySupported()) {
+    if (deferDeviceProtection) {
+    } else if (isPasskeySupported()) {
       const prfSalt = generateRandomBytes(32);
       try {
         const { credentialId, prfOutput } = await registerWebAuthnCredential({ api, jwt, rpId, rpName, prfSalt });
@@ -4093,32 +4124,37 @@ async function createDecaneConnect(config) {
     } finally {
       zeroize(master);
     }
-    const iv = generateRandomBytes(12);
-    const wrappedDeviceShare = await aesGcmEncrypt(
-      wrappingKey,
-      shareSet.device,
-      iv
-    );
-    await storage.putShare({
-      userId,
-      wrappedDeviceShare,
-      iv,
-      unlockMethod,
-      credentialId: meta.credentialId ? b64uToBuffer(meta.credentialId) : void 0,
-      prfSalt: meta.prfSalt ? b64uToBuffer(meta.prfSalt) : void 0,
-      pinSalt: meta.pinSalt ? b64uToBuffer(meta.pinSalt) : void 0,
-      pinIterations: meta.pinIterations,
-      passwordSalt: meta.passwordSalt ? b64uToBuffer(meta.passwordSalt) : void 0,
-      passwordIterations: meta.passwordIterations,
-      version: 1
-    });
-    if (unlockTokenKey) await attachUnlockToken(userId, jwt, unlockTokenKey);
+    let wrappedDeviceShare = null;
+    let iv = null;
+    if (wrappingKey) {
+      iv = generateRandomBytes(12);
+      wrappedDeviceShare = await aesGcmEncrypt(
+        wrappingKey,
+        shareSet.device,
+        iv
+      );
+      await storage.putShare({
+        userId,
+        wrappedDeviceShare,
+        iv,
+        unlockMethod,
+        credentialId: meta.credentialId ? b64uToBuffer(meta.credentialId) : void 0,
+        prfSalt: meta.prfSalt ? b64uToBuffer(meta.prfSalt) : void 0,
+        pinSalt: meta.pinSalt ? b64uToBuffer(meta.pinSalt) : void 0,
+        pinIterations: meta.pinIterations,
+        passwordSalt: meta.passwordSalt ? b64uToBuffer(meta.passwordSalt) : void 0,
+        passwordIterations: meta.passwordIterations,
+        version: 1
+      });
+      if (unlockTokenKey) await attachUnlockToken(userId, jwt, unlockTokenKey);
+    }
     const serverIv = generateRandomBytes(12);
     await withDeadline(api.putShare(jwt, {
       ciphertext: shareSet.server,
       iv: serverIv,
       wrappedShareMeta: {
-        unlockMethod
+        // The server records this on the wallet_created event and nothing else.
+        unlockMethod: deferDeviceProtection ? "deferred" : unlockMethod
         // credential IDs, prfSalt, pinSalt stay on-device — never sent to server
       },
       evmAddress,
@@ -4127,7 +4163,7 @@ async function createDecaneConnect(config) {
     }), remainingBudget(), "storing your wallet");
     zeroize(shareSet.server);
     const addresses = { evm: evmAddress, solana: solanaAddress, tron: tronAddress };
-    if (unlockMethod === "passkey" && meta.credentialId && meta.prfSalt) {
+    if (unlockMethod === "passkey" && meta.credentialId && meta.prfSalt && wrappedDeviceShare && iv) {
       try {
         await api.putRecoveryBackup(jwt, {
           wrappedDeviceShare,
@@ -4210,7 +4246,7 @@ async function createDecaneConnect(config) {
           const tee = new TeeClient(teeUrl);
           const provisioned = await tee.provisionDeviceShare(jwt);
           if (provisioned) {
-            await persistProvisionedShare(userId, jwt, provisioned);
+            if (!deferDeviceProtection) await persistProvisionedShare(userId, jwt, provisioned);
             let addrs;
             try {
               addrs = await session.start(provisioned, jwt, recordedAddresses);
@@ -4254,7 +4290,7 @@ async function createDecaneConnect(config) {
       });
       deviceShare = recovered.deviceShare;
       joinedViaPasskeySync = recovered.flow === "passkey-sync";
-      if (!await storage.getShare(userId) && isPasskeySupported()) {
+      if (!deferDeviceProtection && !await storage.getShare(userId) && isPasskeySupported()) {
         await registerPasskeyAndBackup(userId, jwt, deviceShare);
       }
     } else {
@@ -4337,14 +4373,16 @@ async function createDecaneConnect(config) {
   async function passkeyDeviceCandidate() {
     if (!isPasskeySupported()) return null;
     if (persisted?.userId) return passkeyLoginCandidate();
+    if (lastUserId) return usablePasskeyShare(await storage.getShare(lastUserId));
     const candidates = (await storage.listShares()).map(usablePasskeyShare).filter(Boolean);
     return candidates.length === 1 ? candidates[0] : null;
   }
   async function canOfferPasskey() {
     if (!isPasskeySupported()) return false;
     if (await passkeyDeviceCandidate()) return true;
-    if (!persisted?.userId) return false;
-    return await storage.getShare(persisted.userId) == null;
+    const known = persisted?.userId ?? lastUserId;
+    if (!known) return false;
+    return await storage.getShare(known) == null;
   }
   async function rememberProfile(userId, profile) {
     const incoming = Object.fromEntries(Object.entries(profile).filter(([, v]) => v));
@@ -4557,8 +4595,9 @@ async function createDecaneConnect(config) {
     async signInWithPasskey() {
       const candidate = await passkeyDeviceCandidate();
       if (candidate) return passkeyLogin(candidate);
-      if (isPasskeySupported() && persisted?.userId && await storage.getShare(persisted.userId) == null) {
-        return passkeyLoginWithoutShare(persisted.userId);
+      const known = persisted?.userId ?? lastUserId;
+      if (isPasskeySupported() && known && await storage.getShare(known) == null) {
+        return passkeyLoginWithoutShare(known);
       }
       throw new NewDeviceError();
     },
@@ -4722,6 +4761,24 @@ async function createDecaneConnect(config) {
         zeroize(deviceShare);
       }
     },
+    async deviceProtected() {
+      if (!auth) return false;
+      return await storage.getShare(auth.userId) !== null;
+    },
+    async protectDevice() {
+      if (!auth) throw new ReconnectRequiredError();
+      if (await storage.getShare(auth.userId)) return true;
+      if (!serverAssistedRecovery) throw new NewDeviceError();
+      const tee = new TeeClient(teeUrl);
+      const provisioned = await tee.provisionDeviceShare(auth.jwt);
+      if (!provisioned) throw new NewDeviceError();
+      try {
+        await persistProvisionedShare(auth.userId, auth.jwt, provisioned);
+      } finally {
+        zeroize(provisioned);
+      }
+      return await storage.getShare(auth.userId) !== null;
+    },
     async unlock() {
       if (!auth) {
         const candidate = await passkeyLoginCandidate();
@@ -4898,12 +4955,21 @@ async function createDecaneConnect(config) {
         await api.revoke(auth.jwt).catch(() => {
         });
       }
+      const leaving = auth?.userId ?? persisted?.userId ?? null;
+      if (leaving) {
+        lastUserId = leaving;
+        saveLastUser(LAST_USER_KEY, leaving);
+      }
       auth = null;
       persisted = null;
       clearPersisted(PERSIST_KEY);
       dropLiveSession();
       events.emit("disconnected");
     },
+    forgetLastUser() {
+      lastUserId = null;
+      clearLastUser(LAST_USER_KEY);
+    },
     getAddresses() {
       return auth?.addresses ?? persisted?.addresses ?? null;
     },
@@ -7335,6 +7401,7 @@ function DecaneKit({ config, children }) {
       chains,
       rpcUrls,
       requireAssertionPerSignature,
+      deferDeviceProtection,
       // Recovery callbacks. Forwarding these is what makes recovery
       // configurable at all from <DecaneKit>; before, they were silently
       // dropped and the headless client was constructed without them.
@@ -7355,6 +7422,7 @@ function DecaneKit({ config, children }) {
       promptPin,
       promptUnlockPassword,
       requireAssertionPerSignature,
+      deferDeviceProtection,
       offerRecoveryAtSignup,
       onRecoveryShareOffer,
       onRecoveryFileReady,
@@ -7601,6 +7669,16 @@ function DecaneKit({ config, children }) {
     if (!sdk) throw new Error("Social wallet not connected");
     return sdk.addPasskey();
   }, []);
+  const socialDeviceProtected = (0, import_react5.useCallback)(async () => {
+    const sdk = socialRef.current;
+    if (!sdk) return false;
+    return sdk.deviceProtected();
+  }, []);
+  const socialProtectDevice = (0, import_react5.useCallback)(async () => {
+    const sdk = socialRef.current;
+    if (!sdk) throw new Error("Social wallet not connected");
+    return sdk.protectDevice();
+  }, []);
   const socialSetUnlockPassword = (0, import_react5.useCallback)(async (password) => {
     const sdk = socialRef.current;
     if (!sdk) throw new Error("Social wallet not connected");
@@ -7611,6 +7689,14 @@ function DecaneKit({ config, children }) {
     if (!sdk) return false;
     return sdk.canUnlockWithPassword();
   }, []);
+  const socialForgetLastUser = (0, import_react5.useCallback)(() => {
+    socialRef.current?.forgetLastUser();
+    const sdk = socialRef.current;
+    if (sdk) {
+      sdk.canSignInWithPasskey().then((can) => setSocialAuth((p) => ({ ...p, canUsePasskey: can }))).catch(() => {
+      });
+    }
+  }, []);
   const socialUnlockWithPassword = (0, import_react5.useCallback)(async (password) => {
     const sdk = socialRef.current;
     if (!sdk) throw new Error("Social wallet not connected");
@@ -7685,8 +7771,11 @@ function DecaneKit({ config, children }) {
         socialHasRecoveryShare,
         socialHasPasskey,
         socialAddPasskey,
+        socialDeviceProtected,
+        socialProtectDevice,
         socialSetUnlockPassword,
         socialCanUnlockWithPassword,
+        socialForgetLastUser,
         socialUnlockWithPassword,
         socialRemoveUnlockPassword,
         socialShouldPromptRecovery,
@@ -7994,8 +8083,11 @@ function useSocialWallet() {
     socialHasRecoveryShare,
     socialHasPasskey,
     socialAddPasskey,
+    socialDeviceProtected,
+    socialProtectDevice,
     socialSetUnlockPassword,
     socialCanUnlockWithPassword,
+    socialForgetLastUser,
     socialUnlockWithPassword,
     socialRemoveUnlockPassword,
     socialShouldPromptRecovery,
@@ -8095,6 +8187,16 @@ function useSocialWallet() {
       throw e;
     }
   }, [socialAddPasskey]);
+  const deviceProtected = (0, import_react6.useCallback)(() => run(() => socialDeviceProtected()), [socialDeviceProtected]);
+  const protectDevice = (0, import_react6.useCallback)(async () => {
+    setError(null);
+    try {
+      return await socialProtectDevice();
+    } catch (e) {
+      setError(e.message);
+      throw e;
+    }
+  }, [socialProtectDevice]);
   const setUnlockPassword = (0, import_react6.useCallback)(async (password) => {
     setError(null);
     try {
@@ -8104,6 +8206,7 @@ function useSocialWallet() {
       throw e;
     }
   }, [socialSetUnlockPassword]);
+  const forgetLastUser = (0, import_react6.useCallback)(() => socialForgetLastUser(), [socialForgetLastUser]);
   const canUnlockWithPassword = (0, import_react6.useCallback)(
     () => socialCanUnlockWithPassword(),
     [socialCanUnlockWithPassword]
@@ -8182,6 +8285,10 @@ function useSocialWallet() {
     // Passkey management for THIS device
     hasPasskey,
     addPasskey,
+    // Deferred protection (deferDeviceProtection): whether this device holds
+    // a wrapped share, and the call that stores one — passkey or password.
+    deviceProtected,
+    protectDevice,
     // "Unlock with your password": setUnlockPassword needs a live session;
     // canUnlockWithPassword and unlockWithPassword are the signed-out pair that
     // open one without an identity provider or a passkey.
@@ -8189,6 +8296,8 @@ function useSocialWallet() {
     canUnlockWithPassword,
     unlockWithPassword,
     removeUnlockPassword,
+    // "Use a different account": stop offering the account that signed out.
+    forgetLastUser,
     // Recovery (2-of-3 Shamir share set)
     rotateShares,
     exportPortableBackup,