@did-btcr2/method 0.20.0 → 0.22.0

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@did-btcr2/method",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "type": "module",
-  "description": "Javascript/TypeScript reference implementation of did:btcr2 method, a censorship resistant DID Method using the Bitcoin blockchain as a Verifiable Data Registry to announce changes to the DID document. Core package of the did-btcr2-js monorepo.",
+  "description": "Reference implementation for the did:btcr2 DID method written in TypeScript and JavaScript. did:btcr2 is a censorship resistant DID Method using the Bitcoin blockchain as a Verifiable Data Registry to announce changes to the DID document. This is the core method implementation for the did-btcr2-js monorepo.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/types/index.d.ts",
@@ -83,11 +83,11 @@
     "multiformats": "^13.3.1",
     "nostr-tools": "^2.15.0",
     "tiny-secp256k1": "^2.2.3",
-    "@did-btcr2/cryptosuite": "5.0.0",
     "@did-btcr2/bitcoin": "0.3.4",
+    "@did-btcr2/cryptosuite": "5.1.0",
     "@did-btcr2/kms": "0.2.0",
-    "@did-btcr2/common": "3.1.0",
-    "@did-btcr2/keypair": "0.9.0"
+    "@did-btcr2/keypair": "0.9.1",
+    "@did-btcr2/common": "4.0.1"
   },
   "devDependencies": {
     "@eslint/js": "^9.22.0",
@@ -95,7 +95,7 @@
     "@types/chai-as-promised": "^8.0.1",
     "@types/eslint": "^9.6.1",
     "@types/mocha": "^10.0.9",
-    "@types/node": "^22.5.4",
+    "@types/node": "^25.3.0",
     "@typescript-eslint/eslint-plugin": "^8.5.0",
     "@typescript-eslint/parser": "^8.5.0",
     "c8": "^10.1.2",
@@ -138,6 +138,7 @@
     "build:test": "pnpm build && pnpm build:tests && pnpm c8 mocha",
     "build:lint:test": "pnpm build && pnpm build:tests && pnpm lint:fix",
     "prepublish": "pnpm build",
+    "generate:vector": "pnpm tsx lib/generate-vector.ts",
     "do": "pnpm tsx",
     "do:lib": "${PWD}/lib/run-lib.sh",
     "pack:local": "pnpm pack && mv *.tgz ./release"

package/src/core/beacon/singleton.ts

@@ -1,11 +1,10 @@
 import { AddressUtxo, BitcoinNetworkConnection } from '@did-btcr2/bitcoin';
-import { INVALID_SIDECAR_DATA, KeyBytes, MISSING_UPDATE_DATA } from '@did-btcr2/common';
+import { Canonicalization, INVALID_SIDECAR_DATA, KeyBytes, MISSING_UPDATE_DATA } from '@did-btcr2/common';
 import { SignedBTCR2Update } from '@did-btcr2/cryptosuite';
 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 { SidecarData } from '../types.js';
 import { Beacon } from './beacon.js';
 import { SingletonBeaconError } from './error.js';
@@ -15,7 +14,7 @@ import { BeaconService, BeaconSignal, BlockMetadata } from './interfaces.js';
  * Implements {@link https://dcdpr.github.io/did-btcr2/terminology.html#singleton-beacon | Singleton Beacon}.
  * @class SingletonBeacon
  * @type {SingletonBeacon}
- * @extends {AggregateBeacon}
+ * @extends {Beacon}
  */
 export class SingletonBeacon extends Beacon {
 
@@ -57,7 +56,7 @@ export class SingletonBeacon extends Beacon {
       }
 
       // Canonicalize, hash and encode to base58 the signed update object found in sidecar or CAS
-      const encodedUpdate = canonicalization.process(signedUpdate, { encoding: 'base58' });
+      const encodedUpdate = Canonicalization.process(signedUpdate, { encoding: 'base58' });
 
       // Encode the signal bytes hex string to base58
       const signalBytes = base58btc.encode(Buffer.from(updateHash, 'hex'));
@@ -122,7 +121,7 @@ export class SingletonBeacon extends Beacon {
     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);
+    const updateHash = Canonicalization.andHash(signedUpdate);
 
     // Construct a spend transaction
     const spendTx = new Psbt({ network: bitcoin.network.data })
@@ -140,9 +139,6 @@ export class SingletonBeacon extends Beacon {
 
     // Construct a Schnorr key pair from the secret key
     const keyPair = SchnorrKeyPair.fromSecret(secretKey);
-    if (!keyPair) {
-      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 });
@@ -155,7 +151,9 @@ export class SingletonBeacon extends Beacon {
 
     // Broadcast spendTx to the Bitcoin network.
     const txid = await bitcoin.network.rest.transaction.send(signedTx);
-    console.info(`Broadcasted Singleton Beacon signal with txid ${txid}`);
+
+    // Log the txid of the broadcasted transaction
+    console.info(`Singleton Beacon Signal Broadcasted with txid: ${txid}`);
 
     // Return the signed update
     return signedUpdate;

package/src/core/resolve.ts

@@ -3,6 +3,7 @@ import {
   getNetwork
 } from '@did-btcr2/bitcoin';
 import {
+  Canonicalization,
   DateUtils,
   IdentifierHrp,
   INVALID_DID,
@@ -23,7 +24,7 @@ import {
 } from '@did-btcr2/cryptosuite';
 import { CompressedSecp256k1PublicKey } from '@did-btcr2/keypair';
 import { bytesToHex } from '@noble/hashes/utils';
-import { canonicalization, DidBtcr2 } from '../did-btcr2.js';
+import { DidBtcr2 } from '../did-btcr2.js';
 import { Appendix } from '../utils/appendix.js';
 import { DidDocument, ID_PLACEHOLDER_VALUE } from '../utils/did-document.js';
 import { BeaconFactory } from './beacon/factory.js';
@@ -38,10 +39,13 @@ import { CASAnnouncement, Sidecar, SidecarData } from './types.js';
  * The response object for DID Resolution.
  */
 export interface DidResolutionResponse {
-  currentDocument: DidDocument;
-  confirmations: number;
-  versionId: string;
-  updated: string;
+  didDocument: DidDocument;
+  metadata: {
+    confirmations?: number;
+    versionId: string;
+    updated?: string;
+    deactivated?: boolean;
+  }
 }
 
 /**
@@ -79,7 +83,6 @@ export class Resolve {
 
     return new DidDocument({
       id                 : did,
-      controller         : [did],
       verificationMethod : [{
         id                 : `${did}#initialKey`,
         type               : 'Multikey',
@@ -102,7 +105,7 @@ export class Resolve {
     genesisDocument: object,
   ): Promise<DidDocument> {
     // Canonicalize and sha256 hash the currentDocument
-    const hashBytes = canonicalization.process(genesisDocument, { encoding: 'hex' });
+    const hashBytes = Canonicalization.process(genesisDocument, { encoding: 'hex' });
 
     // Compare the genesisBytes to the hashBytes
     const genesisBytes = bytesToHex(didComponents.genesisBytes);
@@ -137,14 +140,14 @@ export class Resolve {
     const updateMap = new Map<string, SignedBTCR2Update>();
     if(sidecar.updates?.length)
       for(const update of sidecar.updates) {
-        updateMap.set(canonicalization.process(update, { encoding: 'hex' }), update);
+        updateMap.set(Canonicalization.process(update, { encoding: 'hex' }), update);
       }
 
     // CAS Announcements map
     const casMap = new Map<string, CASAnnouncement>();
     if(sidecar.casUpdates?.length)
       for(const update of sidecar.casUpdates) {
-        casMap.set(canonicalization.process(update, { encoding: 'hex' }), update);
+        casMap.set(Canonicalization.process(update, { encoding: 'hex' }), update);
       }
 
     // SMT Proofs map
@@ -220,16 +223,18 @@ export class Resolve {
       : await BeaconSignalDiscovery.fullnode(beaconServices, bitcoin);
 
     // Process each beacon's signals in parallel
-    const promises = Array.from(beaconServicesSignals.entries()).map(
-      async ([service, signals]) => {
-        // Skip beacons with no signals
-        if (!signals.length) return [];
-        // Establish a typed beacon and process its signals
-        return BeaconFactory.establish(service).processSignals(signals, sidecarData);
-      }
+    const promises = await Promise.all(
+      Array.from(beaconServicesSignals.entries()).map(
+        async ([service, signals]) => {
+          // Skip beacons with no signals
+          if (!signals.length) return [];
+          // Establish a typed beacon and process its signals
+          return BeaconFactory.establish(service).processSignals(signals, sidecarData);
+        }
+      )
     );
 
-    return (await Promise.all(promises)).flat();
+    return promises.flat();
   }
 
   /**
@@ -258,31 +263,36 @@ export class Resolve {
     );
 
     // Create a default response object
-    const response = {
-      currentDocument,
-      versionId     : `${currentVersionId}`,
-      confirmations : 0,
-      updated       : ''
+    const response: DidResolutionResponse = {
+      didDocument : currentDocument,
+      metadata    : {
+        versionId     : `${currentVersionId}`,
+        confirmations : 0,
+        updated       : '',
+        deactivated   : currentDocument.deactivated || false
+      }
     };
 
     // Iterate over each (update block) pair
     for(const [update, block] of updates) {
       // Get the hash of the current document
-      const currentDocumentHash = canonicalization.process(response.currentDocument, { encoding: 'base58' });
+      const currentDocumentHash = Canonicalization.process(response.didDocument, { encoding: 'base58' });
 
-      // Set confirmations to the block confirmations
-      response.confirmations = block.confirmations;
+      // Safely convert block.time to timestamp
+      const blocktime = DateUtils.blocktimeToTimestamp(block.time);
 
-      // Safely convert versionTime to timestamp
-      const vTime = DateUtils.dateStringToTimestamp(versionTime || '');
-      // Safely convert block.blocktime to timestamp
-      const bTime = DateUtils.blocktimeToTimestamp(block.time);
       // Set the updated field to the blocktime of the current update
-      response.updated = DateUtils.toISOStringNonFractional(bTime);
+      response.metadata.updated = DateUtils.toISOStringNonFractional(blocktime);
+
+      // Set confirmations to the block confirmations
+      response.metadata.confirmations = block.confirmations;
 
       // if resolutionOptions.versionTime is defined and the blocktime is more recent, return currentDocument
-      if(vTime < bTime) {
-        return response;
+      if(versionTime) {
+        // Safely convert versionTime to timestamp
+        if(blocktime > DateUtils.dateStringToTimestamp(versionTime)) {
+          return response;
+        }
       }
 
       // Check update.targetVersionId against currentVersionId
@@ -294,23 +304,21 @@ export class Resolve {
 
       // If update.targetVersionId == currentVersionId + 1, apply the update
       else if (update.targetVersionId === currentVersionId + 1) {
-      // Prepend `z` to the sourceHash if it does not start with it
-        const sourceHash = update.sourceHash.startsWith('z') ? update.sourceHash : `z${update.sourceHash}`;
-
         // Check if update.sourceHash !== currentDocumentHash
-        if (sourceHash !== currentDocumentHash) {
+        if (update.sourceHash !== currentDocumentHash) {
           // Raise an INVALID_DID_UPDATE error if they do not match
           throw new ResolveError(
             `Hash mismatch: update.sourceHash !== currentDocumentHash`,
-            INVALID_DID_UPDATE, { sourceHash, currentDocumentHash }
+            INVALID_DID_UPDATE, { sourceHash: update.sourceHash, currentDocumentHash }
           );
         }
         // Apply the update to the currentDocument and set it in the response
-        response.currentDocument = await this.applyUpdate(response.currentDocument, update);
+        response.didDocument = await this.applyUpdate(response.didDocument, update);
+
         // Create unsigned_update by removing the proof property from update.
         const unsignedUpdate = JSONUtils.deleteKeys(update, ['proof']) as UnsignedBTCR2Update;
         // Push the canonicalized unsigned update hash to the updateHashHistory
-        updateHashHistory.push(canonicalization.process(unsignedUpdate, { encoding: 'base58' }));
+        updateHashHistory.push(Canonicalization.process(unsignedUpdate, { encoding: 'base58' }));
       }
 
       // If update.targetVersionId > currentVersionId + 1, throw LATE_PUBLISHING error
@@ -319,15 +327,16 @@ export class Resolve {
           `Version Id Mismatch: targetVersionId cannot be > currentVersionId + 1`,
           'LATE_PUBLISHING_ERROR', {
             targetVersionId  : update.targetVersionId,
-            currentVersionId : String(currentVersionId + 1)
+            currentVersionId : currentVersionId + 1
           }
         );
       }
 
       // Increment currentVersionId
       currentVersionId++;
-      // Set currentVersionId in response
-      response.versionId = `${currentVersionId}`;
+
+      // Set response.versionId to be the new  currentVersionId
+      response.metadata.versionId = `${currentVersionId}`;
 
       // If resolutionOptions.versionId is defined and <= currentVersionId, return currentDocument
       if(currentVersionId >= Number(versionId)) {
@@ -336,6 +345,9 @@ export class Resolve {
 
       // Check if the current document is deactivated before further processing
       if(currentDocument.deactivated) {
+        // Set the response deactivated flag to true
+        response.metadata.deactivated = currentDocument.deactivated;
+        // If deactivated, stop processing further updates and return the response
         return response;
       }
     }
@@ -352,12 +364,12 @@ export class Resolve {
    */
   static confirmDuplicate(update: SignedBTCR2Update, updateHashHistory: string[]): void {
     // Create unsigned_update by removing the proof property from update.
-    const unsignedUpdate = JSONUtils.deleteKeys(update, ['proof']) as UnsignedBTCR2Update;
+    const { proof: _, ...unsignedUpdate } = update;
 
     // Hash unsignedUpdate with JSON Document Hashing algorithm
-    const unsignedUpdateHash = canonicalization.process(unsignedUpdate);
+    const unsignedUpdateHash = Canonicalization.process(unsignedUpdate);
 
-    // 5. Let historicalUpdateHash equal updateHashHistory[updateHashIndex].
+    // Let historicalUpdateHash equal updateHashHistory[updateHashIndex].
     const historicalUpdateHash = updateHashHistory[update.targetVersionId - 2];
 
     // Check if the updateHash matches the historical hash
@@ -420,7 +432,7 @@ export class Resolve {
     const cryptosuite = new BIP340Cryptosuite(multikey);
 
     // Canonicalize the update
-    const canonicalUpdate = canonicalization.canonicalize(update);
+    const canonicalUpdate = Canonicalization.canonicalize(update);
 
     // Construct a DataIntegrityProof with the cryptosuite
     const diProof = new BIP340DataIntegrityProof(cryptosuite);
@@ -443,7 +455,7 @@ export class Resolve {
     DidDocument.validate(updatedDocument);
 
     // Canonicalize and hash the updatedDocument to get the currentDocumentHash.
-    const currentDocumentHash = canonicalization.process(currentDocument, { encoding: 'base58' });
+    const currentDocumentHash = Canonicalization.process(updatedDocument, { encoding: 'base58' });
 
     // Prepare the update targetHash for comparison with currentDocumentHash.
     const updateTargetHash = update.targetHash.startsWith('z') ? update.targetHash : `z${update.targetHash}`;

package/src/core/update.ts

@@ -1,4 +1,5 @@
 import {
+  Canonicalization,
   INVALID_DID_UPDATE,
   JSONPatch,
   KeyBytes,
@@ -11,7 +12,6 @@ import {
   SignedBTCR2Update,
   UnsignedBTCR2Update
 } from '@did-btcr2/cryptosuite';
-import { canonicalization } from '../did-btcr2.js';
 import { Btcr2DidDocument, DidDocument, DidVerificationMethod } from '../utils/did-document.js';
 import { BeaconFactory } from './beacon/factory.js';
 import { BeaconService } from './beacon/interfaces.js';
@@ -56,7 +56,7 @@ export class Update {
       patch           : patches,
       targetHash      : '',
       targetVersionId : sourceVersionId + 1,
-      sourceHash      : canonicalization.process(sourceDocument, { encoding: 'base58' }),
+      sourceHash      : Canonicalization.process(sourceDocument, { encoding: 'base58' }),
     };
 
     // Apply all JSON patches to sourceDocument.
@@ -74,7 +74,7 @@ export class Update {
     }
 
     // Set the targetHash by canonicalizing the targetDocument and encoding it in base58.
-    unsignedUpdate.targetHash = canonicalization.process(targetDocument, { encoding: 'base58' });
+    unsignedUpdate.targetHash = Canonicalization.process(targetDocument, { encoding: 'base58' });
 
     // Return unsignedUpdate.
     return unsignedUpdate;

package/src/did-btcr2.ts

@@ -1,6 +1,5 @@
 import { BitcoinNetworkConnection } from '@did-btcr2/bitcoin';
 import {
-  Canonicalization,
   DocumentBytes,
   HexString,
   IdentifierHrp,
@@ -34,9 +33,6 @@ import { Update } from './core/update.js';
 import { Appendix } from './utils/appendix.js';
 import { Btcr2DidDocument, DidVerificationMethod } from './utils/did-document.js';
 
-// TODO: convert to API driver?
-export const canonicalization = new Canonicalization();
-
 export type Btcr2Identifier = string;
 
 export interface DidCreateOptions {
@@ -81,11 +77,16 @@ export class DidBtcr2 implements DidMethod {
    * @param {string} options.network The Bitcoin network to use for the identifier, e.g. 'bitcoin', 'testnet', etc. Defaults to 'bitcoin'.
    * @returns {Promise<Btcr2Identifier>} Promise resolving to a Btcr2Identifier string.
    * @throws {MethodError} if any of the checks fail
+   * @example
+   * ```ts
+   * const genesisBytes = SchnorrKeyPair.generate().publicKey.compressed;
+   * const did = DidBtcr2.create(genesisBytes, { idType: 'KEY', network: 'regtest' });
+   * ```
    */
-  static async create(
+  static create(
     genesisBytes: KeyBytes | DocumentBytes,
     options?: DidCreateOptions
-  ): Promise<Btcr2Identifier> {
+  ): Btcr2Identifier {
     // Deconstruct the idType, version and network from the options, setting defaults if not given
     const { idType, version = 1, network = 'bitcoin' } = options || {};
 
@@ -117,24 +118,26 @@ export class DidBtcr2 implements DidMethod {
    * @example
    * ```ts
    * const resolution = await DidBtcr2.resolve(
-   *  'did:btcr2:k1q0dygyp3gz969tp46dychzy4q78c2k3js68kvyr0shanzg67jnuez2cfplh'
+   *  'did:btcr2:k1qgpr45cheptyjekl3cex80xfnkwhxnlclecwwf92gvdjrszm2uwhzlcxu5xte'
    * )
    * ```
    */
   static async resolve(
     did: string,
-    resolutionOptions: ResolutionOptions = { drivers: {} }
+    resolutionOptions: ResolutionOptions = {}
   ): Promise<DidResolutionResult> {
     try {
+      // Set versionId from resolutionOptions
+      const versionId = resolutionOptions.versionId;
 
       // Initialize an empty DID Resolution Result
       const didResolutionResult: DidResolutionResult = {
         '@context'            : 'https://w3id.org/did-resolution/v1',
         didResolutionMetadata : { contentType: 'application/ld+json' },
         didDocumentMetadata   : {
+          versionId,
           deactivated   : false,
           updated       : undefined,
-          versionId     : resolutionOptions.versionId,
           confirmations : undefined,
         },
         didDocument : null,
@@ -146,25 +149,16 @@ export class DidBtcr2 implements DidMethod {
       // Process sidecar if provided
       const sidecarData = Resolve.sidecarData(resolutionOptions.sidecar);
 
-      // Check if bitcoin driver provided
-      if(!resolutionOptions?.drivers?.bitcoin) {
-        // If not, initialize default drivers
-        resolutionOptions.drivers = resolutionOptions.drivers || {};
-        // Set bitcoin driver to default BitcoinNetworkConnection
-        resolutionOptions.drivers.bitcoin = new BitcoinNetworkConnection();
-        // Set the network based on the decoded identifier
-        resolutionOptions.drivers.bitcoin.setActiveNetwork(didComponents.network);
-      }
-
       // Parse the genesis document from the resolution options if provided
       const genesisDocument = resolutionOptions.sidecar?.genesisDocument;
+
       // Since genesisDocument is optional, check if it exists
       if(!genesisDocument) {
         // If no genesisDocument and x HRP, throw MISSING_UPDATE_DATA error
         if(didComponents.hrp === IdentifierHrp.x)
           throw new ResolveError(
             'External resolution requires genesisDocument',
-            MISSING_UPDATE_DATA, { resolutionOptions }
+            MISSING_UPDATE_DATA, resolutionOptions
           );
       }
 
@@ -176,23 +170,33 @@ export class DidBtcr2 implements DidMethod {
         .filter(BeaconUtils.isBeaconService)
         .map(BeaconUtils.parseBeaconServiceEndpoint);
 
-      console.log('beaconServices', beaconServices);
+      // Check if bitcoin driver provided
+      if(!resolutionOptions?.drivers?.bitcoin) {
+        // If not, initialize default drivers
+        resolutionOptions.drivers = resolutionOptions.drivers || {};
+        // Set bitcoin driver to default BitcoinNetworkConnection
+        resolutionOptions.drivers.bitcoin = new BitcoinNetworkConnection();
+        // Set the network based on the decoded identifier
+        resolutionOptions.drivers.bitcoin.setActiveNetwork(didComponents.network);
+      }
+
+      // Get the bitcoin driver from the resolution options
+      const bitcoin = resolutionOptions.drivers.bitcoin;
 
       // Process the Beacon Signals to get the required updates
       const unsortedUpdates = await Resolve.beaconSignals(
         beaconServices,
         sidecarData,
-        resolutionOptions.drivers.bitcoin
+        bitcoin
       );
-      console.log('unsortedUpdates', unsortedUpdates);
 
       // If no updates found, return the current document
       if(!unsortedUpdates.length) {
-        // Set the current document in the didResolutionResult
+        // Set the didDocument in didResolutionResult based on currentDocument
         didResolutionResult.didDocument = currentDocument;
-
-        // Set the deactivated status in the didDocumentMetadata
+        // Set other required fields in the didResolutionResult
         didResolutionResult.didDocumentMetadata.deactivated = !!currentDocument.deactivated;
+        didResolutionResult.didDocumentMetadata.versionId = versionId ?? '1';
 
         // Return the didResolutionResult early
         return didResolutionResult;
@@ -203,14 +207,12 @@ export class DidBtcr2 implements DidMethod {
         currentDocument,
         unsortedUpdates,
         resolutionOptions.versionTime,
-        resolutionOptions.versionId
+        versionId
       );
 
       // Set all of the required fields in the didResolutionResult
-      didResolutionResult.didDocument = result.currentDocument;
-      didResolutionResult.didDocumentMetadata.confirmations = result.confirmations;
-      didResolutionResult.didDocumentMetadata.versionId = result.versionId;
-      didResolutionResult.didDocumentMetadata.deactivated = !!result.currentDocument.deactivated;
+      didResolutionResult.didDocument = result.didDocument;
+      didResolutionResult.didDocumentMetadata = result.metadata;
 
       // Return didResolutionResult;
       return didResolutionResult;
@@ -339,7 +341,7 @@ export class DidBtcr2 implements DidMethod {
     bitcoin ??= new BitcoinNetworkConnection();
 
     // Announce the signed update to the blockchain using the specified beacon(s)
-    // await Update.announce(beaconService, signed, secretKey, bitcoin);
+    await Update.announce(beaconService, signed, secretKey, bitcoin);
 
     // Return signed update if announced successfully
     return signed;

package/src/utils/did-document-builder.ts

@@ -22,13 +22,6 @@ export class DidDocumentBuilder {
     }
   }
 
-  withController(controller?: Array<string>): this {
-    if (controller) {
-      this.document.controller = controller ?? [this.document.id!];
-    }
-    return this;
-  }
-
   withAuthentication(authentication: Array<string | DidVerificationMethod>): this {
     if (authentication) {
       this.document.authentication = authentication;