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

MinaProtocol / mina / 499

20 Aug 2025 06:34PM UTC coverage: 33.256% (+0.01%) from 33.242%
499

push

buildkite

web-flow
Merge pull request #17641 from MinaProtocol/lyh/improve-genesis-ledger-creation

Improve Genesis Ledger Creation

10 of 30 new or added lines in 9 files covered. (33.33%)

1219 existing lines in 13 files now uncovered.

24095 of 72454 relevant lines covered (33.26%)

24752.12 hits per line

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

0.26
/src/app/cli/src/init/mina_run.ml
1
open Core
49✔
2
open Async
3
module Graphql_cohttp_async =
4
  Graphql_internal.Make (Graphql_async.Schema) (Cohttp_async.Io)
5
    (Cohttp_async.Body)
6

7
let snark_job_list_json t =
8
  let open Participating_state.Let_syntax in
×
9
  let%map sl = Mina_lib.best_staged_ledger t in
×
10
  Staged_ledger.Scan_state.snark_job_list_json (Staged_ledger.scan_state sl)
×
11

12
let snark_pool_list t =
13
  Mina_lib.snark_pool t |> Network_pool.Snark_pool.resource_pool
×
14
  |> Network_pool.Snark_pool.Resource_pool.snark_pool_json
×
15
  |> Yojson.Safe.to_string
16

17
(* create reader, writer for protocol versions, but really for any one-line item in conf_dir *)
18
let make_conf_dir_item_io ~conf_dir ~filename =
19
  let item_file = conf_dir ^/ filename in
×
20
  let read_item () =
×
21
    let open Stdlib in
×
22
    let inp = open_in item_file in
23
    let res = input_line inp in
×
24
    close_in inp ; res
×
25
  in
26
  let write_item item =
27
    let open Stdlib in
×
28
    let outp = open_out item_file in
29
    output_string outp (item ^ "\n") ;
×
30
    close_out outp
×
31
  in
32
  (read_item, write_item)
33

34
let get_proposed_protocol_version_opt ~conf_dir ~logger =
35
  let read_protocol_version, write_protocol_version =
×
36
    make_conf_dir_item_io ~conf_dir ~filename:"proposed_protocol_version"
37
  in
38
  function
39
  | None -> (
×
40
      try
41
        (* not provided on command line, try to read from config dir *)
42
        let protocol_version = read_protocol_version () in
43
        [%log info]
×
44
          "Setting proposed protocol version to $protocol_version from config"
45
          ~metadata:[ ("protocol_version", `String protocol_version) ] ;
46
        Some (Protocol_version.of_string_exn protocol_version)
×
47
      with Sys_error _ ->
×
48
        (* not on command-line, not in config dir, there's no proposed protocol version *)
49
        None )
50
  | Some protocol_version -> (
×
51
      let validate_cli_protocol_version protocol_version =
52
        if Option.is_none (Protocol_version.of_string_opt protocol_version) then (
×
53
          [%log fatal]
×
54
            "Proposed protocol version provided on command line is invalid"
55
            ~metadata:
56
              [ ("proposed_protocol_version", `String protocol_version) ] ;
57
          failwith "Proposed protocol version from command line is invalid" )
×
58
      in
59
      try
60
        (* overwrite if the command line value disagrees with the value in the config *)
61
        let config_protocol_version = read_protocol_version () in
62
        if String.equal config_protocol_version protocol_version then (
×
63
          [%log info]
×
64
            "Using proposed protocol version $protocol_version from command \
65
             line, which matches the one in the config"
66
            ~metadata:[ ("protocol_version", `String protocol_version) ] ;
67
          Some (Protocol_version.of_string_exn config_protocol_version) )
×
68
        else (
×
69
          validate_cli_protocol_version protocol_version ;
70
          write_protocol_version protocol_version ;
×
71
          [%log info]
×
72
            "Overwriting Mina config proposed protocol version \
73
             $config_proposed_protocol_version with proposed protocol version \
74
             $protocol_version from the command line"
75
            ~metadata:
76
              [ ( "config_proposed_protocol_version"
77
                , `String config_protocol_version )
78
              ; ("proposed_protocol_version", `String protocol_version)
79
              ] ;
80
          Some (Protocol_version.of_string_exn protocol_version) )
×
81
      with Sys_error _ ->
×
82
        (* use value provided on command line, write to config dir *)
83
        validate_cli_protocol_version protocol_version ;
84
        write_protocol_version protocol_version ;
×
85
        [%log info]
×
86
          "Using proposed protocol version from command line, writing to config"
87
          ~metadata:[ ("protocol_version", `String protocol_version) ] ;
88
        Some (Protocol_version.of_string_exn protocol_version) )
×
89

90
(*TODO check deferred now and copy theose files to the temp directory*)
91
let log_shutdown ~conf_dir ~top_logger coda_ref =
92
  let logger =
×
93
    Logger.extend top_logger
