@did-btcr2/method 0.34.0 → 0.35.0

package/dist/browser.js

@@ -93203,6 +93203,7 @@ a=end-of-candidates
     InMemoryRateLimitStore: () => InMemoryRateLimitStore,
     InMemoryTransport: () => InMemoryTransport,
     InboxBuffer: () => InboxBuffer,
+    KeyPairAggregationSigner: () => KeyPairAggregationSigner,
     NONCE_CONTRIBUTION: () => NONCE_CONTRIBUTION,
     NonceCache: () => NonceCache,
     NostrTransport: () => NostrTransport,
@@ -100117,6 +100118,13 @@ a=end-of-candidates
   // ../keypair/dist/esm/types.js
   init_shim();
 
+  // ../keypair/dist/esm/utils.js
+  init_shim();
+  function wipe(bytes3) {
+    if (bytes3)
+      bytes3.fill(0);
+  }
+
   // ../cryptosuite/dist/esm/multikey/index.js
   init_secp256k1();
   init_utils();
@@ -100703,8 +100711,48 @@ a=end-of-candidates
 
   // src/core/aggregation/cohort.ts
   init_shim();
-  init_secp256k1();
-  init_utils();
+
+  // ../bitcoin/dist/esm/index.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/connection.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/client/rest/index.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/client/rest/address.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/client/rest/block.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/errors.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/client/rest/transaction.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/client/rest/protocol.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/client/http.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/client/rpc/index.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/client/rpc/json-rpc.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/client/utils.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/client/rpc/protocol.js
+  init_shim();
+
+  // ../bitcoin/dist/esm/network.js
+  init_shim();
 
   // ../../node_modules/.pnpm/@scure+btc-signer@1.8.1/node_modules/@scure/btc-signer/esm/index.js
   init_shim();
@@ -102903,6 +102951,48 @@ a=end-of-candidates
     }
   };
 
+  // ../bitcoin/dist/esm/network.js
+  var REGTEST_NETWORK = {
+    bech32: "bcrt",
+    pubKeyHash: 111,
+    scriptHash: 196,
+    wif: 239
+  };
+  function getNetwork(network) {
+    switch (network) {
+      case "bitcoin":
+        return NETWORK;
+      case "testnet3":
+      case "testnet4":
+      case "signet":
+      case "mutinynet":
+        return TEST_NETWORK;
+      case "regtest":
+        return REGTEST_NETWORK;
+      default:
+        throw new Error(`Unknown network "${network}"`);
+    }
+  }
+
+  // ../bitcoin/dist/esm/constants.js
+  init_shim();
+  var TXIN_WITNESS_COINBASE = "0000000000000000000000000000000000000000000000000000000000000000";
+  var GENESIS_TX_ID = "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b";
+
+  // ../bitcoin/dist/esm/types.js
+  init_shim();
+  var VerbosityLevel;
+  (function(VerbosityLevel2) {
+    VerbosityLevel2[VerbosityLevel2["hex"] = 0] = "hex";
+    VerbosityLevel2[VerbosityLevel2["json"] = 1] = "json";
+    VerbosityLevel2[VerbosityLevel2["jsonext"] = 2] = "jsonext";
+    VerbosityLevel2[VerbosityLevel2["jsonextprev"] = 3] = "jsonextprev";
+  })(VerbosityLevel || (VerbosityLevel = {}));
+
+  // src/core/aggregation/cohort.ts
+  init_secp256k1();
+  init_utils();
+
   // ../../node_modules/.pnpm/@scure+btc-signer@1.8.1/node_modules/@scure/btc-signer/esm/musig2.js
   init_shim();
   init_modular();
