@did-btcr2/aggregation 0.1.0

package/dist/esm/transport/nostr.js

@@ -0,0 +1,491 @@
+var _a;
+import { CompressedSecp256k1PublicKey } from '@did-btcr2/keypair';
+import { bytesToHex, hexToBytes } from '@noble/hashes/utils';
+import { finalizeEvent, nip44 } from 'nostr-tools';
+import { SimplePool } from 'nostr-tools/pool';
+import { CONSOLE_LOGGER } from '../logger.js';
+import { COHORT_ADVERT } from '../messages/constants.js';
+import { isAggregationMessageType, isKeygenMessageType, isSignMessageType, isUpdateMessageType } from '../messages/guards.js';
+import { TransportAdapterError } from './error.js';
+/**
+ * Default Nostr relay URLs.
+ * @constant {Array<string>} DEFAULT_NOSTR_RELAYS
+ */
+export const DEFAULT_NOSTR_RELAYS = [
+    'wss://relay.damus.io',
+    'wss://nos.lol',
+    'wss://relay.snort.social',
+    'wss://nostr-pub.wellorder.net',
+];
+/** Default `since` lookback for broadcast (COHORT_ADVERT) subscriptions: 5 minutes. */
+export const DEFAULT_BROADCAST_LOOKBACK_MS = 5 * 60 * 1000;
+/**
+ * Nostr Transport for did:btcr2 aggregation messages.
+ *
+ * A single NostrTransport manages one relay pool and supports multiple
+ * registered actors. Each actor registers its own DID and keys via
+ * {@link registerActor}; the transport resolves the correct identity when
+ * sending or receiving.
+ *
+ * Message routing:
+ * - Keygen messages (COHORT_ADVERT, COHORT_OPT_IN, COHORT_OPT_IN_ACCEPT, COHORT_READY) to kind 1 (plaintext)
+ * - Update messages (SUBMIT_UPDATE, DISTRIBUTE_AGGREGATED_DATA, VALIDATION_ACK) to kind 1059 (NIP-44 encrypted)
+ * - Sign messages to kind 1059 (NIP-44 encrypted)
+ *
+ * @class NostrTransport
+ * @implements {Transport}
+ */
+export class NostrTransport {
+    name = 'nostr';
+    pool;
+    #relays;
+    #actors = new Map();
+    #peerRegistry = new Map();
+    #started = false;
+    #logger;
+    #broadcastLookbackMs;
+    constructor(config) {
+        this.#relays = config?.relays ?? DEFAULT_NOSTR_RELAYS;
+        this.#logger = config?.logger ?? CONSOLE_LOGGER;
+        this.#broadcastLookbackMs = config?.broadcastLookbackMs ?? DEFAULT_BROADCAST_LOOKBACK_MS;
+    }
+    /**
+     * Registers an actor (DID + keys) to send/receive messages with.
+     * Must be called before start() to ensure subscriptions are created for the actor.
+     * @param {string} did - The DID of the actor.
+     * @param {SchnorrKeyPair} keys - The Schnorr key pair for the actor.
+     * @throws {TransportAdapterError} If the actor is already registered or if the transport has already started.
+     * @example
+     * const transport = new NostrTransport();
+     * const keys = SchnorrKeyPair.generate();
+     * const did = DidBtcr2.create(keys.publicKey.compressed, { idType: 'KEY', network: 'mutinynet' });
+     * transport.registerActor(did, keys);
+     * transport.start();
+     */
+    registerActor(did, keys) {
+        const entry = { keys, handlers: new Map(), subscriptions: [] };
+        this.#actors.set(did, entry);
+        // If already started, create a directed subscription for this actor
+        if (this.#started && this.pool) {
+            this.#subscribeDirected(did, entry);
+        }
+    }
+    /**
+     * Detach an actor: drop its handlers, close its relay subscriptions, and remove its keys + peer
+     * mapping. Idempotent.
+     * @param {string} did - The DID of the actor to unregister.
+     * @returns {void}
+     * @throws {TransportAdapterError} If the transport is not started or if the pool is unavailable.
+     * @example
+     * transport.unregisterActor(did);
+     */
+    unregisterActor(did) {
+        const entry = this.#actors.get(did);
+        if (!entry)
+            return;
+        for (const sub of entry.subscriptions) {
+            try {
+                sub.close();
+            }
+            catch (err) {
+                this.#logger.debug(`Error closing subscription for ${did}:`, err);
+            }
+        }
+        entry.subscriptions.length = 0;
+        entry.handlers.clear();
+        this.#actors.delete(did);
+        this.#peerRegistry.delete(did);
+    }
+    /**
+     * Remove a single (actor, messageType) handler. Idempotent.
+     * @param {string} actorDid - The DID of the actor.
+     * @param {string} messageType - The type of message to unregister the handler for.
+     * @returns {void}
+     * @example
+     * transport.unregisterMessageHandler(actorDid, messageType);
+     */
+    unregisterMessageHandler(actorDid, messageType) {
+        const actor = this.#actors.get(actorDid);
+        if (!actor)
+            return;
+        actor.handlers.delete(messageType);
+    }
+    /**
+     * Gets the public key for a registered actor by their DID.
+     * @param {string} did - The DID of the registered actor to get the public key for.
+     * @returns {Uint8Array | undefined} The compressed public key bytes for the actor's DID, or
+     * undefined if the DID is not registered.
+     */
+    getActorPk(did) {
+        return this.#actors.get(did)?.keys.publicKey.compressed;
+    }
+    /**
+     * Registers a peer's communication public key for encrypted messages.
+     * @param {string} did - The DID of the peer to register.
+     * @param {Uint8Array} communicationPk - The compressed secp256k1 public key bytes for the peer.
+     */
+    registerPeer(did, communicationPk) {
+        try {
+            new CompressedSecp256k1PublicKey(communicationPk);
+        }
+        catch {
+            throw new TransportAdapterError(`Invalid communication public key for peer ${did}: expected a 33-byte compressed secp256k1 key.`, 'INVALID_PEER_KEY', { adapter: this.name, did, keyLength: communicationPk.length });
+        }
+        this.#peerRegistry.set(did, communicationPk);
+    }
+    /**
+     * Gets the registered communication public key for a peer by their DID.
+     * @param {string} did - The DID of the peer to get the communication public key for.
+     * @returns {Uint8Array | undefined} The compressed secp256k1 public key bytes for the peer, or
+     * undefined if the peer is not registered.
+     */
+    getPeerPk(did) {
+        return this.#peerRegistry.get(did);
+    }
+    /**
+     * Registers a message handler function for a specific actor and message type. The handler will be called
+     * when a message of the specified type is received for the actor's DID. The transport must have been
+     * started for handlers to be invoked. If the transport is already started, the handler will be registered
+     * immediately; otherwise, it will be registered when the transport starts and the actor's subscription is created.
+     * @param {string} actorDid - The DID of the actor to register the message handler for.
+     * @param {string} messageType - The type of message to handle.
+     * @param {MessageHandler} handler - The function to handle incoming messages of the specified type.
+     * @throws {TransportAdapterError} If the actor DID is not registered or if the handler is invalid.
+     */
+    registerMessageHandler(actorDid, messageType, handler) {
+        const actor = this.#actors.get(actorDid);
+        if (!actor) {
+            throw new TransportAdapterError(`Cannot register handler: actor ${actorDid} not registered. Call registerActor() first.`, 'UNKNOWN_ACTOR_ERROR', { adapter: this.name, did: actorDid });
+        }
+        actor.handlers.set(messageType, handler);
+    }
+    /**
+     * Starts the transport by connecting to the configured Nostr relays and setting up subscriptions
+     * for all registered actors. This method must be called after registering actors via registerActor()
+     * and before sending or receiving messages. The transport will subscribe to broadcast events (kind 1)
+     * for cohort adverts and directed events (kinds 1 and 1059) for each registered actor based on their
+     * public keys. Incoming events are processed and dispatched to the appropriate handlers based on
+     * message type. If the transport is already started, this method has no effect.
+     * @returns {NostrTransport}
+     */
+    start() {
+        if (this.#started)
+            return this;
+        this.#started = true;
+        this.pool = new SimplePool();
+        // Broadcast subscription: kind 1 COHORT_ADVERT events (all actors receive
+        // these). Duplicate adverts are idempotent: AggregationParticipant stores
+        // discovered cohorts in a Map keyed by cohortId.
+        //
+        // The `since` filter is a workaround for relays that don't backfill
+        // historical events to late subscribers (observed on nos.lol and
+        // relay.snort.social). Without it, an advert published before a
+        // participant's subscription lands is lost on those relays. The default
+        // 5-minute window is generous enough to cover network + subscription
+        // setup delays while still excluding ancient traffic. Set
+        // broadcastLookbackMs to 0 to disable.
+        const broadcastFilter = {
+            kinds: [1],
+            '#t': [COHORT_ADVERT],
+        };
+        if (this.#broadcastLookbackMs > 0) {
+            broadcastFilter.since = Math.floor((Date.now() - this.#broadcastLookbackMs) / 1000);
+        }
+        this.pool.subscribeMany(this.#relays, broadcastFilter, {
+            onclose: (reasons) => this.#logger.debug('Nostr broadcast subscription closed', reasons),
+            onevent: this.#handleBroadcastEvent.bind(this),
+        });
+        // Directed subscriptions for any actors already registered
+        for (const [did, entry] of this.#actors) {
+            this.#subscribeDirected(did, entry);
+        }
+        this.#logger.info(`NostrTransport started, listening on ${this.#relays.length} relay(s)`);
+        return this;
+    }
+    /**
+     * Sends a message by publishing a Nostr event to the configured relays. The message is serialized
+     * as JSON and included in the event content.
+     * @param {BaseMessage} message - The aggregation message to send. Must include a valid `type` property.
+     * @param {Did} sender - The DID of the registered actor sending the message. Must have been
+     * registered via registerActor().
+     * @param {Did} [to] - Optional recipient DID for directed messages. Required for encrypted message
+     * types. If provided, must have been registered via registerPeer().
+     * @returns {Promise<void>} Resolves when the message has been published to the relays. Note that
+     * publication is best-effort: the method will resolve as long as at least one relay accepts the
+     * event, even if others reject it.
+     */
+    async sendMessage(message, sender, to) {
+        const type = message.type;
+        if (!type) {
+            throw new TransportAdapterError('Message type is undefined', 'SEND_MESSAGE_ERROR', { adapter: this.name, type });
+        }
+        const actor = this.#actors.get(sender);
+        if (!actor) {
+            throw new TransportAdapterError(`Unknown sender: ${sender}. Call registerActor() before sending messages.`, 'UNKNOWN_ACTOR_ERROR', { adapter: this.name, did: sender });
+        }
+        const senderKeys = actor.keys;
+        // Sender p-tag matches the event signing key
+        const tags = [
+            ['p', bytesToHex(senderKeys.publicKey.x)],
+            ['t', type],
+        ];
+        if (to) {
+            const recipientPkBytes = this.#peerRegistry.get(to);
+            if (recipientPkBytes) {
+                const recipientPk = new CompressedSecp256k1PublicKey(recipientPkBytes);
+                tags.push(['p', bytesToHex(recipientPk.x)]);
+            }
+        }
+        // Keygen messages: plaintext, kind 1
+        if (isKeygenMessageType(type)) {
+            const event = finalizeEvent({
+                kind: 1,
+                created_at: Math.floor(Date.now() / 1000),
+                tags,
+                content: JSON.stringify(message, _a.#jsonReplacer),
+            }, senderKeys.secretKey.bytes);
+            this.#logger.debug(`Publishing kind 1 [${type}]`);
+            await this.#publishToRelays(event);
+            return;
+        }
+        // Update and sign messages: NIP-44 encrypted, kind 1059
+        if (isUpdateMessageType(type) || isSignMessageType(type)) {
+            if (!to) {
+                throw new TransportAdapterError(`Encrypted messages require a recipient DID, got undefined for type: ${type}`, 'SEND_MESSAGE_ERROR', { adapter: this.name });
+            }
+            const recipientPkBytes = this.#peerRegistry.get(to);
+            if (!recipientPkBytes) {
+                throw new TransportAdapterError(`Unknown peer DID: ${to}. Register peer via registerPeer() before sending encrypted messages.`, 'UNKNOWN_PEER_ERROR', { adapter: this.name, did: to });
+            }
+            const recipientPk = new CompressedSecp256k1PublicKey(recipientPkBytes);
+            const conversationKey = nip44.v2.utils.getConversationKey(senderKeys.secretKey.bytes, bytesToHex(recipientPk.x));
+            const content = nip44.v2.encrypt(JSON.stringify(message, _a.#jsonReplacer), conversationKey);
+            const event = finalizeEvent({
+                kind: 1059,
+                created_at: Math.floor(Date.now() / 1000),
+                tags,
+                content,
+            }, senderKeys.secretKey.bytes);
+            this.#logger.debug(`Publishing kind 1059 [${type}]`);
+            await this.#publishToRelays(event);
+            return;
+        }
+        this.#logger.warn(`Unsupported message type: ${type}`);
+    }
+    /**
+     * Publish the message once immediately and then re-publish on an interval
+     * until the returned stop function is invoked.
+     *
+     * Useful for broadcast messages (COHORT_ADVERT) on relays that don't
+     * backfill historical events to late subscribers: republishing gives late
+     * joiners a window to discover the message without requiring protocol
+     * changes. Relay rate-limit / publish failures inside the interval are
+     * caught and logged rather than propagated - the caller should stop the
+     * repeater once the protocol condition is satisfied.
+     */
+    publishRepeating(message, sender, intervalMs, recipient) {
+        let stopped = false;
+        // Fire the first publish eagerly; any error surfaces as a rejected
+        // promise that we swallow to avoid unhandled rejections - the caller can
+        // observe delivery via receive-side handlers.
+        void this.sendMessage(message, sender, recipient).catch((err) => {
+            this.#logger.debug('publishRepeating first send failed:', err);
+        });
+        const timer = setInterval(() => {
+            if (stopped)
+                return;
+            void this.sendMessage(message, sender, recipient).catch((err) => {
+                this.#logger.debug('publishRepeating retry failed:', err);
+            });
+        }, intervalMs);
+        return () => {
+            if (stopped)
+                return;
+            stopped = true;
+            clearInterval(timer);
+        };
+    }
+    /**
+     * Creates a directed subscription for the given actor, filtering for messages that match the
+     * actor's public key. Messages received on this subscription are dispatched to the actor's
+     * registered handlers based on message type.
+     * @param {string} did - The DID of the actor to create the subscription for.
+     * @param {ActorEntry} entry - The actor's registration entry containing keys and handlers.
+     * @returns {void}
+     * @throws {TransportAdapterError} If the transport is not started or if the pool is unavailable.
+     */
+    #subscribeDirected(did, entry) {
+        if (!this.pool)
+            return;
+        const pkHex = bytesToHex(entry.keys.publicKey.x);
+        // No `since` filter: directed messages must be retrievable on reconnect /
+        // crash-recovery. Out-of-phase messages are silently dropped by the state
+        // machines (AggregationService, AggregationParticipant), so replayed stale
+        // messages are harmless.
+        const sub = this.pool.subscribeMany(this.#relays, { kinds: [1, 1059], '#p': [pkHex] }, {
+            onclose: (reasons) => this.#logger.debug(`Nostr directed subscription closed for ${did}`, reasons),
+            onevent: this.#makeActorEventHandler(did),
+        });
+        entry.subscriptions.push(sub);
+    }
+    /**
+     * Creates an event handler function for a specific actor that processes incoming events, decrypts
+     * if necessary, and dispatches messages to the actor's registered handlers based on message type.
+     * @param {string} actorDid - The DID of the actor to create the event handler for.
+     * @returns {(event: Event) => Promise<void>} An asynchronous event handler function that
+     * processes incoming events for the specified actor.
+     */
+    #makeActorEventHandler(actorDid) {
+        return async (event) => {
+            const actor = this.#actors.get(actorDid);
+            if (!actor)
+                return;
+            // Relay self-echo: sendMessage() adds the sender's own pubkey to the
+            // event's `p` tags (so recipients can reply). The directed subscription
+            // filter `{'#p': [actor_pk]}` therefore matches every event this actor
+            // publishes. Skip - we don't need to process our own outgoing events,
+            // and attempting to NIP-44-decrypt them fails with "invalid MAC" because
+            // the content was encrypted for the recipient, not self.
+            if (event.pubkey === bytesToHex(actor.keys.publicKey.x))
+                return;
+            let message;
+            try {
+                if (event.kind === 1) {
+                    message = JSON.parse(event.content, _a.#jsonReviver);
+                }
+                else if (event.kind === 1059) {
+                    const conversationKey = nip44.v2.utils.getConversationKey(actor.keys.secretKey.bytes, event.pubkey);
+                    const plaintext = nip44.v2.decrypt(event.content, conversationKey);
+                    message = JSON.parse(plaintext, _a.#jsonReviver);
+                }
+                else {
+                    return;
+                }
+            }
+            catch (err) {
+                this.#logger.debug(`Failed to parse event ${event.id} for ${actorDid}:`, err);
+                return;
+            }
+            this.#dispatchMessage(message, actor);
+        };
+    }
+    /**
+     * Handles incoming broadcast events (kind 1) by parsing the event content, validating it as an
+     * aggregation message, and dispatching it to all registered actors that have handlers for the
+     * message type. This is used for COHORT_ADVERT messages that need to be received by all actors
+     * regardless of DID.
+     * @param {Event} event - The Nostr event to handle, expected to be a kind 1 broadcast containing
+     * a COHORT_ADVERT message. The event content is parsed and dispatched to all registered actors
+     * that have handlers for the
+     * @returns
+     */
+    async #handleBroadcastEvent(event) {
+        if (event.kind !== 1)
+            return;
+        let message;
+        try {
+            message = JSON.parse(event.content, _a.#jsonReviver);
+        }
+        catch (err) {
+            this.#logger.debug(`Failed to parse broadcast event ${event.id}:`, err);
+            return;
+        }
+        if (message.body && typeof message.body === 'object') {
+            message = { ...message, ...message.body };
+        }
+        const messageType = message.type;
+        if (!messageType || !isAggregationMessageType(messageType))
+            return;
+        // Dispatch to ALL actors that have a handler for this message type
+        for (const actor of this.#actors.values()) {
+            const handler = actor.handlers.get(messageType);
+            if (handler)
+                await handler(message);
+        }
+    }
+    /**
+     * Dispatches a parsed message to the appropriate handler of a registered actor based on message type.
+     * The message is expected to have already been parsed from the Nostr event content and validated as
+     * an aggregation message. If the message has a body, its properties are merged into the top-level
+     * message object for easier handler access. The message is then dispatched to the handler registered
+     * for its type, if one exists.
+     * @param {Record<string, unknown>} message - The message object parsed from a Nostr event, expected to
+     * @param {ActorEntry} actor - The registered actor entry containing keys and handlers to dispatch the message to.
+     * @returns {void}
+     * @throws {TransportAdapterError} If the message type is unsupported or if no handler is registered
+     * for the message type.
+     */
+    #dispatchMessage(message, actor) {
+        if (message.body && typeof message.body === 'object') {
+            message = { ...message, ...message.body };
+        }
+        const messageType = message.type;
+        if (!messageType || !isAggregationMessageType(messageType))
+            return;
+        const handler = actor.handlers.get(messageType);
+        if (handler)
+            handler(message);
+    }
+    /**
+     * Publishes a Nostr event to the configured relays and handles the results. The method waits for all
+     * relay promises to settle and checks how many accepted or rejected the event. If all relays reject the event,
+     * an error is thrown. Otherwise, the method completes successfully even if some relays rejected the event,
+     * as long as at least one relay accepted it. Relay rejections are logged for debugging purposes.
+     * @param {Event} event - The Nostr event to publish to the configured relays. The event should already
+     * @returns {Promise<void>} A promise that resolves if the event was accepted by at least one relay, or rejects
+     * with a TransportAdapterError if all relays rejected the event.
+     * @throws {TransportAdapterError} If the pool is not initialized or if all relays reject the event.
+     */
+    async #publishToRelays(event) {
+        const relayPromises = this.pool?.publish(this.#relays, event);
+        if (!relayPromises?.length)
+            return;
+        const results = await Promise.allSettled(relayPromises);
+        const accepted = results.filter(r => r.status === 'fulfilled').length;
+        const rejected = results.filter(r => r.status === 'rejected');
+        for (const r of rejected) {
+            this.#logger.debug(`Relay rejected event ${event.id}: ${r.reason}`);
+        }
+        if (accepted === 0) {
+            throw new TransportAdapterError(`All ${results.length} relay(s) rejected event ${event.id}`, 'PUBLISH_ERROR', { adapter: this.name, reasons: rejected.map(r => String(r.reason)) });
+        }
+    }
+    /**
+     * Custom JSON replacer to handle serialization of Uint8Array values as hex strings in message
+     * content. This allows messages containing binary data (e.g. public keys, signatures) to be correctly
+     * serialized to JSON for Nostr event content. The replacer checks if a value is a Uint8Array and, if so,
+     * converts it to a hex string wrapped in an object with a __bytes property. The corresponding reviver
+     * can then convert this back to a Uint8Array when parsing the message content from the event.
+     * @param {string} _key - The key of the property being processed.
+     * @param {unknown} value - The value to check if the message type is valid.
+     * @returns {unknown} The transformed value for JSON serialization. If the value is a Uint8Array,
+     * it returns an object with a __bytes property containing the hex string. Otherwise, it returns
+     * the value unchanged.
+     */
+    static #jsonReplacer(_key, value) {
+        if (value instanceof Uint8Array) {
+            return { __bytes: bytesToHex(value) };
+        }
+        return value;
+    }
+    /**
+     * Custom JSON reviver to handle deserialization of hex strings back into Uint8Array values in message
+     * content. This complements the custom replacer used during serialization, allowing messages that contain
+     * binary data (e.g. public keys, signatures) to be correctly reconstructed when parsing JSON from
+     * Nostr event content. The reviver checks if a value is an object with a __bytes property and,
+     * if so, converts the hex string back into a Uint8Array. Otherwise, it returns the value unchanged.
+     * @param {string} _key - The key of the property being processed.
+     * @param {unknown} value - The value to check if it is an object containing a __bytes property for
+     * hex string conversion.
+     * @returns {unknown} The transformed value for JSON deserialization. If the value is an object
+     * with a __bytes property, it returns a Uint8Array. Otherwise, it returns the value unchanged.
+     */
+    static #jsonReviver(_key, value) {
+        if (value && typeof value === 'object' && '__bytes' in value) {
+            return hexToBytes(value.__bytes);
+        }
+        return value;
+    }
+}
+_a = NostrTransport;
+//# sourceMappingURL=nostr.js.map

package/dist/esm/transport/nostr.js.map

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

package/dist/esm/transport/transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/esm/transport/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/transport/transport.ts"],"names":[],"mappings":""}

package/dist/types/beacon-strategy.d.ts

@@ -0,0 +1,56 @@
+import type { SignedBTCR2Update } from '@did-btcr2/cryptosuite';
+import type { SerializedSMTProof } from '@did-btcr2/smt';
+import type { AggregationCohort } from './cohort.js';
+import type { BaseBody } from './messages/base.js';
+/** Validation result returned to the participant for a distribute-data message. */
+export interface BeaconValidationResult {
+    matches: boolean;
+    casAnnouncement?: Record<string, string>;
+    smtProof?: SerializedSMTProof;
+}
+/** Per-participant body attached to DISTRIBUTE_AGGREGATED_DATA by the service. */
+export interface BeaconDistributePayload {
+    casAnnouncement?: Record<string, string>;
+    smtProof?: Record<string, unknown>;
+}
+/**
+ * Pluggable strategy for beacon-type-specific aggregation, distribution, and
+ * participant-side validation. Lets new beacon types be added without
+ * modifying the service or participant state machines: register a new strategy
+ * via {@link registerBeaconStrategy}.
+ */
+export interface AggregateBeaconStrategy {
+    /** String constant used as `beaconType` on CohortConfig / BaseMessage bodies. */
+    readonly type: string;
+    /**
+     * Service: build the aggregated data on the cohort after all updates are
+     * collected. Implementation should mutate the cohort (set signalBytes,
+     * casAnnouncement, smtProofs, etc.).
+     */
+    buildAggregatedData(cohort: AggregationCohort): void;
+    /**
+     * Service: produce the body fields to attach to DISTRIBUTE_AGGREGATED_DATA
+     * for a specific participant. Called once per cohort member.
+     */
+    getDistributePayload(cohort: AggregationCohort, participantDid: string): BeaconDistributePayload;
+    /**
+     * Participant: verify the aggregated data they received reflects their own
+     * slot. A submitter (`included: true`) checks its update is included; a
+     * decliner (`included: false`, cooperative non-inclusion) checks its
+     * non-inclusion slot instead (absence from the CAS map, or an SMT
+     * non-inclusion proof). `submittedUpdate`/`expectedHash` are present only for a
+     * submitter. Pure function: returns matches + sidecar fields for the caller.
+     */
+    validateParticipantView(params: {
+        participantDid: string;
+        included: boolean;
+        submittedUpdate?: SignedBTCR2Update;
+        expectedHash?: string;
+        body: BaseBody;
+    }): BeaconValidationResult;
+}
+/** Register a custom beacon strategy. Overwrites any existing entry with the same type. */
+export declare function registerBeaconStrategy(strategy: AggregateBeaconStrategy): void;
+/** Look up a registered beacon strategy by type, or undefined if not registered. */
+export declare function getBeaconStrategy(type: string): AggregateBeaconStrategy | undefined;
+//# sourceMappingURL=beacon-strategy.d.ts.map

package/dist/types/beacon-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon-strategy.d.ts","sourceRoot":"","sources":["../../src/beacon-strategy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,mFAAmF;AACnF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAErD;;;OAGG;IACH,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,GAAG,uBAAuB,CAAC;IAEjG;;;;;;;OAOG;IACH,uBAAuB,CAAC,MAAM,EAAE;QAC9B,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,OAAO,CAAC;QAClB,eAAe,CAAC,EAAE,iBAAiB,CAAC;QACpC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,QAAQ,CAAC;KAChB,GAAG,sBAAsB,CAAC;CAC5B;AA2ED,2FAA2F;AAC3F,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAE9E;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAEnF"}