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

MinaProtocol / mina / 3539

27 Mar 2025 07:25PM UTC coverage: 60.771% (+0.05%) from 60.723%
3539

push

buildkite

web-flow
Merge pull request #16795 from MinaProtocol/dw/merge-compatible-into-develop-20250327

[20250327] Merge compatible into develop

89 of 161 new or added lines in 24 files covered. (55.28%)

73 existing lines in 13 files now uncovered.

49903 of 82116 relevant lines covered (60.77%)

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

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

650
    Please:
651
      Open an issue:
652
        <https://github.com/MinaProtocol/mina/issues/new>
653

654
      Briefly describe what you were doing and %s
655

656
    %!|err}
657
        action
658
    else action
×
659
  in
660
  sprintf !{err|
661

662
  ☠  Mina Daemon %s.
663
  %s
664
%!|err} error followup
665

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

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

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