Skip to content

Selecting algorithm names #115

@bleichenbacher-daniel

Description

@bleichenbacher-daniel

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions