From 69b6b4591b689f41c8005f3029154a9758a08f66 Mon Sep 17 00:00:00 2001
From: Manu Sporny <msporny@digitalbazaar.com>
Date: Fri, 16 Feb 2024 19:00:30 -0500
Subject: [PATCH] Update Instantiate Cryptosuite algorithm.

---
 index.html | 77 ++++++++++++++----------------------------------------
 1 file changed, 19 insertions(+), 58 deletions(-)

diff --git a/index.html b/index.html
index 4bc2c85..5da49fc 100644
--- a/index.html
+++ b/index.html
@@ -523,14 +523,14 @@ <h2>Algorithms</h2>
       </p>
 
       <section>
-        <h3>Suite Selection Algorithm</h3>
+        <h3>Instantiate Cryptosuite</h3>
 
         <p>
 This algorithm is used to configure a cryptographic suite to be used by the
-<a href="https://www.w3.org/TR/vc-data-integrity/#add-proof">Add Proof</a> and
-<a href="https://www.w3.org/TR/vc-data-integrity/#verify-proof">Verify Proof</a>
+<a data-cite="VC-DATA-INTEGRITY#add-proof">Add Proof</a> and
+<a href="VC-DATA-INTEGRITY#verify-proof">Verify Proof</a>
 functions in [[[VC-DATA-INTEGRITY]]]. The algorithm takes an options object
-([=map=] |options|) as input and returns a cryptosuite
+([=map=] |options|) as input and returns a [=cryptosuite instance=]
 ([=struct=] |cryptosuite|).
         </p>
 
@@ -539,24 +539,15 @@ <h3>Suite Selection Algorithm</h3>
 Initialize |cryptosuite| to an empty [=struct=].
           </li>
           <li>
-If |options|.|type| is `DataIntegrityProof` and |options|.|cryptosuite| is
-`ecdsa-rdfc-2019` then:
+If |options|.|type| does not equal `DataIntegrityProof`, an
+`INVALID_PROOF_CONFIGURATION` error MUST be raised.
+          </li>
+          <li>
+If |options|.|cryptosuite| is `ecdsa-rdfc-2019` then:
             <ol class="algorithm">
               <li>
-Set |cryptosuite|.|transform| to the algorithm in Section
-<a href="#transformation-ecdsa-rdfc-2019"></a>.
-              </li>
-              <li>
-Set |cryptosuite|.|hash| to the algorithm in Section
-<a href="#hashing-ecdsa-rdfc-2019"></a>.
-              </li>
-              <li>
-Set |cryptosuite|.|createProofConfig| to the algorithm in Section
-<a href="#proof-configuration-ecdsa-rdfc-2019"></a>.
-              </li>
-              <li>
-Set |cryptosuite|.|serializeProof| to the algorithm in Section
-<a href="#proof-serialization-ecdsa-rdfc-2019"></a>.
+Set |cryptosuite|.|createProof| to the algorithm in Section
+<a href="#create-proof-ecdsa-rdfc-2019"></a>.
               </li>
               <li>
 Set |cryptosuite|.|verifyProof| to the algorithm in Section
@@ -565,24 +556,11 @@ <h3>Suite Selection Algorithm</h3>
             </ol>
           </li>
           <li>
-If |options|.|type| is `DataIntegrityProof` and |options|.|cryptosuite| is
-`ecdsa-jcs-2019` then:
+If |options|.|cryptosuite| is `ecdsa-jcs-2019` then:
             <ol class="algorithm">
               <li>
-Set |cryptosuite|.|transform| to the algorithm in Section
-<a href="#transformation-ecdsa-jcs-2019"></a>.
-              </li>
-              <li>
-Set |cryptosuite|.|hash| to the algorithm in Section
-<a href="#hashing-ecdsa-jcs-2019"></a>.
-              </li>
-              <li>
-Set |cryptosuite|.|createProofConfig| to the algorithm in Section
-<a href="#proof-configuration-ecdsa-jcs-2019"></a>.
-              </li>
-              <li>
-Set |cryptosuite|.|serializeProof| to the algorithm in Section
-<a href="#proof-serialization-ecdsa-jcs-2019"></a>.
+Set |cryptosuite|.|createProof| to the algorithm in Section
+<a href="#create-proof-ecdsa-jcs-2019"></a>.
               </li>
               <li>
 Set |cryptosuite|.|verifyProof| to the algorithm in Section
@@ -591,28 +569,11 @@ <h3>Suite Selection Algorithm</h3>
             </ol>
           </li>
           <li>
-If |options|.|type| is `DataIntegrityProof` and |options|.|cryptosuite| is
-`ecdsa-sd-2023` then:
+If |options|.|cryptosuite| is `ecdsa-sd-2023` then:
             <ol class="algorithm">
               <li>
-Set |cryptosuite|.|transform| to the algorithm in Section
-<a href="#base-proof-transformation-ecdsa-sd-2023"></a>.
-              </li>
-              <li>
-Set |cryptosuite|.|hash| to the algorithm in Section
-<a href="#base-proof-hashing-ecdsa-sd-2023"></a>.
-              </li>
-              <li>
-Set |cryptosuite|.|createProofConfig| to the algorithm in Section
-<a href="#base-proof-configuration-ecdsa-sd-2023"></a>.
-              </li>
-              <li>
-Set |cryptosuite|.|serializeProof| to the algorithm in Section
-<a href="#base-proof-serialization-ecdsa-sd-2023"></a>.
-              </li>
-              <li>
-Set |cryptosuite|.|deriveProof| to the algorithm in Section
-<a href="#add-derived-proof-ecdsa-sd-2023"></a>.
+Set |cryptosuite|.|createProof| to the algorithm in Section
+<a href="#create-base-proof-ecdsa-sd-2023"></a>.
               </li>
               <li>
 Set |cryptosuite|.|verifyProof| to the algorithm in Section
@@ -984,7 +945,7 @@ <h3>ecdsa-jcs-2019</h3>
         </p>
 
         <section>
-          <h4>Add Proof (ecdsa-jcs-2019)</h4>
+          <h4>Create Proof (ecdsa-jcs-2019)</h4>
 
           <p>
 To generate a proof, the algorithm in
@@ -2559,7 +2520,7 @@ <h3>ecdsa-sd-2023</h3>
         </p>
 
         <section>
-          <h4>Add Base Proof (ecdsa-sd-2023)</h4>
+          <h4>Create Base Proof (ecdsa-sd-2023)</h4>
 
           <p>
 To generate a base proof, the algorithm in