@did-btcr2/method 0.26.0 → 0.27.0

package/dist/types/core/aggregation/runner/service-runner.d.ts

@@ -0,0 +1,102 @@
+import type { SchnorrKeyPair } from '@did-btcr2/keypair';
+import type { AggregationResult, CohortConfig, PendingOptIn, SigningTxData } from '../service.js';
+import { AggregationService } from '../service.js';
+import type { Transport } from '../transport/transport.js';
+import type { AggregationServiceEvents } from './events.js';
+import { TypedEventEmitter } from './typed-emitter.js';
+/** Decision callback: accept or reject a participant's opt-in. */
+export type OnOptInReceived = (optIn: PendingOptIn) => Promise<{
+    accepted: boolean;
+}>;
+/** Decision callback: finalize keygen now, or wait for more participants. */
+export type OnReadyToFinalize = (info: {
+    acceptedCount: number;
+    minRequired: number;
+}) => Promise<{
+    finalize: boolean;
+}>;
+/** Data callback: provide the Bitcoin transaction data to sign. */
+export type OnProvideTxData = (info: {
+    cohortId: string;
+    beaconAddress: string;
+    signalBytes: Uint8Array;
+}) => Promise<SigningTxData>;
+export interface AggregationServiceRunnerOptions {
+    /** Underlying transport (NostrTransport, MockTransport, etc.). */
+    transport: Transport;
+    /** This service's identity. */
+    did: string;
+    keys: SchnorrKeyPair;
+    /** Cohort configuration. */
+    config: CohortConfig;
+    /**
+     * Decide whether to accept a participant's opt-in.
+     * Default: auto-accept all opt-ins.
+     */
+    onOptInReceived?: OnOptInReceived;
+    /**
+     * Decide whether to finalize keygen now or wait for more participants.
+     * Called after each accepted opt-in once minParticipants is reached.
+     * Default: finalize as soon as minParticipants is reached.
+     */
+    onReadyToFinalize?: OnReadyToFinalize;
+    /**
+     * Provide the Bitcoin transaction data to sign.
+     * REQUIRED — no sensible default.
+     */
+    onProvideTxData: OnProvideTxData;
+}
+/**
+ * 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 declare class AggregationServiceRunner extends TypedEventEmitter<AggregationServiceEvents> {
+    #private;
+    /** Direct access to the underlying state machine for advanced use. */
+    readonly session: AggregationService;
+    constructor(options: AggregationServiceRunnerOptions);
+    /**
+     * 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(): Promise<AggregationResult>;
+    /**
+     * Stop the runner early. Cleans up internal state.
+     * Note: does not unregister transport handlers (the transport interface
+     * does not currently expose unregister).
+     */
+    stop(): void;
+}
+//# sourceMappingURL=service-runner.d.ts.map

package/dist/types/core/aggregation/runner/service-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-runner.d.ts","sourceRoot":"","sources":["../../../../../src/core/aggregation/runner/service-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAUzD,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,aAAa,EAAC,MAAM,eAAe,CAAC;AACtC,OAAO,EACL,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEtF,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB,KAAK,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAErC,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,UAAU,CAAC;CACzB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAE7B,MAAM,WAAW,+BAA+B;IAC9C,kEAAkE;IAClE,SAAS,EAAE,SAAS,CAAC;IAErB,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;IAErB,4BAA4B;IAC5B,MAAM,EAAE,YAAY,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC;;;OAGG;IACH,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,wBAAyB,SAAQ,iBAAiB,CAAC,wBAAwB,CAAC;;IACvF,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;gBAezB,OAAO,EAAE,+BAA+B;IAcpD;;;;;OAKG;IACH,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAkBjC;;;;OAIG;IACH,IAAI,IAAI,IAAI;CAyMb"}