@@ -103317,7 +103407,7 @@ a=end-of-candidates
       }
       const keyAggContext = keyAggregate(this.#cohortKeys);
       const aggPubkey = keyAggExport(keyAggContext);
-      const payment = p2tr(aggPubkey);
+      const payment = p2tr(aggPubkey, void 0, getNetwork(this.network));
       this.tapTweak = schnorr2.utils.taggedHash("TapTweak", aggPubkey);
       if (!payment.address) {
         throw new AggregationCohortError(
@@ -103614,8 +103704,14 @@ a=end-of-candidates
     signature;
     /** Current signing session phase. */
     phase;
-    /** Participant's secret nonce (held only by the participant during signing). */
-    secretNonce;
+    /**
+     * Participant's MuSig2 secret nonce, held only on the participant side
+     * between {@link generateNonceContribution} and {@link generatePartialSignature}.
+     * Private and cleared on every terminal path (success, failure, or teardown
+     * via {@link clearSecrets}) so a spent or abandoned nonce cannot be reused or
+     * serialized.
+     */
+    #secretNonce;
     constructor({ id, cohort, pendingTx, prevOutScripts, prevOutValues }) {
       this.id = id || crypto.randomUUID();
       this.cohort = cohort;
@@ -103767,22 +103863,24 @@ a=end-of-candidates
     generateNonceContribution(participantPublicKey, participantSecretKey) {
       const aggPublicKey = keyAggExport(keyAggregate(this.cohort.cohortKeys));
       const nonces = nonceGen(participantPublicKey, participantSecretKey, aggPublicKey);
-      this.secretNonce = nonces.secret;
+      this.#secretNonce = nonces.secret;
       return nonces.public;
     }
     /**
      * Generates a partial signature using the participant's secret key + secret nonce.
      * Requires the aggregated nonce to have been set first (via the service).
      *
-     * Zeros the stored `secretNonce` after use. JS cannot truly erase memory (GC
-     * and immutable strings), but overwriting the bytes shortens the exposure
-     * window and prevents accidental reuse or serialization of a spent nonce.
+     * Clears the stored secret nonce after use on every path (success or throw)
+     * via {@link clearSecrets}. JS cannot truly erase memory (GC may relocate
+     * buffers), but overwriting the bytes shortens the exposure window and
+     * prevents accidental reuse or serialization of a spent nonce - reuse of a
+     * MuSig2 nonce leaks the secret key.
      */
     generatePartialSignature(participantSecretKey) {
       if (!this.aggregatedNonce) {
         throw new SigningSessionError("Aggregated nonce not available.", "MISSING_AGGREGATED_NONCE");
       }
-      if (!this.secretNonce) {
+      if (!this.#secretNonce) {
         throw new SigningSessionError("Secret nonce not available \u2014 generateNonceContribution() must be called first.", "MISSING_SECRET_NONCE");
       }
       const session = new Session(
@@ -103792,10 +103890,23 @@ a=end-of-candidates
         [this.cohort.tapTweak],
         [true]
       );
-      const partialSig = session.sign(this.secretNonce, participantSecretKey);
-      this.secretNonce.fill(0);
-      this.secretNonce = void 0;
-      return partialSig;
+      try {
+        return session.sign(this.#secretNonce, participantSecretKey);
+      } finally {
+        this.clearSecrets();
+      }
+    }
+    /**
+     * Zeroize any retained secret nonce. Safe to call repeatedly and on any path
+     * (completion, failure, or teardown of an abandoned session). Callers that
+     * drop a session before it reaches a partial signature should invoke this so
+     * the secret nonce does not linger on the live object.
+     */
+    clearSecrets() {
+      if (this.#secretNonce) {
+        wipe(this.#secretNonce);
+        this.#secretNonce = void 0;
+      }
     }
     isComplete() {
       return this.phase === "Complete" /* Complete */;
@@ -103809,13 +103920,13 @@ a=end-of-candidates
   var DEFAULT_MAX_UPDATE_SIZE_BYTES = 256 * 1024;
   var AggregationService = class {
     did;
-    keys;
+    publicKey;
     maxUpdateSizeBytes;
     /** Per-cohort state, keyed by cohortId. */
     #cohortStates = /* @__PURE__ */ new Map();
-    constructor({ did, keys, maxUpdateSizeBytes }) {
+    constructor({ did, publicKey: publicKey2, maxUpdateSizeBytes }) {
       this.did = did;
-      this.keys = keys;
+      this.publicKey = publicKey2;
       this.maxUpdateSizeBytes = maxUpdateSizeBytes ?? DEFAULT_MAX_UPDATE_SIZE_BYTES;
     }
     receive(message2) {
@@ -103908,7 +104019,7 @@ a=end-of-candidates
         cohortSize: state.config.minParticipants,
         beaconType: state.config.beaconType,
         network: state.config.network,
-        communicationPk: this.keys.publicKey.compressed
+        communicationPk: this.publicKey.compressed
       });
       state.phase = "Advertised" /* Advertised */;
       return [message2];
@@ -104319,12 +104430,17 @@ a=end-of-candidates
   init_utils();
   var AggregationParticipant = class {
     did;
-    keys;
+    /** MuSig2 signing capability. The raw secret never lives as a field here. */
+    #signer;
     /** Per-cohort state, keyed by cohortId. */
     #cohortStates = /* @__PURE__ */ new Map();
-    constructor({ did, keys }) {
+    constructor({ did, signer }) {
       this.did = did;
-      this.keys = keys;
+      this.#signer = signer;
+    }
+    /** The participant's compressed (33-byte) MuSig2 public key. Not secret. */
+    get publicKey() {
+      return this.#signer.publicKey;
     }
     /**
      * Process an incoming message. Updates internal state but never produces
@@ -104413,8 +104529,8 @@ a=end-of-candidates
         from: this.did,
         to: state.serviceDid,
         cohortId,
-        participantPk: this.keys.publicKey.compressed,
-        communicationPk: this.keys.publicKey.compressed
+        participantPk: this.publicKey,
+        communicationPk: this.publicKey
       });
       return [optInMessage];
     }
@@ -104444,7 +104560,7 @@ a=end-of-candidates
       const beaconAddress = message2.body?.beaconAddress;
       const cohortKeys = message2.body?.cohortKeys;
       if (!beaconAddress || !cohortKeys) return;
-      const participantPkHex = bytesToHex(this.keys.publicKey.compressed);
+      const participantPkHex = bytesToHex(this.publicKey);
       const cohortKeysHex = cohortKeys.map((k) => bytesToHex(new Uint8Array(k)));
       state.cohort.validateMembership(participantPkHex, cohortKeysHex, beaconAddress);
       state.phase = "CohortReady" /* CohortReady */;
@@ -104611,9 +104727,8 @@ a=end-of-candidates
         prevOutValues
       });
       state.signingSession = session;
-      const nonceContribution = session.generateNonceContribution(
-        this.keys.publicKey.compressed,
-        this.keys.secretKey.bytes
+      const nonceContribution = this.#signer.withSecret(
+        (secretKey) => session.generateNonceContribution(this.publicKey, secretKey)
       );
       state.phase = "NonceSent" /* NonceSent */;
       return [createNonceContributionMessage({
@@ -104656,7 +104771,10 @@ a=end-of-candidates
           { cohortId }
         );
       }
-      const partialSig = state.signingSession.generatePartialSignature(this.keys.secretKey.bytes);
+      const signingSession = state.signingSession;
+      const partialSig = this.#signer.withSecret(
+        (secretKey) => signingSession.generatePartialSignature(secretKey)
+      );
       state.phase = "Complete" /* Complete */;
       return [createSignatureAuthorizationMessage({
         from: this.did,
@@ -104669,6 +104787,37 @@ a=end-of-candidates
     getCohortPhase(cohortId) {
       return this.#cohortStates.get(cohortId)?.phase;
     }
+    /**
+     * Zeroize any retained MuSig2 secret nonces across all cohorts. The raw
+     * signing key is never held here (it lives behind the {@link AggregationSigner}
+     * and is wiped per-operation), but an abandoned signing session can still hold
+     * a secret nonce; call this on teardown to clear it deterministically.
+     */
+    clearSecrets() {
+      for (const state of this.#cohortStates.values()) {
+        state.signingSession?.clearSecrets();
+      }
+    }
+  };
+
+  // src/core/aggregation/signer.ts
+  init_shim();
+  var KeyPairAggregationSigner = class {
+    publicKey;
+    #keys;
+    /** @param {SchnorrKeyPair} keys The keypair whose secret backs this signer. */
+    constructor(keys) {
+      this.#keys = keys;
+      this.publicKey = keys.publicKey.compressed;
+    }
+    withSecret(fn) {
+      const secretKey = this.#keys.secretKey.bytes;
+      try {
+        return fn(secretKey);
+      } finally {
+        wipe(secretKey);
+      }
+    }
   };
 
   // src/core/aggregation/logger.ts
@@ -105425,7 +105574,7 @@ ${value2}`;
         body: JSON.stringify(envelope)
       });
       if (!res.ok) {
-        const body = await safeText(res);
+        const body = await safeText2(res);
         throw new HttpTransportError(
           `sendMessage failed: HTTP ${res.status}`,
           "SEND_MESSAGE_HTTP",
@@ -105602,7 +105751,7 @@ ${value2}`;
       else signal.addEventListener("abort", onAbort, { once: true });
     });
   }
-  async function safeText(res) {
+  async function safeText2(res) {
     try {
       return await res.text();
     } catch {
@@ -111181,10 +111330,10 @@ ${value2}`;
     start() {
     }
     registerActor(did, keys) {
-      this.#actors.set(did, { keys, handlers: /* @__PURE__ */ new Map() });
+      this.#actors.set(did, { publicKey: keys.publicKey.compressed, handlers: /* @__PURE__ */ new Map() });
     }
     getActorPk(did) {
-      return this.#actors.get(did)?.keys.publicKey.compressed;
+      return this.#actors.get(did)?.publicKey;
     }
     /** True if `did` is registered on this transport. Used by the bus for routing. */
     hasActor(did) {
@@ -111407,8 +111556,11 @@ ${value2}`;
       this.#phaseTimeoutMs = options2.phaseTimeoutMs;
       this.#advertRepeatIntervalMs = options2.advertRepeatIntervalMs ?? DEFAULT_ADVERT_REPEAT_INTERVAL_MS;
       this.session = new AggregationService({
+        // The coordinator never signs, so the state machine receives only the
+        // public half of the operator's keypair (see ADR 038). The full keypair
+        // remains the operator's transport/communication identity.
         did: options2.did,
-        keys: options2.keys,
+        publicKey: options2.keys.publicKey,
         maxUpdateSizeBytes: options2.maxUpdateSizeBytes
       });
     }
@@ -111761,7 +111913,10 @@ ${value2}`;
       this.#onProvideUpdate = options2.onProvideUpdate;
       this.#onValidateData = options2.onValidateData ?? (async (info) => ({ approved: info.matches }));
       this.#onApproveSigning = options2.onApproveSigning ?? (async () => ({ approved: true }));
-      this.session = new AggregationParticipant({ did: options2.did, keys: options2.keys });
+      this.session = new AggregationParticipant({
+        did: options2.did,
+        signer: new KeyPairAggregationSigner(options2.keys)
+      });
     }
     /**
      * Start listening for cohorts. The runner stays active until {@link stop}
@@ -111774,6 +111929,7 @@ ${value2}`;
     stop() {
       this.#stopped = true;
       this.#unregisterHandlers();
+      this.session.clearSecrets();
     }
     /** Message types this runner listens for on the transport. */
     static #HANDLED_MESSAGE_TYPES = [
@@ -112615,84 +112771,6 @@ ${value2}`;
   // src/core/beacon/signal-discovery.ts
   init_shim();
 
-  // ../bitcoin/dist/esm/index.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/connection.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/client/rest/index.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/client/rest/address.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/client/rest/block.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/errors.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/client/rest/transaction.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/client/rest/protocol.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/client/http.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/client/rpc/index.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/client/rpc/json-rpc.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/client/utils.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/client/rpc/protocol.js
-  init_shim();
-
-  // ../bitcoin/dist/esm/network.js
-  init_shim();
-  var REGTEST_NETWORK = {
-    bech32: "bcrt",
-    pubKeyHash: 111,
-    scriptHash: 196,
-    wif: 239
-  };
-  function getNetwork(network) {
-    switch (network) {
-      case "bitcoin":
-        return NETWORK;
-      case "testnet3":
-      case "testnet4":
-      case "signet":
-      case "mutinynet":
-        return TEST_NETWORK;
-      case "regtest":
-        return REGTEST_NETWORK;
-      default:
-        throw new Error(`Unknown network "${network}"`);
-    }
-  }
-
-  // ../bitcoin/dist/esm/constants.js
-  init_shim();
-  var TXIN_WITNESS_COINBASE = "0000000000000000000000000000000000000000000000000000000000000000";
-  var GENESIS_TX_ID = "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b";
-
-  // ../bitcoin/dist/esm/types.js
-  init_shim();
-  var VerbosityLevel;
-  (function(VerbosityLevel2) {
-    VerbosityLevel2[VerbosityLevel2["hex"] = 0] = "hex";
-    VerbosityLevel2[VerbosityLevel2["json"] = 1] = "json";
-    VerbosityLevel2[VerbosityLevel2["jsonext"] = 2] = "jsonext";
-    VerbosityLevel2[VerbosityLevel2["jsonextprev"] = 3] = "jsonextprev";
-  })(VerbosityLevel || (VerbosityLevel = {}));
-
   // src/core/beacon/utils.ts
   init_shim();