C2SP / wycheproof

Project Wycheproof tests crypto libraries against known attacks.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Selecting algorithm names

bleichenbacher-daniel opened this issue · comments

I'd like to ask for opinions on algorithm names. While it is not completely necessary to have consistent naming for algorithms (and also file names) it would be helpful to have at least some rule of thumbs to avoid too much confusion. There are some inconsistencies in the current test vector files, so maybe these can be removed. The main issues are as follows:

  • sizes: most libraries use sizes in bits. So this should probably be the default. There are currently some exceptions, such as tag sizes an output sizes. Maybe these should be changed to achieve consistency.
  • distinction between initialisms and abbreviations: Wycheproof currently follows one of the Google style guides which says not to distinguish between these. This is somewhat uncommon since many libraries do distinguish. I.e. instead of name like AESCtrHMACBlake2s and AESCBCHMACSHA3_256 the names would always use PascalCase or camelCase: AesCtrHmacBlake2s and AesCbcHmacSha3_256. (The names above don't include key size and tag size, but that is a separate issue)
  • There are some proposed algorithm names in RFCs. I'm not sure if these should be used. The result would feel somewhat inconsistent.
  • Anything else: there are probably a lot of inconsistencies in the current version that are annoying.