@1shotapi/ows-signer 0.3.0 → 0.3.2

package/README.md

@@ -40,7 +40,8 @@ Only accepts messages when `event.source === window.parent`. Replies use the par
 | `createCredential` | `name`, `options?` (incl. ceremony UI) | `KeyDerived`, `CredentialCreated` |
 | `signDigest` | `digests[]`, `credentialId?`, ceremony UI? | `KeyDerived` (PRF path), `DigestSigned` (`results[]`) |
 | `executeBatch` | batch fields + ceremony UI? | `KeyDerived` (when keys derived), `BatchExecuted` |
-| `revealPrivateKey` | `credentialId?`, ceremony UI? | `KeyDerived` (+ DOM display) |
+| `revealPrivateKey` | `credentialId?`, ceremony UI? | `KeyDerived`, then `PrivateKeyRevealed` (after user dismisses DOM key UI) |
+| `importPrivateKey` | — | DOM hex input; `KeyDerived`, `RecoverySessionStarted` |
 | `createRecoveryData` | passphrase fields + ceremony UI? | `KeyDerived`, `RecoveryDataCreated` |
 | `recoverKey` | envelope + passphrase fields + ceremony UI? | DOM display; `RecoverySessionStarted` or re-bind → `RecoverySessionCleared` |
 | `getPublicKey` | `credentialId?`, `challenge?`, ceremony UI? | `KeyDerived`, `PublicKey`, `ChallengeSigned?` |

package/html/index.html

@@ -77,6 +77,12 @@
       flex-wrap: wrap;
       gap: 8px;
     }
