@did-btcr2/aggregation 0.1.0

package/dist/esm/runner/participant-runner.js

@@ -0,0 +1,407 @@
+var _a;
+import { AGGREGATED_NONCE, AUTHORIZATION_REQUEST, COHORT_ADVERT, COHORT_OPT_IN_ACCEPT, COHORT_READY, DISTRIBUTE_AGGREGATED_DATA, FALLBACK_AUTHORIZATION_REQUEST, } from '../messages/constants.js';
+import { AggregationParticipant } from '../participant.js';
+import { ParticipantCohortPhase } from '../phases.js';
+import { KeyPairAggregationSigner } from '../signer.js';
+import { TypedEventEmitter } from './typed-emitter.js';
+/**
+ * High-level facade for an Aggregation Participant.
+ *
+ * Long-running listener: waits for cohort adverts, applies the `shouldJoin`
+ * filter, and drives each accepted cohort through the full protocol to
+ * completion in parallel.
+ *
+ * @example
+ * ```typescript
+ * const transport = new NostrTransport({ relays: [RELAY] });
+ * transport.registerActor(myDid, myKeys);
+ *
+ * const runner = new AggregationParticipantRunner({
+ *   transport,
+ *   did: myDid,
+ *   keys: myKeys,
+ *   shouldJoin: async (advert) => advert.beaconType === 'CASBeacon',
+ *   onProvideUpdate: async ({ beaconAddress }) => {
+ *     return Updater.sign(myDid, unsigned, vm, secretKey);
+ *   },
+ * });
+ *
+ * runner.on('cohort-complete', ({ beaconAddress }) => {
+ *   console.log(`Add to DID document: bitcoin:${beaconAddress}`);
+ * });
+ *
+ * await runner.start();
+ * ```
+ *
+ * For full manual control, drop down to the underlying state machine via
+ * `runner.session`. The state machine has no transport coupling and exposes
+ * every protocol decision as an explicit method.
+ *
+ * @class AggregationParticipantRunner
+ * @extends TypedEventEmitter<AggregationParticipantEvents>
+ */
+export class AggregationParticipantRunner extends TypedEventEmitter {
+    /** Direct access to the underlying state machine for advanced use. */
+    session;
+    #transport;
+    #did;
+    #shouldJoin;
+    #onProvideUpdate;
+    #onValidateData;
+    #onApproveSigning;
+    #handlersRegistered = false;
+    #stopped = false;
+    constructor(options) {
+        super();
+        this.#transport = options.transport;
+        this.#did = options.did;
+        this.#shouldJoin = options.shouldJoin ?? (async () => false);
+        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,
+            signer: new KeyPairAggregationSigner(options.keys),
+        });
+    }
+    /**
+     * Start listening for cohorts. The runner stays active until {@link stop}
+     * is called or the underlying transport disconnects.
+     */
+    async start() {
+        this.#registerHandlers();
+    }
+    /** Stop the runner and detach transport handlers. Safe to call repeatedly. */
+    stop() {
+        this.#stopped = true;
+        this.#unregisterHandlers();
+        // Deterministically wipe any secret nonce left on an abandoned signing
+        // session. The signing key itself lives behind the AggregationSigner and is
+        // never retained here.
+        this.session.clearSecrets();
+    }
+    /** Message types this runner listens for on the transport. */
+    static #HANDLED_MESSAGE_TYPES = [
+        COHORT_ADVERT,
+        COHORT_OPT_IN_ACCEPT,
+        COHORT_READY,
+        DISTRIBUTE_AGGREGATED_DATA,
+        AUTHORIZATION_REQUEST,
+        AGGREGATED_NONCE,
+        FALLBACK_AUTHORIZATION_REQUEST,
+    ];
+    /** Internal: detach from the transport. Safe to call repeatedly. */
+    #unregisterHandlers() {
+        if (!this.#handlersRegistered)
+            return;
+        this.#handlersRegistered = false;
+        for (const type of _a.#HANDLED_MESSAGE_TYPES) {
+            this.#transport.unregisterMessageHandler(this.#did, type);
+        }
+    }
+    /**
+     * Single-shot helper: start, join the first cohort that passes `shouldJoin`,
+     * drive it to completion, and resolve. Convenient for tests and demos. The
+     * single-cohort special case of {@link joinMatching} (count = 1).
+     */
+    static async joinFirst(options) {
+        return new Promise((resolve, reject) => {
+            const runner = new _a(options);
+            runner.once('cohort-complete', (info) => {
+                runner.stop();
+                resolve(info);
+            });
+            runner.on('error', reject);
+            runner.start().catch(reject);
+        });
+    }
+    /**
+     * Multi-cohort helper: start, join EVERY cohort whose advert passes
+     * `shouldJoin`, drive each to completion in parallel, and resolve once
+     * `count` cohorts have completed (the runner stops at that point). The
+     * N-cohort generalization of {@link joinFirst}, for a participant that joins
+     * several cohorts advertised by one service.
+     *
+     * For an open-ended, long-lived subscriber (no fixed count), construct an
+     * {@link AggregationParticipantRunner} directly, set `shouldJoin`, call
+     * `start()`, and listen for `cohort-complete` - the runner already drives
+     * any number of cohorts concurrently.
+     *
+     * @param options Participant runner options (set `shouldJoin` to select cohorts).
+     * @param count Number of completed cohorts to collect before resolving.
+     * @returns The {@link CohortCompleteInfo} for each completed cohort, in completion order.
+     */
+    static async joinMatching(options, count) {
+        return new Promise((resolve, reject) => {
+            const runner = new _a(options);
+            const completed = [];
+            runner.on('cohort-complete', (info) => {
+                completed.push(info);
+                if (completed.length >= count) {
+                    runner.stop();
+                    resolve(completed);
+                }
+            });
+            runner.on('error', reject);
+            runner.start().catch(reject);
+        });
+    }
+    /**
+     * Internal: handler registration with the transport. Idempotent and safe to call multiple times,
+     * but only registers handlers once.
+     */
+    #registerHandlers() {
+        if (this.#handlersRegistered)
+            return;
+        this.#handlersRegistered = true;
+        this.#transport.registerMessageHandler(this.#did, COHORT_ADVERT, this.#handleAdvert.bind(this));
+        this.#transport.registerMessageHandler(this.#did, COHORT_OPT_IN_ACCEPT, this.#handleOptInAccept.bind(this));
+        this.#transport.registerMessageHandler(this.#did, COHORT_READY, this.#handleCohortReady.bind(this));
+        this.#transport.registerMessageHandler(this.#did, DISTRIBUTE_AGGREGATED_DATA, this.#handleDistributeData.bind(this));
+        this.#transport.registerMessageHandler(this.#did, AUTHORIZATION_REQUEST, this.#handleAuthorizationRequest.bind(this));
+        this.#transport.registerMessageHandler(this.#did, AGGREGATED_NONCE, this.#handleAggregatedNonce.bind(this));
+        this.#transport.registerMessageHandler(this.#did, FALLBACK_AUTHORIZATION_REQUEST, this.#handleFallbackAuthorizationRequest.bind(this));
+    }
+    /**
+     * Internal: handler for cohort adverts. Applies the `shouldJoin` filter and joins if approved.
+     * @param {BaseMessage} msg - The received cohort advert message.
+     * @returns {Promise<void>} Resolves when processing is complete.
+     */
+    async #handleAdvert(msg) {
+        if (this.#stopped)
+            return;
+        try {
+            this.session.receive(msg);
+            const advert = this.session.discoveredCohorts.get(msg.body?.cohortId ?? '');
+            if (!advert)
+                return;
+            this.emit('cohort-discovered', advert);
+            // Register the service's communication key for encrypted message routing
+            if (advert.serviceCommunicationPk) {
+                this.#transport.registerPeer(advert.serviceDid, advert.serviceCommunicationPk);
+            }
+            const join = await this.#shouldJoin(advert);
+            if (!join)
+                return;
+            await this.#sendAll(this.session.joinCohort(advert.cohortId));
+            this.emit('cohort-joined', { cohortId: advert.cohortId });
+        }
+        catch (err) {
+            this.emit('error', err);
+        }
+    }
+    /**
+     * Internal: handler for opt-in accept messages. Updates the session state accordingly.
+     * @param {BaseMessage} msg - The received opt-in accept message.
+     */
+    #handleOptInAccept(msg) {
+        if (this.#stopped)
+            return;
+        try {
+            this.session.receive(msg);
+        }
+        catch (err) {
+            this.emit('error', err);
+        }
+    }
+    /**
+     * Internal: handler for cohort ready messages. Updates the session state, emits a 'cohort-ready'
+     * event, and triggers the update submission flow via the `onProvideUpdate` callback.
+     * @param {BaseMessage} msg - The received cohort ready message.
+     * @returns {Promise<void>} Resolves when processing is complete.
+      */
+    async #handleCohortReady(msg) {
+        if (this.#stopped)
+            return;
+        try {
+            this.session.receive(msg);
+            const cohortId = msg.body?.cohortId;
+            if (!cohortId)
+                return;
+            const info = this.session.joinedCohorts.get(cohortId);
+            if (!info)
+                return;
+            this.emit('cohort-ready', { cohortId, beaconAddress: info.beaconAddress });
+            // Construct the signed update via caller callback and submit. A null return
+            // means the member has no update this round: it declines (cooperative
+            // non-inclusion) but stays in the cohort and still signs.
+            const signedUpdate = await this.#onProvideUpdate({
+                cohortId,
+                beaconAddress: info.beaconAddress,
+            });
+            if (signedUpdate === null) {
+                await this.#sendAll(this.session.declineUpdate(cohortId));
+                this.emit('update-declined', { cohortId });
+            }
+            else {
+                await this.#sendAll(this.session.submitUpdate(cohortId, signedUpdate));
+                this.emit('update-submitted', { cohortId });
+            }
+        }
+        catch (err) {
+            this.emit('error', err);
+        }
+    }
+    /**
+     * Internal: handler for distribute aggregated data messages. Updates the session state, emits a
+     * 'validation-requested' event, and triggers the validation decision flow via the `onValidateData`
+     * callback. Depending on the decision, sends an approval or rejection message.
+     * @param {BaseMessage} msg - The received distribute aggregated data message.
+     * @returns {Promise<void>} Resolves when processing is complete.
+     * @throws {Error} If an error occurs during message processing or callback execution.
+     */
+    async #handleDistributeData(msg) {
+        if (this.#stopped)
+            return;
+        try {
+            this.session.receive(msg);
+            const cohortId = msg.body?.cohortId;
+            if (!cohortId)
+                return;
+            const validation = this.session.pendingValidations.get(cohortId);
+            if (!validation)
+                return;
+            this.emit('validation-requested', validation);
+            const decision = await this.#onValidateData(validation);
+            if (decision.approved) {
+                await this.#sendAll(this.session.approveValidation(cohortId));
+            }
+            else {
+                await this.#sendAll(this.session.rejectValidation(cohortId));
+                this.emit('cohort-failed', { cohortId, reason: 'Validation rejected by participant' });
+            }
+        }
+        catch (err) {
+            this.emit('error', err);
+        }
+    }
+    /**
+     * Internal: handler for authorization request messages. Updates the session state, emits a
+     * 'signing-requested' event, and triggers the signing approval flow via the `onApproveSigning`
+     * callback. Depending on the decision, sends a nonce approval message or emits a 'cohort-failed'
+     * event.
+     * @param {BaseMessage} msg - The received authorization request message.
+     * @returns {Promise<void>} Resolves when processing is complete.
+     * @throws {Error} If an error occurs during message processing or callback execution.
+     */
+    async #handleAuthorizationRequest(msg) {
+        if (this.#stopped)
+            return;
+        try {
+            this.session.receive(msg);
+            const cohortId = msg.body?.cohortId;
+            if (!cohortId)
+                return;
+            const req = this.session.pendingSigningRequests.get(cohortId);
+            if (!req)
+                return;
+            this.emit('signing-requested', req);
+            const decision = await this.#onApproveSigning(req);
+            if (!decision.approved) {
+                this.emit('cohort-failed', { cohortId, reason: 'Signing rejected by participant' });
+                return;
+            }
+            await this.#sendAll(this.session.approveNonce(cohortId));
+        }
+        catch (err) {
+            this.emit('error', err);
+        }
+    }
+    /**
+     * Internal: handler for aggregated nonce messages. Updates the session state, triggers partial
+     * signature generation, and sends the partial signature to the aggregator. If the cohort reaches
+     * completion after processing the nonce, emits a 'cohort-complete' event.
+     * @param {BaseMessage} msg - The received aggregated nonce message.
+     * @returns {Promise<void>} Resolves when processing is complete.
+     * @throws {Error} If an error occurs during message processing or partial signature generation.
+     */
+    async #handleAggregatedNonce(msg) {
+        if (this.#stopped)
+            return;
+        try {
+            this.session.receive(msg);
+            const cohortId = msg.body?.cohortId;
+            if (!cohortId)
+                return;
+            await this.#sendAll(this.session.generatePartialSignature(cohortId));
+            // Check if we've reached completion
+            this.#emitCohortCompleteIfDone(cohortId);
+        }
+        catch (err) {
+            this.emit('error', err);
+        }
+    }
+    /**
+     * Internal: handler for fallback authorization requests. The service abandoned
+     * the optimistic key path; the member authorizes the k-of-n script-path spend
+     * of the same beacon transaction (ADR 042). Reuses `onApproveSigning` to gate
+     * the decision, signs the fallback, and completes once it has contributed (the
+     * service needs only k members).
+     * @param {BaseMessage} msg - The received fallback authorization request message.
+     * @returns {Promise<void>} Resolves when processing is complete.
+     */
+    async #handleFallbackAuthorizationRequest(msg) {
+        if (this.#stopped)
+            return;
+        try {
+            this.session.receive(msg);
+            const cohortId = msg.body?.cohortId;
+            if (!cohortId)
+                return;
+            const req = this.session.pendingFallbackRequests.get(cohortId);
+            if (!req)
+                return;
+            this.emit('fallback-requested', req);
+            const decision = await this.#onApproveSigning(req);
+            if (!decision.approved) {
+                this.emit('cohort-failed', { cohortId, reason: 'Fallback signing rejected by participant' });
+                return;
+            }
+            await this.#sendAll(this.session.approveFallback(cohortId));
+            // The member has contributed its fallback signature and is done from its
+            // own perspective, regardless of whether the service has yet collected k.
+            this.#emitCohortCompleteIfDone(cohortId);
+        }
+        catch (err) {
+            this.emit('error', err);
+        }
+    }
+    /**
+     * Internal: emit `cohort-complete` with the participant's retained sidecar once
+     * the cohort has reached the Complete phase. Surfaces the CAS Announcement map
+     * (CAS beacons) or the SMT proof (SMT beacons) the participant keeps for future
+     * DID resolution. Read via getValidation (not pendingValidations, which lists
+     * only the AwaitingValidation phase) so the sidecar is still available at
+     * Complete. Shared by the optimistic and fallback completion paths.
+     */
+    #emitCohortCompleteIfDone(cohortId) {
+        if (this.session.getCohortPhase(cohortId) !== ParticipantCohortPhase.Complete)
+            return;
+        const info = this.session.joinedCohorts.get(cohortId);
+        if (!info)
+            return;
+        const validation = this.session.getValidation(cohortId);
+        this.emit('cohort-complete', {
+            cohortId,
+            beaconAddress: info.beaconAddress,
+            beaconType: validation?.beaconType ?? '',
+            included: validation?.included ?? true,
+            casAnnouncement: validation?.casAnnouncement,
+            smtProof: validation?.smtProof,
+        });
+    }
+    /**
+     * Internal: send helper to ensure messages are sent sequentially. This is important for protocol
+     * correctness, as some transports may not guarantee message order if sent in parallel.
+     * @param {BaseMessage[]} msgs - The messages to send.
+     * @returns {Promise<void>} Resolves when all messages have been sent.
+     * @throws {Error} If an error occurs during message sending.
+     */
+    async #sendAll(msgs) {
+        for (const m of msgs) {
+            await this.#transport.sendMessage(m, this.#did, m.to);
+        }
+    }
+}
+_a = AggregationParticipantRunner;
+//# sourceMappingURL=participant-runner.js.map

package/dist/esm/runner/participant-runner.js.map

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