94
      [ ("coda_run", `String "Logging state before program ends") ]
95
  in
96
  let frontier_file = conf_dir ^/ "frontier.dot" in
×
97
  let mask_file = conf_dir ^/ "registered_masks.dot" in
×
98
  (* ledger visualization *)
99
  [%log debug] "%s" (Visualization_message.success "registered masks" mask_file) ;
×
100
  Mina_ledger.Ledger.Debug.visualize ~filename:mask_file ;
×
101
  match !coda_ref with
102
  | None ->
×
103
      [%log warn]
×
104
        "Shutdown before Mina instance was created, not saving a visualization"
105
  | Some t -> (
×
106
      (*Transition frontier visualization*)
107
      match Mina_lib.visualize_frontier ~filename:frontier_file t with
108
      | `Active () ->
×
109
          [%log debug] "%s"
×
110
            (Visualization_message.success "transition frontier" frontier_file)
×
111
      | `Bootstrapping ->
×
112
          [%log debug] "%s"
×
113
            (Visualization_message.bootstrap "transition frontier") )
×
114

115
let remove_prev_crash_reports ~conf_dir =
116
  Core.Sys.command (sprintf "rm -rf %s/coda_crash_report*" conf_dir)
×
117

118
let summary exn_json =
119
  let uname = Core.Unix.uname () in
×
120
  let daemon_command =
×
121
    sprintf !"Command: %{sexp: string array}" (Sys.get_argv ())
×
122
  in
123
  `Assoc
×
124
    [ ("OS_type", `String Sys.os_type)
125
    ; ("Release", `String (Core.Unix.Utsname.release uname))
×
126
    ; ("Machine", `String (Core.Unix.Utsname.machine uname))
×
127
    ; ("Sys_name", `String (Core.Unix.Utsname.sysname uname))
×
128
    ; ("Exception", exn_json)
129
    ; ("Command", `String daemon_command)
130
    ; ("Coda_commit", `String Mina_version.commit_id)
131
    ]
132

133
let coda_status coda_ref =
134
  Option.value_map coda_ref
×
135
    ~default:
136
      (Deferred.return (`String "Shutdown before Mina instance was created"))
×
137
    ~f:(fun t ->
138
      Mina_commands.get_status ~flag:`Performance t
×
139
      >>| Daemon_rpcs.Types.Status.to_yojson )
140

141
let make_report exn_json ~conf_dir ~top_logger coda_ref =
142
  (* TEMP MAKE REPORT TRACE *)
143
  [%log' trace top_logger] "make_report: enter" ;
×
144
  ignore (remove_prev_crash_reports ~conf_dir : int) ;
×
145
  let crash_time = Time.to_filename_string ~zone:Time.Zone.utc (Time.now ()) in
×
146
  let temp_config = conf_dir ^/ "coda_crash_report_" ^ crash_time in
×
147
  let () = Core.Unix.mkdir temp_config in
×
148
  (*Transition frontier and ledger visualization*)
149
  log_shutdown ~conf_dir:temp_config ~top_logger coda_ref ;
×
150
  let report_file = temp_config ^ ".tar.gz" in
×
151
  (*Coda status*)
152
  let status_file = temp_config ^/ "coda_status.json" in
153
  let%map status = coda_status !coda_ref in
×
154
  Yojson.Safe.to_file status_file status ;
×
155
  (* TEMP MAKE REPORT TRACE *)
156
  [%log' trace top_logger] "make_report: acquired and wrote status" ;
×
157
  (*coda logs*)
158
  let coda_log = conf_dir ^/ "mina.log" in
×
159
  let () =
×
160
    match Core.Sys.file_exists coda_log with
161
    | `Yes ->
×
162
        let coda_short_log = temp_config ^/ "coda_short.log" in
163
        (*get the last 4MB of the log*)
164
        let log_size = 4 * 1024 * 1024 |> Int64.of_int in
×
165
        let log =
×
166
          In_channel.with_file coda_log ~f:(fun in_chan ->
167
              let len = In_channel.length in_chan in
×
168
              In_channel.seek in_chan
×
169
                Int64.(max 0L (Int64.( + ) len (Int64.neg log_size))) ;
×
170
              In_channel.input_all in_chan )
×
171
        in
172
        Out_channel.write_all coda_short_log ~data:log
×
173
    | _ ->
×
174
        ()
175
  in
176
  (*System info/crash summary*)
177
  let summary = summary exn_json in
178
  Yojson.Safe.to_file (temp_config ^/ "crash_summary.json") summary ;
×
179
  (*copy daemon_json to the temp dir *)
180
  let daemon_config = conf_dir ^/ "daemon.json" in
×
181
  let eq = [%equal: [ `Yes | `Unknown | `No ]] in
×
182
  let () =
183
    if eq (Core.Sys.file_exists daemon_config) `Yes then
×
184
      ignore
×
185
        ( Core.Sys.command
×
186
            (sprintf "cp %s %s" daemon_config (temp_config ^/ "daemon.json"))
×
187
          : int )
188
  in
189
  (*Zip them all up*)
190
  let tmp_files =
191
    [ "coda_short.log"
192
    ; "registered_mask.dot"
193
    ; "frontier.dot"
194
    ; "coda_status.json"
195
    ; "crash_summary.json"
196
    ; "daemon.json"
197
    ]
198
    |> List.filter ~f:(fun f ->
199
           eq (Core.Sys.file_exists (temp_config ^/ f)) `Yes )
×
200
  in
201
  let files = tmp_files |> String.concat ~sep:" " in
×
202
  let tar_command =
×
203
    sprintf "tar  -C %s -czf %s %s" temp_config report_file files
204
  in
205
  let exit = Core.Sys.command tar_command in
×
206
  if exit = 2 then (
×
207
    [%log' fatal top_logger] "Error making the crash report. Exit code: %d" exit ;
×
208
    None )
×
209
  else Some (report_file, temp_config)
×
210

211
(* TODO: handle participation_status more appropriately than doing participate_exn *)
212
let setup_local_server ?(client_trustlist = []) ?rest_server_port
×
213
    ?limited_graphql_port ?itn_graphql_port ?auth_keys
214
    ?(open_limited_graphql_port = false) ?(insecure_rest_server = false) mina =
×
215
  let compile_config = (Mina_lib.config mina).compile_config in
×
216
  let itn_features = (Mina_lib.config mina).itn_features in
×
217
  let client_trustlist =
218
    ref
219
      (Unix.Cidr.Set.of_list
×
220
         ( Unix.Cidr.create ~base_address:Unix.Inet_addr.localhost ~bits:8
221
         :: client_trustlist ) )
222
  in
223
  (* Setup RPC server for client interactions *)
224
  let implement rpc f =
225
    Rpc.Rpc.implement rpc (fun () input ->
×
226
        O1trace.thread ("serve_" ^ Rpc.Rpc.name rpc) (fun () -> f () input) )
×
227
  in
228
  let implement_notrace = Rpc.Rpc.implement in
229
  let logger =
230
    Logger.extend
231
      (Mina_lib.top_level_logger mina)
×
232
      [ ("mina_run", `String "Setting up server logs") ]
233
  in
234
  let client_impls =
×
235
    [ implement Daemon_rpcs.Send_user_commands.rpc (fun () ts ->
×
236
          Deferred.map
×
237
            ( Mina_commands.setup_and_submit_user_commands mina ts
×
238
            |> Participating_state.to_deferred_or_error )
×
239
            ~f:Or_error.join )
240
    ; implement Daemon_rpcs.Send_zkapp_commands.rpc (fun () zkapps ->
×
241
          Deferred.map
×
242
            ( Mina_commands.setup_and_submit_zkapp_commands mina zkapps
×
243
            |> Participating_state.to_deferred_or_error )
×
244
            ~f:Or_error.join )
245
    ; implement Daemon_rpcs.Get_balance.rpc (fun () aid ->
×
246
          return
×
247
            ( Mina_commands.get_balance mina aid
×
248
            |> Participating_state.active_error ) )
×
249
    ; implement Daemon_rpcs.Get_trust_status.rpc (fun () ip_address ->
×
250
          return (Mina_commands.get_trust_status mina ip_address) )
×
251
    ; implement Daemon_rpcs.Get_trust_status_all.rpc (fun () () ->
×
252
          return (Mina_commands.get_trust_status_all mina) )
×
253
    ; implement Daemon_rpcs.Reset_trust_status.rpc (fun () ip_address ->
×
254
          return (Mina_commands.reset_trust_status mina ip_address) )
×
255
    ; implement Daemon_rpcs.Chain_id_inputs.rpc (fun () () ->
×
256
          return (Mina_commands.chain_id_inputs mina) )
×
257
    ; implement Daemon_rpcs.Verify_proof.rpc (fun () (aid, tx, proof) ->
×
258
          return
×
259
            ( Mina_commands.verify_payment mina aid tx proof
×
260
            |> Participating_state.active_error |> Or_error.join ) )
×
261
    ; implement Daemon_rpcs.Get_public_keys_with_details.rpc (fun () () ->
×
262
          let%map keys = Mina_commands.get_keys_with_details mina in
×
263
          Participating_state.active_error keys )
×
264
    ; implement Daemon_rpcs.Get_public_keys.rpc (fun () () ->
×
265
          let%map keys = Mina_commands.get_public_keys mina in
×
266
          Participating_state.active_error keys )
×
267
    ; implement Daemon_rpcs.Get_nonce.rpc (fun () aid ->
×
268
          return
×
269
            ( Mina_commands.get_nonce mina aid
×
270
            |> Participating_state.active_error ) )
×
271
    ; implement Daemon_rpcs.Get_inferred_nonce.rpc (fun () aid ->
×
272
          return
×
273
            ( Mina_lib.get_inferred_nonce_from_transaction_pool_and_ledger mina
×
274
                aid
275
            |> Participating_state.active_error ) )
×
276
    ; implement_notrace Daemon_rpcs.Get_status.rpc (fun () flag ->
×
277
          Mina_commands.get_status ~flag mina )
×
278
    ; implement Daemon_rpcs.Clear_hist_status.rpc (fun () flag ->
×
279
          Mina_commands.clear_hist_status ~flag mina )
×
280
    ; implement Daemon_rpcs.Get_ledger.rpc (fun () lh ->
×
281
          Mina_lib.get_ledger mina lh )
×
282
    ; implement Daemon_rpcs.Get_snarked_ledger.rpc (fun () lh ->
×
283
          Mina_lib.get_snarked_ledger mina lh )
×
284
    ; implement Daemon_rpcs.Get_staking_ledger.rpc (fun () which ->
×
285
          let ledger_or_error =
×
286
            match which with
287
            | Next ->
×
288
                Option.value_map (Mina_lib.next_epoch_ledger mina)
×
289
                  ~default:
290
                    (Or_error.error_string "next staking ledger not available")
×
291
                  ~f:(function
292
                  | `Finalized ledger ->
×
293
                      Ok ledger
294
                  | `Notfinalized ->
×
295
                      Or_error.error_string
296
                        "next staking ledger is not finalized yet" )
297
            | Current ->
×
298
                Option.value_map
×
299
                  (Mina_lib.staking_ledger mina)
×
300
                  ~default:
301
                    (Or_error.error_string
×
302
                       "current staking ledger not available" )
303
                  ~f:Or_error.return
304
          in
305
          match ledger_or_error with
306
          | Ok ledger -> (
×
307
              match ledger with
308
              | Genesis_epoch_ledger l ->
×
NEW
309
                  let l_inner = Lazy.force @@ Genesis_ledger.Packed.t l in
×
NEW
310
                  let%map accts = Mina_ledger.Ledger.to_list l_inner in
×
311
                  Ok accts
×
312
              | Ledger_root l ->
×
313
                  let casted = Mina_ledger.Ledger.Root.as_unmasked l in
314
                  let%map accts =
315
                    Mina_ledger.Ledger.Any_ledger.M.to_list casted
×
316
                  in
317
                  Ok accts )
×
318
          | Error err ->
×
319
              return (Error err) )
320
    ; implement Daemon_rpcs.Stop_daemon.rpc (fun () () ->
×
321
          Scheduler.yield () >>= (fun () -> exit 0) |> don't_wait_for ;
×
322
          Deferred.unit )
×
323
    ; implement Daemon_rpcs.Snark_job_list.rpc (fun () () ->
×
324
          return (snark_job_list_json mina |> Participating_state.active_error) )
×
325
    ; implement Daemon_rpcs.Snark_pool_list.rpc (fun () () ->
×
326
          return (snark_pool_list mina) )
×
327
    ; implement Daemon_rpcs.Start_tracing.rpc (fun () () ->
×
328
          let open Mina_lib.Config in
×
329
          Mina_tracing.start (Mina_lib.config mina).conf_dir )
×
330
    ; implement Daemon_rpcs.Stop_tracing.rpc (fun () () ->
×
331
          Mina_tracing.stop () ; Deferred.unit )
×
332
    ; implement Daemon_rpcs.Start_internal_tracing.rpc (fun () () ->
×
333
          Internal_tracing.toggle ~commit_id:Mina_version.commit_id ~logger
×
334
            `Enabled )
335
    ; implement Daemon_rpcs.Stop_internal_tracing.rpc (fun () () ->
×
336
          Internal_tracing.toggle ~commit_id:Mina_version.commit_id ~logger
×
337
            `Disabled )
338
    ; implement Daemon_rpcs.Visualization.Frontier.rpc (fun () filename ->
×
339
          return (Mina_lib.visualize_frontier ~filename mina) )
×
340
    ; implement Daemon_rpcs.Visualization.Registered_masks.rpc
×
341
        (fun () filename ->
342
          return (Mina_ledger.Ledger.Debug.visualize ~filename) )
×
343
    ; implement Daemon_rpcs.Add_trustlist.rpc (fun () cidr ->
×
344
          return
×
345
            (let cidr_str = Unix.Cidr.to_string cidr in
346
             if Unix.Cidr.Set.mem !client_trustlist cidr then
×
347
               Or_error.errorf "%s already present in trustlist" cidr_str
×
348
             else (
×
349
               client_trustlist := Unix.Cidr.Set.add !client_trustlist cidr ;
×
350
               Ok () ) ) )
351
    ; implement Daemon_rpcs.Remove_trustlist.rpc (fun () cidr ->
×
352
          return
×
353
            (let cidr_str = Unix.Cidr.to_string cidr in
354
             if not @@ Unix.Cidr.Set.mem !client_trustlist cidr then
×
355
               Or_error.errorf "%s not present in trustlist" cidr_str
×
356
             else (
×
357
               client_trustlist := Unix.Cidr.Set.remove !client_trustlist cidr ;
×
358
               Ok () ) ) )
359
    ; implement Daemon_rpcs.Get_trustlist.rpc (fun () () ->
×
360
          return (Set.to_list !client_trustlist) )
×
361
    ; implement Daemon_rpcs.Get_node_status.rpc (fun () peers ->
×
362
          Mina_networking.get_node_status_from_peers (Mina_lib.net mina) peers )
×
363
    ; implement Daemon_rpcs.Get_object_lifetime_statistics.rpc (fun () () ->
×
364
          return
×
365
            (Yojson.Safe.pretty_to_string @@ Allocation_functor.Table.dump ()) )
×
366
    ; implement Daemon_rpcs.Submit_internal_log.rpc
×
367
        (fun () { timestamp; message; metadata; process } ->
368
          let metadata =
×
369
            List.map metadata ~f:(fun (s, value) ->
370
                (s, Yojson.Safe.from_string value) )
×
371
          in
372
          return @@ Itn_logger.log ~process ~timestamp ~message ~metadata () )
×
373
    ]
374
  in
375
  let log_snark_work_metrics
376
      (work : Snark_work_lib.Selector.Result.Stable.Latest.t) =
377
    Mina_metrics.(Counter.inc_one Snark_work.completed_snark_work_received_rpc) ;
×
378
    One_or_two.iter
379
      (One_or_two.zip_exn work.metrics
×
380
         (Snark_work_lib.Selector.Result.Stable.Latest.transactions work) )
×
381
      ~f:(fun ((total, tag), transaction_opt) ->
382
        ( match tag with
×
383
        | `Merge ->
×
384
            Perf_histograms.add_span ~name:"snark_worker_merge_time" total ;
385
            Mina_metrics.(
×
386
              Cryptography.Snark_work_histogram.observe
×
387
                Cryptography.snark_work_merge_time_sec (Time.Span.to_sec total))
×
388
        | `Transition -> (
×
389
            (*should be Some in the case of `Transition*)
390
            match Option.value_exn transaction_opt with
391
            | Mina_transaction.Transaction.Command
×
392
                (Mina_base.User_command.Zkapp_command parties) ->
393
                let init =
394
                  match
395
                    (Mina_base.Account_update.of_fee_payer parties.fee_payer)
×
396
                      .authorization
397
                  with
398
                  | Proof _ ->
×
399
                      (1, 1)
400
                  | _ ->
×
401
                      (1, 0)
402
                in
403
                let parties_count, proof_parties_count =
404
                  Mina_base.Zkapp_command.Call_forest.fold
405
                    parties.account_updates ~init
406
                    ~f:(fun (count, proof_parties_count) party ->
407
                      ( count + 1
×
408
                      , if
409
                          Mina_base.Control.(
410
                            Tag.equal Proof
×
411
                              (tag
×
412
                                 (Mina_base.Account_update.Poly.authorization
×
413
                                    party ) ))
414
                        then proof_parties_count + 1
×
415
                        else proof_parties_count ) )
×
416
                in
417
                Mina_metrics.(
×
418
                  Cryptography.(
419
                    Counter.inc snark_work_zkapp_base_time_sec
420
                      (Time.Span.to_sec total) ;
×
421
                    Counter.inc_one snark_work_zkapp_base_submissions ;
×
422
                    Counter.inc zkapp_transaction_length
×
423
                      (Float.of_int parties_count) ;
×
424
                    Counter.inc zkapp_proof_updates
×
425
                      (Float.of_int proof_parties_count)))
×
426
            | _ ->
×
427
                Mina_metrics.(
428
                  Cryptography.(
429
                    Counter.inc_one snark_work_base_submissions ;
430
                    Counter.inc snark_work_base_time_sec
×
431
                      (Time.Span.to_sec total))) ) ) ;
×
432
        Perf_histograms.add_span ~name:"snark_worker_transition_time" total )
433
  in
434
  let snark_worker_impls =
435
    [ implement Snark_worker.Rpcs_versioned.Get_work.Latest.rpc (fun () () ->
×
436
          Deferred.return
×
437
            (let open Option.Let_syntax in
438
            let%bind key =
439
              Option.merge
×
440
                (Mina_lib.snark_worker_key mina)
×
441
                (Mina_lib.snark_coordinator_key mina)
×
442
                ~f:Fn.const
443
            in
444
            let%map work = Mina_lib.request_work mina in
×
445
            let work =
×
446
              Snark_work_lib.Work.Spec.map work
447
                ~f:
448
                  (Snark_work_lib.Work.Single.Spec.map
449
                     ~f_proof:Ledger_proof.Cached.read_proof_from_disk
450
                     ~f_witness:Transaction_witness.read_all_proofs_from_disk )
451
            in
452
            [%log trace]
×
453
              ~metadata:
454
                [ ( "work_spec"
455
                  , Snark_work_lib.Selector.Spec.Stable.Latest.to_yojson work )
×
456
                ]
457
              "responding to a Get_work request with some new work" ;
458
            Mina_metrics.(Counter.inc_one Snark_work.snark_work_assigned_rpc) ;
×
459
            (work, key)) )
460
    ; implement Snark_worker.Rpcs_versioned.Submit_work.Latest.rpc
×
461
        (fun () (work : Snark_work_lib.Selector.Result.Stable.Latest.t) ->
462
          [%log trace] "received completed work from a snark worker"
×
463
            ~metadata:
464
              [ ( "work_spec"
465
                , Snark_work_lib.Selector.Spec.Stable.Latest.to_yojson work.spec
×
466
                )
467
              ] ;
468
          log_snark_work_metrics work ;
×
469
          Deferred.return @@ Mina_lib.add_work mina work )
×
470
    ; implement Snark_worker.Rpcs_versioned.Failed_to_generate_snark.Latest.rpc
×
471
        (fun
472
          ()
473
          ((error, _work_spec, _prover_public_key) :
474
            Error.t
475
            * Snark_work_lib.Selector.Spec.Stable.Latest.t
476
            * Signature_lib.Public_key.Compressed.t )
477
        ->
478
          [%str_log error]
×
479
            (Snark_worker.Events.Generating_snark_work_failed
480
               { error = Error_json.error_to_yojson error } ) ;
×
481
          Mina_metrics.(Counter.inc_one Snark_work.snark_work_failed_rpc) ;
×
482
          Deferred.unit )
483
    ]
484
  in
485
  let create_graphql_server_with_auth ~mk_context ?auth_keys ~bind_to_address
486
      ~schema ~server_description ~require_auth port =
487
    if require_auth && Option.is_none auth_keys then
×
488
      failwith
×
489
        "Could not create GraphQL server, authentication is required, but no \
490
         authentication keys were provided" ;
491
    let auth_keys =
×
492
      Option.map auth_keys ~f:(fun s ->
493
          let pk_strs = String.split_on_chars ~on:[ ',' ] s in
×
494
          List.map pk_strs ~f:(fun pk_str ->
×
495
              match Itn_crypto.pubkey_of_base64 pk_str with
×
496
              | Ok pk ->
×
497
                  pk
498
              | Error _ ->
×
499
                  failwithf "Could not decode %s to an Ed25519 public key"
500
                    pk_str () ) )
501
    in
502
    let graphql_callback =
×
503
      Graphql_cohttp_async.make_callback ?auth_keys mk_context schema
504
    in
505
    Cohttp_async.(
×
506
      Server.create_expert
×
507
        ~on_handler_error:
508
          (`Call
509
            (fun _net exn ->
510
              [%log error]
×
511
                "Exception while handling REST server request: $error"
512
                ~metadata:
513
                  [ ("error", `String (Exn.to_string_mach exn))
×
514
                  ; ("context", `String "rest_server")
515
                  ] ) )
516
        (Tcp.Where_to_listen.bind_to bind_to_address (On_port port))
×
517
        (fun ~body _sock req ->
518
          let uri = Cohttp.Request.uri req in
×
519
          let status flag =
×
520
            let%bind status = Mina_commands.get_status ~flag mina in
×
521
            Server.respond_string
×
522
              ( status |> Daemon_rpcs.Types.Status.to_yojson
×
523
              |> Yojson.Safe.pretty_to_string )
×
524
          in
525
          let lift x = `Response x in
×
526
          match Uri.path uri with
527
          | "/" ->
×
528
              let body =
529
                "This page is intentionally left blank. The graphql endpoint \
530
                 can be found at `/graphql`."
531
              in
532
              Server.respond_string ~status:`OK body >>| lift
×
533
          | "/graphql" ->
×
534
              [%log debug] "Received graphql request. Uri: $uri"
×
535
                ~metadata:
536
                  [ ("uri", `String (Uri.to_string uri))
×
537
                  ; ("context", `String "rest_server")
538
                  ] ;
539
              graphql_callback () req body
×
540
          | "/status" ->
×
541
              status `None >>| lift
×
542
          | "/status/performance" ->
×
543
              status `Performance >>| lift
×
544
          | _ ->
×
545
              Server.respond_string ~status:`Not_found "Route not found"
×
546
              >>| lift ))
547
    |> Deferred.map ~f:(fun _ ->
548
           [%log info]
×
549
             !"Created %s at: http://localhost:%i/graphql"
550
             server_description port )
551
  in
552
  let create_graphql_server =
553
    create_graphql_server_with_auth
554
      ~mk_context:(fun ~with_seq_no:_ _req -> mina)
×
555
      ?auth_keys:None
556
  in
557
  Option.iter rest_server_port ~f:(fun rest_server_port ->
558
      O1trace.background_thread "serve_graphql" (fun () ->
×
559
          create_graphql_server
×
560
            ~bind_to_address:
561
              Tcp.Bind_to_address.(
562
                if insecure_rest_server then All_addresses else Localhost)
×
563
            ~schema:Mina_graphql.schema ~server_description:"GraphQL server"
564
            ~require_auth:false rest_server_port ) ) ;
565
  (* Second graphql server with limited queries exposed *)
566
  Option.iter limited_graphql_port ~f:(fun rest_server_port ->
×
567
      O1trace.background_thread "serve_limited_graphql" (fun () ->
×
568
          create_graphql_server
×
569
            ~bind_to_address:
570
              Tcp.Bind_to_address.(
571
                if open_limited_graphql_port then All_addresses else Localhost)
×
572
            ~schema:Mina_graphql.schema_limited
573
            ~server_description:"GraphQL server with limited queries"
574
            ~require_auth:false rest_server_port ) ) ;
575
  if itn_features then
×
576
    (* Third graphql server with ITN-particular queries exposed *)
577
    Option.iter itn_graphql_port ~f:(fun rest_server_port ->
×
578
        O1trace.background_thread "serve_itn_graphql" (fun () ->
×
579
            create_graphql_server_with_auth
×
580
              ~mk_context:(fun ~with_seq_no _req -> (with_seq_no, mina))
×
581
              ?auth_keys
582
              ~bind_to_address:
583
                Tcp.Bind_to_address.(
584
                  if insecure_rest_server then All_addresses else Localhost)
×
585
              ~schema:Mina_graphql.schema_itn
586
              ~server_description:"GraphQL server for ITN queries"
587
              ~require_auth:true rest_server_port ) ) ;
588
  let where_to_listen =
×
589
    Tcp.Where_to_listen.bind_to All_addresses
590
      (On_port (Mina_lib.client_port mina))
×
591
  in
592
  O1trace.background_thread "serve_client_rpcs" (fun () ->
×
593
      Deferred.ignore_m
×
594
        (Tcp.Server.create
×
595
           ~on_handler_error:
596
             (`Call
597
               (fun _net exn ->
598
                 [%log error]
×
599
                   "Exception while handling TCP server request: $error"
600
                   ~metadata:
601
                     [ ("error", `String (Exn.to_string_mach exn))
×
602
                     ; ("context", `String "rpc_tcp_server")
603
                     ] ) )
604
           where_to_listen
605
           (fun address reader writer ->
606
             let address = Socket.Address.Inet.addr address in
×
607
             if
×
608
               not
609
                 (Set.exists !client_trustlist ~f:(fun cidr ->
×
610
                      Unix.Cidr.does_match cidr address ) )
×
611
             then (
×
612
               [%log error]
×
613
                 !"Rejecting client connection from $address, it is not \
614
                   present in the trustlist."
615
                 ~metadata:
616
                   [ ("$address", `String (Unix.Inet_addr.to_string address)) ] ;
×
617
               Deferred.unit )
×
618
             else
619
               Rpc.Connection.server_with_close
×
620
                 ~handshake_timeout:compile_config.rpc_handshake_timeout
621
                 ~heartbeat_config:
622
                   (Rpc.Connection.Heartbeat_config.create
×
623
                      ~timeout:
624
                        (Time_ns.Span.of_sec
×
625
                           (Time.Span.to_sec
×
626
                              compile_config.rpc_heartbeat_timeout ) )
627
                      ~send_every:
628
                        (Time_ns.Span.of_sec
×
629
                           (Time.Span.to_sec
×
630
                              compile_config.rpc_heartbeat_send_every ) )
631
                      () )
632
                 reader writer
633
                 ~implementations:
634
                   (Rpc.Implementations.create_exn
635
                      ~implementations:(client_impls @ snark_worker_impls)
636
                      ~on_unknown_rpc:`Raise )
637
                 ~connection_state:(fun _ -> ())
×
638
                 ~on_handshake_error:
639
                   (`Call
640
                     (fun exn ->
641
                       [%log warn]
×
642
                         "Handshake error while handling RPC server request \
643
                          from $address"
644
                         ~metadata:
645
                           [ ("error", `String (Exn.to_string_mach exn))
×
646
                           ; ("context", `String "rpc_server")
647
                           ; ( "address"
648
                             , `String (Unix.Inet_addr.to_string address) )
×
649
                           ] ;
650
                       Deferred.unit ) ) ) ) )
×
651

652
let coda_crash_message ~log_issue ~action ~error =
653
  let followup =
×
654
    if log_issue then
655
      sprintf
×
656
        !{err| The Mina Protocol developers would like to know why!
657

658
    Please:
659
      Open an issue:
660
        <https://github.com/MinaProtocol/mina/issues/new>
661

662
      Briefly describe what you were doing and %s
663

664
    %!|err}
665
        action
666
    else action
×
667
  in
668
  sprintf !{err|
669

670
  ☠  Mina Daemon %s.
671
  %s
672
%!|err} error followup
673

674
let no_report exn_json status =
675
  sprintf
×
676
    "include the last 20 lines from .mina-config/mina.log and then paste the \
677
     following:\n\
678
     Summary:\n\
679
     %s\n\
680
     Status:\n\
681
     %s\n"
682
    (Yojson.Safe.to_string status)
×
683
    (Yojson.Safe.to_string (summary exn_json))
×
684

685
let handle_crash e ~time_controller ~conf_dir ~child_pids ~top_logger coda_ref =
686
  (* attempt to free up some memory before handling crash *)
687
  (* this circumvents using Child_processes.kill, and instead sends SIGKILL to all children *)
688
  Hashtbl.keys child_pids
×
689
  |> List.iter ~f:(fun pid ->
690
         ignore (Signal.send Signal.kill (`Pid pid) : [ `No_such_process | `Ok ]) ) ;
×
691
  let exn_json = Error_json.error_to_yojson (Error.of_exn ~backtrace:`Get e) in
×
692
  [%log' fatal top_logger]
×
693
    "Unhandled top-level exception: $exn\nGenerating crash report"
694
    ~metadata:[ ("exn", exn_json) ] ;
695
  let%bind status = coda_status !coda_ref in
×
696
  (* TEMP MAKE REPORT TRACE *)
697
  [%log' trace top_logger] "handle_crash: acquired coda status" ;
×
698
  let%map action_string =
699
    match%map
700
      Block_time.Timeout.await
×
701
        ~timeout_duration:(Block_time.Span.of_ms 30_000L)
×
702
        time_controller
703
        ( try
704
            make_report exn_json ~conf_dir coda_ref ~top_logger
×
705
            >>| fun k -> Ok k
×
706
          with exn -> return (Error (Error.of_exn exn)) )
×
707
    with
708
    | `Ok (Ok (Some (report_file, temp_config))) ->
×
709
        ( try ignore (Core.Sys.command (sprintf "rm -rf %s" temp_config) : int)
×
710
          with _ -> () ) ;
×
711
        sprintf "attach the crash report %s" report_file
712
    | `Ok (Ok None) ->
×
713
        (*TODO: tar failed, should we ask people to zip the temp directory themselves?*)
714
        no_report exn_json status
715
    | `Ok (Error e) ->
×
716
        [%log' fatal top_logger] "Exception when generating crash report: $exn"
×
717
          ~metadata:[ ("exn", Error_json.error_to_yojson e) ] ;
×
718
        no_report exn_json status
×
719
    | `Timeout ->
×
720
        [%log' fatal top_logger] "Timed out while generated crash report" ;
×
721
        no_report exn_json status
×
722
  in
723
  let message =
×
724
    coda_crash_message ~error:"crashed" ~action:action_string ~log_issue:true
725
  in
726
  Core.print_string message
727

728
let handle_shutdown ~monitor ~time_controller ~conf_dir ~child_pids ~top_logger
729
    coda_ref =
730
  Monitor.detach_and_iter_errors monitor ~f:(fun exn ->
×
731
      don't_wait_for
×
732
        (let%bind () =
733
           match Monitor.extract_exn exn with
734
           | Mina_networking.No_initial_peers ->
×
735
               let message =
736
                 coda_crash_message
737
                   ~error:"failed to connect to any initial peers"
738
                   ~action:
739
                     "You might be trying to connect to a different network \
740
                      version, or need to troubleshoot your configuration. See \
741
                      https://codaprotocol.com/docs/troubleshooting/ for \
742
                      details."
743
                   ~log_issue:false
744
               in
745
               Core.print_string message ; Deferred.unit
×
746
           | Genesis_ledger_helper.Genesis_state_initialization_error ->
×
747
               let message =
748
                 coda_crash_message
749
                   ~error:"failed to initialize the genesis state"
750
                   ~action:
751
                     "include the last 50 lines from .mina-config/mina.log"
752
                   ~log_issue:true
753
               in
754
               Core.print_string message ; Deferred.unit
×
755
           | Mina_stdlib.Mina_user_error.Mina_user_error { message; where } ->
×
756
               Core.print_string "\nFATAL ERROR" ;
757
               let error =
×
758
                 match where with
759
                 | None ->
×
760
                     "encountered a configuration error"
761
                 | Some where ->
×
762
                     sprintf "encountered a configuration error %s" where
×
763
               in
764
               let message =
765
                 coda_crash_message ~error ~action:("\n" ^ message)
766
                   ~log_issue:false
767
               in
768
               Core.print_string message ; Deferred.unit
×
769
           | Mina_lib.Offline_shutdown ->
×
770
               Core.print_string
771
                 "\n\
772
                  [FATAL] *** Mina daemon has been offline for too long ***\n\
773
                  *** Shutting down ***\n" ;
774
               handle_crash Mina_lib.Offline_shutdown ~time_controller ~conf_dir
×
775
                 ~child_pids ~top_logger coda_ref
776
           | Mina_lib.Bootstrap_stuck_shutdown ->
×
777
               Core.print_string
778
                 "\n\
779
                  [FATAL] *** Mina daemon has been stuck in bootstrap for too \
780
                  long ***\n\
781
                  *** Shutting down ***\n" ;
782
               handle_crash Mina_lib.Bootstrap_stuck_shutdown ~time_controller
×
783
                 ~conf_dir ~child_pids ~top_logger coda_ref
784
           | _exn ->
×
785
               let error = Error.of_exn ~backtrace:`Get exn in
786
               let%bind () =
787
                 Node_error_service.send_report
788
                   ~commit_id:Mina_version.commit_id ~logger:top_logger ~error
789
               in
790
               handle_crash exn ~time_controller ~conf_dir ~child_pids
×
791
                 ~top_logger coda_ref
792
         in
793
         Stdlib.exit 1 ) ) ;
×
794
  Async_unix.Signal.(
×
795
    handle terminating ~f:(fun signal ->
796
        log_shutdown ~conf_dir ~top_logger coda_ref ;
×
797
        let logger =
×
798
          Logger.extend top_logger
799
            [ ("coda_run", `String "Program was killed by signal") ]
800
        in
801
        [%log info]
×
802
          !"Mina process was interrupted by $signal"
803
          ~metadata:[ ("signal", `String (to_string signal)) ] ;
×
804
        (* causes async shutdown and at_exit handlers to run *)
805
        Async.shutdown 130 ))
×
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