2026-02-05 18:24:43 +01:00
|
|
|
open Syntax
|
|
|
|
|
|
|
|
|
|
module Binary_format_rsa = struct
|
|
|
|
|
(* RSA public key binary format
|
|
|
|
|
https://www.gnupg.org/documentation/manuals/gcrypt/MPI-formats.html
|
|
|
|
|
:= { uint16_be: n size; uint16_be: e size; n; e}
|
|
|
|
|
|
|
|
|
|
integer in big-endian format (MSB first)
|
|
|
|
|
leading zeroes are stripped unless they are required to keep a value positive
|
|
|
|
|
no 0-termination *)
|
|
|
|
|
|
|
|
|
|
let z_array_to_octets (arr : Z.t array) =
|
|
|
|
|
let nb = Array.length arr in
|
2026-02-12 14:21:50 +01:00
|
|
|
let bits_arr = Array.map Mirage_crypto_pk.Z_extra.to_octets_be arr in
|
2026-02-05 18:24:43 +01:00
|
|
|
let len_arr = Array.map String.length bits_arr in
|
|
|
|
|
let len = (2 * nb) + Array.fold_left ( + ) 0 len_arr in
|
|
|
|
|
let b = Bytes.make len '\x00' in
|
|
|
|
|
let pos = ref 0 in
|
|
|
|
|
Array.iter
|
|
|
|
|
(fun len ->
|
|
|
|
|
Bytes.set_uint16_be b !pos len;
|
|
|
|
|
pos := !pos + 2)
|
|
|
|
|
len_arr;
|
|
|
|
|
Array.iteri
|
|
|
|
|
(fun i bits ->
|
|
|
|
|
let len = len_arr.(i) in
|
|
|
|
|
Bytes.blit_string bits 0 b !pos len;
|
|
|
|
|
pos := !pos + len)
|
|
|
|
|
bits_arr;
|
|
|
|
|
Bytes.unsafe_to_string b
|
|
|
|
|
|
|
|
|
|
let z_array_of_octets ~nb s =
|
|
|
|
|
let s_len = String.length s in
|
2026-02-12 14:21:50 +01:00
|
|
|
if s_len <= 2 * nb then Error "rsa of_octets error"
|
|
|
|
|
else
|
|
|
|
|
let pos = ref 0 in
|
|
|
|
|
let len_arr =
|
|
|
|
|
Array.init nb (fun _i ->
|
|
|
|
|
let len = String.get_uint16_be s !pos in
|
|
|
|
|
pos := !pos + 2;
|
|
|
|
|
len)
|
|
|
|
|
in
|
2026-02-05 18:24:43 +01:00
|
|
|
let len = (2 * nb) + Array.fold_left ( + ) 0 len_arr in
|
2026-02-12 14:21:50 +01:00
|
|
|
if s_len <> len then Error "rsa of_octets error"
|
|
|
|
|
else
|
|
|
|
|
let z_arr =
|
|
|
|
|
Array.init nb (fun i ->
|
|
|
|
|
let len = len_arr.(i) in
|
|
|
|
|
let s = String.sub s !pos len in
|
|
|
|
|
let z = Mirage_crypto_pk.Z_extra.of_octets_be s in
|
|
|
|
|
pos := !pos + len;
|
|
|
|
|
z)
|
|
|
|
|
in
|
|
|
|
|
Ok z_arr
|
2026-02-05 18:24:43 +01:00
|
|
|
|
|
|
|
|
let pub_to_octets ({ n; e } : Mirage_crypto_pk.Rsa.pub) =
|
|
|
|
|
z_array_to_octets [| n; e |]
|
|
|
|
|
|
|
|
|
|
let pub_of_octets s =
|
|
|
|
|
let* arr = z_array_of_octets ~nb:2 s in
|
|
|
|
|
match arr with
|
|
|
|
|
| [| n; e |] ->
|
|
|
|
|
let+ pub = Mirage_crypto_pk.Rsa.pub ~n ~e |> unwrap_err_msg in
|
|
|
|
|
pub
|
|
|
|
|
| _ -> assert false
|
|
|
|
|
|
2026-02-13 09:34:03 +01:00
|
|
|
(* custom private key binary format <> than gcrypt *)
|
2026-02-05 18:24:43 +01:00
|
|
|
let priv_to_octets ({ e; d; n; p; q; dp; dq; q' } : Mirage_crypto_pk.Rsa.priv)
|
|
|
|
|
=
|
|
|
|
|
z_array_to_octets [| e; d; n; p; q; dp; dq; q' |]
|
|
|
|
|
|
|
|
|
|
let priv_of_octets s =
|
|
|
|
|
let* arr = z_array_of_octets ~nb:8 s in
|
|
|
|
|
match arr with
|
|
|
|
|
| [| e; d; n; p; q; dp; dq; q' |] ->
|
|
|
|
|
let+ priv =
|
|
|
|
|
Mirage_crypto_pk.Rsa.priv ~e ~d ~n ~p ~q ~dp ~dq ~q' |> unwrap_err_msg
|
|
|
|
|
in
|
|
|
|
|
priv
|
|
|
|
|
| _ -> assert false
|
|
|
|
|
end
|
|
|
|
|
|
2025-09-13 15:56:19 +02:00
|
|
|
module EddsaPublicKey = struct
|
|
|
|
|
open Mirage_crypto_ec.Ed25519
|
|
|
|
|
|
|
|
|
|
type t = pub
|
|
|
|
|
|
|
|
|
|
let to_octets t = pub_to_octets t
|
2025-12-03 16:19:11 +01:00
|
|
|
|
|
|
|
|
let of_octets t =
|
|
|
|
|
pub_of_octets t |> function
|
|
|
|
|
| Error e -> Fmt.error "%a" Mirage_crypto_ec.pp_error e
|
|
|
|
|
| Ok v -> Ok v
|
|
|
|
|
|
|
|
|
|
let bin =
|
2026-02-05 18:24:43 +01:00
|
|
|
let of_octets_exn t = of_octets t |> Result.get_ok in
|
|
|
|
|
Bin.map (Bin.bytes 32) of_octets_exn to_octets
|
2025-09-13 15:56:19 +02:00
|
|
|
|
|
|
|
|
let of_b32 s =
|
|
|
|
|
let* octets = B32.decode s in
|
2025-12-03 16:19:11 +01:00
|
|
|
let* pub = of_octets octets in
|
|
|
|
|
Ok pub
|
2025-09-13 15:56:19 +02:00
|
|
|
|
|
|
|
|
let to_b32 t = B32.encode (to_octets t)
|
|
|
|
|
let jsont = Jsont.of_of_string ~kind:"EddsaPublicKey" of_b32 ~enc:to_b32
|
2025-12-03 16:19:11 +01:00
|
|
|
|
|
|
|
|
let caqti =
|
|
|
|
|
Caqti_type.custom
|
|
|
|
|
~encode:(fun v -> Ok (to_octets v))
|
|
|
|
|
~decode:(fun v -> of_octets v)
|
|
|
|
|
Caqti_type.octets
|
2025-09-13 15:56:19 +02:00
|
|
|
end
|
|
|
|
|
|
|
|
|
|
module EddsaPrivateKey = struct
|
|
|
|
|
(* EdDSA and ECDHE public keys always point on Curve25519
|
|
|
|
|
and represented using the standard 256 bits Ed25519 compact format,
|
|
|
|
|
converted to Crockford Base32. *)
|
|
|
|
|
open Mirage_crypto_ec.Ed25519
|
|
|
|
|
|
|
|
|
|
type t = priv
|
|
|
|
|
|
2026-02-17 09:30:20 +01:00
|
|
|
let generate = generate
|
2025-09-13 15:56:19 +02:00
|
|
|
let pub_of_priv = pub_of_priv
|
|
|
|
|
let to_octets t = priv_to_octets t
|
|
|
|
|
|
2025-12-03 16:19:11 +01:00
|
|
|
let of_octets t =
|
|
|
|
|
priv_of_octets t |> function
|
|
|
|
|
| Error err ->
|
|
|
|
|
let err = Fmt.str "%a" Mirage_crypto_ec.pp_error err in
|
|
|
|
|
Error err
|
|
|
|
|
| Ok v -> Ok v
|
|
|
|
|
|
|
|
|
|
let bin =
|
|
|
|
|
let of_octets_exn t = of_octets t |> Result.get_ok in
|
|
|
|
|
Bin.map (Bin.bytes 32) of_octets_exn to_octets
|
|
|
|
|
|
|
|
|
|
let jsont =
|
|
|
|
|
let of_b32 s =
|
|
|
|
|
let* octets = B32.decode s in
|
|
|
|
|
of_octets octets
|
|
|
|
|
in
|
|
|
|
|
let to_b32 t = B32.encode (to_octets t) in
|
|
|
|
|
Jsont.of_of_string ~kind:"EddsaPrivateKey" of_b32 ~enc:to_b32
|
2025-09-13 15:56:19 +02:00
|
|
|
end
|
|
|
|
|
|
|
|
|
|
module EddsaSignature : sig
|
|
|
|
|
type t
|
|
|
|
|
|
2025-12-03 16:19:11 +01:00
|
|
|
val sign : key:EddsaPrivateKey.t -> string -> t
|
|
|
|
|
|
|
|
|
|
(* Ok () on verification success *)
|
|
|
|
|
val verify : key:EddsaPublicKey.t -> t -> msg:string -> (unit, string) result
|
2025-09-13 15:56:19 +02:00
|
|
|
val to_octets : t -> string
|
2025-12-03 16:19:11 +01:00
|
|
|
val of_octets : string -> (t, string) result
|
2025-09-13 15:56:19 +02:00
|
|
|
val jsont : t Jsont.t
|
|
|
|
|
val bin : t Bin.t
|
2025-12-03 16:19:11 +01:00
|
|
|
val caqti : t Caqti_type.t
|
2025-09-13 15:56:19 +02:00
|
|
|
end = struct
|
2025-12-03 16:19:11 +01:00
|
|
|
(* transmitted as 64-bytes base32
|
|
|
|
|
binary-encoded objects with just the R and S values *)
|
2025-09-13 15:56:19 +02:00
|
|
|
type t = string
|
|
|
|
|
|
2026-02-17 09:30:20 +01:00
|
|
|
(* mirage_crypto:
|
|
|
|
|
"The result is the concatenation of r and s, as specified in RFC 8032." *)
|
2025-12-03 16:19:11 +01:00
|
|
|
let sign ~key s = Mirage_crypto_ec.Ed25519.sign ~key s
|
|
|
|
|
|
|
|
|
|
let verify ~key s ~msg =
|
|
|
|
|
let b = Mirage_crypto_ec.Ed25519.verify ~key s ~msg in
|
|
|
|
|
match b with
|
2026-02-17 09:30:20 +01:00
|
|
|
| false -> Error "EddsaSignature verification: invalid signature"
|
2025-12-03 16:19:11 +01:00
|
|
|
| true -> Ok ()
|
|
|
|
|
|
2025-09-13 15:56:19 +02:00
|
|
|
let to_octets t = t
|
|
|
|
|
|
2026-02-17 09:30:20 +01:00
|
|
|
let check_size t =
|
|
|
|
|
match String.length t = 64 with
|
|
|
|
|
| false -> Error "EddsaSignature of_octets: data is not 64 bytes."
|
|
|
|
|
| true -> Ok ()
|
|
|
|
|
|
2025-09-13 15:56:19 +02:00
|
|
|
let of_octets v =
|
2026-02-17 09:30:20 +01:00
|
|
|
let+ () = check_size v in
|
|
|
|
|
v
|
2025-09-13 15:56:19 +02:00
|
|
|
|
2025-12-03 16:19:11 +01:00
|
|
|
let bin =
|
|
|
|
|
let of_octets_exn t = of_octets t |> Result.get_ok in
|
|
|
|
|
Bin.map (Bin.bytes 64) of_octets_exn to_octets
|
2025-09-13 15:56:19 +02:00
|
|
|
|
2025-12-03 16:19:11 +01:00
|
|
|
let jsont =
|
|
|
|
|
let of_b32 s =
|
|
|
|
|
let* t = B32.decode s in
|
2026-02-17 09:30:20 +01:00
|
|
|
of_octets t
|
2025-12-03 16:19:11 +01:00
|
|
|
in
|
|
|
|
|
let to_b32 = B32.encode in
|
|
|
|
|
Jsont.of_of_string ~kind:"EddsaSignature" of_b32 ~enc:to_b32
|
|
|
|
|
|
|
|
|
|
let caqti =
|
|
|
|
|
Caqti_type.custom
|
|
|
|
|
~encode:(fun v -> Ok (to_octets v))
|
|
|
|
|
~decode:(fun s -> of_octets s)
|
|
|
|
|
Caqti_type.octets
|
2025-09-13 15:56:19 +02:00
|
|
|
end
|
|
|
|
|
|
|
|
|
|
module RsaPublicKey = struct
|
|
|
|
|
open Mirage_crypto_pk
|
|
|
|
|
|
|
|
|
|
type t = Rsa.pub
|
|
|
|
|
|
2026-02-05 18:24:43 +01:00
|
|
|
let to_octets = Binary_format_rsa.pub_to_octets
|
|
|
|
|
let of_octets = Binary_format_rsa.pub_of_octets
|
2026-02-17 09:30:20 +01:00
|
|
|
let to_b32 t = B32.encode (to_octets t)
|
2025-09-13 15:56:19 +02:00
|
|
|
|
2025-12-03 16:19:11 +01:00
|
|
|
let jsont =
|
|
|
|
|
let of_b32 s =
|
|
|
|
|
let* s = B32.decode s in
|
|
|
|
|
let+ v = of_octets s in
|
|
|
|
|
v
|
|
|
|
|
in
|
|
|
|
|
Jsont.of_of_string ~kind:"RsaPublicKey" of_b32 ~enc:to_b32
|
|
|
|
|
|
|
|
|
|
let caqti : t Caqti_type.t =
|
|
|
|
|
Caqti_type.custom
|
|
|
|
|
~encode:(fun v -> Ok (to_octets v))
|
|
|
|
|
~decode:(fun v -> of_octets v)
|
|
|
|
|
Caqti_type.octets
|
2025-09-13 15:56:19 +02:00
|
|
|
end
|
|
|
|
|
|
|
|
|
|
module RsaPrivateKey = struct
|
|
|
|
|
open Mirage_crypto_pk.Rsa
|
|
|
|
|
|
|
|
|
|
type t = priv
|
|
|
|
|
|
2025-12-03 16:19:11 +01:00
|
|
|
let generate ~bits () =
|
|
|
|
|
let priv = generate ~bits () in
|
|
|
|
|
let pub = pub_of_priv priv in
|
|
|
|
|
(priv, pub)
|
|
|
|
|
|
2025-09-13 15:56:19 +02:00
|
|
|
let pub_of_priv = pub_of_priv
|
2026-02-05 18:24:43 +01:00
|
|
|
let of_octets = Binary_format_rsa.priv_of_octets
|
|
|
|
|
let to_octets = Binary_format_rsa.priv_to_octets
|
2025-09-13 15:56:19 +02:00
|
|
|
|
2025-12-03 16:19:11 +01:00
|
|
|
let jsont =
|
|
|
|
|
let of_b32 s =
|
|
|
|
|
let* s = B32.decode s in
|
|
|
|
|
let+ v = of_octets s in
|
|
|
|
|
v
|
|
|
|
|
in
|
|
|
|
|
let to_b32 t = B32.encode (to_octets t) in
|
|
|
|
|
Jsont.of_of_string ~kind:"RsaPrivateKey" of_b32 ~enc:to_b32
|
2025-09-13 15:56:19 +02:00
|
|
|
end
|
|
|
|
|
|
2026-02-24 19:31:39 +01:00
|
|
|
module RsaSignature = struct
|
2025-09-13 15:56:19 +02:00
|
|
|
type t = string
|
|
|
|
|
|
2025-12-03 16:19:11 +01:00
|
|
|
let jsont =
|
|
|
|
|
let of_b32 s = B32.decode s in
|
|
|
|
|
let to_b32 t = B32.encode t in
|
|
|
|
|
Jsont.of_of_string ~kind:"RsaSignature" of_b32 ~enc:to_b32
|
2025-09-13 15:56:19 +02:00
|
|
|
end
|
2025-12-03 16:19:11 +01:00
|
|
|
|
|
|
|
|
(* some type aliases, just for prettier .mli *)
|
|
|
|
|
type eddsa_priv = EddsaPrivateKey.t
|
|
|
|
|
type eddsa_pub = EddsaPublicKey.t
|
|
|
|
|
type eddsa_sig = EddsaSignature.t
|
|
|
|
|
type rsa_priv = RsaPrivateKey.t
|
|
|
|
|
type rsa_pub = RsaPublicKey.t
|
|
|
|
|
type rsa_sig = RsaSignature.t
|
2026-02-17 09:30:20 +01:00
|
|
|
type denom_hash = Hash.DenominationHash.t
|