• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

MinaProtocol / mina / 767

04 Nov 2025 01:59PM UTC coverage: 32.374% (-4.5%) from 36.902%
767

push

buildkite

web-flow
Merge pull request #18063 from MinaProtocol/lyh/compat-into-dev-nov4-2025

Merge compatible into develop Nov. 4th 2025

87 of 228 new or added lines in 10 files covered. (38.16%)

3416 existing lines in 136 files now uncovered.

23591 of 72871 relevant lines covered (32.37%)

26590.67 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

3.62
/src/lib/transition_frontier/persistent_root/persistent_root.ml
1
open Core
123✔
2
open Mina_base
3
module Ledger = Mina_ledger.Ledger
4
open Frontier_base
5
module Ledger_transfer_any =
6
  Mina_ledger.Ledger_transfer.Make (Ledger.Any_ledger.M) (Ledger.Any_ledger.M)
7
module Root_ledger = Mina_ledger.Root
8

9
let genesis_root_identifier ~genesis_state_hash =
UNCOV
10
  let open Root_identifier.Stable.Latest in
×
11
  { state_hash = genesis_state_hash }
12

13
let with_file ?size filename access_level ~f =
UNCOV
14
  let open Unix in
×
15
  let shared, mode =
16
    match access_level with
UNCOV
17
    | `Read ->
×
18
        (false, [ O_RDONLY ])
UNCOV
19
    | `Write ->
×
20
        (true, [ O_RDWR; O_TRUNC; O_CREAT ])
21
  in
22
  let fd = Unix.openfile filename ~mode in
UNCOV
23
  let buf_size =
×
24
    match size with
UNCOV
25
    | None ->
×
UNCOV
26
        Int64.to_int_exn Unix.(fstat fd).st_size
×
UNCOV
27
    | Some sz ->
×
28
        sz
29
  in
30
  (* Bigstring.map_file has been removed. We copy its old implementation. *)
31
  let buf =
32
    Bigarray.(
UNCOV
33
      array1_of_genarray
×
UNCOV
34
        (Core.Unix.map_file fd char c_layout ~shared [| buf_size |]))
×
35
  in
36
  let x = f buf in
UNCOV
37
  Bigstring.unsafe_destroy buf ;
×
UNCOV
38
  Unix.close fd ;
×
UNCOV
39
  x
×
40

41
(* TODO: create a reusable singleton factory abstraction *)
42
module rec Instance_type : sig
43
  type t =
44
    { snarked_ledger : Root_ledger.t
45
    ; potential_snarked_ledgers : Root_ledger.Config.t Queue.t
46
    ; factory : Factory_type.t
47
    }
48
end =
49
  Instance_type
50

51
and Factory_type : sig
52
  type t =
53
    { directory : string
54
    ; logger : Logger.t
55
    ; mutable instance : Instance_type.t option
56
    ; ledger_depth : int
57
    ; backing_type : Root_ledger.Config.backing_type
58
    }
59
end =
60
  Factory_type
61

62
open Instance_type
63
open Factory_type
64

65
module Instance = struct
66
  type t = Instance_type.t
67

68
  module Config = struct
69
    (** Helper to create a filesystem location (for a file or directory) inside
70
        the [Factory_type.t] directory. *)
UNCOV
71
    let make_instance_location filename t = Filename.concat t.directory filename
×
72

73
    (** Helper to create a [Root_ledger.Config.t] for a snarked ledger based on a
74
        subdirectory of the [Factory_type.t] directory *)
75
    let make_instance_config subdirectory t =
UNCOV
76
      Root_ledger.Config.with_directory ~backing_type:t.backing_type
×
UNCOV
77
        ~directory_name:(make_instance_location subdirectory t)
×
78

79
    (** The config for the actual snarked ledger that is initialized and used by
80
        the daemon *)
81
    let snarked_ledger = make_instance_config "snarked_ledger"
123✔
82

83
    (** The config for the temporary snarked ledger, used while recovering a
84
        vaild potential snarked ledger during startup *)
85
    let tmp_snarked_ledger = make_instance_config "tmp_snarked_ledger"
123✔
86

87
    (** The name of a json file that lists the directory names of the potential
88
        snarked ledgers in the [potential_snarked_ledgers] queue *)
89
    let potential_snarked_ledgers =
