On Tue, 26 Aug 2025 15:48:31 GMT, Weijun Wang <[email protected]> wrote:
>> src/java.base/share/classes/javax/crypto/spec/HPKEParameterSpec.java line 40:
>>
>>> 38: * This immutable class specifies the set of parameters used with a
>>> {@code Cipher} for the
>>> 39: * <a href="https://www.rfc-editor.org/info/rfc9180";>Hybrid Public Key
>>> Encryption</a>
>>> 40: * (HPKE) algorithm. The <a href=
>>
>> I think would be useful to add one or two (but no more) sentences describing
>> HPKE and what it should be used for.
>
> I've added
>
> * HPKE is a public key encryption scheme for encrypting
> * arbitrary-sized plaintexts to a receiver's public key. It combines a
> key
> * encapsulation mechanism (KEM), a key derivation function (KDF), and an
> * authenticated encryption with additional data (AEAD) cipher.
>
> These are copied from [the Abstract of RFC
> 9180](https://www.rfc-editor.org/rfc/rfc9180.html#abstract) with a few tweaks.
First sentence, should it be "with a receiver's public key"?
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/18411#discussion_r2303750559
