decane-connect-kit 2.24.0 → 2.25.0

package/dist/index.cjs

@@ -2416,6 +2416,54 @@ var import_browser = require("@simplewebauthn/browser");
 
 // src/social/attestation.ts
 var import_dcap_qvl = require("@phala/dcap-qvl");
+
+// src/social/collateralCache.ts
+var CACHE_PREFIX = "decane:collateral:v1:";
+var COLLATERAL_TTL_MS = 12 * 60 * 60 * 1e3;
+function storage() {
+  try {
+    return typeof localStorage !== "undefined" ? localStorage : null;
+  } catch {
+    return null;
+  }
+}
+function keyFor(teeUrl) {
+  return `${CACHE_PREFIX}${teeUrl}`;
+}
+function readCollateral(teeUrl) {
+  const store = storage();
+  if (!store) return null;
+  try {
+    const raw = store.getItem(keyFor(teeUrl));
+    if (!raw) return null;
+    const entry = JSON.parse(raw);
+    if (!entry?.at || Date.now() - entry.at > COLLATERAL_TTL_MS) {
+      store.removeItem(keyFor(teeUrl));
+      return null;
+    }
+    return entry.collateral ?? null;
+  } catch {
+    return null;
+  }
+}
+function writeCollateral(teeUrl, collateral) {
+  const store = storage();
+  if (!store) return;
+  try {
+    store.setItem(keyFor(teeUrl), JSON.stringify({ at: Date.now(), collateral }));
+  } catch {
+  }
+}
+function dropCollateral(teeUrl) {
+  const store = storage();
+  if (!store) return;
+  try {
+    store.removeItem(keyFor(teeUrl));
+  } catch {
+  }
+}
+
+// src/social/attestation.ts
 init_errors();
 
 // ../../infra/tee-measurement.json
