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

MinaProtocol / mina / 90

17 Apr 2025 10:58AM UTC coverage: 32.594% (+0.4%) from 32.178%
90

push

buildkite

web-flow
Merge pull request #16970 from MinaProtocol/feature/keep-snark-work-proofs-cached

Keep snark work proofs on disk until we actually need them

0 of 9 new or added lines in 9 files covered. (0.0%)

949 existing lines in 49 files now uncovered.

23374 of 71713 relevant lines covered (32.59%)

32160.56 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
9✔
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 Coda 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 Coda 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 Coda 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 ->
×
309
                  let%map accts = Mina_ledger.Ledger.to_list l in
×
310
                  Ok accts
×
311
              | Ledger_db db ->
×
312
                  let%map accts = Mina_ledger.Ledger.Db.to_list db in
×
313
                  Ok accts )
×
314
          | Error err ->
×
315
              return (Error err) )
316
    ; implement Daemon_rpcs.Stop_daemon.rpc (fun () () ->
×
317
          Scheduler.yield () >>= (fun () -> exit 0) |> don't_wait_for ;
×
318
          Deferred.unit )
×
319
    ; implement Daemon_rpcs.Snark_job_list.rpc (fun () () ->
×
320
          return (snark_job_list_json mina |> Participating_state.active_error) )
×
321
    ; implement Daemon_rpcs.Snark_pool_list.rpc (fun () () ->
×
322
          return (snark_pool_list mina) )
×
323
    ; implement Daemon_rpcs.Start_tracing.rpc (fun () () ->
×
324
          let open Mina_lib.Config in
×
325
          Mina_tracing.start (Mina_lib.config mina).conf_dir )
×
326
    ; implement Daemon_rpcs.Stop_tracing.rpc (fun () () ->
×
327
          Mina_tracing.stop () ; Deferred.unit )
×
328
    ; implement Daemon_rpcs.Start_internal_tracing.rpc (fun () () ->
×
329
          Internal_tracing.toggle ~commit_id:Mina_version.commit_id ~logger
×
330
            `Enabled )
331
    ; implement Daemon_rpcs.Stop_internal_tracing.rpc (fun () () ->
×
332
          Internal_tracing.toggle ~commit_id:Mina_version.commit_id ~logger
×
333
            `Disabled )
334
    ; implement Daemon_rpcs.Visualization.Frontier.rpc (fun () filename ->
×
335
          return (Mina_lib.visualize_frontier ~filename mina) )
×
336
    ; implement Daemon_rpcs.Visualization.Registered_masks.rpc
×
337
        (fun () filename ->
338
          return (Mina_ledger.Ledger.Debug.visualize ~filename) )
×
339
    ; implement Daemon_rpcs.Add_trustlist.rpc (fun () cidr ->
×
340
          return
×
341
            (let cidr_str = Unix.Cidr.to_string cidr in
342
             if Unix.Cidr.Set.mem !client_trustlist cidr then
×
343
               Or_error.errorf "%s already present in trustlist" cidr_str
×
344
             else (
×
345
               client_trustlist := Unix.Cidr.Set.add !client_trustlist cidr ;
×
346
               Ok () ) ) )
347
    ; implement Daemon_rpcs.Remove_trustlist.rpc (fun () cidr ->
×
348
          return
×
349
            (let cidr_str = Unix.Cidr.to_string cidr in
350
             if not @@ Unix.Cidr.Set.mem !client_trustlist cidr then
×
351
               Or_error.errorf "%s not present in trustlist" cidr_str
×
352
             else (
×
353
               client_trustlist := Unix.Cidr.Set.remove !client_trustlist cidr ;
×
354
               Ok () ) ) )
355
    ; implement Daemon_rpcs.Get_trustlist.rpc (fun () () ->
×
356
          return (Set.to_list !client_trustlist) )
×
357
    ; implement Daemon_rpcs.Get_node_status.rpc (fun () peers ->
×
358
          Mina_networking.get_node_status_from_peers (Mina_lib.net mina) peers )
×
359
    ; implement Daemon_rpcs.Get_object_lifetime_statistics.rpc (fun () () ->
×
360
          return
×
361
            (Yojson.Safe.pretty_to_string @@ Allocation_functor.Table.dump ()) )
×
362
    ; implement Daemon_rpcs.Submit_internal_log.rpc
×
363
        (fun () { timestamp; message; metadata; process } ->
364
          let metadata =
×
365
            List.map metadata ~f:(fun (s, value) ->
366
                (s, Yojson.Safe.from_string value) )
×
367
          in
368
          return @@ Itn_logger.log ~process ~timestamp ~message ~metadata () )
