@did-btcr2/method 0.19.0 → 0.20.0

package/dist/cjs/core/beacon/beacon.js

@@ -0,0 +1,25 @@
+/**
+ * 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 class Beacon {
+    /**
+     * The Beacon service configuration parsed from the DID Document.
+     */
+    service;
+    constructor(service) {
+        this.service = service;
+    }
+}
+//# sourceMappingURL=beacon.js.map

package/dist/cjs/core/beacon/beacon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon.js","sourceRoot":"","sources":["../../../../src/core/beacon/beacon.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAgB,MAAM;IAC1B;;OAEG;IACM,OAAO,CAAgB;IAEhC,YAAY,OAAsB;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CA4BF"}

package/dist/cjs/core/beacon/cas-beacon.js

@@ -1,55 +1,39 @@
-import { MethodError } from '@did-btcr2/common';
-import { AggregateBeacon } from './interfaces.js';
+import { Beacon } from './beacon.js';
+import { CASBeaconError } from './error.js';
 /**
  * Implements {@link https://dcdpr.github.io/did-btcr2/terminology.html#cas-beacon | CAS Beacon}.
- *
  * @class CASBeacon
  * @type {CASBeacon}
- * @extends {AggregateBeacon}
+ * @extends {Beacon}
  */
-export class CASBeacon extends AggregateBeacon {
+export class CASBeacon extends Beacon {
     /**
      * Creates an instance of CASBeacon.
      * @param {BeaconService} service The service of the Beacon.
-     * @param {?BeaconSidecarData} [sidecar] The sidecar data of the Beacon.
      */
-    constructor(service, signals, sidecar, bitcoin) {
-        super({ ...service, type: 'CASBeacon' }, signals, sidecar, bitcoin);
-    }
-    /**
-     * Establish a CASBeacon instance based on the provided service and sidecar data.
-     * @param {BeaconService} service - The beacon service configuration.
-     * @param {SidecarData} sidecar - The sidecar data.
-     * @returns {CASBeacon} The established CASBeacon instance.
-     */
-    static establish(service, signals, sidecar) {
-        return new CASBeacon(service, signals, sidecar);
-    }
-    /**
-     * TODO: Figure out if this is necessary or not.
-     * @param {HexString} updateHash The hash of the update to generate the signal for.
-     * @returns {BeaconSignal} The generated signal.
-     * @throws {MethodError} if the signal is invalid.
-     */
-    generateSignal(updateHash) {
-        throw new Error('Method not implemented.' + updateHash);
+    constructor(service) {
+        super({ ...service, type: 'CASBeacon' });
     }
     /**
      * Implements {@link https://dcdpr.github.io/did-btcr2/operations/resolve.html#process-cas-beacon | 7.2.e.1 Process CAS Beacon}.
-     * @returns {Promise<BTCR2SignedUpdate | undefined>} The processed signed update or undefined.
-     * @throws {MethodError} if the signal processing fails.
+     * @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() {
-        throw new MethodError('Method not implemented.', `METHOD_NOT_IMPLEMENTED`);
+    processSignals(signals, sidecar) {
+        throw new CASBeaconError('Method not implemented.', `METHOD_NOT_IMPLEMENTED`, { signals, sidecar });
     }
     /**
-     * TODO: Finish implementation
-     * @param {HexString} updateHash The hash of the update to broadcast.
-     * @returns {Promise<{ spentTx: string; signedUpdate: BTCR2SignedUpdate }>} The result of the broadcast.
-     * @throws {MethodError} if the broadcast fails.
+     * 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.
      */
-    async broadcastSignal(updateHash) {
-        throw new MethodError('Method not implemented.', `METHOD_NOT_IMPLEMENTED`, { updateHash });
+    async broadcastSignal(signedUpdate, secretKey, bitcoin) {
+        throw new CASBeaconError('Method not implemented.', `METHOD_NOT_IMPLEMENTED`, { signedUpdate, secretKey, bitcoin });
     }
 }
 //# sourceMappingURL=cas-beacon.js.map

package/dist/cjs/core/beacon/cas-beacon.js.map

@@ -1 +1 @@
-{"version":3,"file":"cas-beacon.js","sourceRoot":"","sources":["../../../../src/core/beacon/cas-beacon.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,eAAe,EAA8C,MAAM,iBAAiB,CAAC;AAG9F;;;;;;GAMG;AACH,MAAM,OAAO,SAAU,SAAQ,eAAe;IAC5C;;;;OAIG;IACH,YACE,OAAsB,EACtB,OAA4B,EAC5B,OAAoB,EACpB,OAAkC;QAElC,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,OAAsB,EAAE,OAA4B,EAAE,OAAoB;QACzF,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,UAAqB;QAClC,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,MAAM,IAAI,WAAW,CAAC,yBAAyB,EAAE,wBAAwB,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,UAAqB;QACzC,MAAM,IAAI,WAAW,CAAC,yBAAyB,EAAE,wBAAwB,EAAE,EAAC,UAAU,EAAC,CAAC,CAAC;IAC3F,CAAC;CACF"}
+{"version":3,"file":"cas-beacon.js","sourceRoot":"","sources":["../../../../src/core/beacon/cas-beacon.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C;;;;;GAKG;AACH,MAAM,OAAO,SAAU,SAAQ,MAAM;IACnC;;;OAGG;IACH,YAAY,OAAsB;QAChC,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CACZ,OAA4B,EAC5B,OAAoB;QAEpB,MAAM,IAAI,cAAc,CAAC,yBAAyB,EAAE,wBAAwB,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACtG,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,CACnB,YAA+B,EAC/B,SAAmB,EACnB,OAAiC;QAEjC,MAAM,IAAI,cAAc,CAAC,yBAAyB,EAAE,wBAAwB,EAAE,EAAC,YAAY,EAAE,SAAS,EAAE,OAAO,EAAC,CAAC,CAAC;IACpH,CAAC;CACF"}

package/dist/cjs/core/beacon/error.js

@@ -24,13 +24,13 @@ export class AggregateBeaconError extends MethodError {
         super(message, type, data);
     }
 }
-export class CIDAggregateBeaconError extends MethodError {
-    constructor(message, type = 'CIDAggregateBeaconError', data) {
+export class CASBeaconError extends MethodError {
+    constructor(message, type = 'CASBeaconError', data) {
         super(message, type, data);
     }
 }
-export class SMTAggregateBeaconError extends MethodError {
-    constructor(message, type = 'SMTAggregateBeaconError', data) {
+export class SMTBeaconError extends MethodError {
+    constructor(message, type = 'SMTBeaconError', data) {
         super(message, type, data);
     }
 }

package/dist/cjs/core/beacon/error.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../../src/core/beacon/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C,YAAY,OAAe,EAAE,OAAe,aAAa,EAAE,IAA0B;QACnF,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IACrD,YAAY,OAAe,EAAE,OAAe,wBAAwB,EAAE,IAA0B;QAC9F,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IACrD,YAAY,OAAe,EAAE,OAAe,wBAAwB,EAAE,IAA0B;QAC9F,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAGD,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,OAAe,EAAE,OAAe,sBAAsB,EAAE,IAA0B;QAC5F,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,OAAe,EAAE,OAAe,sBAAsB,EAAE,IAA0B;QAC5F,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IACtD,YAAY,OAAe,EAAE,OAAe,yBAAyB,EAAE,IAA0B;QAC/F,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IACtD,YAAY,OAAe,EAAE,OAAe,yBAAyB,EAAE,IAA0B;QAC/F,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF"}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../../src/core/beacon/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C,YAAY,OAAe,EAAE,OAAe,aAAa,EAAE,IAA0B;QACnF,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IACrD,YAAY,OAAe,EAAE,OAAe,wBAAwB,EAAE,IAA0B;QAC9F,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IACrD,YAAY,OAAe,EAAE,OAAe,wBAAwB,EAAE,IAA0B;QAC9F,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,OAAe,EAAE,OAAe,sBAAsB,EAAE,IAA0B;QAC5F,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,OAAe,EAAE,OAAe,sBAAsB,EAAE,IAA0B;QAC5F,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC7C,YAAY,OAAe,EAAE,OAAe,gBAAgB,EAAE,IAA0B;QACtF,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC7C,YAAY,OAAe,EAAE,OAAe,gBAAgB,EAAE,IAA0B;QACtF,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/dist/cjs/core/beacon/factory.js

@@ -10,19 +10,17 @@ import { SMTBeacon } from './smt-beacon.js';
 export class BeaconFactory {
     /**
      * Establish a Beacon instance based on the provided service and optional sidecar data.
-     * @param {BeaconService} service - The beacon service configuration.
-     * @param {Array<BeaconSignal>} signals - The array of beacon signals.
-     * @param {SidecarData} sidecar - The sidecar data associated with the beacon.
+     * @param {BeaconService} service The beacon service configuration.
      * @returns {Beacon} The established Beacon instance.
      */
-    static establish(service, signals, sidecar) {
+    static establish(service) {
         switch (service.type) {
             case 'SingletonBeacon':
-                return new SingletonBeacon(service, signals, sidecar);
+                return new SingletonBeacon(service);
             case 'CASBeacon':
-                return new CASBeacon(service, signals, sidecar);
+                return new CASBeacon(service);
             case 'SMTBeacon':
-                return new SMTBeacon(service, signals, sidecar);
+                return new SMTBeacon(service);
             default:
                 throw new MethodError('Invalid Beacon Type', 'INVALID_BEACON_ERROR', service);
         }

package/dist/cjs/core/beacon/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/core/beacon/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,OAAO,aAAa;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,OAAsB,EAAE,OAA4B,EAAE,OAAoB;QACzF,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,iBAAiB;gBACpB,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACxD,KAAK,WAAW;gBACd,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAClD,KAAK,WAAW;gBACd,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAClD;gBACE,MAAM,IAAI,WAAW,CAAC,qBAAqB,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/core/beacon/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,OAAO,aAAa;IACxB;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,OAAsB;QACrC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,iBAAiB;gBACpB,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;YACtC,KAAK,WAAW;gBACd,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;YAChC,KAAK,WAAW;gBACd,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;YAChC;gBACE,MAAM,IAAI,WAAW,CAAC,qBAAqB,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;CACF"}

package/dist/cjs/core/beacon/interfaces.js

@@ -1,32 +1,2 @@
-/**
- * Abstract class representing an AggregateBeacon.
- * @abstract
- * @class AggregateBeacon
- * @type {AggregateBeacon}
- */
-export class AggregateBeacon {
-    /**
-     * The Beacon service object parsed from the DID Document.
-     */
-    service;
-    /**
-     * The array of Beacon Signals associated with this Beacon service.
-     */
-    signals;
-    /**
-     * The sidecar data associated with this Beacon service.
-     * TODO: Make this more specific to Beacon type.
-     */
-    sidecar;
-    /**
-     * The Bitcoin network connection associated with this Beacon service.
-     */
-    bitcoin;
-    constructor(service, signals, sidecar, bitcoin) {
-        this.service = service;
-        this.signals = signals;
-        this.sidecar = sidecar;
-        this.bitcoin = bitcoin;
-    }
-}
+export {};
 //# sourceMappingURL=interfaces.js.map

package/dist/cjs/core/beacon/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/core/beacon/interfaces.ts"],"names":[],"mappings":"AAqEA;;;;;GAKG;AACH,MAAM,OAAgB,eAAe;IACnC;;OAEG;IACH,OAAO,CAAgB;IAEvB;;OAEG;IACH,OAAO,CAAsB;IAE7B;;;OAGG;IACH,OAAO,CAAc;IAErB;;OAEG;IACH,OAAO,CAA2B;IAElC,YACE,OAAsB,EACtB,OAA4B,EAC5B,OAAoB,EACpB,OAAkC;QAElC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAQ,CAAC;IAC1B,CAAC;CAgBF"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/core/beacon/interfaces.ts"],"names":[],"mappings":""}

package/dist/cjs/core/beacon/signal-discovery.js

@@ -0,0 +1,183 @@
+import { GENESIS_TX_ID, TXIN_WITNESS_COINBASE } from '@did-btcr2/bitcoin';
+import { ResolveError } from '@did-btcr2/common';
+import { BeaconUtils } from './utils.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 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 async indexer(beaconServices, bitcoin) {
+        const beaconServiceSignals = new Map();
+        // Fetch the current block count once before the loop
+        const currentBlockCount = await bitcoin.network.rest.block.count();
+        // Iterate over each beacon
+        for (const beaconService of beaconServices) {
+            beaconServiceSignals.set(beaconService, []);
+            // Get the transactions for the beacon address via REST
+            const beaconSignals = await bitcoin.network.rest.address.getTxs(beaconService.serviceEndpoint);
+            // If no signals are found, continue
+            if (!beaconSignals || !beaconSignals.length) {
+                continue;
+            }
+            // Iterate over each signal
+            for (const beaconSignal of beaconSignals) {
+                // Get the last vout in the transaction
+                const signalVout = beaconSignal.vout.slice(-1)[0];
+                /**
+                 * Look for OP_RETURN in last vout scriptpubkey_asm
+                 * Vout (rest) format:
+                 * {
+                 *  scriptpubkey: '6a20570f177c65e64fb5cf61180b664cdddf09ab76153c2b192e22006e5b22a3917a',
+                 *  scriptpubkey_asm: 'OP_RETURN OP_PUSHBYTES_32 570f177c65e64fb5cf61180b664cdddf09ab76153c2b192e22006e5b22a3917a',
+                 *  scriptpubkey_type: 'op_return',
+                 *  value: 0
+                 * }
+                 */
+                if (!signalVout || !signalVout.scriptpubkey_asm.includes('OP_RETURN')) {
+                    continue;
+                }
+                // Construct output map for easier access
+                const outputMap = new Map(Object.entries(signalVout));
+                // Grab the signal vout scriptpubkey
+                const signalVoutScriptPubkey = outputMap.get('scriptpubkey_asm');
+                // If the signal vout scriptpubkey does not exist, continue to next signal
+                if (!signalVoutScriptPubkey) {
+                    continue;
+                }
+                // Extract hex string hash of the signal bytes from the scriptpubkey
+                const updateHash = signalVoutScriptPubkey.split(' ').slice(-1)[0];
+                if (!updateHash) {
+                    continue;
+                }
+                // Use the pre-fetched block count instead of calling per-signal
+                const confirmations = currentBlockCount - beaconSignal.status.block_height + 1;
+                // Push the beacon signal object to the signals array for the beacon service
+                beaconServiceSignals.get(beaconService)?.push({
+                    tx: beaconSignal,
+                    signalBytes: updateHash,
+                    blockMetadata: {
+                        confirmations,
+                        height: beaconSignal.status.block_height,
+                        time: beaconSignal.status.block_time,
+                    }
+                });
+            }
+        }
+        return beaconServiceSignals;
+    }
+    /**
+     * 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 async fullnode(beaconServices, bitcoin) {
+        const beaconServiceSignals = new Map();
+        for (const beaconService of beaconServices) {
+            beaconServiceSignals.set(beaconService, []);
+        }
+        // Get the RPC connection from the bitcoin network
+        const rpc = bitcoin.network.rpc;
+        // Ensure that the RPC connection is available
+        if (!rpc) {
+            throw new ResolveError('RPC connection is not available', 'RPC_CONNECTION_ERROR', bitcoin);
+        }
+        // Get the current block height once before the loop
+        const targetHeight = await rpc.getBlockCount();
+        // Hoist the beacon services map before the loop
+        const beaconServicesMap = BeaconUtils.getBeaconServicesMap(beaconServices);
+        // Set genesis height
+        let height = 0;
+        // Opt into rpc connection to get the block data at the blockhash
+        let block = await bitcoin.network.rpc.getBlock({ height });
+        console.info(`Searching for beacon signals, please wait ...`);
+        while (block.height <= targetHeight) {
+            // Iterate over each transaction in the block
+            for (const tx of block.tx) {
+                // If the txid is a coinbase, continue ...
+                if (tx.txid === GENESIS_TX_ID) {
+                    continue;
+                }
+                // Iterate over each input in the transaction
+                for (const vin of tx.vin) {
+                    // If the vin is a coinbase transaction, continue ...
+                    if (vin.coinbase) {
+                        continue;
+                    }
+                    // If the vin txinwitness contains a coinbase did, continue ...
+                    if (vin.txinwitness && vin.txinwitness.length === 1 && vin.txinwitness[0] === TXIN_WITNESS_COINBASE) {
+                        continue;
+                    }
+                    // If the txid from the vin is undefined, continue ...
+                    if (!vin.txid) {
+                        continue;
+                    }
+                    // If the vout from the vin is undefined, continue ...
+                    if (vin.vout === undefined) {
+                        continue;
+                    }
+                    // Get the previous output transaction data
+                    const prevout = await rpc.getRawTransaction(vin.txid, 2);
+                    // If the previous output vout at the vin.vout index is undefined, continue ...
+                    if (!prevout.vout[vin.vout]) {
+                        continue;
+                    }
+                    // Get the address from the scriptPubKey from the prevvout
+                    const scriptPubKey = prevout.vout[vin.vout].scriptPubKey;
+                    // If the scriptPubKey.address is undefined, continue ...
+                    if (!scriptPubKey.address) {
+                        continue;
+                    }
+                    // Use the hoisted beaconServicesMap instead of rebuilding per-vin
+                    const beaconService = beaconServicesMap.get(scriptPubKey.address);
+                    if (!beaconService) {
+                        continue;
+                    }
+                    // Look for 'OP_RETURN' in the scriptPubKey asm
+                    const txVoutScriptPubkeyAsm = prevout.vout[vin.vout].scriptPubKey.asm;
+                    if (!txVoutScriptPubkeyAsm.includes('OP_RETURN')) {
+                        continue;
+                    }
+                    // Log the found txid and beacon
+                    console.info(`Tx ${tx.txid} contains beacon service address ${scriptPubKey.address} and OP_RETURN!`, tx);
+                    // Extract hex string hash of the signal bytes from the scriptpubkey
+                    const updateHash = txVoutScriptPubkeyAsm.split(' ').slice(-1)[0];
+                    if (!updateHash) {
+                        continue;
+                    }
+                    // Push the beacon signal object to the beacon signals array for that beacon service
+                    beaconServiceSignals.get(beaconService)?.push({
+                        tx,
+                        signalBytes: updateHash,
+                        blockMetadata: {
+                            height: block.height,
+                            time: block.time,
+                            confirmations: block.confirmations
+                        }
+                    });
+                }
+                ;
+            }
+            // Increment the height
+            height += 1;
+            // Use pre-fetched targetHeight instead of calling rpc.getBlockCount() every iteration
+            if (height > targetHeight) {
+                console.info(`Chain tip reached ${height}, breaking ...`);
+                break;
+            }
+            // Reset the block var to the next block data
+            block = await rpc.getBlock({ height });
+        }
+        return beaconServiceSignals;
+    }
+}
+//# sourceMappingURL=signal-discovery.js.map

package/dist/cjs/core/beacon/signal-discovery.js.map

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

package/dist/cjs/core/beacon/singleton.js

@@ -1,59 +1,40 @@
-import { INVALID_SIDECAR_DATA, MethodError, MISSING_UPDATE_DATA, SingletonBeaconError } from '@did-btcr2/common';
-import { CompressedSecp256k1PublicKey } from '@did-btcr2/keypair';
-import { Kms, Signer } from '@did-btcr2/kms';
+import { INVALID_SIDECAR_DATA, MISSING_UPDATE_DATA } from '@did-btcr2/common';
+import { SchnorrKeyPair } from '@did-btcr2/keypair';
+import { Signer } from '@did-btcr2/kms';
 import { opcodes, Psbt, script } from 'bitcoinjs-lib';
 import { base58btc } from 'multiformats/bases/base58';
 import { canonicalization } from '../../did-btcr2.js';
-import { Identifier } from '../identifier.js';
-import { AggregateBeacon } from './interfaces.js';
+import { Beacon } from './beacon.js';
+import { SingletonBeaconError } from './error.js';
 /**
  * Implements {@link https://dcdpr.github.io/did-btcr2/terminology.html#singleton-beacon | Singleton Beacon}.
- *
  * @class SingletonBeacon
  * @type {SingletonBeacon}
  * @extends {AggregateBeacon}
  */
-export class SingletonBeacon extends AggregateBeacon {
+export class SingletonBeacon extends Beacon {
     /**
      * Creates an instance of SingletonBeacon.
-     * @param {BeaconService} service The Beacon service.
-     * @param {?BeaconSidecarData} sidecar The SingletonBeacon sidecar data.
-     */
-    constructor(service, signals, sidecar, bitcoin) {
-        super({ ...service, type: 'SingletonBeacon' }, signals, sidecar, bitcoin);
-    }
-    /**
-     * Static, convenience method for establishing a CASBeacon object.
-     * @param {string} service The Beacon service.
-     * @param {SidecarData} sidecar The sidecar data.
-     * @returns {SingletonBeacon} The Singleton Beacon.
-     */
-    static establish(service, signals, sidecar) {
-        return new SingletonBeacon(service, signals, sidecar);
-    }
-    /**
-     * Generates a Beacon Signal for a Singleton Beacon Service.
-     * @param {HexString} updateHash The update hash to be included in the Beacon Signal.
-     * @returns {BeaconSignal} The generated signal.
-     * @throws {MethodError} if the signal is invalid.
+     * @param {BeaconService} service The BeaconService object representing the funded beacon to announce the update to.
+     *
      */
-    generateSignal(updateHash) {
-        throw new MethodError('Method not implemented.', `METHOD_NOT_IMPLEMENTED`, { updateHash });
+    constructor(service) {
+        super({ ...service, type: 'SingletonBeacon' });
     }
     /**
      * Processes an array of Beacon Signals associated with a Singleton Beacon Service.
-     * @returns {Promise<BTCR2SignedUpdate | undefined>} The DID Update payload announced by the Beacon Signal.
+     * @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.
      */
-    async processSignals() {
+    async processSignals(signals, sidecar) {
         // Initialize an empty array to hold the BTCR2 signed updates
         const updates = new Array();
-        // Loop through each signal in this.signals
-        for (const signal of this.signals || []) {
+        // Loop through each signal in signals
+        for (const signal of signals) {
             // Grab the beacon signal bytes hash from the signal
             const updateHash = signal.signalBytes;
             // Use the updateHash as the sidecar data lookup key to retrieve the btcr2 update
-            const signedUpdate = this.sidecar.updateMap.get(updateHash);
+            const signedUpdate = sidecar.updateMap.get(updateHash);
             // If no btcr2 update is found in sidecar data maps, throw missingUpdateData error.
             if (!signedUpdate) {
                 throw new SingletonBeaconError(`BTCR2 Signed Update not found for update hash ${updateHash}.`, MISSING_UPDATE_DATA, signal);
@@ -74,70 +55,62 @@ export class SingletonBeacon extends AggregateBeacon {
         return updates;
     }
     /**
-     * Broadcasts a SingletonBeacon signal.
-     * TODO: Design and implement a way to construct, sign and send via RPC
-     *
-     * @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.
      */
-    async broadcastSignal(updateHash) {
-        // 1. Initialize an addressURI variable to beacon.serviceEndpoint.
-        // 2. Set bitcoinAddress to the decoding of addressURI following BIP21.
+    async broadcastSignal(signedUpdate, secretKey, bitcoin) {
+        // Convert the serviceEndpoint to a bitcoin address by removing the 'bitcoin:' prefix
         const bitcoinAddress = this.service.serviceEndpoint.replace('bitcoin:', '');
-        // 3. Ensure bitcoinAddress is funded, if not, fund this address.
-        // let inputs: Array<CreateRawTxInputs> = [];
-        const utxos = await this.bitcoin.network.rest.address.getUtxos(bitcoinAddress);
+        // Query the Bitcoin network for UTXOs associated with the bitcoinAddress
+        const utxos = await bitcoin.network.rest.address.getUtxos(bitcoinAddress);
+        // If no utxos are found, throw an error indicating the address is unfunded.
         if (!utxos.length) {
             throw new SingletonBeaconError('No UTXOs found, please fund address!', 'UNFUNDED_BEACON_ADDRESS', { bitcoinAddress });
         }
-        const utxo = utxos.sort((a, b) => b.status.block_height - a.status.block_height)[0];
+        // Sort utxos by block height and take the most recent one
+        const utxo = utxos.sort((a, b) => b.status.block_height - a.status.block_height).shift();
+        // If no utxos are found, throw an error.
         if (!utxo) {
             throw new SingletonBeaconError('Beacon bitcoin address unfunded or utxos unconfirmed.', 'UNFUNDED_BEACON_ADDRESS', { bitcoinAddress });
         }
-        // 4. Set hashBytes to the result of passing signedUpdate to the JSON Canonicalization and Hash algorithm.
-        const udpateHashBytes = Buffer.from(updateHash, 'hex');
-        if (udpateHashBytes.length !== 32) {
-            throw new SingletonBeaconError('Hash must be 32 bytes');
-        }
-        // 5. Initialize spendTx to a Bitcoin transaction that spends a transaction controlled by the bitcoinAddress and
-        //    contains at least one transaction output. This output MUST have the following format
-        //    [OP_RETURN, OP_PUSH32, hashBytes]
-        const { txid, vout } = utxo;
-        const prevTx = await this.bitcoin.network.rest.transaction.getHex(txid);
-        const input = {
-            hash: txid,
-            index: vout,
+        // Get the previous tx to the utxo being spent
+        const prevTx = await bitcoin.network.rest.transaction.getHex(utxo.txid);
+        // Canonicalize and hash the signed update for OP_RETURN output
+        const updateHash = canonicalization.canonicalhash(signedUpdate);
+        // Construct a spend transaction
+        const spendTx = new Psbt({ network: bitcoin.network.data })
+            // Spend tx contains the utxo as its input
+            .addInput({
+            hash: utxo.txid,
+            index: utxo.vout,
             nonWitnessUtxo: Buffer.from(prevTx, 'hex')
-        };
-        // TODO: Figure out a good way to estimate fees
-        const spendTx = new Psbt({ network: this.bitcoin.network.data })
-            .addInput(input)
+        })
+            // Add a change output minus a fee of 500 sats
+            // TODO: calculate fee based on transaction vsize and current fee rates
             .addOutput({ address: bitcoinAddress, value: BigInt(utxo.value) - BigInt(500) })
-            .addOutput({ script: script.compile([opcodes.OP_RETURN, udpateHashBytes]), value: 0n });
-        // 6. Retrieve the cryptographic material, e.g private key or signing capability, associated with the bitcoinAddress
-        //    or service. How this is done is left to the implementer.
-        const components = Identifier.decode(this.service.id);
-        const keyUri = new CompressedSecp256k1PublicKey(components.genesisBytes).hex;
-        const keyPair = Kms.getKey(keyUri);
+            // Add an OP_RETURN output containing the update hash
+            .addOutput({ script: script.compile([opcodes.OP_RETURN, updateHash]), value: 0n });
+        // Construct a Schnorr key pair from the secret key
+        const keyPair = SchnorrKeyPair.fromSecret(secretKey);
         if (!keyPair) {
-            throw new Error('Key pair not found.');
+            throw new SingletonBeaconError('Key pair not found.', 'KEY_PAIR_NOT_FOUND', { secretKey });
         }
-        const signer = new Signer({ keyPair, network: this.bitcoin.network.name });
-        // 7. Sign the spendTx.
+        // Construct a signer object from the key pair and bitcoin network
+        const signer = new Signer({ keyPair, network: bitcoin.network.name });
+        // Sign 0th input, finalize extract to hex in prep for broadcast
         const signedTx = spendTx.signInput(0, signer)
             .finalizeAllInputs()
             .extractTransaction()
             .toHex();
-        if (!spendTx) {
-            throw new SingletonBeaconError('Failed to sign raw transaction.', 'RAW_TX_SIGN_FAILED', { spendTx });
-        }
-        // 8. Broadcast spendTx to the Bitcoin network.
-        const spentTx = await this.bitcoin.network.rest.transaction.send(signedTx);
-        if (!spentTx) {
-            throw new SingletonBeaconError('Failed to send raw transaction.', 'SEND_FAILED', { spentTx });
-        }
-        // Return the signed update and the spend tx id.
-        return spentTx;
+        // Broadcast spendTx to the Bitcoin network.
+        const txid = await bitcoin.network.rest.transaction.send(signedTx);
+        console.info(`Broadcasted Singleton Beacon signal with txid ${txid}`);
+        // Return the signed update
+        return signedUpdate;
     }
 }
 //# sourceMappingURL=singleton.js.map

package/dist/cjs/core/beacon/singleton.js.map

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