From b27603d0b82fbd2e053c7511e8278cba561cd027 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Matev=C5=BE=20Jekovec?= <matevz@oasisprotocol.org>
Date: Mon, 14 Oct 2024 12:54:29 +0200
Subject: [PATCH] contracts/generateSigningKeypair: Doc explicit sk size

---
 contracts/contracts/Sapphire.sol | 26 ++++++++++++++++++++------
 1 file changed, 20 insertions(+), 6 deletions(-)

diff --git a/contracts/contracts/Sapphire.sol b/contracts/contracts/Sapphire.sol
index 7cd740f7..f891c54a 100644
--- a/contracts/contracts/Sapphire.sol
+++ b/contracts/contracts/Sapphire.sol
@@ -321,16 +321,27 @@ library Sapphire {
      * ##### Secp256r1: 4,000 gas
      * - `7` (`Secp256r1PrehashedSha256`)
      *
-     * #### Public Key Format
+     * ##### Secp384r1: 18,000 gas
+     * - `8` (`Secp384r1PrehashedSha384`)
+     *
+     * #### Key Formats
      *
      * ##### Ed25519
      *
-     * 32 bytes
+     * Public key: 32 bytes
+     * Secret key: 32 bytes
      *
      * ##### Secp256k1 & Secp256r1
      *
-     * 33 bytes, compressed format (`0x02` or `0x03` prefix, then 32 byte X
-     * coordinate).
+     * Public key: 33 bytes, compressed format (`0x02` or `0x03` prefix, then 32
+     * byte X coordinate).
+     * Secret key: 32 bytes
+     *
+     * ##### Secp384r1
+     *
+     * Public key: 49 bytes, compressed format (`0x02` or `0x03` prefix, then 48
+     * byte X coordinate).
+     * Secret key: 48 bytes
      *
      * #### Example
      *
@@ -344,8 +355,8 @@ library Sapphire {
      * @param alg The signing alg for which to generate a keypair.
      * @param seed The seed to use for generating the key pair. You can use the
      * `randomBytes` method if you don't already have a seed.
-     * @return publicKey The public half of the keypair.
-     * @return secretKey The secret half of the keypair.
+     * @return publicKey The public part of the keypair.
+     * @return secretKey The secret part of the keypair.
      */
     function generateSigningKeyPair(SigningAlg alg, bytes memory seed)
         internal
@@ -392,6 +403,8 @@ library Sapphire {
      *   bytes) as context, empty message.
      * - `7` (`Secp256r1PrehashedSha256`): 9,000 gas, pre-existing hash (32
      *   bytes) as context, empty message.
+     * - `8` (`Secp384r1PrehashedSha384`): 43,200 gas, pre-existing hash (32
+     *   bytes) as context, empty message.
      *
      * #### Example
      *
@@ -450,6 +463,7 @@ library Sapphire {
      * - `4` (`Secp256k1PrehashedKeccak256`): 3,000 gas
      * - `5` (`Secp256k1PrehashedSha256`): 3,000 gas
      * - `7` (`Secp256r1PrehashedSha256`): 7,900 gas
+     * - `8` (`Secp384r1PrehashedSha384`): 37,920 gas
      *
      * #### Example
      *