×
369
    ]
370
  in
371
  let log_snark_work_metrics (work : Snark_worker.Work.Result.t) =
372
    Mina_metrics.(Counter.inc_one Snark_work.completed_snark_work_received_rpc) ;
×
373
    One_or_two.iter
374
      (One_or_two.zip_exn work.metrics
×
375
         (Snark_worker.Work.Result.transactions work) )
×
376
      ~f:(fun ((total, tag), transaction_opt) ->
377
        ( match tag with
×
378
        | `Merge ->
×
379
            Perf_histograms.add_span ~name:"snark_worker_merge_time" total ;
380
            Mina_metrics.(
×
381
              Cryptography.Snark_work_histogram.observe
×
382
                Cryptography.snark_work_merge_time_sec (Time.Span.to_sec total))
×
383
        | `Transition -> (
×
384
            (*should be Some in the case of `Transition*)
385
            match Option.value_exn transaction_opt with
386
            | Mina_transaction.Transaction.Command
×
387
                (Mina_base.User_command.Zkapp_command parties) ->
388
                let init =
389
                  match
390
                    (Mina_base.Account_update.of_fee_payer parties.fee_payer)
×
391
                      .authorization
392
                  with
393
                  | Proof _ ->
×
394
                      (1, 1)
395
                  | _ ->
×
396
                      (1, 0)
397
                in
398
                let parties_count, proof_parties_count =
399
                  Mina_base.Zkapp_command.Call_forest.fold
400
                    parties.account_updates ~init
401
                    ~f:(fun (count, proof_parties_count) party ->
402
                      ( count + 1
×
403
                      , if
404
                          Mina_base.Control.(
405
                            Tag.equal Proof
×
406
                              (tag
×
407
                                 (Mina_base.Account_update.Poly.authorization
×
408
                                    party ) ))
409
                        then proof_parties_count + 1
×
410
                        else proof_parties_count ) )
×
411
                in
412
                Mina_metrics.(
×
413
                  Cryptography.(
414
                    Counter.inc snark_work_zkapp_base_time_sec
415
                      (Time.Span.to_sec total) ;
×
416
                    Counter.inc_one snark_work_zkapp_base_submissions ;
×
417
                    Counter.inc zkapp_transaction_length
×
418
                      (Float.of_int parties_count) ;
×
419
                    Counter.inc zkapp_proof_updates
×
420
                      (Float.of_int proof_parties_count)))
×
421
            | _ ->
×
422
                Mina_metrics.(
423
                  Cryptography.(
424
                    Counter.inc_one snark_work_base_submissions ;
425
                    Counter.inc snark_work_base_time_sec
×
426
                      (Time.Span.to_sec total))) ) ) ;
×
427
        Perf_histograms.add_span ~name:"snark_worker_transition_time" total )
428
  in
429
  let snark_worker_impls =
430
    [ implement Snark_worker.Rpcs_versioned.Get_work.Latest.rpc (fun () () ->
×
431
          Deferred.return
×
432
            (let open Option.Let_syntax in
433
            let%bind key =
434
              Option.merge
×
435
                (Mina_lib.snark_worker_key mina)
×
436
                (Mina_lib.snark_coordinator_key mina)
×
437
                ~f:Fn.const
438
            in
439
            let%map work = Mina_lib.request_work mina in
×
NEW
440
            let work =
×
441
              Snark_work_lib.Work.Spec.map work
442
                ~f:
443
                  (Snark_work_lib.Work.Single.Spec.map
444
                     ~f_proof:Ledger_proof.Cached.read_proof_from_disk
445
                     ~f_witness:Transaction_witness.read_all_proofs_from_disk )
446
            in
447
            [%log trace]
×
448
              ~metadata:[ ("work_spec", Snark_worker.Work.Spec.to_yojson work) ]
×
449
              "responding to a Get_work request with some new work" ;
450
            Mina_metrics.(Counter.inc_one Snark_work.snark_work_assigned_rpc) ;
×
451
            (work, key)) )
452
    ; implement Snark_worker.Rpcs_versioned.Submit_work.Latest.rpc
×
453
        (fun () (work : Snark_worker.Work.Result.t) ->
454
          [%log trace] "received completed work from a snark worker"
×
455
            ~metadata:
456
              [ ("work_spec", Snark_worker.Work.Spec.to_yojson work.spec) ] ;
×
457
          log_snark_work_metrics work ;
×
458
          Deferred.return @@ Mina_lib.add_work mina work )
×
459
    ; implement Snark_worker.Rpcs_versioned.Failed_to_generate_snark.Latest.rpc
×
460
        (fun
461
          ()
462
          ((error, _work_spec, _prover_public_key) :
463
            Error.t
464
            * Snark_worker.Work.Spec.t
465
            * Signature_lib.Public_key.Compressed.t )
466
        ->
467
          [%str_log error]
×
468
            (Snark_worker.Generating_snark_work_failed
469
               { error = Error_json.error_to_yojson error } ) ;
×
470
          Mina_metrics.(Counter.inc_one Snark_work.snark_work_failed_rpc) ;
×
471
          Deferred.unit )
472
    ]
473
  in
474
  let create_graphql_server_with_auth ~mk_context ?auth_keys ~bind_to_address
475
      ~schema ~server_description ~require_auth port =
476
    if require_auth && Option.is_none auth_keys then
×
477
      failwith
×
478
        "Could not create GraphQL server, authentication is required, but no \
479
         authentication keys were provided" ;
480
    let auth_keys =
×
481
      Option.map auth_keys ~f:(fun s ->
482
          let pk_strs = String.split_on_chars ~on:[ ',' ] s in
×
483
          List.map pk_strs ~f:(fun pk_str ->
×
484
              match Itn_crypto.pubkey_of_base64 pk_str with
×
485
              | Ok pk ->
×
486
                  pk
487
              | Error _ ->
×
488
                  failwithf "Could not decode %s to an Ed25519 public key"
489
                    pk_str () ) )
490
    in
491
    let graphql_callback =
×
492
      Graphql_cohttp_async.make_callback ?auth_keys mk_context schema
493
    in
494
    Cohttp_async.(
×
495
      Server.create_expert
×
496
        ~on_handler_error:
497
          (`Call
498
            (fun _net exn ->
499
              [%log error]
×
500
                "Exception while handling REST server request: $error"
501
                ~metadata:
502
                  [ ("error", `String (Exn.to_string_mach exn))
×
503
                  ; ("context", `String "rest_server")
504
                  ] ) )
505
        (Tcp.Where_to_listen.bind_to bind_to_address (On_port port))
×
506
        (fun ~body _sock req ->
507
          let uri = Cohttp.Request.uri req in
×
508
          let status flag =
×
509
            let%bind status = Mina_commands.get_status ~flag mina in
×
510
            Server.respond_string
×
511
              ( status |> Daemon_rpcs.Types.Status.to_yojson
×
512
              |> Yojson.Safe.pretty_to_string )
×
513
          in
514
          let lift x = `Response x in
×
515
          match Uri.path uri with
516
          | "/" ->
×
517
              let body =
518
                "This page is intentionally left blank. The graphql endpoint \
519
                 can be found at `/graphql`."
520
              in
521
              Server.respond_string ~status:`OK body >>| lift
×
522
          | "/graphql" ->
×
523
              [%log debug] "Received graphql request. Uri: $uri"
×
524
                ~metadata:
525
                  [ ("uri", `String (Uri.to_string uri))
×
526
                  ; ("context", `String "rest_server")
527
                  ] ;
528
              graphql_callback () req body
×
529
          | "/status" ->
×
530
              status `None >>| lift
×
531
          | "/status/performance" ->
×
532
              status `Performance >>| lift
×
533
          | _ ->
×
534
              Server.respond_string ~status:`Not_found "Route not found"
×
535
              >>| lift ))
536
    |> Deferred.map ~f:(fun _ ->
537
           [%log info]
×
538
             !"Created %s at: http://localhost:%i/graphql"
539
             server_description port )
540
  in
541
  let create_graphql_server =
542
    create_graphql_server_with_auth
543
      ~mk_context:(fun ~with_seq_no:_ _req -> mina)
×
544
      ?auth_keys:None
545
  in
546
  Option.iter rest_server_port ~f:(fun rest_server_port ->
547
      O1trace.background_thread "serve_graphql" (fun () ->
×
548
          create_graphql_server
×
549
            ~bind_to_address:
550
              Tcp.Bind_to_address.(
551
                if insecure_rest_server then All_addresses else Localhost)
×
552
            ~schema:Mina_graphql.schema ~server_description:"GraphQL server"
553
            ~require_auth:false rest_server_port ) ) ;
554
  (* Second graphql server with limited queries exposed *)
555
  Option.iter limited_graphql_port ~f:(fun rest_server_port ->
×
556
      O1trace.background_thread "serve_limited_graphql" (fun () ->
×
557
          create_graphql_server
×
558
            ~bind_to_address:
559
              Tcp.Bind_to_address.(
560
                if open_limited_graphql_port then All_addresses else Localhost)
×
561
            ~schema:Mina_graphql.schema_limited
562
            ~server_description:"GraphQL server with limited queries"
563
            ~require_auth:false rest_server_port ) ) ;
564
  if itn_features then
×
565
    (* Third graphql server with ITN-particular queries exposed *)
566
    Option.iter itn_graphql_port ~f:(fun rest_server_port ->
×
567
        O1trace.background_thread "serve_itn_graphql" (fun () ->
×
568
            create_graphql_server_with_auth
×
569
              ~mk_context:(fun ~with_seq_no _req -> (with_seq_no, mina))
×
570
              ?auth_keys
571
              ~bind_to_address:
572
                Tcp.Bind_to_address.(
573
                  if insecure_rest_server then All_addresses else Localhost)
×
574
              ~schema:Mina_graphql.schema_itn
575
              ~server_description:"GraphQL server for ITN queries"
576
              ~require_auth:true rest_server_port ) ) ;
577
  let where_to_listen =
×
578
    Tcp.Where_to_listen.bind_to All_addresses
579
      (On_port (Mina_lib.client_port mina))
×
580
  in
581
  O1trace.background_thread "serve_client_rpcs" (fun () ->
×
582
      Deferred.ignore_m
×
583
        (Tcp.Server.create
×
584
           ~on_handler_error:
585
             (`Call
586
               (fun _net exn ->
587
                 [%log error]
×
588
                   "Exception while handling TCP server request: $error"
589
                   ~metadata:
590
                     [ ("error", `String (Exn.to_string_mach exn))
×
591
                     ; ("context", `String "rpc_tcp_server")
592
                     ] ) )
593
           where_to_listen
594
           (fun address reader writer ->
595
             let address = Socket.Address.Inet.addr address in
×
596
             if
×
597
               not
598
                 (Set.exists !client_trustlist ~f:(fun cidr ->
×
599
                      Unix.Cidr.does_match cidr address ) )
×
600
             then (
×
601
               [%log error]
×
602
                 !"Rejecting client connection from $address, it is not \
603
                   present in the trustlist."
604
                 ~metadata:
605
                   [ ("$address", `String (Unix.Inet_addr.to_string address)) ] ;
×
606
               Deferred.unit )
×
607
             else
608
               Rpc.Connection.server_with_close
×
609
                 ~handshake_timeout:compile_config.rpc_handshake_timeout
610
                 ~heartbeat_config:
611
                   (Rpc.Connection.Heartbeat_config.create
×
612
                      ~timeout:
613
                        (Time_ns.Span.of_sec
×
614
                           (Time.Span.to_sec
×
615
                              compile_config.rpc_heartbeat_timeout ) )
616
                      ~send_every:
617
                        (Time_ns.Span.of_sec
×
618
                           (Time.Span.to_sec
×
619
                              compile_config.rpc_heartbeat_send_every ) )
620
                      () )
621
                 reader writer
622
                 ~implementations:
623
                   (Rpc.Implementations.create_exn
624
                      ~implementations:(client_impls @ snark_worker_impls)
625
                      ~on_unknown_rpc:`Raise )
626
                 ~connection_state:(fun _ -> ())
×
627
                 ~on_handshake_error:
628
                   (`Call
629
                     (fun exn ->
630
                       [%log warn]
×
631
                         "Handshake error while handling RPC server request \
632
                          from $address"
633
                         ~metadata:
634
                           [ ("error", `String (Exn.to_string_mach exn))
×
635
                           ; ("context", `String "rpc_server")
636
                           ; ( "address"
637
                             , `String (Unix.Inet_addr.to_string address) )
×
638
                           ] ;
639
                       Deferred.unit ) ) ) ) )
×
640

641
let coda_crash_message ~log_issue ~action ~error =
642
  let followup =
×
643
    if log_issue then
644
      sprintf
×
645
        !{err| The Mina Protocol developers would like to know why!
646

647
    Please:
648
      Open an issue:
649
        <https://github.com/MinaProtocol/mina/issues/new>
650

651
      Briefly describe what you were doing and %s
652

653
    %!|err}
654
        action
655
    else action
×
656
  in
657
  sprintf !{err|
658

659
  ☠  Mina Daemon %s.
660
  %s
661
%!|err} error followup
662

663
let no_report exn_json status =
664
  sprintf
×
665
    "include the last 20 lines from .mina-config/mina.log and then paste the \
666
     following:\n\
667
     Summary:\n\
668
     %s\n\
669
     Status:\n\
670
     %s\n"
671
    (Yojson.Safe.to_string status)
×
672
    (Yojson.Safe.to_string (summary exn_json))
×
673

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

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