package/dist/types/core/aggregation/runner/typed-emitter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Tiny strongly-typed event emitter.
+ *
+ * Browser-compatible (no Node.js `events` module). Uses a generic event map
+ * to give compile-time safety on event names and listener signatures.
+ *
+ * @example
+ * type MyEvents = {
+ *   'connected': [{ host: string }];
+ *   'data': [Uint8Array];
+ *   'error': [Error];
+ * };
+ *
+ * class MyClient extends TypedEventEmitter<MyEvents> {
+ *   doStuff() {
+ *     this.emit('connected', { host: 'example.com' });  // ✓ typed
+ *     this.emit('data', new Uint8Array([1, 2]));        // ✓ typed
+ *   }
+ * }
+ *
+ * const client = new MyClient();
+ * client.on('connected', ({ host }) => console.log(host));  // ✓ typed
+ */
+export type EventMap = Record<string, ReadonlyArray<unknown>>;
+export type Listener<Args extends ReadonlyArray<unknown>> = (...args: Args) => void;
+export declare class TypedEventEmitter<Events extends EventMap> {
+    #private;
+    /** Subscribe to an event. */
+    on<K extends keyof Events>(event: K, listener: Listener<Events[K]>): this;
+    /** Subscribe to an event, automatically unsubscribing after the first call. */
+    once<K extends keyof Events>(event: K, listener: Listener<Events[K]>): this;
+    /** Unsubscribe a specific listener. */
+    off<K extends keyof Events>(event: K, listener: Listener<Events[K]>): this;
+    /** Emit an event to all subscribed listeners. */
+    emit<K extends keyof Events>(event: K, ...args: Events[K]): boolean;
+    /** Remove all listeners (optionally for a specific event). */
+    removeAllListeners<K extends keyof Events>(event?: K): this;
+    /** Number of listeners for an event. */
+    listenerCount<K extends keyof Events>(event: K): number;
+}
+//# sourceMappingURL=typed-emitter.d.ts.map

package/dist/types/core/aggregation/runner/typed-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-emitter.d.ts","sourceRoot":"","sources":["../../../../../src/core/aggregation/runner/typed-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAE9D,MAAM,MAAM,QAAQ,CAAC,IAAI,SAAS,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;AAEpF,qBAAa,iBAAiB,CAAC,MAAM,SAAS,QAAQ;;IAGpD,6BAA6B;IAC7B,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAUzE,+EAA+E;IAC/E,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAQ3E,uCAAuC;IACvC,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAK1E,iDAAiD;IACjD,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO;IAcnE,8DAA8D;IAC9D,kBAAkB,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAS3D,wCAAwC;IACxC,aAAa,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;CAGxD"}

package/dist/types/core/aggregation/service.d.ts

@@ -0,0 +1,112 @@
+import type { SignedBTCR2Update } from '@did-btcr2/cryptosuite';
+import type { SchnorrKeyPair } from '@did-btcr2/keypair';
+import type { Transaction } from 'bitcoinjs-lib';
+import { AggregationCohort } from './cohort.js';
+import type { BaseMessage } from './messages/base.js';
+import type { ServiceCohortPhaseType } from './phases.js';
+/** Cohort configuration set by the service operator. */
+export interface CohortConfig {
+    minParticipants: number;
+    network: string;
+    beaconType: string;
+}
+/** Pending opt-in awaiting service operator approval. */
+export interface PendingOptIn {
+    cohortId: string;
+    participantDid: string;
+    participantPk: Uint8Array;
+    communicationPk: Uint8Array;
+}
+/** Validation tracking progress. */
+export interface ValidationProgress {
+    approved: ReadonlySet<string>;
+    rejected: ReadonlySet<string>;
+    pending: ReadonlySet<string>;
+    total: number;
+}
+/** Final aggregation result for a cohort. */
+export interface AggregationResult {
+    cohortId: string;
+    signature: Uint8Array;
+    signedTx: Transaction;
+}
+/** Transaction data needed to start a signing session. */
+export interface SigningTxData {
+    tx: Transaction;
+    prevOutScripts: Uint8Array[];
+    prevOutValues: bigint[];
+}
+export interface AggregationServiceParams {
+    did: string;
+    keys: SchnorrKeyPair;
+}
+/**
+ * Sans-I/O state machine for an Aggregation Service.
+ *
+ * Manages multiple cohorts simultaneously. The service operator drives the
+ * state machine via `receive()` (for incoming messages) and explicit action
+ * methods (advertising, accepting opt-ins, finalizing keygen, building
+ * aggregated data, starting signing). All outgoing messages are returned for
+ * the caller to send via whatever transport.
+ *
+ * @class AggregationService
+ */
+export declare class AggregationService {
+    #private;
+    readonly did: string;
+    readonly keys: SchnorrKeyPair;
+    constructor({ did, keys }: AggregationServiceParams);
+    receive(message: BaseMessage): void;
+    /**
+     * Create a new cohort with the given config. Returns the cohort ID.
+     * Cohort starts in `Created` phase — call `advertise()` to broadcast.
+     */
+    createCohort(config: CohortConfig): string;
+    /**
+     * Advertise a cohort to discover participants.
+     * Returns the advert message to broadcast.
+     */
+    advertise(cohortId: string): BaseMessage[];
+    /** Pending opt-ins awaiting operator approval. */
+    pendingOptIns(cohortId: string): ReadonlyMap<string, PendingOptIn>;
+    /**
+     * Service operator accepts a participant's opt-in.
+     * Returns the accept message to send.
+     */
+    acceptParticipant(cohortId: string, participantDid: string): BaseMessage[];
+    /**
+     * Finalize cohort keygen: compute MuSig2 Taproot beacon address and send
+     * COHORT_READY messages to all accepted participants.
+     */
+    finalizeKeygen(cohortId: string): BaseMessage[];
+    /** Updates collected so far for a cohort. */
+    collectedUpdates(cohortId: string): ReadonlyMap<string, SignedBTCR2Update>;
+    /**
+     * Build the aggregated data structure (CAS Announcement or SMT tree) and
+     * return distribute messages to send to all participants for validation.
+     */
+    buildAndDistribute(cohortId: string): BaseMessage[];
+    validationProgress(cohortId: string): ValidationProgress;
+    /**
+     * Start a signing session by creating auth requests for all participants.
+     * The caller provides the transaction data — typically built via
+     * `buildBeaconTransaction()` against a Bitcoin connection.
+     */
+    startSigning(cohortId: string, txData: SigningTxData): BaseMessage[];
+    /**
+     * Generate the aggregated nonce and return messages to send to participants.
+     * Call after `validationProgress(cohortId).approved.size === total`.
+     */
+    sendAggregatedNonce(cohortId: string): BaseMessage[];
+    getResult(cohortId: string): AggregationResult | undefined;
+    getCohortPhase(cohortId: string): ServiceCohortPhaseType | undefined;
+    getCohort(cohortId: string): AggregationCohort | undefined;
+    /**
+     * Get the signing session ID for a cohort, if a signing session has been started.
+     * @param {string} cohortId - The cohort ID.
+     * @returns {string | undefined} The session ID, or undefined if no session is active.
+     */
+    getSigningSessionId(cohortId: string): string | undefined;
+    get cohorts(): ReadonlyArray<AggregationCohort>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/types/core/aggregation/service.d.ts.map

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

package/dist/types/core/aggregation/signing-session.d.ts

@@ -0,0 +1,69 @@
+import { Transaction } from 'bitcoinjs-lib';
+import type { AggregationCohort } from './cohort.js';
+import type { SigningSessionPhaseType } from './phases.js';
+type PublicKeyHex = string;
+type Nonce = Uint8Array;
+export interface SigningSessionParams {
+    id?: string;
+    cohort: AggregationCohort;
+    pendingTx: Transaction;
+    prevOutScripts?: Uint8Array[];
+    prevOutValues?: bigint[];
+}
+/**
+ * MuSig2 signing session for a beacon transaction.
+ *
+ * Implements the BIP-327 signing protocol over a Taproot key-path-only
+ * transaction. The session is used by both AggregationService (collecting
+ * nonces and partial signatures, computing the final signature) and
+ * AggregationParticipant (generating their nonce and partial signature).
+ *
+ * @class BeaconSigningSession
+ */
+export declare class BeaconSigningSession {
+    /** Unique identifier for this signing session. */
+    id: string;
+    /** The cohort this session signs for. */
+    cohort: AggregationCohort;
+    /** The Bitcoin transaction being signed. */
+    pendingTx: Transaction;
+    /** Previous output scripts for Taproot sighash computation (BIP-341). */
+    prevOutScripts: Uint8Array[];
+    /** Previous output values for Taproot sighash computation. */
+    prevOutValues: bigint[];
+    /** Map of participant publicKey-hex → public nonce contribution. */
+    nonceContributions: Map<PublicKeyHex, Nonce>;
+    /** Aggregated MuSig2 nonce (66 bytes). */
+    aggregatedNonce?: Uint8Array;
+    /** Map of participant DID → partial signature. */
+    partialSignatures: Map<string, Uint8Array>;
+    /** Final 64-byte Schnorr signature. */
+    signature?: Uint8Array;
+    /** Current signing session phase. */
+    phase: SigningSessionPhaseType;
+    /** Participant's secret nonce (held only by the participant during signing). */
+    secretNonce?: Uint8Array;
+    constructor({ id, cohort, pendingTx, prevOutScripts, prevOutValues }: SigningSessionParams);
+    /**
+     * Computes the Taproot sighash (BIP-341) for the first input.
+     */
+    get sigHash(): Uint8Array;
+    addNonceContribution(participantDid: string, nonceContribution: Uint8Array): void;
+    generateAggregatedNonce(): Uint8Array;
+    addPartialSignature(participantDid: string, partialSig: Uint8Array): void;
+    generateFinalSignature(): Uint8Array;
+    /**
+     * Generates a fresh MuSig2 nonce contribution for the participant.
+     * Stores the secret nonce internally for use in `generatePartialSignature()`.
+     */
+    generateNonceContribution(participantPublicKey: Uint8Array, participantSecretKey: Uint8Array): Uint8Array;
+    /**
+     * Generates a partial signature using the participant's secret key + secret nonce.
+     * Requires the aggregated nonce to have been set first (via the service).
+     */
+    generatePartialSignature(participantSecretKey: Uint8Array): Uint8Array;
+    isComplete(): boolean;
+    isFailed(): boolean;
+}
+export {};
+//# sourceMappingURL=signing-session.d.ts.map

package/dist/types/core/aggregation/signing-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing-session.d.ts","sourceRoot":"","sources":["../../../../src/core/aggregation/signing-session.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG3D,KAAK,YAAY,GAAG,MAAM,CAAC;AAC3B,KAAK,KAAK,GAAG,UAAU,CAAC;AAExB,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,WAAW,CAAC;IACvB,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAC/B,kDAAkD;IAC3C,EAAE,EAAE,MAAM,CAAC;IAElB,yCAAyC;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAEjC,4CAA4C;IACrC,SAAS,EAAE,WAAW,CAAC;IAE9B,yEAAyE;IAClE,cAAc,EAAE,UAAU,EAAE,CAAC;IAEpC,8DAA8D;IACvD,aAAa,EAAE,MAAM,EAAE,CAAC;IAE/B,oEAAoE;IAC7D,kBAAkB,EAAE,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,CAAa;IAEhE,0CAA0C;IACnC,eAAe,CAAC,EAAE,UAAU,CAAC;IAEpC,kDAAkD;IAC3C,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAa;IAE9D,uCAAuC;IAChC,SAAS,CAAC,EAAE,UAAU,CAAC;IAE9B,qCAAqC;IAC9B,KAAK,EAAE,uBAAuB,CAAC;IAEtC,gFAAgF;IACzE,WAAW,CAAC,EAAE,UAAU,CAAC;gBAEpB,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,EAAE,oBAAoB;IAS1F;;OAEG;IACH,IAAI,OAAO,IAAI,UAAU,CAaxB;IAEM,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,GAAG,IAAI;IA0BjF,uBAAuB,IAAI,UAAU;IAYrC,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAoBzE,sBAAsB,IAAI,UAAU;IAsB3C;;;OAGG;IACI,yBAAyB,CAAC,oBAAoB,EAAE,UAAU,EAAE,oBAAoB,EAAE,UAAU,GAAG,UAAU;IAOhH;;;OAGG;IACI,wBAAwB,CAAC,oBAAoB,EAAE,UAAU,GAAG,UAAU;IAiBtE,UAAU,IAAI,OAAO;IAIrB,QAAQ,IAAI,OAAO;CAG3B"}

package/dist/types/core/aggregation/transport/didcomm.d.ts

@@ -0,0 +1,20 @@
+import type { SchnorrKeyPair } from '@did-btcr2/keypair';
+import type { BaseMessage } from '../messages/base.js';
+import type { MessageHandler, Transport } from './transport.js';
+/**
+ * DIDComm Transport (stub).
+ *
+ * @class DidCommTransport
+ * @implements {Transport}
+ */
+export declare class DidCommTransport implements Transport {
+    name: string;
+    start(): void;
+    registerActor(_did: string, _keys: SchnorrKeyPair): void;
+    getActorPk(_did: string): Uint8Array | undefined;
+    registerPeer(_did: string, _communicationPk: Uint8Array): void;
+    getPeerPk(_did: string): Uint8Array | undefined;
+    registerMessageHandler(_actorDid: string, _messageType: string, _handler: MessageHandler): void;
+    sendMessage(_message: BaseMessage, _sender: string, _recipient?: string): Promise<void>;
+}
+//# sourceMappingURL=didcomm.d.ts.map

package/dist/types/core/aggregation/transport/didcomm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"didcomm.d.ts","sourceRoot":"","sources":["../../../../../src/core/aggregation/transport/didcomm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IACzC,IAAI,EAAE,MAAM,CAAa;IAEzB,KAAK,IAAI,IAAI;IAIb,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAIxD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIhD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,GAAG,IAAI;IAI9D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI/C,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAIzF,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrG"}

package/dist/types/core/{beacon/aggregation/communication → aggregation/transport}/error.d.ts

@@ -1,8 +1,8 @@
 import { MethodError } from '@did-btcr2/common';
-export declare class CommunicationServiceError extends MethodError {
+export declare class TransportError extends MethodError {
     constructor(message: string, type?: string, data?: Record<string, any>);
 }
-export declare class CommunicationAdapterError extends MethodError {
+export declare class TransportAdapterError extends MethodError {
     constructor(message: string, type?: string, data?: Record<string, any>);
 }
 //# sourceMappingURL=error.d.ts.map

package/dist/types/core/aggregation/transport/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../../../src/core/aggregation/transport/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,qBAAa,cAAe,SAAQ,WAAW;gBACjC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAyB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGzF;AAED,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAgC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGhG"}

package/dist/types/core/aggregation/transport/factory.d.ts

@@ -0,0 +1,13 @@
+import type { Transport, TransportType } from './transport.js';
+export interface TransportConfig {
+    type: TransportType;
+    relays?: string[];
+}
+/**
+ * Factory for creating Transport instances.
+ * @class TransportFactory
+ */
+export declare class TransportFactory {
+    static establish(config: TransportConfig): Transport;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/types/core/aggregation/transport/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/core/aggregation/transport/factory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS;CAarD"}

package/dist/types/core/aggregation/transport/index.d.ts

@@ -0,0 +1,6 @@
+export * from './transport.js';
+export * from './error.js';
+export * from './factory.js';
+export * from './nostr.js';
+export * from './didcomm.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/core/aggregation/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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"}

package/dist/types/core/aggregation/transport/nostr.d.ts

@@ -0,0 +1,55 @@
+import type { Did } from '@did-btcr2/common';
+import type { SchnorrKeyPair } from '@did-btcr2/keypair';
+import { SimplePool } from 'nostr-tools/pool';
+import type { BaseMessage } from '../messages/base.js';
+import type { MessageHandler, Transport } from './transport.js';
+/**
+ * Default Nostr relay URLs.
+ * @constant {Array<string>} DEFAULT_NOSTR_RELAYS
+ */
+export declare const DEFAULT_NOSTR_RELAYS: string[];
+export interface NostrTransportConfig {
+    relays?: string[];
+}
+/**
+ * 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) → kind 1 (plaintext)
+ * - Update messages (SUBMIT_UPDATE, DISTRIBUTE_AGGREGATED_DATA, VALIDATION_ACK) → kind 1059 (NIP-44 encrypted)
+ * - Sign messages → kind 1059 (NIP-44 encrypted)
+ *
+ * @class NostrTransport
+ * @implements {Transport}
+ */
+export declare class NostrTransport implements Transport {
+    #private;
+    name: string;
+    pool?: SimplePool;
+    constructor(config?: NostrTransportConfig);
+    /**
+     * 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();
+     * transport.registerActor('did:btcr2:...', keys);
+     * transport.start();
+     */
+    registerActor(did: string, keys: SchnorrKeyPair): void;
+    getActorPk(did: string): Uint8Array | undefined;
+    registerPeer(did: string, communicationPk: Uint8Array): void;
+    getPeerPk(did: string): Uint8Array | undefined;
+    registerMessageHandler(actorDid: string, messageType: string, handler: MessageHandler): void;
+    start(): NostrTransport;
+    sendMessage(message: BaseMessage, sender: Did, to?: Did): Promise<void>;
+}
+//# sourceMappingURL=nostr.d.ts.map

package/dist/types/core/aggregation/transport/nostr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nostr.d.ts","sourceRoot":"","sources":["../../../../../src/core/aggregation/transport/nostr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UAKhC,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAQD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAe,YAAW,SAAS;;IAC9C,IAAI,EAAE,MAAM,CAAW;IAEvB,IAAI,CAAC,EAAE,UAAU,CAAC;gBAMN,MAAM,CAAC,EAAE,oBAAoB;IAIzC;;;;;;;;;;;OAWG;IACI,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAUtD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI/C,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,GAAG,IAAI;IAY5D,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI9C,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAW5F,KAAK,IAAI,cAAc;IAsBjB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAkMrF"}

package/dist/types/core/aggregation/transport/transport.d.ts

@@ -0,0 +1,37 @@
+import type { SchnorrKeyPair } from '@did-btcr2/keypair';
+import type { BaseMessage } from '../messages/base.js';
+export type SyncMessageHandler = (msg: any) => void;
+export type AsyncMessageHandler = (msg: any) => Promise<void>;
+export type MessageHandler = SyncMessageHandler | AsyncMessageHandler;
+export type TransportType = 'nostr' | 'didcomm';
+/**
+ * Multi-actor message transport.
+ *
+ * A single transport instance manages one connection (relay pool, channel, etc.)
+ * shared by all registered actors. Each actor registers its own DID and keys;
+ * the transport resolves the correct identity when sending or receiving messages.
+ *
+ * The transport is a pure passthrough — it knows nothing about the aggregation
+ * protocol. It only signs/encrypts outgoing messages with the sender's keys and
+ * dispatches incoming messages to the correct actor's registered handler.
+ *
+ * @interface Transport
+ */
+export interface Transport {
+    name: string;
+    /** Start the underlying transport (idempotent — only starts once). */
+    start(): void;
+    /** Register an actor (service or participant) with this transport. */
+    registerActor(did: string, keys: SchnorrKeyPair): void;
+    /** Return a registered actor's compressed communication public key. */
+    getActorPk(did: string): Uint8Array | undefined;
+    /** Store a remote peer's communication public key for encrypted routing. */
+    registerPeer(did: string, communicationPk: Uint8Array): void;
+    /** Retrieve a remote peer's communication public key. */
+    getPeerPk(did: string): Uint8Array | undefined;
+    /** Register a message handler scoped to a specific actor. */
+    registerMessageHandler(actorDid: string, messageType: string, handler: MessageHandler): void;
+    /** Send a message. The transport looks up sender to resolve signing keys. */
+    sendMessage(message: BaseMessage, sender: string, recipient?: string): Promise<void>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/types/core/aggregation/transport/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../../src/core/aggregation/transport/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;AACpD,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAEtE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IAEb,sEAAsE;IACtE,KAAK,IAAI,IAAI,CAAC;IAEd,sEAAsE;IACtE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAEvD,uEAAuE;IACvE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAEhD,4EAA4E;IAC5E,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,GAAG,IAAI,CAAC;IAE7D,yDAAyD;IACzD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAE/C,6DAA6D;IAC7D,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAE7F,6EAA6E;IAC7E,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF"}

package/dist/types/core/beacon/beacon.d.ts

@@ -1,9 +1,17 @@
-import type { KeyBytes } from '@did-btcr2/common';
 import type { BitcoinConnection } from '@did-btcr2/bitcoin';
+import type { KeyBytes } from '@did-btcr2/common';
 import type { SignedBTCR2Update } from '@did-btcr2/cryptosuite';
 import type { BeaconProcessResult } from '../resolver.js';
 import type { SidecarData } from '../types.js';
+import type { FeeEstimator } from './fee-estimator.js';
 import type { BeaconService, BeaconSignal } from './interfaces.js';
+/**
+ * Options accepted by {@link Beacon.buildSignAndBroadcast}.
+ */
+export interface BroadcastOptions {
+    /** Fee estimator for computing the transaction fee. Defaults to {@link DEFAULT_FEE_ESTIMATOR}. */
+    feeEstimator?: FeeEstimator;
+}
 /**
  * Abstract base class for all BTCR2 Beacon types.
  * A Beacon is a service listed in a BTCR2 DID document that informs resolvers
@@ -43,8 +51,35 @@ export declare abstract class Beacon {
      * @param {SignedBTCR2Update} signedUpdate The signed BTCR2 update to broadcast.
      * @param {KeyBytes} secretKey The secret key for signing the Bitcoin transaction.
      * @param {BitcoinConnection} bitcoin The Bitcoin network connection.
+     * @param {BroadcastOptions} [options] Optional broadcast configuration (e.g. fee estimator).
      * @returns {Promise<SignedBTCR2Update>} The signed update that was broadcast.
      */
-    abstract broadcastSignal(signedUpdate: SignedBTCR2Update, secretKey: KeyBytes, bitcoin: BitcoinConnection): Promise<SignedBTCR2Update>;
+    abstract broadcastSignal(signedUpdate: SignedBTCR2Update, secretKey: KeyBytes, bitcoin: BitcoinConnection, options?: BroadcastOptions): Promise<SignedBTCR2Update>;
+    /**
+     * Shared PSBT construction + signing + broadcast helper used by all beacon types.
+     *
+     * Steps:
+     * 1. Parse the beacon's `serviceEndpoint` (stripping `bitcoin:` prefix) into a Bitcoin address.
+     * 2. Query the address for unconfirmed/confirmed UTXOs.
+     * 3. Select the most recent confirmed UTXO.
+     * 4. Fetch the previous transaction hex for `nonWitnessUtxo`.
+     * 5. Build a PSBT: input (UTXO) → change output + OP_RETURN(signalBytes).
+     * 6. Compute the fee via the supplied (or default) {@link FeeEstimator} against the tx vsize.
+     * 7. Sign input 0 with an ECDSA signer derived from `secretKey`.
+     * 8. Finalize, extract, and broadcast via the REST transaction endpoint.
+     *
+     * Fee handling: the PSBT is constructed with a placeholder change amount, signed to measure
+     * vsize, then the change is adjusted to pay the actual fee and the input re-signed. This
+     * two-pass approach avoids hardcoded fee constants and produces a tx that matches the
+     * estimator's rate.
+     *
+     * @param signalBytes 32-byte payload to embed in OP_RETURN.
+     * @param secretKey Secret key used to sign the spending input.
+     * @param bitcoin Bitcoin network connection.
+     * @param options Broadcast options (fee estimator, etc.).
+     * @returns The txid of the broadcast transaction.
+     * @throws {BeaconError} if the address is unfunded or no UTXO is available.
+     */
+    protected buildSignAndBroadcast(signalBytes: Uint8Array, secretKey: KeyBytes, bitcoin: BitcoinConnection, options?: BroadcastOptions): Promise<string>;
 }
 //# sourceMappingURL=beacon.d.ts.map

package/dist/types/core/beacon/beacon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"beacon.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/beacon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnE;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,MAAM;IAC1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;gBAEpB,OAAO,EAAE,aAAa;IAIlC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,CACrB,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,EAC5B,OAAO,EAAE,WAAW,GACnB,mBAAmB;IAEtB;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CACtB,YAAY,EAAE,iBAAiB,EAC/B,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC;CAC9B"}
+{"version":3,"file":"beacon.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/beacon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKnE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kGAAkG;IAClG,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,MAAM;IAC1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;gBAEpB,OAAO,EAAE,aAAa;IAIlC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,CACrB,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,EAC5B,OAAO,EAAE,WAAW,GACnB,mBAAmB;IAEtB;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,CACtB,YAAY,EAAE,iBAAiB,EAC/B,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,iBAAiB,CAAC;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;cACa,qBAAqB,CACnC,WAAW,EAAE,UAAU,EACvB,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC;CAsEnB"}

package/dist/types/core/beacon/cas-beacon.d.ts

@@ -3,8 +3,17 @@ import type { KeyBytes } from '@did-btcr2/common';
 import type { SignedBTCR2Update } from '@did-btcr2/cryptosuite';
 import type { BeaconProcessResult } from '../resolver.js';
 import type { SidecarData } from '../types.js';
+import type { BroadcastOptions } from './beacon.js';
 import { Beacon } from './beacon.js';
-import type { BeaconService, BeaconSignal } from './interfaces.js';
+import type { BeaconService, BeaconSignal, CasPublishFn } from './interfaces.js';
+/**
+ * CAS-specific broadcast options — extends {@link BroadcastOptions} with an optional
+ * `casPublish` callback used to publish the CAS Announcement off-chain after the
+ * OP_RETURN signal is broadcast.
+ */
+export interface CASBroadcastOptions extends BroadcastOptions {
+    casPublish?: CasPublishFn;
+}
 /**
  * Implements {@link https://dcdpr.github.io/did-btcr2/terminology.html#cas-beacon | CAS Beacon}.
  *
@@ -30,7 +39,7 @@ export declare class CASBeacon extends Beacon {
      * For each signal, the signalBytes contain the hex-encoded hash of a CAS Announcement.
      * The CAS Announcement maps DIDs to their base64url-encoded update hashes.
      * This method looks up the CAS Announcement from the sidecar, extracts the update
-     * hash for the DID being resolved, and retrieves the corresponding signed update.
+     * hash for the DID being resolved, and retrieves the corresponding signed update from sidecar.
      *
      * @param {Array<BeaconSignal>} signals The array of Beacon Signals to process.
      * @param {SidecarData} sidecar The sidecar data associated with the CAS Beacon.
@@ -41,16 +50,19 @@ export declare class CASBeacon extends Beacon {
     /**
      * Broadcasts a CAS Beacon signal to the Bitcoin network.
      *
-     * Creates a CAS Announcement mapping the DID to the update hash, then broadcasts
-     * the hash of the announcement via OP_RETURN. The CAS Announcement is distributed
-     * to resolvers via sidecar data.
+     * 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}.
      *
      * @param {SignedBTCR2Update} signedUpdate The signed BTCR2 update to broadcast.
      * @param {KeyBytes} secretKey The secret key for signing the Bitcoin transaction.
      * @param {BitcoinConnection} bitcoin The Bitcoin network connection.
+     * @param {CASBroadcastOptions} [options] Optional broadcast configuration, including a
+     *   `casPublish` callback to publish the announcement off-chain and a `feeEstimator`.
      * @returns {Promise<SignedBTCR2Update>} The signed update that was broadcast.
-     * @throws {CASBeaconError} if the bitcoin address is invalid or unfunded.
+     * @throws {BeaconError} if the bitcoin address is invalid, unfunded, or UTXO cannot cover the fee.
      */
-    broadcastSignal(signedUpdate: SignedBTCR2Update, secretKey: KeyBytes, bitcoin: BitcoinConnection): Promise<SignedBTCR2Update>;
+    broadcastSignal(signedUpdate: SignedBTCR2Update, secretKey: KeyBytes, bitcoin: BitcoinConnection, options?: CASBroadcastOptions): Promise<SignedBTCR2Update>;
 }
 //# sourceMappingURL=cas-beacon.d.ts.map