@did-btcr2/method 0.26.0 → 0.28.0

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

@@ -0,0 +1,286 @@
+import { AGGREGATED_NONCE, AUTHORIZATION_REQUEST, COHORT_ADVERT, COHORT_OPT_IN_ACCEPT, COHORT_READY, DISTRIBUTE_AGGREGATED_DATA, } from '../messages/constants.js';
+import { AggregationParticipant } from '../participant.js';
+import { ParticipantCohortPhase } from '../phases.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 }) => {
+<<<<<<< Updated upstream
+ *     return Update.sign(myDid, unsigned, vm, secretKey);
+=======
+ *     return Updater.sign(myDid, unsigned, vm, secretKey);
+>>>>>>> Stashed changes
+ *   },
+ * });
+ *
+ * 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, keys: 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. Does not unregister transport handlers. */
+    stop() {
+        this.#stopped = true;
+    }
+    /**
+     * Single-shot helper: start, join the first cohort that passes `shouldJoin`,
+     * drive it to completion, and resolve. Convenient for tests and demos.
+     */
+    static async joinFirst(options) {
+        return new Promise((resolve, reject) => {
+            const runner = new AggregationParticipantRunner(options);
+            runner.once('cohort-complete', (info) => {
+                runner.stop();
+                resolve(info);
+            });
+            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));
+    }
+    /**
+     * 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
+            const signedUpdate = await this.#onProvideUpdate({
+                cohortId,
+                beaconAddress: info.beaconAddress,
+            });
+            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
+            if (this.session.getCohortPhase(cohortId) === ParticipantCohortPhase.Complete) {
+                const info = this.session.joinedCohorts.get(cohortId);
+                if (info) {
+                    this.emit('cohort-complete', { cohortId, beaconAddress: info.beaconAddress });
+                }
+            }
+        }
+        catch (err) {
+            this.emit('error', err);
+        }
+    }
+    /**
+     * 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);
+        }
+    }
+}
+//# sourceMappingURL=participant-runner.js.map

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

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

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

@@ -0,0 +1,290 @@
+import { COHORT_OPT_IN, NONCE_CONTRIBUTION, SIGNATURE_AUTHORIZATION, SUBMIT_UPDATE, VALIDATION_ACK, } from '../messages/constants.js';
+import { ServiceCohortPhase } from '../phases.js';
+import { AggregationService } from '../service.js';
+import { TypedEventEmitter } from './typed-emitter.js';
+/**
+ * High-level facade for running an Aggregation Service over a Transport.
+ *
+ * Wires the {@link AggregationService} state machine to a {@link Transport},
+ * encapsulating message handler registration, outgoing message dispatch,
+ * and decision callback orchestration.
+ *
+ * @example
+ * ```typescript
+ * const transport = new NostrTransport({ relays: [RELAY] });
+ * transport.registerActor(serviceDid, serviceKeys);
+ *
+ * const runner = new AggregationServiceRunner({
+ *   transport,
+ *   did: serviceDid,
+ *   keys: serviceKeys,
+ *   config: { minParticipants: 2, network: 'mutinynet', beaconType: 'CASBeacon' },
+ *   onProvideTxData: async ({ beaconAddress, signalBytes }) => {
+ *     return await buildBeaconTransaction(beaconAddress, signalBytes, bitcoin);
+ *   },
+ * });
+ *
+ * runner.on('keygen-complete', ({ beaconAddress }) => console.log(beaconAddress));
+ * runner.on('signing-complete', ({ signature }) => console.log('done'));
+ *
+ * const result = await runner.run();
+ * ```
+ *
+ * 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 AggregationServiceRunner
+ */
+export class AggregationServiceRunner extends TypedEventEmitter {
+    /** Direct access to the underlying state machine for advanced use. */
+    session;
+    #transport;
+    #did;
+    #config;
+    #onOptInReceived;
+    #onReadyToFinalize;
+    #onProvideTxData;
+    #cohortId;
+    #handlersRegistered = false;
+    #stopped = false;
+    #resolveRun;
+    #rejectRun;
+    constructor(options) {
+        super();
+        this.#transport = options.transport;
+        this.#did = options.did;
+        this.#config = options.config;
+        this.#onOptInReceived = options.onOptInReceived ?? (async () => ({ accepted: true }));
+        this.#onReadyToFinalize = options.onReadyToFinalize ?? (async ({ acceptedCount, minRequired }) => ({
+            finalize: acceptedCount >= minRequired,
+        }));
+        this.#onProvideTxData = options.onProvideTxData;
+        this.session = new AggregationService({ did: options.did, keys: options.keys });
+    }
+    /**
+     * Run the protocol to completion. Resolves with the final aggregation result
+     * (signature + signed transaction) once signing is complete.
+     *
+     * @returns {Promise<AggregationResult>} The final result with signature and signed tx.
+     */
+    run() {
+        return new Promise((resolve, reject) => {
+            this.#resolveRun = resolve;
+            this.#rejectRun = reject;
+            try {
+                this.#registerHandlers();
+                this.#cohortId = this.session.createCohort(this.#config);
+                // Emit cohort-advertised BEFORE the send so the event fires before any downstream cascade
+                const advertMsgs = this.session.advertise(this.#cohortId);
+                this.emit('cohort-advertised', { cohortId: this.#cohortId });
+                this.#sendAll(advertMsgs).catch(err => this.#fail(err));
+            }
+            catch (err) {
+                this.#fail(err);
+            }
+        });
+    }
+    /**
+     * Stop the runner early. Cleans up internal state.
+     * Note: does not unregister transport handlers (the transport interface
+     * does not currently expose unregister).
+     */
+    stop() {
+        this.#stopped = true;
+    }
+    /**
+     * Internal: handler registration with the transport. Idempotent.
+     */
+    #registerHandlers() {
+        if (this.#handlersRegistered)
+            return;
+        this.#handlersRegistered = true;
+        this.#transport.registerMessageHandler(this.#did, COHORT_OPT_IN, this.#handleOptIn.bind(this));
+        this.#transport.registerMessageHandler(this.#did, SUBMIT_UPDATE, this.#handleSubmitUpdate.bind(this));
+        this.#transport.registerMessageHandler(this.#did, VALIDATION_ACK, this.#handleValidationAck.bind(this));
+        this.#transport.registerMessageHandler(this.#did, NONCE_CONTRIBUTION, this.#handleNonceContribution.bind(this));
+        this.#transport.registerMessageHandler(this.#did, SIGNATURE_AUTHORIZATION, this.#handleSignatureAuthorization.bind(this));
+    }
+    /**
+     * Internal: message handlers for each protocol step. Each handler:
+     * 1) feeds the message into the state machine via session.receive()
+     * 2) emits a high-level event for external observers
+     * 3) checks if the new state triggers any automatic next steps, and if so:
+     *    a) calls the appropriate decision callback(s)
+     *    b) sends any resulting messages from the state machine
+     * @param {BaseMessage} msg - The incoming message to handle.
+     * @returns {Promise<void>} Resolves when handling is complete.
+      * @throws {Error} If any step of handling fails, the error is emitted and the run promise is rejected.
+      * Note: if the runner has been stopped, handlers will ignore incoming messages.
+     */
+    async #handleOptIn(msg) {
+        if (this.#stopped)
+            return;
+        try {
+            this.session.receive(msg);
+            const optIn = this.session.pendingOptIns(this.#cohortId).get(msg.from);
+            if (!optIn)
+                return;
+            this.emit('opt-in-received', optIn);
+            // Register peer key for encrypted messaging
+            if (optIn.communicationPk) {
+                this.#transport.registerPeer(msg.from, optIn.communicationPk);
+            }
+            const decision = await this.#onOptInReceived(optIn);
+            if (!decision.accepted)
+                return;
+            await this.#sendAll(this.session.acceptParticipant(this.#cohortId, msg.from));
+            this.emit('participant-accepted', { participantDid: msg.from });
+            // Check if it's time to finalize
+            const cohort = this.session.getCohort(this.#cohortId);
+            if (cohort.participants.length >= this.#config.minParticipants) {
+                const finalizeDecision = await this.#onReadyToFinalize({
+                    acceptedCount: cohort.participants.length,
+                    minRequired: this.#config.minParticipants,
+                });
+                if (finalizeDecision.finalize) {
+                    // finalizeKeygen() computes the beacon address synchronously
+                    // emit BEFORE awaiting sendAll. Otherwise the downstream cascade
+                    // (which can run all the way to signing-complete) would resolve the
+                    // run() promise before this event fires.
+                    const readyMsgs = this.session.finalizeKeygen(this.#cohortId);
+                    this.emit('keygen-complete', {
+                        cohortId: this.#cohortId,
+                        beaconAddress: cohort.beaconAddress,
+                    });
+                    await this.#sendAll(readyMsgs);
+                }
+            }
+        }
+        catch (err) {
+            this.#fail(err);
+        }
+    }
+    /**
+     * Handler for receiving participant updates. When all updates are received, automatically builds
+     * and distributes the data for validation.
+     * @param {BaseMessage} msg - The incoming message to handle.
+     * @returns {Promise<void>} Resolves when handling is complete.
+     * @throws {Error} If any step of handling fails, the error is emitted and the run promise is rejected.
+     * Note: if the runner has been stopped, handlers will ignore incoming messages.
+     */
+    async #handleSubmitUpdate(msg) {
+        if (this.#stopped)
+            return;
+        try {
+            this.session.receive(msg);
+            this.emit('update-received', { participantDid: msg.from });
+            // When all updates collected, build and distribute
+            if (this.session.getCohortPhase(this.#cohortId) === ServiceCohortPhase.UpdatesCollected) {
+                const distributeMsgs = this.session.buildAndDistribute(this.#cohortId);
+                this.emit('data-distributed', { cohortId: this.#cohortId });
+                await this.#sendAll(distributeMsgs);
+            }
+        }
+        catch (err) {
+            this.#fail(err);
+        }
+    }
+    /**
+     * Handler for receiving validation acknowledgments. When all validations are received,
+     * automatically requests tx data and starts signing.
+     * @param {BaseMessage} msg - The incoming message to handle.
+     * @returns {Promise<void>} Resolves when handling is complete.
+     * @throws {Error} If any step of handling fails, the error is emitted and the run promise is rejected.
+     * Note: if the runner has been stopped, handlers will ignore incoming messages.
+     */
+    async #handleValidationAck(msg) {
+        if (this.#stopped)
+            return;
+        try {
+            this.session.receive(msg);
+            const approved = !!msg.body?.approved;
+            this.emit('validation-received', { participantDid: msg.from, approved });
+            // When all validations received, request tx data and start signing
+            if (this.session.getCohortPhase(this.#cohortId) === ServiceCohortPhase.Validated) {
+                const cohort = this.session.getCohort(this.#cohortId);
+                const txData = await this.#onProvideTxData({
+                    cohortId: this.#cohortId,
+                    beaconAddress: cohort.beaconAddress,
+                    signalBytes: cohort.signalBytes,
+                });
+                const authMsgs = this.session.startSigning(this.#cohortId, txData);
+                const sessionId = this.session.getSigningSessionId(this.#cohortId) ?? '';
+                this.emit('signing-started', { sessionId });
+                await this.#sendAll(authMsgs);
+            }
+        }
+        catch (err) {
+            this.#fail(err);
+        }
+    }
+    /**
+     * Handler for receiving nonce contributions and signature authorizations. When all nonces or
+     * signatures are received,
+     * @param {BaseMessage} msg - The incoming message to handle.
+     * @returns {Promise<void>} Resolves when handling is complete.
+     * @throws {Error} If any step of handling fails, the error is emitted and the run promise is rejected.
+     * Note: if the runner has been stopped, handlers will ignore incoming messages.
+     */
+    async #handleNonceContribution(msg) {
+        if (this.#stopped)
+            return;
+        try {
+            this.session.receive(msg);
+            this.emit('nonce-received', { participantDid: msg.from });
+            // When all nonces collected, send aggregated nonce
+            if (this.session.getCohortPhase(this.#cohortId) === ServiceCohortPhase.NoncesCollected) {
+                await this.#sendAll(this.session.sendAggregatedNonce(this.#cohortId));
+            }
+        }
+        catch (err) {
+            this.#fail(err);
+        }
+    }
+    /**
+     * Handler for receiving signature authorizations. When all partial signatures are received, the
+     * session automatically completes and the final result is emitted and the run() promise is resolved.
+     * @param {BaseMessage} msg - The incoming message to handle.
+     * @returns {Promise<void>} Resolves when handling is complete.
+     * @throws {Error} If any step of handling fails, the error is emitted and the run promise is rejected.
+     * Note: if the runner has been stopped, handlers will ignore incoming messages.
+     */
+    async #handleSignatureAuthorization(msg) {
+        if (this.#stopped)
+            return;
+        try {
+            this.session.receive(msg);
+            // The state machine auto-completes when all partial sigs received
+            const result = this.session.getResult(this.#cohortId);
+            if (result) {
+                this.emit('signing-complete', result);
+                this.#resolveRun?.(result);
+            }
+        }
+        catch (err) {
+            this.#fail(err);
+        }
+    }
+    /**
+     * Internal: helper to send all messages sequentially. Catches and propagates errors.
+     * @param {BaseMessage[]} msgs - The messages to send.
+     * @returns {Promise<void>} Resolves when all messages have been sent.
+     * @throws {Error} If sending any message fails, the error is emitted and the run promise is
+     * rejected.
+     */
+    async #sendAll(msgs) {
+        for (const m of msgs) {
+            await this.#transport.sendMessage(m, this.#did, m.to);
+        }
+    }
+    /**
+     * Internal: helper to handle errors. Emits an 'error' event and rejects the run promise.
+     * @param {Error} err - The error to handle.
+     */
+    #fail(err) {
+        this.emit('error', err);
+        this.#rejectRun?.(err);
+    }
+}
+//# sourceMappingURL=service-runner.js.map

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

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