Initial project import

tools/v/vlib/crypto/ecdsa/README.md

@@ -0,0 +1,32 @@
+## ecdsa
+
+`ecdsa` module for V language. Its a wrapper on top of openssl ecdsa functionality.
+Its currently (expanded) to support the following curves:
+
+- NIST P-256 curve, commonly referred as prime256v1 or secp256r1
+- NIST P-384 curve, commonly referred as secp384r1 
+- NIST P-521 curve, commonly referred as secp521r1
+- A famous Bitcoin curve, commonly referred as secp256k1
+
+# Example
+```v
+import crypto.ecdsa
+
+fn main() {
+	// create default NIST P-256 secp256r1 curve key pair. If you wish to generate another curve,
+	// use: `pbkey, pvkey := ecdsa.generate_key(nid: .secp521r1)!` instead.
+	pbkey, pvkey := ecdsa.generate_key()!
+
+	message_tobe_signed := 'Hello ecdsa'.bytes()
+	// create a signature with the recommended hash
+	signature := pvkey.sign(message_tobe_signed)!
+
+	// verify the message with the signature
+	verified := pbkey.verify(message_tobe_signed, signature)!
+	dump(verified) // should be true
+
+	// free allocated keys when you have done with your work.
+	pbkey.free()
+	pvkey.free()
+}
+```