@@ -2443,6 +2491,9 @@ function hexToBytes(hex) {
 function bytesToHex(bytes) {
   return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
 }
+function nowSeconds() {
+  return Math.floor(Date.now() / 1e3);
+}
 async function verifyTeeAttestation(teeUrl, nonce) {
   const res = await fetch(`${teeUrl}/attestation`, {
     method: "POST",
@@ -2452,9 +2503,22 @@ async function verifyTeeAttestation(teeUrl, nonce) {
   if (!res.ok) throw new AttestationError("quote fetch failed");
   const { quote, measurement } = await res.json();
   let verified;
+  const cached = readCollateral(teeUrl);
   try {
-    verified = await (0, import_dcap_qvl.getCollateralAndVerify)(hexToBytes(quote));
-  } catch {
+    if (cached) {
+      try {
+        verified = await (0, import_dcap_qvl.verify)(hexToBytes(quote), cached, nowSeconds());
+      } catch {
+        dropCollateral(teeUrl);
+        verified = await (0, import_dcap_qvl.getCollateralAndVerify)(hexToBytes(quote));
+      }
+    } else {
+      const collateral = await (0, import_dcap_qvl.getCollateral)(import_dcap_qvl.PHALA_PCCS_URL, hexToBytes(quote));
+      verified = await (0, import_dcap_qvl.verify)(hexToBytes(quote), collateral, nowSeconds());
+      writeCollateral(teeUrl, collateral);
+    }
+  } catch (e) {
+    if (e instanceof AttestationError) throw e;
     throw new AttestationError("quote signature invalid");
   }
   if (verified.status === "Revoked") {
@@ -2496,14 +2560,51 @@ async function teeFetch(url, init) {
 }
 var ATTESTATION_TTL_MS = 10 * 6e4;
 var attestationCache = /* @__PURE__ */ new Map();
+var ATTESTATION_PERSIST_PREFIX = "decane:attested:v1:";
+function persistedAt(teeUrl) {
+  try {
+    if (typeof sessionStorage === "undefined") return null;
+    const raw = sessionStorage.getItem(ATTESTATION_PERSIST_PREFIX + teeUrl);
+    const at = raw ? Number(raw) : NaN;
+    return Number.isFinite(at) ? at : null;
+  } catch {
+    return null;
+  }
+}
+function rememberAttested(teeUrl, at) {
+  try {
+    if (typeof sessionStorage !== "undefined") {
+      sessionStorage.setItem(ATTESTATION_PERSIST_PREFIX + teeUrl, String(at));
+    }
+  } catch {
+  }
+}
+function forgetAttested(teeUrl) {
+  try {
+    if (typeof sessionStorage !== "undefined") {
+      sessionStorage.removeItem(ATTESTATION_PERSIST_PREFIX + teeUrl);
+    }
+  } catch {
+  }
+}
 function attestOnce(teeUrl, verify) {
   const hit = attestationCache.get(teeUrl);
   if (hit && Date.now() - hit.at < ATTESTATION_TTL_MS) return hit.promise;
-  const promise = verify().catch((e) => {
+  const at = persistedAt(teeUrl);
+  if (at && Date.now() - at < ATTESTATION_TTL_MS) {
+    const resolved = Promise.resolve();
+    attestationCache.set(teeUrl, { at, promise: resolved });
+    return resolved;
+  }
+  const startedAt = Date.now();
+  const promise = verify().then(() => {
+    rememberAttested(teeUrl, startedAt);
+  }).catch((e) => {
     attestationCache.delete(teeUrl);
+    forgetAttested(teeUrl);
     throw e;
   });
-  attestationCache.set(teeUrl, { at: Date.now(), promise });
+  attestationCache.set(teeUrl, { at: startedAt, promise });
   return promise;
 }
 function prewarmAttestation(teeUrl) {
@@ -3232,6 +3333,8 @@ function loginWithKingsChatPopup(opts) {
 
 // src/social/signers/evm.ts
 var import_ethers2 = require("ethers");
+init_errors();
+var DECODE = (bytes) => new TextDecoder().decode(bytes);
 async function signEvmTransaction(tee, chain, tx, jwt) {
   const resolved = await (0, import_ethers2.resolveProperties)(tx);
   const unsigned = import_ethers2.Transaction.from(resolved).unsignedSerialized;
@@ -3240,7 +3343,44 @@ async function signEvmTransaction(tee, chain, tx, jwt) {
   return tee.sign({ chain, kind: "transaction", payload, txHash }, jwt);
 }
 async function signEvmMessage(tee, chain, message, jwt) {
-  return tee.sign({ chain, kind: "message", payload: message }, jwt);
+  return tee.sign({ chain, kind: "message", payload: messageAsString(message) }, jwt);
+}
+function messageAsString(message) {
+  if (typeof message === "string") return message;
+  if (!isValidUtf8(message)) {
+    throw new CallSequenceError(
+      "signMessage: the message bytes are not valid UTF-8. The signer hashes text; pass a string, or UTF-8 bytes."
+    );
+  }
+  return DECODE(message);
+}
+function isValidUtf8(b) {
+  let i = 0;
+  while (i < b.length) {
+    const c = b[i];
+    let n = 0;
+    if (c < 128) n = 0;
+    else if (c >= 194 && c <= 223) n = 1;
+    else if (c >= 224 && c <= 239) n = 2;
+    else if (c >= 240 && c <= 244) n = 3;
+    else return false;
+    for (let k = 1; k <= n; k++) {
+      const t = b[i + k];
+      if (t === void 0 || (t & 192) !== 128) return false;
+    }
+    if (n === 2) {
+      const c1 = b[i + 1];
+      if (c === 224 && c1 < 160) return false;
+      if (c === 237 && c1 >= 160) return false;
+    }
+    if (n === 3) {
+      const c1 = b[i + 1];
+      if (c === 240 && c1 < 144) return false;
+      if (c === 244 && c1 >= 144) return false;
+    }
+    i += n + 1;
+  }
+  return true;
 }
 async function signEvmAuthorization(tee, chainId, address, nonce, jwt) {
   const serialized = await tee.sign(
@@ -3736,29 +3876,44 @@ function clearLastUser(key) {
 function sessionPersistKey(apiKey) {
   return `decane:sess:${apiKey.slice(0, 20)}`;
 }
+var sessionStore = () => typeof sessionStorage !== "undefined" ? sessionStorage : null;
+function useCrossTabSessionStore(enabled) {
+  sessionStore = enabled ? () => typeof localStorage !== "undefined" ? localStorage : null : () => typeof sessionStorage !== "undefined" ? sessionStorage : null;
+}
 function loadSession(key) {
   try {
-    const raw = typeof sessionStorage !== "undefined" ? sessionStorage.getItem(key) : null;
-    return raw ? JSON.parse(raw) : null;
+    const raw = sessionStore()?.getItem(key) ?? (typeof sessionStorage !== "undefined" ? sessionStorage.getItem(key) : null) ?? (typeof localStorage !== "undefined" ? localStorage.getItem(key) : null);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (parsed?.expiresAt && parsed.expiresAt <= Date.now()) {
+      clearSessionPersist(key);
+      return null;
+    }
+    return parsed;
   } catch {
     return null;
   }
 }
 function saveSession(key, s) {
   try {
-    sessionStorage.setItem(key, JSON.stringify(s));
+    sessionStore()?.setItem(key, JSON.stringify(s));
   } catch {
   }
 }
 function clearSessionPersist(key) {
   try {
-    sessionStorage.removeItem(key);
+    if (typeof sessionStorage !== "undefined") sessionStorage.removeItem(key);
+  } catch {
+  }
+  try {
+    if (typeof localStorage !== "undefined") localStorage.removeItem(key);
   } catch {
   }
 }
 async function createDecaneConnect(config) {
   if (!config.appId) throw new Error("decane-connect-kit: appId is required");
   if (!config.apiKey) throw new Error("decane-connect-kit: apiKey is required");
+  useCrossTabSessionStore(config.resumeSessionAcrossTabs === true);
   if (!config.chains?.length)
     throw new Error("decane-connect-kit: at least one chain is required");
   if (config.rotateOnNewDeviceRecovery && !config.onRecoveryRotated) {
@@ -3777,7 +3932,7 @@ async function createDecaneConnect(config) {
   const teeUrl = config.teeUrl ?? DEFAULT_TEE_URL;
   const events = new EventEmitter();
   const api = new ApiClient(baseUrl, config.apiKey, config.appId);
-  const storage = new Storage();
+  const storage2 = new Storage();
   const session = new SessionManager(
     events,
     durationMs,
@@ -3920,7 +4075,7 @@ async function createDecaneConnect(config) {
   }
   async function attachUnlockToken(userId, jwt, tokenKey) {
     try {
-      const stored = await storage.getShare(userId);
+      const stored = await storage2.getShare(userId);
       if (!stored) return;
       const { token } = await api.issueUnlockToken(jwt);
       const unlockTokenIv = generateRandomBytes(12);
@@ -3929,13 +4084,13 @@ async function createDecaneConnect(config) {
         new TextEncoder().encode(token),
         unlockTokenIv
       );
-      await storage.putShare({ ...stored, wrappedUnlockToken, unlockTokenIv });
+      await storage2.putShare({ ...stored, wrappedUnlockToken, unlockTokenIv });
     } catch (e) {
       console.warn("decane-connect-kit: could not store an unlock token for this device.", e);
     }
   }
   async function persistRotatedDeviceShare(userId, deviceShare) {
-    const stored = await storage.getShare(userId);
+    const stored = await storage2.getShare(userId);
     if (!stored) {
       throw new CallSequenceError(
         "Share set was rotated but this device has no stored share to update. Recover the wallet on this device before rotating."
@@ -3944,21 +4099,21 @@ async function createDecaneConnect(config) {
     const wrappingKey = await getWrappingKey(stored);
     const iv = generateRandomBytes(12);
     const wrappedDeviceShare = await aesGcmEncrypt(wrappingKey, deviceShare, iv);
-    await storage.putShare({ ...stored, wrappedDeviceShare, iv });
+    await storage2.putShare({ ...stored, wrappedDeviceShare, iv });
   }
   function hasPasswordUnlock(stored) {
     return !!stored && stored.unlockMethod === "password" && !!stored.passwordSalt && !!stored.wrappedUnlockToken && !!stored.unlockTokenIv;
   }
   async function passwordDeviceCandidate() {
     if (persisted?.userId) {
-      const stored = await storage.getShare(persisted.userId);
+      const stored = await storage2.getShare(persisted.userId);
       return hasPasswordUnlock(stored) ? stored : null;
     }
     if (lastUserId) {
-      const stored = await storage.getShare(lastUserId);
+      const stored = await storage2.getShare(lastUserId);
       return hasPasswordUnlock(stored) ? stored : null;
     }
-    const candidates = (await storage.listShares()).filter(hasPasswordUnlock);
+    const candidates = (await storage2.listShares()).filter(hasPasswordUnlock);
     return candidates.length === 1 ? candidates[0] : null;
   }
   async function getWrappingKey(stored) {
@@ -3986,7 +4141,7 @@ async function createDecaneConnect(config) {
     let credentialId;
     let prfOutput;
     try {
-      const label = (await storage.getShare(userId))?.profile?.email;
+      const label = (await storage2.getShare(userId))?.profile?.email;
       ({ credentialId, prfOutput } = await registerWebAuthnCredential({
         api,
         jwt,
@@ -4018,8 +4173,8 @@ async function createDecaneConnect(config) {
     const wrappingKey = await importAesKey(prfOutput);
     const iv = generateRandomBytes(12);
     const wrappedDeviceShare = await aesGcmEncrypt(wrappingKey, deviceShare, iv);
-    const existing = await storage.getShare(userId);
-    await storage.putShare({
+    const existing = await storage2.getShare(userId);
+    await storage2.putShare({
       ...existing,
       userId,
       wrappedDeviceShare,
@@ -4103,7 +4258,7 @@ async function createDecaneConnect(config) {
       const { wrappingKey, tokenKey, meta } = await passwordSetup();
       const iv = generateRandomBytes(12);
       const wrappedDeviceShare = await aesGcmEncrypt(wrappingKey, deviceShare, iv);
-      await storage.putShare({
+      await storage2.putShare({
         userId,
         wrappedDeviceShare,
         iv,
@@ -4177,7 +4332,7 @@ async function createDecaneConnect(config) {
         shareSet.device,
         iv
       );
-      await storage.putShare({
+      await storage2.putShare({
         userId,
         wrappedDeviceShare,
         iv,
@@ -4281,7 +4436,7 @@ async function createDecaneConnect(config) {
   async function returningUserUnlock(userId, jwt) {
     const rawAddresses = await api.getAddresses(jwt);
     const recordedAddresses = rawAddresses.evm && rawAddresses.solana ? { evm: rawAddresses.evm, solana: rawAddresses.solana, tron: rawAddresses.tron ?? evmToTronAddress2(rawAddresses.evm) } : null;
-    const stored = await storage.getShare(userId);
+    const stored = await storage2.getShare(userId);
     let deviceShare;
     let joinedViaPasskeySync = false;
     if (!stored) {
@@ -4320,7 +4475,7 @@ async function createDecaneConnect(config) {
         rpId,
         teeUrl,
         api,
-        storage,
+        storage: storage2,
         onProgress: config.onRecoveryProgress,
         promptForRecoveryFile: config.promptForRecoveryFile,
         onNewRecoveryShare: async (recoveryShare, shareSetVersion) => {
@@ -4334,7 +4489,7 @@ async function createDecaneConnect(config) {
       });
       deviceShare = recovered.deviceShare;
       joinedViaPasskeySync = recovered.flow === "passkey-sync";
-      if (!deferDeviceProtection && !await storage.getShare(userId) && isPasskeySupported()) {
+      if (!deferDeviceProtection && !await storage2.getShare(userId) && isPasskeySupported()) {
         await registerPasskeyAndBackup(userId, jwt, deviceShare);
       }
     } else {
@@ -4355,7 +4510,7 @@ async function createDecaneConnect(config) {
     } catch (e) {
       if (e instanceof StaleDeviceShareError) {
         zeroize(deviceShare);
-        await storage.deleteShare(userId);
+        await storage2.deleteShare(userId);
         if (stored) return returningUserUnlock(userId, jwt);
       } else {
         zeroize(deviceShare);
@@ -4379,7 +4534,7 @@ async function createDecaneConnect(config) {
     const result = await tee.rotateShares(jwt);
     try {
       await persistRotatedDeviceShare(userId, result.deviceShare);
-      const refreshed = await storage.getShare(userId);
+      const refreshed = await storage2.getShare(userId);
       if (refreshed?.unlockMethod === "passkey" && refreshed.credentialId && refreshed.prfSalt) {
         await api.putRecoveryBackup(jwt, {
           wrappedDeviceShare: refreshed.wrappedDeviceShare,
@@ -4412,13 +4567,13 @@ async function createDecaneConnect(config) {
   }
   async function passkeyLoginCandidate() {
     if (!persisted?.userId || !isPasskeySupported()) return null;
-    return usablePasskeyShare(await storage.getShare(persisted.userId));
+    return usablePasskeyShare(await storage2.getShare(persisted.userId));
   }
   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);
+    if (lastUserId) return usablePasskeyShare(await storage2.getShare(lastUserId));
+    const candidates = (await storage2.listShares()).map(usablePasskeyShare).filter(Boolean);
     return candidates.length === 1 ? candidates[0] : null;
   }
   async function canOfferPasskey() {
@@ -4426,15 +4581,15 @@ async function createDecaneConnect(config) {
     if (await passkeyDeviceCandidate()) return true;
     const known = persisted?.userId ?? lastUserId;
     if (!known) return false;
-    return await storage.getShare(known) == null;
+    return await storage2.getShare(known) == null;
   }
   async function rememberProfile(userId, profile) {
     const incoming = Object.fromEntries(Object.entries(profile).filter(([, v]) => v));
     if (!Object.keys(incoming).length) return;
     try {
-      const stored = await storage.getShare(userId);
+      const stored = await storage2.getShare(userId);
       if (!stored) return;
-      await storage.putShare({ ...stored, profile: { ...stored.profile, ...incoming } });
+      await storage2.putShare({ ...stored, profile: { ...stored.profile, ...incoming } });
     } catch {
     }
   }
@@ -4458,7 +4613,7 @@ async function createDecaneConnect(config) {
     savePersisted(PERSIST_KEY, persisted);
     events.emit("connected");
     persistLiveSession();
-    const stored = await storage.getShare(userId);
+    const stored = await storage2.getShare(userId);
     return {
       addresses,
       isNewUser: false,
@@ -4631,7 +4786,7 @@ async function createDecaneConnect(config) {
       events.emit("connected");
       persistLiveSession();
       scheduleAccessTokenExpiry(token, claims.expiresAt);
-      const stored = await storage.getShare(claims.userId);
+      const stored = await storage2.getShare(claims.userId);
       return {
         addresses,
         isNewUser: false,
@@ -4661,7 +4816,7 @@ async function createDecaneConnect(config) {
       const candidate = await passkeyDeviceCandidate();
       if (candidate) return passkeyLogin(candidate);
       const known = persisted?.userId ?? lastUserId;
-      if (isPasskeySupported() && known && await storage.getShare(known) == null) {
+      if (isPasskeySupported() && known && await storage2.getShare(known) == null) {
         return passkeyLoginWithoutShare(known);
       }
       throw new NewDeviceError();
@@ -4680,7 +4835,7 @@ async function createDecaneConnect(config) {
     async setUnlockPassword(password) {
       if (!auth) throw new ReconnectRequiredError();
       validateUnlockPassword(password);
-      const stored = await storage.getShare(auth.userId);
+      const stored = await storage2.getShare(auth.userId);
       if (!stored) throw new NewDeviceError();
       const deviceShare = await aesGcmDecrypt(
         await getWrappingKey(stored),
@@ -4699,7 +4854,7 @@ async function createDecaneConnect(config) {
         );
         const iv = generateRandomBytes(12);
         const wrappedDeviceShare = await aesGcmEncrypt(shareKey, deviceShare, iv);
-        await storage.putShare({
+        await storage2.putShare({
           ...stored,
           unlockMethod: "password",
           wrappedDeviceShare,
@@ -4779,9 +4934,9 @@ async function createDecaneConnect(config) {
     async removeUnlockPassword() {
       if (!auth) throw new ReconnectRequiredError();
       await api.revokeUnlockTokens(auth.jwt);
-      const stored = await storage.getShare(auth.userId);
+      const stored = await storage2.getShare(auth.userId);
       if (!stored || stored.unlockMethod !== "password") return;
-      await storage.putShare({
+      await storage2.putShare({
         ...stored,
         wrappedUnlockToken: void 0,
         unlockTokenIv: void 0
@@ -4789,13 +4944,13 @@ async function createDecaneConnect(config) {
     },
     async hasPasskey() {
       if (!auth) return false;
-      const stored = await storage.getShare(auth.userId);
+      const stored = await storage2.getShare(auth.userId);
       return stored?.unlockMethod === "passkey";
     },
     async addPasskey() {
       if (!auth) throw new ReconnectRequiredError();
       if (!isPasskeySupported()) throw new WebAuthnNotSupportedError();
-      const stored = await storage.getShare(auth.userId);
+      const stored = await storage2.getShare(auth.userId);
       if (stored?.unlockMethod === "passkey") return;
       if (!stored) {
         if (!serverAssistedRecovery) throw new NewDeviceError();
@@ -4828,11 +4983,11 @@ async function createDecaneConnect(config) {
     },
     async deviceProtected() {
       if (!auth) return false;
-      return await storage.getShare(auth.userId) !== null;
+      return await storage2.getShare(auth.userId) !== null;
     },
     async protectDevice() {
       if (!auth) throw new ReconnectRequiredError();
-      if (await storage.getShare(auth.userId)) return true;
+      if (await storage2.getShare(auth.userId)) return true;
       if (!serverAssistedRecovery) throw new NewDeviceError();
       const tee = new TeeClient(teeUrl);
       const provisioned = await tee.provisionDeviceShare(auth.jwt);
@@ -4842,7 +4997,7 @@ async function createDecaneConnect(config) {
       } finally {
         zeroize(provisioned);
       }
-      return await storage.getShare(auth.userId) !== null;
+      return await storage2.getShare(auth.userId) !== null;
     },
     async unlock() {
       if (!auth) {
@@ -4884,8 +5039,7 @@ async function createDecaneConnect(config) {
         return bufferToB64u(sig);
       }
       if (req.chain.startsWith("tron:")) {
-        const msg = typeof req.message === "string" ? req.message : new TextDecoder().decode(req.message);
-        return tee.sign({ chain: req.chain, kind: "message", payload: msg }, auth?.jwt);
+        return tee.sign({ chain: req.chain, kind: "message", payload: messageAsString(req.message) }, auth?.jwt);
       }
       throw new CallSequenceError(`Unsupported chain: ${req.chain}`);
     },