@did-btcr2/method 0.33.0 → 0.34.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,7 +82,9 @@ __export(index_exports, {
   HttpTransportError: () => HttpTransportError,
   ID_PLACEHOLDER_VALUE: () => ID_PLACEHOLDER_VALUE,
   Identifier: () => Identifier,
+  InMemoryBus: () => InMemoryBus,
   InMemoryRateLimitStore: () => InMemoryRateLimitStore,
+  InMemoryTransport: () => InMemoryTransport,
   InboxBuffer: () => InboxBuffer,
   NONCE_CONTRIBUTION: () => NONCE_CONTRIBUTION,
   NonceCache: () => NonceCache,
@@ -104,6 +106,7 @@ __export(index_exports, {
   ServiceCohortPhase: () => ServiceCohortPhase,
   SigningSessionError: () => SigningSessionError,
   SigningSessionPhase: () => SigningSessionPhase,
+  SinglePartyBeacon: () => SinglePartyBeacon,
   SingletonBeacon: () => SingletonBeacon,
   SingletonBeaconError: () => SingletonBeaconError,
   StaticFeeEstimator: () => StaticFeeEstimator,
@@ -3641,6 +3644,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, { keys, handlers: /* @__PURE__ */ new Map() });
+  }
+  getActorPk(did) {
+    return this.#actors.get(did)?.keys.publicKey.compressed;
+  }
+  /** 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 {
@@ -4368,8 +4484,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 +4639,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 +4680,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 +4698,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 +4709,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 +4846,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 +4906,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 +4934,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 +4971,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 +4990,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 +5067,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 +5079,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 +5093,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) {
@@ -6278,7 +6450,7 @@ var import_cryptosuite2 = require("@did-btcr2/cryptosuite");
 var import_bitcoin3 = 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_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 +6660,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).
@@ -7068,7 +7240,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;
@@ -7135,7 +7307,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 +7384,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 +7431,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 +7484,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 +7711,7 @@ var DidDocumentBuilder = class {
   AggregationParticipant,
   AggregationParticipantError,
   AggregationParticipantRunner,
+  AggregationRunner,
   AggregationService,
   AggregationServiceError,
   AggregationServiceRunner,
@@ -7546,7 +7719,6 @@ var DidDocumentBuilder = class {
   BECH32M_CHARS,
   BTCR2_DID_DOCUMENT_CONTEXT,
   BaseMessage,
-  Beacon,
   BeaconError,
   BeaconFactory,
   BeaconSignalDiscovery,
@@ -7581,7 +7753,9 @@ var DidDocumentBuilder = class {
   HttpTransportError,
   ID_PLACEHOLDER_VALUE,
   Identifier,
+  InMemoryBus,
   InMemoryRateLimitStore,
+  InMemoryTransport,
   InboxBuffer,
   NONCE_CONTRIBUTION,
   NonceCache,
@@ -7603,6 +7777,7 @@ var DidDocumentBuilder = class {
   ServiceCohortPhase,
   SigningSessionError,
   SigningSessionPhase,
+  SinglePartyBeacon,
   SingletonBeacon,
   SingletonBeaconError,
   StaticFeeEstimator,

package/dist/esm/core/aggregation/runner/aggregation-runner.js

@@ -0,0 +1,66 @@
+import { InMemoryBus, InMemoryTransport } from '../transport/in-memory.js';
+import { AggregationParticipantRunner } from './participant-runner.js';
+import { AggregationServiceRunner } from './service-runner.js';
+/**
+ * High-level facades for driving an aggregation cohort to completion.
+ *
+ * @class AggregationRunner
+ */
+export class AggregationRunner {
+    /**
+     * 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);
+        // Pre-register communication keys both ways. Production exchanges these via
+        // the protocol handshake; in-process we wire them directly.
+        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();
+        }
+    }
+}
+//# sourceMappingURL=aggregation-runner.js.map

package/dist/esm/core/aggregation/runner/aggregation-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregation-runner.js","sourceRoot":"","sources":["../../../../../src/core/aggregation/runner/aggregation-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AA2B/D;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAC5B;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAA0B;QAC1C,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;QAC3D,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnE,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3E,4EAA4E;QAC5E,4DAA4D;QAC5D,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC/F,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACvF,SAAS,CAAC,KAAK,EAAE,CAAC;QAElB,MAAM,OAAO,GAAG,IAAI,wBAAwB,CAAC;YAC3C,SAAS;YACT,GAAG,EAAsB,OAAO,CAAC,OAAO,CAAC,GAAG;YAC5C,IAAI,EAAqB,OAAO,CAAC,OAAO,CAAC,IAAI;YAC7C,MAAM,EAAmB,EAAE,eAAe,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE;YACvH,eAAe,EAAU,OAAO,CAAC,eAAe;YAChD,WAAW,EAAc,OAAO,CAAC,WAAW;YAC5C,cAAc,EAAW,OAAO,CAAC,cAAc;YAC/C,yEAAyE;YACzE,kEAAkE;YAClE,sBAAsB,EAAG,CAAC;SAC3B,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,IAAI,4BAA4B,CAAC;YACnD,SAAS;YACT,GAAG,EAAe,OAAO,CAAC,WAAW,CAAC,GAAG;YACzC,IAAI,EAAc,OAAO,CAAC,WAAW,CAAC,IAAI;YAC1C,UAAU,EAAQ,KAAK,IAAI,EAAE,CAAC,IAAI;YAClC,eAAe,EAAG,OAAO,CAAC,eAAe;SAC1C,CAAC,CAAC;QAEH,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;QAC7B,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;CACF"}

package/dist/esm/core/aggregation/runner/index.js

@@ -2,4 +2,5 @@ export * from './typed-emitter.js';
 export * from './events.js';
 export * from './service-runner.js';
 export * from './participant-runner.js';
+export * from './aggregation-runner.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/core/aggregation/runner/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/aggregation/runner/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/aggregation/runner/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/esm/core/aggregation/transport/in-memory.js

@@ -0,0 +1,146 @@
+import { bytesToHex, hexToBytes } from '@noble/hashes/utils';
+/**
+ * In-process message bus connecting one or more {@link InMemoryTransport}
+ * instances. Routes broadcasts to every registered actor and directed messages
+ * to the actor that owns the recipient DID — with no relay, server, or network.
+ *
+ * Each delivery does a JSON round-trip (Uint8Array preserved as `__bytes` hex)
+ * so handlers receive an isolated, serialization-faithful copy, exactly as a
+ * real transport would. The message `body` is merged to the top level to match
+ * the shape the {@link NostrTransport} dispatch produces.
+ *
+ * @class InMemoryBus
+ */
+export class InMemoryBus {
+    #transports = 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;
+        // JSON round-trip to mimic transport serialization, preserving Uint8Array.
+        const replacer = (_k, v) => v instanceof Uint8Array ? { __bytes: bytesToHex(v) } : v;
+        const reviver = (_k, v) => v && typeof v === 'object' && '__bytes' in v
+            ? 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;
+            }
+        }
+    }
+}
+/**
+ * In-process {@link Transport} that routes aggregation messages through an
+ * {@link InMemoryBus} instead of a relay or HTTP server. Supports multiple
+ * actors per instance, so a single transport can host both a service and its
+ * participants (e.g. a cohort-of-one via {@link AggregationRunner.solo}).
+ *
+ * Encryption is a no-op (in-process, same trust domain); `registerPeer` /
+ * `getPeerPk` keep a registry so the contract matches the wire transports.
+ *
+ * @class InMemoryTransport
+ * @implements {Transport}
+ */
+export class InMemoryTransport {
+    name = 'in-memory';
+    bus;
+    #actors = new Map();
+    #peers = 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() {
+        // No-op: there is no underlying connection to open.
+    }
+    registerActor(did, keys) {
+        this.#actors.set(did, { keys, handlers: new Map() });
+    }
+    getActorPk(did) {
+        return this.#actors.get(did)?.keys.publicKey.compressed;
+    }
+    /** 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);
+    }
+}
+//# sourceMappingURL=in-memory.js.map

package/dist/esm/core/aggregation/transport/in-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.js","sourceRoot":"","sources":["../../../../../src/core/aggregation/transport/in-memory.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/aggregation/transport/index.js

@@ -1,6 +1,7 @@
 export * from './transport.js';
 export * from './error.js';
 export * from './factory.js';
+export * from './in-memory.js';
 export * from './nostr.js';
 export * from './didcomm.js';
 export * from './http/index.js';

package/dist/esm/core/aggregation/transport/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/aggregation/transport/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/aggregation/transport/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}