+    .ows-actions {
+      flex: 0 0 auto;
+      display: flex;
+      flex-wrap: wrap;
+      gap: 8px;
+    }
     .ows-copy,
     .ows-confirm,
     .ows-deny {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1shotapi/ows-signer",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "OWS Signing Layer — plain JavaScript WebAuthn PRF key custody with curve-based signing (on-chain via EIP-8244)",
   "type": "module",
   "files": [

package/src/constants.js

@@ -21,6 +21,7 @@ export const METHODS = [
   "createCredential",
   "signDigest",
   "revealPrivateKey",
+  "importPrivateKey",
   "createRecoveryData",
   "recoverKey",
   "getPublicKey",

package/src/handlers.js

@@ -16,7 +16,7 @@ import {
   normalizePrfOutputToArrayBuffer,
 } from "./crypto/prf.js";
 import { getPublicKeyAsync as edGetPublicKeyAsync } from "./crypto/vendor/noble-ed25519.js";
-import { getPublicKey as secpGetPublicKey } from "./crypto/vendor/noble-secp256k1.js";
+import { getPublicKey as secpGetPublicKey, utils as secpUtils } from "./crypto/vendor/noble-secp256k1.js";
 import { debugLog, describePrfExtensionResults } from "./debug.js";
 import { decryptPrivateKey, encryptPrivateKey } from "./crypto/recovery.js";
 import { signWithScheme, validateSignPayload } from "./crypto/sign.js";
@@ -30,7 +30,14 @@ import {
   withCeremony,
   zeroize,
 } from "./state.js";
-import { clearUi, CeremonyDeniedError, promptCeremonyConfirm, promptPassphrase, showPrivateKey } from "./ui.js";
+import {
+  clearUi,
+  CeremonyDeniedError,
+  promptCeremonyConfirm,
+  promptPassphrase,
+  promptPrivateKey,
+  showPrivateKey,
+} from "./ui.js";
 import {
   createPasskeyCredential,
   getAssertionSignatureBase64Url,
@@ -126,6 +133,10 @@ export async function handleRequest(
         await handleRevealPrivateKey(params, correlationId, targetOrigin);
         return;
 
+      case "importPrivateKey":
+        await handleImportPrivateKey(params, correlationId, targetOrigin);
+        return;
+
       case "createRecoveryData":
         await handleCreateRecoveryData(params, correlationId, targetOrigin);
         return;
@@ -445,9 +456,79 @@ async function handleRevealPrivateKey(params, correlationId, targetOrigin) {
       keys.secp256k1PublicKey,
       keys.ed25519PublicKey,
     );
-    showPrivateKey(keys.secp256k1PrivateKey);
-    zeroize(keys.secp256k1PrivateKey);
+    try {
+      const dismiss = showPrivateKey(keys.secp256k1PrivateKey);
+      zeroize(keys.secp256k1PrivateKey);
+      await dismiss;
+    } finally {
+      zeroize(keys.secp256k1PrivateKey);
+    }
   });
+  emitEvent(
+    window.parent,
+    targetOrigin,
+    "PrivateKeyRevealed",
+    correlationId,
+    {},
+  );
+}
+
+/**
+ * Paste a secp256k1 private key hex into the Signing Layer and start a recovery
+ * session (same session semantics as `recoverKey` without a backup envelope).
+ *
+ * @param {Record<string, unknown>} _params
+ * @param {string | undefined} correlationId
+ * @param {string} targetOrigin
+ */
+async function handleImportPrivateKey(_params, correlationId, targetOrigin) {
+  const raw = await promptPrivateKey();
+  let privateKey;
+  try {
+    privateKey = parseImportedPrivateKeyHex(raw);
+  } catch {
+    emitInvalid(correlationId, targetOrigin, "invalidPrivateKey");
+    return;
+  }
+  if (!secpUtils.isValidPrivateKey(privateKey)) {
+    zeroize(privateKey);
+    emitInvalid(correlationId, targetOrigin, "invalidPrivateKey");
+    return;
+  }
+
+  setRecoveryPrivateKey(privateKey);
+
+  const secp256k1PublicKey = secpGetPublicKey(privateKey, false);
+  const ed25519Seed = await ed25519SeedFromSecp256k1Scalar(privateKey);
+  const ed25519PublicKey = await edGetPublicKeyAsync(ed25519Seed);
+  emitKeyDerived(
+    targetOrigin,
+    correlationId,
+    secp256k1PublicKey,
+    ed25519PublicKey,
+  );
+  zeroize(ed25519Seed);
+
+  emitEvent(
+    window.parent,
+    targetOrigin,
+    "RecoverySessionStarted",
+    correlationId,
+    { recoverySessionActive: true },
+  );
+}
+
+/**
+ * @param {string} raw
+ * @returns {Uint8Array}
+ */
+function parseImportedPrivateKeyHex(raw) {
+  const trimmed = raw.trim();
+  const withPrefix =
+    trimmed.startsWith("0x") || trimmed.startsWith("0X")
+      ? trimmed
+      : `0x${trimmed}`;
+  return parse0xHex(withPrefix, 32);
 }
 
 /**

package/src/ui.js

@@ -225,23 +225,43 @@ export function promptCeremonyConfirm(fields, runOnConfirm) {
 }
 
 /**
+ * Show the private key hex with Copy + Done. Resolves when the user clicks Done
+ * (or the UI is cleared), so Branding can keep the ceremony panel open.
+ *
  * @param {Uint8Array} privateKey
+ * @returns {Promise<void>}
  */
 export function showPrivateKey(privateKey) {
-  if (!root) return;
+  if (!root) {
+    return Promise.reject(new Error("uiNotInitialized"));
+  }
   cancelPendingCeremonyConfirm();
   clearUi();
-  const pre = document.createElement("pre");
-  pre.className = "ows-key";
-  pre.textContent = to0xHex(privateKey);
-  const copyBtn = document.createElement("button");
-  copyBtn.type = "button";
-  copyBtn.className = "ows-copy";
-  copyBtn.textContent = "Copy";
-  copyBtn.addEventListener("click", async () => {
-    await navigator.clipboard.writeText(pre.textContent ?? "");
+  const hex = to0xHex(privateKey);
+  return new Promise((resolve) => {
+    const pre = document.createElement("pre");
+    pre.className = "ows-key";
+    pre.textContent = hex;
+    const copyBtn = document.createElement("button");
+    copyBtn.type = "button";
+    copyBtn.className = "ows-copy";
+    copyBtn.textContent = "Copy";
+    copyBtn.addEventListener("click", async () => {
+      await navigator.clipboard.writeText(pre.textContent ?? "");
+    });
+    const doneBtn = document.createElement("button");
+    doneBtn.type = "button";
+    doneBtn.className = "ows-confirm";
+    doneBtn.textContent = "Done";
+    doneBtn.addEventListener("click", () => {
+      clearUi();
+      resolve();
+    });
+    const actions = document.createElement("div");
+    actions.className = "ows-actions";
+    actions.append(copyBtn, doneBtn);
+    root.append(pre, actions);
   });
-  root.append(pre, copyBtn);
 }
 
 /**
@@ -282,3 +302,68 @@ export function promptPassphrase(passwordText, buttonText, minPasswordLength) {
     root.append(input, button);
   });
 }
+
+/**
+ * Prompt for a secp256k1 private key hex (with or without `0x`). Resolves with
+ * the trimmed hex string the user entered; rejects on Cancel.
+ *
+ * @returns {Promise<string>}
+ */
+export function promptPrivateKey() {
+  if (!root) {
+    return Promise.reject(new Error("uiNotInitialized"));
+  }
+  cancelPendingCeremonyConfirm();
+  clearUi();
+  return new Promise((resolve, reject) => {
+    const header = document.createElement("h2");
+    header.className = "ows-ceremony-header";
+    header.textContent = "Import private key";
+    const body = document.createElement("p");
+    body.className = "ows-ceremony-text";
+    body.textContent =
+      "Paste your secp256k1 private key. It stays in this secure panel and is never sent to the host.";
+    const input = document.createElement("input");
+    input.type = "password";
+    input.className = "ows-password";
+    input.placeholder = "0x…";
+    input.autocomplete = "off";
+    input.spellcheck = false;
+    const errorEl = document.createElement("p");
+    errorEl.className = "ows-ceremony-text";
+    errorEl.style.color = "tomato";
+    errorEl.hidden = true;
+    const confirmBtn = document.createElement("button");
+    confirmBtn.type = "button";
+    confirmBtn.className = "ows-confirm";
+    confirmBtn.textContent = "Import";
+    const denyBtn = document.createElement("button");
+    denyBtn.type = "button";
+    denyBtn.className = "ows-deny";
+    denyBtn.textContent = "Cancel";
+    const actions = document.createElement("div");
+    actions.className = "ows-actions";
+    actions.append(confirmBtn, denyBtn);
+
+    const finish = (fn) => {
+      clearUi();
+      fn();
+    };
+
+    confirmBtn.addEventListener("click", () => {
+      const value = input.value.trim();
+      if (!value) {
+        errorEl.textContent = "Enter a private key.";
+        errorEl.hidden = false;
+        return;
+      }
+      finish(() => resolve(value));
+    });
+    denyBtn.addEventListener("click", () => {
+      finish(() => reject(new CeremonyDeniedError()));
+    });
+
+    root.append(header, body, input, errorEl, actions);
+    input.focus();
+  });
+}