Documentation: validatePrivateKey does not check typed array length about libauth HOT 3 CLOSED

Hey @webmaster128, thanks for opening an issue!

Thanks, I should improve the documentation on validatePrivateKey to clarify the functionality there. There's a short note here on it – basically, I want to avoid adding any runtime checks which aren't necessary for 100% of consumers.

For most applications, when a potential new key is generated, it should be 32 bytes in length, so also validating the length in validatePrivateKey would be extraneous.

Ideally, TypeScript will eventually support stronger type guarantees about the length of a typed array so our function signature can specifically require a 32-byte Uint8Array (microsoft/TypeScript#18471). This would never be an error at runtime, because the compiler should be able to catch any instance in which the programmer accidentally generated the wrong size key (or failed to validate the length of a user-provided key), and those errors should never make it to runtime.

from libauth.

👍 makes sense, thanks. If I know that, I can easily do the check in my own code.

from libauth.

Merging into #3, which I think probably handles this best.

from libauth.