@did-btcr2/method 0.16.0 → 0.17.1

package/dist/browser.js

@@ -45004,11 +45004,11 @@ var BTCR2 = (() => {
             };
             metadataRegistry.registerProvider(provider);
             return provider;
-            function GetOrCreateMetadataMap(O, P3, Create2) {
+            function GetOrCreateMetadataMap(O, P3, Create) {
               var targetMetadata = metadata2.get(O);
               var createdTargetMetadata = false;
               if (IsUndefined(targetMetadata)) {
-                if (!Create2)
+                if (!Create)
                   return void 0;
                 targetMetadata = new _Map();
                 metadata2.set(O, targetMetadata);
@@ -45016,7 +45016,7 @@ var BTCR2 = (() => {
               }
               var metadataMap = targetMetadata.get(P3);
               if (IsUndefined(metadataMap)) {
-                if (!Create2)
+                if (!Create)
                   return void 0;
                 metadataMap = new _Map();
                 targetMetadata.set(P3, metadataMap);
@@ -45143,12 +45143,12 @@ var BTCR2 = (() => {
             };
             return provider;
           }
-          function GetMetadataProvider(O, P3, Create2) {
+          function GetMetadataProvider(O, P3, Create) {
             var registeredProvider = metadataRegistry.getProvider(O, P3);
             if (!IsUndefined(registeredProvider)) {
               return registeredProvider;
             }
-            if (Create2) {
+            if (Create) {
               if (metadataRegistry.setProvider(O, P3, metadataProvider)) {
                 return metadataProvider;
               }
@@ -45991,13 +45991,13 @@ var BTCR2 = (() => {
     BeaconFactory: () => BeaconFactory,
     BeaconUtils: () => BeaconUtils,
     CIDAggregateBeacon: () => CIDAggregateBeacon,
-    Create: () => Create,
     DID_REGEX: () => DID_REGEX,
     Deactivate: () => Deactivate,
     DidBtcr2: () => DidBtcr2,
     DidDocument: () => DidDocument2,
     DidDocumentBuilder: () => DidDocumentBuilder,
     DidVerificationMethod: () => DidVerificationMethod,
+    Document: () => Document,
     GeneralUtils: () => GeneralUtils,
     Identifier: () => Identifier,
     IntermediateDidDocument: () => IntermediateDidDocument,
@@ -48513,6 +48513,45 @@ var BTCR2 = (() => {
   // ../bitcoin/dist/esm/client/rest/index.js
   init_shim();
 
+  // ../bitcoin/dist/esm/constants.js
+  init_shim();
+  var TXIN_WITNESS_COINBASE = "0000000000000000000000000000000000000000000000000000000000000000";
+  var GENESIS_TX_ID = "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b";
+  var DEFAULT_BITCOIN_NETWORK_CONFIG = {
+    bitcoin: {
+      rpc: void 0,
+      rest: { host: "https://mempool.holdings/api" }
+    },
+    testnet3: {
+      rpc: void 0,
+      rest: { host: "https://mempool.holdings/testnet/api" }
+    },
+    testnet4: {
+      rpc: void 0,
+      rest: { host: "https://mempool.holdings/testnet4/api" }
+    },
+    signet: {
+      rpc: void 0,
+      rest: { host: "https://mempool.holdings/signet/api" }
+    },
+    mutinynet: {
+      rpc: void 0,
+      rest: { host: "https://mutinynet.com/api" }
+    },
+    regtest: {
+      rpc: {
+        network: "regtest",
+        host: "http://localhost:18443",
+        port: 18443,
+        username: "polaruser",
+        password: "polarpass",
+        allowDefaultWallet: true,
+        version: "28.1.0"
+      },
+      rest: { host: "http://localhost:3000" }
+    }
+  };
+
   // ../bitcoin/dist/esm/client/rest/address.js
   init_shim();
   var BitcoinAddress = class {
@@ -48708,46 +48747,8 @@ var BTCR2 = (() => {
     }
   };
 
-  // ../bitcoin/dist/esm/constants.js
+  // ../bitcoin/dist/esm/types.js
   init_shim();
-  var TXIN_WITNESS_COINBASE = "0000000000000000000000000000000000000000000000000000000000000000";
-  var GENESIS_TX_ID = "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b";
-  var DEFAULT_BITCOIN_NETWORK_CONFIG = {
-    mainnet: {
-      rpc: void 0,
-      rest: { host: "https://mempool.space/api" }
-    },
-    testnet3: {
-      rpc: void 0,
-      rest: { host: "https://mempool.space/testnet/api" }
-    },
-    testnet4: {
-      rpc: void 0,
-      rest: { host: "https://mempool.space/testnet4/api" }
-    },
-    signet: {
-      rpc: void 0,
-      rest: { host: "https://mempool.space/signet/api" }
-    },
-    mutinynet: {
-      rpc: void 0,
-      rest: { host: "https://mutinynet.com/api" }
-    },
-    regtest: {
-      rpc: {
-        network: "regtest",
-        host: "http://localhost:18443",
-        port: 18443,
-        username: "polaruser",
-        password: "polarpass",
-        allowDefaultWallet: true,
-        version: "28.1.0"
-      },
-      rest: { host: "http://localhost:3000" }
-    }
-  };
-
-  // ../bitcoin/dist/esm/client/rest/index.js
   var RestClientConfig = class {
     host;
     headers;
@@ -48756,6 +48757,51 @@ var BTCR2 = (() => {
       this.headers = headers;
     }
   };
+  var BitcoinRpcClientConfig = class _BitcoinRpcClientConfig {
+    network;
+    headers;
+    host;
+    logger;
+    password;
+    timeout;
+    username;
+    version;
+    wallet;
+    allowDefaultWallet;
+    constructor(options2 = {
+      headers: {},
+      host: "http://localhost",
+      logger: console,
+      password: "",
+      timeout: 3e4,
+      username: "",
+      version: "0.21.1",
+      wallet: "",
+      allowDefaultWallet: false
+    }) {
+      this.headers = options2.headers;
+      this.host = options2.host;
+      this.logger = options2.logger;
+      this.password = options2.password;
+      this.timeout = options2.timeout;
+      this.username = options2.username;
+      this.version = options2.version;
+      this.wallet = options2.wallet;
+      this.allowDefaultWallet = options2.allowDefaultWallet;
+    }
+    static initialize(options2) {
+      return new _BitcoinRpcClientConfig(options2);
+    }
+  };
+  var VerbosityLevel;
+  (function(VerbosityLevel2) {
+    VerbosityLevel2[VerbosityLevel2["hex"] = 0] = "hex";
+    VerbosityLevel2[VerbosityLevel2["json"] = 1] = "json";
+    VerbosityLevel2[VerbosityLevel2["jsonext"] = 2] = "jsonext";
+    VerbosityLevel2[VerbosityLevel2["jsonextprev"] = 3] = "jsonextprev";
+  })(VerbosityLevel || (VerbosityLevel = {}));
+
+  // ../bitcoin/dist/esm/client/rest/index.js
   var BitcoinRestClient = class _BitcoinRestClient {
     /**
      * The encapsulated {@link RestClientConfig} object.
@@ -48848,52 +48894,6 @@ var BTCR2 = (() => {
   // ../bitcoin/dist/esm/client/rpc/index.js
   init_shim();
 
-  // ../bitcoin/dist/esm/types.js
-  init_shim();
-  var BitcoinRpcClientConfig = class _BitcoinRpcClientConfig {
-    network;
-    headers;
-    host;
-    logger;
-    password;
-    timeout;
-    username;
-    version;
-    wallet;
-    allowDefaultWallet;
-    constructor(options2 = {
-      headers: {},
-      host: "localhost",
-      logger: console,
-      password: "",
-      timeout: 3e4,
-      username: "",
-      version: "0.21.1",
-      wallet: "",
-      allowDefaultWallet: false
-    }) {
-      this.headers = options2.headers;
-      this.host = options2.host;
-      this.logger = options2.logger;
-      this.password = options2.password;
-      this.timeout = options2.timeout;
-      this.username = options2.username;
-      this.version = options2.version;
-      this.wallet = options2.wallet;
-      this.allowDefaultWallet = options2.allowDefaultWallet;
-    }
-    static initialize(options2) {
-      return new _BitcoinRpcClientConfig(options2);
-    }
-  };
-  var VerbosityLevel;
-  (function(VerbosityLevel2) {
-    VerbosityLevel2[VerbosityLevel2["hex"] = 0] = "hex";
-    VerbosityLevel2[VerbosityLevel2["json"] = 1] = "json";
-    VerbosityLevel2[VerbosityLevel2["jsonext"] = 2] = "jsonext";
-    VerbosityLevel2[VerbosityLevel2["jsonextprev"] = 3] = "jsonextprev";
-  })(VerbosityLevel || (VerbosityLevel = {}));
-
   // ../bitcoin/dist/esm/client/rpc/json-rpc.js
   init_shim();
 
@@ -48932,8 +48932,8 @@ var BTCR2 = (() => {
             u.password = "";
             this.url = u.toString().replace(/\/+$/, "");
           }
-        } catch {
-          console.error("Invalid URL in Bitcoin RPC config");
+        } catch (error) {
+          console.error(`Invalid URL in Bitcoin RPC config: ${this.url}`, error);
         }
       }
     }
@@ -57844,7 +57844,7 @@ var BTCR2 = (() => {
     }
     /**
      * Computes the public key from the secret key bytes.
-     * @returns {KeyBytes} The computed public key
+     * @returns {CompressedSecp256k1PublicKey} The computed public key
      */
     computePublicKey() {
       const publicKeyBytes = tinysecp.pointFromScalar(this.bytes, true);
@@ -57854,7 +57854,7 @@ var BTCR2 = (() => {
       if (publicKeyBytes.length !== 33) {
         throw new SecretKeyError("Invalid compute: public key not compressed format", "COMPUTE_PUBLIC_KEY_ERROR");
       }
-      return publicKeyBytes;
+      return new CompressedSecp256k1PublicKey(publicKeyBytes);
     }
     /**
      * Converts the secret key to a JSON object.
@@ -57876,15 +57876,14 @@ var BTCR2 = (() => {
     }
     /**
      * Checks if the public key is a valid secp256k1 point.
-     * @param {CompressedSecp256k1PublicKey} pk The public key to validate
      * @returns {boolean} True if the public key is valid, false otherwise
      */
-    hasValidPublicKey(pk) {
+    hasValidPublicKey() {
+      const pk = this.computePublicKey();
       if (!tinysecp.isPoint(pk.compressed)) {
         return false;
       }
-      const computed = new CompressedSecp256k1PublicKey(this.computePublicKey());
-      return computed.equals(pk);
+      return true;
     }
     /**
      * Decodes the multibase string to the 34-byte secret key (2 byte prefix + 32 byte key).
@@ -57971,7 +57970,7 @@ var BTCR2 = (() => {
     /**
      * Generates a public key from the given secret key bytes.
      * @param {KeyBytes} bytes The secret key bytes
-     * @returns {KeyBytes} The computed public key bytes
+     * @returns {CompressedSecp256k1PublicKey} The computed public key bytes
      */
     static getPublicKey(bytes3) {
       return new _Secp256k1SecretKey(bytes3).computePublicKey();
@@ -58028,10 +58027,15 @@ var BTCR2 = (() => {
     }
     /**
      * Parity of the SEC compressed public key.
-     * @returns {0 | 1} The parity of the public key. 0 = even (0x02), 1 = odd (0x03).
+     * @returns {0x02 | 0x03} The parity byte (0x02 if even, 0x03 if odd).
+     * @throws {PublicKeyError} If the parity byte is not 0x02 or 0x03.
      */
     get parity() {
-      return this._bytes[0] & 1;
+      const parity = this._bytes[0];
+      if (![2, 3].includes(parity)) {
+        throw new PublicKeyError("Invalid state: parity byte must be 2 or 3", "PARITY_ERROR", { parity });
+      }
+      return parity;
     }
     /**
      * Whether the SEC compressed public key has even Y.
@@ -58178,7 +58182,7 @@ var BTCR2 = (() => {
         throw new PublicKeyError("Invalid arg: must be 32 byte secret key", "FROM_SECRET_KEY_ERROR");
       }
       const secret = sk instanceof Secp256k1SecretKey ? sk : new Secp256k1SecretKey(sk);
-      return new _CompressedSecp256k1PublicKey(secret.computePublicKey());
+      return secret.computePublicKey();
     }
     /**
      * Computes modular exponentiation: (base^exp) % mod.
@@ -58260,7 +58264,7 @@ var BTCR2 = (() => {
       } else if (params.publicKey instanceof Uint8Array) {
         this._publicKey = new CompressedSecp256k1PublicKey(params.publicKey);
       } else {
-        this._publicKey = new CompressedSecp256k1PublicKey(this._secretKey.computePublicKey());
+        this._publicKey = this._secretKey.computePublicKey();
       }
       this._publicKeyMultibase = this._publicKey.multibase.encoded;
       this._secretKeyMultibase = this._secretKey ? this._secretKey.multibase : "";
@@ -58286,8 +58290,13 @@ var BTCR2 = (() => {
      * @throws {KeyPairError} If the public key is not a valid pair with the secret key.
      */
     set publicKey(publicKey2) {
-      if (this.secretKey && !this.secretKey.hasValidPublicKey(publicKey2)) {
-        throw new KeyPairError("Public key is not a valid pair with the secret key", "PUBLIC_KEY_ERROR");
+      if (this.secretKey) {
+        if (!this.secretKey.hasValidPublicKey()) {
+          throw new KeyPairError("Secret key is not valid", "SECRET_KEY_ERROR");
+        }
+        const cPk = this.secretKey.computePublicKey();
+        if (!publicKey2.equals(cPk))
+          throw new KeyPairError("Public key is not a valid pair with the secret key", "PUBLIC_KEY_ERROR");
       }
       this._publicKey = publicKey2;
       this._publicKeyMultibase = publicKey2.multibase.encoded;
@@ -145773,7 +145782,7 @@ a=end-of-candidates
      * @throws {MultikeyError} if neither a publicKey nor a privateKey is provided
      * @returns {SchnorrMultikey} A new Multikey instance
      */
-    static initialize({ id, controller, keys }) {
+    static create({ id, controller, keys }) {
       return new _SchnorrMultikey({ id, controller, keys });
     }
     /**
@@ -146374,7 +146383,14 @@ a=end-of-candidates
     }
   };
 
-  // src/core/crud/create.ts
+  // src/core/crud/deactivate.ts
+  init_shim();
+
+  // src/did-btcr2.ts
+  init_shim();
+  var tinysecp4 = __toESM(require_dist2(), 1);
+
+  // src/core/crud/read.ts
   init_shim();
 
   // src/utils/beacons.ts
@@ -147142,6 +147158,7 @@ a=end-of-candidates
     capabilityDelegation;
     service;
     constructor(document2) {
+      console.log("Constructing DidDocument with document:", document2);
       const idType = document2.id.includes("k1") ? IdentifierTypes.KEY : IdentifierTypes.EXTERNAL;
       const isIntermediate = document2.id === ID_PLACEHOLDER_VALUE;
       const { id, controller, verificationMethod: vm, service } = document2;
@@ -147381,6 +147398,7 @@ a=end-of-candidates
       if (!_DidDocument.isValidVerificationRelationships(this)) {
         throw new DidDocumentError("Invalid IntermediateDidDocument assertionMethod", INVALID_DID_DOCUMENT, this);
       }
+      return true;
     }
     /**
      * Convert the DidDocument to an IntermediateDidDocument.
@@ -147395,19 +147413,7 @@ a=end-of-candidates
   };
   var IntermediateDidDocument = class _IntermediateDidDocument extends DidDocument2 {
     constructor(document2) {
-      const intermediateDocument = JSON.cloneReplace(document2, DID_REGEX, ID_PLACEHOLDER_VALUE);
-      super(intermediateDocument);
-    }
-    /**
-     * Create a minimal IntermediateDidDocument with a placeholder ID.
-     * @param {Array<DidVerificationMethod>} verificationMethod The public key in multibase format.
-     * @param {VerificationRelationships} relationships The public key in multibase format.
-     * @param {Array<BeaconService>} service The service to be included in the document.
-     * @returns {IntermediateDidDocument} A new IntermediateDidDocument with the placeholder ID.
-     */
-    static create(verificationMethod, relationships, service) {
-      const id = ID_PLACEHOLDER_VALUE;
-      return new _IntermediateDidDocument({ id, ...relationships, verificationMethod, service });
+      super(document2);
     }
     /**
      * Convert the IntermediateDidDocument to a DidDocument by replacing the placeholder value with the provided DID.
@@ -147420,92 +147426,72 @@ a=end-of-candidates
       return new DidDocument2(parseThis);
     }
     /**
-     * Create a DidDocument from a JSON object.
-     * @param {JSONObject} object The JSON object to convert.
-     * @returns {DidDocument} The created DidDocument.
+     * Create an IntermediateDidDocument from a DidDocument by replacing the DID with a placeholder value.
+     * @param {DidDocument} didDocument The DidDocument to convert.
+     * @returns {IntermediateDidDocument} The IntermediateDidDocument representation of the DidDocument.
      */
-    static from(object2) {
-      return new _IntermediateDidDocument(object2).toDidDocument(object2.id);
+    static fromDidDocument(didDocument) {
+      const intermediateDocument = JSON.cloneReplace(didDocument, DID_REGEX, ID_PLACEHOLDER_VALUE);
+      return new _IntermediateDidDocument(intermediateDocument);
     }
-  };
-
-  // src/core/crud/create.ts
-  var Create = class {
     /**
-     * Implements {@link https://dcdpr.github.io/did-btcr2/#deterministic-key-based-creation | 4.1.1 Deterministic Key-Based Creation}.
-     *
-     * For deterministic key-based creation, the did:btcr2 identifier encodes a secp256k1 public key. The key is then used
-     * to deterministically generate the initial DID document.
-     *
-     * @param {CreateKeyParams} params See {@link CreateKeyParams} for details.
-     * @param {number} params.version did-btcr2 identifier version.
-     * @param {string} params.network did-btcr2 bitcoin network.
-     * @param {KeyBytes} params.pubKeyBytes public key bytes for id creation.
-     * @returns {CreateResponse} A response object of type {@link CreateResponse}.
-     * @throws {DidError} if the public key is missing or invalid.
+     * Create a minimal IntermediateDidDocument with a placeholder ID.
+     * @param {Array<DidVerificationMethod>} verificationMethod The public key in multibase format.
+     * @param {VerificationRelationships} relationships The public key in multibase format.
+     * @param {Array<BeaconService>} service The service to be included in the document.
+     * @returns {IntermediateDidDocument} A new IntermediateDidDocument with the placeholder ID.
      */
-    static deterministic({ pubKeyBytes, options: options2 }) {
-      const { version: version3 = 1, network = "bitcoin" } = options2;
-      const idType = IdentifierTypes.KEY;
-      const identifier = Identifier.encode({ version: version3, network, idType, genesisBytes: pubKeyBytes });
-      const { compressed: publicKey2, multibase: publicKeyMultibase } = new CompressedSecp256k1PublicKey(pubKeyBytes);
-      const service = BeaconUtils.generateBeaconServices({
-        identifier,
-        publicKey: publicKey2,
+    static create(verificationMethod, relationships, service) {
+      const id = ID_PLACEHOLDER_VALUE;
+      return new _IntermediateDidDocument({ id, ...relationships, verificationMethod, service });
+    }
+    /**
+     * Create a minimal IntermediateDidDocument from a public key.
+     * @param {KeyBytes} publicKey The public key in bytes format.
+     * @returns {IntermediateDidDocument} A new IntermediateDidDocument with the placeholder ID.
+     */
+    static fromPublicKey(publicKey2, network) {
+      const pk = new CompressedSecp256k1PublicKey(publicKey2);
+      const id = ID_PLACEHOLDER_VALUE;
+      const service = BeaconUtils.generateBeaconService({
+        id: `${id}#key-0`,
+        publicKey: pk.compressed,
         network: getNetwork(network),
+        addressType: "p2pkh",
         type: "SingletonBeacon"
       });
-      const initialDocument = new DidDocument2({
-        id: identifier,
-        controller: [identifier],
-        verificationMethod: [{
-          id: `${identifier}#initialKey`,
+      const relationships = {
+        authentication: [`${id}#key-0`],
+        assertionMethod: [`${id}#key-0`],
+        capabilityInvocation: [`${id}#key-0`],
+        capabilityDelegation: [`${id}#key-0`]
+      };
+      const verificationMethod = [
+        {
+          id: `${id}#key-0`,
           type: "Multikey",
-          controller: identifier,
-          publicKeyMultibase: publicKeyMultibase.encoded
-        }],
-        service
-      });
-      return { did: identifier, initialDocument };
+          controller: id,
+          publicKeyMultibase: pk.multibase.encoded
+        }
+      ];
+      return _IntermediateDidDocument.create(verificationMethod, relationships, [service]);
     }
     /**
-     * Implements {@link https://dcdpr.github.io/did-btcr2/#external-initial-document-creation | 4.1.2 External Initial Document Creation}.
-     *
-     * Creates a did:btcr2 identifier from some initiating arbitrary DID document. This allows for more complex
-     * initial DID documents, including the ability to include Service Endpoints and Beacons that support aggregation.
-     * Inputs include `intermediateDocument`, optional version and network returning initialDidDocument. The
-     * intermediateDocument should be a valid DID document except all places where the DID document requires the use of
-     * the identifier (e.g. the id field). These fields should use placeholder value
-     * `did:btcr2:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`. The intermediateDocument should include at
-     * least one verificationMethod and service of the type SingletonBeacon.
-     *
-     * @param {CreateExternalParams} params See {@link CreateExternalParams} for details.
-     * @param {number} params.version Identifier version.
-     * @param {string} params.network Identifier network name.
-     * @param {string} params.documentBytes Intermediate DID Document bytes.
-     * @returns {CreateResponse} A Promise resolving to {@link CreateResponses}.
-     * @throws {DidError} if the verificationMethod or service objects are missing required properties
+     * Taken an object, convert it to an IntermediateDocuemnt and then to a DidDocument.
+     * @param {JSONObject} object The JSON object to convert.
+     * @returns {DidDocument} The created DidDocument.
      */
-    static async external({ intermediateDocument, options: options2 }) {
-      const idType = IdentifierTypes.EXTERNAL;
-      const { version: version3 = 1, network = "bitcoin" } = options2;
-      intermediateDocument.validateIntermediate();
-      const genesisBytes = await JSON.canonicalization.canonicalhash(intermediateDocument);
-      const did = Identifier.encode({ idType, genesisBytes, version: version3, network });
-      const initialDocument = intermediateDocument.toDidDocument(did);
-      return { did, initialDocument };
+    static fromJSON(object2) {
+      return new _IntermediateDidDocument(object2);
+    }
+  };
+  var Document = class {
+    static isValid(didDocument) {
+      return new DidDocument2(didDocument).validateIntermediate();
     }
   };
-
-  // src/core/crud/deactivate.ts
-  init_shim();
-
-  // src/did-btcr2.ts
-  init_shim();
-  var tinysecp4 = __toESM(require_dist2(), 1);
 
   // src/core/crud/read.ts
-  init_shim();
   var bitcoin4 = new BitcoinNetworkConnection();
   var Resolve = class {
     /**
@@ -148107,7 +148093,7 @@ a=end-of-candidates
         );
       }
       const id = fullId.slice(fullId.indexOf("#"));
-      const multikey = !secretKeyMultibase ? await KeyManager.getKeyPair(fullId) : SchnorrMultikey.initialize({
+      const multikey = !secretKeyMultibase ? await KeyManager.getKeyPair(fullId) : SchnorrMultikey.create({
         id,
         controller,
         keys: new SchnorrKeyPair({
@@ -148204,15 +148190,9 @@ a=end-of-candidates
      */
     static async create(params) {
       const { idType, options: options2 = {} } = params;
-      if (idType === IdentifierTypes.KEY) {
-        const { pubKeyBytes } = params;
-        return Create.deterministic({ pubKeyBytes, options: options2 });
-      }
-      if (idType === IdentifierTypes.EXTERNAL) {
-        const { intermediateDocument } = params;
-        return await Create.external({ intermediateDocument, options: options2 });
-      }
-      throw new MethodError('Invalid idType: expected "KEY" or "EXTERNAL"', INVALID_DID, params);
+      const { version: version3 = 1, network = "bitcoin" } = options2;
+      const genesisBytes = params.genesisBytes;
+      return Identifier.encode({ idType, genesisBytes, version: version3, network });
     }
     /**
      * Entry point for section {@link https://dcdpr.github.io/did-btcr2/#read | 7.2 Read}.