90
      make_instance_location "potential_snarked_ledgers.json"
123✔
91

92
    (** A method that generates fresh potential snarked ledger configs, each
93
        using a distinct root subdirectory *)
94
    let make_potential_snarked_ledger t =
95
      let uuid = Uuid_unix.create () in
×
96
      make_instance_config ("snarked_ledger" ^ Uuid.to_string_hum uuid) t
×
97

98
    (** The name of the file recording the [Root_identifier.t] of the snarked
99
        root *)
100
    let root_identifier = make_instance_location "root"
123✔
101
  end
102

103
  let potential_snarked_ledgers_to_yojson queue =
104
    `List (List.map (Queue.to_list queue) ~f:Root_ledger.Config.to_yojson)
×
105

106
  let potential_snarked_ledgers_of_yojson json =
107
    Yojson.Safe.Util.to_list json
×
108
    |> List.map ~f:(fun json ->
109
           Root_ledger.Config.of_yojson json |> Result.ok_or_failwith )
×
110

111
  let load_potential_snarked_ledgers_from_disk factory =
UNCOV
112
    let location = Config.potential_snarked_ledgers factory in
×
UNCOV
113
    if phys_equal (Sys.file_exists location) `Yes then
×
114
      Yojson.Safe.from_file location |> potential_snarked_ledgers_of_yojson
×
UNCOV
115
    else []
×
116

117
  let write_potential_snarked_ledgers_to_disk t =
118
    Yojson.Safe.to_file
×
119
      (Config.potential_snarked_ledgers t.factory)
×
120
      (potential_snarked_ledgers_to_yojson t.potential_snarked_ledgers)
×
121

122
  let enqueue_snarked_ledger ~config t =
123
    Queue.enqueue t.potential_snarked_ledgers config ;
×
124
    write_potential_snarked_ledgers_to_disk t
×
125

126
  let dequeue_snarked_ledger t =
127
    let config = Queue.dequeue_exn t.potential_snarked_ledgers in
×
128
    Root_ledger.Config.delete_any_backing config ;
×
129
    write_potential_snarked_ledgers_to_disk t
×
130

131
  let destroy t =
132
    List.iter
×
133
      (Queue.to_list t.potential_snarked_ledgers)
×
134
      ~f:Root_ledger.Config.delete_any_backing ;
135
    Mina_stdlib_unix.File_system.rmrf
×
136
      (Config.potential_snarked_ledgers t.factory) ;
×
137
    Root_ledger.close t.snarked_ledger ;
×
138
    t.factory.instance <- None
×
139

140
  let close t =
UNCOV
141
    Root_ledger.close t.snarked_ledger ;
×
UNCOV
142
    t.factory.instance <- None
×
143

144
  let create ~logger factory =
UNCOV
145
    let snarked_ledger =
×
146
      Root_ledger.create ~logger ~depth:factory.ledger_depth
UNCOV
147
        ~config:(Config.snarked_ledger factory)
×
148
        ()
149
    in
UNCOV
150
    { snarked_ledger; potential_snarked_ledgers = Queue.create (); factory }
×
151

152
  (** When we load from disk,
153
      1. Check the potential_snarked_ledgers to see if any one of these
154
         matches the snarked_ledger_hash in persistent_frontier;
155
      2. if none of those works, we load the old snarked_ledger and check if
156
         the old snarked_ledger matches with persistent_frontier;
157
      3. if not, we just reset all the persisted data and start from genesis
158
   *)
159
  let load_from_disk factory ~snarked_ledger_hash ~logger =
UNCOV
160
    let potential_snarked_ledgers =
×
161
      load_potential_snarked_ledgers_from_disk factory
162
    in
UNCOV
163
    let snarked_ledger =
×
164
      List.fold_until potential_snarked_ledgers ~init:None
