@did-btcr2/method 0.33.0 → 0.35.0

package/dist/cjs/index.js

@@ -40,6 +40,7 @@ __export(index_exports, {
   AggregationParticipant: () => AggregationParticipant,
   AggregationParticipantError: () => AggregationParticipantError,
   AggregationParticipantRunner: () => AggregationParticipantRunner,
+  AggregationRunner: () => AggregationRunner,
   AggregationService: () => AggregationService,
   AggregationServiceError: () => AggregationServiceError,
   AggregationServiceRunner: () => AggregationServiceRunner,
@@ -47,7 +48,6 @@ __export(index_exports, {
   BECH32M_CHARS: () => BECH32M_CHARS,
   BTCR2_DID_DOCUMENT_CONTEXT: () => BTCR2_DID_DOCUMENT_CONTEXT,
   BaseMessage: () => BaseMessage,
-  Beacon: () => Beacon,
   BeaconError: () => BeaconError,
   BeaconFactory: () => BeaconFactory,
   BeaconSignalDiscovery: () => BeaconSignalDiscovery,
@@ -82,8 +82,11 @@ __export(index_exports, {
   HttpTransportError: () => HttpTransportError,
   ID_PLACEHOLDER_VALUE: () => ID_PLACEHOLDER_VALUE,
   Identifier: () => Identifier,
+  InMemoryBus: () => InMemoryBus,
   InMemoryRateLimitStore: () => InMemoryRateLimitStore,
+  InMemoryTransport: () => InMemoryTransport,
   InboxBuffer: () => InboxBuffer,
+  KeyPairAggregationSigner: () => KeyPairAggregationSigner,
   NONCE_CONTRIBUTION: () => NONCE_CONTRIBUTION,
   NonceCache: () => NonceCache,
   NostrTransport: () => NostrTransport,
@@ -104,6 +107,7 @@ __export(index_exports, {
   ServiceCohortPhase: () => ServiceCohortPhase,
   SigningSessionError: () => SigningSessionError,
   SigningSessionPhase: () => SigningSessionPhase,
+  SinglePartyBeacon: () => SinglePartyBeacon,
   SingletonBeacon: () => SingletonBeacon,
   SingletonBeaconError: () => SingletonBeaconError,
   StaticFeeEstimator: () => StaticFeeEstimator,
@@ -221,6 +225,7 @@ function getBeaconStrategy(type) {
 }
 
 // src/core/aggregation/cohort.ts
+var import_bitcoin = require("@did-btcr2/bitcoin");
 var import_common3 = require("@did-btcr2/common");
 var import_smt2 = require("@did-btcr2/smt");
 var import_secp256k1 = require("@noble/curves/secp256k1.js");
@@ -322,7 +327,7 @@ var AggregationCohort = class {
     }
     const keyAggContext = (0, import_musig2.keyAggregate)(this.#cohortKeys);
     const aggPubkey = (0, import_musig2.keyAggExport)(keyAggContext);
-    const payment = (0, import_btc_signer.p2tr)(aggPubkey);
+    const payment = (0, import_btc_signer.p2tr)(aggPubkey, void 0, (0, import_bitcoin.getNetwork)(this.network));
     this.tapTweak = import_secp256k1.schnorr.utils.taggedHash("TapTweak", aggPubkey);
     if (!payment.address) {
       throw new AggregationCohortError(
@@ -593,6 +598,7 @@ var SigningSessionPhase = /* @__PURE__ */ ((SigningSessionPhase2) => {
 })(SigningSessionPhase || {});
 
 // src/core/aggregation/signing-session.ts
+var import_keypair = require("@did-btcr2/keypair");
 var import_btc_signer2 = require("@scure/btc-signer");
 var musig2 = __toESM(require("@scure/btc-signer/musig2"), 1);
 var BeaconSigningSession = class {
@@ -616,8 +622,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;
@@ -769,22 +781,24 @@ var BeaconSigningSession = class {
   generateNonceContribution(participantPublicKey, participantSecretKey) {
     const aggPublicKey = musig2.keyAggExport(musig2.keyAggregate(this.cohort.cohortKeys));
     const nonces = musig2.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 musig2.Session(
@@ -794,10 +808,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) {
+      (0, import_keypair.wipe)(this.#secretNonce);
+      this.#secretNonce = void 0;
+    }
   }
   isComplete() {
     return this.phase === "Complete" /* Complete */;
@@ -811,13 +838,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, maxUpdateSizeBytes }) {
     this.did = did;
-    this.keys = keys;
+    this.publicKey = publicKey;
     this.maxUpdateSizeBytes = maxUpdateSizeBytes ?? DEFAULT_MAX_UPDATE_SIZE_BYTES;
   }
   receive(message) {
@@ -910,7 +937,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 [message];
@@ -1322,12 +1349,17 @@ var import_utils3 = require("@noble/hashes/utils");
 var import_btc_signer3 = require("@scure/btc-signer");
 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
@@ -1416,8 +1448,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];
   }
@@ -1448,7 +1480,7 @@ var AggregationParticipant = class {
     const beaconAddress = message.body?.beaconAddress;
     const cohortKeys = message.body?.cohortKeys;
     if (!beaconAddress || !cohortKeys) return;
-    const participantPkHex = (0, import_utils3.bytesToHex)(this.keys.publicKey.compressed);
+    const participantPkHex = (0, import_utils3.bytesToHex)(this.publicKey);
     const cohortKeysHex = cohortKeys.map((k) => (0, import_utils3.bytesToHex)(new Uint8Array(k)));
     state.cohort.validateMembership(participantPkHex, cohortKeysHex, beaconAddress);
     state.phase = "CohortReady" /* CohortReady */;
@@ -1615,9 +1647,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({
@@ -1660,7 +1691,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,
@@ -1673,6 +1707,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
+var import_keypair2 = require("@did-btcr2/keypair");
+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 {
+      (0, import_keypair2.wipe)(secretKey);
+    }
+  }
 };
 
 // src/core/aggregation/logger.ts
@@ -1784,11 +1849,11 @@ var TransportAdapterError = class extends import_common6.MethodError {
 var import_common10 = require("@did-btcr2/common");
 
 // src/core/aggregation/transport/http/client.ts
-var import_keypair2 = require("@did-btcr2/keypair");
+var import_keypair4 = require("@did-btcr2/keypair");
 
 // src/core/identifier.ts
 var import_common7 = require("@did-btcr2/common");
-var import_keypair = require("@did-btcr2/keypair");
+var import_keypair3 = require("@did-btcr2/keypair");
 var import_base4 = require("@scure/base");
 var Identifier = class _Identifier {
   /**
@@ -1821,7 +1886,7 @@ var Identifier = class _Identifier {
     }
     if (idType === "KEY") {
       try {
-        new import_keypair.CompressedSecp256k1PublicKey(genesisBytes);
+        new import_keypair3.CompressedSecp256k1PublicKey(genesisBytes);
       } catch {
         throw new import_common7.IdentifierError(
           'Expected "genesisBytes" to be a valid compressed secp256k1 public key',
@@ -1923,7 +1988,7 @@ var Identifier = class _Identifier {
     const genesisBytes = dataBytes.slice(byteIndex + 1);
     if (idType === "KEY") {
       try {
-        new import_keypair.CompressedSecp256k1PublicKey(genesisBytes);
+        new import_keypair3.CompressedSecp256k1PublicKey(genesisBytes);
       } catch {
         throw new import_common7.IdentifierError(`Invalid genesisBytes: ${genesisBytes}`, import_common7.INVALID_DID, { identifier });
       }
@@ -1935,7 +2000,7 @@ var Identifier = class _Identifier {
    * @returns {string} The new did:btcr2 identifier.
    */
   static generate() {
-    const keyPair = import_keypair.SchnorrKeyPair.generate();
+    const keyPair = import_keypair3.SchnorrKeyPair.generate();
     const did = this.encode(
       keyPair.publicKey.compressed,
       {
@@ -1961,7 +2026,7 @@ var Identifier = class _Identifier {
         { did, idType }
       );
     }
-    return new import_keypair.CompressedSecp256k1PublicKey(genesisBytes);
+    return new import_keypair3.CompressedSecp256k1PublicKey(genesisBytes);
   }
   /**
    * Validates a did:btcr2 identifier.
@@ -2368,7 +2433,7 @@ var HttpClientTransport = class {
   }
   registerPeer(did, communicationPk) {
     try {
-      new import_keypair2.CompressedSecp256k1PublicKey(communicationPk);
+      new import_keypair4.CompressedSecp256k1PublicKey(communicationPk);
     } catch {
       throw new HttpTransportError(
         `Invalid communication public key for peer ${did}: expected a 33-byte compressed secp256k1 key.`,
@@ -2564,14 +2629,14 @@ var HttpClientTransport = class {
     const peerBytes = this.#peers.get(did);
     if (peerBytes) {
       try {
-        return new import_keypair2.CompressedSecp256k1PublicKey(peerBytes);
+        return new import_keypair4.CompressedSecp256k1PublicKey(peerBytes);
       } catch {
       }
     }
     try {
       const components = Identifier.decode(did);
       if (components.idType === "KEY") {
-        return new import_keypair2.CompressedSecp256k1PublicKey(components.genesisBytes);
+        return new import_keypair4.CompressedSecp256k1PublicKey(components.genesisBytes);
       }
     } catch {
     }
@@ -2616,7 +2681,7 @@ function flattenMessage(msg) {
 }
 
 // src/core/aggregation/transport/http/server.ts
-var import_keypair3 = require("@did-btcr2/keypair");
+var import_keypair5 = require("@did-btcr2/keypair");
 
 // src/core/aggregation/transport/http/inbox-buffer.ts
 var InboxBuffer = class {
@@ -2781,7 +2846,7 @@ var HttpServerTransport = class {
   }
   registerPeer(did, communicationPk) {
     try {
-      new import_keypair3.CompressedSecp256k1PublicKey(communicationPk);
+      new import_keypair5.CompressedSecp256k1PublicKey(communicationPk);
     } catch {
       throw new HttpTransportError(
         `Invalid peer public key for ${did}`,
@@ -3059,14 +3124,14 @@ var HttpServerTransport = class {
     const peerBytes = this.#peers.get(did);
     if (peerBytes) {
       try {
-        return new import_keypair3.CompressedSecp256k1PublicKey(peerBytes);
+        return new import_keypair5.CompressedSecp256k1PublicKey(peerBytes);
       } catch {
       }
     }
     try {
       const components = Identifier.decode(did);
       if (components.idType === "KEY") {
-        return new import_keypair3.CompressedSecp256k1PublicKey(components.genesisBytes);
+        return new import_keypair5.CompressedSecp256k1PublicKey(components.genesisBytes);
       }
     } catch {
     }
@@ -3165,7 +3230,7 @@ function flattenMessage2(msg) {
 }
 
 // src/core/aggregation/transport/nostr.ts
-var import_keypair4 = require("@did-btcr2/keypair");
+var import_keypair6 = require("@did-btcr2/keypair");
 var import_utils6 = require("@noble/hashes/utils");
 var import_nostr_tools = require("nostr-tools");
 var import_pool = require("nostr-tools/pool");
@@ -3263,7 +3328,7 @@ var NostrTransport = class _NostrTransport {
    */
   registerPeer(did, communicationPk) {
     try {
-      new import_keypair4.CompressedSecp256k1PublicKey(communicationPk);
+      new import_keypair6.CompressedSecp256k1PublicKey(communicationPk);
     } catch {
       throw new TransportAdapterError(
         `Invalid communication public key for peer ${did}: expected a 33-byte compressed secp256k1 key.`,
@@ -3370,7 +3435,7 @@ var NostrTransport = class _NostrTransport {
     if (to) {
       const recipientPkBytes = this.#peerRegistry.get(to);
       if (recipientPkBytes) {
-        const recipientPk = new import_keypair4.CompressedSecp256k1PublicKey(recipientPkBytes);
+        const recipientPk = new import_keypair6.CompressedSecp256k1PublicKey(recipientPkBytes);
         tags.push(["p", (0, import_utils6.bytesToHex)(recipientPk.x)]);
       }
     }
@@ -3401,7 +3466,7 @@ var NostrTransport = class _NostrTransport {
           { adapter: this.name, did: to }
         );
       }
-      const recipientPk = new import_keypair4.CompressedSecp256k1PublicKey(recipientPkBytes);
+      const recipientPk = new import_keypair6.CompressedSecp256k1PublicKey(recipientPkBytes);
       const conversationKey = import_nostr_tools.nip44.v2.utils.getConversationKey(
         senderKeys.secretKey.bytes,
         (0, import_utils6.bytesToHex)(recipientPk.x)
@@ -3641,6 +3706,119 @@ var TransportFactory = class {
   }
 };
 
+// src/core/aggregation/transport/in-memory.ts
+var import_utils7 = require("@noble/hashes/utils");
+var InMemoryBus = class {
+  #transports = /* @__PURE__ */ new Set();
+  /** Attach a transport to this bus. Called by the transport's constructor. */
+  register(transport) {
+    this.#transports.add(transport);
+  }
+  /** Detach a transport from this bus. */
+  unregister(transport) {
+    this.#transports.delete(transport);
+  }
+  /**
+   * Deliver a message. With no `recipient` the message is broadcast to every
+   * actor on the bus; otherwise it is routed to the single transport that owns
+   * the recipient DID.
+   */
+  async deliver(message, _sender, recipient) {
+    const type = message.type;
+    if (!type) return;
+    const replacer = (_k, v) => v instanceof Uint8Array ? { __bytes: (0, import_utils7.bytesToHex)(v) } : v;
+    const reviver = (_k, v) => v && typeof v === "object" && "__bytes" in v ? (0, import_utils7.hexToBytes)(v.__bytes) : v;
+    const raw = JSON.parse(JSON.stringify(message, replacer), reviver);
+    const serialized = { ...raw, ...raw.body ?? {} };
+    if (!recipient) {
+      for (const t of this.#transports) {
+        await t.dispatchBroadcast(type, serialized);
+      }
+      return;
+    }
+    for (const t of this.#transports) {
+      if (t.hasActor(recipient)) {
+        await t.dispatchDirected(recipient, type, serialized);
+        return;
+      }
+    }
+  }
+};
+var InMemoryTransport = class {
+  name = "in-memory";
+  bus;
+  #actors = /* @__PURE__ */ new Map();
+  #peers = /* @__PURE__ */ new Map();
+  /** @param bus Shared bus. Pass the same bus to connect multiple transports. */
+  constructor(bus = new InMemoryBus()) {
+    this.bus = bus;
+    this.bus.register(this);
+  }
+  start() {
+  }
+  registerActor(did, keys) {
+    this.#actors.set(did, { publicKey: keys.publicKey.compressed, handlers: /* @__PURE__ */ new Map() });
+  }
+  getActorPk(did) {
+    return this.#actors.get(did)?.publicKey;
+  }
+  /** True if `did` is registered on this transport. Used by the bus for routing. */
+  hasActor(did) {
+    return this.#actors.has(did);
+  }
+  registerPeer(did, communicationPk) {
+    this.#peers.set(did, communicationPk);
+  }
+  getPeerPk(did) {
+    return this.#peers.get(did);
+  }
+  registerMessageHandler(actorDid, messageType, handler) {
+    const actor = this.#actors.get(actorDid);
+    if (actor) actor.handlers.set(messageType, handler);
+  }
+  unregisterMessageHandler(actorDid, messageType) {
+    const actor = this.#actors.get(actorDid);
+    if (actor) actor.handlers.delete(messageType);
+  }
+  unregisterActor(did) {
+    const actor = this.#actors.get(did);
+    if (!actor) return;
+    actor.handlers.clear();
+    this.#actors.delete(did);
+    this.#peers.delete(did);
+  }
+  async sendMessage(message, sender, recipient) {
+    await this.bus.deliver(message, sender, recipient);
+  }
+  publishRepeating(message, sender, intervalMs, recipient) {
+    let stopped = false;
+    void this.sendMessage(message, sender, recipient).catch(() => {
+    });
+    const timer = setInterval(() => {
+      if (stopped) return;
+      void this.sendMessage(message, sender, recipient).catch(() => {
+      });
+    }, intervalMs);
+    return () => {
+      if (stopped) return;
+      stopped = true;
+      clearInterval(timer);
+    };
+  }
+  /** Deliver a broadcast message to every actor on this transport that handles `type`. */
+  async dispatchBroadcast(type, message) {
+    for (const actor of this.#actors.values()) {
+      const handler = actor.handlers.get(type);
+      if (handler) await handler(message);
+    }
+  }
+  /** Deliver a directed message to the recipient actor's handler for `type`. */
+  async dispatchDirected(recipientDid, type, message) {
+    const handler = this.#actors.get(recipientDid)?.handlers.get(type);
+    if (handler) await handler(message);
+  }
+};
+
 // src/core/aggregation/transport/didcomm.ts
 var import_common11 = require("@did-btcr2/common");
 var DidCommTransport = class {
@@ -3793,8 +3971,11 @@ var AggregationServiceRunner = class _AggregationServiceRunner extends TypedEven
     this.#phaseTimeoutMs = options.phaseTimeoutMs;
     this.#advertRepeatIntervalMs = options.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: options.did,
-      keys: options.keys,
+      publicKey: options.keys.publicKey,
       maxUpdateSizeBytes: options.maxUpdateSizeBytes
     });
   }
@@ -4146,7 +4327,10 @@ var AggregationParticipantRunner = class _AggregationParticipantRunner extends T
     this.#onProvideUpdate = options.onProvideUpdate;
     this.#onValidateData = options.onValidateData ?? (async (info) => ({ approved: info.matches }));
     this.#onApproveSigning = options.onApproveSigning ?? (async () => ({ approved: true }));
-    this.session = new AggregationParticipant({ did: options.did, keys: options.keys });
+    this.session = new AggregationParticipant({
+      did: options.did,
+      signer: new KeyPairAggregationSigner(options.keys)
+    });
   }
   /**
    * Start listening for cohorts. The runner stays active until {@link stop}
@@ -4159,6 +4343,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 = [
@@ -4368,8 +4553,64 @@ var AggregationParticipantRunner = class _AggregationParticipantRunner extends T
   }
 };
 
+// src/core/aggregation/runner/aggregation-runner.ts
+var AggregationRunner = class {
+  /**
+   * Run a cohort of ONE participant entirely in-process and return the
+   * aggregated MuSig2 result.
+   *
+   * One party plays both the coordinating service and the lone participant,
+   * connected over an {@link InMemoryTransport} (no relay or HTTP server). This
+   * makes the single-participant aggregate-beacon path — the N=1 corner of the
+   * two-axis beacon matrix (see ADR 037) — first-class, useful for generating
+   * and reproducing single-participant aggregate test vectors.
+   *
+   * The service advertises a cohort with `minParticipants: 1`; the participant
+   * joins, submits its update, and the two complete keygen, data distribution,
+   * validation, and a one-signer MuSig2 P2TR key-path signing round.
+   *
+   * @param options Service + participant identities, cohort config, and the
+   *   update / tx-data callbacks.
+   * @returns The {@link AggregationResult} (cohort id, aggregated signature, signed tx).
+   */
+  static async solo(options) {
+    const transport = new InMemoryTransport(new InMemoryBus());
+    transport.registerActor(options.service.did, options.service.keys);
+    transport.registerActor(options.participant.did, options.participant.keys);
+    transport.registerPeer(options.participant.did, options.participant.keys.publicKey.compressed);
+    transport.registerPeer(options.service.did, options.service.keys.publicKey.compressed);
+    transport.start();
+    const service = new AggregationServiceRunner({
+      transport,
+      did: options.service.did,
+      keys: options.service.keys,
+      config: { minParticipants: 1, network: options.config.network, beaconType: options.config.beaconType },
+      onProvideTxData: options.onProvideTxData,
+      cohortTtlMs: options.cohortTtlMs,
+      phaseTimeoutMs: options.phaseTimeoutMs,
+      // In-process bus with the participant already listening: a single advert
+      // suffices, so disable the republish loop (no dangling interval).
+      advertRepeatIntervalMs: 0
+    });
+    const participant = new AggregationParticipantRunner({
+      transport,
+      did: options.participant.did,
+      keys: options.participant.keys,
+      shouldJoin: async () => true,
+      onProvideUpdate: options.onProvideUpdate
+    });
+    await participant.start();
+    try {
+      return await service.run();
+    } finally {
+      participant.stop();
+      service.stop();
+    }
+  }
+};
+
 // src/core/beacon/beacon.ts
-var import_utils7 = require("@noble/hashes/utils.js");
+var import_utils8 = require("@noble/hashes/utils.js");
 var import_btc_signer4 = require("@scure/btc-signer");
 
 // src/core/beacon/error.ts
@@ -4467,7 +4708,7 @@ async function fetchSpendableUtxo(bitcoinAddress, bitcoin) {
     );
   }
   const prevTxHex = await bitcoin.rest.transaction.getHex(utxo.txid);
-  return { utxo, prevTxBytes: (0, import_utils7.hexToBytes)(prevTxHex) };
+  return { utxo, prevTxBytes: (0, import_utils8.hexToBytes)(prevTxHex) };
 }
 async function buildAggregationBeaconTx(opts) {
   const feeEstimator = opts.feeEstimator ?? DEFAULT_FEE_ESTIMATOR;
@@ -4508,7 +4749,7 @@ async function signSingletonInput(tx, inputIdx, kind, signer, prevOutScript, amo
     const sighashType = import_btc_signer4.SigHash.ALL;
     const sighash2 = tx.preimageLegacy(inputIdx, prevOutScript, sighashType);
     const sig2 = signer.sign(sighash2, "ecdsa");
-    const sigWithType = (0, import_utils7.concatBytes)(sig2, new Uint8Array([sighashType]));
+    const sigWithType = (0, import_utils8.concatBytes)(sig2, new Uint8Array([sighashType]));
     tx.updateInput(inputIdx, { partialSig: [[pubkey, sigWithType]] }, true);
     tx.finalize();
     return tx.hex;
@@ -4526,7 +4767,7 @@ async function signSingletonInput(tx, inputIdx, kind, signer, prevOutScript, amo
     const sighashType = import_btc_signer4.SigHash.ALL;
     const sighash2 = tx.preimageWitnessV0(inputIdx, sighashScript, sighashType, amount);
     const sig2 = signer.sign(sighash2, "ecdsa");
-    const sigWithType = (0, import_utils7.concatBytes)(sig2, new Uint8Array([sighashType]));
+    const sigWithType = (0, import_utils8.concatBytes)(sig2, new Uint8Array([sighashType]));
     tx.updateInput(inputIdx, { partialSig: [[pubkey, sigWithType]] }, true);
     tx.finalize();
     return tx.hex;
@@ -4537,7 +4778,7 @@ async function signSingletonInput(tx, inputIdx, kind, signer, prevOutScript, amo
   tx.finalize();
   return tx.hex;
 }
-var Beacon = class {
+var SinglePartyBeacon = class {
   /**
    * The Beacon service configuration parsed from the DID Document.
    */
@@ -4674,7 +4915,7 @@ var Beacon = class {
 
 // src/core/beacon/cas-beacon.ts
 var import_common13 = require("@did-btcr2/common");
-var CASBeacon = class extends Beacon {
+var CASBeacon = class extends SinglePartyBeacon {
   /**
    * Creates an instance of CASBeacon.
    * @param {BeaconService} service The service of the Beacon.
@@ -4734,7 +4975,7 @@ var CASBeacon = class extends Beacon {
    * Creates a CAS Announcement mapping the DID to the update hash, broadcasts the hash of the
    * announcement via OP_RETURN, and optionally publishes the announcement off-chain via the
    * supplied `casPublish` callback. UTXO selection, PSBT construction, fee estimation, signing,
-   * and broadcast are delegated to {@link Beacon.buildSignAndBroadcast}.
+   * and broadcast are delegated to {@link SinglePartyBeacon.buildSignAndBroadcast}.
    *
    * @param {SignedBTCR2Update} signedUpdate The signed BTCR2 update to broadcast.
    * @param {Signer} signer Signer that produces the ECDSA signature for the Bitcoin transaction.
@@ -4762,7 +5003,7 @@ var import_common16 = require("@did-btcr2/common");
 
 // src/core/beacon/singleton-beacon.ts
 var import_common14 = require("@did-btcr2/common");
-var SingletonBeacon = class extends Beacon {
+var SingletonBeacon = class extends SinglePartyBeacon {
   /**
    * Creates an instance of SingletonBeacon.
    * @param {BeaconService} service The BeaconService object representing the funded beacon to announce the update to.
@@ -4799,7 +5040,7 @@ var SingletonBeacon = class extends Beacon {
    *
    * The signal bytes embedded in OP_RETURN are the SHA-256 canonical hash of the signed update.
    * UTXO selection, PSBT construction, fee estimation, signing, and broadcast are delegated to
-   * {@link Beacon.buildSignAndBroadcast}.
+   * {@link SinglePartyBeacon.buildSignAndBroadcast}.
    *
    * @param {SignedBTCR2Update} signedUpdate The signed BTCR2 update to broadcast.
    * @param {Signer} signer Signer that produces the ECDSA signature for the Bitcoin transaction.
@@ -4818,8 +5059,8 @@ var SingletonBeacon = class extends Beacon {
 // src/core/beacon/smt-beacon.ts
 var import_common15 = require("@did-btcr2/common");
 var import_smt3 = require("@did-btcr2/smt");
-var import_utils8 = require("@noble/hashes/utils");
-var SMTBeacon = class extends Beacon {
+var import_utils9 = require("@noble/hashes/utils");
+var SMTBeacon = class extends SinglePartyBeacon {
   /**
    * Creates an instance of SMTBeacon.
    * @param {BeaconService} service The Beacon service.
@@ -4895,7 +5136,7 @@ var SMTBeacon = class extends Beacon {
    * Builds a single-entry Sparse Merkle Tree from the signed update, then broadcasts the tree's
    * root hash via OP_RETURN. For multi-party aggregation, use the {@link AggregationService}
    * subsystem directly instead of this method. UTXO selection, PSBT construction, fee estimation,
-   * signing, and broadcast are delegated to {@link Beacon.buildSignAndBroadcast}.
+   * signing, and broadcast are delegated to {@link SinglePartyBeacon.buildSignAndBroadcast}.
    *
    * @param {SignedBTCR2Update} signedUpdate The signed BTCR2 update to broadcast.
    * @param {Signer} signer Signer that produces the ECDSA signature for the Bitcoin transaction.
@@ -4907,7 +5148,7 @@ var SMTBeacon = class extends Beacon {
   async broadcastSignal(signedUpdate, signer, bitcoin, options) {
     const did = this.service.id.split("#")[0];
     const canonicalBytes = new TextEncoder().encode((0, import_common15.canonicalize)(signedUpdate));
-    const nonce = (0, import_utils8.randomBytes)(32);
+    const nonce = (0, import_utils9.randomBytes)(32);
     const tree = new import_smt3.BTCR2MerkleTree();
     tree.addEntries([{ did, nonce, signedUpdate: canonicalBytes }]);
     tree.finalize();
@@ -4921,7 +5162,7 @@ var BeaconFactory = class {
   /**
    * Establish a Beacon instance based on the provided service and optional sidecar data.
    * @param {BeaconService} service The beacon service configuration.
-   * @returns {Beacon} The established Beacon instance.
+   * @returns {SinglePartyBeacon} The established Beacon instance.
    */
   static establish(service) {
     switch (service.type) {
@@ -4938,11 +5179,11 @@ var BeaconFactory = class {
 };
 
 // src/core/beacon/signal-discovery.ts
-var import_bitcoin2 = require("@did-btcr2/bitcoin");
+var import_bitcoin3 = require("@did-btcr2/bitcoin");
 var import_common18 = require("@did-btcr2/common");
 
 // src/core/beacon/utils.ts
-var import_bitcoin = require("@did-btcr2/bitcoin");
+var import_bitcoin2 = require("@did-btcr2/bitcoin");
 var import_common17 = require("@did-btcr2/common");
 var import_btc_signer5 = require("@scure/btc-signer");
 
@@ -6049,7 +6290,7 @@ var BeaconUtils = class {
   static createBeaconService(did, addressType, beaconType) {
     try {
       const components = Identifier.decode(did);
-      const network = (0, import_bitcoin.getNetwork)(components.network);
+      const network = (0, import_bitcoin2.getNetwork)(components.network);
       const pubkey = components.genesisBytes;
       const id = `${did}#initial${addressType.toUpperCase()}`;
       const address = addressType === "p2tr" ? (0, import_btc_signer5.p2tr)(pubkey.slice(1, 33), void 0, network).address : addressType === "p2wpkh" ? (0, import_btc_signer5.p2wpkh)(pubkey, network).address : (0, import_btc_signer5.p2pkh)(pubkey, network).address;
@@ -6200,14 +6441,14 @@ var BeaconSignalDiscovery = class {
     console.info(`Searching for beacon signals, please wait ...`);
     while (block.height <= targetHeight) {
       for (const tx of block.tx) {
-        if (tx.txid === import_bitcoin2.GENESIS_TX_ID) {
+        if (tx.txid === import_bitcoin3.GENESIS_TX_ID) {
           continue;
         }
         for (const vin of tx.vin) {
           if (vin.coinbase) {
             continue;
           }
-          if (vin.txinwitness && vin.txinwitness.length === 1 && vin.txinwitness[0] === import_bitcoin2.TXIN_WITNESS_COINBASE) {
+          if (vin.txinwitness && vin.txinwitness.length === 1 && vin.txinwitness[0] === import_bitcoin3.TXIN_WITNESS_COINBASE) {
             continue;
           }
           if (!vin.txid) {
@@ -6261,10 +6502,10 @@ var BeaconSignalDiscovery = class {
 };
 
 // src/core/resolver.ts
-var import_bitcoin4 = require("@did-btcr2/bitcoin");
+var import_bitcoin5 = require("@did-btcr2/bitcoin");
 var import_common22 = require("@did-btcr2/common");
 var import_cryptosuite3 = require("@did-btcr2/cryptosuite");
-var import_keypair6 = require("@did-btcr2/keypair");
+var import_keypair8 = require("@did-btcr2/keypair");
 
 // src/did-btcr2.ts
 var import_common21 = require("@did-btcr2/common");
@@ -6275,10 +6516,10 @@ var import_common20 = require("@did-btcr2/common");
 var import_cryptosuite2 = require("@did-btcr2/cryptosuite");
 
 // src/utils/did-document.ts
-var import_bitcoin3 = require("@did-btcr2/bitcoin");
+var import_bitcoin4 = require("@did-btcr2/bitcoin");
 var import_common19 = require("@did-btcr2/common");
-var import_keypair5 = require("@did-btcr2/keypair");
-var import_utils10 = require("@web5/dids/utils");
+var import_keypair7 = require("@did-btcr2/keypair");
+var import_utils11 = require("@web5/dids/utils");
 var import_btc_signer6 = require("@scure/btc-signer");
 var BTCR2_DID_DOCUMENT_CONTEXT = [
   "https://www.w3.org/ns/did/v1.1",
@@ -6488,7 +6729,7 @@ var DidDocument = class _DidDocument {
    * @returns {boolean} True if the services are valid.
    */
   static isValidServices(service) {
-    return Array.isArray(service) && service.every(import_utils10.isDidService);
+    return Array.isArray(service) && service.every(import_utils11.isDidService);
   }
   /**
    * Validates verification relationships (authentication, assertionMethod, capabilityInvocation, capabilityDelegation).
@@ -6599,9 +6840,9 @@ var GenesisDocument = class _GenesisDocument extends DidDocument {
    * @returns {GenesisDocument} A new GenesisDocument with the placeholder ID.
    */
   static fromPublicKey(publicKey, network) {
-    const pk = new import_keypair5.CompressedSecp256k1PublicKey(publicKey);
+    const pk = new import_keypair7.CompressedSecp256k1PublicKey(publicKey);
     const id = ID_PLACEHOLDER_VALUE;
-    const address = (0, import_btc_signer6.p2pkh)(pk.compressed, (0, import_bitcoin3.getNetwork)(network)).address;
+    const address = (0, import_btc_signer6.p2pkh)(pk.compressed, (0, import_bitcoin4.getNetwork)(network)).address;
     const services = [{
       id: `${id}#service-0`,
       serviceEndpoint: `bitcoin:${address}`,
@@ -7068,7 +7309,7 @@ var DidBtcr2 = class {
 };
 
 // src/core/resolver.ts
-var import_utils12 = require("@noble/curves/utils.js");
+var import_utils13 = require("@noble/curves/utils.js");
 var Resolver = class _Resolver {
   // --- Immutable inputs ---
   #didComponents;
@@ -7108,11 +7349,11 @@ var Resolver = class _Resolver {
   static deterministic(didComponents) {
     const genesisBytes = didComponents.genesisBytes;
     const did = Identifier.encode(genesisBytes, didComponents);
-    const { multibase } = new import_keypair6.CompressedSecp256k1PublicKey(genesisBytes);
+    const { multibase } = new import_keypair8.CompressedSecp256k1PublicKey(genesisBytes);
     const service = BeaconUtils.generateBeaconServices({
       id: did,
       publicKey: genesisBytes,
-      network: (0, import_bitcoin4.getNetwork)(didComponents.network),
+      network: (0, import_bitcoin5.getNetwork)(didComponents.network),
       beaconType: "SingletonBeacon"
     });
     return new DidDocument({
@@ -7135,7 +7376,7 @@ var Resolver = class _Resolver {
    */
   static external(didComponents, genesisDocument) {
     const genesisDocumentHash = (0, import_common22.canonicalHashBytes)(genesisDocument);
-    if (!(0, import_utils12.equalBytes)(didComponents.genesisBytes, genesisDocumentHash)) {
+    if (!(0, import_utils13.equalBytes)(didComponents.genesisBytes, genesisDocumentHash)) {
       throw new import_common22.ResolveError(
         `Initial document mismatch: genesisBytes !== genesisDocumentHash`,
         import_common22.INVALID_DID_DOCUMENT,
@@ -7212,7 +7453,7 @@ var Resolver = class _Resolver {
         this.confirmDuplicate(update, updateHashHistory);
       } else if (update.targetVersionId === currentVersionId + 1) {
         const sourceHashBytes = (0, import_common22.decode)(update.sourceHash, "base64urlnopad");
-        if (!(0, import_utils12.equalBytes)(sourceHashBytes, currentDocumentHash)) {
+        if (!(0, import_utils13.equalBytes)(sourceHashBytes, currentDocumentHash)) {
           throw new import_common22.ResolveError(
             `Hash mismatch: update.sourceHash !== currentDocumentHash`,
             import_common22.INVALID_DID_UPDATE,
@@ -7259,7 +7500,7 @@ var Resolver = class _Resolver {
     const { proof: _, ...unsignedUpdate } = update;
     const unsignedUpdateHash = (0, import_common22.canonicalHashBytes)(unsignedUpdate);
     const historicalUpdateHash = updateHashHistory[update.targetVersionId - 2];
-    if (!(0, import_utils12.equalBytes)(historicalUpdateHash, unsignedUpdateHash)) {
+    if (!(0, import_utils13.equalBytes)(historicalUpdateHash, unsignedUpdateHash)) {
       throw new import_common22.ResolveError(
         `Invalid duplicate: unsigned update hash does not match historical hash`,
         import_common22.LATE_PUBLISHING_ERROR,
@@ -7312,7 +7553,7 @@ var Resolver = class _Resolver {
     DidDocument.validate(updatedDocument);
     const currentDocumentHash = (0, import_common22.canonicalHashBytes)(updatedDocument);
     const updateTargetHash = (0, import_common22.decode)(update.targetHash);
-    if (!(0, import_utils12.equalBytes)(updateTargetHash, currentDocumentHash)) {
+    if (!(0, import_utils13.equalBytes)(updateTargetHash, currentDocumentHash)) {
       throw new import_common22.ResolveError(
         `Invalid update: update.targetHash !== currentDocumentHash`,
         import_common22.INVALID_DID_UPDATE,
@@ -7539,6 +7780,7 @@ var DidDocumentBuilder = class {
   AggregationParticipant,
   AggregationParticipantError,
   AggregationParticipantRunner,
+  AggregationRunner,
   AggregationService,
   AggregationServiceError,
   AggregationServiceRunner,
@@ -7546,7 +7788,6 @@ var DidDocumentBuilder = class {
   BECH32M_CHARS,
   BTCR2_DID_DOCUMENT_CONTEXT,
   BaseMessage,
-  Beacon,
   BeaconError,
   BeaconFactory,
   BeaconSignalDiscovery,
@@ -7581,8 +7822,11 @@ var DidDocumentBuilder = class {
   HttpTransportError,
   ID_PLACEHOLDER_VALUE,
   Identifier,
+  InMemoryBus,
   InMemoryRateLimitStore,
+  InMemoryTransport,
   InboxBuffer,
+  KeyPairAggregationSigner,
   NONCE_CONTRIBUTION,
   NonceCache,
   NostrTransport,
@@ -7603,6 +7847,7 @@ var DidDocumentBuilder = class {
   ServiceCohortPhase,
   SigningSessionError,
   SigningSessionPhase,
+  SinglePartyBeacon,
   SingletonBeacon,
   SingletonBeaconError,
   StaticFeeEstimator,