@did-btcr2/method 0.18.1 → 0.20.0

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

@@ -1,219 +1,116 @@
-import { BitcoinNetworkConnection } from '@did-btcr2/bitcoin';
-import { INVALID_SIDECAR_DATA, LATE_PUBLISHING_ERROR, 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 { Beacon } from '../../interfaces/beacon.js';
-import { Appendix } from '../../utils/appendix.js';
-import { Identifier } from '../identifier.js';
-const bitcoin = new BitcoinNetworkConnection();
+import { canonicalization } from '../../did-btcr2.js';
+import { Beacon } from './beacon.js';
+import { SingletonBeaconError } from './error.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 class SingletonBeacon extends Beacon {
     /**
      * Creates an instance of SingletonBeacon.
-     * @param {BeaconService} service The Beacon service.
-     * @param {?BeaconSidecarData} [sidecar] Optional sidecar data.
-     */
-    constructor(service, sidecar) {
-        super({ ...service, type: 'SingletonBeacon' }, sidecar);
-    }
-    /**
-     * Get the Beacon service.
-     * @readonly
-     * @type {BeaconService} The Beacon service.
-     */
-    get service() {
-        return {
-            type: this.type,
-            id: this.id,
-            serviceEndpoint: this.serviceEndpoint
-        };
-    }
-    /**
-     * 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, sidecar) {
-        return new SingletonBeacon(service, sidecar);
+    constructor(service) {
+        super({ ...service, type: '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.
+     * 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.
      */
-    generateSignal(didUpdatePayload) {
-        throw new Error('Method not implemented.' + didUpdatePayload);
-    }
-    /**
-     * 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.
-     */
-    async processSignal(signal, signalsMetadata) {
-        // 1. Initialize a txOut variable to the 0th transaction output of the tx.
-        const output = signal.vout.filter((vout) => (vout['scriptpubkey_asm'] || vout['scriptPubKey'].asm).includes('OP_RETURN'))?.[0];
-        if (!output) {
-            throw new SingletonBeaconError('No OP_RETURN output found in transaction outputs.', 'NO_OP_RETURN', { signal });
-        }
-        const outputMap = new Map(Object.entries(output));
-        // 2. Set didUpdatePayload to null.
-        let didUpdatePayload = undefined;
-        // 3. Check txout is of the format [OP_RETURN, OP_PUSH32, <32bytes>], if not, then return didUpdatePayload.
-        //    The Bitcoin transaction is not a Beacon Signal.
-        const UPDATE_PAYLOAD_HASH = (outputMap.get('scriptpubkey_asm') ?? outputMap.get('scriptPubKey').asm).split(' ').last();
-        if (!UPDATE_PAYLOAD_HASH) {
-            return undefined;
-        }
-        // 4. Set hashBytes to the 32 bytes in the txout.
-        const hashBytes = JSON.canonicalization.encode(Buffer.fromHex(UPDATE_PAYLOAD_HASH), 'base58');
-        // Convert signalsMetadata to a Map for easier access
-        const signalsMetadataMap = new Map(Object.entries(signalsMetadata));
-        // 5. If signalsMetadata:
-        if (signalsMetadata) {
-            // 5.1 Set didUpdatePayload to signalsMetadata.updatePayload
-            didUpdatePayload = signalsMetadataMap.get(signal.txid)?.didUpdate;
-            if (!didUpdatePayload) {
-                throw new SingletonBeaconError('Update Payload not found in signal metadata.', 'PROCESS_SIGNAL_ERROR');
+    async processSignals(signals, sidecar) {
+        // Initialize an empty array to hold the BTCR2 signed updates
+        const updates = new Array();
+        // 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 = 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);
             }
-            // 5.2 Set updateHashBytes to the result of passing didUpdatePayload to the JSON Canonicalization and Hash algorithm.
-            const updateHashBytes = await JSON.canonicalization.process(didUpdatePayload, 'base58');
-            // 5.3 If updateHashBytes does not equal hashBytes, MUST throw an invalidSidecarData error.
-            if (updateHashBytes !== hashBytes) {
-                throw new SingletonBeaconError(`Hash mismatch: updateHashBytes ${updateHashBytes} !== hashBytes ${hashBytes}.`, INVALID_SIDECAR_DATA, { UPDATE_PAYLOAD_HASH, didUpdatePayload });
+            // Canonicalize, hash and encode to base58 the signed update object found in sidecar or CAS
+            const encodedUpdate = canonicalization.process(signedUpdate, { encoding: 'base58' });
+            // Encode the signal bytes hex string to base58
+            const signalBytes = base58btc.encode(Buffer.from(updateHash, 'hex'));
+            // Check for mismatch between found sidecar/cas update hash and onchain beacon signal hash
+            if (encodedUpdate !== signalBytes) {
+                // If mismatch, throw invalidSidecarData error.
+                throw new SingletonBeaconError(`Hash mismatch: sidecar update ${encodedUpdate} !== signal bytes ${signalBytes}.`, INVALID_SIDECAR_DATA, { encodedUpdate, signalBytes });
             }
-            // 7. Return didUpdatePayload.
-            return didUpdatePayload;
-        }
-        // 6. Else:
-        //  6.1 Set didUpdatePayload to the result of passing hashBytes into the Fetch Content from Addressable Storage algorithm.
-        const didUpdatePayloadString = await Appendix.fetchFromCas(base58btc.decode(hashBytes));
-        if (!didUpdatePayloadString || !JSON.parse(didUpdatePayloadString)) {
-            throw new SingletonBeaconError('Update payload not found in addressable storage.', INVALID_SIDECAR_DATA);
-        }
-        didUpdatePayload = JSON.parse(didUpdatePayloadString);
-        //  6.2 If didUpdatePayload is null, MUST raise a latePublishingError. MAY identify Beacon Signal to resolver and request additional Sidecar data be provided.
-        if (!didUpdatePayload) {
-            throw new SingletonBeaconError('Update payload hash does not match transaction hash.', LATE_PUBLISHING_ERROR);
+            // Push signedUpdate to updates array
+            updates.push([signedUpdate, signal.blockMetadata]);
         }
-        // 7. Return didUpdatePayload.
-        return didUpdatePayload;
+        // Return the array of signed updates
+        return updates;
     }
     /**
-     * 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.
      */
-    async broadcastSignal(didUpdatePayload) {
-        // 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> = [];
+        // 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) {
-            // TODO: Discuss what to do here because sending to a beacon address does not allow you to spend from it immediately.
             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 didUpdatePayload to the JSON Canonicalization and Hash algorithm.
-        const hashBytes = Buffer.fromHex(await JSON.canonicalization.process(didUpdatePayload));
-        if (hashBytes.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 bitcoin.network.rest.transaction.getHex(txid);
-        const input = {
-            hash: txid,
-            index: vout,
-            nonWitnessUtxo: Buffer.fromHex(prevTx)
-        };
-        // TODO: Figure out a good way to estimate fees
+        // 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 })
-            .addInput(input)
+            // Spend tx contains the utxo as its input
+            .addInput({
+            hash: utxo.txid,
+            index: utxo.vout,
+            nonWitnessUtxo: Buffer.from(prevTx, 'hex')
+        })
+            // 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, hashBytes]), 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 });
         }
+        // Construct a signer object from the key pair and bitcoin network
         const signer = new Signer({ keyPair, network: bitcoin.network.name });
-        // 7. Sign the spendTx.
+        // 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 bitcoin.network.rest.transaction.send(signedTx);
-        if (!spentTx) {
-            throw new SingletonBeaconError('Failed to send raw transaction.', 'SEND_FAILED', { spentTx });
-        }
-        // 9. Set signalId to the Bitcoin transaction identifier of spendTx.
-        // 10. Initialize signalMetadata to an empty object.
-        // 11. Set signalMetadata.updatePayload to didUpdatePayload.
-        // 12. Return the object {<signalId>: { updatePayload: DidUpdatePayload; proofs?: any; }}.
-        return { [spentTx]: { didUpdate: didUpdatePayload } };
+        // 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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"}

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

@@ -0,0 +1,39 @@
+import { Beacon } from './beacon.js';
+import { SMTBeaconError } from './error.js';
+/**
+ * Implements {@link https://dcdpr.github.io/did-btcr2/terminology.html#smt-beacon | SMTBeacon}.
+ * @class SMTBeacon
+ * @type {SMTBeacon}
+ * @extends {Beacon}
+ */
+export class SMTBeacon extends Beacon {
+    /**
+     * Creates an instance of SMTBeacon.
+     * @param {BeaconService} service The Beacon service.
+     */
+    constructor(service) {
+        super({ ...service, type: 'SMTBeacon' });
+    }
+    /**
+     * 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, sidecar) {
+        throw new SMTBeaconError('Method not implemented.', `METHOD_NOT_IMPLEMENTED`, { signals, sidecar });
+    }
+    /**
+     * 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.
+     */
+    async broadcastSignal(signedUpdate, secretKey, bitcoin) {
+        throw new SMTBeaconError('Method not implemented.', `METHOD_NOT_IMPLEMENTED`, { signedUpdate, secretKey, bitcoin });
+    }
+}
+//# sourceMappingURL=smt-beacon.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"smt-beacon.js","sourceRoot":"","sources":["../../../../src/core/beacon/smt-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,EAAC,OAAO,EAAE,OAAO,EAAC,CAAC,CAAC;IACpG,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"}