type error = [ | `Invalid_format | `Invalid_length | `Invalid_range | `Not_on_curve | `At_infinity | `Low_order ] let error_to_string = function | `Invalid_format -> "invalid format" | `Not_on_curve -> "point is not on curve" | `At_infinity -> "point is at infinity" | `Invalid_length -> "invalid length" | `Invalid_range -> "invalid range" | `Low_order -> "low order" let pp_error fmt e = Format.fprintf fmt "Cannot parse point: %s" (error_to_string e) let rev_string buf = let len = String.length buf in let res = Bytes.create len in for i = 0 to len - 1 do Bytes.set res (len - 1 - i) (String.get buf i) done ; Bytes.unsafe_to_string res exception Message_too_long let bit_at buf i = let byte_num = i / 8 in let bit_num = i mod 8 in let byte = String.get_uint8 buf byte_num in byte land (1 lsl bit_num) <> 0 module type Dh = sig type secret val secret_of_octets : ?compress:bool -> string -> (secret * string, error) result val secret_to_octets : secret -> string val gen_key : ?compress:bool -> ?g:Mirage_crypto_rng.g -> unit -> secret * string val key_exchange : secret -> string -> (string, error) result end module type Dsa = sig type priv type pub val byte_length : int val bit_length : int val priv_of_octets : string -> (priv, error) result val priv_to_octets : priv -> string val pub_of_octets : string -> (pub, error) result val pub_to_octets : ?compress:bool -> pub -> string val pub_of_priv : priv -> pub val generate : ?g:Mirage_crypto_rng.g -> unit -> priv * pub val sign : key:priv -> ?k:string -> string -> string * string val verify : key:pub -> string * string -> string -> bool module K_gen (H : Digestif.S) : sig val generate : key:priv -> string -> string end module Precompute : sig val generator_tables : unit -> string array array array end end module type Dh_dsa = sig module Dh : Dh module Dsa : Dsa end type field_element = string type out_field_element = bytes module type Parameters = sig val a : field_element val b : field_element val g_x : field_element val g_y : field_element val p : field_element val n : field_element val pident: string val byte_length : int val bit_length : int val fe_length : int val first_byte_bits : int option end type point = { f_x : field_element; f_y : field_element; f_z : field_element } type out_point = { m_f_x : out_field_element; m_f_y : out_field_element; m_f_z : out_field_element } type scalar = Scalar of string module type Foreign = sig val mul : out_field_element -> field_element -> field_element -> unit val sub : out_field_element -> field_element -> field_element -> unit val add : out_field_element -> field_element -> field_element -> unit val to_montgomery : out_field_element -> field_element -> unit val from_octets : out_field_element -> string -> unit val set_one : out_field_element -> unit val nz : field_element -> bool val sqr : out_field_element -> field_element -> unit val from_montgomery : out_field_element -> field_element -> unit val to_octets : bytes -> field_element -> unit val inv : out_field_element -> field_element -> unit val select_c : out_field_element -> bool -> field_element -> field_element -> unit val double_c : out_point -> point -> unit val add_c : out_point -> point -> point -> unit val scalar_mult_base_c : out_point -> string -> unit end module type Field_element = sig val mul : field_element -> field_element -> field_element val sub : field_element -> field_element -> field_element val add : field_element -> field_element -> field_element val from_montgomery : field_element -> field_element val zero : field_element val one : field_element val nz : field_element -> bool val sqr : field_element -> field_element val inv : field_element -> field_element val select : bool -> then_:field_element -> else_:field_element -> field_element val from_be_octets : string -> field_element val to_octets : field_element -> string val double_point : point -> point val add_point : point -> point -> point val scalar_mult_base_point : scalar -> point end module Make_field_element (P : Parameters) (F : Foreign) : Field_element = struct let b_uts b = Bytes.unsafe_to_string b let create () = Bytes.create P.fe_length let mul a b = let tmp = create () in F.mul tmp a b; b_uts tmp let sub a b = let tmp = create () in F.sub tmp a b; b_uts tmp let add a b = let tmp = create () in F.add tmp a b; b_uts tmp let from_montgomery a = let tmp = create () in F.from_montgomery tmp a; b_uts tmp let zero = let b = Bytes.make P.fe_length '\000' in b_uts b let one = let fe = create () in F.set_one fe; b_uts fe let nz a = F.nz a let sqr a = let tmp = create () in F.sqr tmp a; b_uts tmp let inv a = let tmp = create () in F.inv tmp a; b_uts tmp let select bit ~then_ ~else_ = let tmp = create () in F.select_c tmp bit then_ else_; b_uts tmp let from_be_octets buf = let buf_rev = rev_string buf in let tmp = create () in F.from_octets tmp buf_rev; F.to_montgomery tmp (b_uts tmp); b_uts tmp let create_octets () = Bytes.create P.byte_length let to_octets fe = let tmp = create_octets () in F.to_octets tmp fe; b_uts tmp let out_point () = { m_f_x = create (); m_f_y = create (); m_f_z = create (); } let out_p_to_p p = { f_x = b_uts p.m_f_x ; f_y = b_uts p.m_f_y ; f_z = b_uts p.m_f_z ; } let double_point p = let tmp = out_point () in F.double_c tmp p; out_p_to_p tmp let add_point a b = let tmp = out_point () in F.add_c tmp a b; out_p_to_p tmp let scalar_mult_base_point (Scalar d) = let tmp = out_point () in F.scalar_mult_base_c tmp d; out_p_to_p tmp end module type Point = sig val at_infinity : unit -> point val is_infinity : point -> bool val add : point -> point -> point val double : point -> point val of_octets : string -> (point, error) result val to_octets : compress:bool -> point -> string val to_affine_raw : point -> (field_element * field_element) option val x_of_finite_point : point -> string val params_g : point val select : bool -> then_:point -> else_:point -> point val scalar_mult_base : scalar -> point end module Make_point (P : Parameters) (F : Foreign) : Point = struct module Fe = Make_field_element(P)(F) let at_infinity () = let f_x = Fe.one in let f_y = Fe.one in let f_z = Fe.zero in { f_x; f_y; f_z } let is_infinity (p : point) = not (Fe.nz p.f_z) let is_solution_to_curve_equation = let a = Fe.from_be_octets P.a in let b = Fe.from_be_octets P.b in fun ~x ~y -> let x3 = Fe.mul x x in let x3 = Fe.mul x3 x in let ax = Fe.mul a x in let y2 = Fe.mul y y in let sum = Fe.add x3 ax in let sum = Fe.add sum b in let sum = Fe.sub sum y2 in not (Fe.nz sum) let check_coordinate buf = (* ensure buf < p: *) match Eqaf.compare_be_with_len ~len:P.byte_length buf P.p >= 0 with | true -> None | exception Invalid_argument _ -> None | false -> Some (Fe.from_be_octets buf) (** Convert coordinates to a finite point ensuring: - x < p - y < p - y^2 = ax^3 + ax + b *) let validate_finite_point ~x ~y = match (check_coordinate x, check_coordinate y) with | Some f_x, Some f_y -> if is_solution_to_curve_equation ~x:f_x ~y:f_y then let f_z = Fe.one in Ok { f_x; f_y; f_z } else Error `Not_on_curve | _ -> Error `Invalid_range let to_affine_raw p = if is_infinity p then None else let z1 = Fe.from_montgomery p.f_z in let z2 = Fe.inv z1 in let z1 = Fe.sqr z2 in let z1 = Fe.from_montgomery z1 in let x = Fe.mul p.f_x z1 in let z1 = Fe.mul z1 z2 in let y = Fe.mul p.f_y z1 in Some (x, y) let to_affine p = Option.map (fun (x, y) -> Fe.to_octets x, Fe.to_octets y) (to_affine_raw p) let to_octets ~compress p = let buf = match to_affine p with | None -> String.make 1 '\000' | Some (x, y) -> let len_x = String.length x and len_y = String.length y in let res = Bytes.create (1 + len_x + len_y) in Bytes.set res 0 '\004' ; let rev_x = rev_string x and rev_y = rev_string y in Bytes.unsafe_blit_string rev_x 0 res 1 len_x ; Bytes.unsafe_blit_string rev_y 0 res (1 + len_x) len_y ; Bytes.unsafe_to_string res in if compress then let out = Bytes.create (P.byte_length + 1) in let ident = 2 + (String.get_uint8 buf (P.byte_length * 2)) land 1 in Bytes.unsafe_blit_string buf 1 out 1 P.byte_length; Bytes.set_uint8 out 0 ident; Bytes.unsafe_to_string out else buf let double p = Fe.double_point p let add p q = Fe.add_point p q let x_of_finite_point p = match to_affine p with None -> assert false | Some (x, _) -> rev_string x let params_g = match validate_finite_point ~x:P.g_x ~y:P.g_y with | Ok p -> p | Error _ -> assert false let select bit ~then_ ~else_ = { f_x = Fe.select bit ~then_:then_.f_x ~else_:else_.f_x; f_y = Fe.select bit ~then_:then_.f_y ~else_:else_.f_y; f_z = Fe.select bit ~then_:then_.f_z ~else_:else_.f_z; } let pow x exp = let r0 = ref Fe.one in let r1 = ref x in for i = P.byte_length * 8 - 1 downto 0 do let bit = bit_at exp i in let multiplied = Fe.mul !r0 !r1 in let r0_sqr = Fe.sqr !r0 in let r1_sqr = Fe.sqr !r1 in r0 := Fe.select bit ~then_:multiplied ~else_:r0_sqr; r1 := Fe.select bit ~then_:r1_sqr ~else_:multiplied; done; !r0 let decompress = (* When p = 4*k+3, as is the case of NIST-P256, there is an efficient square root algorithm to recover the y, as follows: Given the compact representation of Q as x, y2 = x^3 + a*x + b y' = y2^((p+1)/4) y = min(y',p-y') Q=(x,y) is the canonical representation of the point *) let pident = P.pident (* (Params.p + 1) / 4*) in let a = Fe.from_be_octets P.a in let b = Fe.from_be_octets P.b in let p = Fe.from_be_octets P.p in fun pk -> let x = Fe.from_be_octets (String.sub pk 1 P.byte_length) in let x3 = Fe.mul x x in let x3 = Fe.mul x3 x in (* x3 *) let ax = Fe.mul a x in (* ax *) let sum = Fe.add x3 ax in let sum = Fe.add sum b in (* y^2 *) let y = pow sum pident in (* https://tools.ietf.org/id/draft-jivsov-ecc-compact-00.xml#sqrt point 4.3*) let y' = Fe.sub p y in let y = Fe.from_montgomery y in let y_struct = Fe.to_octets y in (* number must not be in montgomery domain*) let y_struct = rev_string y_struct in let y' = Fe.from_montgomery y' in let y_struct2 = Fe.to_octets y' in (* number must not be in montgomery domain*) let y_struct2 = rev_string y_struct2 in let ident = String.get_uint8 pk 0 in let signY = 2 + (String.get_uint8 y_struct (P.byte_length - 1)) land 1 in let res = if Int.equal signY ident then y_struct else y_struct2 in let out = Bytes.create ((P.byte_length * 2) + 1) in Bytes.set out 0 '\004'; Bytes.unsafe_blit_string pk 1 out 1 P.byte_length; Bytes.unsafe_blit_string res 0 out (P.byte_length + 1) P.byte_length; Bytes.unsafe_to_string out let of_octets buf = let len = P.byte_length in if String.length buf = 0 then Error `Invalid_format else let of_octets buf = let x = String.sub buf 1 len in let y = String.sub buf (1 + len) len in validate_finite_point ~x ~y in match String.get_uint8 buf 0 with | 0x00 when String.length buf = 1 -> Ok (at_infinity ()) | 0x02 | 0x03 when String.length P.pident > 0 -> let decompressed = decompress buf in of_octets decompressed | 0x04 when String.length buf = 1 + len + len -> of_octets buf | 0x00 | 0x04 -> Error `Invalid_length | _ -> Error `Invalid_format let scalar_mult_base = Fe.scalar_mult_base_point end module type Scalar = sig val not_zero : string -> bool val is_in_range : string -> bool val of_octets : string -> (scalar, error) result val to_octets : scalar -> string val scalar_mult : scalar -> point -> point val scalar_mult_base : scalar -> point val generator_tables : unit -> field_element array array array end module Make_scalar (Param : Parameters) (P : Point) : Scalar = struct let not_zero = let zero = String.make Param.byte_length '\000' in fun buf -> not (Eqaf.equal buf zero) let is_in_range buf = not_zero buf && Eqaf.compare_be_with_len ~len:Param.byte_length Param.n buf > 0 let of_octets buf = match is_in_range buf with | exception Invalid_argument _ -> Error `Invalid_length | true -> Ok (Scalar (rev_string buf)) | false -> Error `Invalid_range let to_octets (Scalar buf) = rev_string buf (* Branchless Montgomery ladder method *) let scalar_mult (Scalar s) p = let r0 = ref (P.at_infinity ()) in let r1 = ref p in for i = Param.byte_length * 8 - 1 downto 0 do let bit = bit_at s i in let sum = P.add !r0 !r1 in let r0_double = P.double !r0 in let r1_double = P.double !r1 in r0 := P.select bit ~then_:sum ~else_:r0_double; r1 := P.select bit ~then_:r1_double ~else_:sum done; !r0 (* Specialization of [scalar_mult d p] when [p] is the generator *) let scalar_mult_base = P.scalar_mult_base (* Pre-compute multiples of the generator point returns the tables along with the number of significant bytes *) let generator_tables () = let len = Param.fe_length * 2 in let one_table _ = Array.init 15 (fun _ -> P.at_infinity ()) in let table = Array.init len one_table in let base = ref P.params_g in for i = 0 to len - 1 do table.(i).(0) <- !base; for j = 1 to 14 do table.(i).(j) <- P.add !base table.(i).(j - 1) done; base := P.double !base; base := P.double !base; base := P.double !base; base := P.double !base done; let convert {f_x; f_y; f_z} = [|f_x; f_y; f_z|] in Array.map (Array.map convert) table end module Make_dh (Param : Parameters) (P : Point) (S : Scalar) : Dh = struct let point_of_octets c = match P.of_octets c with | Ok p when not (P.is_infinity p) -> Ok p | Ok _ -> Error `At_infinity | Error _ as e -> e let point_to_octets = P.to_octets type secret = scalar let share ?(compress = false) private_key = let public_key = S.scalar_mult_base private_key in point_to_octets ~compress public_key let secret_of_octets ?compress s = match S.of_octets s with | Ok p -> Ok (p, share ?compress p) | Error _ as e -> e let secret_to_octets s = S.to_octets s let rec generate_private_key ?g () = let candidate = Mirage_crypto_rng.generate ?g Param.byte_length in match S.of_octets candidate with | Ok secret -> secret | Error _ -> generate_private_key ?g () let gen_key ?compress ?g () = let private_key = generate_private_key ?g () in private_key, share ?compress private_key let key_exchange secret received = match point_of_octets received with | Error _ as err -> err | Ok shared -> Ok (P.x_of_finite_point (S.scalar_mult secret shared)) end module type Foreign_n = sig val mul : out_field_element -> field_element -> field_element -> unit val add : out_field_element -> field_element -> field_element -> unit val inv : out_field_element -> field_element -> unit val one : out_field_element -> unit val from_bytes : out_field_element -> string -> unit val to_bytes : bytes -> field_element -> unit val from_montgomery : out_field_element -> field_element -> unit val to_montgomery : out_field_element -> field_element -> unit end module type Fn = sig val from_be_octets : string -> field_element val to_be_octets : field_element -> string val mul : field_element -> field_element -> field_element val add : field_element -> field_element -> field_element val inv : field_element -> field_element val one : field_element val from_montgomery : field_element -> field_element val to_montgomery : field_element -> field_element end module Make_Fn (P : Parameters) (F : Foreign_n) : Fn = struct let b_uts = Bytes.unsafe_to_string let create () = Bytes.create P.fe_length let create_octets () = Bytes.create P.byte_length let from_be_octets v = let v' = create () in F.from_bytes v' (rev_string v); F.to_montgomery v' (b_uts v'); b_uts v' let to_be_octets v = let buf = create_octets () in F.to_bytes buf v; rev_string (b_uts buf) let mul a b = let tmp = create () in F.mul tmp a b; b_uts tmp let add a b = let tmp = create () in F.add tmp a b; b_uts tmp let inv a = let tmp = create () in F.inv tmp a; F.to_montgomery tmp (b_uts tmp); b_uts tmp let one = let tmp = create () in F.one tmp; b_uts tmp let from_montgomery a = let tmp = create () in F.from_montgomery tmp a; b_uts tmp let to_montgomery a = let tmp = create () in F.to_montgomery tmp a; b_uts tmp end module Make_dsa (Param : Parameters) (F : Fn) (P : Point) (S : Scalar) (H : Digestif.S) = struct type priv = scalar let byte_length = Param.byte_length let bit_length = Param.bit_length let priv_of_octets= S.of_octets let priv_to_octets = S.to_octets let padded msg = let l = String.length msg in let bl = Param.byte_length in let first_byte_ok () = match Param.first_byte_bits with | None -> true | Some m -> (String.get_uint8 msg 0) land (0xFF land (lnot m)) = 0 in if l > bl || (l = bl && not (first_byte_ok ())) then raise Message_too_long else if l = bl then msg else ( let res = Bytes.make bl '\000' in Bytes.unsafe_blit_string msg 0 res (bl - l) l ; Bytes.unsafe_to_string res ) (* RFC 6979: compute a deterministic k *) module K_gen (H : Digestif.S) = struct let drbg : 'a Mirage_crypto_rng.generator = let module M = Mirage_crypto_rng.Hmac_drbg (H) in (module M) let g ~key msg = let g = Mirage_crypto_rng.create ~strict:true drbg in Mirage_crypto_rng.reseed ~g (S.to_octets key ^ msg); g (* Defined in RFC 6979 sec 2.3.2 with - blen = 8 * Param.byte_length - qlen = Param.bit_length *) let bits2int r = (* keep qlen *leftmost* bits *) let shift = (8 * Param.byte_length) - Param.bit_length in if shift = 0 then Bytes.unsafe_to_string r else (* Assuming shift is < 8 *) let r' = Bytes.create Param.byte_length in let p = ref 0x00 in for i = 0 to Param.byte_length - 1 do let x = Bytes.get_uint8 r i in let v = (x lsr shift) lor (!p lsl (8 - shift)) in p := x; Bytes.set_uint8 r' i v done; Bytes.unsafe_to_string r' (* take qbit length, and ensure it is suitable for ECDSA (> 0 & < n) *) let gen g = let rec go () = let b = Bytes.create Param.byte_length in Mirage_crypto_rng.generate_into ~g b Param.byte_length; (* truncate to the desired number of bits *) let r = bits2int b in if S.is_in_range r then r else go () in go () let generate ~key buf = gen (g ~key (padded buf)) end module K_gen_default = K_gen(H) type pub = point let pub_of_octets = P.of_octets let pub_to_octets ?(compress = false) pk = P.to_octets ~compress pk let generate ?g () = (* FIPS 186-4 B 4.2 *) let d = let rec one () = match S.of_octets (Mirage_crypto_rng.generate ?g Param.byte_length) with | Ok x -> x | Error _ -> one () in one () in let q = S.scalar_mult_base d in (d, q) let x_of_finite_point_mod_n p = match P.to_affine_raw p with | None -> None | Some (x, _) -> let x = F.to_montgomery x in let x = F.mul x F.one in let x = F.from_montgomery x in Some (F.to_be_octets x) let sign ~key ?k msg = let msg = padded msg in let e = F.from_be_octets msg in let g = K_gen_default.g ~key msg in let rec do_sign g = let again () = match k with | None -> do_sign g | Some _ -> invalid_arg "k not suitable" in let k' = match k with None -> K_gen_default.gen g | Some k -> k in let ksc = match S.of_octets k' with | Ok ksc -> ksc | Error _ -> invalid_arg "k not in range" (* if no k is provided, this cannot happen since K_gen_*.gen already preserves the Scalar invariants *) in let point = S.scalar_mult_base ksc in match x_of_finite_point_mod_n point with | None -> again () | Some r -> let r_mon = F.from_be_octets r in let kmon = F.from_be_octets k' in let kinv = F.inv kmon in let dmon = F.from_be_octets (S.to_octets key) in let rd = F.mul r_mon dmon in let cmon = F.add e rd in let smon = F.mul kinv cmon in let s = F.from_montgomery smon in let s = F.to_be_octets s in if S.not_zero s && S.not_zero r then r, s else again () in do_sign g let pub_of_priv priv = S.scalar_mult_base priv let verify ~key (r, s) msg = try let r = padded r and s = padded s in if not (S.is_in_range r && S.is_in_range s) then false else let msg = padded msg in let z = F.from_be_octets msg in let s_mon = F.from_be_octets s in let s_inv = F.inv s_mon in let u1 = F.mul z s_inv in let r_mon = F.from_be_octets r in let u2 = F.mul r_mon s_inv in let u1 = F.from_montgomery u1 in let u2 = F.from_montgomery u2 in match S.of_octets (F.to_be_octets u1), S.of_octets (F.to_be_octets u2) with | Ok u1, Ok u2 -> let point = P.add (S.scalar_mult_base u1) (S.scalar_mult u2 key) in begin match x_of_finite_point_mod_n point with | None -> false (* point is infinity *) | Some r' -> String.equal r r' end | Error _, _ | _, Error _ -> false with | Message_too_long -> false module Precompute = struct let generator_tables = S.generator_tables end end module P256 : Dh_dsa = struct module Params = struct let a = "\xFF\xFF\xFF\xFF\x00\x00\x00\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFC" let b = "\x5A\xC6\x35\xD8\xAA\x3A\x93\xE7\xB3\xEB\xBD\x55\x76\x98\x86\xBC\x65\x1D\x06\xB0\xCC\x53\xB0\xF6\x3B\xCE\x3C\x3E\x27\xD2\x60\x4B" let g_x = "\x6B\x17\xD1\xF2\xE1\x2C\x42\x47\xF8\xBC\xE6\xE5\x63\xA4\x40\xF2\x77\x03\x7D\x81\x2D\xEB\x33\xA0\xF4\xA1\x39\x45\xD8\x98\xC2\x96" let g_y = "\x4F\xE3\x42\xE2\xFE\x1A\x7F\x9B\x8E\xE7\xEB\x4A\x7C\x0F\x9E\x16\x2B\xCE\x33\x57\x6B\x31\x5E\xCE\xCB\xB6\x40\x68\x37\xBF\x51\xF5" let p = "\xFF\xFF\xFF\xFF\x00\x00\x00\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF" let n = "\xFF\xFF\xFF\xFF\x00\x00\x00\x00\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xBC\xE6\xFA\xAD\xA7\x17\x9E\x84\xF3\xB9\xCA\xC2\xFC\x63\x25\x51" let pident = "\x3F\xFF\xFF\xFF\xC0\x00\x00\x00\x40\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x40\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00" |> rev_string (* (Params.p + 1) / 4*) let byte_length = 32 let bit_length = 256 let fe_length = 32 let first_byte_bits = None end module Foreign = struct external mul : out_field_element -> field_element -> field_element -> unit = "mc_p256_mul" [@@noalloc] external sub : out_field_element -> field_element -> field_element -> unit = "mc_p256_sub" [@@noalloc] external add : out_field_element -> field_element -> field_element -> unit = "mc_p256_add" [@@noalloc] external to_montgomery : out_field_element -> field_element -> unit = "mc_p256_to_montgomery" [@@noalloc] external from_octets : out_field_element -> string -> unit = "mc_p256_from_bytes" [@@noalloc] external set_one : out_field_element -> unit = "mc_p256_set_one" [@@noalloc] external nz : field_element -> bool = "mc_p256_nz" [@@noalloc] external sqr : out_field_element -> field_element -> unit = "mc_p256_sqr" [@@noalloc] external from_montgomery : out_field_element -> field_element -> unit = "mc_p256_from_montgomery" [@@noalloc] external to_octets : bytes -> field_element -> unit = "mc_p256_to_bytes" [@@noalloc] external inv : out_field_element -> field_element -> unit = "mc_p256_inv" [@@noalloc] external select_c : out_field_element -> bool -> field_element -> field_element -> unit = "mc_p256_select" [@@noalloc] external double_c : out_point -> point -> unit = "mc_p256_point_double" [@@noalloc] external add_c : out_point -> point -> point -> unit = "mc_p256_point_add" [@@noalloc] external scalar_mult_base_c : out_point -> string -> unit = "mc_p256_scalar_mult_base" [@@noalloc] end module Foreign_n = struct external mul : out_field_element -> field_element -> field_element -> unit = "mc_np256_mul" [@@noalloc] external add : out_field_element -> field_element -> field_element -> unit = "mc_np256_add" [@@noalloc] external inv : out_field_element -> field_element -> unit = "mc_np256_inv" [@@noalloc] external one : out_field_element -> unit = "mc_np256_one" [@@noalloc] external from_bytes : out_field_element -> string -> unit = "mc_np256_from_bytes" [@@noalloc] external to_bytes : bytes -> field_element -> unit = "mc_np256_to_bytes" [@@noalloc] external from_montgomery : out_field_element -> field_element -> unit = "mc_np256_from_montgomery" [@@noalloc] external to_montgomery : out_field_element -> field_element -> unit = "mc_np256_to_montgomery" [@@noalloc] end module P = Make_point(Params)(Foreign) module S = Make_scalar(Params)(P) module Dh = Make_dh(Params)(P)(S) module Fn = Make_Fn(Params)(Foreign_n) module Dsa = Make_dsa(Params)(Fn)(P)(S)(Digestif.SHA256) end module P384 : Dh_dsa = struct module Params = struct let a = "\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFE\xFF\xFF\xFF\xFF\x00\x00\x00\x00\x00\x00\x00\x00\xFF\xFF\xFF\xFC" let b = "\xB3\x31\x2F\xA7\xE2\x3E\xE7\xE4\x98\x8E\x05\x6B\xE3\xF8\x2D\x19\x18\x1D\x9C\x6E\xFE\x81\x41\x12\x03\x14\x08\x8F\x50\x13\x87\x5A\xC6\x56\x39\x8D\x8A\x2E\xD1\x9D\x2A\x85\xC8\xED\xD3\xEC\x2A\xEF" let g_x = "\xAA\x87\xCA\x22\xBE\x8B\x05\x37\x8E\xB1\xC7\x1E\xF3\x20\xAD\x74\x6E\x1D\x3B\x62\x8B\xA7\x9B\x98\x59\xF7\x41\xE0\x82\x54\x2A\x38\x55\x02\xF2\x5D\xBF\x55\x29\x6C\x3A\x54\x5E\x38\x72\x76\x0A\xB7" let g_y = "\x36\x17\xde\x4a\x96\x26\x2c\x6f\x5d\x9e\x98\xbf\x92\x92\xdc\x29\xf8\xf4\x1d\xbd\x28\x9a\x14\x7c\xe9\xda\x31\x13\xb5\xf0\xb8\xc0\x0a\x60\xb1\xce\x1d\x7e\x81\x9d\x7a\x43\x1d\x7c\x90\xea\x0e\x5f" let p = "\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFE\xFF\xFF\xFF\xFF\x00\x00\x00\x00\x00\x00\x00\x00\xFF\xFF\xFF\xFF" let n = "\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xC7\x63\x4D\x81\xF4\x37\x2D\xDF\x58\x1A\x0D\xB2\x48\xB0\xA7\x7A\xEC\xEC\x19\x6A\xCC\xC5\x29\x73" let pident = "\x3F\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xBF\xFF\xFF\xFF\xC0\x00\x00\x00\x00\x00\x00\x00\x40\x00\x00\x00" |> rev_string (* (Params.p + 1) / 4*) let byte_length = 48 let bit_length = 384 let fe_length = 48 let first_byte_bits = None end module Foreign = struct external mul : out_field_element -> field_element -> field_element -> unit = "mc_p384_mul" [@@noalloc] external sub : out_field_element -> field_element -> field_element -> unit = "mc_p384_sub" [@@noalloc] external add : out_field_element -> field_element -> field_element -> unit = "mc_p384_add" [@@noalloc] external to_montgomery : out_field_element -> field_element -> unit = "mc_p384_to_montgomery" [@@noalloc] external from_octets : out_field_element -> string -> unit = "mc_p384_from_bytes" [@@noalloc] external set_one : out_field_element -> unit = "mc_p384_set_one" [@@noalloc] external nz : field_element -> bool = "mc_p384_nz" [@@noalloc] external sqr : out_field_element -> field_element -> unit = "mc_p384_sqr" [@@noalloc] external from_montgomery : out_field_element -> field_element -> unit = "mc_p384_from_montgomery" [@@noalloc] external to_octets : bytes -> field_element -> unit = "mc_p384_to_bytes" [@@noalloc] external inv : out_field_element -> field_element -> unit = "mc_p384_inv" [@@noalloc] external select_c : out_field_element -> bool -> field_element -> field_element -> unit = "mc_p384_select" [@@noalloc] external double_c : out_point -> point -> unit = "mc_p384_point_double" [@@noalloc] external add_c : out_point -> point -> point -> unit = "mc_p384_point_add" [@@noalloc] external scalar_mult_base_c : out_point -> string -> unit = "mc_p384_scalar_mult_base" [@@noalloc] end module Foreign_n = struct external mul : out_field_element -> field_element -> field_element -> unit = "mc_np384_mul" [@@noalloc] external add : out_field_element -> field_element -> field_element -> unit = "mc_np384_add" [@@noalloc] external inv : out_field_element -> field_element -> unit = "mc_np384_inv" [@@noalloc] external one : out_field_element -> unit = "mc_np384_one" [@@noalloc] external from_bytes : out_field_element -> string -> unit = "mc_np384_from_bytes" [@@noalloc] external to_bytes : bytes -> field_element -> unit = "mc_np384_to_bytes" [@@noalloc] external from_montgomery : out_field_element -> field_element -> unit = "mc_np384_from_montgomery" [@@noalloc] external to_montgomery : out_field_element -> field_element -> unit = "mc_np384_to_montgomery" [@@noalloc] end module P = Make_point(Params)(Foreign) module S = Make_scalar(Params)(P) module Dh = Make_dh(Params)(P)(S) module Fn = Make_Fn(Params)(Foreign_n) module Dsa = Make_dsa(Params)(Fn)(P)(S)(Digestif.SHA384) end module P521 : Dh_dsa = struct module Params = struct let a = "\x01\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFC" let b = "\x00\x51\x95\x3E\xB9\x61\x8E\x1C\x9A\x1F\x92\x9A\x21\xA0\xB6\x85\x40\xEE\xA2\xDA\x72\x5B\x99\xB3\x15\xF3\xB8\xB4\x89\x91\x8E\xF1\x09\xE1\x56\x19\x39\x51\xEC\x7E\x93\x7B\x16\x52\xC0\xBD\x3B\xB1\xBF\x07\x35\x73\xDF\x88\x3D\x2C\x34\xF1\xEF\x45\x1F\xD4\x6B\x50\x3F\x00" let g_x = "\x00\xC6\x85\x8E\x06\xB7\x04\x04\xE9\xCD\x9E\x3E\xCB\x66\x23\x95\xB4\x42\x9C\x64\x81\x39\x05\x3F\xB5\x21\xF8\x28\xAF\x60\x6B\x4D\x3D\xBA\xA1\x4B\x5E\x77\xEF\xE7\x59\x28\xFE\x1D\xC1\x27\xA2\xFF\xA8\xDE\x33\x48\xB3\xC1\x85\x6A\x42\x9B\xF9\x7E\x7E\x31\xC2\xE5\xBD\x66" let g_y = "\x01\x18\x39\x29\x6a\x78\x9a\x3b\xc0\x04\x5c\x8a\x5f\xb4\x2c\x7d\x1b\xd9\x98\xf5\x44\x49\x57\x9b\x44\x68\x17\xaf\xbd\x17\x27\x3e\x66\x2c\x97\xee\x72\x99\x5e\xf4\x26\x40\xc5\x50\xb9\x01\x3f\xad\x07\x61\x35\x3c\x70\x86\xa2\x72\xc2\x40\x88\xbe\x94\x76\x9f\xd1\x66\x50" let p = "\x01\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF" let n = "\x01\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFA\x51\x86\x87\x83\xBF\x2F\x96\x6B\x7F\xCC\x01\x48\xF7\x09\xA5\xD0\x3B\xB5\xC9\xB8\x89\x9C\x47\xAE\xBB\x6F\xB7\x1E\x91\x38\x64\x09" let pident = "\x01\x7f\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff" |> rev_string let byte_length = 66 let bit_length = 521 let fe_length = if Sys.word_size == 64 then 72 else 68 (* TODO: is this congruent with C code? *) let first_byte_bits = Some 0x01 end module Foreign = struct external mul : out_field_element -> field_element -> field_element -> unit = "mc_p521_mul" [@@noalloc] external sub : out_field_element -> field_element -> field_element -> unit = "mc_p521_sub" [@@noalloc] external add : out_field_element -> field_element -> field_element -> unit = "mc_p521_add" [@@noalloc] external to_montgomery : out_field_element -> field_element -> unit = "mc_p521_to_montgomery" [@@noalloc] external from_octets : out_field_element -> string -> unit = "mc_p521_from_bytes" [@@noalloc] external set_one : out_field_element -> unit = "mc_p521_set_one" [@@noalloc] external nz : field_element -> bool = "mc_p521_nz" [@@noalloc] external sqr : out_field_element -> field_element -> unit = "mc_p521_sqr" [@@noalloc] external from_montgomery : out_field_element -> field_element -> unit = "mc_p521_from_montgomery" [@@noalloc] external to_octets : bytes -> field_element -> unit = "mc_p521_to_bytes" [@@noalloc] external inv : out_field_element -> field_element -> unit = "mc_p521_inv" [@@noalloc] external select_c : out_field_element -> bool -> field_element -> field_element -> unit = "mc_p521_select" [@@noalloc] external double_c : out_point -> point -> unit = "mc_p521_point_double" [@@noalloc] external add_c : out_point -> point -> point -> unit = "mc_p521_point_add" [@@noalloc] external scalar_mult_base_c : out_point -> string -> unit = "mc_p521_scalar_mult_base" [@@noalloc] end module Foreign_n = struct external mul : out_field_element -> field_element -> field_element -> unit = "mc_np521_mul" [@@noalloc] external add : out_field_element -> field_element -> field_element -> unit = "mc_np521_add" [@@noalloc] external inv : out_field_element -> field_element -> unit = "mc_np521_inv" [@@noalloc] external one : out_field_element -> unit = "mc_np521_one" [@@noalloc] external from_bytes : out_field_element -> string -> unit = "mc_np521_from_bytes" [@@noalloc] external to_bytes : bytes -> field_element -> unit = "mc_np521_to_bytes" [@@noalloc] external from_montgomery : out_field_element -> field_element -> unit = "mc_np521_from_montgomery" [@@noalloc] external to_montgomery : out_field_element -> field_element -> unit = "mc_np521_to_montgomery" [@@noalloc] end module P = Make_point(Params)(Foreign) module S = Make_scalar(Params)(P) module Dh = Make_dh(Params)(P)(S) module Fn = Make_Fn(Params)(Foreign_n) module Dsa = Make_dsa(Params)(Fn)(P)(S)(Digestif.SHA512) end module X25519 = struct (* RFC 7748 *) external x25519_scalar_mult_generic : bytes -> string -> string -> unit = "mc_x25519_scalar_mult_generic" [@@noalloc] let key_len = 32 let scalar_mult in_ base = let out = Bytes.create key_len in x25519_scalar_mult_generic out in_ base; Bytes.unsafe_to_string out type secret = string let basepoint = String.init key_len (function 0 -> '\009' | _ -> '\000') let public priv = scalar_mult priv basepoint let gen_key ?compress:_ ?g () = let secret = Mirage_crypto_rng.generate ?g key_len in secret, public secret let secret_of_octets ?compress:_ s = if String.length s = key_len then Ok (s, public s) else Error `Invalid_length let secret_to_octets s = s let is_zero = let zero = String.make key_len '\000' in fun buf -> String.equal zero buf let key_exchange secret public = if String.length public = key_len then let res = scalar_mult secret public in if is_zero res then Error `Low_order else Ok res else Error `Invalid_length end module Ed25519 = struct external scalar_mult_base_to_bytes : bytes -> string -> unit = "mc_25519_scalar_mult_base" [@@noalloc] external reduce_l : bytes -> unit = "mc_25519_reduce_l" [@@noalloc] external muladd : bytes -> string -> string -> string -> unit = "mc_25519_muladd" [@@noalloc] external double_scalar_mult : bytes -> string -> string -> string -> bool = "mc_25519_double_scalar_mult" [@@noalloc] external pub_ok : string -> bool = "mc_25519_pub_ok" [@@noalloc] let key_len = 32 let scalar_mult_base_to_bytes p = let tmp = Bytes.create key_len in scalar_mult_base_to_bytes tmp p; Bytes.unsafe_to_string tmp let muladd a b c = let tmp = Bytes.create key_len in muladd tmp a b c; Bytes.unsafe_to_string tmp let double_scalar_mult a b c = let tmp = Bytes.create key_len in let s = double_scalar_mult tmp a b c in s, Bytes.unsafe_to_string tmp type pub = string type priv = string let sha512 datas = let open Digestif.SHA512 in let buf = Bytes.create digest_size in let ctx = List.fold_left (feed_string ?off:None ?len:None) empty datas in get_into_bytes ctx buf; buf (* RFC 8032 *) let public secret = (* section 5.1.5 *) (* step 1 *) let h = sha512 [ secret ] in (* step 2 *) let s, rest = Bytes.sub h 0 key_len, Bytes.unsafe_to_string (Bytes.sub h key_len (Bytes.length h - key_len)) in Bytes.set_uint8 s 0 ((Bytes.get_uint8 s 0) land 248); Bytes.set_uint8 s 31 (((Bytes.get_uint8 s 31) land 127) lor 64); let s = Bytes.unsafe_to_string s in (* step 3 and 4 *) let public = scalar_mult_base_to_bytes s in public, (s, rest) let pub_of_priv secret = fst (public secret) let priv_of_octets buf = if String.length buf = key_len then Ok buf else Error `Invalid_length let priv_to_octets (priv : priv) = priv let pub_of_octets buf = if String.length buf = key_len then if pub_ok buf then Ok buf else Error `Not_on_curve else Error `Invalid_length let pub_to_octets pub = pub let generate ?g () = let secret = Mirage_crypto_rng.generate ?g key_len in secret, pub_of_priv secret let sign ~key msg = (* section 5.1.6 *) let pub, (s, prefix) = public key in let r = sha512 [ prefix; msg ] in reduce_l r; let r = Bytes.unsafe_to_string r in let r_big = scalar_mult_base_to_bytes r in let k = sha512 [ r_big; pub; msg] in reduce_l k; let k = Bytes.unsafe_to_string k in let s_out = muladd k s r in let res = Bytes.create (key_len + key_len) in Bytes.unsafe_blit_string r_big 0 res 0 key_len ; Bytes.unsafe_blit_string s_out 0 res key_len key_len ; Bytes.unsafe_to_string res let verify ~key signature ~msg = (* section 5.1.7 *) if String.length signature = 2 * key_len then let r, s = String.sub signature 0 key_len, String.sub signature key_len key_len in let s_smaller_l = (* check s within 0 <= s < L *) let s' = Bytes.make (key_len * 2) '\000' in Bytes.unsafe_blit_string s 0 s' 0 key_len; reduce_l s'; let s' = Bytes.unsafe_to_string s' in let s'' = s ^ String.make key_len '\000' in String.equal s'' s' in if s_smaller_l then begin let k = sha512 [ r ; key ; msg ] in reduce_l k; let k = Bytes.unsafe_to_string k in let success, r' = double_scalar_mult k key s in success && String.equal r r' end else false else false end