165
        ~f:(fun _ config ->
166
          let potential_snarked_ledger =
×
167
            Root_ledger.create ~logger ~depth:factory.ledger_depth ~config ()
168
          in
169
          let potential_snarked_ledger_hash =
×
170
            Frozen_ledger_hash.of_ledger_hash
171
            @@ Root_ledger.merkle_root potential_snarked_ledger
×
172
          in
173
          [%log debug]
×
174
            ~metadata:
175
              [ ( "potential_snarked_ledger_hash"
176
                , Frozen_ledger_hash.to_yojson potential_snarked_ledger_hash )
×
177
              ]
178
            "loaded potential_snarked_ledger from disk" ;
179
          if
×
180
            Frozen_ledger_hash.equal potential_snarked_ledger_hash
181
              snarked_ledger_hash
182
          then (
×
183
            let snarked_ledger =
184
              Root_ledger.create ~logger ~depth:factory.ledger_depth
185
                ~config:(Config.tmp_snarked_ledger factory)
×
186
                ()
187
            in
188
            match
×
189
              Ledger_transfer_any.transfer_accounts
190
                ~src:(Root_ledger.as_unmasked potential_snarked_ledger)
×
191
                ~dest:(Root_ledger.as_unmasked snarked_ledger)
×
192
            with
193
            | Ok _ ->
×
194
                Root_ledger.close potential_snarked_ledger ;
195
                Root_ledger.Config.delete_any_backing
×
196
                @@ Config.snarked_ledger factory ;
×
197
                Root_ledger.Config.move_backing_exn
×
198
                  ~src:(Config.tmp_snarked_ledger factory)
×
199
                  ~dst:(Config.snarked_ledger factory) ;
×
200
                List.iter potential_snarked_ledgers
201
                  ~f:Root_ledger.Config.delete_any_backing ;
202
                Mina_stdlib_unix.File_system.rmrf
×
203
                  (Config.potential_snarked_ledgers factory) ;
×
204
                Stop (Some snarked_ledger)
×
205
            | Error e ->
×
206
                Root_ledger.close potential_snarked_ledger ;
207
                List.iter potential_snarked_ledgers
×
208
                  ~f:Root_ledger.Config.delete_any_backing ;
209
                Mina_stdlib_unix.File_system.rmrf
×
210
                  (Config.potential_snarked_ledgers factory) ;
×
211
                [%log' error factory.logger]
×
212
                  ~metadata:[ ("error", `String (Error.to_string_hum e)) ]
×
213
                  "Ledger_transfer failed" ;
214
                Stop None )
×
215
          else (
×
216
            Root_ledger.close potential_snarked_ledger ;
217
            Continue None ) )
×
218
        ~finish:(fun _ ->
UNCOV
219
          List.iter potential_snarked_ledgers
×
220
            ~f:Root_ledger.Config.delete_any_backing ;
UNCOV
221
          Mina_stdlib_unix.File_system.rmrf
×
UNCOV
222
            (Config.potential_snarked_ledgers factory) ;
×
UNCOV
223
          None )
×
224
    in
UNCOV
225
    match snarked_ledger with
×
UNCOV
226
    | None ->
×
227
        let snarked_ledger =
228
          Root_ledger.create ~logger ~depth:factory.ledger_depth
UNCOV
229
            ~config:(Config.snarked_ledger factory)
×
230
            ()
231
        in
UNCOV
232
        let potential_snarked_ledger_hash =
×
233
          Frozen_ledger_hash.of_ledger_hash
UNCOV
234
          @@ Root_ledger.merkle_root snarked_ledger
×
235
        in
UNCOV
236
        if
×
237
          Frozen_ledger_hash.equal potential_snarked_ledger_hash
238
            snarked_ledger_hash
239
        then
UNCOV
240
          Ok
×
241
            { snarked_ledger
UNCOV
242
            ; potential_snarked_ledgers = Queue.create ()
×
243
            ; factory
244
            }
245
        else (
×
246
          Root_ledger.close snarked_ledger ;
247
          Error `Snarked_ledger_mismatch )
×
248
    | Some snarked_ledger ->
×
249
        Ok
250
          { snarked_ledger
251
          ; potential_snarked_ledgers = Queue.create ()
×
252
          ; factory
253
          }
254

UNCOV
255
  let snarked_ledger { snarked_ledger; _ } = snarked_ledger
×
256

257
  let set_root_identifier t new_root_identifier =
UNCOV
258
    [%log' trace t.factory.logger]
×
259
      ~metadata:
UNCOV
260
        [ ("root_identifier", Root_identifier.to_yojson new_root_identifier) ]
×
261
      "Setting persistent root identifier" ;
UNCOV
262
    let size = Root_identifier.Stable.Latest.bin_size_t new_root_identifier in
×
UNCOV
263
    with_file (Config.root_identifier t.factory) `Write ~size ~f:(fun buf ->
×
UNCOV
264
        ignore
×
UNCOV
265
          ( Root_identifier.Stable.Latest.bin_write_t buf ~pos:0
×
266
              new_root_identifier
267
            : int ) )
268

269
  (* defaults to genesis *)
270
  let load_root_identifier t =
UNCOV
271
    let file = Config.root_identifier t.factory in
×
UNCOV
272
    match Unix.access file [ `Exists; `Read ] with
×
273
    | Error _ ->
×
274
        None
UNCOV
275
    | Ok () ->
×
276
        with_file file `Read ~f:(fun buf ->
UNCOV
277
            let root_identifier =
×
278
              Root_identifier.Stable.Latest.bin_read_t buf ~pos_ref:(ref 0)
279
            in
UNCOV
280
            [%log' trace t.factory.logger]
×
281
              ~metadata:
UNCOV
282
                [ ("root_identifier", Root_identifier.to_yojson root_identifier)
×
283
                ]
284
              "Loaded persistent root identifier" ;
UNCOV
285
            Some root_identifier )
×
286

287
  let set_root_state_hash t state_hash = set_root_identifier t { state_hash }
×
288
end
289

290
type t = Factory_type.t
291

292
let create ~logger ~directory ~backing_type ~ledger_depth =
UNCOV
293
  { directory; logger; instance = None; ledger_depth; backing_type }
×
294

295
let create_instance_exn t =
UNCOV
296
  assert (Option.is_none t.instance) ;
×
297
  let instance = Instance.create ~logger:t.logger t in
UNCOV
298
  t.instance <- Some instance ;
×
299
  instance
300

301
let load_from_disk_exn t ~snarked_ledger_hash ~logger =
UNCOV
302
  let open Result.Let_syntax in
×
UNCOV
303
  assert (Option.is_none t.instance) ;
×
UNCOV
304
  let%map instance = Instance.load_from_disk t ~snarked_ledger_hash ~logger in
×
UNCOV
305
  t.instance <- Some instance ;
×
306
  instance
307

308
let with_instance_exn t ~f =
UNCOV
309
  let instance = create_instance_exn t in
×
UNCOV
310
  let x = f instance in
×
UNCOV
311
  Instance.close instance ; x
×
312

313
(** Clear the factory directory and recreate the snarked ledger instance for
314
    this factory with [create_root] and [setup] *)
315
let reset_factory_root_exn t ~create_root ~setup =
UNCOV
316
  let open Async.Deferred.Let_syntax in
×
UNCOV
317
  assert (Option.is_none t.instance) ;
×
318
  (* Certain database initialization methods, e.g. creation from a checkpoint,
319
     depend on the parent directory existing and the target directory _not_
320
     existing. *)
UNCOV
321
  let%bind () = Mina_stdlib_unix.File_system.remove_dir t.directory in
×
UNCOV
322
  let%map () = Mina_stdlib_unix.File_system.create_dir t.directory in
×
UNCOV
323
  let root =
×
UNCOV
324
    create_root
×
UNCOV
325
      ~config:(Instance.Config.snarked_ledger t)
×
326
      ~depth:t.ledger_depth ()
327
    |> Or_error.ok_exn
328
  in
UNCOV
329
  Root_ledger.close root ;
×
UNCOV
330
  with_instance_exn t ~f:setup
×
331

332
let reset_to_genesis_exn t ~precomputed_values =
UNCOV
333
  let open Async.Deferred.Let_syntax in
×
334
  let logger = t.logger in
UNCOV
335
  [%log debug] "Resetting snarked_root in $directory to genesis"
×
336
    ~metadata:[ ("directory", `String t.directory) ] ;
337
  let%map () =
UNCOV
338
    reset_factory_root_exn t
×
UNCOV
339
      ~create_root:(Precomputed_values.create_root precomputed_values)
×
340
      ~setup:(fun instance ->
UNCOV
341
        Instance.set_root_identifier instance
×
342
          (genesis_root_identifier
343
             ~genesis_state_hash:
UNCOV
344
               (Precomputed_values.genesis_state_hashes precomputed_values)
×
345
                 .state_hash ) )
346
  in
UNCOV
347
  [%log debug] "Finished resetting snarked_root to genesis"
×
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc