@did-btcr2/method 0.18.1 → 0.20.0

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

@@ -2,7 +2,15 @@ import { RawSchnorrKeyPair } from '@did-btcr2/keypair';
 import { AggregateBeaconCohort } from './cohort/index.js';
 import { CommunicationService, Service, ServiceAdapterIdentity } from './communication/service.js';
 import { BeaconCohortSigningSession } from './session/index.js';
-type BeaconCoordinatorParams = {
+/**
+ * Parameters for initializing a BeaconCoordinator.
+ * @type {BeaconCoordinatorParams}
+ * @property {CommunicationService} [protocol] - The communication protocol to be used.
+ * @property {string} did - The Decentralized Identifier (DID) for the coordinator.
+ * @property {ServiceAdapterIdentity<RawSchnorrKeyPair>} keys - The keys used for cryptographic operations.
+ * @property {string} [name] - Optional name for the coordinator.
+ */
+export type BeaconCoordinatorParams = {
     protocol?: CommunicationService;
     did: string;
     keys: ServiceAdapterIdentity<RawSchnorrKeyPair>;
@@ -14,6 +22,7 @@ type BeaconCoordinatorParams = {
  * @type {BeaconCoordinator}
  */
 export declare class BeaconCoordinator {
+    #private;
     /**
      * The name of the BeaconCoordinator service.
      * @type {string}
@@ -47,37 +56,17 @@ export declare class BeaconCoordinator {
      * @param {string} [params.did] Optional DID to use for the coordinator. If not provided, a new DID will be generated.
      * @param {ServiceAdapterIdentity<RawKeyPair>} params.keys The keys used for cryptographic operations.
      */
-    constructor(params: BeaconCoordinatorParams);
+    constructor(params: {
+        did: string;
+        keys: ServiceAdapterIdentity<RawSchnorrKeyPair>;
+        protocol?: CommunicationService;
+        name?: string;
+    });
     /**
      * Setup and start the BeaconCoordinator communication protocol.
      * @returns {void}
      */
     start(): void;
-    /**
-     * Handles opt-in requests from participants to join a cohort.
-     * @param {OptInMessage} message The message containing the opt-in request.
-     * @returns {Promise<void>}
-     */
-    private _handleOptIn;
-    /**
-     * Handles request signature messages from participants.
-     * @private
-     * @param {CohortRequestSignatureMessage} message The message containing the request signature.
-     * @returns {Promise<void>}
-     */
-    private _handleRequestSignature;
-    /**
-     * Handles nonce contribution messages from participants.
-     * @param {CohortNonceContributionMessage} message The message containing the nonce contribution.
-     * @returns {Promise<void>}
-     */
-    private _handleNonceContribution;
-    /**
-     * Handles signature authorization messages from participants.
-     * @param {Maybe<CohortSignatureAuthorizationMessage>} message The message containing the signature authorization request.
-     * @returns {Promise<void>}
-     */
-    private _handleSignatureAuthorization;
     /**
      * Starts the key generation process for a cohort once it has enough participants.
      * @param {Musig2Cohort} cohort The cohort for which to start key generation.
@@ -100,7 +89,7 @@ export declare class BeaconCoordinator {
      * Announces a new cohort to all subscribers.
      * @param {number} minParticipants The minimum number of participants required for the cohort.
      * @param {string} [network='mutinynet'] The network on which the cohort operates (default is 'signet').
-     * @param {string} [beaconType='SMTAggregateBeacon'] The type of beacon to be used (default is 'SMTAggregateBeacon').
+     * @param {string} [beaconType='SMTBeacon'] The type of beacon to be used (default is 'SMTBeacon').
      * @returns {Promise<AggregateBeaconCohort>} The newly created cohort.
      */
     advertiseCohort(minParticipants: number, network?: string, beaconType?: string): Promise<AggregateBeaconCohort>;
@@ -124,4 +113,3 @@ export declare class BeaconCoordinator {
      */
     static initialize(service: Service): BeaconCoordinator;
 }
-export {};

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

@@ -1 +1 @@
-{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../../../src/core/beacon/aggregation/coordinator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAkB1D,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACnG,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGhE,KAAK,uBAAuB,GAAG;IAC7B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,sBAAsB,CAAC,iBAAiB,CAAC,CAAA;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAA;AACD;;;;GAIG;AAEH,qBAAa,iBAAiB;IAC5B;;;OAGG;IACI,IAAI,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACI,GAAG,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACI,QAAQ,EAAE,oBAAoB,CAAC;IAEtC;;;OAGG;IACI,OAAO,EAAE,KAAK,CAAC,qBAAqB,CAAC,CAAM;IAElD;;;OAGG;IACI,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAa;IAElF;;;;;;;OAOG;gBACS,MAAM,EAAE,uBAAuB;IAO3C;;;OAGG;IACI,KAAK,IAAI,IAAI;IASpB;;;;OAIG;YACW,YAAY;IAqB1B;;;;;OAKG;YACW,uBAAuB;IAgBrC;;;;OAIG;YACW,wBAAwB;IA2CtC;;;;OAIG;YACW,6BAA6B;IAkD3C;;;;OAIG;YACW,mBAAmB;IAWjC;;;;OAIG;IACU,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnE;;;;OAIG;IACU,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBpF;;;;;;OAMG;IACU,eAAe,CAC1B,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,MAAoB,EAC7B,UAAU,GAAE,MAA6B,GACxC,OAAO,CAAC,qBAAqB,CAAC;IAkBjC;;;;OAIG;IACU,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA0BlF;;;;;OAKG;IACU,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAsBvF;;;;OAIG;WACW,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB;CAU9D"}
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../../../src/core/beacon/aggregation/coordinator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAkB1D,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACnG,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGhE;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,sBAAsB,CAAC,iBAAiB,CAAC,CAAA;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAA;AACD;;;;GAIG;AACH,qBAAa,iBAAiB;;IAC5B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,QAAQ,EAAE,oBAAoB,CAAC;IAE/B;;;OAGG;IACH,OAAO,EAAE,KAAK,CAAC,qBAAqB,CAAC,CAAM;IAE3C;;;OAGG;IACH,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAa;IAE3E;;;;;;;OAOG;gBACS,MAAM,EAAE;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,sBAAsB,CAAC,iBAAiB,CAAC,CAAA;QAC/C,QAAQ,CAAC,EAAE,oBAAoB,CAAC;QAChC,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IAOD;;;OAGG;IACH,KAAK,IAAI,IAAI;IAgKb;;;;OAIG;YACW,mBAAmB;IAWjC;;;;OAIG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5D;;;;OAIG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB7E;;;;;;OAMG;IACG,eAAe,CACnB,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,MAAoB,EAC7B,UAAU,GAAE,MAAoB,GAC/B,OAAO,CAAC,qBAAqB,CAAC;IAkBjC;;;;OAIG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA0B3E;;;;;OAKG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAsBhF;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB;CAUvD"}

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

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

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

@@ -0,0 +1,44 @@
+import { KeyBytes } from '@did-btcr2/common';
+import { BitcoinNetworkConnection } from '../../../../bitcoin/dist/types/bitcoin.js';
+import { SignedBTCR2Update } from '../../../../cryptosuite/dist/types/data-integrity-proof/interface.js';
+import { SidecarData } from '../types.js';
+import { BeaconService, BeaconSignal, BlockMetadata } from './interfaces.js';
+/**
+ * Abstract base class for all BTCR2 Beacon types.
+ * A Beacon is a service listed in a BTCR2 DID document that informs resolvers
+ * how to find authentic updates to the DID.
+ *
+ * Beacons are lightweight typed wrappers around a {@link BeaconService} configuration.
+ * Dependencies (signals, sidecar data, bitcoin connection) are passed as method
+ * parameters rather than held as instance state.
+ *
+ * Use {@link BeaconFactory.establish} to create typed instances from service config.
+ *
+ * @abstract
+ * @class Beacon
+ * @type {Beacon}
+ */
+export declare abstract class Beacon {
+    /**
+     * The Beacon service configuration parsed from the DID Document.
+     */
+    readonly service: BeaconService;
+    constructor(service: BeaconService);
+    /**
+     * Processes an array of Beacon Signals to extract BTCR2 Signed Updates.
+     * Used during the resolve path.
+     * @param {Array<BeaconSignal>} signals The beacon signals discovered on-chain.
+     * @param {SidecarData} sidecar The processed sidecar data containing update/CAS/SMT maps.
+     * @returns {Promise<Array<[SignedBTCR2Update, BlockMetadata]>>} The updates announced by the signals.
+     */
+    abstract processSignals(signals: Array<BeaconSignal>, sidecar: SidecarData): Promise<Array<[SignedBTCR2Update, BlockMetadata]>>;
+    /**
+     * Broadcasts a signed update as a Beacon Signal to the Bitcoin network.
+     * Used during the update path.
+     * @param {SignedBTCR2Update} signedUpdate The signed BTCR2 update to broadcast.
+     * @param {KeyBytes} secretKey The secret key for signing the Bitcoin transaction.
+     * @param {BitcoinNetworkConnection} bitcoin The Bitcoin network connection.
+     * @returns {Promise<SignedBTCR2Update>} The signed update that was broadcast.
+     */
+    abstract broadcastSignal(signedUpdate: SignedBTCR2Update, secretKey: KeyBytes, bitcoin: BitcoinNetworkConnection): Promise<SignedBTCR2Update>;
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"beacon.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/beacon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sEAAsE,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7E;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,MAAM;IAC1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;gBAEpB,OAAO,EAAE,aAAa;IAIlC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CACrB,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,EAC5B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,CAAC,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC;IAGrD;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CACtB,YAAY,EAAE,iBAAiB,EAC/B,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC;CAC9B"}

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

@@ -0,0 +1,36 @@
+import { BitcoinNetworkConnection } from '@did-btcr2/bitcoin';
+import { KeyBytes } from '@did-btcr2/common';
+import { SignedBTCR2Update } from '@did-btcr2/cryptosuite';
+import { SidecarData } from '../types.js';
+import { Beacon } from './beacon.js';
+import { BeaconService, BeaconSignal, BlockMetadata } from './interfaces.js';
+/**
+ * Implements {@link https://dcdpr.github.io/did-btcr2/terminology.html#cas-beacon | CAS Beacon}.
+ * @class CASBeacon
+ * @type {CASBeacon}
+ * @extends {Beacon}
+ */
+export declare class CASBeacon extends Beacon {
+    /**
+     * Creates an instance of CASBeacon.
+     * @param {BeaconService} service The service of the Beacon.
+     */
+    constructor(service: BeaconService);
+    /**
+     * Implements {@link https://dcdpr.github.io/did-btcr2/operations/resolve.html#process-cas-beacon | 7.2.e.1 Process CAS Beacon}.
+     * @param {Array<BeaconSignal>} signals The array of Beacon Signals to process.
+     * @param {SidecarData} sidecar The sidecar data associated with the CAS Beacon.
+     * @returns {Promise<Array<[SignedBTCR2Update, BlockMetadata]>>} The processed signals.
+     * @throws {CASBeaconError} if processing fails.
+     */
+    processSignals(signals: Array<BeaconSignal>, sidecar: SidecarData): Promise<Array<[SignedBTCR2Update, BlockMetadata]>>;
+    /**
+     * Broadcast CAS Beacon signal to the Bitcoin network.
+     * @param {SignedBTCR2Update} signedUpdate The signed BTCR2 update to broadcast.
+     * @param {KeyBytes} secretKey The secret key for signing the Bitcoin transaction.
+     * @param {BitcoinNetworkConnection} bitcoin The Bitcoin network connection.
+     * @return {Promise<SignedBTCR2Update>} The signed update that was broadcasted.
+     * @throws {CASBeaconError} if broadcasting fails.
+     */
+    broadcastSignal(signedUpdate: SignedBTCR2Update, secretKey: KeyBytes, bitcoin: BitcoinNetworkConnection): Promise<SignedBTCR2Update>;
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"cas-beacon.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/cas-beacon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7E;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,MAAM;IACnC;;;OAGG;gBACS,OAAO,EAAE,aAAa;IAIlC;;;;;;OAMG;IACH,cAAc,CACZ,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,EAC5B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,CAAC,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC;IAIrD;;;;;;;OAOG;IACG,eAAe,CACnB,YAAY,EAAE,iBAAiB,EAC/B,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC;CAG9B"}

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

@@ -14,9 +14,9 @@ export declare class SingletonBeaconError extends MethodError {
 export declare class AggregateBeaconError extends MethodError {
     constructor(message: string, type?: string, data?: Record<string, any>);
 }
-export declare class CIDAggregateBeaconError extends MethodError {
+export declare class CASBeaconError extends MethodError {
     constructor(message: string, type?: string, data?: Record<string, any>);
 }
-export declare class SMTAggregateBeaconError extends MethodError {
+export declare class SMTBeaconError extends MethodError {
     constructor(message: string, type?: string, data?: Record<string, any>);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAsB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGtF;AAED,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAiC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGjG;AAED,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAiC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGjG;AAGD,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAA+B,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAG/F;AAED,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAA+B,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAG/F;AAED,qBAAa,uBAAwB,SAAQ,WAAW;gBAC1C,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGlG;AAED,qBAAa,uBAAwB,SAAQ,WAAW;gBAC1C,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGlG"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAsB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGtF;AAED,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAiC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGjG;AAED,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAiC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGjG;AAED,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAA+B,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAG/F;AAED,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAA+B,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAG/F;AAED,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,cAAe,SAAQ,WAAW;gBACjC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAyB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGzF"}

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

@@ -1,5 +1,5 @@
-import { Beacon, BeaconService } from '../../interfaces/beacon.js';
-import { SidecarData } from '../../utils/types.js';
+import { Beacon } from './beacon.js';
+import { BeaconService } from './interfaces.js';
 /**
  * Beacon Factory pattern to create Beacon instances.
  * @class BeaconFactory
@@ -8,9 +8,8 @@ import { SidecarData } from '../../utils/types.js';
 export declare class BeaconFactory {
     /**
      * Establish a Beacon instance based on the provided service and optional sidecar data.
-     * @param {BeaconService} service - The beacon service configuration.
-     * @param {SidecarData} [sidecar] - The optional sidecar data.
+     * @param {BeaconService} service The beacon service configuration.
      * @returns {Beacon} The established Beacon instance.
      */
-    static establish(service: BeaconService, sidecar?: SidecarData): Beacon;
+    static establish(service: BeaconService): Beacon;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAuB,WAAW,EAAuB,MAAM,sBAAsB,CAAC;AAK7F;;;;GAIG;AACH,qBAAa,aAAa;IACxB;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM;CAexE"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;GAIG;AACH,qBAAa,aAAa;IACxB;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;CAYjD"}

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

@@ -0,0 +1,59 @@
+import { RawTransactionRest, RawTransactionV2 } from '@did-btcr2/bitcoin';
+import { UnixTimestamp } from '@did-btcr2/common';
+import { DidServiceEndpoint, DidService } from '@web5/dids';
+/**
+ * Represents a Beacon Service, which extends a W3C DID Service by setting serviceEndpoint
+ * as a single DidServiceEndpoint.
+ * @interface BeaconService
+ * @extends DidService
+ */
+export interface BeaconService extends DidService {
+    serviceEndpoint: DidServiceEndpoint;
+}
+/**
+ * Represents a parsed Beacon Service, which extends the Beacon Service with a Bitcoin address.
+ * @interface ParsedBeaconService
+ * @extends BeaconService
+ */
+export interface ParsedBeaconService extends BeaconService {
+    /**
+     * The Bitcoin address associated with this Beacon Service.
+     */
+    address: string;
+}
+/**
+ * Metadata about a Bitcoin block containing a Beacon Signal.
+ * @interface BlockMetadata
+ */
+export interface BlockMetadata {
+    /**
+    * The block height at which the Beacon Signal was included.
+    */
+    height: number;
+    /**
+     * The timestamp of the block containing the Beacon Signal.
+     */
+    time: UnixTimestamp;
+    /**
+     * The number of confirmations for the block containing the Beacon Signal.
+     */
+    confirmations: number;
+}
+/**
+ * Represents a Beacon Signal, which is a transaction broadcasted by a Beacon to announce a DID update.
+ * @interface BeaconSignal
+ */
+export interface BeaconSignal {
+    /**
+     * The raw Bitcoin transaction representing the Beacon Signal.
+     */
+    tx: RawTransactionRest | RawTransactionV2;
+    /**
+     * The beacon signal bytes hash (i.e. the hash of the BTCR2 update included in the Beacon Signal tx).
+     */
+    signalBytes: string;
+    /**
+     * Metadata about the block containing the Beacon Signal.
+     */
+    blockMetadata: BlockMetadata;
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC7C,eAAe,EAAE,kBAAkB,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACtD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC3B;;MAEE;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,EAAE,kBAAkB,GAAG,gBAAgB,CAAC;IAE1C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,EAAE,aAAa,CAAC;CAC9B"}

package/dist/types/core/beacon/signal-discovery.d.ts

@@ -0,0 +1,25 @@
+import { BitcoinNetworkConnection } from '@did-btcr2/bitcoin';
+import { BeaconService, BeaconSignal } from './interfaces.js';
+/**
+ * Static utility class for discovering Beacon Signals on the Bitcoin blockchain.
+ * Extracted from {@link Resolve} for single-responsibility and independent testability.
+ *
+ * @class BeaconSignalDiscovery
+ */
+export declare class BeaconSignalDiscovery {
+    /**
+     * Retrieves the beacon signals for the given array of BeaconService objects
+     * using an esplora/electrs REST API connection via a bitcoin I/O driver.
+     * @param {Array<BeaconService>} beaconServices Array of BeaconService objects to retrieve signals for
+     * @param {BitcoinNetworkConnection} bitcoin Bitcoin network connection to use for REST calls
+     * @returns {Promise<Map<BeaconService, Array<BeaconSignal>>>} Map of beacon service to its discovered signals
+     */
+    static indexer(beaconServices: Array<BeaconService>, bitcoin: BitcoinNetworkConnection): Promise<Map<BeaconService, Array<BeaconSignal>>>;
+    /**
+     * Traverse the full blockchain from genesis to chain top looking for beacon signals.
+     * @param {Array<BeaconService>} beaconServices Array of BeaconService objects to search for signals.
+     * @param {BitcoinNetworkConnection} bitcoin Bitcoin network connection to use for RPC calls.
+     * @returns {Promise<Map<BeaconService, Array<BeaconSignal>>>} Map of beacon service to its discovered signals.
+     */
+    static fullnode(beaconServices: Array<BeaconService>, bitcoin: BitcoinNetworkConnection): Promise<Map<BeaconService, Array<BeaconSignal>>>;
+}

package/dist/types/core/beacon/signal-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-discovery.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/signal-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EAKzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG9D;;;;;GAKG;AACH,qBAAa,qBAAqB;IAEhC;;;;;;OAMG;WACU,OAAO,CAClB,cAAc,EAAE,KAAK,CAAC,aAAa,CAAC,EACpC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IA0EnD;;;;;OAKG;WACU,QAAQ,CACnB,cAAc,EAAE,KAAK,CAAC,aAAa,CAAC,EACpC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;CA4HpD"}

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

@@ -1,91 +1,35 @@
-import { RawTransactionRest, RawTransactionV2 } from '@did-btcr2/bitcoin';
-import { DidUpdatePayload } from '@did-btcr2/common';
-import { Beacon, BeaconService, BeaconSignal } from '../../interfaces/beacon.js';
-import { BeaconSidecarData, SignalsMetadata, SingletonSidecar } from '../../utils/types.js';
+import { BitcoinNetworkConnection } from '@did-btcr2/bitcoin';
+import { KeyBytes } from '@did-btcr2/common';
+import { SignedBTCR2Update } from '@did-btcr2/cryptosuite';
+import { SidecarData } from '../types.js';
+import { Beacon } from './beacon.js';
+import { BeaconService, BeaconSignal, BlockMetadata } from './interfaces.js';
 /**
- * Implements {@link https://dcdpr.github.io/did-btcr2/#singleton-beacon | 5.1 Singleton Beacon}.
- *
- * A Singleton Beacon enables a single entity to independently post a DID Update Payload in a Beacon Signal. Its is a
- * Beacon that can be used to publish a single DID Update Payload targeting a single DID document. The serviceEndpoint
- * for this Beacon Type is a Bitcoin address represented as a URI following the BIP21 scheme. It is recommended that
- * this Bitcoin address be under the sole control of the DID controller. How the Bitcoin address and the cryptographic
- * material that controls it are generated is left to the implementation.
- *
+ * Implements {@link https://dcdpr.github.io/did-btcr2/terminology.html#singleton-beacon | Singleton Beacon}.
  * @class SingletonBeacon
  * @type {SingletonBeacon}
- * @extends {Beacon}
+ * @extends {AggregateBeacon}
  */
 export declare class SingletonBeacon extends Beacon {
     /**
      * Creates an instance of SingletonBeacon.
-     * @param {BeaconService} service The Beacon service.
-     * @param {?BeaconSidecarData} [sidecar] Optional sidecar data.
-     */
-    constructor(service: BeaconService, sidecar?: BeaconSidecarData<SingletonSidecar>);
-    /**
-     * Get the Beacon service.
-     * @readonly
-     * @type {BeaconService} The Beacon service.
-     */
-    get service(): BeaconService;
-    /**
-     * Implements {@link https://dcdpr.github.io/did-btcr2/#establish-singleton-beacon | 5.1.1 Establish Singleton Beacon}.
+     * @param {BeaconService} service The BeaconService object representing the funded beacon to announce the update to.
      *
-     * Static, convenience method for establishing a Beacon object.
-     *
-     * A Singleton Beacon is a Beacon that can be used to publish a single DID Update Payload targeting a single DID
-     * document. The serviceEndpoint for this Beacon Type is a Bitcoin address represented as a URI following the BIP21
-     * scheme. It is RECOMMENDED that this Bitcoin address be under the sole control of the DID controller. How the
-     * Bitcoin address and the cryptographic material that controls it are generated is left to the implementation.
-     * The Establish Singleton Beacon algorithm takes in a Bitcoin address and a serviceId and returns a Singleton Beacon service.
-     * It returns a SignletonBeacon object with the given id, type, and serviceEndpoint.
-     *
-     * @param {string} service The Beacon service.
-     * @param {BeaconSidecarData<SingletonSidecar>} sidecar The sidecar data.
-     * @returns {SingletonBeacon} The Singleton Beacon.
-     */
-    static establish(service: BeaconService, sidecar: BeaconSidecarData<SingletonSidecar>): SingletonBeacon;
-    /**
-     * TODO: Figure out if this is necessary or not.
-     * @param {string} didUpdatePayload The DID Update Payload to generate the signal for.
-     * @returns {BeaconSignal} The generated signal.
-     * @throws {MethodError} if the signal is invalid.
      */
-    generateSignal(didUpdatePayload: string): BeaconSignal;
+    constructor(service: BeaconService);
     /**
-     * TODO: Finish implementation per spec
-     *
-     * Implements {@link https://dcdpr.github.io/did-btcr2/#process-singleton-beacon-signal | 5.1.3 Process Singleton Beacon Signal}.
-     * See {@link Beacon.processSignal | Abstract Beacon Interface Method processSignal} for more details.
-     *
-     * The Process Singleton Beacon Signal algorithm is called by the Process Beacon Signals algorithm as part of the Read
-     * operation. It takes a Bitcoin transaction representing a Beacon Signal and optional signalSidecarData containing
-     * any sidecar data provided to the resolver for the Beacon Signal identified by the Bitcoin transaction identifier.
-     * It returns the DID Update payload announced by the Beacon Signal or throws an error.
-     *
-     * @param {RawTransactionV2} signal Bitcoin transaction representing a Beacon Signal.
-     * @param {SignalsMetadata} signalsMetadata: SignalsMetadata Optional sidecar data for the Beacon Signal.
-     * @returns {Promise<DidUpdatePayload | undefined>} The DID Update payload announced by the Beacon Signal.
-     * @throws {DidError} if the signalTx is invalid or the signalSidecarData is invalid.
+     * Processes an array of Beacon Signals associated with a Singleton Beacon Service.
+     * @returns {Promise<SignedBTCR2Update | undefined>} The DID Update payload announced by the Beacon Signal.
+     * @throws {SingletonBeaconError} if the signalTx is invalid or the signalSidecarData is invalid.
      */
-    processSignal(signal: RawTransactionV2 | RawTransactionRest, signalsMetadata: SignalsMetadata): Promise<DidUpdatePayload | undefined>;
+    processSignals(signals: Array<BeaconSignal>, sidecar: SidecarData): Promise<Array<[SignedBTCR2Update, BlockMetadata]>>;
     /**
-     * Implements {@link https://dcdpr.github.io/did-btcr2/#broadcast-singleton-beacon-signal | 5.1.2 Broadcast Singleton Beacon Signal}.
-     *
-     * The Broadcast Singleton Beacon Signal algorithm is called by the Announce DID Update algorithm as part of the
-     * Update operation, if the Beacon being used is of the type SingletonBeacon. It takes as input a Beacon service and a
-     * secured didUpdatePayload. The algorithm constructs a Bitcoin transaction that spends from the Beacon address
-     * identified in the service and contains a transaction output of the format [OP_RETURN, OP_PUSH32, <hashBytes>],
-     * where hashBytes is the SHA256 hash of the canonical didUpdatePayload. The Bitcoin transaction is then signed and
-     * broadcast to the Bitcoin network, thereby publicly announcing a DID update in a Beacon Signal. It returns a
-     * signalMetadata object mapping the Bitcoin transaction identifier of the Beacon Signal to the necessary data needed
-     * to verify the signal announces a specific DID Update Payload.
-     *
-     * TODO: Design and implement a way to construct, sign and send via RPC
-     *
-     * @param {DidUpdatePayload} didUpdatePayload The verificationMethod object to be used for signing.
-     * @returns {SignedRawTx} Successful output of a bitcoin transaction.
+     * Broadcasts a SingletonBeacon signal to the Bitcoin network.
+     * @param {SignedBTCR2Update} signedUpdate The signed BTCR2 update to broadcast.
+     * @param {KeyBytes} secretKey The secret key for signing the Bitcoin transaction.
+     * @param {BitcoinNetworkConnection} bitcoin The Bitcoin network connection.
+     * @returns {Promise<SignedBTCR2Update>} The signed update that was broadcast.
      * @throws {SingletonBeaconError} if the bitcoin address is invalid or unfunded.
      */
-    broadcastSignal(didUpdatePayload: DidUpdatePayload): Promise<SignalsMetadata>;
+    broadcastSignal(signedUpdate: SignedBTCR2Update, secretKey: KeyBytes, bitcoin: BitcoinNetworkConnection): Promise<SignedBTCR2Update>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/singleton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,kBAAkB,EAAE,gBAAgB,EAAe,MAAM,oBAAoB,CAAC;AAC9H,OAAO,EAAE,gBAAgB,EAAqE,MAAM,mBAAmB,CAAC;AAKxH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAY,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAMtG;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,MAAM;IAEzC;;;;OAIG;gBACS,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC,gBAAgB,CAAC;IAIjF;;;;OAIG;IACH,IAAI,OAAO,IAAI,aAAa,CAM3B;IAED;;;;;;;;;;;;;;;OAeG;WACW,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,eAAe;IAI9G;;;;;OAKG;IACI,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,YAAY;IAI7D;;;;;;;;;;;;;;;OAeG;IACU,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,EAAE,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAiElJ;;;;;;;;;;;;;;;;;OAiBG;IACU,eAAe,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CAyE3F"}
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/singleton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAwB,QAAQ,EAAuB,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7E;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,MAAM;IAEzC;;;;OAIG;gBACS,OAAO,EAAE,aAAa;IAIlC;;;;OAIG;IACG,cAAc,CAClB,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,EAC5B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,CAAC,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC;IA0CrD;;;;;;;OAOG;IACG,eAAe,CACnB,YAAY,EAAE,iBAAiB,EAC/B,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC;CAsE9B"}

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

@@ -0,0 +1,36 @@
+import { BitcoinNetworkConnection } from '@did-btcr2/bitcoin';
+import { KeyBytes } from '@did-btcr2/common';
+import { SignedBTCR2Update } from '@did-btcr2/cryptosuite';
+import { SidecarData } from '../types.js';
+import { Beacon } from './beacon.js';
+import { BeaconService, BeaconSignal, BlockMetadata } from './interfaces.js';
+/**
+ * Implements {@link https://dcdpr.github.io/did-btcr2/terminology.html#smt-beacon | SMTBeacon}.
+ * @class SMTBeacon
+ * @type {SMTBeacon}
+ * @extends {Beacon}
+ */
+export declare class SMTBeacon extends Beacon {
+    /**
+     * Creates an instance of SMTBeacon.
+     * @param {BeaconService} service The Beacon service.
+     */
+    constructor(service: BeaconService);
+    /**
+     * Implements {@link https://dcdpr.github.io/did-btcr2/operations/resolve.html#process-smt-beacon | 7.2.e.1 Process SMT Beacon}.
+     * @param {Array<BeaconSignal>} signals The array of Beacon Signals to process.
+     * @param {SidecarData} sidecar The sidecar data associated with the SMT Beacon.
+     * @returns {Promise<Array<[SignedBTCR2Update, BlockMetadata]>>} The processed signals.
+     * @throws {SMTBeaconError} if processing fails.
+     */
+    processSignals(signals: Array<BeaconSignal>, sidecar: SidecarData): Promise<Array<[SignedBTCR2Update, BlockMetadata]>>;
+    /**
+     * Broadcast CAS Beacon signal to the Bitcoin network.
+     * @param {SignedBTCR2Update} signedUpdate The signed BTCR2 update to broadcast.
+     * @param {KeyBytes} secretKey The secret key for signing the Bitcoin transaction.
+     * @param {BitcoinNetworkConnection} bitcoin The Bitcoin network connection.
+     * @return {Promise<SignedBTCR2Update>} The signed update that was broadcasted.
+     * @throws {SMTBeaconError} if broadcasting fails.
+     */
+    broadcastSignal(signedUpdate: SignedBTCR2Update, secretKey: KeyBytes, bitcoin: BitcoinNetworkConnection): Promise<SignedBTCR2Update>;
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"smt-beacon.d.ts","sourceRoot":"","sources":["../../../../src/core/beacon/smt-beacon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7E;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,MAAM;IACnC;;;OAGG;gBACS,OAAO,EAAE,aAAa;IAIlC;;;;;;OAMG;IACH,cAAc,CACZ,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,EAC5B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,CAAC,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC;IAIrD;;;;;;;OAOG;IACG,eAAe,CACnB,YAAY,EAAE,iBAAiB,EAC/B,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC;CAG9B"}