diff --git a/pgpainless-core/src/main/java/org/pgpainless/decryption_verification/MissingPublicKeyCallback.java b/pgpainless-core/src/main/java/org/pgpainless/decryption_verification/MissingPublicKeyCallback.java index f41b60ed..ed52dfa4 100644 --- a/pgpainless-core/src/main/java/org/pgpainless/decryption_verification/MissingPublicKeyCallback.java +++ b/pgpainless-core/src/main/java/org/pgpainless/decryption_verification/MissingPublicKeyCallback.java @@ -19,6 +19,16 @@ import org.bouncycastle.openpgp.PGPPublicKey; public interface MissingPublicKeyCallback { + /** + * This method gets called if we encounter a signature of an unknown key. + * + * Note: It would be super cool to provide the OpenPgp fingerprint here, but unfortunately signatures only contain + * the key id (see https://tools.ietf.org/html/rfc4880#section-5.2.3.5) + * + * @param keyId ID of the missing key + * + * @return the key or null + */ PGPPublicKey onMissingPublicKeyEncountered(Long keyId); }