add comments to clarify serialized size constants

Author: leighmcculloch

soroban-sdk-macros/src/map_type.rs

@@ -8,8 +8,8 @@ use syn::{
     Type, TypePath, TypeTuple,
 };
 
-const G1_SERIALIZED_SIZE: u32 = 96;
-const G2_SERIALIZED_SIZE: u32 = 192;
+const G1_SERIALIZED_SIZE: u32 = 96; // Must match soroban_sdk::crypto::bls21_381::G1_SERIALIZED_SIZE.
+const G2_SERIALIZED_SIZE: u32 = 192; // Must match soroban_sdk::crypto::bls21_381::G2_SERIALIZED_SIZE.
 
 #[allow(clippy::too_many_lines)]
 pub fn map_type(t: &Type, allow_hash: bool) -> Result<ScSpecTypeDef, Error> {

soroban-sdk/src/crypto/bls12_381.rs

@@ -14,8 +14,8 @@ use core::{
 
 pub const FP_SERIALIZED_SIZE: usize = 48; // Size in bytes of a serialized Fp element in BLS12-381. The field modulus is 381 bits, requiring 48 bytes (384 bits) with 3 bits reserved for flags.
 pub const FP2_SERIALIZED_SIZE: usize = FP_SERIALIZED_SIZE * 2;
-pub const G1_SERIALIZED_SIZE: usize = FP_SERIALIZED_SIZE * 2;
-pub const G2_SERIALIZED_SIZE: usize = FP2_SERIALIZED_SIZE * 2;
+pub const G1_SERIALIZED_SIZE: usize = FP_SERIALIZED_SIZE * 2; // Must match soroban_sdk_macro::map_type::G1_SERIALIZED_SIZE.
+pub const G2_SERIALIZED_SIZE: usize = FP2_SERIALIZED_SIZE * 2;// Must match soroban_sdk_macro::map_type::G2_SERIALIZED_SIZE.
 
 /// Bls12_381 provides access to curve and field arithmetics on the BLS12-381
 /// curve.