package cid

  1. Overview
  2. Docs
Legend:
Page
Library
Module
Module type
Parameter
Class
Class type
Source

Source file cid.ml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
include Cid_intf

module Make (Md : Multihash.S) = struct
  type multihash = Cstruct.t Md.t

  (* Compatible with Multicodec.ipld *)

  let version_string = function
    | `Cidv0 -> "Cidv0"
    | (`Cidv1 | `Cidv2 | `Cidv3) as v -> Multicodec.cid_to_string v

  let version_of_ipld = function
    | (`Cidv1 | `Cidv2 | `Cidv3) as v -> v
    | _ -> invalid_arg "Expected a CID version"

  type t = {
    version : version;
    base : Multibase.Encoding.t;
    codec : Multicodec.t;
    hash : Cstruct.t Md.t;
  }

  let v ~version ~base ~codec ~hash = { version; base; codec; hash }
  let version t = t.version
  let base t = t.base
  let codec t = t.codec
  let hash t = t.hash

  let equal a b =
    a.version = b.version && a.base = b.base && a.codec = b.codec
    && Md.equal a.hash b.hash

  let cidv0_of_string ~base buf =
    match Md.read_buff buf with
    | Ok hash -> { version = `Cidv0; base; codec = `Dag_pb; hash }
    | Error (`Msg m) -> failwith ("Failed parsing Cidv0: " ^ m)

  let of_cstruct ~base buf =
    let l = Cstruct.length buf in
    if
      l = 34 && Cstruct.get_uint8 buf 0 = 0x12 && Cstruct.get_uint8 buf 1 = 0x20
    then Ok (cidv0_of_string ~base buf)
    else
      let v, off = Multihash.Uvarint.decode buf in
      let c, off' = Multihash.Uvarint.decode Cstruct.(sub buf off (l - off)) in
      match Md.read_buff Cstruct.(sub buf (off + off') (l - off - off')) with
      | Ok hash ->
          let version =
            version_of_ipld (Option.get @@ Multicodec.cid_of_code v)
          in
          let codec = Option.get @@ Multicodec.of_code c in
          let v = Ok { version; codec; base; hash } in
          (v
            :> ( t,
                 [ `Msg of string | `Unsupported of Multibase.Encoding.t ] )
               result)
      | Error _ as e ->
          (e
            :> ( t,
                 [ `Msg of string | `Unsupported of Multibase.Encoding.t ] )
               result)

  let ( <+> ) = Cstruct.append

  let to_cstruct { version; base; codec; hash } =
    match version with
    | `Cidv0 -> (
        match base with
        | `Base58btc ->
            let hash = Md.write hash in
            let b = Multibase.Base58.encode (Cstruct.to_string hash) in
            Cstruct.of_string b
        | _ ->
            let hash = Md.write hash in
            let b =
              Multibase.encode base (Cstruct.to_string hash) |> Result.get_ok
            in
            Cstruct.of_string b)
    | (`Cidv1 | `Cidv2 | `Cidv3) as version ->
        let enc =
          (* TODO: when dropping support of older compilers, we can change to String.get_uint8 *)
          Multibase.Encoding.to_code base |> Bytes.of_string |> fun s ->
          Bytes.get_uint8 s 0
        in
        let ver =
          Multicodec.cid_to_code (version :> Multicodec.cid)
          |> Multihash.Uvarint.encode
        in
        let cod = Multicodec.to_code codec |> Multihash.Uvarint.encode in
        let has = Md.write hash in
        let buf = Cstruct.create 1 in
        Cstruct.set_uint8 buf 0 enc;
        buf <+> ver <+> cod <+> has

  let fail_encoding = function
    | Error (`Msg s) -> failwith s
    | Error (`Unsupported b) ->
        failwith ("Unsupported encoding: " ^ Multibase.Encoding.to_string b)
    | Ok v -> v

  let to_string t =
    let buf = to_cstruct t in
    if t.version = `Cidv0 then Cstruct.to_string buf
    else
      let data = Cstruct.(to_string (sub buf 1 (length buf - 1))) in
      Multibase.encode t.base data |> fail_encoding

  let of_string s =
    if String.length s = 46 && s.[0] = 'Q' && s.[1] = 'm' then
      let v =
        of_cstruct ~base:`Base58btc
          (Cstruct.of_string @@ Multibase.Base58.decode s)
      in
      (v
        :> (t, [ `Msg of string | `Unsupported of Multibase.Encoding.t ]) result)
    else
      match Multibase.decode s with
      | Ok (base, s) ->
          let v = of_cstruct ~base (Cstruct.of_string s) in
          (v
            :> ( t,
                 [ `Msg of string | `Unsupported of Multibase.Encoding.t ] )
               result)
      | Error _ as e -> e

  let pp_human ppf { version; base; codec; hash } =
    Format.fprintf ppf "%s - %s - %s - %a" (version_string version)
      (Multibase.Encoding.to_string base)
      (Multicodec.to_string codec)
      Md.pp hash
end

include Make (Multihash_digestif)
OCaml

Innovation. Community. Security.