Add methods for more information about the verification process

Author: peacekeeper

src/main/java/com/danubetech/dataintegrity/verifier/LdVerifier.java

@@ -47,7 +47,7 @@ public static LdVerifier<? extends DataIntegritySuite> ldVerifierForDataIntegrit
 		return LdVerifierRegistry.getLdVerifierByDataIntegritySuite(dataIntegritySuite);
 	}
 
-	public boolean verify(JsonLDObject jsonLdObject, DataIntegrityProof dataIntegrityProof) throws IOException, GeneralSecurityException, JsonLDException {
+	public LdVerifierResult verifyWithResult(JsonLDObject jsonLdObject, DataIntegrityProof dataIntegrityProof) throws IOException, GeneralSecurityException, JsonLDException {
 
 		// check the proof object
 
@@ -73,24 +73,32 @@ public boolean verify(JsonLDObject jsonLdObject, DataIntegrityProof dataIntegrit
 
 		// verify
 
-		boolean verify = this.verify(canonicalizationResult, ldProofOptions);
-		if (log.isDebugEnabled()) log.debug("Verified data integrity proof: {} --> {}", dataIntegrityProof, verify);
+		boolean verified = this.verify(canonicalizationResult, ldProofOptions);
+		if (log.isDebugEnabled()) log.debug("Verified data integrity proof: {} --> {}", dataIntegrityProof, verified);
 
 		// done
 
-		return verify;
+		return new LdVerifierResult(dataIntegrityProof, ldProofOptions, canonicalizer, canonicalizationResult, verified);
 	}
 
-	public boolean verify(JsonLDObject jsonLdObject) throws IOException, GeneralSecurityException, JsonLDException {
+	public LdVerifierResult verifyWithResult(JsonLDObject jsonLdObject) throws IOException, GeneralSecurityException, JsonLDException {
 
 		// obtain the signature object
 
 		DataIntegrityProof dataIntegrityProof = DataIntegrityProof.getFromJsonLDObject(jsonLdObject);
-		if (dataIntegrityProof == null) return false;
+		if (dataIntegrityProof == null) return new LdVerifierResult(dataIntegrityProof, null, null, null, false);
 
 		// done
 
-		return this.verify(jsonLdObject, dataIntegrityProof);
+		return this.verifyWithResult(jsonLdObject, dataIntegrityProof);
+	}
+
+	public boolean verify(JsonLDObject jsonLdObject, DataIntegrityProof dataIntegrityProof) throws IOException, GeneralSecurityException, JsonLDException {
+		return this.verifyWithResult(jsonLdObject, dataIntegrityProof).verified();
+	}
+
+	public boolean verify(JsonLDObject jsonLdObject) throws IOException, GeneralSecurityException, JsonLDException {
+		return this.verifyWithResult(jsonLdObject).verified();
 	}
 
 	public void initialize(DataIntegrityProof dataIntegrityProof) throws GeneralSecurityException {
@@ -101,6 +109,13 @@ public void initialize(DataIntegrityProof dataIntegrityProof) throws GeneralSecu
 
 	public abstract Canonicalizer getCanonicalizer(DataIntegrityProof dataIntegrityProof);
 
+	/*
+	 * Helper records
+	 */
+
+	public record LdVerifierResult(DataIntegrityProof dataIntegrityProof, DataIntegrityProof ldProofOptions, Canonicalizer canonicalizer, byte[] canonicalizationResult, boolean verified) {
+	}
+
 	/*
 	 * Getters and setters
 	 */