@did-btcr2/method 0.34.0 → 0.35.0

package/dist/browser.mjs

@@ -99982,6 +99982,13 @@ function compareBytes(a2, b) {
 // ../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();
@@ -100568,8 +100575,48 @@ function getBeaconStrategy(type) {
 
 // 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();
@@ -102768,6 +102815,48 @@ var Transaction = class _Transaction {
   }
 };
 
+// ../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();
@@ -103182,7 +103271,7 @@ var AggregationCohort = class {
     }
     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(
@@ -103479,8 +103568,14 @@ var BeaconSigningSession = class {
   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;
@@ -103632,22 +103727,24 @@ var BeaconSigningSession = class {
   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(
@@ -103657,10 +103754,23 @@ var BeaconSigningSession = class {
       [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 */;
@@ -103674,13 +103784,13 @@ var BeaconSigningSession = class {
 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) {
@@ -103773,7 +103883,7 @@ var AggregationService = class {
       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];
@@ -104184,12 +104294,17 @@ init_shim();
 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
@@ -104278,8 +104393,8 @@ var AggregationParticipant = class {
       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];
   }
@@ -104309,7 +104424,7 @@ var AggregationParticipant = class {
     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 */;
@@ -104476,9 +104591,8 @@ var AggregationParticipant = class {
       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({
@@ -104521,7 +104635,10 @@ var AggregationParticipant = class {
         { 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,
@@ -104534,6 +104651,37 @@ var AggregationParticipant = class {
   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
@@ -105290,7 +105438,7 @@ var HttpClientTransport = class {
       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",
@@ -105467,7 +105615,7 @@ function sleep(ms2, signal) {
     else signal.addEventListener("abort", onAbort, { once: true });
   });
 }
-async function safeText(res) {
+async function safeText2(res) {
   try {
     return await res.text();
   } catch {
@@ -111046,10 +111194,10 @@ var InMemoryTransport = class {
   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) {
@@ -111272,8 +111420,11 @@ var AggregationServiceRunner = class _AggregationServiceRunner extends TypedEven
     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
     });
   }
@@ -111626,7 +111777,10 @@ var AggregationParticipantRunner = class _AggregationParticipantRunner extends T
     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}
@@ -111639,6 +111793,7 @@ var AggregationParticipantRunner = class _AggregationParticipantRunner extends T
   stop() {
     this.#stopped = true;
     this.#unregisterHandlers();
+    this.session.clearSecrets();
   }
   /** Message types this runner listens for on the transport. */
   static #HANDLED_MESSAGE_TYPES = [
@@ -112480,84 +112635,6 @@ init_shim();
 // 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();
 
@@ -129024,6 +129101,7 @@ export {
   InMemoryRateLimitStore,
   InMemoryTransport,
   InboxBuffer,
+  KeyPairAggregationSigner,
   NONCE_CONTRIBUTION,
   NonceCache,
   NostrTransport,