fixup! add a Rust library

realistic doc examples

Author: burgerdev

rust/src/dalek.rs

@@ -3,14 +3,20 @@
 //! Usage example:
 //!
 //! ```
+//! use hex_literal::hex;
 //! use x25519_dalek::{PublicKey, StaticSecret};
 //! use glome::{tag,verify};
-//! let raw_private_key = [15u8; 32]; // <- our private key loaded from somewhere
-//! let private_key: StaticSecret = raw_private_key.into();
-//! let raw_public_key = [16u8; 32]; // <- their public key loaded from somewhere
-//! let public_key: PublicKey = raw_public_key.into();
-//! tag(&private_key, &public_key, 0u8, b"Hello, world!");
-//! verify(&private_key, &public_key, 42u8, b"Goodbye.", b"\x00\x01\x02\x03");
+//!
+//! let alice_private_key: StaticSecret = hex!("fee1deadfee1deadfee1deadfee1deadfee1deadfee1deadfee1deadfee1dead").into();
+//! let alice_public_key: PublicKey = (&alice_private_key).into();
+//!
+//! let bob_private_key: StaticSecret = hex!("b105f00db105f00db105f00db105f00db105f00db105f00db105f00db105f00d").into();
+//! let bob_public_key: PublicKey = (&bob_private_key).into();
+//!
+//! let msg = b"Hello, world!";
+//! let t = tag(&alice_private_key, &bob_public_key, 0u8, msg);
+//! assert!(verify(&bob_private_key, &alice_public_key, 0u8, msg, &t));
+//! assert!(!verify(&bob_private_key, &alice_public_key, 0u8, b"kthxbai", &t));
 //! ```
 
 use x25519_dalek::{PublicKey as DalekPublicKey, StaticSecret};

rust/src/openssl.rs

@@ -7,14 +7,29 @@
 //! Usage example:
 //!
 //! ```
+//! use hex_literal::hex;
 //! use openssl::pkey;
 //! use glome::{tag,verify};
+//!
 //! let raw_private_key = [15u8; 32]; // <- our private key loaded from somewhere
 //! let private_key = pkey::PKey::private_key_from_raw_bytes(&raw_private_key, pkey::Id::X25519).unwrap();
 //! let raw_public_key = [16u8; 32]; // <- their public key loaded from somewhere
 //! let public_key = pkey::PKey::public_key_from_raw_bytes(&raw_public_key, pkey::Id::X25519).unwrap();
-//! tag(&private_key, &public_key, 0u8, b"Hello, world!");
-//! verify(&private_key, &public_key, 42u8, b"Goodbye.", b"\x00\x01\x02\x03");
+//!
+//! let alice_raw_private_key = hex!("fee1deadfee1deadfee1deadfee1deadfee1deadfee1deadfee1deadfee1dead");
+//! let alice_private_key = pkey::PKey::private_key_from_raw_bytes(&alice_raw_private_key, pkey::Id::X25519).unwrap();
+//! let alice_raw_public_key = hex!("872f435bb8b89d0e3ad62aa2e511074ee195e1c39ef6a88001418be656e3c376");
+//! let alice_public_key = pkey::PKey::public_key_from_raw_bytes(&alice_raw_public_key, pkey::Id::X25519).unwrap();
+//!
+//! let bob_raw_private_key = hex!("b105f00db105f00db105f00db105f00db105f00db105f00db105f00db105f00d");
+//! let bob_private_key = pkey::PKey::private_key_from_raw_bytes(&bob_raw_private_key, pkey::Id::X25519).unwrap();
+//! let bob_raw_public_key = hex!("d1b6941bba120bcd131f335da15778d9c68dadd398ae61cf8e7d94484ee65647");
+//! let bob_public_key = pkey::PKey::public_key_from_raw_bytes(&bob_raw_public_key, pkey::Id::X25519).unwrap();
+//!
+//! let msg = b"Hello, world!";
+//! let t = tag(&alice_private_key, &bob_public_key, 0u8, msg);
+//! assert!(verify(&bob_private_key, &alice_public_key, 0u8, msg, &t));
+//! assert!(!verify(&bob_private_key, &alice_public_key, 0u8, b"kthxbai", &t));
 //! ```
 
 use openssl::{derive, pkey};