From a3f15774e18e36ae051da263dc781e9e4cdfedfc Mon Sep 17 00:00:00 2001 From: ximinez Date: Thu, 20 Mar 2025 16:45:54 +0000 Subject: [PATCH] deploy: d22a5057b93a97acbffca14075bda62cad0b0fa7 --- Application_8cpp_source.html | 2 +- ByzantineFailureSim__test_8cpp_source.html | 2 +- ConsensusParms_8h_source.html | 239 +- ConsensusTypes_8h_source.html | 122 +- Consensus_8cpp_source.html | 308 +- Consensus_8h_source.html | 2980 +++--- Consensus__test_8cpp_source.html | 2466 +++-- DisputedTx_8h_source.html | 435 +- NetworkOPs_8cpp_source.html | 9243 +++++++++-------- NetworkOPs_8h_source.html | 2 +- RCLConsensus_8cpp_source.html | 12 +- RCLConsensus_8h_source.html | 6 +- ScaleFreeSim__test_8cpp_source.html | 2 +- Tx_8h_source.html | 10 +- annotated.html | 3 +- classes.html | 2 +- classripple_1_1Consensus-members.html | 65 +- classripple_1_1Consensus.html | 235 +- ...sripple_1_1Consensus_1_1MonitoredMode.html | 10 +- classripple_1_1Consensus__coll__graph.map | 38 +- classripple_1_1Consensus__coll__graph.md5 | 2 +- classripple_1_1Consensus__coll__graph.png | Bin 117307 -> 118029 bytes classripple_1_1DisputedTx-members.html | 24 +- classripple_1_1DisputedTx.html | 182 +- classripple_1_1DisputedTx__coll__graph.map | 7 +- classripple_1_1DisputedTx__coll__graph.md5 | 2 +- classripple_1_1DisputedTx__coll__graph.png | Bin 7549 -> 11109 bytes classripple_1_1NetworkOPsImp-members.html | 2 + classripple_1_1NetworkOPsImp.html | 432 +- ...e_1_1NetworkOPsImp_1_1StateAccounting.html | 26 +- ...1_1NetworkOPsImp_1_1TransactionStatus.html | 16 +- classripple_1_1NetworkOPsImp__coll__graph.map | 100 +- classripple_1_1NetworkOPsImp__coll__graph.md5 | 2 +- classripple_1_1NetworkOPsImp__coll__graph.png | Bin 697543 -> 711997 bytes classripple_1_1RCLConsensus.html | 68 +- classripple_1_1RCLConsensus_1_1Adaptor.html | 100 +- ..._1RCLConsensus_1_1Adaptor__coll__graph.map | 100 +- ..._1RCLConsensus_1_1Adaptor__coll__graph.md5 | 2 +- ..._1RCLConsensus_1_1Adaptor__coll__graph.png | Bin 561423 -> 586978 bytes classripple_1_1RCLConsensus__coll__graph.map | 68 +- classripple_1_1RCLConsensus__coll__graph.md5 | 2 +- classripple_1_1RCLConsensus__coll__graph.png | Bin 618842 -> 617704 bytes ...le_1_1test_1_1Consensus__test-members.html | 31 +- classripple_1_1test_1_1Consensus__test.html | 53 +- classripple_1_1test_1_1csf_1_1PeerGroup.html | 100 +- ...1test_1_1csf_1_1PeerGroup__coll__graph.map | 100 +- ...1test_1_1csf_1_1PeerGroup__coll__graph.md5 | 2 +- ...1test_1_1csf_1_1PeerGroup__coll__graph.png | Bin 577480 -> 581354 bytes ..._1_1test_1_1csf_1_1Peer_1_1ValAdaptor.html | 58 +- ...csf_1_1Peer_1_1ValAdaptor__coll__graph.map | 58 +- ...csf_1_1Peer_1_1ValAdaptor__coll__graph.md5 | 2 +- ...csf_1_1Peer_1_1ValAdaptor__coll__graph.png | Bin 602897 -> 602828 bytes classripple_1_1test_1_1csf_1_1Sim.html | 80 +- ...ple_1_1test_1_1csf_1_1Sim__coll__graph.map | 80 +- ...ple_1_1test_1_1csf_1_1Sim__coll__graph.md5 | 2 +- ...ple_1_1test_1_1csf_1_1Sim__coll__graph.png | Bin 576201 -> 575444 bytes classripple_1_1test_1_1csf_1_1Tx-members.html | 2 +- classripple_1_1test_1_1csf_1_1Tx.html | 10 +- collectors_8h_source.html | 4 +- functions_a.html | 31 +- functions_b.html | 4 +- functions_c.html | 40 +- functions_d.html | 2 +- functions_e.html | 7 +- functions_enum.html | 1 + functions_eval.html | 276 - functions_eval_a.html | 88 + functions_eval_b.html | 89 + functions_eval_c.html | 88 + functions_eval_d.html | 91 + functions_eval_e.html | 84 + functions_eval_f.html | 85 + functions_eval_g.html | 99 + functions_eval_h.html | 84 + functions_eval_i.html | 84 + functions_eval_k.html | 83 + functions_eval_l.html | 95 + functions_eval_m.html | 93 + functions_eval_n.html | 97 + functions_eval_o.html | 89 + functions_eval_p.html | 91 + functions_eval_q.html | 83 + functions_eval_r.html | 87 + functions_eval_s.html | 121 + functions_eval_t.html | 113 + functions_eval_u.html | 84 + functions_eval_v.html | 84 + functions_eval_w.html | 84 + functions_f.html | 2 +- functions_func.html | 4 +- functions_func_b.html | 2 +- functions_func_c.html | 4 +- functions_func_e.html | 2 +- functions_func_i.html | 4 +- functions_func_j.html | 2 +- functions_func_m.html | 4 +- functions_func_o.html | 18 +- functions_func_r.html | 4 +- functions_func_s.html | 79 +- functions_func_t.html | 11 +- functions_g.html | 3 +- functions_h.html | 2 +- functions_i.html | 24 +- functions_l.html | 21 +- functions_m.html | 7 +- functions_n.html | 8 +- functions_o.html | 20 +- functions_p.html | 11 +- functions_q.html | 3 +- functions_r.html | 4 +- functions_s.html | 53 +- functions_t.html | 17 +- functions_u.html | 2 +- functions_v.html | 20 +- functions_vars.html | 16 +- functions_vars_c.html | 4 + functions_vars_e.html | 1 + functions_vars_l.html | 12 +- functions_vars_m.html | 2 +- functions_vars_n.html | 1 + functions_vars_p.html | 5 +- functions_vars_v.html | 8 +- hierarchy.html | 3675 +++---- inherit_graph_1000.map | 18 +- inherit_graph_1000.md5 | 2 +- inherit_graph_1000.png | Bin 4970 -> 65131 bytes inherit_graph_1001.map | 5 +- inherit_graph_1001.md5 | 2 +- inherit_graph_1001.png | Bin 7463 -> 4970 bytes inherit_graph_1002.map | 5 + inherit_graph_1002.md5 | 1 + inherit_graph_1002.png | Bin 0 -> 7463 bytes inherit_graph_211.map | 2 +- inherit_graph_211.md5 | 2 +- inherit_graph_211.png | Bin 3666 -> 3078 bytes inherit_graph_212.map | 2 +- inherit_graph_212.md5 | 2 +- inherit_graph_212.png | Bin 3772 -> 3666 bytes inherit_graph_213.map | 2 +- inherit_graph_213.md5 | 2 +- inherit_graph_213.png | Bin 4479 -> 3772 bytes inherit_graph_214.map | 2 +- inherit_graph_214.md5 | 2 +- inherit_graph_214.png | Bin 3611 -> 4479 bytes inherit_graph_215.map | 2 +- inherit_graph_215.md5 | 2 +- inherit_graph_215.png | Bin 2601 -> 3611 bytes inherit_graph_216.map | 2 +- inherit_graph_216.md5 | 2 +- inherit_graph_216.png | Bin 1723 -> 2601 bytes inherit_graph_217.map | 2 +- inherit_graph_217.md5 | 2 +- inherit_graph_217.png | Bin 1570 -> 1723 bytes inherit_graph_218.map | 3 +- inherit_graph_218.md5 | 2 +- inherit_graph_218.png | Bin 4382 -> 1570 bytes inherit_graph_219.map | 4 +- inherit_graph_219.md5 | 2 +- inherit_graph_219.png | Bin 4670 -> 4382 bytes inherit_graph_220.map | 4 +- inherit_graph_220.md5 | 2 +- inherit_graph_220.png | Bin 4209 -> 4670 bytes inherit_graph_221.map | 2 +- inherit_graph_221.md5 | 2 +- inherit_graph_221.png | Bin 3797 -> 4209 bytes inherit_graph_222.map | 2 +- inherit_graph_222.md5 | 2 +- inherit_graph_222.png | Bin 4817 -> 3797 bytes inherit_graph_223.map | 2 +- inherit_graph_223.md5 | 2 +- inherit_graph_223.png | Bin 3959 -> 4817 bytes inherit_graph_224.map | 18 +- inherit_graph_224.md5 | 2 +- inherit_graph_224.png | Bin 60783 -> 3959 bytes inherit_graph_225.map | 21 +- inherit_graph_225.md5 | 2 +- inherit_graph_225.png | Bin 9341 -> 60783 bytes inherit_graph_226.map | 10 +- inherit_graph_226.md5 | 2 +- inherit_graph_226.png | Bin 15856 -> 9341 bytes inherit_graph_227.map | 5 +- inherit_graph_227.md5 | 2 +- inherit_graph_227.png | Bin 3555 -> 15856 bytes inherit_graph_228.map | 17 +- inherit_graph_228.md5 | 2 +- inherit_graph_228.png | Bin 48451 -> 3555 bytes inherit_graph_229.map | 17 +- inherit_graph_229.md5 | 2 +- inherit_graph_229.png | Bin 4104 -> 48451 bytes inherit_graph_230.map | 2 +- inherit_graph_230.md5 | 2 +- inherit_graph_230.png | Bin 4472 -> 4104 bytes inherit_graph_231.map | 2 +- inherit_graph_231.md5 | 2 +- inherit_graph_231.png | Bin 4052 -> 4472 bytes inherit_graph_232.map | 3 +- inherit_graph_232.md5 | 2 +- inherit_graph_232.png | Bin 2672 -> 4052 bytes inherit_graph_233.map | 3 +- inherit_graph_233.md5 | 2 +- inherit_graph_233.png | Bin 4280 -> 2672 bytes inherit_graph_234.map | 7 +- inherit_graph_234.md5 | 2 +- inherit_graph_234.png | Bin 13950 -> 4280 bytes inherit_graph_235.map | 7 +- inherit_graph_235.md5 | 2 +- inherit_graph_235.png | Bin 4242 -> 13950 bytes inherit_graph_236.map | 12 +- inherit_graph_236.md5 | 2 +- inherit_graph_236.png | Bin 38259 -> 4242 bytes inherit_graph_237.map | 12 +- inherit_graph_237.md5 | 2 +- inherit_graph_237.png | Bin 4878 -> 38259 bytes inherit_graph_238.map | 2 +- inherit_graph_238.md5 | 2 +- inherit_graph_238.png | Bin 5189 -> 4878 bytes inherit_graph_239.map | 34 +- inherit_graph_239.md5 | 2 +- inherit_graph_239.png | Bin 112964 -> 5189 bytes inherit_graph_240.map | 34 +- inherit_graph_240.md5 | 2 +- inherit_graph_240.png | Bin 4210 -> 112964 bytes inherit_graph_241.map | 2 +- inherit_graph_241.md5 | 2 +- inherit_graph_241.png | Bin 4633 -> 4210 bytes inherit_graph_242.map | 5 +- inherit_graph_242.md5 | 2 +- inherit_graph_242.png | Bin 8599 -> 4633 bytes inherit_graph_243.map | 4 +- inherit_graph_243.md5 | 2 +- inherit_graph_243.png | Bin 2086 -> 8599 bytes inherit_graph_244.map | 2 +- inherit_graph_244.md5 | 2 +- inherit_graph_244.png | Bin 2395 -> 2086 bytes inherit_graph_245.map | 2 +- inherit_graph_245.md5 | 2 +- inherit_graph_245.png | Bin 1740 -> 2395 bytes inherit_graph_246.map | 2 +- inherit_graph_246.md5 | 2 +- inherit_graph_246.png | Bin 2192 -> 1740 bytes inherit_graph_247.map | 2 +- inherit_graph_247.md5 | 2 +- inherit_graph_247.png | Bin 2487 -> 2192 bytes inherit_graph_248.map | 3 +- inherit_graph_248.md5 | 2 +- inherit_graph_248.png | Bin 4416 -> 2487 bytes inherit_graph_249.map | 3 +- inherit_graph_249.md5 | 2 +- inherit_graph_249.png | Bin 1505 -> 4416 bytes inherit_graph_250.map | 3 +- inherit_graph_250.md5 | 2 +- inherit_graph_250.png | Bin 4839 -> 1505 bytes inherit_graph_251.map | 3 +- inherit_graph_251.md5 | 2 +- inherit_graph_251.png | Bin 2829 -> 4839 bytes inherit_graph_252.map | 2 +- inherit_graph_252.md5 | 2 +- inherit_graph_252.png | Bin 1840 -> 2829 bytes inherit_graph_253.map | 2 +- inherit_graph_253.md5 | 2 +- inherit_graph_253.png | Bin 2906 -> 1840 bytes inherit_graph_254.map | 2 +- inherit_graph_254.md5 | 2 +- inherit_graph_254.png | Bin 2392 -> 2906 bytes inherit_graph_255.map | 2 +- inherit_graph_255.md5 | 2 +- inherit_graph_255.png | Bin 1845 -> 2392 bytes inherit_graph_256.map | 2 +- inherit_graph_256.md5 | 2 +- inherit_graph_256.png | Bin 1695 -> 1845 bytes inherit_graph_257.map | 2 +- inherit_graph_257.md5 | 2 +- inherit_graph_257.png | Bin 5592 -> 1695 bytes inherit_graph_258.map | 2 +- inherit_graph_258.md5 | 2 +- inherit_graph_258.png | Bin 3742 -> 5592 bytes inherit_graph_259.map | 2 +- inherit_graph_259.md5 | 2 +- inherit_graph_259.png | Bin 3725 -> 3742 bytes inherit_graph_260.map | 2 +- inherit_graph_260.md5 | 2 +- inherit_graph_260.png | Bin 3474 -> 3725 bytes inherit_graph_261.map | 2 +- inherit_graph_261.md5 | 2 +- inherit_graph_261.png | Bin 2270 -> 3474 bytes inherit_graph_262.map | 2 +- inherit_graph_262.md5 | 2 +- inherit_graph_262.png | Bin 2668 -> 2270 bytes inherit_graph_263.map | 2 +- inherit_graph_263.md5 | 2 +- inherit_graph_263.png | Bin 2253 -> 2668 bytes inherit_graph_264.map | 2 +- inherit_graph_264.md5 | 2 +- inherit_graph_264.png | Bin 2140 -> 2253 bytes inherit_graph_265.map | 2 +- inherit_graph_265.md5 | 2 +- inherit_graph_265.png | Bin 3361 -> 2140 bytes inherit_graph_266.map | 2 +- inherit_graph_266.md5 | 2 +- inherit_graph_266.png | Bin 2658 -> 3361 bytes inherit_graph_267.map | 2 +- inherit_graph_267.md5 | 2 +- inherit_graph_267.png | Bin 2135 -> 2658 bytes inherit_graph_268.map | 2 +- inherit_graph_268.md5 | 2 +- inherit_graph_268.png | Bin 2181 -> 2135 bytes inherit_graph_269.map | 2 +- inherit_graph_269.md5 | 2 +- inherit_graph_269.png | Bin 1904 -> 2181 bytes inherit_graph_270.map | 2 +- inherit_graph_270.md5 | 2 +- inherit_graph_270.png | Bin 2231 -> 1904 bytes inherit_graph_271.map | 2 +- inherit_graph_271.md5 | 2 +- inherit_graph_271.png | Bin 2760 -> 2231 bytes inherit_graph_272.map | 2 +- inherit_graph_272.md5 | 2 +- inherit_graph_272.png | Bin 2426 -> 2760 bytes inherit_graph_273.map | 2 +- inherit_graph_273.md5 | 2 +- inherit_graph_273.png | Bin 2157 -> 2426 bytes inherit_graph_274.map | 2 +- inherit_graph_274.md5 | 2 +- inherit_graph_274.png | Bin 1721 -> 2157 bytes inherit_graph_275.map | 2 +- inherit_graph_275.md5 | 2 +- inherit_graph_275.png | Bin 1982 -> 1721 bytes inherit_graph_276.map | 3 +- inherit_graph_276.md5 | 2 +- inherit_graph_276.png | Bin 3482 -> 1982 bytes inherit_graph_277.map | 3 +- inherit_graph_277.md5 | 2 +- inherit_graph_277.png | Bin 1868 -> 3482 bytes inherit_graph_278.map | 2 +- inherit_graph_278.md5 | 2 +- inherit_graph_278.png | Bin 3240 -> 1868 bytes inherit_graph_279.map | 2 +- inherit_graph_279.md5 | 2 +- inherit_graph_279.png | Bin 3720 -> 3240 bytes inherit_graph_280.map | 2 +- inherit_graph_280.md5 | 2 +- inherit_graph_280.png | Bin 1935 -> 3720 bytes inherit_graph_281.map | 2 +- inherit_graph_281.md5 | 2 +- inherit_graph_281.png | Bin 2481 -> 1935 bytes inherit_graph_282.map | 2 +- inherit_graph_282.md5 | 2 +- inherit_graph_282.png | Bin 2305 -> 2481 bytes inherit_graph_283.map | 2 +- inherit_graph_283.md5 | 2 +- inherit_graph_283.png | Bin 2107 -> 2305 bytes inherit_graph_284.map | 2 +- inherit_graph_284.md5 | 2 +- inherit_graph_284.png | Bin 2799 -> 2107 bytes inherit_graph_285.map | 3 +- inherit_graph_285.md5 | 2 +- inherit_graph_285.png | Bin 4311 -> 2799 bytes inherit_graph_286.map | 3 +- inherit_graph_286.md5 | 2 +- inherit_graph_286.png | Bin 4086 -> 4311 bytes inherit_graph_287.map | 3 +- inherit_graph_287.md5 | 2 +- inherit_graph_287.png | Bin 5022 -> 4086 bytes inherit_graph_288.map | 4 +- inherit_graph_288.md5 | 2 +- inherit_graph_288.png | Bin 4997 -> 5022 bytes inherit_graph_289.map | 3 +- inherit_graph_289.md5 | 2 +- inherit_graph_289.png | Bin 3615 -> 4997 bytes inherit_graph_290.map | 2 +- inherit_graph_290.md5 | 2 +- inherit_graph_290.png | Bin 2304 -> 3615 bytes inherit_graph_291.map | 2 +- inherit_graph_291.md5 | 2 +- inherit_graph_291.png | Bin 1654 -> 2304 bytes inherit_graph_292.map | 2 +- inherit_graph_292.md5 | 2 +- inherit_graph_292.png | Bin 2601 -> 1654 bytes inherit_graph_293.map | 2 +- inherit_graph_293.md5 | 2 +- inherit_graph_293.png | Bin 2633 -> 2601 bytes inherit_graph_294.map | 2 +- inherit_graph_294.md5 | 2 +- inherit_graph_294.png | Bin 1747 -> 2633 bytes inherit_graph_295.map | 2 +- inherit_graph_295.md5 | 2 +- inherit_graph_295.png | Bin 964 -> 1747 bytes inherit_graph_296.map | 2 +- inherit_graph_296.md5 | 2 +- inherit_graph_296.png | Bin 2065 -> 964 bytes inherit_graph_297.map | 2 +- inherit_graph_297.md5 | 2 +- inherit_graph_297.png | Bin 2861 -> 2065 bytes inherit_graph_298.map | 2 +- inherit_graph_298.md5 | 2 +- inherit_graph_298.png | Bin 2800 -> 2861 bytes inherit_graph_299.map | 2 +- inherit_graph_299.md5 | 2 +- inherit_graph_299.png | Bin 1619 -> 2800 bytes inherit_graph_300.map | 2 +- inherit_graph_300.md5 | 2 +- inherit_graph_300.png | Bin 1861 -> 1619 bytes inherit_graph_301.map | 4 +- inherit_graph_301.md5 | 2 +- inherit_graph_301.png | Bin 6421 -> 1861 bytes inherit_graph_302.map | 4 +- inherit_graph_302.md5 | 2 +- inherit_graph_302.png | Bin 984 -> 6421 bytes inherit_graph_303.map | 2 +- inherit_graph_303.md5 | 2 +- inherit_graph_303.png | Bin 1272 -> 984 bytes inherit_graph_304.map | 3 +- inherit_graph_304.md5 | 2 +- inherit_graph_304.png | Bin 2023 -> 1272 bytes inherit_graph_305.map | 3 +- inherit_graph_305.md5 | 2 +- inherit_graph_305.png | Bin 1750 -> 2023 bytes inherit_graph_306.map | 2 +- inherit_graph_306.md5 | 2 +- inherit_graph_306.png | Bin 2013 -> 1750 bytes inherit_graph_307.map | 2 +- inherit_graph_307.md5 | 2 +- inherit_graph_307.png | Bin 1508 -> 2013 bytes inherit_graph_308.map | 3 +- inherit_graph_308.md5 | 2 +- inherit_graph_308.png | Bin 4133 -> 1508 bytes inherit_graph_309.map | 3 +- inherit_graph_309.md5 | 2 +- inherit_graph_309.png | Bin 1705 -> 4133 bytes inherit_graph_310.map | 2 +- inherit_graph_310.md5 | 2 +- inherit_graph_310.png | Bin 2020 -> 1705 bytes inherit_graph_311.map | 4 +- inherit_graph_311.md5 | 2 +- inherit_graph_311.png | Bin 7348 -> 2020 bytes inherit_graph_312.map | 5 +- inherit_graph_312.md5 | 2 +- inherit_graph_312.png | Bin 2740 -> 7348 bytes inherit_graph_313.map | 3 +- inherit_graph_313.md5 | 2 +- inherit_graph_313.png | Bin 2199 -> 2740 bytes inherit_graph_314.map | 4 +- inherit_graph_314.md5 | 2 +- inherit_graph_314.png | Bin 4017 -> 2199 bytes inherit_graph_315.map | 4 +- inherit_graph_315.md5 | 2 +- inherit_graph_315.png | Bin 3563 -> 4017 bytes inherit_graph_316.map | 2 +- inherit_graph_316.md5 | 2 +- inherit_graph_316.png | Bin 2650 -> 3563 bytes inherit_graph_317.map | 2 +- inherit_graph_317.md5 | 2 +- inherit_graph_317.png | Bin 1252 -> 2650 bytes inherit_graph_318.map | 2 +- inherit_graph_318.md5 | 2 +- inherit_graph_318.png | Bin 1033 -> 1252 bytes inherit_graph_319.map | 2 +- inherit_graph_319.md5 | 2 +- inherit_graph_319.png | Bin 1693 -> 1033 bytes inherit_graph_320.map | 2 +- inherit_graph_320.md5 | 2 +- inherit_graph_320.png | Bin 1513 -> 1693 bytes inherit_graph_321.map | 2 +- inherit_graph_321.md5 | 2 +- inherit_graph_321.png | Bin 1452 -> 1513 bytes inherit_graph_322.map | 2 +- inherit_graph_322.md5 | 2 +- inherit_graph_322.png | Bin 1629 -> 1452 bytes inherit_graph_323.map | 2 +- inherit_graph_323.md5 | 2 +- inherit_graph_323.png | Bin 2027 -> 1629 bytes inherit_graph_324.map | 2 +- inherit_graph_324.md5 | 2 +- inherit_graph_324.png | Bin 2109 -> 2027 bytes inherit_graph_325.map | 2 +- inherit_graph_325.md5 | 2 +- inherit_graph_325.png | Bin 1621 -> 2109 bytes inherit_graph_326.map | 2 +- inherit_graph_326.md5 | 2 +- inherit_graph_326.png | Bin 1571 -> 1621 bytes inherit_graph_327.map | 2 +- inherit_graph_327.md5 | 2 +- inherit_graph_327.png | Bin 1218 -> 1571 bytes inherit_graph_328.map | 2 +- inherit_graph_328.md5 | 2 +- inherit_graph_328.png | Bin 1494 -> 1218 bytes inherit_graph_329.map | 2 +- inherit_graph_329.md5 | 2 +- inherit_graph_329.png | Bin 1504 -> 1494 bytes inherit_graph_330.map | 2 +- inherit_graph_330.md5 | 2 +- inherit_graph_330.png | Bin 1457 -> 1504 bytes inherit_graph_331.map | 2 +- inherit_graph_331.md5 | 2 +- inherit_graph_331.png | Bin 2723 -> 1457 bytes inherit_graph_332.map | 3 +- inherit_graph_332.md5 | 2 +- inherit_graph_332.png | Bin 4967 -> 2723 bytes inherit_graph_333.map | 3 +- inherit_graph_333.md5 | 2 +- inherit_graph_333.png | Bin 3485 -> 4967 bytes inherit_graph_334.map | 2 +- inherit_graph_334.md5 | 2 +- inherit_graph_334.png | Bin 3568 -> 3485 bytes inherit_graph_335.map | 3 +- inherit_graph_335.md5 | 2 +- inherit_graph_335.png | Bin 4882 -> 3568 bytes inherit_graph_336.map | 4 +- inherit_graph_336.md5 | 2 +- inherit_graph_336.png | Bin 4308 -> 4882 bytes inherit_graph_337.map | 3 +- inherit_graph_337.md5 | 2 +- inherit_graph_337.png | Bin 2439 -> 4308 bytes inherit_graph_338.map | 2 +- inherit_graph_338.md5 | 2 +- inherit_graph_338.png | Bin 2652 -> 2439 bytes inherit_graph_339.map | 2 +- inherit_graph_339.md5 | 2 +- inherit_graph_339.png | Bin 2619 -> 2652 bytes inherit_graph_340.map | 2 +- inherit_graph_340.md5 | 2 +- inherit_graph_340.png | Bin 1590 -> 2619 bytes inherit_graph_341.map | 2 +- inherit_graph_341.md5 | 2 +- inherit_graph_341.png | Bin 2482 -> 1590 bytes inherit_graph_342.map | 2 +- inherit_graph_342.md5 | 2 +- inherit_graph_342.png | Bin 1251 -> 2482 bytes inherit_graph_343.map | 2 +- inherit_graph_343.md5 | 2 +- inherit_graph_343.png | Bin 1733 -> 1251 bytes inherit_graph_344.map | 2 +- inherit_graph_344.md5 | 2 +- inherit_graph_344.png | Bin 1434 -> 1733 bytes inherit_graph_345.map | 2 +- inherit_graph_345.md5 | 2 +- inherit_graph_345.png | Bin 1846 -> 1434 bytes inherit_graph_346.map | 2 +- inherit_graph_346.md5 | 2 +- inherit_graph_346.png | Bin 2391 -> 1846 bytes inherit_graph_347.map | 2 +- inherit_graph_347.md5 | 2 +- inherit_graph_347.png | Bin 2652 -> 2391 bytes inherit_graph_348.map | 2 +- inherit_graph_348.md5 | 2 +- inherit_graph_348.png | Bin 2252 -> 2652 bytes inherit_graph_349.map | 2 +- inherit_graph_349.md5 | 2 +- inherit_graph_349.png | Bin 1564 -> 2252 bytes inherit_graph_350.map | 2 +- inherit_graph_350.md5 | 2 +- inherit_graph_350.png | Bin 1715 -> 1564 bytes inherit_graph_351.map | 2 +- inherit_graph_351.md5 | 2 +- inherit_graph_351.png | Bin 2246 -> 1715 bytes inherit_graph_352.map | 2 +- inherit_graph_352.md5 | 2 +- inherit_graph_352.png | Bin 2571 -> 2246 bytes inherit_graph_353.map | 2 +- inherit_graph_353.md5 | 2 +- inherit_graph_353.png | Bin 1831 -> 2571 bytes inherit_graph_354.map | 2 +- inherit_graph_354.md5 | 2 +- inherit_graph_354.png | Bin 1377 -> 1831 bytes inherit_graph_355.map | 2 +- inherit_graph_355.md5 | 2 +- inherit_graph_355.png | Bin 1618 -> 1377 bytes inherit_graph_356.map | 2 +- inherit_graph_356.md5 | 2 +- inherit_graph_356.png | Bin 1671 -> 1618 bytes inherit_graph_357.map | 2 +- inherit_graph_357.md5 | 2 +- inherit_graph_357.png | Bin 1752 -> 1671 bytes inherit_graph_358.map | 2 +- inherit_graph_358.md5 | 2 +- inherit_graph_358.png | Bin 1621 -> 1752 bytes inherit_graph_359.map | 2 +- inherit_graph_359.md5 | 2 +- inherit_graph_359.png | Bin 2206 -> 1621 bytes inherit_graph_360.map | 2 +- inherit_graph_360.md5 | 2 +- inherit_graph_360.png | Bin 1446 -> 2206 bytes inherit_graph_361.map | 3 +- inherit_graph_361.md5 | 2 +- inherit_graph_361.png | Bin 2274 -> 1446 bytes inherit_graph_362.map | 3 +- inherit_graph_362.md5 | 2 +- inherit_graph_362.png | Bin 1985 -> 2274 bytes inherit_graph_363.map | 2 +- inherit_graph_363.md5 | 2 +- inherit_graph_363.png | Bin 1942 -> 1985 bytes inherit_graph_364.map | 5 +- inherit_graph_364.md5 | 2 +- inherit_graph_364.png | Bin 9372 -> 1942 bytes inherit_graph_365.map | 5 +- inherit_graph_365.md5 | 2 +- inherit_graph_365.png | Bin 1409 -> 9372 bytes inherit_graph_366.map | 2 +- inherit_graph_366.md5 | 2 +- inherit_graph_366.png | Bin 1501 -> 1409 bytes inherit_graph_367.map | 2 +- inherit_graph_367.md5 | 2 +- inherit_graph_367.png | Bin 1818 -> 1501 bytes inherit_graph_368.map | 2 +- inherit_graph_368.md5 | 2 +- inherit_graph_368.png | Bin 1439 -> 1818 bytes inherit_graph_369.map | 2 +- inherit_graph_369.md5 | 2 +- inherit_graph_369.png | Bin 1929 -> 1439 bytes inherit_graph_370.map | 2 +- inherit_graph_370.md5 | 2 +- inherit_graph_370.png | Bin 2038 -> 1929 bytes inherit_graph_371.map | 2 +- inherit_graph_371.md5 | 2 +- inherit_graph_371.png | Bin 1699 -> 2038 bytes inherit_graph_372.map | 2 +- inherit_graph_372.md5 | 2 +- inherit_graph_372.png | Bin 2220 -> 1699 bytes inherit_graph_373.map | 2 +- inherit_graph_373.md5 | 2 +- inherit_graph_373.png | Bin 2114 -> 2220 bytes inherit_graph_374.map | 2 +- inherit_graph_374.md5 | 2 +- inherit_graph_374.png | Bin 1347 -> 2114 bytes inherit_graph_375.map | 2 +- inherit_graph_375.md5 | 2 +- inherit_graph_375.png | Bin 2096 -> 1347 bytes inherit_graph_376.map | 2 +- inherit_graph_376.md5 | 2 +- inherit_graph_376.png | Bin 2851 -> 2096 bytes inherit_graph_377.map | 2 +- inherit_graph_377.md5 | 2 +- inherit_graph_377.png | Bin 1629 -> 2851 bytes inherit_graph_378.map | 2 +- inherit_graph_378.md5 | 2 +- inherit_graph_378.png | Bin 3249 -> 1629 bytes inherit_graph_379.map | 2 +- inherit_graph_379.md5 | 2 +- inherit_graph_379.png | Bin 3469 -> 3249 bytes inherit_graph_380.map | 2 +- inherit_graph_380.md5 | 2 +- inherit_graph_380.png | Bin 4082 -> 3469 bytes inherit_graph_381.map | 2 +- inherit_graph_381.md5 | 2 +- inherit_graph_381.png | Bin 3869 -> 4082 bytes inherit_graph_382.map | 2 +- inherit_graph_382.md5 | 2 +- inherit_graph_382.png | Bin 2773 -> 3869 bytes inherit_graph_383.map | 2 +- inherit_graph_383.md5 | 2 +- inherit_graph_383.png | Bin 3793 -> 2773 bytes inherit_graph_384.map | 2 +- inherit_graph_384.md5 | 2 +- inherit_graph_384.png | Bin 3596 -> 3793 bytes inherit_graph_385.map | 2 +- inherit_graph_385.md5 | 2 +- inherit_graph_385.png | Bin 4101 -> 3596 bytes inherit_graph_386.map | 2 +- inherit_graph_386.md5 | 2 +- inherit_graph_386.png | Bin 3262 -> 4101 bytes inherit_graph_387.map | 2 +- inherit_graph_387.md5 | 2 +- inherit_graph_387.png | Bin 1780 -> 3262 bytes inherit_graph_388.map | 2 +- inherit_graph_388.md5 | 2 +- inherit_graph_388.png | Bin 2179 -> 1780 bytes inherit_graph_389.map | 2 +- inherit_graph_389.md5 | 2 +- inherit_graph_389.png | Bin 2336 -> 2179 bytes inherit_graph_390.map | 2 +- inherit_graph_390.md5 | 2 +- inherit_graph_390.png | Bin 2103 -> 2336 bytes inherit_graph_391.map | 2 +- inherit_graph_391.md5 | 2 +- inherit_graph_391.png | Bin 2601 -> 2103 bytes inherit_graph_392.map | 3 +- inherit_graph_392.md5 | 2 +- inherit_graph_392.png | Bin 4734 -> 2601 bytes inherit_graph_393.map | 3 +- inherit_graph_393.md5 | 2 +- inherit_graph_393.png | Bin 2728 -> 4734 bytes inherit_graph_394.map | 5 +- inherit_graph_394.md5 | 2 +- inherit_graph_394.png | Bin 10335 -> 2728 bytes inherit_graph_395.map | 5 +- inherit_graph_395.md5 | 2 +- inherit_graph_395.png | Bin 3014 -> 10335 bytes inherit_graph_396.map | 2 +- inherit_graph_396.md5 | 2 +- inherit_graph_396.png | Bin 2774 -> 3014 bytes inherit_graph_397.map | 5 +- inherit_graph_397.md5 | 2 +- inherit_graph_397.png | Bin 10820 -> 2774 bytes inherit_graph_398.map | 5 +- inherit_graph_398.md5 | 2 +- inherit_graph_398.png | Bin 2339 -> 10820 bytes inherit_graph_399.map | 2 +- inherit_graph_399.md5 | 2 +- inherit_graph_399.png | Bin 2637 -> 2339 bytes inherit_graph_400.map | 2 +- inherit_graph_400.md5 | 2 +- inherit_graph_400.png | Bin 2192 -> 2637 bytes inherit_graph_401.map | 5 +- inherit_graph_401.md5 | 2 +- inherit_graph_401.png | Bin 9850 -> 2192 bytes inherit_graph_402.map | 5 +- inherit_graph_402.md5 | 2 +- inherit_graph_402.png | Bin 2179 -> 9850 bytes inherit_graph_403.map | 2 +- inherit_graph_403.md5 | 2 +- inherit_graph_403.png | Bin 2206 -> 2179 bytes inherit_graph_404.map | 3 +- inherit_graph_404.md5 | 2 +- inherit_graph_404.png | Bin 3101 -> 2206 bytes inherit_graph_405.map | 3 +- inherit_graph_405.md5 | 2 +- inherit_graph_405.png | Bin 2523 -> 3101 bytes inherit_graph_406.map | 2 +- inherit_graph_406.md5 | 2 +- inherit_graph_406.png | Bin 2178 -> 2523 bytes inherit_graph_407.map | 4 +- inherit_graph_407.md5 | 2 +- inherit_graph_407.png | Bin 8068 -> 2178 bytes inherit_graph_408.map | 4 +- inherit_graph_408.md5 | 2 +- inherit_graph_408.png | Bin 2213 -> 8068 bytes inherit_graph_409.map | 3 +- inherit_graph_409.md5 | 2 +- inherit_graph_409.png | Bin 4274 -> 2213 bytes inherit_graph_410.map | 3 +- inherit_graph_410.md5 | 2 +- inherit_graph_410.png | Bin 3920 -> 4274 bytes inherit_graph_411.map | 2 +- inherit_graph_411.md5 | 2 +- inherit_graph_411.png | Bin 2740 -> 3920 bytes inherit_graph_412.map | 2 +- inherit_graph_412.md5 | 2 +- inherit_graph_412.png | Bin 3025 -> 2740 bytes inherit_graph_413.map | 2 +- inherit_graph_413.md5 | 2 +- inherit_graph_413.png | Bin 3006 -> 3025 bytes inherit_graph_414.map | 2 +- inherit_graph_414.md5 | 2 +- inherit_graph_414.png | Bin 2049 -> 3006 bytes inherit_graph_415.map | 2 +- inherit_graph_415.md5 | 2 +- inherit_graph_415.png | Bin 1829 -> 2049 bytes inherit_graph_416.map | 2 +- inherit_graph_416.md5 | 2 +- inherit_graph_416.png | Bin 1198 -> 1829 bytes inherit_graph_417.map | 2 +- inherit_graph_417.md5 | 2 +- inherit_graph_417.png | Bin 1745 -> 1198 bytes inherit_graph_418.map | 2 +- inherit_graph_418.md5 | 2 +- inherit_graph_418.png | Bin 1748 -> 1745 bytes inherit_graph_419.map | 2 +- inherit_graph_419.md5 | 2 +- inherit_graph_419.png | Bin 2359 -> 1748 bytes inherit_graph_420.map | 2 +- inherit_graph_420.md5 | 2 +- inherit_graph_420.png | Bin 1639 -> 2359 bytes inherit_graph_421.map | 2 +- inherit_graph_421.md5 | 2 +- inherit_graph_421.png | Bin 1547 -> 1639 bytes inherit_graph_422.map | 2 +- inherit_graph_422.md5 | 2 +- inherit_graph_422.png | Bin 1519 -> 1547 bytes inherit_graph_423.map | 2 +- inherit_graph_423.md5 | 2 +- inherit_graph_423.png | Bin 2478 -> 1519 bytes inherit_graph_424.map | 2 +- inherit_graph_424.md5 | 2 +- inherit_graph_424.png | Bin 2229 -> 2478 bytes inherit_graph_425.map | 2 +- inherit_graph_425.md5 | 2 +- inherit_graph_425.png | Bin 2007 -> 2229 bytes inherit_graph_426.map | 2 +- inherit_graph_426.md5 | 2 +- inherit_graph_426.png | Bin 2095 -> 2007 bytes inherit_graph_427.map | 2 +- inherit_graph_427.md5 | 2 +- inherit_graph_427.png | Bin 2209 -> 2095 bytes inherit_graph_428.map | 2 +- inherit_graph_428.md5 | 2 +- inherit_graph_428.png | Bin 1817 -> 2209 bytes inherit_graph_429.map | 2 +- inherit_graph_429.md5 | 2 +- inherit_graph_429.png | Bin 1928 -> 1817 bytes inherit_graph_430.map | 14 +- inherit_graph_430.md5 | 2 +- inherit_graph_430.png | Bin 38488 -> 1928 bytes inherit_graph_431.map | 14 +- inherit_graph_431.md5 | 2 +- inherit_graph_431.png | Bin 2322 -> 38488 bytes inherit_graph_432.map | 2 +- inherit_graph_432.md5 | 2 +- inherit_graph_432.png | Bin 2931 -> 2322 bytes inherit_graph_433.map | 2 +- inherit_graph_433.md5 | 2 +- inherit_graph_433.png | Bin 2230 -> 2931 bytes inherit_graph_434.map | 2 +- inherit_graph_434.md5 | 2 +- inherit_graph_434.png | Bin 1600 -> 2230 bytes inherit_graph_435.map | 2 +- inherit_graph_435.md5 | 2 +- inherit_graph_435.png | Bin 1568 -> 1600 bytes inherit_graph_436.map | 2 +- inherit_graph_436.md5 | 2 +- inherit_graph_436.png | Bin 3998 -> 1568 bytes inherit_graph_437.map | 2 +- inherit_graph_437.md5 | 2 +- inherit_graph_437.png | Bin 4453 -> 3998 bytes inherit_graph_438.map | 2 +- inherit_graph_438.md5 | 2 +- inherit_graph_438.png | Bin 4286 -> 4453 bytes inherit_graph_439.map | 2 +- inherit_graph_439.md5 | 2 +- inherit_graph_439.png | Bin 4530 -> 4286 bytes inherit_graph_440.md5 | 2 +- inherit_graph_440.png | Bin 4599 -> 4530 bytes inherit_graph_441.md5 | 2 +- inherit_graph_441.png | Bin 4676 -> 4599 bytes inherit_graph_442.md5 | 2 +- inherit_graph_442.png | Bin 4487 -> 4676 bytes inherit_graph_443.md5 | 2 +- inherit_graph_443.png | Bin 4960 -> 4487 bytes inherit_graph_444.md5 | 2 +- inherit_graph_444.png | Bin 4838 -> 4960 bytes inherit_graph_445.map | 2 +- inherit_graph_445.md5 | 2 +- inherit_graph_445.png | Bin 2446 -> 4838 bytes inherit_graph_446.map | 2 +- inherit_graph_446.md5 | 2 +- inherit_graph_446.png | Bin 2823 -> 2446 bytes inherit_graph_447.map | 2 +- inherit_graph_447.md5 | 2 +- inherit_graph_447.png | Bin 1687 -> 2823 bytes inherit_graph_448.map | 2 +- inherit_graph_448.md5 | 2 +- inherit_graph_448.png | Bin 1995 -> 1687 bytes inherit_graph_449.map | 2 +- inherit_graph_449.md5 | 2 +- inherit_graph_449.png | Bin 2208 -> 1995 bytes inherit_graph_450.map | 2 +- inherit_graph_450.md5 | 2 +- inherit_graph_450.png | Bin 2001 -> 2208 bytes inherit_graph_451.map | 2 +- inherit_graph_451.md5 | 2 +- inherit_graph_451.png | Bin 1779 -> 2001 bytes inherit_graph_452.map | 2 +- inherit_graph_452.md5 | 2 +- inherit_graph_452.png | Bin 1467 -> 1779 bytes inherit_graph_453.map | 2 +- inherit_graph_453.md5 | 2 +- inherit_graph_453.png | Bin 1215 -> 1467 bytes inherit_graph_454.map | 2 +- inherit_graph_454.md5 | 2 +- inherit_graph_454.png | Bin 2055 -> 1215 bytes inherit_graph_455.map | 2 +- inherit_graph_455.md5 | 2 +- inherit_graph_455.png | Bin 2316 -> 2055 bytes inherit_graph_456.map | 2 +- inherit_graph_456.md5 | 2 +- inherit_graph_456.png | Bin 2589 -> 2316 bytes inherit_graph_457.map | 2 +- inherit_graph_457.md5 | 2 +- inherit_graph_457.png | Bin 3069 -> 2589 bytes inherit_graph_458.map | 2 +- inherit_graph_458.md5 | 2 +- inherit_graph_458.png | Bin 2573 -> 3069 bytes inherit_graph_459.map | 2 +- inherit_graph_459.md5 | 2 +- inherit_graph_459.png | Bin 1974 -> 2573 bytes inherit_graph_460.map | 2 +- inherit_graph_460.md5 | 2 +- inherit_graph_460.png | Bin 2420 -> 1974 bytes inherit_graph_461.map | 2 +- inherit_graph_461.md5 | 2 +- inherit_graph_461.png | Bin 2032 -> 2420 bytes inherit_graph_462.map | 3 +- inherit_graph_462.md5 | 2 +- inherit_graph_462.png | Bin 3777 -> 2032 bytes inherit_graph_463.map | 3 +- inherit_graph_463.md5 | 2 +- inherit_graph_463.png | Bin 3335 -> 3777 bytes inherit_graph_464.map | 2 +- inherit_graph_464.md5 | 2 +- inherit_graph_464.png | Bin 3849 -> 3335 bytes inherit_graph_465.map | 2 +- inherit_graph_465.md5 | 2 +- inherit_graph_465.png | Bin 1680 -> 3849 bytes inherit_graph_466.map | 2 +- inherit_graph_466.md5 | 2 +- inherit_graph_466.png | Bin 1586 -> 1680 bytes inherit_graph_467.map | 2 +- inherit_graph_467.md5 | 2 +- inherit_graph_467.png | Bin 3085 -> 1586 bytes inherit_graph_468.map | 2 +- inherit_graph_468.md5 | 2 +- inherit_graph_468.png | Bin 4049 -> 3085 bytes inherit_graph_469.map | 2 +- inherit_graph_469.md5 | 2 +- inherit_graph_469.png | Bin 2580 -> 4049 bytes inherit_graph_470.map | 2 +- inherit_graph_470.md5 | 2 +- inherit_graph_470.png | Bin 3111 -> 2580 bytes inherit_graph_471.map | 2 +- inherit_graph_471.md5 | 2 +- inherit_graph_471.png | Bin 2507 -> 3111 bytes inherit_graph_472.map | 2 +- inherit_graph_472.md5 | 2 +- inherit_graph_472.png | Bin 2253 -> 2507 bytes inherit_graph_473.map | 2 +- inherit_graph_473.md5 | 2 +- inherit_graph_473.png | Bin 2398 -> 2253 bytes inherit_graph_474.map | 3 +- inherit_graph_474.md5 | 2 +- inherit_graph_474.png | Bin 2572 -> 2398 bytes inherit_graph_475.map | 3 +- inherit_graph_475.md5 | 2 +- inherit_graph_475.png | Bin 2258 -> 2572 bytes inherit_graph_476.map | 2 +- inherit_graph_476.md5 | 2 +- inherit_graph_476.png | Bin 2245 -> 2258 bytes inherit_graph_477.map | 4 +- inherit_graph_477.md5 | 2 +- inherit_graph_477.png | Bin 3764 -> 2245 bytes inherit_graph_478.map | 4 +- inherit_graph_478.md5 | 2 +- inherit_graph_478.png | Bin 2358 -> 3764 bytes inherit_graph_479.map | 4 +- inherit_graph_479.md5 | 2 +- inherit_graph_479.png | Bin 6848 -> 2358 bytes inherit_graph_480.map | 4 +- inherit_graph_480.md5 | 2 +- inherit_graph_480.png | Bin 2082 -> 6848 bytes inherit_graph_481.map | 2 +- inherit_graph_481.md5 | 2 +- inherit_graph_481.png | Bin 2894 -> 2082 bytes inherit_graph_482.map | 2 +- inherit_graph_482.md5 | 2 +- inherit_graph_482.png | Bin 1683 -> 2894 bytes inherit_graph_483.map | 2 +- inherit_graph_483.md5 | 2 +- inherit_graph_483.png | Bin 1890 -> 1683 bytes inherit_graph_484.map | 2 +- inherit_graph_484.md5 | 2 +- inherit_graph_484.png | Bin 1983 -> 1890 bytes inherit_graph_485.map | 5 +- inherit_graph_485.md5 | 2 +- inherit_graph_485.png | Bin 7115 -> 1983 bytes inherit_graph_486.map | 7 +- inherit_graph_486.md5 | 2 +- inherit_graph_486.png | Bin 6742 -> 7115 bytes inherit_graph_487.map | 4 +- inherit_graph_487.md5 | 2 +- inherit_graph_487.png | Bin 2007 -> 6742 bytes inherit_graph_488.map | 2 +- inherit_graph_488.md5 | 2 +- inherit_graph_488.png | Bin 3489 -> 2007 bytes inherit_graph_489.md5 | 2 +- inherit_graph_489.png | Bin 3557 -> 3489 bytes inherit_graph_490.map | 2 +- inherit_graph_490.md5 | 2 +- inherit_graph_490.png | Bin 1985 -> 3557 bytes inherit_graph_491.map | 4 +- inherit_graph_491.md5 | 2 +- inherit_graph_491.png | Bin 5834 -> 1985 bytes inherit_graph_492.map | 4 +- inherit_graph_492.md5 | 2 +- inherit_graph_492.png | Bin 2065 -> 5834 bytes inherit_graph_493.map | 2 +- inherit_graph_493.md5 | 2 +- inherit_graph_493.png | Bin 2414 -> 2065 bytes inherit_graph_494.map | 2 +- inherit_graph_494.md5 | 2 +- inherit_graph_494.png | Bin 2579 -> 2414 bytes inherit_graph_495.map | 2 +- inherit_graph_495.md5 | 2 +- inherit_graph_495.png | Bin 2746 -> 2579 bytes inherit_graph_496.map | 2 +- inherit_graph_496.md5 | 2 +- inherit_graph_496.png | Bin 1973 -> 2746 bytes inherit_graph_497.map | 2 +- inherit_graph_497.md5 | 2 +- inherit_graph_497.png | Bin 2228 -> 1973 bytes inherit_graph_498.map | 2 +- inherit_graph_498.md5 | 2 +- inherit_graph_498.png | Bin 1127 -> 2228 bytes inherit_graph_499.map | 2 +- inherit_graph_499.md5 | 2 +- inherit_graph_499.png | Bin 2059 -> 1127 bytes inherit_graph_500.map | 2 +- inherit_graph_500.md5 | 2 +- inherit_graph_500.png | Bin 1825 -> 2059 bytes inherit_graph_501.map | 2 +- inherit_graph_501.md5 | 2 +- inherit_graph_501.png | Bin 1908 -> 1825 bytes inherit_graph_502.map | 2 +- inherit_graph_502.md5 | 2 +- inherit_graph_502.png | Bin 1849 -> 1908 bytes inherit_graph_503.map | 2 +- inherit_graph_503.md5 | 2 +- inherit_graph_503.png | Bin 1532 -> 1849 bytes inherit_graph_504.map | 2 +- inherit_graph_504.md5 | 2 +- inherit_graph_504.png | Bin 2060 -> 1532 bytes inherit_graph_505.map | 2 +- inherit_graph_505.md5 | 2 +- inherit_graph_505.png | Bin 2784 -> 2060 bytes inherit_graph_506.map | 2 +- inherit_graph_506.md5 | 2 +- inherit_graph_506.png | Bin 3059 -> 2784 bytes inherit_graph_507.map | 2 +- inherit_graph_507.md5 | 2 +- inherit_graph_507.png | Bin 3860 -> 3059 bytes inherit_graph_508.map | 2 +- inherit_graph_508.md5 | 2 +- inherit_graph_508.png | Bin 3561 -> 3860 bytes inherit_graph_509.map | 2 +- inherit_graph_509.md5 | 2 +- inherit_graph_509.png | Bin 3601 -> 3561 bytes inherit_graph_510.map | 2 +- inherit_graph_510.md5 | 2 +- inherit_graph_510.png | Bin 1696 -> 3601 bytes inherit_graph_511.map | 2 +- inherit_graph_511.md5 | 2 +- inherit_graph_511.png | Bin 2380 -> 1696 bytes inherit_graph_512.map | 2 +- inherit_graph_512.md5 | 2 +- inherit_graph_512.png | Bin 2084 -> 2380 bytes inherit_graph_513.map | 2 +- inherit_graph_513.md5 | 2 +- inherit_graph_513.png | Bin 1704 -> 2084 bytes inherit_graph_514.map | 2 +- inherit_graph_514.md5 | 2 +- inherit_graph_514.png | Bin 1797 -> 1704 bytes inherit_graph_515.map | 2 +- inherit_graph_515.md5 | 2 +- inherit_graph_515.png | Bin 1394 -> 1797 bytes inherit_graph_516.map | 2 +- inherit_graph_516.md5 | 2 +- inherit_graph_516.png | Bin 1643 -> 1394 bytes inherit_graph_517.map | 2 +- inherit_graph_517.md5 | 2 +- inherit_graph_517.png | Bin 2319 -> 1643 bytes inherit_graph_518.map | 2 +- inherit_graph_518.md5 | 2 +- inherit_graph_518.png | Bin 2021 -> 2319 bytes inherit_graph_519.map | 2 +- inherit_graph_519.md5 | 2 +- inherit_graph_519.png | Bin 2910 -> 2021 bytes inherit_graph_520.map | 2 +- inherit_graph_520.md5 | 2 +- inherit_graph_520.png | Bin 1974 -> 2910 bytes inherit_graph_521.map | 2 +- inherit_graph_521.md5 | 2 +- inherit_graph_521.png | Bin 2446 -> 1974 bytes inherit_graph_522.map | 2 +- inherit_graph_522.md5 | 2 +- inherit_graph_522.png | Bin 2859 -> 2446 bytes inherit_graph_523.map | 2 +- inherit_graph_523.md5 | 2 +- inherit_graph_523.png | Bin 3377 -> 2859 bytes inherit_graph_524.map | 2 +- inherit_graph_524.md5 | 2 +- inherit_graph_524.png | Bin 3549 -> 3377 bytes inherit_graph_525.map | 2 +- inherit_graph_525.md5 | 2 +- inherit_graph_525.png | Bin 3262 -> 3549 bytes inherit_graph_526.map | 2 +- inherit_graph_526.md5 | 2 +- inherit_graph_526.png | Bin 3018 -> 3262 bytes inherit_graph_527.map | 2 +- inherit_graph_527.md5 | 2 +- inherit_graph_527.png | Bin 3574 -> 3018 bytes inherit_graph_528.map | 2 +- inherit_graph_528.md5 | 2 +- inherit_graph_528.png | Bin 3400 -> 3574 bytes inherit_graph_529.map | 2 +- inherit_graph_529.md5 | 2 +- inherit_graph_529.png | Bin 3046 -> 3400 bytes inherit_graph_530.map | 2 +- inherit_graph_530.md5 | 2 +- inherit_graph_530.png | Bin 3632 -> 3046 bytes inherit_graph_531.map | 2 +- inherit_graph_531.md5 | 2 +- inherit_graph_531.png | Bin 3385 -> 3632 bytes inherit_graph_532.map | 4 +- inherit_graph_532.md5 | 2 +- inherit_graph_532.png | Bin 3771 -> 3385 bytes inherit_graph_533.map | 4 +- inherit_graph_533.md5 | 2 +- inherit_graph_533.png | Bin 2914 -> 3771 bytes inherit_graph_534.map | 2 +- inherit_graph_534.md5 | 2 +- inherit_graph_534.png | Bin 2993 -> 2914 bytes inherit_graph_535.map | 2 +- inherit_graph_535.md5 | 2 +- inherit_graph_535.png | Bin 3068 -> 2993 bytes inherit_graph_536.map | 2 +- inherit_graph_536.md5 | 2 +- inherit_graph_536.png | Bin 3407 -> 3068 bytes inherit_graph_537.map | 2 +- inherit_graph_537.md5 | 2 +- inherit_graph_537.png | Bin 2741 -> 3407 bytes inherit_graph_538.map | 2 +- inherit_graph_538.md5 | 2 +- inherit_graph_538.png | Bin 2772 -> 2741 bytes inherit_graph_539.map | 2 +- inherit_graph_539.md5 | 2 +- inherit_graph_539.png | Bin 2450 -> 2772 bytes inherit_graph_540.map | 2 +- inherit_graph_540.md5 | 2 +- inherit_graph_540.png | Bin 2139 -> 2450 bytes inherit_graph_541.map | 2 +- inherit_graph_541.md5 | 2 +- inherit_graph_541.png | Bin 1981 -> 2139 bytes inherit_graph_542.map | 2 +- inherit_graph_542.md5 | 2 +- inherit_graph_542.png | Bin 1808 -> 1981 bytes inherit_graph_543.map | 2 +- inherit_graph_543.md5 | 2 +- inherit_graph_543.png | Bin 2201 -> 1808 bytes inherit_graph_544.map | 2 +- inherit_graph_544.md5 | 2 +- inherit_graph_544.png | Bin 1814 -> 2201 bytes inherit_graph_545.map | 2 +- inherit_graph_545.md5 | 2 +- inherit_graph_545.png | Bin 2057 -> 1814 bytes inherit_graph_546.map | 2 +- inherit_graph_546.md5 | 2 +- inherit_graph_546.png | Bin 1865 -> 2057 bytes inherit_graph_547.map | 2 +- inherit_graph_547.md5 | 2 +- inherit_graph_547.png | Bin 2293 -> 1865 bytes inherit_graph_548.map | 2 +- inherit_graph_548.md5 | 2 +- inherit_graph_548.png | Bin 2475 -> 2293 bytes inherit_graph_549.map | 2 +- inherit_graph_549.md5 | 2 +- inherit_graph_549.png | Bin 2381 -> 2475 bytes inherit_graph_550.map | 2 +- inherit_graph_550.md5 | 2 +- inherit_graph_550.png | Bin 1450 -> 2381 bytes inherit_graph_551.map | 2 +- inherit_graph_551.md5 | 2 +- inherit_graph_551.png | Bin 1316 -> 1450 bytes inherit_graph_552.map | 2 +- inherit_graph_552.md5 | 2 +- inherit_graph_552.png | Bin 2864 -> 1316 bytes inherit_graph_553.map | 4 +- inherit_graph_553.md5 | 2 +- inherit_graph_553.png | Bin 7956 -> 2864 bytes inherit_graph_554.map | 4 +- inherit_graph_554.md5 | 2 +- inherit_graph_554.png | Bin 2813 -> 7956 bytes inherit_graph_555.map | 2 +- inherit_graph_555.md5 | 2 +- inherit_graph_555.png | Bin 2844 -> 2813 bytes inherit_graph_556.map | 2 +- inherit_graph_556.md5 | 2 +- inherit_graph_556.png | Bin 1664 -> 2844 bytes inherit_graph_557.map | 2 +- inherit_graph_557.md5 | 2 +- inherit_graph_557.png | Bin 1666 -> 1664 bytes inherit_graph_558.map | 2 +- inherit_graph_558.md5 | 2 +- inherit_graph_558.png | Bin 2572 -> 1666 bytes inherit_graph_559.map | 2 +- inherit_graph_559.md5 | 2 +- inherit_graph_559.png | Bin 2126 -> 2572 bytes inherit_graph_560.map | 2 +- inherit_graph_560.md5 | 2 +- inherit_graph_560.png | Bin 1940 -> 2126 bytes inherit_graph_561.map | 2 +- inherit_graph_561.md5 | 2 +- inherit_graph_561.png | Bin 2350 -> 1940 bytes inherit_graph_562.map | 2 +- inherit_graph_562.md5 | 2 +- inherit_graph_562.png | Bin 1759 -> 2350 bytes inherit_graph_563.map | 2 +- inherit_graph_563.md5 | 2 +- inherit_graph_563.png | Bin 2244 -> 1759 bytes inherit_graph_564.map | 2 +- inherit_graph_564.md5 | 2 +- inherit_graph_564.png | Bin 2110 -> 2244 bytes inherit_graph_565.map | 2 +- inherit_graph_565.md5 | 2 +- inherit_graph_565.png | Bin 2216 -> 2110 bytes inherit_graph_566.map | 2 +- inherit_graph_566.md5 | 2 +- inherit_graph_566.png | Bin 1597 -> 2216 bytes inherit_graph_567.map | 2 +- inherit_graph_567.md5 | 2 +- inherit_graph_567.png | Bin 1559 -> 1597 bytes inherit_graph_568.map | 2 +- inherit_graph_568.md5 | 2 +- inherit_graph_568.png | Bin 1185 -> 1559 bytes inherit_graph_569.map | 2 +- inherit_graph_569.md5 | 2 +- inherit_graph_569.png | Bin 1374 -> 1185 bytes inherit_graph_570.map | 2 +- inherit_graph_570.md5 | 2 +- inherit_graph_570.png | Bin 1531 -> 1374 bytes inherit_graph_571.map | 2 +- inherit_graph_571.md5 | 2 +- inherit_graph_571.png | Bin 2408 -> 1531 bytes inherit_graph_572.map | 2 +- inherit_graph_572.md5 | 2 +- inherit_graph_572.png | Bin 2064 -> 2408 bytes inherit_graph_573.map | 2 +- inherit_graph_573.md5 | 2 +- inherit_graph_573.png | Bin 2040 -> 2064 bytes inherit_graph_574.map | 2 +- inherit_graph_574.md5 | 2 +- inherit_graph_574.png | Bin 1996 -> 2040 bytes inherit_graph_575.map | 2 +- inherit_graph_575.md5 | 2 +- inherit_graph_575.png | Bin 2576 -> 1996 bytes inherit_graph_576.map | 2 +- inherit_graph_576.md5 | 2 +- inherit_graph_576.png | Bin 1593 -> 2576 bytes inherit_graph_577.map | 2 +- inherit_graph_577.md5 | 2 +- inherit_graph_577.png | Bin 2619 -> 1593 bytes inherit_graph_578.map | 2 +- inherit_graph_578.md5 | 2 +- inherit_graph_578.png | Bin 1455 -> 2619 bytes inherit_graph_579.map | 2 +- inherit_graph_579.md5 | 2 +- inherit_graph_579.png | Bin 1150 -> 1455 bytes inherit_graph_580.map | 2 +- inherit_graph_580.md5 | 2 +- inherit_graph_580.png | Bin 1766 -> 1150 bytes inherit_graph_581.map | 2 +- inherit_graph_581.md5 | 2 +- inherit_graph_581.png | Bin 2714 -> 1766 bytes inherit_graph_582.map | 2 +- inherit_graph_582.md5 | 2 +- inherit_graph_582.png | Bin 2371 -> 2714 bytes inherit_graph_583.map | 2 +- inherit_graph_583.md5 | 2 +- inherit_graph_583.png | Bin 2299 -> 2371 bytes inherit_graph_584.map | 2 +- inherit_graph_584.md5 | 2 +- inherit_graph_584.png | Bin 1767 -> 2299 bytes inherit_graph_585.map | 2 +- inherit_graph_585.md5 | 2 +- inherit_graph_585.png | Bin 1288 -> 1767 bytes inherit_graph_586.map | 2 +- inherit_graph_586.md5 | 2 +- inherit_graph_586.png | Bin 1281 -> 1288 bytes inherit_graph_587.map | 3 +- inherit_graph_587.md5 | 2 +- inherit_graph_587.png | Bin 3450 -> 1281 bytes inherit_graph_588.map | 3 +- inherit_graph_588.md5 | 2 +- inherit_graph_588.png | Bin 1615 -> 3450 bytes inherit_graph_589.map | 2 +- inherit_graph_589.md5 | 2 +- inherit_graph_589.png | Bin 2455 -> 1615 bytes inherit_graph_590.map | 2 +- inherit_graph_590.md5 | 2 +- inherit_graph_590.png | Bin 2003 -> 2455 bytes inherit_graph_591.map | 2 +- inherit_graph_591.md5 | 2 +- inherit_graph_591.png | Bin 2270 -> 2003 bytes inherit_graph_592.map | 3 +- inherit_graph_592.md5 | 2 +- inherit_graph_592.png | Bin 2490 -> 2270 bytes inherit_graph_593.map | 3 +- inherit_graph_593.md5 | 2 +- inherit_graph_593.png | Bin 2452 -> 2490 bytes inherit_graph_594.map | 2 +- inherit_graph_594.md5 | 2 +- inherit_graph_594.png | Bin 1563 -> 2452 bytes inherit_graph_595.map | 2 +- inherit_graph_595.md5 | 2 +- inherit_graph_595.png | Bin 2500 -> 1563 bytes inherit_graph_596.map | 2 +- inherit_graph_596.md5 | 2 +- inherit_graph_596.png | Bin 2514 -> 2500 bytes inherit_graph_597.map | 2 +- inherit_graph_597.md5 | 2 +- inherit_graph_597.png | Bin 2072 -> 2514 bytes inherit_graph_598.map | 2 +- inherit_graph_598.md5 | 2 +- inherit_graph_598.png | Bin 1840 -> 2072 bytes inherit_graph_599.map | 3 +- inherit_graph_599.md5 | 2 +- inherit_graph_599.png | Bin 2539 -> 1840 bytes inherit_graph_600.map | 3 +- inherit_graph_600.md5 | 2 +- inherit_graph_600.png | Bin 2984 -> 2539 bytes inherit_graph_601.map | 6 +- inherit_graph_601.md5 | 2 +- inherit_graph_601.png | Bin 14678 -> 2984 bytes inherit_graph_602.map | 8 +- inherit_graph_602.md5 | 2 +- inherit_graph_602.png | Bin 7080 -> 14678 bytes inherit_graph_603.map | 9 +- inherit_graph_603.md5 | 2 +- inherit_graph_603.png | Bin 14649 -> 7080 bytes inherit_graph_604.map | 7 +- inherit_graph_604.md5 | 2 +- inherit_graph_604.png | Bin 1645 -> 14649 bytes inherit_graph_605.map | 2 +- inherit_graph_605.md5 | 2 +- inherit_graph_605.png | Bin 1971 -> 1645 bytes inherit_graph_606.map | 2 +- inherit_graph_606.md5 | 2 +- inherit_graph_606.png | Bin 2590 -> 1971 bytes inherit_graph_607.map | 2 +- inherit_graph_607.md5 | 2 +- inherit_graph_607.png | Bin 2540 -> 2590 bytes inherit_graph_608.map | 2 +- inherit_graph_608.md5 | 2 +- inherit_graph_608.png | Bin 2963 -> 2540 bytes inherit_graph_609.map | 2 +- inherit_graph_609.md5 | 2 +- inherit_graph_609.png | Bin 2626 -> 2963 bytes inherit_graph_610.map | 2 +- inherit_graph_610.md5 | 2 +- inherit_graph_610.png | Bin 3206 -> 2626 bytes inherit_graph_611.map | 2 +- inherit_graph_611.md5 | 2 +- inherit_graph_611.png | Bin 1134 -> 3206 bytes inherit_graph_612.map | 2 +- inherit_graph_612.md5 | 2 +- inherit_graph_612.png | Bin 1615 -> 1134 bytes inherit_graph_613.map | 2 +- inherit_graph_613.md5 | 2 +- inherit_graph_613.png | Bin 1693 -> 1615 bytes inherit_graph_614.map | 2 +- inherit_graph_614.md5 | 2 +- inherit_graph_614.png | Bin 2080 -> 1693 bytes inherit_graph_615.map | 2 +- inherit_graph_615.md5 | 2 +- inherit_graph_615.png | Bin 1862 -> 2080 bytes inherit_graph_616.map | 2 +- inherit_graph_616.md5 | 2 +- inherit_graph_616.png | Bin 2252 -> 1862 bytes inherit_graph_617.map | 2 +- inherit_graph_617.md5 | 2 +- inherit_graph_617.png | Bin 1963 -> 2252 bytes inherit_graph_618.map | 2 +- inherit_graph_618.md5 | 2 +- inherit_graph_618.png | Bin 1080 -> 1963 bytes inherit_graph_619.map | 2 +- inherit_graph_619.md5 | 2 +- inherit_graph_619.png | Bin 2987 -> 1080 bytes inherit_graph_620.map | 2 +- inherit_graph_620.md5 | 2 +- inherit_graph_620.png | Bin 3348 -> 2987 bytes inherit_graph_621.map | 2 +- inherit_graph_621.md5 | 2 +- inherit_graph_621.png | Bin 2843 -> 3348 bytes inherit_graph_622.map | 2 +- inherit_graph_622.md5 | 2 +- inherit_graph_622.png | Bin 2784 -> 2843 bytes inherit_graph_623.map | 2 +- inherit_graph_623.md5 | 2 +- inherit_graph_623.png | Bin 2449 -> 2784 bytes inherit_graph_624.map | 4 +- inherit_graph_624.md5 | 2 +- inherit_graph_624.png | Bin 10080 -> 2449 bytes inherit_graph_625.map | 4 +- inherit_graph_625.md5 | 2 +- inherit_graph_625.png | Bin 2405 -> 10080 bytes inherit_graph_626.map | 2 +- inherit_graph_626.md5 | 2 +- inherit_graph_626.png | Bin 2493 -> 2405 bytes inherit_graph_627.map | 2 +- inherit_graph_627.md5 | 2 +- inherit_graph_627.png | Bin 2367 -> 2493 bytes inherit_graph_628.map | 2 +- inherit_graph_628.md5 | 2 +- inherit_graph_628.png | Bin 1946 -> 2367 bytes inherit_graph_629.map | 2 +- inherit_graph_629.md5 | 2 +- inherit_graph_629.png | Bin 3121 -> 1946 bytes inherit_graph_630.map | 2 +- inherit_graph_630.md5 | 2 +- inherit_graph_630.png | Bin 3784 -> 3121 bytes inherit_graph_631.map | 2 +- inherit_graph_631.md5 | 2 +- inherit_graph_631.png | Bin 4370 -> 3784 bytes inherit_graph_632.map | 2 +- inherit_graph_632.md5 | 2 +- inherit_graph_632.png | Bin 4279 -> 4370 bytes inherit_graph_633.map | 2 +- inherit_graph_633.md5 | 2 +- inherit_graph_633.png | Bin 4271 -> 4279 bytes inherit_graph_634.map | 2 +- inherit_graph_634.md5 | 2 +- inherit_graph_634.png | Bin 3113 -> 4271 bytes inherit_graph_635.map | 2 +- inherit_graph_635.md5 | 2 +- inherit_graph_635.png | Bin 3284 -> 3113 bytes inherit_graph_636.map | 2 +- inherit_graph_636.md5 | 2 +- inherit_graph_636.png | Bin 3419 -> 3284 bytes inherit_graph_637.map | 2 +- inherit_graph_637.md5 | 2 +- inherit_graph_637.png | Bin 3561 -> 3419 bytes inherit_graph_638.map | 2 +- inherit_graph_638.md5 | 2 +- inherit_graph_638.png | Bin 3330 -> 3561 bytes inherit_graph_639.map | 2 +- inherit_graph_639.md5 | 2 +- inherit_graph_639.png | Bin 3417 -> 3330 bytes inherit_graph_640.map | 2 +- inherit_graph_640.md5 | 2 +- inherit_graph_640.png | Bin 3438 -> 3417 bytes inherit_graph_641.map | 2 +- inherit_graph_641.md5 | 2 +- inherit_graph_641.png | Bin 3613 -> 3438 bytes inherit_graph_642.map | 2 +- inherit_graph_642.md5 | 2 +- inherit_graph_642.png | Bin 1816 -> 3613 bytes inherit_graph_643.map | 2 +- inherit_graph_643.md5 | 2 +- inherit_graph_643.png | Bin 2734 -> 1816 bytes inherit_graph_644.map | 2 +- inherit_graph_644.md5 | 2 +- inherit_graph_644.png | Bin 2461 -> 2734 bytes inherit_graph_645.map | 2 +- inherit_graph_645.md5 | 2 +- inherit_graph_645.png | Bin 3137 -> 2461 bytes inherit_graph_646.map | 2 +- inherit_graph_646.md5 | 2 +- inherit_graph_646.png | Bin 2890 -> 3137 bytes inherit_graph_647.map | 2 +- inherit_graph_647.md5 | 2 +- inherit_graph_647.png | Bin 2910 -> 2890 bytes inherit_graph_648.md5 | 2 +- inherit_graph_648.png | Bin 2280 -> 2910 bytes inherit_graph_649.map | 5 +- inherit_graph_649.md5 | 2 +- inherit_graph_649.png | Bin 8183 -> 2280 bytes inherit_graph_650.map | 5 +- inherit_graph_650.md5 | 2 +- inherit_graph_650.png | Bin 2930 -> 8183 bytes inherit_graph_651.map | 2 +- inherit_graph_651.md5 | 2 +- inherit_graph_651.png | Bin 2023 -> 2930 bytes inherit_graph_652.map | 2 +- inherit_graph_652.md5 | 2 +- inherit_graph_652.png | Bin 2237 -> 2023 bytes inherit_graph_653.map | 2 +- inherit_graph_653.md5 | 2 +- inherit_graph_653.png | Bin 2547 -> 2237 bytes inherit_graph_654.map | 2 +- inherit_graph_654.md5 | 2 +- inherit_graph_654.png | Bin 1843 -> 2547 bytes inherit_graph_655.map | 2 +- inherit_graph_655.md5 | 2 +- inherit_graph_655.png | Bin 2873 -> 1843 bytes inherit_graph_656.map | 2 +- inherit_graph_656.md5 | 2 +- inherit_graph_656.png | Bin 3135 -> 2873 bytes inherit_graph_657.map | 2 +- inherit_graph_657.md5 | 2 +- inherit_graph_657.png | Bin 2383 -> 3135 bytes inherit_graph_658.map | 2 +- inherit_graph_658.md5 | 2 +- inherit_graph_658.png | Bin 2838 -> 2383 bytes inherit_graph_659.map | 2 +- inherit_graph_659.md5 | 2 +- inherit_graph_659.png | Bin 2217 -> 2838 bytes inherit_graph_660.map | 2 +- inherit_graph_660.md5 | 2 +- inherit_graph_660.png | Bin 2117 -> 2217 bytes inherit_graph_661.map | 2 +- inherit_graph_661.md5 | 2 +- inherit_graph_661.png | Bin 2991 -> 2117 bytes inherit_graph_662.map | 2 +- inherit_graph_662.md5 | 2 +- inherit_graph_662.png | Bin 3564 -> 2991 bytes inherit_graph_663.map | 2 +- inherit_graph_663.md5 | 2 +- inherit_graph_663.png | Bin 3402 -> 3564 bytes inherit_graph_664.map | 2 +- inherit_graph_664.md5 | 2 +- inherit_graph_664.png | Bin 2197 -> 3402 bytes inherit_graph_665.map | 2 +- inherit_graph_665.md5 | 2 +- inherit_graph_665.png | Bin 3125 -> 2197 bytes inherit_graph_666.map | 2 +- inherit_graph_666.md5 | 2 +- inherit_graph_666.png | Bin 2032 -> 3125 bytes inherit_graph_667.map | 3 +- inherit_graph_667.md5 | 2 +- inherit_graph_667.png | Bin 3691 -> 2032 bytes inherit_graph_668.map | 3 +- inherit_graph_668.md5 | 2 +- inherit_graph_668.png | Bin 2052 -> 3691 bytes inherit_graph_669.map | 2 +- inherit_graph_669.md5 | 2 +- inherit_graph_669.png | Bin 2456 -> 2052 bytes inherit_graph_670.map | 2 +- inherit_graph_670.md5 | 2 +- inherit_graph_670.png | Bin 2519 -> 2456 bytes inherit_graph_671.map | 2 +- inherit_graph_671.md5 | 2 +- inherit_graph_671.png | Bin 2458 -> 2519 bytes inherit_graph_672.map | 2 +- inherit_graph_672.md5 | 2 +- inherit_graph_672.png | Bin 2623 -> 2458 bytes inherit_graph_673.map | 2 +- inherit_graph_673.md5 | 2 +- inherit_graph_673.png | Bin 3091 -> 2623 bytes inherit_graph_674.map | 2 +- inherit_graph_674.md5 | 2 +- inherit_graph_674.png | Bin 4498 -> 3091 bytes inherit_graph_675.map | 2 +- inherit_graph_675.md5 | 2 +- inherit_graph_675.png | Bin 3275 -> 4498 bytes inherit_graph_676.map | 2 +- inherit_graph_676.md5 | 2 +- inherit_graph_676.png | Bin 3573 -> 3275 bytes inherit_graph_677.map | 2 +- inherit_graph_677.md5 | 2 +- inherit_graph_677.png | Bin 2496 -> 3573 bytes inherit_graph_678.map | 2 +- inherit_graph_678.md5 | 2 +- inherit_graph_678.png | Bin 1930 -> 2496 bytes inherit_graph_679.map | 2 +- inherit_graph_679.md5 | 2 +- inherit_graph_679.png | Bin 3340 -> 1930 bytes inherit_graph_680.map | 2 +- inherit_graph_680.md5 | 2 +- inherit_graph_680.png | Bin 3021 -> 3340 bytes inherit_graph_681.map | 2 +- inherit_graph_681.md5 | 2 +- inherit_graph_681.png | Bin 2171 -> 3021 bytes inherit_graph_682.map | 2 +- inherit_graph_682.md5 | 2 +- inherit_graph_682.png | Bin 2201 -> 2171 bytes inherit_graph_683.map | 2 +- inherit_graph_683.md5 | 2 +- inherit_graph_683.png | Bin 1801 -> 2201 bytes inherit_graph_684.map | 2 +- inherit_graph_684.md5 | 2 +- inherit_graph_684.png | Bin 2125 -> 1801 bytes inherit_graph_685.map | 2 +- inherit_graph_685.md5 | 2 +- inherit_graph_685.png | Bin 2623 -> 2125 bytes inherit_graph_686.map | 2 +- inherit_graph_686.md5 | 2 +- inherit_graph_686.png | Bin 2231 -> 2623 bytes inherit_graph_687.map | 2 +- inherit_graph_687.md5 | 2 +- inherit_graph_687.png | Bin 2653 -> 2231 bytes inherit_graph_688.map | 2 +- inherit_graph_688.md5 | 2 +- inherit_graph_688.png | Bin 2330 -> 2653 bytes inherit_graph_689.map | 2 +- inherit_graph_689.md5 | 2 +- inherit_graph_689.png | Bin 2214 -> 2330 bytes inherit_graph_690.map | 2 +- inherit_graph_690.md5 | 2 +- inherit_graph_690.png | Bin 2084 -> 2214 bytes inherit_graph_691.map | 2 +- inherit_graph_691.md5 | 2 +- inherit_graph_691.png | Bin 1485 -> 2084 bytes inherit_graph_692.map | 2 +- inherit_graph_692.md5 | 2 +- inherit_graph_692.png | Bin 3023 -> 1485 bytes inherit_graph_693.map | 2 +- inherit_graph_693.md5 | 2 +- inherit_graph_693.png | Bin 1938 -> 3023 bytes inherit_graph_694.map | 2 +- inherit_graph_694.md5 | 2 +- inherit_graph_694.png | Bin 2673 -> 1938 bytes inherit_graph_695.map | 2 +- inherit_graph_695.md5 | 2 +- inherit_graph_695.png | Bin 2008 -> 2673 bytes inherit_graph_696.map | 2 +- inherit_graph_696.md5 | 2 +- inherit_graph_696.png | Bin 2585 -> 2008 bytes inherit_graph_697.map | 2 +- inherit_graph_697.md5 | 2 +- inherit_graph_697.png | Bin 2428 -> 2585 bytes inherit_graph_698.map | 2 +- inherit_graph_698.md5 | 2 +- inherit_graph_698.png | Bin 2927 -> 2428 bytes inherit_graph_699.map | 2 +- inherit_graph_699.md5 | 2 +- inherit_graph_699.png | Bin 2059 -> 2927 bytes inherit_graph_700.map | 2 +- inherit_graph_700.md5 | 2 +- inherit_graph_700.png | Bin 2591 -> 2059 bytes inherit_graph_701.map | 2 +- inherit_graph_701.md5 | 2 +- inherit_graph_701.png | Bin 1597 -> 2591 bytes inherit_graph_702.map | 2 +- inherit_graph_702.md5 | 2 +- inherit_graph_702.png | Bin 2328 -> 1597 bytes inherit_graph_703.map | 2 +- inherit_graph_703.md5 | 2 +- inherit_graph_703.png | Bin 2431 -> 2328 bytes inherit_graph_704.map | 2 +- inherit_graph_704.md5 | 2 +- inherit_graph_704.png | Bin 2012 -> 2431 bytes inherit_graph_705.map | 2 +- inherit_graph_705.md5 | 2 +- inherit_graph_705.png | Bin 2582 -> 2012 bytes inherit_graph_706.map | 2 +- inherit_graph_706.md5 | 2 +- inherit_graph_706.png | Bin 2487 -> 2582 bytes inherit_graph_707.map | 2 +- inherit_graph_707.md5 | 2 +- inherit_graph_707.png | Bin 3318 -> 2487 bytes inherit_graph_708.map | 2 +- inherit_graph_708.md5 | 2 +- inherit_graph_708.png | Bin 2472 -> 3318 bytes inherit_graph_709.map | 2 +- inherit_graph_709.md5 | 2 +- inherit_graph_709.png | Bin 1638 -> 2472 bytes inherit_graph_710.map | 2 +- inherit_graph_710.md5 | 2 +- inherit_graph_710.png | Bin 2785 -> 1638 bytes inherit_graph_711.map | 2 +- inherit_graph_711.md5 | 2 +- inherit_graph_711.png | Bin 2418 -> 2785 bytes inherit_graph_712.map | 2 +- inherit_graph_712.md5 | 2 +- inherit_graph_712.png | Bin 2469 -> 2418 bytes inherit_graph_713.map | 2 +- inherit_graph_713.md5 | 2 +- inherit_graph_713.png | Bin 3940 -> 2469 bytes inherit_graph_714.map | 2 +- inherit_graph_714.md5 | 2 +- inherit_graph_714.png | Bin 2089 -> 3940 bytes inherit_graph_715.map | 2 +- inherit_graph_715.md5 | 2 +- inherit_graph_715.png | Bin 2637 -> 2089 bytes inherit_graph_716.map | 2 +- inherit_graph_716.md5 | 2 +- inherit_graph_716.png | Bin 3238 -> 2637 bytes inherit_graph_717.map | 2 +- inherit_graph_717.md5 | 2 +- inherit_graph_717.png | Bin 3084 -> 3238 bytes inherit_graph_718.map | 2 +- inherit_graph_718.md5 | 2 +- inherit_graph_718.png | Bin 1509 -> 3084 bytes inherit_graph_719.map | 2 +- inherit_graph_719.md5 | 2 +- inherit_graph_719.png | Bin 2079 -> 1509 bytes inherit_graph_720.map | 2 +- inherit_graph_720.md5 | 2 +- inherit_graph_720.png | Bin 2396 -> 2079 bytes inherit_graph_721.map | 2 +- inherit_graph_721.md5 | 2 +- inherit_graph_721.png | Bin 1859 -> 2396 bytes inherit_graph_722.map | 2 +- inherit_graph_722.md5 | 2 +- inherit_graph_722.png | Bin 2392 -> 1859 bytes inherit_graph_723.map | 2 +- inherit_graph_723.md5 | 2 +- inherit_graph_723.png | Bin 2182 -> 2392 bytes inherit_graph_724.map | 2 +- inherit_graph_724.md5 | 2 +- inherit_graph_724.png | Bin 2657 -> 2182 bytes inherit_graph_725.map | 2 +- inherit_graph_725.md5 | 2 +- inherit_graph_725.png | Bin 3203 -> 2657 bytes inherit_graph_726.map | 2 +- inherit_graph_726.md5 | 2 +- inherit_graph_726.png | Bin 2446 -> 3203 bytes inherit_graph_727.map | 2 +- inherit_graph_727.md5 | 2 +- inherit_graph_727.png | Bin 2572 -> 2446 bytes inherit_graph_728.map | 2 +- inherit_graph_728.md5 | 2 +- inherit_graph_728.png | Bin 2633 -> 2572 bytes inherit_graph_729.map | 2 +- inherit_graph_729.md5 | 2 +- inherit_graph_729.png | Bin 1846 -> 2633 bytes inherit_graph_730.map | 5 +- inherit_graph_730.md5 | 2 +- inherit_graph_730.png | Bin 9873 -> 1846 bytes inherit_graph_731.map | 9 +- inherit_graph_731.md5 | 2 +- inherit_graph_731.png | Bin 12320 -> 9873 bytes inherit_graph_732.map | 6 +- inherit_graph_732.md5 | 2 +- inherit_graph_732.png | Bin 2965 -> 12320 bytes inherit_graph_733.map | 2 +- inherit_graph_733.md5 | 2 +- inherit_graph_733.png | Bin 2937 -> 2965 bytes inherit_graph_734.map | 3 +- inherit_graph_734.md5 | 2 +- inherit_graph_734.png | Bin 3933 -> 2937 bytes inherit_graph_735.map | 3 +- inherit_graph_735.md5 | 2 +- inherit_graph_735.png | Bin 1711 -> 3933 bytes inherit_graph_736.map | 2 +- inherit_graph_736.md5 | 2 +- inherit_graph_736.png | Bin 1791 -> 1711 bytes inherit_graph_737.map | 2 +- inherit_graph_737.md5 | 2 +- inherit_graph_737.png | Bin 1985 -> 1791 bytes inherit_graph_738.map | 2 +- inherit_graph_738.md5 | 2 +- inherit_graph_738.png | Bin 1880 -> 1985 bytes inherit_graph_739.map | 2 +- inherit_graph_739.md5 | 2 +- inherit_graph_739.png | Bin 1720 -> 1880 bytes inherit_graph_740.map | 2 +- inherit_graph_740.md5 | 2 +- inherit_graph_740.png | Bin 2113 -> 1720 bytes inherit_graph_741.map | 2 +- inherit_graph_741.md5 | 2 +- inherit_graph_741.png | Bin 3076 -> 2113 bytes inherit_graph_742.map | 2 +- inherit_graph_742.md5 | 2 +- inherit_graph_742.png | Bin 2176 -> 3076 bytes inherit_graph_743.map | 2 +- inherit_graph_743.md5 | 2 +- inherit_graph_743.png | Bin 2029 -> 2176 bytes inherit_graph_744.map | 2 +- inherit_graph_744.md5 | 2 +- inherit_graph_744.png | Bin 3009 -> 2029 bytes inherit_graph_745.map | 2 +- inherit_graph_745.md5 | 2 +- inherit_graph_745.png | Bin 2240 -> 3009 bytes inherit_graph_746.map | 2 +- inherit_graph_746.md5 | 2 +- inherit_graph_746.png | Bin 1656 -> 2240 bytes inherit_graph_747.map | 2 +- inherit_graph_747.md5 | 2 +- inherit_graph_747.png | Bin 2171 -> 1656 bytes inherit_graph_748.map | 2 +- inherit_graph_748.md5 | 2 +- inherit_graph_748.png | Bin 1843 -> 2171 bytes inherit_graph_749.map | 2 +- inherit_graph_749.md5 | 2 +- inherit_graph_749.png | Bin 2212 -> 1843 bytes inherit_graph_750.map | 2 +- inherit_graph_750.md5 | 2 +- inherit_graph_750.png | Bin 1924 -> 2212 bytes inherit_graph_751.map | 2 +- inherit_graph_751.md5 | 2 +- inherit_graph_751.png | Bin 1795 -> 1924 bytes inherit_graph_752.map | 3 +- inherit_graph_752.md5 | 2 +- inherit_graph_752.png | Bin 3374 -> 1795 bytes inherit_graph_753.map | 3 +- inherit_graph_753.md5 | 2 +- inherit_graph_753.png | Bin 2085 -> 3374 bytes inherit_graph_754.map | 2 +- inherit_graph_754.md5 | 2 +- inherit_graph_754.png | Bin 2228 -> 2085 bytes inherit_graph_755.map | 2 +- inherit_graph_755.md5 | 2 +- inherit_graph_755.png | Bin 1954 -> 2228 bytes inherit_graph_756.map | 2 +- inherit_graph_756.md5 | 2 +- inherit_graph_756.png | Bin 2341 -> 1954 bytes inherit_graph_757.map | 2 +- inherit_graph_757.md5 | 2 +- inherit_graph_757.png | Bin 1945 -> 2341 bytes inherit_graph_758.map | 2 +- inherit_graph_758.md5 | 2 +- inherit_graph_758.png | Bin 2223 -> 1945 bytes inherit_graph_759.map | 2 +- inherit_graph_759.md5 | 2 +- inherit_graph_759.png | Bin 2037 -> 2223 bytes inherit_graph_760.map | 2 +- inherit_graph_760.md5 | 2 +- inherit_graph_760.png | Bin 2099 -> 2037 bytes inherit_graph_761.map | 2 +- inherit_graph_761.md5 | 2 +- inherit_graph_761.png | Bin 1961 -> 2099 bytes inherit_graph_762.map | 2 +- inherit_graph_762.md5 | 2 +- inherit_graph_762.png | Bin 2993 -> 1961 bytes inherit_graph_763.map | 2 +- inherit_graph_763.md5 | 2 +- inherit_graph_763.png | Bin 2171 -> 2993 bytes inherit_graph_764.map | 2 +- inherit_graph_764.md5 | 2 +- inherit_graph_764.png | Bin 2044 -> 2171 bytes inherit_graph_765.map | 2 +- inherit_graph_765.md5 | 2 +- inherit_graph_765.png | Bin 2377 -> 2044 bytes inherit_graph_766.map | 4 +- inherit_graph_766.md5 | 2 +- inherit_graph_766.png | Bin 7071 -> 2377 bytes inherit_graph_767.map | 4 +- inherit_graph_767.md5 | 2 +- inherit_graph_767.png | Bin 1757 -> 7071 bytes inherit_graph_768.map | 2 +- inherit_graph_768.md5 | 2 +- inherit_graph_768.png | Bin 2162 -> 1757 bytes inherit_graph_769.map | 2 +- inherit_graph_769.md5 | 2 +- inherit_graph_769.png | Bin 1676 -> 2162 bytes inherit_graph_770.map | 2 +- inherit_graph_770.md5 | 2 +- inherit_graph_770.png | Bin 1892 -> 1676 bytes inherit_graph_771.map | 2 +- inherit_graph_771.md5 | 2 +- inherit_graph_771.png | Bin 1764 -> 1892 bytes inherit_graph_772.map | 2 +- inherit_graph_772.md5 | 2 +- inherit_graph_772.png | Bin 1581 -> 1764 bytes inherit_graph_773.map | 2 +- inherit_graph_773.md5 | 2 +- inherit_graph_773.png | Bin 2250 -> 1581 bytes inherit_graph_774.map | 2 +- inherit_graph_774.md5 | 2 +- inherit_graph_774.png | Bin 2369 -> 2250 bytes inherit_graph_775.map | 2 +- inherit_graph_775.md5 | 2 +- inherit_graph_775.png | Bin 1779 -> 2369 bytes inherit_graph_776.map | 2 +- inherit_graph_776.md5 | 2 +- inherit_graph_776.png | Bin 2725 -> 1779 bytes inherit_graph_777.map | 2 +- inherit_graph_777.md5 | 2 +- inherit_graph_777.png | Bin 1805 -> 2725 bytes inherit_graph_778.map | 2 +- inherit_graph_778.md5 | 2 +- inherit_graph_778.png | Bin 1955 -> 1805 bytes inherit_graph_779.map | 2 +- inherit_graph_779.md5 | 2 +- inherit_graph_779.png | Bin 1442 -> 1955 bytes inherit_graph_780.map | 2 +- inherit_graph_780.md5 | 2 +- inherit_graph_780.png | Bin 1918 -> 1442 bytes inherit_graph_781.map | 2 +- inherit_graph_781.md5 | 2 +- inherit_graph_781.png | Bin 1910 -> 1918 bytes inherit_graph_782.map | 2 +- inherit_graph_782.md5 | 2 +- inherit_graph_782.png | Bin 2104 -> 1910 bytes inherit_graph_783.map | 2 +- inherit_graph_783.md5 | 2 +- inherit_graph_783.png | Bin 1679 -> 2104 bytes inherit_graph_784.map | 2 +- inherit_graph_784.md5 | 2 +- inherit_graph_784.png | Bin 1553 -> 1679 bytes inherit_graph_785.map | 2 +- inherit_graph_785.md5 | 2 +- inherit_graph_785.png | Bin 1417 -> 1553 bytes inherit_graph_786.map | 2 +- inherit_graph_786.md5 | 2 +- inherit_graph_786.png | Bin 1922 -> 1417 bytes inherit_graph_787.map | 2 +- inherit_graph_787.md5 | 2 +- inherit_graph_787.png | Bin 2102 -> 1922 bytes inherit_graph_788.map | 2 +- inherit_graph_788.md5 | 2 +- inherit_graph_788.png | Bin 1944 -> 2102 bytes inherit_graph_789.map | 2 +- inherit_graph_789.md5 | 2 +- inherit_graph_789.png | Bin 1637 -> 1944 bytes inherit_graph_790.map | 2 +- inherit_graph_790.md5 | 2 +- inherit_graph_790.png | Bin 2035 -> 1637 bytes inherit_graph_791.map | 2 +- inherit_graph_791.md5 | 2 +- inherit_graph_791.png | Bin 2004 -> 2035 bytes inherit_graph_792.map | 2 +- inherit_graph_792.md5 | 2 +- inherit_graph_792.png | Bin 2109 -> 2004 bytes inherit_graph_793.map | 2 +- inherit_graph_793.md5 | 2 +- inherit_graph_793.png | Bin 2078 -> 2109 bytes inherit_graph_794.map | 2 +- inherit_graph_794.md5 | 2 +- inherit_graph_794.png | Bin 2060 -> 2078 bytes inherit_graph_795.map | 2 +- inherit_graph_795.md5 | 2 +- inherit_graph_795.png | Bin 1989 -> 2060 bytes inherit_graph_796.map | 2 +- inherit_graph_796.md5 | 2 +- inherit_graph_796.png | Bin 1602 -> 1989 bytes inherit_graph_797.map | 2 +- inherit_graph_797.md5 | 2 +- inherit_graph_797.png | Bin 2337 -> 1602 bytes inherit_graph_798.map | 2 +- inherit_graph_798.md5 | 2 +- inherit_graph_798.png | Bin 2011 -> 2337 bytes inherit_graph_799.map | 2 +- inherit_graph_799.md5 | 2 +- inherit_graph_799.png | Bin 2113 -> 2011 bytes inherit_graph_800.map | 2 +- inherit_graph_800.md5 | 2 +- inherit_graph_800.png | Bin 2249 -> 2113 bytes inherit_graph_801.map | 2 +- inherit_graph_801.md5 | 2 +- inherit_graph_801.png | Bin 2102 -> 2249 bytes inherit_graph_802.map | 2 +- inherit_graph_802.md5 | 2 +- inherit_graph_802.png | Bin 1761 -> 2102 bytes inherit_graph_803.map | 2 +- inherit_graph_803.md5 | 2 +- inherit_graph_803.png | Bin 1936 -> 1761 bytes inherit_graph_804.map | 2 +- inherit_graph_804.md5 | 2 +- inherit_graph_804.png | Bin 1811 -> 1936 bytes inherit_graph_805.map | 2 +- inherit_graph_805.md5 | 2 +- inherit_graph_805.png | Bin 1665 -> 1811 bytes inherit_graph_806.map | 2 +- inherit_graph_806.md5 | 2 +- inherit_graph_806.png | Bin 1932 -> 1665 bytes inherit_graph_807.map | 2 +- inherit_graph_807.md5 | 2 +- inherit_graph_807.png | Bin 1695 -> 1932 bytes inherit_graph_808.map | 2 +- inherit_graph_808.md5 | 2 +- inherit_graph_808.png | Bin 1701 -> 1695 bytes inherit_graph_809.map | 2 +- inherit_graph_809.md5 | 2 +- inherit_graph_809.png | Bin 2562 -> 1701 bytes inherit_graph_810.map | 2 +- inherit_graph_810.md5 | 2 +- inherit_graph_810.png | Bin 2089 -> 2562 bytes inherit_graph_811.map | 2 +- inherit_graph_811.md5 | 2 +- inherit_graph_811.png | Bin 2690 -> 2089 bytes inherit_graph_812.map | 2 +- inherit_graph_812.md5 | 2 +- inherit_graph_812.png | Bin 2541 -> 2690 bytes inherit_graph_813.map | 2 +- inherit_graph_813.md5 | 2 +- inherit_graph_813.png | Bin 2886 -> 2541 bytes inherit_graph_814.map | 2 +- inherit_graph_814.md5 | 2 +- inherit_graph_814.png | Bin 1930 -> 2886 bytes inherit_graph_815.map | 2 +- inherit_graph_815.md5 | 2 +- inherit_graph_815.png | Bin 1550 -> 1930 bytes inherit_graph_816.map | 2 +- inherit_graph_816.md5 | 2 +- inherit_graph_816.png | Bin 1743 -> 1550 bytes inherit_graph_817.map | 2 +- inherit_graph_817.md5 | 2 +- inherit_graph_817.png | Bin 2370 -> 1743 bytes inherit_graph_818.map | 2 +- inherit_graph_818.md5 | 2 +- inherit_graph_818.png | Bin 2134 -> 2370 bytes inherit_graph_819.map | 2 +- inherit_graph_819.md5 | 2 +- inherit_graph_819.png | Bin 2030 -> 2134 bytes inherit_graph_820.map | 2 +- inherit_graph_820.md5 | 2 +- inherit_graph_820.png | Bin 2371 -> 2030 bytes inherit_graph_821.map | 2 +- inherit_graph_821.md5 | 2 +- inherit_graph_821.png | Bin 2199 -> 2371 bytes inherit_graph_822.map | 2 +- inherit_graph_822.md5 | 2 +- inherit_graph_822.png | Bin 2686 -> 2199 bytes inherit_graph_823.map | 2 +- inherit_graph_823.md5 | 2 +- inherit_graph_823.png | Bin 1765 -> 2686 bytes inherit_graph_824.map | 2 +- inherit_graph_824.md5 | 2 +- inherit_graph_824.png | Bin 2100 -> 1765 bytes inherit_graph_825.map | 2 +- inherit_graph_825.md5 | 2 +- inherit_graph_825.png | Bin 1455 -> 2100 bytes inherit_graph_826.map | 2 +- inherit_graph_826.md5 | 2 +- inherit_graph_826.png | Bin 1999 -> 1455 bytes inherit_graph_827.map | 2 +- inherit_graph_827.md5 | 2 +- inherit_graph_827.png | Bin 1467 -> 1999 bytes inherit_graph_828.map | 2 +- inherit_graph_828.md5 | 2 +- inherit_graph_828.png | Bin 1517 -> 1467 bytes inherit_graph_829.map | 2 +- inherit_graph_829.md5 | 2 +- inherit_graph_829.png | Bin 1894 -> 1517 bytes inherit_graph_830.map | 2 +- inherit_graph_830.md5 | 2 +- inherit_graph_830.png | Bin 2199 -> 1894 bytes inherit_graph_831.map | 2 +- inherit_graph_831.md5 | 2 +- inherit_graph_831.png | Bin 1651 -> 2199 bytes inherit_graph_832.map | 2 +- inherit_graph_832.md5 | 2 +- inherit_graph_832.png | Bin 1319 -> 1651 bytes inherit_graph_833.map | 2 +- inherit_graph_833.md5 | 2 +- inherit_graph_833.png | Bin 1822 -> 1319 bytes inherit_graph_834.map | 2 +- inherit_graph_834.md5 | 2 +- inherit_graph_834.png | Bin 2169 -> 1822 bytes inherit_graph_835.map | 2 +- inherit_graph_835.md5 | 2 +- inherit_graph_835.png | Bin 1947 -> 2169 bytes inherit_graph_836.map | 2 +- inherit_graph_836.md5 | 2 +- inherit_graph_836.png | Bin 2162 -> 1947 bytes inherit_graph_837.map | 2 +- inherit_graph_837.md5 | 2 +- inherit_graph_837.png | Bin 2130 -> 2162 bytes inherit_graph_838.map | 2 +- inherit_graph_838.md5 | 2 +- inherit_graph_838.png | Bin 1944 -> 2130 bytes inherit_graph_839.map | 2 +- inherit_graph_839.md5 | 2 +- inherit_graph_839.png | Bin 2051 -> 1944 bytes inherit_graph_840.map | 2 +- inherit_graph_840.md5 | 2 +- inherit_graph_840.png | Bin 2045 -> 2051 bytes inherit_graph_841.map | 2 +- inherit_graph_841.md5 | 2 +- inherit_graph_841.png | Bin 1888 -> 2045 bytes inherit_graph_842.map | 2 +- inherit_graph_842.md5 | 2 +- inherit_graph_842.png | Bin 2008 -> 1888 bytes inherit_graph_843.map | 2 +- inherit_graph_843.md5 | 2 +- inherit_graph_843.png | Bin 1985 -> 2008 bytes inherit_graph_844.map | 2 +- inherit_graph_844.md5 | 2 +- inherit_graph_844.png | Bin 2134 -> 1985 bytes inherit_graph_845.map | 2 +- inherit_graph_845.md5 | 2 +- inherit_graph_845.png | Bin 2703 -> 2134 bytes inherit_graph_846.map | 2 +- inherit_graph_846.md5 | 2 +- inherit_graph_846.png | Bin 1903 -> 2703 bytes inherit_graph_847.map | 2 +- inherit_graph_847.md5 | 2 +- inherit_graph_847.png | Bin 2430 -> 1903 bytes inherit_graph_848.map | 2 +- inherit_graph_848.md5 | 2 +- inherit_graph_848.png | Bin 1885 -> 2430 bytes inherit_graph_849.map | 2 +- inherit_graph_849.md5 | 2 +- inherit_graph_849.png | Bin 2458 -> 1885 bytes inherit_graph_850.map | 2 +- inherit_graph_850.md5 | 2 +- inherit_graph_850.png | Bin 1284 -> 2458 bytes inherit_graph_851.map | 2 +- inherit_graph_851.md5 | 2 +- inherit_graph_851.png | Bin 2130 -> 1284 bytes inherit_graph_852.map | 2 +- inherit_graph_852.md5 | 2 +- inherit_graph_852.png | Bin 1737 -> 2130 bytes inherit_graph_853.map | 2 +- inherit_graph_853.md5 | 2 +- inherit_graph_853.png | Bin 2037 -> 1737 bytes inherit_graph_854.map | 2 +- inherit_graph_854.md5 | 2 +- inherit_graph_854.png | Bin 2609 -> 2037 bytes inherit_graph_855.map | 2 +- inherit_graph_855.md5 | 2 +- inherit_graph_855.png | Bin 2149 -> 2609 bytes inherit_graph_856.map | 2 +- inherit_graph_856.md5 | 2 +- inherit_graph_856.png | Bin 2266 -> 2149 bytes inherit_graph_857.map | 2 +- inherit_graph_857.md5 | 2 +- inherit_graph_857.png | Bin 1381 -> 2266 bytes inherit_graph_858.map | 2 +- inherit_graph_858.md5 | 2 +- inherit_graph_858.png | Bin 1811 -> 1381 bytes inherit_graph_859.map | 2 +- inherit_graph_859.md5 | 2 +- inherit_graph_859.png | Bin 1639 -> 1811 bytes inherit_graph_860.map | 2 +- inherit_graph_860.md5 | 2 +- inherit_graph_860.png | Bin 2707 -> 1639 bytes inherit_graph_861.map | 2 +- inherit_graph_861.md5 | 2 +- inherit_graph_861.png | Bin 2336 -> 2707 bytes inherit_graph_862.map | 2 +- inherit_graph_862.md5 | 2 +- inherit_graph_862.png | Bin 2355 -> 2336 bytes inherit_graph_863.map | 2 +- inherit_graph_863.md5 | 2 +- inherit_graph_863.png | Bin 1946 -> 2355 bytes inherit_graph_864.map | 2 +- inherit_graph_864.md5 | 2 +- inherit_graph_864.png | Bin 2103 -> 1946 bytes inherit_graph_865.map | 2 +- inherit_graph_865.md5 | 2 +- inherit_graph_865.png | Bin 2089 -> 2103 bytes inherit_graph_866.map | 2 +- inherit_graph_866.md5 | 2 +- inherit_graph_866.png | Bin 1879 -> 2089 bytes inherit_graph_867.map | 2 +- inherit_graph_867.md5 | 2 +- inherit_graph_867.png | Bin 2044 -> 1879 bytes inherit_graph_868.map | 2 +- inherit_graph_868.md5 | 2 +- inherit_graph_868.png | Bin 2160 -> 2044 bytes inherit_graph_869.map | 2 +- inherit_graph_869.md5 | 2 +- inherit_graph_869.png | Bin 2751 -> 2160 bytes inherit_graph_870.map | 2 +- inherit_graph_870.md5 | 2 +- inherit_graph_870.png | Bin 2595 -> 2751 bytes inherit_graph_871.map | 2 +- inherit_graph_871.md5 | 2 +- inherit_graph_871.png | Bin 2832 -> 2595 bytes inherit_graph_872.map | 2 +- inherit_graph_872.md5 | 2 +- inherit_graph_872.png | Bin 1760 -> 2832 bytes inherit_graph_873.map | 2 +- inherit_graph_873.md5 | 2 +- inherit_graph_873.png | Bin 2016 -> 1760 bytes inherit_graph_874.map | 2 +- inherit_graph_874.md5 | 2 +- inherit_graph_874.png | Bin 3019 -> 2016 bytes inherit_graph_875.map | 2 +- inherit_graph_875.md5 | 2 +- inherit_graph_875.png | Bin 2286 -> 3019 bytes inherit_graph_876.map | 2 +- inherit_graph_876.md5 | 2 +- inherit_graph_876.png | Bin 3095 -> 2286 bytes inherit_graph_877.map | 2 +- inherit_graph_877.md5 | 2 +- inherit_graph_877.png | Bin 3298 -> 3095 bytes inherit_graph_878.map | 2 +- inherit_graph_878.md5 | 2 +- inherit_graph_878.png | Bin 2735 -> 3298 bytes inherit_graph_879.map | 2 +- inherit_graph_879.md5 | 2 +- inherit_graph_879.png | Bin 3823 -> 2735 bytes inherit_graph_880.map | 2 +- inherit_graph_880.md5 | 2 +- inherit_graph_880.png | Bin 3116 -> 3823 bytes inherit_graph_881.map | 2 +- inherit_graph_881.md5 | 2 +- inherit_graph_881.png | Bin 2755 -> 3116 bytes inherit_graph_882.map | 3 +- inherit_graph_882.md5 | 2 +- inherit_graph_882.png | Bin 4619 -> 2755 bytes inherit_graph_883.map | 4 +- inherit_graph_883.md5 | 2 +- inherit_graph_883.png | Bin 4008 -> 4619 bytes inherit_graph_884.map | 3 +- inherit_graph_884.md5 | 2 +- inherit_graph_884.png | Bin 3217 -> 4008 bytes inherit_graph_885.map | 2 +- inherit_graph_885.md5 | 2 +- inherit_graph_885.png | Bin 2672 -> 3217 bytes inherit_graph_886.map | 2 +- inherit_graph_886.md5 | 2 +- inherit_graph_886.png | Bin 2655 -> 2672 bytes inherit_graph_887.map | 2 +- inherit_graph_887.md5 | 2 +- inherit_graph_887.png | Bin 2201 -> 2655 bytes inherit_graph_888.map | 2 +- inherit_graph_888.md5 | 2 +- inherit_graph_888.png | Bin 2507 -> 2201 bytes inherit_graph_889.map | 2 +- inherit_graph_889.md5 | 2 +- inherit_graph_889.png | Bin 3156 -> 2507 bytes inherit_graph_890.map | 2 +- inherit_graph_890.md5 | 2 +- inherit_graph_891.map | 5 +- inherit_graph_891.md5 | 2 +- inherit_graph_891.png | Bin 10427 -> 3156 bytes inherit_graph_892.map | 6 +- inherit_graph_892.md5 | 2 +- inherit_graph_892.png | Bin 4720 -> 10427 bytes inherit_graph_893.map | 4 +- inherit_graph_893.md5 | 2 +- inherit_graph_893.png | Bin 4177 -> 4720 bytes inherit_graph_894.map | 3 +- inherit_graph_894.md5 | 2 +- inherit_graph_894.png | Bin 3446 -> 4177 bytes inherit_graph_895.map | 2 +- inherit_graph_895.md5 | 2 +- inherit_graph_895.png | Bin 1868 -> 3446 bytes inherit_graph_896.map | 2 +- inherit_graph_896.md5 | 2 +- inherit_graph_896.png | Bin 2505 -> 1868 bytes inherit_graph_897.map | 2 +- inherit_graph_897.md5 | 2 +- inherit_graph_897.png | Bin 2804 -> 2505 bytes inherit_graph_898.map | 2 +- inherit_graph_898.md5 | 2 +- inherit_graph_898.png | Bin 1957 -> 2804 bytes inherit_graph_899.map | 2 +- inherit_graph_899.md5 | 2 +- inherit_graph_899.png | Bin 2588 -> 1957 bytes inherit_graph_900.map | 2 +- inherit_graph_900.md5 | 2 +- inherit_graph_900.png | Bin 2058 -> 2588 bytes inherit_graph_901.map | 2 +- inherit_graph_901.md5 | 2 +- inherit_graph_901.png | Bin 1880 -> 2058 bytes inherit_graph_902.map | 58 +- inherit_graph_902.md5 | 2 +- inherit_graph_902.png | Bin 352297 -> 1880 bytes inherit_graph_903.map | 58 +- inherit_graph_903.md5 | 2 +- inherit_graph_903.png | Bin 1925 -> 352297 bytes inherit_graph_904.map | 2 +- inherit_graph_904.md5 | 2 +- inherit_graph_904.png | Bin 2932 -> 1925 bytes inherit_graph_905.map | 2 +- inherit_graph_905.md5 | 2 +- inherit_graph_905.png | Bin 2794 -> 2932 bytes inherit_graph_906.map | 2 +- inherit_graph_906.md5 | 2 +- inherit_graph_906.png | Bin 1853 -> 2794 bytes inherit_graph_907.map | 2 +- inherit_graph_907.md5 | 2 +- inherit_graph_907.png | Bin 1693 -> 1853 bytes inherit_graph_908.map | 2 +- inherit_graph_908.md5 | 2 +- inherit_graph_908.png | Bin 2596 -> 1693 bytes inherit_graph_909.map | 2 +- inherit_graph_909.md5 | 2 +- inherit_graph_909.png | Bin 1493 -> 2596 bytes inherit_graph_910.map | 2 +- inherit_graph_910.md5 | 2 +- inherit_graph_910.png | Bin 1988 -> 1493 bytes inherit_graph_911.map | 2 +- inherit_graph_911.md5 | 2 +- inherit_graph_911.png | Bin 1370 -> 1988 bytes inherit_graph_912.map | 2 +- inherit_graph_912.md5 | 2 +- inherit_graph_912.png | Bin 1938 -> 1370 bytes inherit_graph_913.map | 2 +- inherit_graph_913.md5 | 2 +- inherit_graph_913.png | Bin 1263 -> 1938 bytes inherit_graph_914.map | 2 +- inherit_graph_914.md5 | 2 +- inherit_graph_914.png | Bin 2018 -> 1263 bytes inherit_graph_915.map | 2 +- inherit_graph_915.md5 | 2 +- inherit_graph_915.png | Bin 1903 -> 2018 bytes inherit_graph_916.map | 2 +- inherit_graph_916.md5 | 2 +- inherit_graph_916.png | Bin 2751 -> 1903 bytes inherit_graph_917.map | 2 +- inherit_graph_917.md5 | 2 +- inherit_graph_917.png | Bin 1844 -> 2751 bytes inherit_graph_918.map | 2 +- inherit_graph_918.md5 | 2 +- inherit_graph_918.png | Bin 1834 -> 1844 bytes inherit_graph_919.map | 2 +- inherit_graph_919.md5 | 2 +- inherit_graph_919.png | Bin 2272 -> 1834 bytes inherit_graph_920.map | 2 +- inherit_graph_920.md5 | 2 +- inherit_graph_920.png | Bin 1668 -> 2272 bytes inherit_graph_921.map | 2 +- inherit_graph_921.md5 | 2 +- inherit_graph_921.png | Bin 1877 -> 1668 bytes inherit_graph_922.map | 2 +- inherit_graph_922.md5 | 2 +- inherit_graph_922.png | Bin 1986 -> 1877 bytes inherit_graph_923.map | 2 +- inherit_graph_923.md5 | 2 +- inherit_graph_923.png | Bin 1463 -> 1986 bytes inherit_graph_924.map | 3 +- inherit_graph_924.md5 | 2 +- inherit_graph_924.png | Bin 4824 -> 1463 bytes inherit_graph_925.map | 3 +- inherit_graph_925.md5 | 2 +- inherit_graph_925.png | Bin 1978 -> 4824 bytes inherit_graph_926.map | 2 +- inherit_graph_926.md5 | 2 +- inherit_graph_926.png | Bin 2648 -> 1978 bytes inherit_graph_927.map | 2 +- inherit_graph_927.md5 | 2 +- inherit_graph_927.png | Bin 1783 -> 2648 bytes inherit_graph_928.map | 2 +- inherit_graph_928.md5 | 2 +- inherit_graph_928.png | Bin 2036 -> 1783 bytes inherit_graph_929.map | 2 +- inherit_graph_929.md5 | 2 +- inherit_graph_929.png | Bin 2647 -> 2036 bytes inherit_graph_930.map | 2 +- inherit_graph_930.md5 | 2 +- inherit_graph_930.png | Bin 3359 -> 2647 bytes inherit_graph_931.map | 2 +- inherit_graph_931.md5 | 2 +- inherit_graph_931.png | Bin 3178 -> 3359 bytes inherit_graph_932.map | 2 +- inherit_graph_932.md5 | 2 +- inherit_graph_932.png | Bin 3240 -> 3178 bytes inherit_graph_933.map | 2 +- inherit_graph_933.md5 | 2 +- inherit_graph_933.png | Bin 1979 -> 3240 bytes inherit_graph_934.map | 2 +- inherit_graph_934.md5 | 2 +- inherit_graph_934.png | Bin 2045 -> 1979 bytes inherit_graph_935.map | 2 +- inherit_graph_935.md5 | 2 +- inherit_graph_935.png | Bin 2332 -> 2045 bytes inherit_graph_936.map | 2 +- inherit_graph_936.md5 | 2 +- inherit_graph_936.png | Bin 1760 -> 2332 bytes inherit_graph_937.map | 2 +- inherit_graph_937.md5 | 2 +- inherit_graph_937.png | Bin 2869 -> 1760 bytes inherit_graph_938.map | 2 +- inherit_graph_938.md5 | 2 +- inherit_graph_938.png | Bin 2289 -> 2869 bytes inherit_graph_939.map | 2 +- inherit_graph_939.md5 | 2 +- inherit_graph_939.png | Bin 2831 -> 2289 bytes inherit_graph_940.map | 2 +- inherit_graph_940.md5 | 2 +- inherit_graph_940.png | Bin 2526 -> 2831 bytes inherit_graph_941.map | 2 +- inherit_graph_941.md5 | 2 +- inherit_graph_941.png | Bin 1818 -> 2526 bytes inherit_graph_942.map | 2 +- inherit_graph_942.md5 | 2 +- inherit_graph_942.png | Bin 2014 -> 1818 bytes inherit_graph_943.map | 2 +- inherit_graph_943.md5 | 2 +- inherit_graph_943.png | Bin 2528 -> 2014 bytes inherit_graph_944.map | 2 +- inherit_graph_944.md5 | 2 +- inherit_graph_944.png | Bin 2402 -> 2528 bytes inherit_graph_945.map | 2 +- inherit_graph_945.md5 | 2 +- inherit_graph_945.png | Bin 1844 -> 2402 bytes inherit_graph_946.map | 2 +- inherit_graph_946.md5 | 2 +- inherit_graph_946.png | Bin 2009 -> 1844 bytes inherit_graph_947.map | 2 +- inherit_graph_947.md5 | 2 +- inherit_graph_947.png | Bin 2083 -> 2009 bytes inherit_graph_948.map | 2 +- inherit_graph_948.md5 | 2 +- inherit_graph_948.png | Bin 2575 -> 2083 bytes inherit_graph_949.map | 2 +- inherit_graph_949.md5 | 2 +- inherit_graph_949.png | Bin 2193 -> 2575 bytes inherit_graph_950.map | 2 +- inherit_graph_950.md5 | 2 +- inherit_graph_950.png | Bin 2465 -> 2193 bytes inherit_graph_951.map | 2 +- inherit_graph_951.md5 | 2 +- inherit_graph_951.png | Bin 3109 -> 2465 bytes inherit_graph_952.map | 2 +- inherit_graph_952.md5 | 2 +- inherit_graph_952.png | Bin 1543 -> 3109 bytes inherit_graph_953.map | 4 +- inherit_graph_953.md5 | 2 +- inherit_graph_953.png | Bin 6535 -> 1543 bytes inherit_graph_954.map | 4 +- inherit_graph_954.md5 | 2 +- inherit_graph_954.png | Bin 2335 -> 6535 bytes inherit_graph_955.map | 3 +- inherit_graph_955.md5 | 2 +- inherit_graph_955.png | Bin 2157 -> 2335 bytes inherit_graph_956.map | 4 +- inherit_graph_956.md5 | 2 +- inherit_graph_956.png | Bin 4529 -> 2157 bytes inherit_graph_957.map | 3 +- inherit_graph_957.md5 | 2 +- inherit_graph_957.png | Bin 3142 -> 4529 bytes inherit_graph_958.map | 3 +- inherit_graph_958.md5 | 2 +- inherit_graph_958.png | Bin 5351 -> 3142 bytes inherit_graph_959.map | 4 +- inherit_graph_959.md5 | 2 +- inherit_graph_959.png | Bin 4492 -> 5351 bytes inherit_graph_960.map | 3 +- inherit_graph_960.md5 | 2 +- inherit_graph_960.png | Bin 2254 -> 4492 bytes inherit_graph_961.map | 2 +- inherit_graph_961.md5 | 2 +- inherit_graph_961.png | Bin 3158 -> 2254 bytes inherit_graph_962.map | 2 +- inherit_graph_962.md5 | 2 +- inherit_graph_962.png | Bin 2686 -> 3158 bytes inherit_graph_963.map | 2 +- inherit_graph_963.md5 | 2 +- inherit_graph_963.png | Bin 3316 -> 2686 bytes inherit_graph_964.map | 2 +- inherit_graph_964.md5 | 2 +- inherit_graph_964.png | Bin 2276 -> 3316 bytes inherit_graph_965.map | 2 +- inherit_graph_965.md5 | 2 +- inherit_graph_965.png | Bin 2177 -> 2276 bytes inherit_graph_966.map | 3 +- inherit_graph_966.md5 | 2 +- inherit_graph_966.png | Bin 3774 -> 2177 bytes inherit_graph_967.map | 7 +- inherit_graph_967.md5 | 2 +- inherit_graph_967.png | Bin 23274 -> 3774 bytes inherit_graph_968.map | 7 +- inherit_graph_968.md5 | 2 +- inherit_graph_968.png | Bin 6025 -> 23274 bytes inherit_graph_969.map | 4 +- inherit_graph_969.md5 | 2 +- inherit_graph_969.png | Bin 3746 -> 6025 bytes inherit_graph_970.map | 5 +- inherit_graph_970.md5 | 2 +- inherit_graph_970.png | Bin 11164 -> 3746 bytes inherit_graph_971.map | 5 +- inherit_graph_971.md5 | 2 +- inherit_graph_971.png | Bin 4571 -> 11164 bytes inherit_graph_972.map | 4 +- inherit_graph_972.md5 | 2 +- inherit_graph_972.png | Bin 4347 -> 4571 bytes inherit_graph_973.map | 20 +- inherit_graph_973.md5 | 2 +- inherit_graph_973.png | Bin 57980 -> 4347 bytes inherit_graph_974.map | 42 +- inherit_graph_974.md5 | 2 +- inherit_graph_974.png | Bin 111738 -> 57980 bytes inherit_graph_975.map | 28 +- inherit_graph_975.md5 | 2 +- inherit_graph_975.png | Bin 12078 -> 111738 bytes inherit_graph_976.map | 7 +- inherit_graph_976.md5 | 2 +- inherit_graph_976.png | Bin 7487 -> 12078 bytes inherit_graph_977.map | 5 +- inherit_graph_977.md5 | 2 +- inherit_graph_977.png | Bin 4332 -> 7487 bytes inherit_graph_978.map | 4 +- inherit_graph_978.md5 | 2 +- inherit_graph_978.png | Bin 5454 -> 4332 bytes inherit_graph_979.map | 12 +- inherit_graph_979.md5 | 2 +- inherit_graph_979.png | Bin 37543 -> 5454 bytes inherit_graph_980.map | 13 +- inherit_graph_980.md5 | 2 +- inherit_graph_980.png | Bin 8135 -> 37543 bytes inherit_graph_981.map | 17 +- inherit_graph_981.md5 | 2 +- inherit_graph_981.png | Bin 43699 -> 8135 bytes inherit_graph_982.map | 20 +- inherit_graph_982.md5 | 2 +- inherit_graph_982.png | Bin 22241 -> 43699 bytes inherit_graph_983.map | 8 +- inherit_graph_983.md5 | 2 +- inherit_graph_983.png | Bin 3127 -> 22241 bytes inherit_graph_984.map | 3 +- inherit_graph_984.md5 | 2 +- inherit_graph_984.png | Bin 2348 -> 3127 bytes inherit_graph_985.map | 4 +- inherit_graph_985.md5 | 2 +- inherit_graph_985.png | Bin 8451 -> 2348 bytes inherit_graph_986.map | 5 +- inherit_graph_986.md5 | 2 +- inherit_graph_986.png | Bin 9534 -> 8451 bytes inherit_graph_987.map | 4 +- inherit_graph_987.md5 | 2 +- inherit_graph_987.png | Bin 9125 -> 9534 bytes inherit_graph_988.map | 4 +- inherit_graph_988.md5 | 2 +- inherit_graph_988.png | Bin 8391 -> 9125 bytes inherit_graph_989.map | 4 +- inherit_graph_989.md5 | 2 +- inherit_graph_989.png | Bin 11456 -> 8391 bytes inherit_graph_990.map | 4 +- inherit_graph_990.md5 | 2 +- inherit_graph_990.png | Bin 7948 -> 11456 bytes inherit_graph_991.map | 4 +- inherit_graph_991.md5 | 2 +- inherit_graph_991.png | Bin 6714 -> 7948 bytes inherit_graph_992.map | 8 +- inherit_graph_992.md5 | 2 +- inherit_graph_992.png | Bin 27916 -> 6714 bytes inherit_graph_993.map | 12 +- inherit_graph_993.md5 | 2 +- inherit_graph_993.png | Bin 15693 -> 27916 bytes inherit_graph_994.map | 7 +- inherit_graph_994.md5 | 2 +- inherit_graph_994.png | Bin 3207 -> 15693 bytes inherit_graph_995.map | 3 +- inherit_graph_995.md5 | 2 +- inherit_graph_995.png | Bin 4581 -> 3207 bytes inherit_graph_996.map | 4 +- inherit_graph_996.md5 | 2 +- inherit_graph_996.png | Bin 3834 -> 4581 bytes inherit_graph_997.map | 22 +- inherit_graph_997.md5 | 2 +- inherit_graph_997.png | Bin 135659 -> 3834 bytes inherit_graph_998.map | 22 +- inherit_graph_998.md5 | 2 +- inherit_graph_998.png | Bin 4173 -> 135659 bytes inherit_graph_999.map | 18 +- inherit_graph_999.md5 | 2 +- inherit_graph_999.png | Bin 65131 -> 4173 bytes inherits.html | 1587 +-- md____w_rippled_rippled_docs_consensus.html | 2 +- menudata.js | 44 +- namespacemembers_c.html | 4 +- namespacemembers_e.html | 2 +- namespacemembers_func_c.html | 4 +- namespacemembers_func_g.html | 3 +- namespacemembers_g.html | 3 +- namespacemembers_i.html | 4 +- namespacemembers_s.html | 2 +- namespaceripple.html | 96 +- namespaces.html | 3 +- search/all_10.js | 784 +- search/all_11.js | 680 +- search/all_12.js | 19 +- search/all_13.js | 1008 +- search/all_14.js | 2351 ++--- search/all_15.js | 2608 ++--- search/all_16.js | 605 +- search/all_17.js | 110 +- search/all_18.js | 177 +- search/all_1c.js | 233 +- search/all_2.js | 1534 +-- search/all_3.js | 698 +- search/all_4.js | 1799 ++-- search/all_5.js | 8 +- search/all_6.js | 331 +- search/all_7.js | 522 +- search/all_8.js | 528 +- search/all_9.js | 298 +- search/all_a.js | 569 +- search/all_b.js | 6 +- search/all_c.js | 59 +- search/all_d.js | 895 +- search/all_e.js | 1427 +-- search/all_f.js | 48 +- search/classes_0.js | 3 +- search/classes_c.js | 279 +- search/enums_0.js | 3 +- search/enumvalues_13.js | 23 +- search/enumvalues_5.js | 3 +- search/enumvalues_6.js | 5 +- search/enumvalues_9.js | 31 +- search/enumvalues_c.js | 159 +- search/enumvalues_d.js | 33 +- search/functions_1.js | 564 +- search/functions_10.js | 4 +- search/functions_12.js | 245 +- search/functions_13.js | 970 +- search/functions_14.js | 1889 ++-- search/functions_15.js | 8 +- search/functions_16.js | 159 +- search/functions_1b.js | 233 +- search/functions_2.js | 285 +- search/functions_3.js | 379 +- search/functions_4.js | 4 +- search/functions_5.js | 4 +- search/functions_6.js | 236 +- search/functions_7.js | 508 +- search/functions_8.js | 4 +- search/functions_9.js | 841 +- search/functions_a.js | 6 +- search/functions_d.js | 4 +- search/functions_e.js | 215 +- search/functions_f.js | 61 +- search/typedefs_1.js | 4 +- search/typedefs_2.js | 51 +- search/typedefs_8.js | 53 +- search/variables_0.js | 40 +- search/variables_13.js | 4 +- search/variables_15.js | 70 +- search/variables_2.js | 240 +- search/variables_4.js | 57 +- search/variables_b.js | 190 +- search/variables_c.js | 2 +- search/variables_d.js | 12 +- search/variables_f.js | 191 +- structripple_1_1ConsensusParms-members.html | 45 +- structripple_1_1ConsensusParms.html | 495 +- ...ensusParms_1_1AvalancheCutoff-members.html | 91 + ..._1_1ConsensusParms_1_1AvalancheCutoff.html | 161 + ...sParms_1_1AvalancheCutoff__coll__graph.map | 4 + ...sParms_1_1AvalancheCutoff__coll__graph.md5 | 1 + ...sParms_1_1AvalancheCutoff__coll__graph.png | Bin 0 -> 5197 bytes ...tripple_1_1ConsensusParms__coll__graph.map | 10 +- ...tripple_1_1ConsensusParms__coll__graph.md5 | 2 +- ...tripple_1_1ConsensusParms__coll__graph.png | Bin 24356 -> 52046 bytes structripple_1_1ConsensusResult.html | 56 +- ...ripple_1_1ConsensusResult__coll__graph.map | 26 +- ...ripple_1_1ConsensusResult__coll__graph.md5 | 2 +- ...ripple_1_1ConsensusResult__coll__graph.png | Bin 57454 -> 65572 bytes ..._1_1NetworkOPsImp_1_1ServerFeeSummary.html | 16 +- ...Imp_1_1StateAccounting_1_1CounterData.html | 10 +- ...OPsImp_1_1StateAccounting_1_1Counters.html | 6 +- structripple_1_1NetworkOPsImp_1_1Stats.html | 26 +- ...tworkOPsImp_1_1SubAccountHistoryIndex.html | 18 +- ...etworkOPsImp_1_1SubAccountHistoryInfo.html | 6 +- ...rkOPsImp_1_1SubAccountHistoryInfoWeak.html | 6 +- ...1test_1_1Consensus__test_1_1Disruptor.html | 96 +- ...sensus__test_1_1Disruptor__coll__graph.map | 76 +- ...sensus__test_1_1Disruptor__coll__graph.md5 | 2 +- ...sensus__test_1_1Disruptor__coll__graph.png | Bin 544727 -> 547829 bytes ...1test_1_1Consensus__test_1_1UndoDelay.html | 86 +- ...sensus__test_1_1UndoDelay__coll__graph.map | 76 +- ...sensus__test_1_1UndoDelay__coll__graph.md5 | 2 +- ...sensus__test_1_1UndoDelay__coll__graph.png | Bin 542565 -> 545101 bytes structripple_1_1test_1_1csf_1_1Peer.html | 90 +- ...le_1_1test_1_1csf_1_1Peer__coll__graph.map | 90 +- ...le_1_1test_1_1csf_1_1Peer__coll__graph.md5 | 2 +- ...le_1_1test_1_1csf_1_1Peer__coll__graph.png | Bin 600267 -> 598359 bytes ...test_1_1csf_1_1TrustGraph_1_1ForkInfo.html | 100 +- ...1_1TrustGraph_1_1ForkInfo__coll__graph.map | 100 +- ...1_1TrustGraph_1_1ForkInfo__coll__graph.md5 | 2 +- ...1_1TrustGraph_1_1ForkInfo__coll__graph.png | Bin 579844 -> 583463 bytes test_2csf_2Peer_8h_source.html | 10 +- 2606 files changed, 30109 insertions(+), 26998 deletions(-) create mode 100644 functions_eval_a.html create mode 100644 functions_eval_b.html create mode 100644 functions_eval_c.html create mode 100644 functions_eval_d.html create mode 100644 functions_eval_e.html create mode 100644 functions_eval_f.html create mode 100644 functions_eval_g.html create mode 100644 functions_eval_h.html create mode 100644 functions_eval_i.html create mode 100644 functions_eval_k.html create mode 100644 functions_eval_l.html create mode 100644 functions_eval_m.html create mode 100644 functions_eval_n.html create mode 100644 functions_eval_o.html create mode 100644 functions_eval_p.html create mode 100644 functions_eval_q.html create mode 100644 functions_eval_r.html create mode 100644 functions_eval_s.html create mode 100644 functions_eval_t.html create mode 100644 functions_eval_u.html create mode 100644 functions_eval_v.html create mode 100644 functions_eval_w.html create mode 100644 inherit_graph_1002.map create mode 100644 inherit_graph_1002.md5 create mode 100644 inherit_graph_1002.png create mode 100644 structripple_1_1ConsensusParms_1_1AvalancheCutoff-members.html create mode 100644 structripple_1_1ConsensusParms_1_1AvalancheCutoff.html create mode 100644 structripple_1_1ConsensusParms_1_1AvalancheCutoff__coll__graph.map create mode 100644 structripple_1_1ConsensusParms_1_1AvalancheCutoff__coll__graph.md5 create mode 100644 structripple_1_1ConsensusParms_1_1AvalancheCutoff__coll__graph.png diff --git a/Application_8cpp_source.html b/Application_8cpp_source.html index 95073f34b1..9af3b6a54d 100644 --- a/Application_8cpp_source.html +++ b/Application_8cpp_source.html @@ -2563,7 +2563,7 @@ $(function() {
ripple::make_Application
std::unique_ptr< Application > make_Application(std::unique_ptr< Config > config, std::unique_ptr< Logs > logs, std::unique_ptr< TimeKeeper > timeKeeper)
Definition: Application.cpp:2189
ripple::make_ServerHandler
std::unique_ptr< ServerHandler > make_ServerHandler(Application &app, boost::asio::io_service &io_service, JobQueue &jobQueue, NetworkOPs &networkOPs, Resource::Manager &resourceManager, CollectorManager &cm)
Definition: ServerHandler.cpp:1268
ripple::initAccountIdCache
void initAccountIdCache(std::size_t count)
Initialize the global cache used to map AccountID to base58 conversions.
Definition: AccountID.cpp:107
-
ripple::make_NetworkOPs
std::unique_ptr< NetworkOPs > make_NetworkOPs(Application &app, NetworkOPs::clock_type &clock, bool standalone, std::size_t minPeerCount, bool startvalid, JobQueue &job_queue, LedgerMaster &ledgerMaster, ValidatorKeys const &validatorKeys, boost::asio::io_service &io_svc, beast::Journal journal, beast::insight::Collector::ptr const &collector)
Definition: NetworkOPs.cpp:4612
+
ripple::make_NetworkOPs
std::unique_ptr< NetworkOPs > make_NetworkOPs(Application &app, NetworkOPs::clock_type &clock, bool standalone, std::size_t minPeerCount, bool startvalid, JobQueue &job_queue, LedgerMaster &ledgerMaster, ValidatorKeys const &validatorKeys, boost::asio::io_service &io_svc, beast::Journal journal, beast::insight::Collector::ptr const &collector)
Definition: NetworkOPs.cpp:4639
ripple::Endpoints
std::unordered_map< std::string, boost::asio::ip::tcp::endpoint > Endpoints
Definition: ServerImpl.h:39
ripple::hotACCOUNT_NODE
@ hotACCOUNT_NODE
Definition: NodeObject.h:35
ripple::getNodeIdentity
std::pair< PublicKey, SecretKey > getNodeIdentity(Application &app, boost::program_options::variables_map const &cmdline)
The cryptographic credentials identifying this server instance.
Definition: NodeIdentity.cpp:29
diff --git a/ByzantineFailureSim__test_8cpp_source.html b/ByzantineFailureSim__test_8cpp_source.html index 13b6477108..ea06bf81a3 100644 --- a/ByzantineFailureSim__test_8cpp_source.html +++ b/ByzantineFailureSim__test_8cpp_source.html @@ -189,7 +189,7 @@ $(function() {
std::cout
ripple
Use hash_* containers for keys that do not need a cryptographically secure hashing algorithm.
Definition: algorithm.h:26
std::chrono
-
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:34
+
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:39
utility
diff --git a/ConsensusParms_8h_source.html b/ConsensusParms_8h_source.html index b3749cb464..ae5ef27098 100644 --- a/ConsensusParms_8h_source.html +++ b/ConsensusParms_8h_source.html @@ -98,99 +98,164 @@ $(function() {
20#ifndef RIPPLE_CONSENSUS_CONSENSUS_PARMS_H_INCLUDED
21#define RIPPLE_CONSENSUS_CONSENSUS_PARMS_H_INCLUDED
22
-
23#include <chrono>
-
24#include <cstddef>
-
25
-
26namespace ripple {
-
27
-
33struct ConsensusParms
-
34{
-
35 explicit ConsensusParms() = default;
-
36
-
37 //-------------------------------------------------------------------------
-
38 // Validation and proposal durations are relative to NetClock times, so use
-
39 // second resolution
-
46 std::chrono::seconds validationVALID_WALL = std::chrono::minutes{5};
-
47
-
54 std::chrono::seconds validationVALID_LOCAL = std::chrono::minutes{3};
-
55
-
61 std::chrono::seconds validationVALID_EARLY = std::chrono::minutes{3};
-
62
-
64 std::chrono::seconds proposeFRESHNESS = std::chrono::seconds{20};
-
65
-
67 std::chrono::seconds proposeINTERVAL = std::chrono::seconds{12};
-
68
-
69 //-------------------------------------------------------------------------
-
70 // Consensus durations are relative to the internal Consensus clock and use
-
71 // millisecond resolution.
-
72
-
74 std::size_t minCONSENSUS_PCT = 80;
-
75
-
77 std::chrono::milliseconds ledgerIDLE_INTERVAL = std::chrono::seconds{15};
-
78
-
80 std::chrono::milliseconds ledgerMIN_CONSENSUS =
-
81 std::chrono::milliseconds{1950};
-
82
-
89 std::chrono::milliseconds ledgerMAX_CONSENSUS = std::chrono::seconds{15};
-
90
-
92 std::chrono::milliseconds ledgerMIN_CLOSE = std::chrono::seconds{2};
-
93
-
95 std::chrono::milliseconds ledgerGRANULARITY = std::chrono::seconds{1};
-
96
-
107 std::chrono::milliseconds avMIN_CONSENSUS_TIME = std::chrono::seconds{5};
-
108
-
109 //------------------------------------------------------------------------------
-
110 // Avalanche tuning
-
111 // As a function of the percent this round's duration is of the prior round,
-
112 // we increase the threshold for yes votes to add a transaction to our
-
113 // position.
-
114
-
116 std::size_t avINIT_CONSENSUS_PCT = 50;
-
117
-
119 std::size_t avMID_CONSENSUS_TIME = 50;
-
120
-
122 std::size_t avMID_CONSENSUS_PCT = 65;
-
123
-
125 std::size_t avLATE_CONSENSUS_TIME = 85;
-
126
-
128 std::size_t avLATE_CONSENSUS_PCT = 70;
-
129
-
131 std::size_t avSTUCK_CONSENSUS_TIME = 200;
-
132
-
134 std::size_t avSTUCK_CONSENSUS_PCT = 95;
-
135
-
137 std::size_t avCT_CONSENSUS_PCT = 75;
-
138};
-
139
-
140} // namespace ripple
-
141#endif
+
23#include <xrpl/beast/utility/instrumentation.h>
+
24
+
25#include <chrono>
+
26#include <cstddef>
+
27#include <functional>
+
28#include <map>
+
29#include <optional>
+
30
+
31namespace ripple {
+
32
+
38struct ConsensusParms
+
39{
+
40 explicit ConsensusParms() = default;
+
41
+
42 //-------------------------------------------------------------------------
+
43 // Validation and proposal durations are relative to NetClock times, so use
+
44 // second resolution
+
51 std::chrono::seconds const validationVALID_WALL = std::chrono::minutes{5};
+
52
+
59 std::chrono::seconds const validationVALID_LOCAL = std::chrono::minutes{3};
+
60
+
66 std::chrono::seconds const validationVALID_EARLY = std::chrono::minutes{3};
+
67
+
69 std::chrono::seconds const proposeFRESHNESS = std::chrono::seconds{20};
+
70
+
72 std::chrono::seconds const proposeINTERVAL = std::chrono::seconds{12};
+
73
+
74 //-------------------------------------------------------------------------
+
75 // Consensus durations are relative to the internal Consensus clock and use
+
76 // millisecond resolution.
+
77
+
79 std::size_t const minCONSENSUS_PCT = 80;
+
80
+
82 std::chrono::milliseconds const ledgerIDLE_INTERVAL =
+
83 std::chrono::seconds{15};
+
84
+
86 std::chrono::milliseconds const ledgerMIN_CONSENSUS =
+
87 std::chrono::milliseconds{1950};
+
88
+
95 std::chrono::milliseconds const ledgerMAX_CONSENSUS =
+
96 std::chrono::seconds{15};
+
97
+
99 std::chrono::milliseconds const ledgerMIN_CLOSE = std::chrono::seconds{2};
+
100
+
102 std::chrono::milliseconds const ledgerGRANULARITY = std::chrono::seconds{1};
+
103
+
105 std::size_t const ledgerABANDON_CONSENSUS_FACTOR = 10;
+
106
+
113 std::chrono::milliseconds const ledgerABANDON_CONSENSUS =
+
114 std::chrono::seconds{120};
+
115
+
126 std::chrono::milliseconds const avMIN_CONSENSUS_TIME =
+
127 std::chrono::seconds{5};
+
128
+
129 //------------------------------------------------------------------------------
+
130 // Avalanche tuning
+
131 // As a function of the percent this round's duration is of the prior round,
+
132 // we increase the threshold for yes votes to add a transaction to our
+
133 // position.
+
134 enum AvalancheState { init, mid, late, stuck };
+
135 struct AvalancheCutoff
+
136 {
+
137 int const consensusTime;
+
138 std::size_t const consensusPct;
+
139 AvalancheState const next;
+
140 };
+
146 std::map<AvalancheState, AvalancheCutoff> const avalancheCutoffs{
+
147 // {state, {time, percent, nextState}},
+
148 // Initial state: 50% of nodes must vote yes
+
149 {init, {0, 50, mid}},
+
150 // mid-consensus starts after 50% of the previous round time, and
+
151 // requires 65% yes
+
152 {mid, {50, 65, late}},
+
153 // late consensus starts after 85% time, and requires 70% yes
+
154 {late, {85, 70, stuck}},
+
155 // we're stuck after 2x time, requires 95% yes votes
+
156 {stuck, {200, 95, stuck}},
+
157 };
+
158
+
160 std::size_t const avCT_CONSENSUS_PCT = 75;
+
161
+
163 // (Moving to the next avalanche level, considering that votes are stalled
+
164 // without consensus.)
+
165 std::size_t const avMIN_ROUNDS = 2;
+
166
+
169 std::size_t const avSTALLED_ROUNDS = 4;
+
170};
+
171
+
172inline std::pair<std::size_t, std::optional<ConsensusParms::AvalancheState>>
+
173getNeededWeight(
+
174 ConsensusParms const& p,
+
175 ConsensusParms::AvalancheState currentState,
+
176 int percentTime,
+
177 std::size_t currentRounds,
+
178 std::size_t minimumRounds)
+
179{
+
180 // at() can throw, but the map is built by hand to ensure all valid
+
181 // values are available.
+
182 auto const& currentCutoff = p.avalancheCutoffs.at(currentState);
+
183 // Should we consider moving to the next state?
+
184 if (currentCutoff.next != currentState && currentRounds >= minimumRounds)
+
185 {
+
186 // at() can throw, but the map is built by hand to ensure all
+
187 // valid values are available.
+
188 auto const& nextCutoff = p.avalancheCutoffs.at(currentCutoff.next);
+
189 // See if enough time has passed to move on to the next.
+
190 XRPL_ASSERT(
+
191 nextCutoff.consensusTime >= currentCutoff.consensusTime,
+
192 "ripple::getNeededWeight : next state valid");
+
193 if (percentTime >= nextCutoff.consensusTime)
+
194 {
+
195 return {nextCutoff.consensusPct, currentCutoff.next};
+
196 }
+
197 }
+
198 return {currentCutoff.consensusPct, {}};
+
199}
+
200
+
201} // namespace ripple
+
202#endif
chrono
cstddef
std::chrono::seconds
+
functional
+
map
ripple
Use hash_* containers for keys that do not need a cryptographically secure hashing algorithm.
Definition: algorithm.h:26
+
ripple::getNeededWeight
std::pair< std::size_t, std::optional< ConsensusParms::AvalancheState > > getNeededWeight(ConsensusParms const &p, ConsensusParms::AvalancheState currentState, int percentTime, std::size_t currentRounds, std::size_t minimumRounds)
Definition: ConsensusParms.h:173
+
optional
+
std::pair
std::size_t
-
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:34
-
ripple::ConsensusParms::avINIT_CONSENSUS_PCT
std::size_t avINIT_CONSENSUS_PCT
Percentage of nodes on our UNL that must vote yes.
Definition: ConsensusParms.h:116
-
ripple::ConsensusParms::minCONSENSUS_PCT
std::size_t minCONSENSUS_PCT
The percentage threshold above which we can declare consensus.
Definition: ConsensusParms.h:74
-
ripple::ConsensusParms::ledgerMIN_CONSENSUS
std::chrono::milliseconds ledgerMIN_CONSENSUS
The number of seconds we wait minimum to ensure participation.
Definition: ConsensusParms.h:80
-
ripple::ConsensusParms::ledgerIDLE_INTERVAL
std::chrono::milliseconds ledgerIDLE_INTERVAL
The duration a ledger may remain idle before closing.
Definition: ConsensusParms.h:77
-
ripple::ConsensusParms::avMIN_CONSENSUS_TIME
std::chrono::milliseconds avMIN_CONSENSUS_TIME
The minimum amount of time to consider the previous round to have taken.
Definition: ConsensusParms.h:107
-
ripple::ConsensusParms::avLATE_CONSENSUS_PCT
std::size_t avLATE_CONSENSUS_PCT
Percentage of nodes that most vote yes after advancing.
Definition: ConsensusParms.h:128
-
ripple::ConsensusParms::validationVALID_LOCAL
std::chrono::seconds validationVALID_LOCAL
Duration a validation remains current after first observed.
Definition: ConsensusParms.h:54
-
ripple::ConsensusParms::validationVALID_WALL
std::chrono::seconds validationVALID_WALL
The duration a validation remains current after its ledger's close time.
Definition: ConsensusParms.h:46
-
ripple::ConsensusParms::ledgerGRANULARITY
std::chrono::milliseconds ledgerGRANULARITY
How often we check state or change positions.
Definition: ConsensusParms.h:95
-
ripple::ConsensusParms::validationVALID_EARLY
std::chrono::seconds validationVALID_EARLY
Duration pre-close in which validations are acceptable.
Definition: ConsensusParms.h:61
-
ripple::ConsensusParms::avSTUCK_CONSENSUS_PCT
std::size_t avSTUCK_CONSENSUS_PCT
Percentage of nodes that must vote yes after we are stuck.
Definition: ConsensusParms.h:134
-
ripple::ConsensusParms::proposeFRESHNESS
std::chrono::seconds proposeFRESHNESS
How long we consider a proposal fresh.
Definition: ConsensusParms.h:64
-
ripple::ConsensusParms::ledgerMAX_CONSENSUS
std::chrono::milliseconds ledgerMAX_CONSENSUS
The maximum amount of time to spend pausing for laggards.
Definition: ConsensusParms.h:89
-
ripple::ConsensusParms::avLATE_CONSENSUS_TIME
std::size_t avLATE_CONSENSUS_TIME
Percentage of previous round duration before we advance.
Definition: ConsensusParms.h:125
-
ripple::ConsensusParms::ledgerMIN_CLOSE
std::chrono::milliseconds ledgerMIN_CLOSE
Minimum number of seconds to wait to ensure others have computed the LCL.
Definition: ConsensusParms.h:92
+
ripple::ConsensusParms::AvalancheCutoff
Definition: ConsensusParms.h:136
+
ripple::ConsensusParms::AvalancheCutoff::consensusPct
std::size_t const consensusPct
Definition: ConsensusParms.h:138
+
ripple::ConsensusParms::AvalancheCutoff::consensusTime
int const consensusTime
Definition: ConsensusParms.h:137
+
ripple::ConsensusParms::AvalancheCutoff::next
AvalancheState const next
Definition: ConsensusParms.h:139
+
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:39
+
ripple::ConsensusParms::avSTALLED_ROUNDS
std::size_t const avSTALLED_ROUNDS
Number of rounds before a stuck vote is considered unlikely to change because voting stalled.
Definition: ConsensusParms.h:169
+
ripple::ConsensusParms::ledgerGRANULARITY
std::chrono::milliseconds const ledgerGRANULARITY
How often we check state or change positions.
Definition: ConsensusParms.h:102
+
ripple::ConsensusParms::avCT_CONSENSUS_PCT
std::size_t const avCT_CONSENSUS_PCT
Percentage of nodes required to reach agreement on ledger close time.
Definition: ConsensusParms.h:160
+
ripple::ConsensusParms::proposeINTERVAL
std::chrono::seconds const proposeINTERVAL
How often we force generating a new proposal to keep ours fresh.
Definition: ConsensusParms.h:72
+
ripple::ConsensusParms::avMIN_ROUNDS
std::size_t const avMIN_ROUNDS
Number of rounds before certain actions can happen.
Definition: ConsensusParms.h:165
+
ripple::ConsensusParms::avMIN_CONSENSUS_TIME
std::chrono::milliseconds const avMIN_CONSENSUS_TIME
The minimum amount of time to consider the previous round to have taken.
Definition: ConsensusParms.h:126
+
ripple::ConsensusParms::validationVALID_EARLY
std::chrono::seconds const validationVALID_EARLY
Duration pre-close in which validations are acceptable.
Definition: ConsensusParms.h:66
+
ripple::ConsensusParms::AvalancheState
AvalancheState
Definition: ConsensusParms.h:134
+
ripple::ConsensusParms::mid
@ mid
Definition: ConsensusParms.h:134
+
ripple::ConsensusParms::stuck
@ stuck
Definition: ConsensusParms.h:134
+
ripple::ConsensusParms::late
@ late
Definition: ConsensusParms.h:134
+
ripple::ConsensusParms::init
@ init
Definition: ConsensusParms.h:134
+
ripple::ConsensusParms::ledgerIDLE_INTERVAL
std::chrono::milliseconds const ledgerIDLE_INTERVAL
The duration a ledger may remain idle before closing.
Definition: ConsensusParms.h:82
+
ripple::ConsensusParms::ledgerMIN_CONSENSUS
std::chrono::milliseconds const ledgerMIN_CONSENSUS
The number of seconds we wait minimum to ensure participation.
Definition: ConsensusParms.h:86
+
ripple::ConsensusParms::ledgerABANDON_CONSENSUS
std::chrono::milliseconds const ledgerABANDON_CONSENSUS
Maximum amount of time to give a consensus round.
Definition: ConsensusParms.h:113
ripple::ConsensusParms::ConsensusParms
ConsensusParms()=default
-
ripple::ConsensusParms::proposeINTERVAL
std::chrono::seconds proposeINTERVAL
How often we force generating a new proposal to keep ours fresh.
Definition: ConsensusParms.h:67
-
ripple::ConsensusParms::avCT_CONSENSUS_PCT
std::size_t avCT_CONSENSUS_PCT
Percentage of nodes required to reach agreement on ledger close time.
Definition: ConsensusParms.h:137
-
ripple::ConsensusParms::avMID_CONSENSUS_PCT
std::size_t avMID_CONSENSUS_PCT
Percentage of nodes that most vote yes after advancing.
Definition: ConsensusParms.h:122
-
ripple::ConsensusParms::avSTUCK_CONSENSUS_TIME
std::size_t avSTUCK_CONSENSUS_TIME
Percentage of previous round duration before we are stuck.
Definition: ConsensusParms.h:131
-
ripple::ConsensusParms::avMID_CONSENSUS_TIME
std::size_t avMID_CONSENSUS_TIME
Percentage of previous round duration before we advance.
Definition: ConsensusParms.h:119
+
ripple::ConsensusParms::minCONSENSUS_PCT
std::size_t const minCONSENSUS_PCT
The percentage threshold above which we can declare consensus.
Definition: ConsensusParms.h:79
+
ripple::ConsensusParms::avalancheCutoffs
std::map< AvalancheState, AvalancheCutoff > const avalancheCutoffs
Map the consensus requirement avalanche state to the amount of time that must pass before moving to t...
Definition: ConsensusParms.h:146
+
ripple::ConsensusParms::ledgerMIN_CLOSE
std::chrono::milliseconds const ledgerMIN_CLOSE
Minimum number of seconds to wait to ensure others have computed the LCL.
Definition: ConsensusParms.h:99
+
ripple::ConsensusParms::proposeFRESHNESS
std::chrono::seconds const proposeFRESHNESS
How long we consider a proposal fresh.
Definition: ConsensusParms.h:69
+
ripple::ConsensusParms::validationVALID_LOCAL
std::chrono::seconds const validationVALID_LOCAL
Duration a validation remains current after first observed.
Definition: ConsensusParms.h:59
+
ripple::ConsensusParms::ledgerMAX_CONSENSUS
std::chrono::milliseconds const ledgerMAX_CONSENSUS
The maximum amount of time to spend pausing for laggards.
Definition: ConsensusParms.h:95
+
ripple::ConsensusParms::validationVALID_WALL
std::chrono::seconds const validationVALID_WALL
The duration a validation remains current after its ledger's close time.
Definition: ConsensusParms.h:51
+
ripple::ConsensusParms::ledgerABANDON_CONSENSUS_FACTOR
std::size_t const ledgerABANDON_CONSENSUS_FACTOR
How long to wait before completely abandoning consensus.
Definition: ConsensusParms.h:105
diff --git a/ConsensusTypes_8h_source.html b/ConsensusTypes_8h_source.html index 5b46f755d7..4b5e25d93a 100644 --- a/ConsensusTypes_8h_source.html +++ b/ConsensusTypes_8h_source.html @@ -203,53 +203,54 @@ $(function() {
188enum class ConsensusState {
189 No,
190 MovedOn,
-
191 Yes
-
192};
-
193
-
202template <class Traits>
-
203struct ConsensusResult
-
204{
-
205 using Ledger_t = typename Traits::Ledger_t;
-
206 using TxSet_t = typename Traits::TxSet_t;
-
207 using NodeID_t = typename Traits::NodeID_t;
-
208
-
209 using Tx_t = typename TxSet_t::Tx;
-
210 using Proposal_t = ConsensusProposal<
-
211 NodeID_t,
-
212 typename Ledger_t::ID,
-
213 typename TxSet_t::ID>;
-
214 using Dispute_t = DisputedTx<Tx_t, NodeID_t>;
-
215
-
216 ConsensusResult(TxSet_t&& s, Proposal_t&& p)
-
217 : txns{std::move(s)}, position{std::move(p)}
-
218 {
-
219 XRPL_ASSERT(
-
220 txns.id() == position.position(),
-
221 "ripple::ConsensusResult : valid inputs");
-
222 }
-
223
-
225 TxSet_t txns;
-
226
-
228 Proposal_t position;
-
229
-
231 hash_map<typename Tx_t::ID, Dispute_t> disputes;
-
232
-
233 // Set of TxSet ids we have already compared/created disputes
-
234 hash_set<typename TxSet_t::ID> compares;
-
235
-
236 // Measures the duration of the establish phase for this consensus round
-
237 ConsensusTimer roundTime;
-
238
-
239 // Indicates state in which consensus ended. Once in the accept phase
-
240 // will be either Yes or MovedOn
-
241 ConsensusState state = ConsensusState::No;
-
242
-
243 // The number of peers proposing during the round
-
244 std::size_t proposers = 0;
-
245};
-
246} // namespace ripple
-
247
-
248#endif
+
191 Expired,
+
192 Yes
+
193};
+
194
+
203template <class Traits>
+
204struct ConsensusResult
+
205{
+
206 using Ledger_t = typename Traits::Ledger_t;
+
207 using TxSet_t = typename Traits::TxSet_t;
+
208 using NodeID_t = typename Traits::NodeID_t;
+
209
+
210 using Tx_t = typename TxSet_t::Tx;
+
211 using Proposal_t = ConsensusProposal<
+
212 NodeID_t,
+
213 typename Ledger_t::ID,
+
214 typename TxSet_t::ID>;
+
215 using Dispute_t = DisputedTx<Tx_t, NodeID_t>;
+
216
+
217 ConsensusResult(TxSet_t&& s, Proposal_t&& p)
+
218 : txns{std::move(s)}, position{std::move(p)}
+
219 {
+
220 XRPL_ASSERT(
+
221 txns.id() == position.position(),
+
222 "ripple::ConsensusResult : valid inputs");
+
223 }
+
224
+
226 TxSet_t txns;
+
227
+
229 Proposal_t position;
+
230
+
232 hash_map<typename Tx_t::ID, Dispute_t> disputes;
+
233
+
234 // Set of TxSet ids we have already compared/created disputes
+
235 hash_set<typename TxSet_t::ID> compares;
+
236
+
237 // Measures the duration of the establish phase for this consensus round
+
238 ConsensusTimer roundTime;
+
239
+
240 // Indicates state in which consensus ended. Once in the accept phase
+
241 // will be either Yes or MovedOn or Expired
+
242 ConsensusState state = ConsensusState::No;
+
243
+
244 // The number of peers proposing during the round
+
245 std::size_t proposers = 0;
+
246};
+
247} // namespace ripple
+
248
+
249#endif
@@ -278,6 +279,7 @@ $(function() {
ripple::ConsensusPhase::open
@ open
We haven't closed our ledger yet, but others might have.
ripple::ConsensusPhase::establish
@ establish
Establishing consensus by exchanging proposals with our peers.
ripple::ConsensusState
ConsensusState
Whether we have or don't have a consensus.
Definition: ConsensusTypes.h:188
+
ripple::ConsensusState::Expired
@ Expired
Consensus time limit has hard-expired.
ripple::ConsensusState::MovedOn
@ MovedOn
The network has consensus without us.
ripple::ConsensusState::No
@ No
We do not have consensus.
ripple::ManifestDisposition::accepted
@ accepted
Manifest is valid.
@@ -289,19 +291,19 @@ $(function() {
ripple::ConsensusCloseTimes::peers
std::map< NetClock::time_point, int > peers
Close time estimates, keep ordered for predictable traverse.
Definition: ConsensusTypes.h:181
ripple::ConsensusCloseTimes::self
NetClock::time_point self
Our close time estimate.
Definition: ConsensusTypes.h:184
-
ripple::ConsensusResult
Encapsulates the result of consensus.
Definition: ConsensusTypes.h:204
-
ripple::ConsensusResult::Ledger_t
typename Traits::Ledger_t Ledger_t
Definition: ConsensusTypes.h:205
-
ripple::ConsensusResult::ConsensusResult
ConsensusResult(TxSet_t &&s, Proposal_t &&p)
Definition: ConsensusTypes.h:216
-
ripple::ConsensusResult::Tx_t
typename TxSet_t::Tx Tx_t
Definition: ConsensusTypes.h:209
-
ripple::ConsensusResult::disputes
hash_map< typename Tx_t::ID, Dispute_t > disputes
Transactions which are under dispute with our peers.
Definition: ConsensusTypes.h:231
-
ripple::ConsensusResult::compares
hash_set< typename TxSet_t::ID > compares
Definition: ConsensusTypes.h:234
-
ripple::ConsensusResult::NodeID_t
typename Traits::NodeID_t NodeID_t
Definition: ConsensusTypes.h:207
-
ripple::ConsensusResult::txns
TxSet_t txns
The set of transactions consensus agrees go in the ledger.
Definition: ConsensusTypes.h:225
- -
ripple::ConsensusResult::roundTime
ConsensusTimer roundTime
Definition: ConsensusTypes.h:237
-
ripple::ConsensusResult::TxSet_t
typename Traits::TxSet_t TxSet_t
Definition: ConsensusTypes.h:206
- -
ripple::ConsensusResult::position
Proposal_t position
Our proposed position on transactions/close time.
Definition: ConsensusTypes.h:228
+
ripple::ConsensusResult
Encapsulates the result of consensus.
Definition: ConsensusTypes.h:205
+
ripple::ConsensusResult::Ledger_t
typename Traits::Ledger_t Ledger_t
Definition: ConsensusTypes.h:206
+
ripple::ConsensusResult::ConsensusResult
ConsensusResult(TxSet_t &&s, Proposal_t &&p)
Definition: ConsensusTypes.h:217
+
ripple::ConsensusResult::Tx_t
typename TxSet_t::Tx Tx_t
Definition: ConsensusTypes.h:210
+
ripple::ConsensusResult::disputes
hash_map< typename Tx_t::ID, Dispute_t > disputes
Transactions which are under dispute with our peers.
Definition: ConsensusTypes.h:232
+
ripple::ConsensusResult::compares
hash_set< typename TxSet_t::ID > compares
Definition: ConsensusTypes.h:235
+
ripple::ConsensusResult::NodeID_t
typename Traits::NodeID_t NodeID_t
Definition: ConsensusTypes.h:208
+
ripple::ConsensusResult::txns
TxSet_t txns
The set of transactions consensus agrees go in the ledger.
Definition: ConsensusTypes.h:226
+ +
ripple::ConsensusResult::roundTime
ConsensusTimer roundTime
Definition: ConsensusTypes.h:238
+
ripple::ConsensusResult::TxSet_t
typename Traits::TxSet_t TxSet_t
Definition: ConsensusTypes.h:207
+ +
ripple::ConsensusResult::position
Proposal_t position
Our proposed position on transactions/close time.
Definition: ConsensusTypes.h:229
diff --git a/Consensus_8cpp_source.html b/Consensus_8cpp_source.html index a66c84a92f..6bfaaa0b4c 100644 --- a/Consensus_8cpp_source.html +++ b/Consensus_8cpp_source.html @@ -124,7 +124,7 @@ $(function() {
46 << ", timeSincePrevClose: " << timeSincePrevClose.count() << "ms"
47 << ", openTime: " << openTime.count() << "ms"
48 << ", idleInterval: " << idleInterval.count() << "ms"
-
49 << ", ledgerMIN_CLOSE: " << parms.ledgerMIN_CLOSE.count() << "ms"
+
49 << ", ledgerMIN_CLOSE: " << parms.ledgerMIN_CLOSE.count() << "ms"
50 << ". ";
51 using namespace std::chrono_literals;
52 if ((prevRoundTime < -1s) || (prevRoundTime > 10min) ||
@@ -158,7 +158,7 @@ $(function() {
80 }
81
82 // Preserve minimum ledger open time
-
83 if (openTime < parms.ledgerMIN_CLOSE)
+
83 if (openTime < parms.ledgerMIN_CLOSE)
84 {
85 JLOG(j.debug()) << "Must wait minimum time before closing";
86 CLOG(clog) << "not closing because under ledgerMIN_CLOSE. ";
@@ -181,144 +181,175 @@ $(function() {
103}
104
105bool
-
106checkConsensusReached(
+
106checkConsensusReached(
107 std::size_t agreeing,
108 std::size_t total,
109 bool count_self,
110 std::size_t minConsensusPct,
111 bool reachedMax,
-
112 std::unique_ptr<std::stringstream> const& clog)
-
113{
-
114 CLOG(clog) << "checkConsensusReached params: agreeing: " << agreeing
-
115 << ", total: " << total << ", count_self: " << count_self
-
116 << ", minConsensusPct: " << minConsensusPct
-
117 << ", reachedMax: " << reachedMax << ". ";
-
118
-
119 // If we are alone for too long, we have consensus.
-
120 // Delaying consensus like this avoids a circumstance where a peer
-
121 // gets ahead of proposers insofar as it has not received any proposals.
-
122 // This could happen if there's a slowdown in receiving proposals. Reaching
-
123 // consensus prematurely in this way means that the peer will likely desync.
-
124 // The check for reachedMax should allow plenty of time for proposals to
-
125 // arrive, and there should be no downside. If a peer is truly not
-
126 // receiving any proposals, then there should be no hurry. There's
-
127 // really nowhere to go.
-
128 if (total == 0)
-
129 {
-
130 if (reachedMax)
-
131 {
-
132 CLOG(clog)
-
133 << "Consensus reached because nobody shares our position and "
-
134 "maximum duration has passed.";
-
135 return true;
-
136 }
-
137 CLOG(clog) << "Consensus not reached and nobody shares our position. ";
-
138 return false;
-
139 }
-
140
-
141 if (count_self)
-
142 {
-
143 ++agreeing;
-
144 ++total;
-
145 CLOG(clog) << "agreeing and total adjusted: " << agreeing << ','
-
146 << total << ". ";
-
147 }
-
148
-
149 std::size_t currentPercentage = (agreeing * 100) / total;
-
150 CLOG(clog) << "currentPercentage: " << currentPercentage;
-
151 bool const ret = currentPercentage >= minConsensusPct;
-
152 if (ret)
-
153 {
-
154 CLOG(clog) << ", consensus reached. ";
-
155 }
-
156 else
-
157 {
-
158 CLOG(clog) << ", consensus not reached. ";
+
112 bool stalled,
+
113 std::unique_ptr<std::stringstream> const& clog)
+
114{
+
115 CLOG(clog) << "checkConsensusReached params: agreeing: " << agreeing
+
116 << ", total: " << total << ", count_self: " << count_self
+
117 << ", minConsensusPct: " << minConsensusPct
+
118 << ", reachedMax: " << reachedMax << ". ";
+
119
+
120 // If we are alone for too long, we have consensus.
+
121 // Delaying consensus like this avoids a circumstance where a peer
+
122 // gets ahead of proposers insofar as it has not received any proposals.
+
123 // This could happen if there's a slowdown in receiving proposals. Reaching
+
124 // consensus prematurely in this way means that the peer will likely desync.
+
125 // The check for reachedMax should allow plenty of time for proposals to
+
126 // arrive, and there should be no downside. If a peer is truly not
+
127 // receiving any proposals, then there should be no hurry. There's
+
128 // really nowhere to go.
+
129 if (total == 0)
+
130 {
+
131 if (reachedMax)
+
132 {
+
133 CLOG(clog)
+
134 << "Consensus reached because nobody shares our position and "
+
135 "maximum duration has passed.";
+
136 return true;
+
137 }
+
138 CLOG(clog) << "Consensus not reached and nobody shares our position. ";
+
139 return false;
+
140 }
+
141
+
142 // We only get stalled when every disputed transaction unequivocally has 80%
+
143 // (minConsensusPct) agreement, either for or against. That is: either under
+
144 // 20% or over 80% consensus (repectively "nay" or "yay"). This prevents
+
145 // manipulation by a minority of byzantine peers of which transactions make
+
146 // the cut to get into the ledger.
+
147 if (stalled)
+
148 {
+
149 CLOG(clog) << "consensus stalled. ";
+
150 return true;
+
151 }
+
152
+
153 if (count_self)
+
154 {
+
155 ++agreeing;
+
156 ++total;
+
157 CLOG(clog) << "agreeing and total adjusted: " << agreeing << ','
+
158 << total << ". ";
159 }
-
160 return ret;
-
161}
+
160
+
161 std::size_t currentPercentage = (agreeing * 100) / total;
162
-
163ConsensusState
-
164checkConsensus(
-
165 std::size_t prevProposers,
-
166 std::size_t currentProposers,
-
167 std::size_t currentAgree,
-
168 std::size_t currentFinished,
-
169 std::chrono::milliseconds previousAgreeTime,
-
170 std::chrono::milliseconds currentAgreeTime,
-
171 ConsensusParms const& parms,
-
172 bool proposing,
-
173 beast::Journal j,
-
174 std::unique_ptr<std::stringstream> const& clog)
-
175{
-
176 CLOG(clog) << "checkConsensus: prop=" << currentProposers << "/"
-
177 << prevProposers << " agree=" << currentAgree
-
178 << " validated=" << currentFinished
-
179 << " time=" << currentAgreeTime.count() << "/"
-
180 << previousAgreeTime.count() << " proposing? " << proposing
-
181 << " minimum duration to reach consensus: "
-
182 << parms.ledgerMIN_CONSENSUS.count() << "ms"
-
183 << " max consensus time " << parms.ledgerMAX_CONSENSUS.count()
-
184 << "s"
-
185 << " minimum consensus percentage: " << parms.minCONSENSUS_PCT
-
186 << ". ";
-
187
-
188 if (currentAgreeTime <= parms.ledgerMIN_CONSENSUS)
-
189 {
-
190 CLOG(clog) << "Not reached. ";
-
191 return ConsensusState::No;
-
192 }
-
193
-
194 if (currentProposers < (prevProposers * 3 / 4))
-
195 {
-
196 // Less than 3/4 of the last ledger's proposers are present; don't
-
197 // rush: we may need more time.
-
198 if (currentAgreeTime < (previousAgreeTime + parms.ledgerMIN_CONSENSUS))
-
199 {
-
200 JLOG(j.trace()) << "too fast, not enough proposers";
-
201 CLOG(clog) << "Too fast, not enough proposers. Not reached. ";
-
202 return ConsensusState::No;
-
203 }
-
204 }
-
205
-
206 // Have we, together with the nodes on our UNL list, reached the threshold
-
207 // to declare consensus?
-
208 if (checkConsensusReached(
-
209 currentAgree,
-
210 currentProposers,
-
211 proposing,
-
212 parms.minCONSENSUS_PCT,
-
213 currentAgreeTime > parms.ledgerMAX_CONSENSUS,
-
214 clog))
-
215 {
-
216 JLOG(j.debug()) << "normal consensus";
-
217 CLOG(clog) << "reached. ";
-
218 return ConsensusState::Yes;
-
219 }
-
220
-
221 // Have sufficient nodes on our UNL list moved on and reached the threshold
-
222 // to declare consensus?
-
223 if (checkConsensusReached(
-
224 currentFinished,
-
225 currentProposers,
-
226 false,
-
227 parms.minCONSENSUS_PCT,
-
228 currentAgreeTime > parms.ledgerMAX_CONSENSUS,
+
163 CLOG(clog) << "currentPercentage: " << currentPercentage;
+
164 bool const ret = currentPercentage >= minConsensusPct;
+
165 if (ret)
+
166 {
+
167 CLOG(clog) << ", consensus reached. ";
+
168 }
+
169 else
+
170 {
+
171 CLOG(clog) << ", consensus not reached. ";
+
172 }
+
173 return ret;
+
174}
+
175
+
176ConsensusState
+
177checkConsensus(
+
178 std::size_t prevProposers,
+
179 std::size_t currentProposers,
+
180 std::size_t currentAgree,
+
181 std::size_t currentFinished,
+
182 std::chrono::milliseconds previousAgreeTime,
+
183 std::chrono::milliseconds currentAgreeTime,
+
184 bool stalled,
+
185 ConsensusParms const& parms,
+
186 bool proposing,
+
187 beast::Journal j,
+
188 std::unique_ptr<std::stringstream> const& clog)
+
189{
+
190 CLOG(clog) << "checkConsensus: prop=" << currentProposers << "/"
+
191 << prevProposers << " agree=" << currentAgree
+
192 << " validated=" << currentFinished
+
193 << " time=" << currentAgreeTime.count() << "/"
+
194 << previousAgreeTime.count() << " proposing? " << proposing
+
195 << " minimum duration to reach consensus: "
+
196 << parms.ledgerMIN_CONSENSUS.count() << "ms"
+
197 << " max consensus time " << parms.ledgerMAX_CONSENSUS.count()
+
198 << "ms"
+
199 << " minimum consensus percentage: " << parms.minCONSENSUS_PCT
+
200 << ". ";
+
201
+
202 if (currentAgreeTime <= parms.ledgerMIN_CONSENSUS)
+
203 {
+
204 CLOG(clog) << "Not reached. ";
+
205 return ConsensusState::No;
+
206 }
+
207
+
208 if (currentProposers < (prevProposers * 3 / 4))
+
209 {
+
210 // Less than 3/4 of the last ledger's proposers are present; don't
+
211 // rush: we may need more time.
+
212 if (currentAgreeTime < (previousAgreeTime + parms.ledgerMIN_CONSENSUS))
+
213 {
+
214 JLOG(j.trace()) << "too fast, not enough proposers";
+
215 CLOG(clog) << "Too fast, not enough proposers. Not reached. ";
+
216 return ConsensusState::No;
+
217 }
+
218 }
+
219
+
220 // Have we, together with the nodes on our UNL list, reached the threshold
+
221 // to declare consensus?
+
222 if (checkConsensusReached(
+
223 currentAgree,
+
224 currentProposers,
+
225 proposing,
+
226 parms.minCONSENSUS_PCT,
+
227 currentAgreeTime > parms.ledgerMAX_CONSENSUS,
+
228 stalled,
229 clog))
230 {
-
231 JLOG(j.warn()) << "We see no consensus, but 80% of nodes have moved on";
-
232 CLOG(clog) << "We see no consensus, but 80% of nodes have moved on";
-
233 return ConsensusState::MovedOn;
-
234 }
-
235
-
236 // no consensus yet
-
237 JLOG(j.trace()) << "no consensus";
-
238 CLOG(clog) << "No consensus. ";
-
239 return ConsensusState::No;
-
240}
-
241
-
242} // namespace ripple
+
231 JLOG((stalled ? j.warn() : j.debug()))
+
232 << "normal consensus" << (stalled ? ", but stalled" : "");
+
233 CLOG(clog) << "reached" << (stalled ? ", but stalled." : ".");
+
234 return ConsensusState::Yes;
+
235 }
+
236
+
237 // Have sufficient nodes on our UNL list moved on and reached the threshold
+
238 // to declare consensus?
+
239 if (checkConsensusReached(
+
240 currentFinished,
+
241 currentProposers,
+
242 false,
+
243 parms.minCONSENSUS_PCT,
+
244 currentAgreeTime > parms.ledgerMAX_CONSENSUS,
+
245 false,
+
246 clog))
+
247 {
+
248 JLOG(j.warn()) << "We see no consensus, but 80% of nodes have moved on";
+
249 CLOG(clog) << "We see no consensus, but 80% of nodes have moved on";
+
250 return ConsensusState::MovedOn;
+
251 }
+
252
+
253 std::chrono::milliseconds const maxAgreeTime =
+
254 previousAgreeTime * parms.ledgerABANDON_CONSENSUS_FACTOR;
+
255 if (currentAgreeTime > std::clamp(
+
256 maxAgreeTime,
+
257 parms.ledgerMAX_CONSENSUS,
+
258 parms.ledgerABANDON_CONSENSUS))
+
259 {
+
260 JLOG(j.warn()) << "consensus taken too long";
+
261 CLOG(clog) << "Consensus taken too long. ";
+
262 // Note the Expired result may be overridden by the caller.
+
263 return ConsensusState::Expired;
+
264 }
+
265
+
266 // no consensus yet
+
267 JLOG(j.trace()) << "no consensus";
+
268 CLOG(clog) << "No consensus. ";
+
269 return ConsensusState::No;
+
270}
+
271
+
272} // namespace ripple
+
std::clamp
T clamp(T... args)
beast::Journal
A generic endpoint for log messages.
Definition: Journal.h:60
beast::Journal::debug
Stream debug() const
Definition: Journal.h:328
beast::Journal::trace
Stream trace() const
Severity stream access functions.
Definition: Journal.h:322
@@ -326,21 +357,24 @@ $(function() {
ripple
Use hash_* containers for keys that do not need a cryptographically secure hashing algorithm.
Definition: algorithm.h:26
-
ripple::checkConsensus
ConsensusState checkConsensus(std::size_t prevProposers, std::size_t currentProposers, std::size_t currentAgree, std::size_t currentFinished, std::chrono::milliseconds previousAgreeTime, std::chrono::milliseconds currentAgreeTime, ConsensusParms const &parms, bool proposing, beast::Journal j, std::unique_ptr< std::stringstream > const &clog)
Determine whether the network reached consensus and whether we joined.
Definition: Consensus.cpp:164
ripple::ConsensusMode::proposing
@ proposing
We are normal participant in consensus and propose our position.
+
ripple::checkConsensus
ConsensusState checkConsensus(std::size_t prevProposers, std::size_t currentProposers, std::size_t currentAgree, std::size_t currentFinished, std::chrono::milliseconds previousAgreeTime, std::chrono::milliseconds currentAgreeTime, bool stalled, ConsensusParms const &parms, bool proposing, beast::Journal j, std::unique_ptr< std::stringstream > const &clog)
Determine whether the network reached consensus and whether we joined.
Definition: Consensus.cpp:177
+
ripple::checkConsensusReached
bool checkConsensusReached(std::size_t agreeing, std::size_t total, bool count_self, std::size_t minConsensusPct, bool reachedMax, bool stalled, std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.cpp:106
ripple::ConsensusState
ConsensusState
Whether we have or don't have a consensus.
Definition: ConsensusTypes.h:188
+
ripple::ConsensusState::Expired
@ Expired
Consensus time limit has hard-expired.
ripple::ConsensusState::MovedOn
@ MovedOn
The network has consensus without us.
ripple::ConsensusState::Yes
@ Yes
We have consensus along with the network.
ripple::ConsensusState::No
@ No
We do not have consensus.
-
ripple::checkConsensusReached
bool checkConsensusReached(std::size_t agreeing, std::size_t total, bool count_self, std::size_t minConsensusPct, bool reachedMax, std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.cpp:106
ripple::shouldCloseLedger
bool shouldCloseLedger(bool anyTransactions, std::size_t prevProposers, std::size_t proposersClosed, std::size_t proposersValidated, std::chrono::milliseconds prevRoundTime, std::chrono::milliseconds timeSincePrevClose, std::chrono::milliseconds openTime, std::chrono::milliseconds idleInterval, ConsensusParms const &parms, beast::Journal j, std::unique_ptr< std::stringstream > const &clog)
Determines whether the current ledger should close at this time.
Definition: Consensus.cpp:27
std::stringstream::str
T str(T... args)
-
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:34
-
ripple::ConsensusParms::minCONSENSUS_PCT
std::size_t minCONSENSUS_PCT
The percentage threshold above which we can declare consensus.
Definition: ConsensusParms.h:74
-
ripple::ConsensusParms::ledgerMIN_CONSENSUS
std::chrono::milliseconds ledgerMIN_CONSENSUS
The number of seconds we wait minimum to ensure participation.
Definition: ConsensusParms.h:80
-
ripple::ConsensusParms::ledgerMAX_CONSENSUS
std::chrono::milliseconds ledgerMAX_CONSENSUS
The maximum amount of time to spend pausing for laggards.
Definition: ConsensusParms.h:89
-
ripple::ConsensusParms::ledgerMIN_CLOSE
std::chrono::milliseconds ledgerMIN_CLOSE
Minimum number of seconds to wait to ensure others have computed the LCL.
Definition: ConsensusParms.h:92
+
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:39
+
ripple::ConsensusParms::ledgerMIN_CONSENSUS
std::chrono::milliseconds const ledgerMIN_CONSENSUS
The number of seconds we wait minimum to ensure participation.
Definition: ConsensusParms.h:86
+
ripple::ConsensusParms::ledgerABANDON_CONSENSUS
std::chrono::milliseconds const ledgerABANDON_CONSENSUS
Maximum amount of time to give a consensus round.
Definition: ConsensusParms.h:113
+
ripple::ConsensusParms::minCONSENSUS_PCT
std::size_t const minCONSENSUS_PCT
The percentage threshold above which we can declare consensus.
Definition: ConsensusParms.h:79
+
ripple::ConsensusParms::ledgerMIN_CLOSE
std::chrono::milliseconds const ledgerMIN_CLOSE
Minimum number of seconds to wait to ensure others have computed the LCL.
Definition: ConsensusParms.h:99
+
ripple::ConsensusParms::ledgerMAX_CONSENSUS
std::chrono::milliseconds const ledgerMAX_CONSENSUS
The maximum amount of time to spend pausing for laggards.
Definition: ConsensusParms.h:95
+
ripple::ConsensusParms::ledgerABANDON_CONSENSUS_FACTOR
std::size_t const ledgerABANDON_CONSENSUS_FACTOR
How long to wait before completely abandoning consensus.
Definition: ConsensusParms.h:105
diff --git a/Consensus_8h_source.html b/Consensus_8h_source.html index ea7c07eba2..802d85f835 100644 --- a/Consensus_8h_source.html +++ b/Consensus_8h_source.html @@ -109,1437 +109,1493 @@ $(function() {
31#include <xrpl/beast/utility/Journal.h>
32#include <xrpl/json/json_writer.h>
33
-
34#include <chrono>
-
35#include <deque>
-
36#include <optional>
-
37#include <sstream>
-
38
-
39namespace ripple {
-
40
-
60bool
-
61shouldCloseLedger(
-
62 bool anyTransactions,
-
63 std::size_t prevProposers,
-
64 std::size_t proposersClosed,
-
65 std::size_t proposersValidated,
-
66 std::chrono::milliseconds prevRoundTime,
-
67 std::chrono::milliseconds timeSincePrevClose,
-
68 std::chrono::milliseconds openTime,
-
69 std::chrono::milliseconds idleInterval,
-
70 ConsensusParms const& parms,
-
71 beast::Journal j,
-
72 std::unique_ptr<std::stringstream> const& clog = {});
-
73
-
89ConsensusState
-
90checkConsensus(
-
91 std::size_t prevProposers,
-
92 std::size_t currentProposers,
-
93 std::size_t currentAgree,
-
94 std::size_t currentFinished,
-
95 std::chrono::milliseconds previousAgreeTime,
-
96 std::chrono::milliseconds currentAgreeTime,
-
97 ConsensusParms const& parms,
-
98 bool proposing,
-
99 beast::Journal j,
-
100 std::unique_ptr<std::stringstream> const& clog = {});
-
101
-
290template <class Adaptor>
-
291class Consensus
-
292{
-
293 using Ledger_t = typename Adaptor::Ledger_t;
-
294 using TxSet_t = typename Adaptor::TxSet_t;
-
295 using NodeID_t = typename Adaptor::NodeID_t;
-
296 using Tx_t = typename TxSet_t::Tx;
-
297 using PeerPosition_t = typename Adaptor::PeerPosition_t;
-
298 using Proposal_t = ConsensusProposal<
-
299 NodeID_t,
-
300 typename Ledger_t::ID,
-
301 typename TxSet_t::ID>;
-
302
-
303 using Result = ConsensusResult<Adaptor>;
-
304
-
305 // Helper class to ensure adaptor is notified whenever the ConsensusMode
-
306 // changes
-
307 class MonitoredMode
-
308 {
-
309 ConsensusMode mode_;
+
34#include <algorithm>
+
35#include <chrono>
+
36#include <deque>
+
37#include <optional>
+
38#include <sstream>
+
39
+
40namespace ripple {
+
41
+
61bool
+
62shouldCloseLedger(
+
63 bool anyTransactions,
+
64 std::size_t prevProposers,
+
65 std::size_t proposersClosed,
+
66 std::size_t proposersValidated,
+
67 std::chrono::milliseconds prevRoundTime,
+
68 std::chrono::milliseconds timeSincePrevClose,
+
69 std::chrono::milliseconds openTime,
+
70 std::chrono::milliseconds idleInterval,
+
71 ConsensusParms const& parms,
+
72 beast::Journal j,
+
73 std::unique_ptr<std::stringstream> const& clog = {});
+
74
+
94ConsensusState
+
95checkConsensus(
+
96 std::size_t prevProposers,
+
97 std::size_t currentProposers,
+
98 std::size_t currentAgree,
+
99 std::size_t currentFinished,
+
100 std::chrono::milliseconds previousAgreeTime,
+
101 std::chrono::milliseconds currentAgreeTime,
+
102 bool stalled,
+
103 ConsensusParms const& parms,
+
104 bool proposing,
+
105 beast::Journal j,
+
106 std::unique_ptr<std::stringstream> const& clog = {});
+
107
+
296template <class Adaptor>
+
297class Consensus
+
298{
+
299 using Ledger_t = typename Adaptor::Ledger_t;
+
300 using TxSet_t = typename Adaptor::TxSet_t;
+
301 using NodeID_t = typename Adaptor::NodeID_t;
+
302 using Tx_t = typename TxSet_t::Tx;
+
303 using PeerPosition_t = typename Adaptor::PeerPosition_t;
+
304 using Proposal_t = ConsensusProposal<
+
305 NodeID_t,
+
306 typename Ledger_t::ID,
+
307 typename TxSet_t::ID>;
+
308
+
309 using Result = ConsensusResult<Adaptor>;
310
-
311 public:
-
312 MonitoredMode(ConsensusMode m) : mode_{m}
-
313 {
-
314 }
-
315 ConsensusMode
-
316 get() const
-
317 {
-
318 return mode_;
-
319 }
-
320
-
321 void
-
322 set(ConsensusMode mode, Adaptor& a)
-
323 {
-
324 a.onModeChange(mode_, mode);
-
325 mode_ = mode;
-
326 }
-
327 };
-
328
-
329public:
-
331 using clock_type = beast::abstract_clock<std::chrono::steady_clock>;
-
332
-
333 Consensus(Consensus&&) noexcept = default;
+
311 // Helper class to ensure adaptor is notified whenever the ConsensusMode
+
312 // changes
+
313 class MonitoredMode
+
314 {
+
315 ConsensusMode mode_;
+
316
+
317 public:
+
318 MonitoredMode(ConsensusMode m) : mode_{m}
+
319 {
+
320 }
+
321 ConsensusMode
+
322 get() const
+
323 {
+
324 return mode_;
+
325 }
+
326
+
327 void
+
328 set(ConsensusMode mode, Adaptor& a)
+
329 {
+
330 a.onModeChange(mode_, mode);
+
331 mode_ = mode;
+
332 }
+
333 };
334
-
341 Consensus(clock_type const& clock, Adaptor& adaptor, beast::Journal j);
-
342
-
358 void
-
359 startRound(
-
360 NetClock::time_point const& now,
-
361 typename Ledger_t::ID const& prevLedgerID,
-
362 Ledger_t prevLedger,
-
363 hash_set<NodeID_t> const& nowUntrusted,
-
364 bool proposing,
-
365 std::unique_ptr<std::stringstream> const& clog = {});
-
366
-
373 bool
-
374 peerProposal(
-
375 NetClock::time_point const& now,
-
376 PeerPosition_t const& newProposal);
-
377
-
383 void
-
384 timerEntry(
-
385 NetClock::time_point const& now,
-
386 std::unique_ptr<std::stringstream> const& clog = {});
-
387
-
393 void
-
394 gotTxSet(NetClock::time_point const& now, TxSet_t const& txSet);
-
395
-
412 void
-
413 simulate(
-
414 NetClock::time_point const& now,
-
415 std::optional<std::chrono::milliseconds> consensusDelay);
-
416
-
424 typename Ledger_t::ID
-
425 prevLedgerID() const
-
426 {
-
427 return prevLedgerID_;
-
428 }
-
429
-
430 ConsensusPhase
-
431 phase() const
+
335public:
+
337 using clock_type = beast::abstract_clock<std::chrono::steady_clock>;
+
338
+
339 Consensus(Consensus&&) noexcept = default;
+
340
+
347 Consensus(clock_type const& clock, Adaptor& adaptor, beast::Journal j);
+
348
+
364 void
+
365 startRound(
+
366 NetClock::time_point const& now,
+
367 typename Ledger_t::ID const& prevLedgerID,
+
368 Ledger_t prevLedger,
+
369 hash_set<NodeID_t> const& nowUntrusted,
+
370 bool proposing,
+
371 std::unique_ptr<std::stringstream> const& clog = {});
+
372
+
379 bool
+
380 peerProposal(
+
381 NetClock::time_point const& now,
+
382 PeerPosition_t const& newProposal);
+
383
+
389 void
+
390 timerEntry(
+
391 NetClock::time_point const& now,
+
392 std::unique_ptr<std::stringstream> const& clog = {});
+
393
+
399 void
+
400 gotTxSet(NetClock::time_point const& now, TxSet_t const& txSet);
+
401
+
418 void
+
419 simulate(
+
420 NetClock::time_point const& now,
+
421 std::optional<std::chrono::milliseconds> consensusDelay);
+
422
+
430 typename Ledger_t::ID
+
431 prevLedgerID() const
432 {
-
433 return phase_;
+
433 return prevLedgerID_;
434 }
435
-
443 Json::Value
-
444 getJson(bool full) const;
-
445
-
446private:
-
447 void
-
448 startRoundInternal(
-
449 NetClock::time_point const& now,
-
450 typename Ledger_t::ID const& prevLedgerID,
-
451 Ledger_t const& prevLedger,
-
452 ConsensusMode mode,
-
453 std::unique_ptr<std::stringstream> const& clog);
-
454
-
455 // Change our view of the previous ledger
-
456 void
-
457 handleWrongLedger(
-
458 typename Ledger_t::ID const& lgrId,
+
436 ConsensusPhase
+
437 phase() const
+
438 {
+
439 return phase_;
+
440 }
+
441
+
449 Json::Value
+
450 getJson(bool full) const;
+
451
+
452private:
+
453 void
+
454 startRoundInternal(
+
455 NetClock::time_point const& now,
+
456 typename Ledger_t::ID const& prevLedgerID,
+
457 Ledger_t const& prevLedger,
+
458 ConsensusMode mode,
459 std::unique_ptr<std::stringstream> const& clog);
460
-
466 void
-
467 checkLedger(std::unique_ptr<std::stringstream> const& clog);
-
468
+
461 // Change our view of the previous ledger
+
462 void
+
463 handleWrongLedger(
+
464 typename Ledger_t::ID const& lgrId,
+
465 std::unique_ptr<std::stringstream> const& clog);
+
466
472 void
-
473 playbackProposals();
+
473 checkLedger(std::unique_ptr<std::stringstream> const& clog);
474
-
477 bool
-
478 peerProposalInternal(
-
479 NetClock::time_point const& now,
-
480 PeerPosition_t const& newProposal);
-
481
-
488 void
-
489 phaseOpen(std::unique_ptr<std::stringstream> const& clog);
-
490
-
499 void
-
500 phaseEstablish(std::unique_ptr<std::stringstream> const& clog);
-
501
-
524 bool
-
525 shouldPause(std::unique_ptr<std::stringstream> const& clog) const;
-
526
-
527 // Close the open ledger and establish initial position.
-
528 void
-
529 closeLedger(std::unique_ptr<std::stringstream> const& clog);
-
530
-
531 // Adjust our positions to try to agree with other validators.
-
532 void
-
533 updateOurPositions(std::unique_ptr<std::stringstream> const& clog);
-
534
-
535 bool
-
536 haveConsensus(std::unique_ptr<std::stringstream> const& clog);
-
537
-
538 // Create disputes between our position and the provided one.
-
539 void
-
540 createDisputes(
-
541 TxSet_t const& o,
-
542 std::unique_ptr<std::stringstream> const& clog = {});
+
478 void
+
479 playbackProposals();
+
480
+
483 bool
+
484 peerProposalInternal(
+
485 NetClock::time_point const& now,
+
486 PeerPosition_t const& newProposal);
+
487
+
494 void
+
495 phaseOpen(std::unique_ptr<std::stringstream> const& clog);
+
496
+
505 void
+
506 phaseEstablish(std::unique_ptr<std::stringstream> const& clog);
+
507
+
530 bool
+
531 shouldPause(std::unique_ptr<std::stringstream> const& clog) const;
+
532
+
533 // Close the open ledger and establish initial position.
+
534 void
+
535 closeLedger(std::unique_ptr<std::stringstream> const& clog);
+
536
+
537 // Adjust our positions to try to agree with other validators.
+
538 void
+
539 updateOurPositions(std::unique_ptr<std::stringstream> const& clog);
+
540
+
541 bool
+
542 haveConsensus(std::unique_ptr<std::stringstream> const& clog);
543
-
544 // Update our disputes given that this node has adopted a new position.
-
545 // Will call createDisputes as needed.
-
546 void
-
547 updateDisputes(NodeID_t const& node, TxSet_t const& other);
-
548
-
549 // Revoke our outstanding proposal, if any, and cease proposing
-
550 // until this round ends.
-
551 void
-
552 leaveConsensus(std::unique_ptr<std::stringstream> const& clog);
-
553
-
554 // The rounded or effective close time estimate from a proposer
-
555 NetClock::time_point
-
556 asCloseTime(NetClock::time_point raw) const;
-
557
-
558private:
-
559 Adaptor& adaptor_;
-
560
-
561 ConsensusPhase phase_{ConsensusPhase::accepted};
-
562 MonitoredMode mode_{ConsensusMode::observing};
-
563 bool firstRound_ = true;
-
564 bool haveCloseTimeConsensus_ = false;
-
565
-
566 clock_type const& clock_;
-
567
-
568 // How long the consensus convergence has taken, expressed as
-
569 // a percentage of the time that we expected it to take.
-
570 int convergePercent_{0};
+
544 // Create disputes between our position and the provided one.
+
545 void
+
546 createDisputes(
+
547 TxSet_t const& o,
+
548 std::unique_ptr<std::stringstream> const& clog = {});
+
549
+
550 // Update our disputes given that this node has adopted a new position.
+
551 // Will call createDisputes as needed.
+
552 void
+
553 updateDisputes(NodeID_t const& node, TxSet_t const& other);
+
554
+
555 // Revoke our outstanding proposal, if any, and cease proposing
+
556 // until this round ends.
+
557 void
+
558 leaveConsensus(std::unique_ptr<std::stringstream> const& clog);
+
559
+
560 // The rounded or effective close time estimate from a proposer
+
561 NetClock::time_point
+
562 asCloseTime(NetClock::time_point raw) const;
+
563
+
564private:
+
565 Adaptor& adaptor_;
+
566
+
567 ConsensusPhase phase_{ConsensusPhase::accepted};
+
568 MonitoredMode mode_{ConsensusMode::observing};
+
569 bool firstRound_ = true;
+
570 bool haveCloseTimeConsensus_ = false;
571
-
572 // How long has this round been open
-
573 ConsensusTimer openTime_;
-
574
-
575 NetClock::duration closeResolution_ = ledgerDefaultTimeResolution;
-
576
-
577 // Time it took for the last consensus round to converge
-
578 std::chrono::milliseconds prevRoundTime_;
-
579
-
580 //-------------------------------------------------------------------------
-
581 // Network time measurements of consensus progress
+
572 clock_type const& clock_;
+
573
+
574 // How long the consensus convergence has taken, expressed as
+
575 // a percentage of the time that we expected it to take.
+
576 int convergePercent_{0};
+
577
+
578 // How long has this round been open
+
579 ConsensusTimer openTime_;
+
580
+
581 NetClock::duration closeResolution_ = ledgerDefaultTimeResolution;
582
-
583 // The current network adjusted time. This is the network time the
-
584 // ledger would close if it closed now
-
585 NetClock::time_point now_;
-
586 NetClock::time_point prevCloseTime_;
-
587
-
588 //-------------------------------------------------------------------------
-
589 // Non-peer (self) consensus data
-
590
-
591 // Last validated ledger ID provided to consensus
-
592 typename Ledger_t::ID prevLedgerID_;
-
593 // Last validated ledger seen by consensus
-
594 Ledger_t previousLedger_;
-
595
-
596 // Transaction Sets, indexed by hash of transaction tree
-
597 hash_map<typename TxSet_t::ID, const TxSet_t> acquired_;
-
598
-
599 std::optional<Result> result_;
-
600 ConsensusCloseTimes rawCloseTimes_;
-
601
-
602 //-------------------------------------------------------------------------
-
603 // Peer related consensus data
+
583 ConsensusParms::AvalancheState closeTimeAvalancheState_ =
+
584 ConsensusParms::init;
+
585
+
586 // Time it took for the last consensus round to converge
+
587 std::chrono::milliseconds prevRoundTime_;
+
588
+
589 //-------------------------------------------------------------------------
+
590 // Network time measurements of consensus progress
+
591
+
592 // The current network adjusted time. This is the network time the
+
593 // ledger would close if it closed now
+
594 NetClock::time_point now_;
+
595 NetClock::time_point prevCloseTime_;
+
596
+
597 //-------------------------------------------------------------------------
+
598 // Non-peer (self) consensus data
+
599
+
600 // Last validated ledger ID provided to consensus
+
601 typename Ledger_t::ID prevLedgerID_;
+
602 // Last validated ledger seen by consensus
+
603 Ledger_t previousLedger_;
604
-
605 // Peer proposed positions for the current round
-
606 hash_map<NodeID_t, PeerPosition_t> currPeerPositions_;
+
605 // Transaction Sets, indexed by hash of transaction tree
+
606 hash_map<typename TxSet_t::ID, const TxSet_t> acquired_;
607
-
608 // Recently received peer positions, available when transitioning between
-
609 // ledgers or rounds
-
610 hash_map<NodeID_t, std::deque<PeerPosition_t>> recentPeerPositions_;
-
611
-
612 // The number of proposers who participated in the last consensus round
-
613 std::size_t prevProposers_ = 0;
+
608 std::optional<Result> result_;
+
609 ConsensusCloseTimes rawCloseTimes_;
+
610
+
611 // The number of calls to phaseEstablish where none of our peers
+
612 // have changed any votes on disputed transactions.
+
613 std::size_t peerUnchangedCounter_ = 0;
614
-
615 // nodes that have bowed out of this consensus process
-
616 hash_set<NodeID_t> deadNodes_;
+
615 // The total number of times we have called phaseEstablish
+
616 std::size_t establishCounter_ = 0;
617
-
618 // Journal for debugging
-
619 beast::Journal const j_;
-
620};
-
621
-
622template <class Adaptor>
-
623Consensus<Adaptor>::Consensus(
-
624 clock_type const& clock,
-
625 Adaptor& adaptor,
-
626 beast::Journal journal)
-
627 : adaptor_(adaptor), clock_(clock), j_{journal}
-
628{
-
629 JLOG(j_.debug()) << "Creating consensus object";
-
630}
-
631
-
632template <class Adaptor>
-
633void
-
634Consensus<Adaptor>::startRound(
-
635 NetClock::time_point const& now,
-
636 typename Ledger_t::ID const& prevLedgerID,
-
637 Ledger_t prevLedger,
-
638 hash_set<NodeID_t> const& nowUntrusted,
-
639 bool proposing,
-
640 std::unique_ptr<std::stringstream> const& clog)
-
641{
-
642 if (firstRound_)
-
643 {
-
644 // take our initial view of closeTime_ from the seed ledger
-
645 prevRoundTime_ = adaptor_.parms().ledgerIDLE_INTERVAL;
-
646 prevCloseTime_ = prevLedger.closeTime();
-
647 firstRound_ = false;
-
648 }
-
649 else
-
650 {
-
651 prevCloseTime_ = rawCloseTimes_.self;
-
652 }
-
653
-
654 for (NodeID_t const& n : nowUntrusted)
-
655 recentPeerPositions_.erase(n);
-
656
-
657 ConsensusMode startMode =
-
658 proposing ? ConsensusMode::proposing : ConsensusMode::observing;
-
659
-
660 // We were handed the wrong ledger
-
661 if (prevLedger.id() != prevLedgerID)
-
662 {
-
663 // try to acquire the correct one
-
664 if (auto newLedger = adaptor_.acquireLedger(prevLedgerID))
-
665 {
-
666 prevLedger = *newLedger;
-
667 }
-
668 else // Unable to acquire the correct ledger
-
669 {
-
670 startMode = ConsensusMode::wrongLedger;
-
671 JLOG(j_.info())
-
672 << "Entering consensus with: " << previousLedger_.id();
-
673 JLOG(j_.info()) << "Correct LCL is: " << prevLedgerID;
-
674 }
-
675 }
-
676
-
677 startRoundInternal(now, prevLedgerID, prevLedger, startMode, clog);
-
678}
-
679template <class Adaptor>
-
680void
-
681Consensus<Adaptor>::startRoundInternal(
-
682 NetClock::time_point const& now,
-
683 typename Ledger_t::ID const& prevLedgerID,
-
684 Ledger_t const& prevLedger,
-
685 ConsensusMode mode,
-
686 std::unique_ptr<std::stringstream> const& clog)
-
687{
-
688 phase_ = ConsensusPhase::open;
-
689 JLOG(j_.debug()) << "transitioned to ConsensusPhase::open ";
-
690 CLOG(clog) << "startRoundInternal transitioned to ConsensusPhase::open, "
-
691 "previous ledgerID: "
-
692 << prevLedgerID << ", seq: " << prevLedger.seq() << ". ";
-
693 mode_.set(mode, adaptor_);
-
694 now_ = now;
-
695 prevLedgerID_ = prevLedgerID;
-
696 previousLedger_ = prevLedger;
-
697 result_.reset();
-
698 convergePercent_ = 0;
-
699 haveCloseTimeConsensus_ = false;
-
700 openTime_.reset(clock_.now());
-
701 currPeerPositions_.clear();
-
702 acquired_.clear();
-
703 rawCloseTimes_.peers.clear();
-
704 rawCloseTimes_.self = {};
-
705 deadNodes_.clear();
-
706
-
707 closeResolution_ = getNextLedgerTimeResolution(
-
708 previousLedger_.closeTimeResolution(),
-
709 previousLedger_.closeAgree(),
-
710 previousLedger_.seq() + typename Ledger_t::Seq{1});
-
711
-
712 playbackProposals();
-
713 CLOG(clog) << "number of peer proposals,previous proposers: "
-
714 << currPeerPositions_.size() << ',' << prevProposers_ << ". ";
-
715 if (currPeerPositions_.size() > (prevProposers_ / 2))
-
716 {
-
717 // We may be falling behind, don't wait for the timer
-
718 // consider closing the ledger immediately
-
719 CLOG(clog) << "consider closing the ledger immediately. ";
-
720 timerEntry(now_, clog);
-
721 }
-
722}
+
618 //-------------------------------------------------------------------------
+
619 // Peer related consensus data
+
620
+
621 // Peer proposed positions for the current round
+
622 hash_map<NodeID_t, PeerPosition_t> currPeerPositions_;
+
623
+
624 // Recently received peer positions, available when transitioning between
+
625 // ledgers or rounds
+
626 hash_map<NodeID_t, std::deque<PeerPosition_t>> recentPeerPositions_;
+
627
+
628 // The number of proposers who participated in the last consensus round
+
629 std::size_t prevProposers_ = 0;
+
630
+
631 // nodes that have bowed out of this consensus process
+
632 hash_set<NodeID_t> deadNodes_;
+
633
+
634 // Journal for debugging
+
635 beast::Journal const j_;
+
636};
+
637
+
638template <class Adaptor>
+
639Consensus<Adaptor>::Consensus(
+
640 clock_type const& clock,
+
641 Adaptor& adaptor,
+
642 beast::Journal journal)
+
643 : adaptor_(adaptor), clock_(clock), j_{journal}
+
644{
+
645 JLOG(j_.debug()) << "Creating consensus object";
+
646}
+
647
+
648template <class Adaptor>
+
649void
+
650Consensus<Adaptor>::startRound(
+
651 NetClock::time_point const& now,
+
652 typename Ledger_t::ID const& prevLedgerID,
+
653 Ledger_t prevLedger,
+
654 hash_set<NodeID_t> const& nowUntrusted,
+
655 bool proposing,
+
656 std::unique_ptr<std::stringstream> const& clog)
+
657{
+
658 if (firstRound_)
+
659 {
+
660 // take our initial view of closeTime_ from the seed ledger
+
661 prevRoundTime_ = adaptor_.parms().ledgerIDLE_INTERVAL;
+
662 prevCloseTime_ = prevLedger.closeTime();
+
663 firstRound_ = false;
+
664 }
+
665 else
+
666 {
+
667 prevCloseTime_ = rawCloseTimes_.self;
+
668 }
+
669
+
670 for (NodeID_t const& n : nowUntrusted)
+
671 recentPeerPositions_.erase(n);
+
672
+
673 ConsensusMode startMode =
+
674 proposing ? ConsensusMode::proposing : ConsensusMode::observing;
+
675
+
676 // We were handed the wrong ledger
+
677 if (prevLedger.id() != prevLedgerID)
+
678 {
+
679 // try to acquire the correct one
+
680 if (auto newLedger = adaptor_.acquireLedger(prevLedgerID))
+
681 {
+
682 prevLedger = *newLedger;
+
683 }
+
684 else // Unable to acquire the correct ledger
+
685 {
+
686 startMode = ConsensusMode::wrongLedger;
+
687 JLOG(j_.info())
+
688 << "Entering consensus with: " << previousLedger_.id();
+
689 JLOG(j_.info()) << "Correct LCL is: " << prevLedgerID;
+
690 }
+
691 }
+
692
+
693 startRoundInternal(now, prevLedgerID, prevLedger, startMode, clog);
+
694}
+
695template <class Adaptor>
+
696void
+
697Consensus<Adaptor>::startRoundInternal(
+
698 NetClock::time_point const& now,
+
699 typename Ledger_t::ID const& prevLedgerID,
+
700 Ledger_t const& prevLedger,
+
701 ConsensusMode mode,
+
702 std::unique_ptr<std::stringstream> const& clog)
+
703{
+
704 phase_ = ConsensusPhase::open;
+
705 JLOG(j_.debug()) << "transitioned to ConsensusPhase::open ";
+
706 CLOG(clog) << "startRoundInternal transitioned to ConsensusPhase::open, "
+
707 "previous ledgerID: "
+
708 << prevLedgerID << ", seq: " << prevLedger.seq() << ". ";
+
709 mode_.set(mode, adaptor_);
+
710 now_ = now;
+
711 prevLedgerID_ = prevLedgerID;
+
712 previousLedger_ = prevLedger;
+
713 result_.reset();
+
714 convergePercent_ = 0;
+
715 closeTimeAvalancheState_ = ConsensusParms::init;
+
716 haveCloseTimeConsensus_ = false;
+
717 openTime_.reset(clock_.now());
+
718 currPeerPositions_.clear();
+
719 acquired_.clear();
+
720 rawCloseTimes_.peers.clear();
+
721 rawCloseTimes_.self = {};
+
722 deadNodes_.clear();
723
-
724template <class Adaptor>
-
725bool
-
726Consensus<Adaptor>::peerProposal(
-
727 NetClock::time_point const& now,
-
728 PeerPosition_t const& newPeerPos)
-
729{
-
730 JLOG(j_.debug()) << "PROPOSAL " << newPeerPos.render();
-
731 auto const& peerID = newPeerPos.proposal().nodeID();
-
732
-
733 // Always need to store recent positions
-
734 {
-
735 auto& props = recentPeerPositions_[peerID];
-
736
-
737 if (props.size() >= 10)
-
738 props.pop_front();
-
739
-
740 props.push_back(newPeerPos);
-
741 }
-
742 return peerProposalInternal(now, newPeerPos);
-
743}
-
744
-
745template <class Adaptor>
-
746bool
-
747Consensus<Adaptor>::peerProposalInternal(
-
748 NetClock::time_point const& now,
-
749 PeerPosition_t const& newPeerPos)
-
750{
-
751 // Nothing to do for now if we are currently working on a ledger
-
752 if (phase_ == ConsensusPhase::accepted)
-
753 return false;
-
754
-
755 now_ = now;
+
724 closeResolution_ = getNextLedgerTimeResolution(
+
725 previousLedger_.closeTimeResolution(),
+
726 previousLedger_.closeAgree(),
+
727 previousLedger_.seq() + typename Ledger_t::Seq{1});
+
728
+
729 playbackProposals();
+
730 CLOG(clog) << "number of peer proposals,previous proposers: "
+
731 << currPeerPositions_.size() << ',' << prevProposers_ << ". ";
+
732 if (currPeerPositions_.size() > (prevProposers_ / 2))
+
733 {
+
734 // We may be falling behind, don't wait for the timer
+
735 // consider closing the ledger immediately
+
736 CLOG(clog) << "consider closing the ledger immediately. ";
+
737 timerEntry(now_, clog);
+
738 }
+
739}
+
740
+
741template <class Adaptor>
+
742bool
+
743Consensus<Adaptor>::peerProposal(
+
744 NetClock::time_point const& now,
+
745 PeerPosition_t const& newPeerPos)
+
746{
+
747 JLOG(j_.debug()) << "PROPOSAL " << newPeerPos.render();
+
748 auto const& peerID = newPeerPos.proposal().nodeID();
+
749
+
750 // Always need to store recent positions
+
751 {
+
752 auto& props = recentPeerPositions_[peerID];
+
753
+
754 if (props.size() >= 10)
+
755 props.pop_front();
756
-
757 auto const& newPeerProp = newPeerPos.proposal();
-
758
-
759 if (newPeerProp.prevLedger() != prevLedgerID_)
-
760 {
-
761 JLOG(j_.debug()) << "Got proposal for " << newPeerProp.prevLedger()
-
762 << " but we are on " << prevLedgerID_;
-
763 return false;
-
764 }
-
765
-
766 auto const& peerID = newPeerProp.nodeID();
-
767
-
768 if (deadNodes_.find(peerID) != deadNodes_.end())
-
769 {
-
770 JLOG(j_.info()) << "Position from dead node: " << peerID;
-
771 return false;
-
772 }
+
757 props.push_back(newPeerPos);
+
758 }
+
759 return peerProposalInternal(now, newPeerPos);
+
760}
+
761
+
762template <class Adaptor>
+
763bool
+
764Consensus<Adaptor>::peerProposalInternal(
+
765 NetClock::time_point const& now,
+
766 PeerPosition_t const& newPeerPos)
+
767{
+
768 // Nothing to do for now if we are currently working on a ledger
+
769 if (phase_ == ConsensusPhase::accepted)
+
770 return false;
+
771
+
772 now_ = now;
773
-
774 {
-
775 // update current position
-
776 auto peerPosIt = currPeerPositions_.find(peerID);
-
777
-
778 if (peerPosIt != currPeerPositions_.end())
-
779 {
-
780 if (newPeerProp.proposeSeq() <=
-
781 peerPosIt->second.proposal().proposeSeq())
-
782 {
-
783 return false;
-
784 }
-
785 }
-
786
-
787 if (newPeerProp.isBowOut())
-
788 {
-
789 JLOG(j_.info()) << "Peer " << peerID << " bows out";
-
790 if (result_)
-
791 {
-
792 for (auto& it : result_->disputes)
-
793 it.second.unVote(peerID);
-
794 }
-
795 if (peerPosIt != currPeerPositions_.end())
-
796 currPeerPositions_.erase(peerID);
-
797 deadNodes_.insert(peerID);
-
798
-
799 return true;
-
800 }
-
801
-
802 if (peerPosIt != currPeerPositions_.end())
-
803 peerPosIt->second = newPeerPos;
-
804 else
-
805 currPeerPositions_.emplace(peerID, newPeerPos);
-
806 }
-
807
-
808 if (newPeerProp.isInitial())
-
809 {
-
810 // Record the close time estimate
-
811 JLOG(j_.trace()) << "Peer reports close time as "
-
812 << newPeerProp.closeTime().time_since_epoch().count();
-
813 ++rawCloseTimes_.peers[newPeerProp.closeTime()];
-
814 }
+
774 auto const& newPeerProp = newPeerPos.proposal();
+
775
+
776 if (newPeerProp.prevLedger() != prevLedgerID_)
+
777 {
+
778 JLOG(j_.debug()) << "Got proposal for " << newPeerProp.prevLedger()
+
779 << " but we are on " << prevLedgerID_;
+
780 return false;
+
781 }
+
782
+
783 auto const& peerID = newPeerProp.nodeID();
+
784
+
785 if (deadNodes_.find(peerID) != deadNodes_.end())
+
786 {
+
787 JLOG(j_.info()) << "Position from dead node: " << peerID;
+
788 return false;
+
789 }
+
790
+
791 {
+
792 // update current position
+
793 auto peerPosIt = currPeerPositions_.find(peerID);
+
794
+
795 if (peerPosIt != currPeerPositions_.end())
+
796 {
+
797 if (newPeerProp.proposeSeq() <=
+
798 peerPosIt->second.proposal().proposeSeq())
+
799 {
+
800 return false;
+
801 }
+
802 }
+
803
+
804 if (newPeerProp.isBowOut())
+
805 {
+
806 JLOG(j_.info()) << "Peer " << peerID << " bows out";
+
807 if (result_)
+
808 {
+
809 for (auto& it : result_->disputes)
+
810 it.second.unVote(peerID);
+
811 }
+
812 if (peerPosIt != currPeerPositions_.end())
+
813 currPeerPositions_.erase(peerID);
+
814 deadNodes_.insert(peerID);
815
-
816 JLOG(j_.trace()) << "Processing peer proposal " << newPeerProp.proposeSeq()
-
817 << "/" << newPeerProp.position();
+
816 return true;
+
817 }
818
-
819 {
-
820 auto const ait = acquired_.find(newPeerProp.position());
-
821 if (ait == acquired_.end())
-
822 {
-
823 // acquireTxSet will return the set if it is available, or
-
824 // spawn a request for it and return nullopt/nullptr. It will call
-
825 // gotTxSet once it arrives
-
826 if (auto set = adaptor_.acquireTxSet(newPeerProp.position()))
-
827 gotTxSet(now_, *set);
-
828 else
-
829 JLOG(j_.debug()) << "Don't have tx set for peer";
-
830 }
-
831 else if (result_)
-
832 {
-
833 updateDisputes(newPeerProp.nodeID(), ait->second);
-
834 }
-
835 }
-
836
-
837 return true;
-
838}
-
839
-
840template <class Adaptor>
-
841void
-
842Consensus<Adaptor>::timerEntry(
-
843 NetClock::time_point const& now,
-
844 std::unique_ptr<std::stringstream> const& clog)
-
845{
-
846 CLOG(clog) << "Consensus<Adaptor>::timerEntry. ";
-
847 // Nothing to do if we are currently working on a ledger
-
848 if (phase_ == ConsensusPhase::accepted)
-
849 {
-
850 CLOG(clog) << "Nothing to do during accepted phase. ";
-
851 return;
+
819 if (peerPosIt != currPeerPositions_.end())
+
820 peerPosIt->second = newPeerPos;
+
821 else
+
822 currPeerPositions_.emplace(peerID, newPeerPos);
+
823 }
+
824
+
825 if (newPeerProp.isInitial())
+
826 {
+
827 // Record the close time estimate
+
828 JLOG(j_.trace()) << "Peer reports close time as "
+
829 << newPeerProp.closeTime().time_since_epoch().count();
+
830 ++rawCloseTimes_.peers[newPeerProp.closeTime()];
+
831 }
+
832
+
833 JLOG(j_.trace()) << "Processing peer proposal " << newPeerProp.proposeSeq()
+
834 << "/" << newPeerProp.position();
+
835
+
836 {
+
837 auto const ait = acquired_.find(newPeerProp.position());
+
838 if (ait == acquired_.end())
+
839 {
+
840 // acquireTxSet will return the set if it is available, or
+
841 // spawn a request for it and return nullopt/nullptr. It will call
+
842 // gotTxSet once it arrives
+
843 if (auto set = adaptor_.acquireTxSet(newPeerProp.position()))
+
844 gotTxSet(now_, *set);
+
845 else
+
846 JLOG(j_.debug()) << "Don't have tx set for peer";
+
847 }
+
848 else if (result_)
+
849 {
+
850 updateDisputes(newPeerProp.nodeID(), ait->second);
+
851 }
852 }
853
-
854 now_ = now;
-
855 CLOG(clog) << "Set network adjusted time to " << to_string(now) << ". ";
+
854 return true;
+
855}
856
-
857 // Check we are on the proper ledger (this may change phase_)
-
858 const auto phaseOrig = phase_;
-
859 CLOG(clog) << "Phase " << to_string(phaseOrig) << ". ";
-
860 checkLedger(clog);
-
861 if (phaseOrig != phase_)
-
862 {
-
863 CLOG(clog) << "Changed phase to << " << to_string(phase_) << ". ";
-
864 }
-
865
-
866 if (phase_ == ConsensusPhase::open)
-
867 phaseOpen(clog);
-
868 else if (phase_ == ConsensusPhase::establish)
-
869 phaseEstablish(clog);
-
870 CLOG(clog) << "timerEntry finishing in phase " << to_string(phase_) << ". ";
-
871}
-
872
-
873template <class Adaptor>
-
874void
-
875Consensus<Adaptor>::gotTxSet(
-
876 NetClock::time_point const& now,
-
877 TxSet_t const& txSet)
-
878{
-
879 // Nothing to do if we've finished work on a ledger
-
880 if (phase_ == ConsensusPhase::accepted)
-
881 return;
+
857template <class Adaptor>
+
858void
+
859Consensus<Adaptor>::timerEntry(
+
860 NetClock::time_point const& now,
+
861 std::unique_ptr<std::stringstream> const& clog)
+
862{
+
863 CLOG(clog) << "Consensus<Adaptor>::timerEntry. ";
+
864 // Nothing to do if we are currently working on a ledger
+
865 if (phase_ == ConsensusPhase::accepted)
+
866 {
+
867 CLOG(clog) << "Nothing to do during accepted phase. ";
+
868 return;
+
869 }
+
870
+
871 now_ = now;
+
872 CLOG(clog) << "Set network adjusted time to " << to_string(now) << ". ";
+
873
+
874 // Check we are on the proper ledger (this may change phase_)
+
875 const auto phaseOrig = phase_;
+
876 CLOG(clog) << "Phase " << to_string(phaseOrig) << ". ";
+
877 checkLedger(clog);
+
878 if (phaseOrig != phase_)
+
879 {
+
880 CLOG(clog) << "Changed phase to << " << to_string(phase_) << ". ";
+
881 }
882
-
883 now_ = now;
-
884
-
885 auto id = txSet.id();
-
886
-
887 // If we've already processed this transaction set since requesting
-
888 // it from the network, there is nothing to do now
-
889 if (!acquired_.emplace(id, txSet).second)
-
890 return;
-
891
-
892 if (!result_)
-
893 {
-
894 JLOG(j_.debug()) << "Not creating disputes: no position yet.";
-
895 }
-
896 else
-
897 {
-
898 // Our position is added to acquired_ as soon as we create it,
-
899 // so this txSet must differ
-
900 XRPL_ASSERT(
-
901 id != result_->position.position(),
-
902 "ripple::Consensus::gotTxSet : updated transaction set");
-
903 bool any = false;
-
904 for (auto const& [nodeId, peerPos] : currPeerPositions_)
-
905 {
-
906 if (peerPos.proposal().position() == id)
-
907 {
-
908 updateDisputes(nodeId, txSet);
-
909 any = true;
-
910 }
-
911 }
-
912
-
913 if (!any)
-
914 {
-
915 JLOG(j_.warn())
-
916 << "By the time we got " << id << " no peers were proposing it";
-
917 }
-
918 }
-
919}
-
920
-
921template <class Adaptor>
-
922void
-
923Consensus<Adaptor>::simulate(
-
924 NetClock::time_point const& now,
-
925 std::optional<std::chrono::milliseconds> consensusDelay)
-
926{
-
927 using namespace std::chrono_literals;
-
928 JLOG(j_.info()) << "Simulating consensus";
-
929 now_ = now;
-
930 closeLedger({});
-
931 result_->roundTime.tick(consensusDelay.value_or(100ms));
-
932 result_->proposers = prevProposers_ = currPeerPositions_.size();
-
933 prevRoundTime_ = result_->roundTime.read();
-
934 phase_ = ConsensusPhase::accepted;
-
935 adaptor_.onForceAccept(
-
936 *result_,
-
937 previousLedger_,
-
938 closeResolution_,
-
939 rawCloseTimes_,
-
940 mode_.get(),
-
941 getJson(true));
-
942 JLOG(j_.info()) << "Simulation complete";
-
943}
-
944
-
945template <class Adaptor>
-
946Json::Value
-
947Consensus<Adaptor>::getJson(bool full) const
-
948{
-
949 using std::to_string;
-
950 using Int = Json::Value::Int;
-
951
-
952 Json::Value ret(Json::objectValue);
-
953
-
954 ret["proposing"] = (mode_.get() == ConsensusMode::proposing);
-
955 ret["proposers"] = static_cast<int>(currPeerPositions_.size());
-
956
-
957 if (mode_.get() != ConsensusMode::wrongLedger)
-
958 {
-
959 ret["synched"] = true;
-
960 ret["ledger_seq"] =
-
961 static_cast<std::uint32_t>(previousLedger_.seq()) + 1;
-
962 ret["close_granularity"] = static_cast<Int>(closeResolution_.count());
-
963 }
-
964 else
-
965 ret["synched"] = false;
-
966
-
967 ret["phase"] = to_string(phase_);
+
883 if (phase_ == ConsensusPhase::open)
+
884 phaseOpen(clog);
+
885 else if (phase_ == ConsensusPhase::establish)
+
886 phaseEstablish(clog);
+
887 CLOG(clog) << "timerEntry finishing in phase " << to_string(phase_) << ". ";
+
888}
+
889
+
890template <class Adaptor>
+
891void
+
892Consensus<Adaptor>::gotTxSet(
+
893 NetClock::time_point const& now,
+
894 TxSet_t const& txSet)
+
895{
+
896 // Nothing to do if we've finished work on a ledger
+
897 if (phase_ == ConsensusPhase::accepted)
+
898 return;
+
899
+
900 now_ = now;
+
901
+
902 auto id = txSet.id();
+
903
+
904 // If we've already processed this transaction set since requesting
+
905 // it from the network, there is nothing to do now
+
906 if (!acquired_.emplace(id, txSet).second)
+
907 return;
+
908
+
909 if (!result_)
+
910 {
+
911 JLOG(j_.debug()) << "Not creating disputes: no position yet.";
+
912 }
+
913 else
+
914 {
+
915 // Our position is added to acquired_ as soon as we create it,
+
916 // so this txSet must differ
+
917 XRPL_ASSERT(
+
918 id != result_->position.position(),
+
919 "ripple::Consensus::gotTxSet : updated transaction set");
+
920 bool any = false;
+
921 for (auto const& [nodeId, peerPos] : currPeerPositions_)
+
922 {
+
923 if (peerPos.proposal().position() == id)
+
924 {
+
925 updateDisputes(nodeId, txSet);
+
926 any = true;
+
927 }
+
928 }
+
929
+
930 if (!any)
+
931 {
+
932 JLOG(j_.warn())
+
933 << "By the time we got " << id << " no peers were proposing it";
+
934 }
+
935 }
+
936}
+
937
+
938template <class Adaptor>
+
939void
+
940Consensus<Adaptor>::simulate(
+
941 NetClock::time_point const& now,
+
942 std::optional<std::chrono::milliseconds> consensusDelay)
+
943{
+
944 using namespace std::chrono_literals;
+
945 JLOG(j_.info()) << "Simulating consensus";
+
946 now_ = now;
+
947 closeLedger({});
+
948 result_->roundTime.tick(consensusDelay.value_or(100ms));
+
949 result_->proposers = prevProposers_ = currPeerPositions_.size();
+
950 prevRoundTime_ = result_->roundTime.read();
+
951 phase_ = ConsensusPhase::accepted;
+
952 adaptor_.onForceAccept(
+
953 *result_,
+
954 previousLedger_,
+
955 closeResolution_,
+
956 rawCloseTimes_,
+
957 mode_.get(),
+
958 getJson(true));
+
959 JLOG(j_.info()) << "Simulation complete";
+
960}
+
961
+
962template <class Adaptor>
+
963Json::Value
+
964Consensus<Adaptor>::getJson(bool full) const
+
965{
+
966 using std::to_string;
+
967 using Int = Json::Value::Int;
968
-
969 if (result_ && !result_->disputes.empty() && !full)
-
970 ret["disputes"] = static_cast<Int>(result_->disputes.size());
-
971
-
972 if (result_)
-
973 ret["our_position"] = result_->position.getJson();
-
974
-
975 if (full)
-
976 {
-
977 if (result_)
-
978 ret["current_ms"] =
-
979 static_cast<Int>(result_->roundTime.read().count());
-
980 ret["converge_percent"] = convergePercent_;
-
981 ret["close_resolution"] = static_cast<Int>(closeResolution_.count());
-
982 ret["have_time_consensus"] = haveCloseTimeConsensus_;
-
983 ret["previous_proposers"] = static_cast<Int>(prevProposers_);
-
984 ret["previous_mseconds"] = static_cast<Int>(prevRoundTime_.count());
+
969 Json::Value ret(Json::objectValue);
+
970
+
971 ret["proposing"] = (mode_.get() == ConsensusMode::proposing);
+
972 ret["proposers"] = static_cast<int>(currPeerPositions_.size());
+
973
+
974 if (mode_.get() != ConsensusMode::wrongLedger)
+
975 {
+
976 ret["synched"] = true;
+
977 ret["ledger_seq"] =
+
978 static_cast<std::uint32_t>(previousLedger_.seq()) + 1;
+
979 ret["close_granularity"] = static_cast<Int>(closeResolution_.count());
+
980 }
+
981 else
+
982 ret["synched"] = false;
+
983
+
984 ret["phase"] = to_string(phase_);
985
-
986 if (!currPeerPositions_.empty())
-
987 {
-
988 Json::Value ppj(Json::objectValue);
-
989
-
990 for (auto const& [nodeId, peerPos] : currPeerPositions_)
-
991 {
-
992 ppj[to_string(nodeId)] = peerPos.getJson();
-
993 }
-
994 ret["peer_positions"] = std::move(ppj);
-
995 }
-
996
-
997 if (!acquired_.empty())
-
998 {
-
999 Json::Value acq(Json::arrayValue);
-
1000 for (auto const& at : acquired_)
-
1001 {
-
1002 acq.append(to_string(at.first));
-
1003 }
-
1004 ret["acquired"] = std::move(acq);
-
1005 }
+
986 if (result_ && !result_->disputes.empty() && !full)
+
987 ret["disputes"] = static_cast<Int>(result_->disputes.size());
+
988
+
989 if (result_)
+
990 ret["our_position"] = result_->position.getJson();
+
991
+
992 if (full)
+
993 {
+
994 if (result_)
+
995 ret["current_ms"] =
+
996 static_cast<Int>(result_->roundTime.read().count());
+
997 ret["converge_percent"] = convergePercent_;
+
998 ret["close_resolution"] = static_cast<Int>(closeResolution_.count());
+
999 ret["have_time_consensus"] = haveCloseTimeConsensus_;
+
1000 ret["previous_proposers"] = static_cast<Int>(prevProposers_);
+
1001 ret["previous_mseconds"] = static_cast<Int>(prevRoundTime_.count());
+
1002
+
1003 if (!currPeerPositions_.empty())
+
1004 {
+
1005 Json::Value ppj(Json::objectValue);
1006
-
1007 if (result_ && !result_->disputes.empty())
-
1008 {
-
1009 Json::Value dsj(Json::objectValue);
-
1010 for (auto const& [txId, dispute] : result_->disputes)
-
1011 {
-
1012 dsj[to_string(txId)] = dispute.getJson();
-
1013 }
-
1014 ret["disputes"] = std::move(dsj);
-
1015 }
-
1016
-
1017 if (!rawCloseTimes_.peers.empty())
-
1018 {
-
1019 Json::Value ctj(Json::objectValue);
-
1020 for (auto const& ct : rawCloseTimes_.peers)
-
1021 {
-
1022 ctj[std::to_string(ct.first.time_since_epoch().count())] =
-
1023 ct.second;
-
1024 }
-
1025 ret["close_times"] = std::move(ctj);
-
1026 }
-
1027
-
1028 if (!deadNodes_.empty())
-
1029 {
-
1030 Json::Value dnj(Json::arrayValue);
-
1031 for (auto const& dn : deadNodes_)
-
1032 {
-
1033 dnj.append(to_string(dn));
-
1034 }
-
1035 ret["dead_nodes"] = std::move(dnj);
-
1036 }
-
1037 }
-
1038
-
1039 return ret;
-
1040}
-
1041
-
1042// Handle a change in the prior ledger during a consensus round
-
1043template <class Adaptor>
-
1044void
-
1045Consensus<Adaptor>::handleWrongLedger(
-
1046 typename Ledger_t::ID const& lgrId,
-
1047 std::unique_ptr<std::stringstream> const& clog)
-
1048{
-
1049 CLOG(clog) << "handleWrongLedger. ";
-
1050 XRPL_ASSERT(
-
1051 lgrId != prevLedgerID_ || previousLedger_.id() != lgrId,
-
1052 "ripple::Consensus::handleWrongLedger : have wrong ledger");
-
1053
-
1054 // Stop proposing because we are out of sync
-
1055 leaveConsensus(clog);
-
1056
-
1057 // First time switching to this ledger
-
1058 if (prevLedgerID_ != lgrId)
-
1059 {
-
1060 prevLedgerID_ = lgrId;
-
1061
-
1062 // Clear out state
-
1063 if (result_)
-
1064 {
-
1065 result_->disputes.clear();
-
1066 result_->compares.clear();
-
1067 }
-
1068
-
1069 currPeerPositions_.clear();
-
1070 rawCloseTimes_.peers.clear();
-
1071 deadNodes_.clear();
-
1072
-
1073 // Get back in sync, this will also recreate disputes
-
1074 playbackProposals();
-
1075 }
-
1076
-
1077 if (previousLedger_.id() == prevLedgerID_)
-
1078 {
-
1079 CLOG(clog) << "previousLedger_.id() == prevLeverID_ " << prevLedgerID_
-
1080 << ". ";
-
1081 return;
-
1082 }
-
1083
-
1084 // we need to switch the ledger we're working from
-
1085 if (auto newLedger = adaptor_.acquireLedger(prevLedgerID_))
-
1086 {
-
1087 JLOG(j_.info()) << "Have the consensus ledger " << prevLedgerID_;
-
1088 CLOG(clog) << "Have the consensus ledger " << prevLedgerID_ << ". ";
-
1089 startRoundInternal(
-
1090 now_, lgrId, *newLedger, ConsensusMode::switchedLedger, clog);
-
1091 }
-
1092 else
-
1093 {
-
1094 CLOG(clog) << "Still on wrong ledger. ";
-
1095 mode_.set(ConsensusMode::wrongLedger, adaptor_);
-
1096 }
-
1097}
-
1098
-
1099template <class Adaptor>
-
1100void
-
1101Consensus<Adaptor>::checkLedger(std::unique_ptr<std::stringstream> const& clog)
-
1102{
-
1103 CLOG(clog) << "checkLedger. ";
-
1104
-
1105 auto netLgr =
-
1106 adaptor_.getPrevLedger(prevLedgerID_, previousLedger_, mode_.get());
-
1107 CLOG(clog) << "network ledgerid " << netLgr << ", " << "previous ledger "
-
1108 << prevLedgerID_ << ". ";
-
1109
-
1110 if (netLgr != prevLedgerID_)
-
1111 {
-
1112 std::stringstream ss;
-
1113 ss << "View of consensus changed during " << to_string(phase_)
-
1114 << " mode=" << to_string(mode_.get()) << ", " << prevLedgerID_
-
1115 << " to " << netLgr << ", "
-
1116 << Json::Compact{previousLedger_.getJson()} << ". ";
-
1117 JLOG(j_.warn()) << ss.str();
-
1118 CLOG(clog) << ss.str();
-
1119 CLOG(clog) << "State on consensus change "
-
1120 << Json::Compact{getJson(true)} << ". ";
-
1121 handleWrongLedger(netLgr, clog);
-
1122 }
-
1123 else if (previousLedger_.id() != prevLedgerID_)
-
1124 {
-
1125 CLOG(clog) << "previousLedger_.id() != prevLedgerID_: "
-
1126 << previousLedger_.id() << ',' << to_string(prevLedgerID_)
-
1127 << ". ";
-
1128 handleWrongLedger(netLgr, clog);
-
1129 }
-
1130}
-
1131
-
1132template <class Adaptor>
-
1133void
-
1134Consensus<Adaptor>::playbackProposals()
-
1135{
-
1136 for (auto const& it : recentPeerPositions_)
-
1137 {
-
1138 for (auto const& pos : it.second)
-
1139 {
-
1140 if (pos.proposal().prevLedger() == prevLedgerID_)
-
1141 {
-
1142 if (peerProposalInternal(now_, pos))
-
1143 adaptor_.share(pos);
-
1144 }
-
1145 }
+
1007 for (auto const& [nodeId, peerPos] : currPeerPositions_)
+
1008 {
+
1009 ppj[to_string(nodeId)] = peerPos.getJson();
+
1010 }
+
1011 ret["peer_positions"] = std::move(ppj);
+
1012 }
+
1013
+
1014 if (!acquired_.empty())
+
1015 {
+
1016 Json::Value acq(Json::arrayValue);
+
1017 for (auto const& at : acquired_)
+
1018 {
+
1019 acq.append(to_string(at.first));
+
1020 }
+
1021 ret["acquired"] = std::move(acq);
+
1022 }
+
1023
+
1024 if (result_ && !result_->disputes.empty())
+
1025 {
+
1026 Json::Value dsj(Json::objectValue);
+
1027 for (auto const& [txId, dispute] : result_->disputes)
+
1028 {
+
1029 dsj[to_string(txId)] = dispute.getJson();
+
1030 }
+
1031 ret["disputes"] = std::move(dsj);
+
1032 }
+
1033
+
1034 if (!rawCloseTimes_.peers.empty())
+
1035 {
+
1036 Json::Value ctj(Json::objectValue);
+
1037 for (auto const& ct : rawCloseTimes_.peers)
+
1038 {
+
1039 ctj[std::to_string(ct.first.time_since_epoch().count())] =
+
1040 ct.second;
+
1041 }
+
1042 ret["close_times"] = std::move(ctj);
+
1043 }
+
1044
+
1045 if (!deadNodes_.empty())
+
1046 {
+
1047 Json::Value dnj(Json::arrayValue);
+
1048 for (auto const& dn : deadNodes_)
+
1049 {
+
1050 dnj.append(to_string(dn));
+
1051 }
+
1052 ret["dead_nodes"] = std::move(dnj);
+
1053 }
+
1054 }
+
1055
+
1056 return ret;
+
1057}
+
1058
+
1059// Handle a change in the prior ledger during a consensus round
+
1060template <class Adaptor>
+
1061void
+
1062Consensus<Adaptor>::handleWrongLedger(
+
1063 typename Ledger_t::ID const& lgrId,
+
1064 std::unique_ptr<std::stringstream> const& clog)
+
1065{
+
1066 CLOG(clog) << "handleWrongLedger. ";
+
1067 XRPL_ASSERT(
+
1068 lgrId != prevLedgerID_ || previousLedger_.id() != lgrId,
+
1069 "ripple::Consensus::handleWrongLedger : have wrong ledger");
+
1070
+
1071 // Stop proposing because we are out of sync
+
1072 leaveConsensus(clog);
+
1073
+
1074 // First time switching to this ledger
+
1075 if (prevLedgerID_ != lgrId)
+
1076 {
+
1077 prevLedgerID_ = lgrId;
+
1078
+
1079 // Clear out state
+
1080 if (result_)
+
1081 {
+
1082 result_->disputes.clear();
+
1083 result_->compares.clear();
+
1084 }
+
1085
+
1086 currPeerPositions_.clear();
+
1087 rawCloseTimes_.peers.clear();
+
1088 deadNodes_.clear();
+
1089
+
1090 // Get back in sync, this will also recreate disputes
+
1091 playbackProposals();
+
1092 }
+
1093
+
1094 if (previousLedger_.id() == prevLedgerID_)
+
1095 {
+
1096 CLOG(clog) << "previousLedger_.id() == prevLeverID_ " << prevLedgerID_
+
1097 << ". ";
+
1098 return;
+
1099 }
+
1100
+
1101 // we need to switch the ledger we're working from
+
1102 if (auto newLedger = adaptor_.acquireLedger(prevLedgerID_))
+
1103 {
+
1104 JLOG(j_.info()) << "Have the consensus ledger " << prevLedgerID_;
+
1105 CLOG(clog) << "Have the consensus ledger " << prevLedgerID_ << ". ";
+
1106 startRoundInternal(
+
1107 now_, lgrId, *newLedger, ConsensusMode::switchedLedger, clog);
+
1108 }
+
1109 else
+
1110 {
+
1111 CLOG(clog) << "Still on wrong ledger. ";
+
1112 mode_.set(ConsensusMode::wrongLedger, adaptor_);
+
1113 }
+
1114}
+
1115
+
1116template <class Adaptor>
+
1117void
+
1118Consensus<Adaptor>::checkLedger(std::unique_ptr<std::stringstream> const& clog)
+
1119{
+
1120 CLOG(clog) << "checkLedger. ";
+
1121
+
1122 auto netLgr =
+
1123 adaptor_.getPrevLedger(prevLedgerID_, previousLedger_, mode_.get());
+
1124 CLOG(clog) << "network ledgerid " << netLgr << ", " << "previous ledger "
+
1125 << prevLedgerID_ << ". ";
+
1126
+
1127 if (netLgr != prevLedgerID_)
+
1128 {
+
1129 std::stringstream ss;
+
1130 ss << "View of consensus changed during " << to_string(phase_)
+
1131 << " mode=" << to_string(mode_.get()) << ", " << prevLedgerID_
+
1132 << " to " << netLgr << ", "
+
1133 << Json::Compact{previousLedger_.getJson()} << ". ";
+
1134 JLOG(j_.warn()) << ss.str();
+
1135 CLOG(clog) << ss.str();
+
1136 CLOG(clog) << "State on consensus change "
+
1137 << Json::Compact{getJson(true)} << ". ";
+
1138 handleWrongLedger(netLgr, clog);
+
1139 }
+
1140 else if (previousLedger_.id() != prevLedgerID_)
+
1141 {
+
1142 CLOG(clog) << "previousLedger_.id() != prevLedgerID_: "
+
1143 << previousLedger_.id() << ',' << to_string(prevLedgerID_)
+
1144 << ". ";
+
1145 handleWrongLedger(netLgr, clog);
1146 }
1147}
1148
1149template <class Adaptor>
1150void
-
1151Consensus<Adaptor>::phaseOpen(std::unique_ptr<std::stringstream> const& clog)
+
1151Consensus<Adaptor>::playbackProposals()
1152{
-
1153 CLOG(clog) << "phaseOpen. ";
-
1154 using namespace std::chrono;
-
1155
-
1156 // it is shortly before ledger close time
-
1157 bool anyTransactions = adaptor_.hasOpenTransactions();
-
1158 auto proposersClosed = currPeerPositions_.size();
-
1159 auto proposersValidated = adaptor_.proposersValidated(prevLedgerID_);
-
1160
-
1161 openTime_.tick(clock_.now());
-
1162
-
1163 // This computes how long since last ledger's close time
-
1164 milliseconds sinceClose;
-
1165 {
-
1166 auto const mode = mode_.get();
-
1167 bool const closeAgree = previousLedger_.closeAgree();
-
1168 auto const prevCloseTime = previousLedger_.closeTime();
-
1169 auto const prevParentCloseTimePlus1 =
-
1170 previousLedger_.parentCloseTime() + 1s;
-
1171 bool const previousCloseCorrect =
-
1172 (mode != ConsensusMode::wrongLedger) && closeAgree &&
-
1173 (prevCloseTime != prevParentCloseTimePlus1);
-
1174
-
1175 auto const lastCloseTime = previousCloseCorrect
-
1176 ? prevCloseTime // use consensus timing
-
1177 : prevCloseTime_; // use the time we saw internally
-
1178
-
1179 if (now_ >= lastCloseTime)
-
1180 sinceClose = duration_cast<milliseconds>(now_ - lastCloseTime);
-
1181 else
-
1182 sinceClose = -duration_cast<milliseconds>(lastCloseTime - now_);
-
1183 CLOG(clog) << "calculating how long since last ledger's close time "
-
1184 "based on mode : "
-
1185 << to_string(mode) << ", previous closeAgree: " << closeAgree
-
1186 << ", previous close time: " << to_string(prevCloseTime)
-
1187 << ", previous parent close time + 1s: "
-
1188 << to_string(prevParentCloseTimePlus1)
-
1189 << ", previous close time seen internally: "
-
1190 << to_string(prevCloseTime_)
-
1191 << ", last close time: " << to_string(lastCloseTime)
-
1192 << ", since close: " << sinceClose.count() << ". ";
-
1193 }
-
1194
-
1195 auto const idleInterval = std::max<milliseconds>(
-
1196 adaptor_.parms().ledgerIDLE_INTERVAL,
-
1197 2 * previousLedger_.closeTimeResolution());
-
1198 CLOG(clog) << "idle interval set to " << idleInterval.count()
-
1199 << "ms based on " << "ledgerIDLE_INTERVAL: "
-
1200 << adaptor_.parms().ledgerIDLE_INTERVAL.count()
-
1201 << ", previous ledger close time resolution: "
-
1202 << previousLedger_.closeTimeResolution().count() << "ms. ";
-
1203
-
1204 // Decide if we should close the ledger
-
1205 if (shouldCloseLedger(
-
1206 anyTransactions,
-
1207 prevProposers_,
-
1208 proposersClosed,
-
1209 proposersValidated,
-
1210 prevRoundTime_,
-
1211 sinceClose,
-
1212 openTime_.read(),
-
1213 idleInterval,
-
1214 adaptor_.parms(),
-
1215 j_,
-
1216 clog))
-
1217 {
-
1218 CLOG(clog) << "closing ledger. ";
-
1219 closeLedger(clog);
-
1220 }
-
1221}
-
1222
-
1223template <class Adaptor>
-
1224bool
-
1225Consensus<Adaptor>::shouldPause(
-
1226 std::unique_ptr<std::stringstream> const& clog) const
-
1227{
-
1228 CLOG(clog) << "shouldPause? ";
-
1229 auto const& parms = adaptor_.parms();
-
1230 std::uint32_t const ahead(
-
1231 previousLedger_.seq() -
-
1232 std::min(adaptor_.getValidLedgerIndex(), previousLedger_.seq()));
-
1233 auto [quorum, trustedKeys] = adaptor_.getQuorumKeys();
-
1234 std::size_t const totalValidators = trustedKeys.size();
-
1235 std::size_t laggards =
-
1236 adaptor_.laggards(previousLedger_.seq(), trustedKeys);
-
1237 std::size_t const offline = trustedKeys.size();
-
1238
-
1239 std::stringstream vars;
-
1240 vars << " consensuslog (working seq: " << previousLedger_.seq() << ", "
-
1241 << "validated seq: " << adaptor_.getValidLedgerIndex() << ", "
-
1242 << "am validator: " << adaptor_.validator() << ", "
-
1243 << "have validated: " << adaptor_.haveValidated() << ", "
-
1244 << "roundTime: " << result_->roundTime.read().count() << ", "
-
1245 << "max consensus time: " << parms.ledgerMAX_CONSENSUS.count() << ", "
-
1246 << "validators: " << totalValidators << ", "
-
1247 << "laggards: " << laggards << ", " << "offline: " << offline << ", "
-
1248 << "quorum: " << quorum << ")";
-
1249
-
1250 if (!ahead || !laggards || !totalValidators || !adaptor_.validator() ||
-
1251 !adaptor_.haveValidated() ||
-
1252 result_->roundTime.read() > parms.ledgerMAX_CONSENSUS)
-
1253 {
-
1254 j_.debug() << "not pausing (early)" << vars.str();
-
1255 CLOG(clog) << "Not pausing (early). ";
-
1256 return false;
-
1257 }
-
1258
-
1259 bool willPause = false;
-
1260
-
1274 constexpr static std::size_t maxPausePhase = 4;
+
1153 for (auto const& it : recentPeerPositions_)
+
1154 {
+
1155 for (auto const& pos : it.second)
+
1156 {
+
1157 if (pos.proposal().prevLedger() == prevLedgerID_)
+
1158 {
+
1159 if (peerProposalInternal(now_, pos))
+
1160 adaptor_.share(pos);
+
1161 }
+
1162 }
+
1163 }
+
1164}
+
1165
+
1166template <class Adaptor>
+
1167void
+
1168Consensus<Adaptor>::phaseOpen(std::unique_ptr<std::stringstream> const& clog)
+
1169{
+
1170 CLOG(clog) << "phaseOpen. ";
+
1171 using namespace std::chrono;
+
1172
+
1173 // it is shortly before ledger close time
+
1174 bool anyTransactions = adaptor_.hasOpenTransactions();
+
1175 auto proposersClosed = currPeerPositions_.size();
+
1176 auto proposersValidated = adaptor_.proposersValidated(prevLedgerID_);
+
1177
+
1178 openTime_.tick(clock_.now());
+
1179
+
1180 // This computes how long since last ledger's close time
+
1181 milliseconds sinceClose;
+
1182 {
+
1183 auto const mode = mode_.get();
+
1184 bool const closeAgree = previousLedger_.closeAgree();
+
1185 auto const prevCloseTime = previousLedger_.closeTime();
+
1186 auto const prevParentCloseTimePlus1 =
+
1187 previousLedger_.parentCloseTime() + 1s;
+
1188 bool const previousCloseCorrect =
+
1189 (mode != ConsensusMode::wrongLedger) && closeAgree &&
+
1190 (prevCloseTime != prevParentCloseTimePlus1);
+
1191
+
1192 auto const lastCloseTime = previousCloseCorrect
+
1193 ? prevCloseTime // use consensus timing
+
1194 : prevCloseTime_; // use the time we saw internally
+
1195
+
1196 if (now_ >= lastCloseTime)
+
1197 sinceClose = duration_cast<milliseconds>(now_ - lastCloseTime);
+
1198 else
+
1199 sinceClose = -duration_cast<milliseconds>(lastCloseTime - now_);
+
1200 CLOG(clog) << "calculating how long since last ledger's close time "
+
1201 "based on mode : "
+
1202 << to_string(mode) << ", previous closeAgree: " << closeAgree
+
1203 << ", previous close time: " << to_string(prevCloseTime)
+
1204 << ", previous parent close time + 1s: "
+
1205 << to_string(prevParentCloseTimePlus1)
+
1206 << ", previous close time seen internally: "
+
1207 << to_string(prevCloseTime_)
+
1208 << ", last close time: " << to_string(lastCloseTime)
+
1209 << ", since close: " << sinceClose.count() << ". ";
+
1210 }
+
1211
+
1212 auto const idleInterval = std::max<milliseconds>(
+
1213 adaptor_.parms().ledgerIDLE_INTERVAL,
+
1214 2 * previousLedger_.closeTimeResolution());
+
1215 CLOG(clog) << "idle interval set to " << idleInterval.count()
+
1216 << "ms based on " << "ledgerIDLE_INTERVAL: "
+
1217 << adaptor_.parms().ledgerIDLE_INTERVAL.count()
+
1218 << ", previous ledger close time resolution: "
+
1219 << previousLedger_.closeTimeResolution().count() << "ms. ";
+
1220
+
1221 // Decide if we should close the ledger
+
1222 if (shouldCloseLedger(
+
1223 anyTransactions,
+
1224 prevProposers_,
+
1225 proposersClosed,
+
1226 proposersValidated,
+
1227 prevRoundTime_,
+
1228 sinceClose,
+
1229 openTime_.read(),
+
1230 idleInterval,
+
1231 adaptor_.parms(),
+
1232 j_,
+
1233 clog))
+
1234 {
+
1235 CLOG(clog) << "closing ledger. ";
+
1236 closeLedger(clog);
+
1237 }
+
1238}
+
1239
+
1240template <class Adaptor>
+
1241bool
+
1242Consensus<Adaptor>::shouldPause(
+
1243 std::unique_ptr<std::stringstream> const& clog) const
+
1244{
+
1245 CLOG(clog) << "shouldPause? ";
+
1246 auto const& parms = adaptor_.parms();
+
1247 std::uint32_t const ahead(
+
1248 previousLedger_.seq() -
+
1249 std::min(adaptor_.getValidLedgerIndex(), previousLedger_.seq()));
+
1250 auto [quorum, trustedKeys] = adaptor_.getQuorumKeys();
+
1251 std::size_t const totalValidators = trustedKeys.size();
+
1252 std::size_t laggards =
+
1253 adaptor_.laggards(previousLedger_.seq(), trustedKeys);
+
1254 std::size_t const offline = trustedKeys.size();
+
1255
+
1256 std::stringstream vars;
+
1257 vars << " consensuslog (working seq: " << previousLedger_.seq() << ", "
+
1258 << "validated seq: " << adaptor_.getValidLedgerIndex() << ", "
+
1259 << "am validator: " << adaptor_.validator() << ", "
+
1260 << "have validated: " << adaptor_.haveValidated() << ", "
+
1261 << "roundTime: " << result_->roundTime.read().count() << ", "
+
1262 << "max consensus time: " << parms.ledgerMAX_CONSENSUS.count() << ", "
+
1263 << "validators: " << totalValidators << ", "
+
1264 << "laggards: " << laggards << ", " << "offline: " << offline << ", "
+
1265 << "quorum: " << quorum << ")";
+
1266
+
1267 if (!ahead || !laggards || !totalValidators || !adaptor_.validator() ||
+
1268 !adaptor_.haveValidated() ||
+
1269 result_->roundTime.read() > parms.ledgerMAX_CONSENSUS)
+
1270 {
+
1271 j_.debug() << "not pausing (early)" << vars.str();
+
1272 CLOG(clog) << "Not pausing (early). ";
+
1273 return false;
+
1274 }
1275
-
1295 std::size_t const phase = (ahead - 1) % (maxPausePhase + 1);
-
1296
-
1297 // validators that remain after the laggards() function are considered
-
1298 // offline, and should be considered as laggards for purposes of
-
1299 // evaluating whether the threshold for non-laggards has been reached.
-
1300 switch (phase)
-
1301 {
-
1302 case 0:
-
1303 // Laggards and offline shouldn't preclude consensus.
-
1304 if (laggards + offline > totalValidators - quorum)
-
1305 willPause = true;
-
1306 break;
-
1307 case maxPausePhase:
-
1308 // No tolerance.
-
1309 willPause = true;
-
1310 break;
-
1311 default:
-
1312 // Ensure that sufficient validators are known to be not lagging.
-
1313 // Their sufficiently most recent validation sequence was equal to
-
1314 // or greater than our own.
-
1315 //
-
1316 // The threshold is the amount required for quorum plus
-
1317 // the proportion of the remainder based on number of intermediate
-
1318 // phases between 0 and max.
-
1319 float const nonLaggards = totalValidators - (laggards + offline);
-
1320 float const quorumRatio =
-
1321 static_cast<float>(quorum) / totalValidators;
-
1322 float const allowedDissent = 1.0f - quorumRatio;
-
1323 float const phaseFactor = static_cast<float>(phase) / maxPausePhase;
-
1324
-
1325 if (nonLaggards / totalValidators <
-
1326 quorumRatio + (allowedDissent * phaseFactor))
-
1327 {
-
1328 willPause = true;
-
1329 }
-
1330 }
-
1331
-
1332 if (willPause)
-
1333 {
-
1334 j_.warn() << "pausing" << vars.str();
-
1335 CLOG(clog) << "pausing " << vars.str() << ". ";
-
1336 }
-
1337 else
-
1338 {
-
1339 j_.debug() << "not pausing" << vars.str();
-
1340 CLOG(clog) << "not pausing. ";
-
1341 }
-
1342 return willPause;
-
1343}
-
1344
-
1345template <class Adaptor>
-
1346void
-
1347Consensus<Adaptor>::phaseEstablish(
-
1348 std::unique_ptr<std::stringstream> const& clog)
-
1349{
-
1350 CLOG(clog) << "phaseEstablish. ";
-
1351 // can only establish consensus if we already took a stance
-
1352 XRPL_ASSERT(result_, "ripple::Consensus::phaseEstablish : result is set");
-
1353
-
1354 using namespace std::chrono;
-
1355 ConsensusParms const& parms = adaptor_.parms();
-
1356
-
1357 result_->roundTime.tick(clock_.now());
-
1358 result_->proposers = currPeerPositions_.size();
-
1359
-
1360 convergePercent_ = result_->roundTime.read() * 100 /
-
1361 std::max<milliseconds>(prevRoundTime_, parms.avMIN_CONSENSUS_TIME);
-
1362 CLOG(clog) << "convergePercent_ " << convergePercent_
-
1363 << " is based on round duration so far: "
-
1364 << result_->roundTime.read().count() << "ms, "
-
1365 << "previous round duration: " << prevRoundTime_.count()
-
1366 << "ms, "
-
1367 << "avMIN_CONSENSUS_TIME: " << parms.avMIN_CONSENSUS_TIME.count()
-
1368 << "ms. ";
-
1369
-
1370 // Give everyone a chance to take an initial position
-
1371 if (result_->roundTime.read() < parms.ledgerMIN_CONSENSUS)
-
1372 {
-
1373 CLOG(clog) << "ledgerMIN_CONSENSUS not reached: "
-
1374 << parms.ledgerMIN_CONSENSUS.count() << "ms. ";
-
1375 return;
-
1376 }
-
1377
-
1378 updateOurPositions(clog);
+
1276 bool willPause = false;
+
1277
+
1291 constexpr static std::size_t maxPausePhase = 4;
+
1292
+
1312 std::size_t const phase = (ahead - 1) % (maxPausePhase + 1);
+
1313
+
1314 // validators that remain after the laggards() function are considered
+
1315 // offline, and should be considered as laggards for purposes of
+
1316 // evaluating whether the threshold for non-laggards has been reached.
+
1317 switch (phase)
+
1318 {
+
1319 case 0:
+
1320 // Laggards and offline shouldn't preclude consensus.
+
1321 if (laggards + offline > totalValidators - quorum)
+
1322 willPause = true;
+
1323 break;
+
1324 case maxPausePhase:
+
1325 // No tolerance.
+
1326 willPause = true;
+
1327 break;
+
1328 default:
+
1329 // Ensure that sufficient validators are known to be not lagging.
+
1330 // Their sufficiently most recent validation sequence was equal to
+
1331 // or greater than our own.
+
1332 //
+
1333 // The threshold is the amount required for quorum plus
+
1334 // the proportion of the remainder based on number of intermediate
+
1335 // phases between 0 and max.
+
1336 float const nonLaggards = totalValidators - (laggards + offline);
+
1337 float const quorumRatio =
+
1338 static_cast<float>(quorum) / totalValidators;
+
1339 float const allowedDissent = 1.0f - quorumRatio;
+
1340 float const phaseFactor = static_cast<float>(phase) / maxPausePhase;
+
1341
+
1342 if (nonLaggards / totalValidators <
+
1343 quorumRatio + (allowedDissent * phaseFactor))
+
1344 {
+
1345 willPause = true;
+
1346 }
+
1347 }
+
1348
+
1349 if (willPause)
+
1350 {
+
1351 j_.warn() << "pausing" << vars.str();
+
1352 CLOG(clog) << "pausing " << vars.str() << ". ";
+
1353 }
+
1354 else
+
1355 {
+
1356 j_.debug() << "not pausing" << vars.str();
+
1357 CLOG(clog) << "not pausing. ";
+
1358 }
+
1359 return willPause;
+
1360}
+
1361
+
1362template <class Adaptor>
+
1363void
+
1364Consensus<Adaptor>::phaseEstablish(
+
1365 std::unique_ptr<std::stringstream> const& clog)
+
1366{
+
1367 CLOG(clog) << "phaseEstablish. ";
+
1368 // can only establish consensus if we already took a stance
+
1369 XRPL_ASSERT(result_, "ripple::Consensus::phaseEstablish : result is set");
+
1370
+
1371 ++peerUnchangedCounter_;
+
1372 ++establishCounter_;
+
1373
+
1374 using namespace std::chrono;
+
1375 ConsensusParms const& parms = adaptor_.parms();
+
1376
+
1377 result_->roundTime.tick(clock_.now());
+
1378 result_->proposers = currPeerPositions_.size();
1379
-
1380 // Nothing to do if too many laggards or we don't have consensus.
-
1381 if (shouldPause(clog) || !haveConsensus(clog))
-
1382 return;
-
1383
-
1384 if (!haveCloseTimeConsensus_)
-
1385 {
-
1386 JLOG(j_.info()) << "We have TX consensus but not CT consensus";
-
1387 CLOG(clog) << "We have TX consensus but not CT consensus. ";
-
1388 return;
-
1389 }
-
1390
-
1391 JLOG(j_.info()) << "Converge cutoff (" << currPeerPositions_.size()
-
1392 << " participants)";
-
1393 CLOG(clog) << "Converge cutoff (" << currPeerPositions_.size()
-
1394 << " participants). Transitioned to ConsensusPhase::accepted. ";
-
1395 adaptor_.updateOperatingMode(currPeerPositions_.size());
-
1396 prevProposers_ = currPeerPositions_.size();
-
1397 prevRoundTime_ = result_->roundTime.read();
-
1398 phase_ = ConsensusPhase::accepted;
-
1399 JLOG(j_.debug()) << "transitioned to ConsensusPhase::accepted";
-
1400 adaptor_.onAccept(
-
1401 *result_,
-
1402 previousLedger_,
-
1403 closeResolution_,
-
1404 rawCloseTimes_,
-
1405 mode_.get(),
-
1406 getJson(true),
-
1407 adaptor_.validating());
-
1408}
-
1409
-
1410template <class Adaptor>
-
1411void
-
1412Consensus<Adaptor>::closeLedger(std::unique_ptr<std::stringstream> const& clog)
-
1413{
-
1414 // We should not be closing if we already have a position
-
1415 XRPL_ASSERT(!result_, "ripple::Consensus::closeLedger : result is not set");
-
1416
-
1417 phase_ = ConsensusPhase::establish;
-
1418 JLOG(j_.debug()) << "transitioned to ConsensusPhase::establish";
-
1419 rawCloseTimes_.self = now_;
-
1420
-
1421 result_.emplace(adaptor_.onClose(previousLedger_, now_, mode_.get()));
-
1422 result_->roundTime.reset(clock_.now());
-
1423 // Share the newly created transaction set if we haven't already
-
1424 // received it from a peer
-
1425 if (acquired_.emplace(result_->txns.id(), result_->txns).second)
-
1426 adaptor_.share(result_->txns);
-
1427
-
1428 const auto mode = mode_.get();
-
1429 CLOG(clog)
-
1430 << "closeLedger transitioned to ConsensusPhase::establish, mode: "
-
1431 << to_string(mode)
-
1432 << ", number of peer positions: " << currPeerPositions_.size() << ". ";
-
1433 if (mode == ConsensusMode::proposing)
-
1434 adaptor_.propose(result_->position);
-
1435
-
1436 // Create disputes with any peer positions we have transactions for
-
1437 for (auto const& pit : currPeerPositions_)
-
1438 {
-
1439 auto const& pos = pit.second.proposal().position();
-
1440 auto const it = acquired_.find(pos);
-
1441 if (it != acquired_.end())
-
1442 createDisputes(it->second, clog);
-
1443 }
-
1444}
-
1445
-
1458inline int
-
1459participantsNeeded(int participants, int percent)
-
1460{
-
1461 int result = ((participants * percent) + (percent / 2)) / 100;
-
1462
-
1463 return (result == 0) ? 1 : result;
-
1464}
-
1465
-
1466template <class Adaptor>
-
1467void
-
1468Consensus<Adaptor>::updateOurPositions(
-
1469 std::unique_ptr<std::stringstream> const& clog)
-
1470{
-
1471 // We must have a position if we are updating it
-
1472 XRPL_ASSERT(
-
1473 result_, "ripple::Consensus::updateOurPositions : result is set");
-
1474 ConsensusParms const& parms = adaptor_.parms();
-
1475
-
1476 // Compute a cutoff time
-
1477 auto const peerCutoff = now_ - parms.proposeFRESHNESS;
-
1478 auto const ourCutoff = now_ - parms.proposeINTERVAL;
-
1479 CLOG(clog) << "updateOurPositions. peerCutoff " << to_string(peerCutoff)
-
1480 << ", ourCutoff " << to_string(ourCutoff) << ". ";
-
1481
-
1482 // Verify freshness of peer positions and compute close times
-
1483 std::map<NetClock::time_point, int> closeTimeVotes;
-
1484 {
-
1485 auto it = currPeerPositions_.begin();
-
1486 while (it != currPeerPositions_.end())
-
1487 {
-
1488 Proposal_t const& peerProp = it->second.proposal();
-
1489 if (peerProp.isStale(peerCutoff))
-
1490 {
-
1491 // peer's proposal is stale, so remove it
-
1492 NodeID_t const& peerID = peerProp.nodeID();
-
1493 JLOG(j_.warn()) << "Removing stale proposal from " << peerID;
-
1494 for (auto& dt : result_->disputes)
-
1495 dt.second.unVote(peerID);
-
1496 it = currPeerPositions_.erase(it);
-
1497 }
-
1498 else
-
1499 {
-
1500 // proposal is still fresh
-
1501 ++closeTimeVotes[asCloseTime(peerProp.closeTime())];
-
1502 ++it;
-
1503 }
-
1504 }
-
1505 }
-
1506
-
1507 // This will stay unseated unless there are any changes
-
1508 std::optional<TxSet_t> ourNewSet;
-
1509
-
1510 // Update votes on disputed transactions
-
1511 {
-
1512 std::optional<typename TxSet_t::MutableTxSet> mutableSet;
-
1513 for (auto& [txId, dispute] : result_->disputes)
-
1514 {
-
1515 // Because the threshold for inclusion increases,
-
1516 // time can change our position on a dispute
-
1517 if (dispute.updateVote(
-
1518 convergePercent_,
-
1519 mode_.get() == ConsensusMode::proposing,
-
1520 parms))
+
1380 convergePercent_ = result_->roundTime.read() * 100 /
+
1381 std::max<milliseconds>(prevRoundTime_, parms.avMIN_CONSENSUS_TIME);
+
1382 CLOG(clog) << "convergePercent_ " << convergePercent_
+
1383 << " is based on round duration so far: "
+
1384 << result_->roundTime.read().count() << "ms, "
+
1385 << "previous round duration: " << prevRoundTime_.count()
+
1386 << "ms, "
+
1387 << "avMIN_CONSENSUS_TIME: " << parms.avMIN_CONSENSUS_TIME.count()
+
1388 << "ms. ";
+
1389
+
1390 // Give everyone a chance to take an initial position
+
1391 if (result_->roundTime.read() < parms.ledgerMIN_CONSENSUS)
+
1392 {
+
1393 CLOG(clog) << "ledgerMIN_CONSENSUS not reached: "
+
1394 << parms.ledgerMIN_CONSENSUS.count() << "ms. ";
+
1395 return;
+
1396 }
+
1397
+
1398 updateOurPositions(clog);
+
1399
+
1400 // Nothing to do if too many laggards or we don't have consensus.
+
1401 if (shouldPause(clog) || !haveConsensus(clog))
+
1402 return;
+
1403
+
1404 if (!haveCloseTimeConsensus_)
+
1405 {
+
1406 JLOG(j_.info()) << "We have TX consensus but not CT consensus";
+
1407 CLOG(clog) << "We have TX consensus but not CT consensus. ";
+
1408 return;
+
1409 }
+
1410
+
1411 JLOG(j_.info()) << "Converge cutoff (" << currPeerPositions_.size()
+
1412 << " participants)";
+
1413 CLOG(clog) << "Converge cutoff (" << currPeerPositions_.size()
+
1414 << " participants). Transitioned to ConsensusPhase::accepted. ";
+
1415 adaptor_.updateOperatingMode(currPeerPositions_.size());
+
1416 prevProposers_ = currPeerPositions_.size();
+
1417 prevRoundTime_ = result_->roundTime.read();
+
1418 phase_ = ConsensusPhase::accepted;
+
1419 JLOG(j_.debug()) << "transitioned to ConsensusPhase::accepted";
+
1420 adaptor_.onAccept(
+
1421 *result_,
+
1422 previousLedger_,
+
1423 closeResolution_,
+
1424 rawCloseTimes_,
+
1425 mode_.get(),
+
1426 getJson(true),
+
1427 adaptor_.validating());
+
1428}
+
1429
+
1430template <class Adaptor>
+
1431void
+
1432Consensus<Adaptor>::closeLedger(std::unique_ptr<std::stringstream> const& clog)
+
1433{
+
1434 // We should not be closing if we already have a position
+
1435 XRPL_ASSERT(!result_, "ripple::Consensus::closeLedger : result is not set");
+
1436
+
1437 phase_ = ConsensusPhase::establish;
+
1438 JLOG(j_.debug()) << "transitioned to ConsensusPhase::establish";
+
1439 rawCloseTimes_.self = now_;
+
1440 peerUnchangedCounter_ = 0;
+
1441 establishCounter_ = 0;
+
1442
+
1443 result_.emplace(adaptor_.onClose(previousLedger_, now_, mode_.get()));
+
1444 result_->roundTime.reset(clock_.now());
+
1445 // Share the newly created transaction set if we haven't already
+
1446 // received it from a peer
+
1447 if (acquired_.emplace(result_->txns.id(), result_->txns).second)
+
1448 adaptor_.share(result_->txns);
+
1449
+
1450 const auto mode = mode_.get();
+
1451 CLOG(clog)
+
1452 << "closeLedger transitioned to ConsensusPhase::establish, mode: "
+
1453 << to_string(mode)
+
1454 << ", number of peer positions: " << currPeerPositions_.size() << ". ";
+
1455 if (mode == ConsensusMode::proposing)
+
1456 adaptor_.propose(result_->position);
+
1457
+
1458 // Create disputes with any peer positions we have transactions for
+
1459 for (auto const& pit : currPeerPositions_)
+
1460 {
+
1461 auto const& pos = pit.second.proposal().position();
+
1462 auto const it = acquired_.find(pos);
+
1463 if (it != acquired_.end())
+
1464 createDisputes(it->second, clog);
+
1465 }
+
1466}
+
1467
+
1480inline int
+
1481participantsNeeded(int participants, int percent)
+
1482{
+
1483 int result = ((participants * percent) + (percent / 2)) / 100;
+
1484
+
1485 return (result == 0) ? 1 : result;
+
1486}
+
1487
+
1488template <class Adaptor>
+
1489void
+
1490Consensus<Adaptor>::updateOurPositions(
+
1491 std::unique_ptr<std::stringstream> const& clog)
+
1492{
+
1493 // We must have a position if we are updating it
+
1494 XRPL_ASSERT(
+
1495 result_, "ripple::Consensus::updateOurPositions : result is set");
+
1496 ConsensusParms const& parms = adaptor_.parms();
+
1497
+
1498 // Compute a cutoff time
+
1499 auto const peerCutoff = now_ - parms.proposeFRESHNESS;
+
1500 auto const ourCutoff = now_ - parms.proposeINTERVAL;
+
1501 CLOG(clog) << "updateOurPositions. peerCutoff " << to_string(peerCutoff)
+
1502 << ", ourCutoff " << to_string(ourCutoff) << ". ";
+
1503
+
1504 // Verify freshness of peer positions and compute close times
+
1505 std::map<NetClock::time_point, int> closeTimeVotes;
+
1506 {
+
1507 auto it = currPeerPositions_.begin();
+
1508 while (it != currPeerPositions_.end())
+
1509 {
+
1510 Proposal_t const& peerProp = it->second.proposal();
+
1511 if (peerProp.isStale(peerCutoff))
+
1512 {
+
1513 // peer's proposal is stale, so remove it
+
1514 NodeID_t const& peerID = peerProp.nodeID();
+
1515 JLOG(j_.warn()) << "Removing stale proposal from " << peerID;
+
1516 for (auto& dt : result_->disputes)
+
1517 dt.second.unVote(peerID);
+
1518 it = currPeerPositions_.erase(it);
+
1519 }
+
1520 else
1521 {
-
1522 if (!mutableSet)
-
1523 mutableSet.emplace(result_->txns);
-
1524
-
1525 if (dispute.getOurVote())
-
1526 {
-
1527 // now a yes
-
1528 mutableSet->insert(dispute.tx());
-
1529 }
-
1530 else
-
1531 {
-
1532 // now a no
-
1533 mutableSet->erase(txId);
-
1534 }
-
1535 }
-
1536 }
-
1537
-
1538 if (mutableSet)
-
1539 ourNewSet.emplace(std::move(*mutableSet));
-
1540 }
-
1541
-
1542 NetClock::time_point consensusCloseTime = {};
-
1543 haveCloseTimeConsensus_ = false;
-
1544
-
1545 if (currPeerPositions_.empty())
-
1546 {
-
1547 // no other times
-
1548 haveCloseTimeConsensus_ = true;
-
1549 consensusCloseTime = asCloseTime(result_->position.closeTime());
-
1550 }
-
1551 else
-
1552 {
-
1553 int neededWeight;
-
1554
-
1555 if (convergePercent_ < parms.avMID_CONSENSUS_TIME)
-
1556 neededWeight = parms.avINIT_CONSENSUS_PCT;
-
1557 else if (convergePercent_ < parms.avLATE_CONSENSUS_TIME)
-
1558 neededWeight = parms.avMID_CONSENSUS_PCT;
-
1559 else if (convergePercent_ < parms.avSTUCK_CONSENSUS_TIME)
-
1560 neededWeight = parms.avLATE_CONSENSUS_PCT;
-
1561 else
-
1562 neededWeight = parms.avSTUCK_CONSENSUS_PCT;
-
1563 CLOG(clog) << "neededWeight " << neededWeight << ". ";
-
1564
-
1565 int participants = currPeerPositions_.size();
-
1566 if (mode_.get() == ConsensusMode::proposing)
-
1567 {
-
1568 ++closeTimeVotes[asCloseTime(result_->position.closeTime())];
-
1569 ++participants;
-
1570 }
-
1571
-
1572 // Threshold for non-zero vote
-
1573 int threshVote = participantsNeeded(participants, neededWeight);
-
1574
-
1575 // Threshold to declare consensus
-
1576 int const threshConsensus =
-
1577 participantsNeeded(participants, parms.avCT_CONSENSUS_PCT);
-
1578
-
1579 std::stringstream ss;
-
1580 ss << "Proposers:" << currPeerPositions_.size()
-
1581 << " nw:" << neededWeight << " thrV:" << threshVote
-
1582 << " thrC:" << threshConsensus;
-
1583 JLOG(j_.info()) << ss.str();
-
1584 CLOG(clog) << ss.str();
-
1585
-
1586 for (auto const& [t, v] : closeTimeVotes)
-
1587 {
-
1588 JLOG(j_.debug())
-
1589 << "CCTime: seq "
-
1590 << static_cast<std::uint32_t>(previousLedger_.seq()) + 1 << ": "
-
1591 << t.time_since_epoch().count() << " has " << v << ", "
-
1592 << threshVote << " required";
-
1593
-
1594 if (v >= threshVote)
-
1595 {
-
1596 // A close time has enough votes for us to try to agree
-
1597 consensusCloseTime = t;
-
1598 threshVote = v;
-
1599
-
1600 if (threshVote >= threshConsensus)
-
1601 haveCloseTimeConsensus_ = true;
-
1602 }
-
1603 }
-
1604
-
1605 if (!haveCloseTimeConsensus_)
-
1606 {
-
1607 JLOG(j_.debug())
-
1608 << "No CT consensus:" << " Proposers:"
-
1609 << currPeerPositions_.size()
-
1610 << " Mode:" << to_string(mode_.get())
-
1611 << " Thresh:" << threshConsensus
-
1612 << " Pos:" << consensusCloseTime.time_since_epoch().count();
-
1613 CLOG(clog) << "No close time consensus. ";
-
1614 }
-
1615 }
+
1522 // proposal is still fresh
+
1523 ++closeTimeVotes[asCloseTime(peerProp.closeTime())];
+
1524 ++it;
+
1525 }
+
1526 }
+
1527 }
+
1528
+
1529 // This will stay unseated unless there are any changes
+
1530 std::optional<TxSet_t> ourNewSet;
+
1531
+
1532 // Update votes on disputed transactions
+
1533 {
+
1534 std::optional<typename TxSet_t::MutableTxSet> mutableSet;
+
1535 for (auto& [txId, dispute] : result_->disputes)
+
1536 {
+
1537 // Because the threshold for inclusion increases,
+
1538 // time can change our position on a dispute
+
1539 if (dispute.updateVote(
+
1540 convergePercent_,
+
1541 mode_.get() == ConsensusMode::proposing,
+
1542 parms))
+
1543 {
+
1544 if (!mutableSet)
+
1545 mutableSet.emplace(result_->txns);
+
1546
+
1547 if (dispute.getOurVote())
+
1548 {
+
1549 // now a yes
+
1550 mutableSet->insert(dispute.tx());
+
1551 }
+
1552 else
+
1553 {
+
1554 // now a no
+
1555 mutableSet->erase(txId);
+
1556 }
+
1557 }
+
1558 }
+
1559
+
1560 if (mutableSet)
+
1561 ourNewSet.emplace(std::move(*mutableSet));
+
1562 }
+
1563
+
1564 NetClock::time_point consensusCloseTime = {};
+
1565 haveCloseTimeConsensus_ = false;
+
1566
+
1567 if (currPeerPositions_.empty())
+
1568 {
+
1569 // no other times
+
1570 haveCloseTimeConsensus_ = true;
+
1571 consensusCloseTime = asCloseTime(result_->position.closeTime());
+
1572 }
+
1573 else
+
1574 {
+
1575 // We don't track rounds for close time, so just pass 0s
+
1576 auto const [neededWeight, newState] = getNeededWeight(
+
1577 parms, closeTimeAvalancheState_, convergePercent_, 0, 0);
+
1578 if (newState)
+
1579 closeTimeAvalancheState_ = *newState;
+
1580 CLOG(clog) << "neededWeight " << neededWeight << ". ";
+
1581
+
1582 int participants = currPeerPositions_.size();
+
1583 if (mode_.get() == ConsensusMode::proposing)
+
1584 {
+
1585 ++closeTimeVotes[asCloseTime(result_->position.closeTime())];
+
1586 ++participants;
+
1587 }
+
1588
+
1589 // Threshold for non-zero vote
+
1590 int threshVote = participantsNeeded(participants, neededWeight);
+
1591
+
1592 // Threshold to declare consensus
+
1593 int const threshConsensus =
+
1594 participantsNeeded(participants, parms.avCT_CONSENSUS_PCT);
+
1595
+
1596 std::stringstream ss;
+
1597 ss << "Proposers:" << currPeerPositions_.size()
+
1598 << " nw:" << neededWeight << " thrV:" << threshVote
+
1599 << " thrC:" << threshConsensus;
+
1600 JLOG(j_.info()) << ss.str();
+
1601 CLOG(clog) << ss.str();
+
1602
+
1603 for (auto const& [t, v] : closeTimeVotes)
+
1604 {
+
1605 JLOG(j_.debug())
+
1606 << "CCTime: seq "
+
1607 << static_cast<std::uint32_t>(previousLedger_.seq()) + 1 << ": "
+
1608 << t.time_since_epoch().count() << " has " << v << ", "
+
1609 << threshVote << " required";
+
1610
+
1611 if (v >= threshVote)
+
1612 {
+
1613 // A close time has enough votes for us to try to agree
+
1614 consensusCloseTime = t;
+
1615 threshVote = v;
1616
-
1617 if (!ourNewSet &&
-
1618 ((consensusCloseTime != asCloseTime(result_->position.closeTime())) ||
-
1619 result_->position.isStale(ourCutoff)))
-
1620 {
-
1621 // close time changed or our position is stale
-
1622 ourNewSet.emplace(result_->txns);
-
1623 }
-
1624
-
1625 if (ourNewSet)
-
1626 {
-
1627 auto newID = ourNewSet->id();
-
1628
-
1629 result_->txns = std::move(*ourNewSet);
-
1630
-
1631 std::stringstream ss;
-
1632 ss << "Position change: CTime "
-
1633 << consensusCloseTime.time_since_epoch().count() << ", tx " << newID;
-
1634 JLOG(j_.info()) << ss.str();
-
1635 CLOG(clog) << ss.str();
-
1636
-
1637 result_->position.changePosition(newID, consensusCloseTime, now_);
-
1638
-
1639 // Share our new transaction set and update disputes
-
1640 // if we haven't already received it
-
1641 if (acquired_.emplace(newID, result_->txns).second)
-
1642 {
-
1643 if (!result_->position.isBowOut())
-
1644 adaptor_.share(result_->txns);
+
1617 if (threshVote >= threshConsensus)
+
1618 haveCloseTimeConsensus_ = true;
+
1619 }
+
1620 }
+
1621
+
1622 if (!haveCloseTimeConsensus_)
+
1623 {
+
1624 JLOG(j_.debug())
+
1625 << "No CT consensus:" << " Proposers:"
+
1626 << currPeerPositions_.size()
+
1627 << " Mode:" << to_string(mode_.get())
+
1628 << " Thresh:" << threshConsensus
+
1629 << " Pos:" << consensusCloseTime.time_since_epoch().count();
+
1630 CLOG(clog) << "No close time consensus. ";
+
1631 }
+
1632 }
+
1633
+
1634 if (!ourNewSet &&
+
1635 ((consensusCloseTime != asCloseTime(result_->position.closeTime())) ||
+
1636 result_->position.isStale(ourCutoff)))
+
1637 {
+
1638 // close time changed or our position is stale
+
1639 ourNewSet.emplace(result_->txns);
+
1640 }
+
1641
+
1642 if (ourNewSet)
+
1643 {
+
1644 auto newID = ourNewSet->id();
1645
-
1646 for (auto const& [nodeId, peerPos] : currPeerPositions_)
-
1647 {
-
1648 Proposal_t const& p = peerPos.proposal();
-
1649 if (p.position() == newID)
-
1650 updateDisputes(nodeId, result_->txns);
-
1651 }
-
1652 }
+
1646 result_->txns = std::move(*ourNewSet);
+
1647
+
1648 std::stringstream ss;
+
1649 ss << "Position change: CTime "
+
1650 << consensusCloseTime.time_since_epoch().count() << ", tx " << newID;
+
1651 JLOG(j_.info()) << ss.str();
+
1652 CLOG(clog) << ss.str();
1653
-
1654 // Share our new position if we are still participating this round
-
1655 if (!result_->position.isBowOut() &&
-
1656 (mode_.get() == ConsensusMode::proposing))
-
1657 adaptor_.propose(result_->position);
-
1658 }
-
1659}
-
1660
-
1661template <class Adaptor>
-
1662bool
-
1663Consensus<Adaptor>::haveConsensus(
-
1664 std::unique_ptr<std::stringstream> const& clog)
-
1665{
-
1666 // Must have a stance if we are checking for consensus
-
1667 XRPL_ASSERT(result_, "ripple::Consensus::haveConsensus : has result");
-
1668
-
1669 // CHECKME: should possibly count unacquired TX sets as disagreeing
-
1670 int agree = 0, disagree = 0;
-
1671
-
1672 auto ourPosition = result_->position.position();
-
1673
-
1674 // Count number of agreements/disagreements with our position
-
1675 for (auto const& [nodeId, peerPos] : currPeerPositions_)
-
1676 {
-
1677 Proposal_t const& peerProp = peerPos.proposal();
-
1678 if (peerProp.position() == ourPosition)
-
1679 {
-
1680 ++agree;
-
1681 }
-
1682 else
-
1683 {
-
1684 JLOG(j_.debug()) << nodeId << " has " << peerProp.position();
-
1685 ++disagree;
-
1686 }
-
1687 }
-
1688 auto currentFinished =
-
1689 adaptor_.proposersFinished(previousLedger_, prevLedgerID_);
+
1654 result_->position.changePosition(newID, consensusCloseTime, now_);
+
1655
+
1656 // Share our new transaction set and update disputes
+
1657 // if we haven't already received it
+
1658 if (acquired_.emplace(newID, result_->txns).second)
+
1659 {
+
1660 if (!result_->position.isBowOut())
+
1661 adaptor_.share(result_->txns);
+
1662
+
1663 for (auto const& [nodeId, peerPos] : currPeerPositions_)
+
1664 {
+
1665 Proposal_t const& p = peerPos.proposal();
+
1666 if (p.position() == newID)
+
1667 updateDisputes(nodeId, result_->txns);
+
1668 }
+
1669 }
+
1670
+
1671 // Share our new position if we are still participating this round
+
1672 if (!result_->position.isBowOut() &&
+
1673 (mode_.get() == ConsensusMode::proposing))
+
1674 adaptor_.propose(result_->position);
+
1675 }
+
1676}
+
1677
+
1678template <class Adaptor>
+
1679bool
+
1680Consensus<Adaptor>::haveConsensus(
+
1681 std::unique_ptr<std::stringstream> const& clog)
+
1682{
+
1683 // Must have a stance if we are checking for consensus
+
1684 XRPL_ASSERT(result_, "ripple::Consensus::haveConsensus : has result");
+
1685
+
1686 // CHECKME: should possibly count unacquired TX sets as disagreeing
+
1687 int agree = 0, disagree = 0;
+
1688
+
1689 auto ourPosition = result_->position.position();
1690
-
1691 JLOG(j_.debug()) << "Checking for TX consensus: agree=" << agree
-
1692 << ", disagree=" << disagree;
-
1693
-
1694 // Determine if we actually have consensus or not
-
1695 result_->state = checkConsensus(
-
1696 prevProposers_,
-
1697 agree + disagree,
-
1698 agree,
-
1699 currentFinished,
-
1700 prevRoundTime_,
-
1701 result_->roundTime.read(),
-
1702 adaptor_.parms(),
-
1703 mode_.get() == ConsensusMode::proposing,
-
1704 j_,
-
1705 clog);
-
1706
-
1707 if (result_->state == ConsensusState::No)
-
1708 {
-
1709 CLOG(clog) << "No consensus. ";
-
1710 return false;
-
1711 }
-
1712
-
1713 // There is consensus, but we need to track if the network moved on
-
1714 // without us.
-
1715 if (result_->state == ConsensusState::MovedOn)
-
1716 {
-
1717 JLOG(j_.error()) << "Unable to reach consensus";
-
1718 JLOG(j_.error()) << Json::Compact{getJson(true)};
-
1719 CLOG(clog) << "Unable to reach consensus "
-
1720 << Json::Compact{getJson(true)} << ". ";
-
1721 }
+
1691 // Count number of agreements/disagreements with our position
+
1692 for (auto const& [nodeId, peerPos] : currPeerPositions_)
+
1693 {
+
1694 Proposal_t const& peerProp = peerPos.proposal();
+
1695 if (peerProp.position() == ourPosition)
+
1696 {
+
1697 ++agree;
+
1698 }
+
1699 else
+
1700 {
+
1701 JLOG(j_.debug()) << "Proposal disagreement: Peer " << nodeId
+
1702 << " has " << peerProp.position();
+
1703 ++disagree;
+
1704 }
+
1705 }
+
1706 auto currentFinished =
+
1707 adaptor_.proposersFinished(previousLedger_, prevLedgerID_);
+
1708
+
1709 JLOG(j_.debug()) << "Checking for TX consensus: agree=" << agree
+
1710 << ", disagree=" << disagree;
+
1711
+
1712 ConsensusParms const& parms = adaptor_.parms();
+
1713 // Stalling is BAD
+
1714 bool const stalled = haveCloseTimeConsensus_ &&
+
1715 std::ranges::all_of(result_->disputes,
+
1716 [this, &parms](auto const& dispute) {
+
1717 return dispute.second.stalled(
+
1718 parms,
+
1719 mode_.get() == ConsensusMode::proposing,
+
1720 peerUnchangedCounter_);
+
1721 });
1722
-
1723 CLOG(clog) << "Consensus has been reached. ";
-
1724 return true;
-
1725}
-
1726
-
1727template <class Adaptor>
-
1728void
-
1729Consensus<Adaptor>::leaveConsensus(
-
1730 std::unique_ptr<std::stringstream> const& clog)
-
1731{
-
1732 if (mode_.get() == ConsensusMode::proposing)
-
1733 {
-
1734 if (result_ && !result_->position.isBowOut())
-
1735 {
-
1736 result_->position.bowOut(now_);
-
1737 adaptor_.propose(result_->position);
-
1738 }
-
1739
-
1740 mode_.set(ConsensusMode::observing, adaptor_);
-
1741 JLOG(j_.info()) << "Bowing out of consensus";
-
1742 CLOG(clog) << "Bowing out of consensus. ";
-
1743 }
-
1744}
-
1745
-
1746template <class Adaptor>
-
1747void
-
1748Consensus<Adaptor>::createDisputes(
-
1749 TxSet_t const& o,
-
1750 std::unique_ptr<std::stringstream> const& clog)
-
1751{
-
1752 // Cannot create disputes without our stance
-
1753 XRPL_ASSERT(result_, "ripple::Consensus::createDisputes : result is set");
-
1754
-
1755 // Only create disputes if this is a new set
-
1756 auto const emplaced = result_->compares.emplace(o.id()).second;
-
1757 CLOG(clog) << "createDisputes: new set? " << !emplaced << ". ";
-
1758 if (!emplaced)
-
1759 return;
-
1760
-
1761 // Nothing to dispute if we agree
-
1762 if (result_->txns.id() == o.id())
-
1763 {
-
1764 CLOG(clog) << "both sets are identical. ";
-
1765 return;
-
1766 }
-
1767
-
1768 CLOG(clog) << "comparing existing with new set: " << result_->txns.id()
-
1769 << ',' << o.id() << ". ";
-
1770 JLOG(j_.debug()) << "createDisputes " << result_->txns.id() << " to "
-
1771 << o.id();
-
1772
-
1773 auto differences = result_->txns.compare(o);
-
1774
-
1775 int dc = 0;
-
1776
-
1777 for (auto const& [txId, inThisSet] : differences)
-
1778 {
-
1779 ++dc;
-
1780 // create disputed transactions (from the ledger that has them)
-
1781 XRPL_ASSERT(
-
1782 (inThisSet && result_->txns.find(txId) && !o.find(txId)) ||
-
1783 (!inThisSet && !result_->txns.find(txId) && o.find(txId)),
-
1784 "ripple::Consensus::createDisputes : has disputed transactions");
-
1785
-
1786 Tx_t tx = inThisSet ? result_->txns.find(txId) : o.find(txId);
-
1787 auto txID = tx.id();
-
1788
-
1789 if (result_->disputes.find(txID) != result_->disputes.end())
-
1790 continue;
-
1791
-
1792 JLOG(j_.debug()) << "Transaction " << txID << " is disputed";
-
1793
-
1794 typename Result::Dispute_t dtx{
-
1795 tx,
-
1796 result_->txns.exists(txID),
-
1797 std::max(prevProposers_, currPeerPositions_.size()),
-
1798 j_};
-
1799
-
1800 // Update all of the available peer's votes on the disputed transaction
-
1801 for (auto const& [nodeId, peerPos] : currPeerPositions_)
-
1802 {
-
1803 Proposal_t const& peerProp = peerPos.proposal();
-
1804 auto const cit = acquired_.find(peerProp.position());
-
1805 if (cit != acquired_.end())
-
1806 dtx.setVote(nodeId, cit->second.exists(txID));
-
1807 }
-
1808 adaptor_.share(dtx.tx());
-
1809
-
1810 result_->disputes.emplace(txID, std::move(dtx));
-
1811 }
-
1812 JLOG(j_.debug()) << dc << " differences found";
-
1813 CLOG(clog) << "disputes: " << dc << ". ";
-
1814}
-
1815
-
1816template <class Adaptor>
-
1817void
-
1818Consensus<Adaptor>::updateDisputes(NodeID_t const& node, TxSet_t const& other)
-
1819{
-
1820 // Cannot updateDisputes without our stance
-
1821 XRPL_ASSERT(result_, "ripple::Consensus::updateDisputes : result is set");
-
1822
-
1823 // Ensure we have created disputes against this set if we haven't seen
-
1824 // it before
-
1825 if (result_->compares.find(other.id()) == result_->compares.end())
-
1826 createDisputes(other);
-
1827
-
1828 for (auto& it : result_->disputes)
-
1829 {
-
1830 auto& d = it.second;
-
1831 d.setVote(node, other.exists(d.tx().id()));
-
1832 }
-
1833}
-
1834
-
1835template <class Adaptor>
-
1836NetClock::time_point
-
1837Consensus<Adaptor>::asCloseTime(NetClock::time_point raw) const
-
1838{
-
1839 return roundCloseTime(raw, closeResolution_);
-
1840}
-
1841
-
1842} // namespace ripple
-
1843
-
1844#endif
+
1723 // Determine if we actually have consensus or not
+
1724 result_->state = checkConsensus(
+
1725 prevProposers_,
+
1726 agree + disagree,
+
1727 agree,
+
1728 currentFinished,
+
1729 prevRoundTime_,
+
1730 result_->roundTime.read(),
+
1731 stalled,
+
1732 parms,
+
1733 mode_.get() == ConsensusMode::proposing,
+
1734 j_,
+
1735 clog);
+
1736
+
1737 if (result_->state == ConsensusState::No)
+
1738 {
+
1739 CLOG(clog) << "No consensus. ";
+
1740 return false;
+
1741 }
+
1742
+
1743 // Consensus has taken far too long. Drop out of the round.
+
1744 if (result_->state == ConsensusState::Expired)
+
1745 {
+
1746 static auto const minimumCounter =
+
1747 parms.avalancheCutoffs.size() * parms.avMIN_ROUNDS;
+
1748 std::stringstream ss;
+
1749 if (establishCounter_ < minimumCounter)
+
1750 {
+
1751 // If each round of phaseEstablish takes a very long time, we may
+
1752 // "expire" before we've given consensus enough time at each
+
1753 // avalanche level to actually come to a consensus. In that case,
+
1754 // keep trying. This should only happen if there are an extremely
+
1755 // large number of disputes such that each round takes an inordinate
+
1756 // amount of time.
+
1757
+
1758 ss << "Consensus time has expired in round " << establishCounter_
+
1759 << "; continue until round " << minimumCounter << ". "
+
1760 << Json::Compact{getJson(false)};
+
1761 JLOG(j_.error()) << ss.str();
+
1762 CLOG(clog) << ss.str() << ". ";
+
1763 return false;
+
1764 }
+
1765 ss << "Consensus expired. " << Json::Compact{getJson(true)};
+
1766 JLOG(j_.error()) << ss.str();
+
1767 CLOG(clog) << ss.str() << ". ";
+
1768 leaveConsensus(clog);
+
1769 }
+
1770 // There is consensus, but we need to track if the network moved on
+
1771 // without us.
+
1772 if (result_->state == ConsensusState::MovedOn)
+
1773 {
+
1774 JLOG(j_.error()) << "Unable to reach consensus";
+
1775 JLOG(j_.error()) << Json::Compact{getJson(true)};
+
1776 CLOG(clog) << "Unable to reach consensus "
+
1777 << Json::Compact{getJson(true)} << ". ";
+
1778 }
+
1779
+
1780 CLOG(clog) << "Consensus has been reached. ";
+
1781 return true;
+
1782}
+
1783
+
1784template <class Adaptor>
+
1785void
+
1786Consensus<Adaptor>::leaveConsensus(
+
1787 std::unique_ptr<std::stringstream> const& clog)
+
1788{
+
1789 if (mode_.get() == ConsensusMode::proposing)
+
1790 {
+
1791 if (result_ && !result_->position.isBowOut())
+
1792 {
+
1793 result_->position.bowOut(now_);
+
1794 adaptor_.propose(result_->position);
+
1795 }
+
1796
+
1797 mode_.set(ConsensusMode::observing, adaptor_);
+
1798 JLOG(j_.info()) << "Bowing out of consensus";
+
1799 CLOG(clog) << "Bowing out of consensus. ";
+
1800 }
+
1801}
+
1802
+
1803template <class Adaptor>
+
1804void
+
1805Consensus<Adaptor>::createDisputes(
+
1806 TxSet_t const& o,
+
1807 std::unique_ptr<std::stringstream> const& clog)
+
1808{
+
1809 // Cannot create disputes without our stance
+
1810 XRPL_ASSERT(result_, "ripple::Consensus::createDisputes : result is set");
+
1811
+
1812 // Only create disputes if this is a new set
+
1813 auto const emplaced = result_->compares.emplace(o.id()).second;
+
1814 CLOG(clog) << "createDisputes: new set? " << !emplaced << ". ";
+
1815 if (!emplaced)
+
1816 return;
+
1817
+
1818 // Nothing to dispute if we agree
+
1819 if (result_->txns.id() == o.id())
+
1820 {
+
1821 CLOG(clog) << "both sets are identical. ";
+
1822 return;
+
1823 }
+
1824
+
1825 CLOG(clog) << "comparing existing with new set: " << result_->txns.id()
+
1826 << ',' << o.id() << ". ";
+
1827 JLOG(j_.debug()) << "createDisputes " << result_->txns.id() << " to "
+
1828 << o.id();
+
1829
+
1830 auto differences = result_->txns.compare(o);
+
1831
+
1832 int dc = 0;
+
1833
+
1834 for (auto const& [txId, inThisSet] : differences)
+
1835 {
+
1836 ++dc;
+
1837 // create disputed transactions (from the ledger that has them)
+
1838 XRPL_ASSERT(
+
1839 (inThisSet && result_->txns.find(txId) && !o.find(txId)) ||
+
1840 (!inThisSet && !result_->txns.find(txId) && o.find(txId)),
+
1841 "ripple::Consensus::createDisputes : has disputed transactions");
+
1842
+
1843 Tx_t tx = inThisSet ? result_->txns.find(txId) : o.find(txId);
+
1844 auto txID = tx.id();
+
1845
+
1846 if (result_->disputes.find(txID) != result_->disputes.end())
+
1847 continue;
+
1848
+
1849 JLOG(j_.debug()) << "Transaction " << txID << " is disputed";
+
1850
+
1851 typename Result::Dispute_t dtx{
+
1852 tx,
+
1853 result_->txns.exists(txID),
+
1854 std::max(prevProposers_, currPeerPositions_.size()),
+
1855 j_};
+
1856
+
1857 // Update all of the available peer's votes on the disputed transaction
+
1858 for (auto const& [nodeId, peerPos] : currPeerPositions_)
+
1859 {
+
1860 Proposal_t const& peerProp = peerPos.proposal();
+
1861 auto const cit = acquired_.find(peerProp.position());
+
1862 if (cit != acquired_.end() &&
+
1863 dtx.setVote(nodeId, cit->second.exists(txID)))
+
1864 peerUnchangedCounter_ = 0;
+
1865 }
+
1866 adaptor_.share(dtx.tx());
+
1867
+
1868 result_->disputes.emplace(txID, std::move(dtx));
+
1869 }
+
1870 JLOG(j_.debug()) << dc << " differences found";
+
1871 CLOG(clog) << "disputes: " << dc << ". ";
+
1872}
+
1873
+
1874template <class Adaptor>
+
1875void
+
1876Consensus<Adaptor>::updateDisputes(NodeID_t const& node, TxSet_t const& other)
+
1877{
+
1878 // Cannot updateDisputes without our stance
+
1879 XRPL_ASSERT(result_, "ripple::Consensus::updateDisputes : result is set");
+
1880
+
1881 // Ensure we have created disputes against this set if we haven't seen
+
1882 // it before
+
1883 if (result_->compares.find(other.id()) == result_->compares.end())
+
1884 createDisputes(other);
+
1885
+
1886 for (auto& it : result_->disputes)
+
1887 {
+
1888 auto& d = it.second;
+
1889 if (d.setVote(node, other.exists(d.tx().id())))
+
1890 peerUnchangedCounter_ = 0;
+
1891 }
+
1892}
+
1893
+
1894template <class Adaptor>
+
1895NetClock::time_point
+
1896Consensus<Adaptor>::asCloseTime(NetClock::time_point raw) const
+
1897{
+
1898 return roundCloseTime(raw, closeResolution_);
+
1899}
+
1900
+
1901} // namespace ripple
+
1902
+
1903#endif
+
std::map::begin
T begin(T... args)
@@ -1560,63 +1616,66 @@ $(function() {
ripple::ConsensusProposal::position
Position_t const & position() const
Get the proposed position.
Definition: ConsensusProposal.h:104
ripple::ConsensusProposal::isStale
bool isStale(NetClock::time_point cutoff) const
Get whether this position is stale relative to the provided cutoff.
Definition: ConsensusProposal.h:161
ripple::ConsensusTimer
Measures the duration of phases of consensus.
Definition: ConsensusTypes.h:137
- -
ripple::Consensus::MonitoredMode::set
void set(ConsensusMode mode, Adaptor &a)
Definition: Consensus.h:322
-
ripple::Consensus::MonitoredMode::MonitoredMode
MonitoredMode(ConsensusMode m)
Definition: Consensus.h:312
-
ripple::Consensus::MonitoredMode::get
ConsensusMode get() const
Definition: Consensus.h:316
- -
ripple::Consensus
Generic implementation of consensus algorithm.
Definition: Consensus.h:292
-
ripple::Consensus::playbackProposals
void playbackProposals()
If we radically changed our consensus context for some reason, we need to replay recent proposals so ...
Definition: Consensus.h:1134
-
ripple::Consensus::timerEntry
void timerEntry(NetClock::time_point const &now, std::unique_ptr< std::stringstream > const &clog={})
Call periodically to drive consensus forward.
Definition: Consensus.h:842
-
ripple::Consensus::openTime_
ConsensusTimer openTime_
Definition: Consensus.h:573
- -
ripple::Consensus::startRoundInternal
void startRoundInternal(NetClock::time_point const &now, typename Ledger_t::ID const &prevLedgerID, Ledger_t const &prevLedger, ConsensusMode mode, std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.h:681
-
ripple::Consensus::phaseEstablish
void phaseEstablish(std::unique_ptr< std::stringstream > const &clog)
Handle establish phase.
Definition: Consensus.h:1347
-
ripple::Consensus::PeerPosition_t
typename Adaptor::PeerPosition_t PeerPosition_t
Definition: Consensus.h:297
-
ripple::Consensus::phase_
ConsensusPhase phase_
Definition: Consensus.h:561
-
ripple::Consensus::prevCloseTime_
NetClock::time_point prevCloseTime_
Definition: Consensus.h:586
-
ripple::Consensus::clock_
clock_type const & clock_
Definition: Consensus.h:566
-
ripple::Consensus::leaveConsensus
void leaveConsensus(std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.h:1729
-
ripple::Consensus::updateDisputes
void updateDisputes(NodeID_t const &node, TxSet_t const &other)
Definition: Consensus.h:1818
-
ripple::Consensus::previousLedger_
Ledger_t previousLedger_
Definition: Consensus.h:594
-
ripple::Consensus::TxSet_t
typename Adaptor::TxSet_t TxSet_t
Definition: Consensus.h:294
-
ripple::Consensus::updateOurPositions
void updateOurPositions(std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.h:1468
-
ripple::Consensus::haveConsensus
bool haveConsensus(std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.h:1663
-
ripple::Consensus::prevLedgerID
Ledger_t::ID prevLedgerID() const
Get the previous ledger ID.
Definition: Consensus.h:425
-
ripple::Consensus::handleWrongLedger
void handleWrongLedger(typename Ledger_t::ID const &lgrId, std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.h:1045
-
ripple::Consensus::checkLedger
void checkLedger(std::unique_ptr< std::stringstream > const &clog)
Check if our previous ledger matches the network's.
Definition: Consensus.h:1101
-
ripple::Consensus::recentPeerPositions_
hash_map< NodeID_t, std::deque< PeerPosition_t > > recentPeerPositions_
Definition: Consensus.h:610
-
ripple::Consensus::simulate
void simulate(NetClock::time_point const &now, std::optional< std::chrono::milliseconds > consensusDelay)
Simulate the consensus process without any network traffic.
Definition: Consensus.h:923
-
ripple::Consensus::getJson
Json::Value getJson(bool full) const
Get the Json state of the consensus process.
Definition: Consensus.h:947
- -
ripple::Consensus::Tx_t
typename TxSet_t::Tx Tx_t
Definition: Consensus.h:296
-
ripple::Consensus::startRound
void startRound(NetClock::time_point const &now, typename Ledger_t::ID const &prevLedgerID, Ledger_t prevLedger, hash_set< NodeID_t > const &nowUntrusted, bool proposing, std::unique_ptr< std::stringstream > const &clog={})
Kick-off the next round of consensus.
Definition: Consensus.h:634
+ +
ripple::Consensus::MonitoredMode::set
void set(ConsensusMode mode, Adaptor &a)
Definition: Consensus.h:328
+
ripple::Consensus::MonitoredMode::MonitoredMode
MonitoredMode(ConsensusMode m)
Definition: Consensus.h:318
+
ripple::Consensus::MonitoredMode::get
ConsensusMode get() const
Definition: Consensus.h:322
+ +
ripple::Consensus
Generic implementation of consensus algorithm.
Definition: Consensus.h:298
+
ripple::Consensus::playbackProposals
void playbackProposals()
If we radically changed our consensus context for some reason, we need to replay recent proposals so ...
Definition: Consensus.h:1151
+
ripple::Consensus::timerEntry
void timerEntry(NetClock::time_point const &now, std::unique_ptr< std::stringstream > const &clog={})
Call periodically to drive consensus forward.
Definition: Consensus.h:859
+
ripple::Consensus::openTime_
ConsensusTimer openTime_
Definition: Consensus.h:579
+ +
ripple::Consensus::startRoundInternal
void startRoundInternal(NetClock::time_point const &now, typename Ledger_t::ID const &prevLedgerID, Ledger_t const &prevLedger, ConsensusMode mode, std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.h:697
+
ripple::Consensus::phaseEstablish
void phaseEstablish(std::unique_ptr< std::stringstream > const &clog)
Handle establish phase.
Definition: Consensus.h:1364
+
ripple::Consensus::PeerPosition_t
typename Adaptor::PeerPosition_t PeerPosition_t
Definition: Consensus.h:303
+
ripple::Consensus::phase_
ConsensusPhase phase_
Definition: Consensus.h:567
+
ripple::Consensus::prevCloseTime_
NetClock::time_point prevCloseTime_
Definition: Consensus.h:595
+
ripple::Consensus::clock_
clock_type const & clock_
Definition: Consensus.h:572
+
ripple::Consensus::leaveConsensus
void leaveConsensus(std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.h:1786
+
ripple::Consensus::updateDisputes
void updateDisputes(NodeID_t const &node, TxSet_t const &other)
Definition: Consensus.h:1876
+
ripple::Consensus::previousLedger_
Ledger_t previousLedger_
Definition: Consensus.h:603
+
ripple::Consensus::TxSet_t
typename Adaptor::TxSet_t TxSet_t
Definition: Consensus.h:300
+
ripple::Consensus::closeTimeAvalancheState_
ConsensusParms::AvalancheState closeTimeAvalancheState_
Definition: Consensus.h:583
+
ripple::Consensus::establishCounter_
std::size_t establishCounter_
Definition: Consensus.h:616
+
ripple::Consensus::updateOurPositions
void updateOurPositions(std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.h:1490
+
ripple::Consensus::haveConsensus
bool haveConsensus(std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.h:1680
+
ripple::Consensus::prevLedgerID
Ledger_t::ID prevLedgerID() const
Get the previous ledger ID.
Definition: Consensus.h:431
+
ripple::Consensus::handleWrongLedger
void handleWrongLedger(typename Ledger_t::ID const &lgrId, std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.h:1062
+
ripple::Consensus::checkLedger
void checkLedger(std::unique_ptr< std::stringstream > const &clog)
Check if our previous ledger matches the network's.
Definition: Consensus.h:1118
+
ripple::Consensus::recentPeerPositions_
hash_map< NodeID_t, std::deque< PeerPosition_t > > recentPeerPositions_
Definition: Consensus.h:626
+
ripple::Consensus::simulate
void simulate(NetClock::time_point const &now, std::optional< std::chrono::milliseconds > consensusDelay)
Simulate the consensus process without any network traffic.
Definition: Consensus.h:940
+
ripple::Consensus::getJson
Json::Value getJson(bool full) const
Get the Json state of the consensus process.
Definition: Consensus.h:964
+ +
ripple::Consensus::Tx_t
typename TxSet_t::Tx Tx_t
Definition: Consensus.h:302
+
ripple::Consensus::startRound
void startRound(NetClock::time_point const &now, typename Ledger_t::ID const &prevLedgerID, Ledger_t prevLedger, hash_set< NodeID_t > const &nowUntrusted, bool proposing, std::unique_ptr< std::stringstream > const &clog={})
Kick-off the next round of consensus.
Definition: Consensus.h:650
ripple::Consensus::Consensus
Consensus(Consensus &&) noexcept=default
-
ripple::Consensus::now_
NetClock::time_point now_
Definition: Consensus.h:585
-
ripple::Consensus::prevProposers_
std::size_t prevProposers_
Definition: Consensus.h:613
-
ripple::Consensus::asCloseTime
NetClock::time_point asCloseTime(NetClock::time_point raw) const
Definition: Consensus.h:1837
-
ripple::Consensus::j_
beast::Journal const j_
Definition: Consensus.h:619
-
ripple::Consensus::createDisputes
void createDisputes(TxSet_t const &o, std::unique_ptr< std::stringstream > const &clog={})
Definition: Consensus.h:1748
-
ripple::Consensus::gotTxSet
void gotTxSet(NetClock::time_point const &now, TxSet_t const &txSet)
Process a transaction set acquired from the network.
Definition: Consensus.h:875
-
ripple::Consensus::adaptor_
Adaptor & adaptor_
Definition: Consensus.h:559
-
ripple::Consensus::Ledger_t
typename Adaptor::Ledger_t Ledger_t
Definition: Consensus.h:293
-
ripple::Consensus::phase
ConsensusPhase phase() const
Definition: Consensus.h:431
-
ripple::Consensus::acquired_
hash_map< typename TxSet_t::ID, const TxSet_t > acquired_
Definition: Consensus.h:597
-
ripple::Consensus::NodeID_t
typename Adaptor::NodeID_t NodeID_t
Definition: Consensus.h:295
-
ripple::Consensus::closeLedger
void closeLedger(std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.h:1412
-
ripple::Consensus::closeResolution_
NetClock::duration closeResolution_
Definition: Consensus.h:575
-
ripple::Consensus::peerProposal
bool peerProposal(NetClock::time_point const &now, PeerPosition_t const &newProposal)
A peer has proposed a new position, adjust our tracking.
Definition: Consensus.h:726
-
ripple::Consensus::peerProposalInternal
bool peerProposalInternal(NetClock::time_point const &now, PeerPosition_t const &newProposal)
Handle a replayed or a new peer proposal.
Definition: Consensus.h:747
-
ripple::Consensus::mode_
MonitoredMode mode_
Definition: Consensus.h:562
-
ripple::Consensus::currPeerPositions_
hash_map< NodeID_t, PeerPosition_t > currPeerPositions_
Definition: Consensus.h:606
-
ripple::Consensus::shouldPause
bool shouldPause(std::unique_ptr< std::stringstream > const &clog) const
Evaluate whether pausing increases likelihood of validation.
Definition: Consensus.h:1225
-
ripple::Consensus::phaseOpen
void phaseOpen(std::unique_ptr< std::stringstream > const &clog)
Handle pre-close phase.
Definition: Consensus.h:1151
-
ripple::Consensus::rawCloseTimes_
ConsensusCloseTimes rawCloseTimes_
Definition: Consensus.h:600
-
ripple::Consensus::prevRoundTime_
std::chrono::milliseconds prevRoundTime_
Definition: Consensus.h:578
-
ripple::Consensus::result_
std::optional< Result > result_
Definition: Consensus.h:599
-
ripple::Consensus::deadNodes_
hash_set< NodeID_t > deadNodes_
Definition: Consensus.h:616
-
ripple::Consensus::prevLedgerID_
Ledger_t::ID prevLedgerID_
Definition: Consensus.h:592
-
ripple::Consensus::haveCloseTimeConsensus_
bool haveCloseTimeConsensus_
Definition: Consensus.h:564
+
ripple::Consensus::now_
NetClock::time_point now_
Definition: Consensus.h:594
+
ripple::Consensus::prevProposers_
std::size_t prevProposers_
Definition: Consensus.h:629
+
ripple::Consensus::asCloseTime
NetClock::time_point asCloseTime(NetClock::time_point raw) const
Definition: Consensus.h:1896
+
ripple::Consensus::j_
beast::Journal const j_
Definition: Consensus.h:635
+
ripple::Consensus::createDisputes
void createDisputes(TxSet_t const &o, std::unique_ptr< std::stringstream > const &clog={})
Definition: Consensus.h:1805
+
ripple::Consensus::gotTxSet
void gotTxSet(NetClock::time_point const &now, TxSet_t const &txSet)
Process a transaction set acquired from the network.
Definition: Consensus.h:892
+
ripple::Consensus::adaptor_
Adaptor & adaptor_
Definition: Consensus.h:565
+
ripple::Consensus::Ledger_t
typename Adaptor::Ledger_t Ledger_t
Definition: Consensus.h:299
+
ripple::Consensus::phase
ConsensusPhase phase() const
Definition: Consensus.h:437
+
ripple::Consensus::acquired_
hash_map< typename TxSet_t::ID, const TxSet_t > acquired_
Definition: Consensus.h:606
+
ripple::Consensus::peerUnchangedCounter_
std::size_t peerUnchangedCounter_
Definition: Consensus.h:613
+
ripple::Consensus::NodeID_t
typename Adaptor::NodeID_t NodeID_t
Definition: Consensus.h:301
+
ripple::Consensus::closeLedger
void closeLedger(std::unique_ptr< std::stringstream > const &clog)
Definition: Consensus.h:1432
+
ripple::Consensus::closeResolution_
NetClock::duration closeResolution_
Definition: Consensus.h:581
+
ripple::Consensus::peerProposal
bool peerProposal(NetClock::time_point const &now, PeerPosition_t const &newProposal)
A peer has proposed a new position, adjust our tracking.
Definition: Consensus.h:743
+
ripple::Consensus::peerProposalInternal
bool peerProposalInternal(NetClock::time_point const &now, PeerPosition_t const &newProposal)
Handle a replayed or a new peer proposal.
Definition: Consensus.h:764
+
ripple::Consensus::mode_
MonitoredMode mode_
Definition: Consensus.h:568
+
ripple::Consensus::currPeerPositions_
hash_map< NodeID_t, PeerPosition_t > currPeerPositions_
Definition: Consensus.h:622
+
ripple::Consensus::shouldPause
bool shouldPause(std::unique_ptr< std::stringstream > const &clog) const
Evaluate whether pausing increases likelihood of validation.
Definition: Consensus.h:1242
+
ripple::Consensus::phaseOpen
void phaseOpen(std::unique_ptr< std::stringstream > const &clog)
Handle pre-close phase.
Definition: Consensus.h:1168
+
ripple::Consensus::rawCloseTimes_
ConsensusCloseTimes rawCloseTimes_
Definition: Consensus.h:609
+
ripple::Consensus::prevRoundTime_
std::chrono::milliseconds prevRoundTime_
Definition: Consensus.h:587
+
ripple::Consensus::result_
std::optional< Result > result_
Definition: Consensus.h:608
+
ripple::Consensus::deadNodes_
hash_set< NodeID_t > deadNodes_
Definition: Consensus.h:632
+
ripple::Consensus::prevLedgerID_
Ledger_t::ID prevLedgerID_
Definition: Consensus.h:601
+
ripple::Consensus::haveCloseTimeConsensus_
bool haveCloseTimeConsensus_
Definition: Consensus.h:570
ripple::DisputedTx
A transaction discovered to be in dispute during consensus.
Definition: DisputedTx.h:49
@@ -1632,12 +1691,13 @@ $(function() {
Json::objectValue
@ objectValue
object value (collection of name/value pairs).
Definition: json_value.h:44
ripple
Use hash_* containers for keys that do not need a cryptographically secure hashing algorithm.
Definition: algorithm.h:26
-
ripple::checkConsensus
ConsensusState checkConsensus(std::size_t prevProposers, std::size_t currentProposers, std::size_t currentAgree, std::size_t currentFinished, std::chrono::milliseconds previousAgreeTime, std::chrono::milliseconds currentAgreeTime, ConsensusParms const &parms, bool proposing, beast::Journal j, std::unique_ptr< std::stringstream > const &clog)
Determine whether the network reached consensus and whether we joined.
Definition: Consensus.cpp:164
+
ripple::getNeededWeight
std::pair< std::size_t, std::optional< ConsensusParms::AvalancheState > > getNeededWeight(ConsensusParms const &p, ConsensusParms::AvalancheState currentState, int percentTime, std::size_t currentRounds, std::size_t minimumRounds)
Definition: ConsensusParms.h:173
ripple::ConsensusMode
ConsensusMode
Represents how a node currently participates in Consensus.
Definition: ConsensusTypes.h:57
ripple::ConsensusMode::wrongLedger
@ wrongLedger
We have the wrong ledger and are attempting to acquire it.
ripple::ConsensusMode::proposing
@ proposing
We are normal participant in consensus and propose our position.
ripple::ConsensusMode::switchedLedger
@ switchedLedger
We switched ledgers since we started this consensus round but are now running on what we believe is t...
ripple::ConsensusMode::observing
@ observing
We are observing peer positions, but not proposing our position.
+
ripple::checkConsensus
ConsensusState checkConsensus(std::size_t prevProposers, std::size_t currentProposers, std::size_t currentAgree, std::size_t currentFinished, std::chrono::milliseconds previousAgreeTime, std::chrono::milliseconds currentAgreeTime, bool stalled, ConsensusParms const &parms, bool proposing, beast::Journal j, std::unique_ptr< std::stringstream > const &clog)
Determine whether the network reached consensus and whether we joined.
Definition: Consensus.cpp:177
ripple::roundCloseTime
std::chrono::time_point< Clock, Duration > roundCloseTime(std::chrono::time_point< Clock, Duration > closeTime, std::chrono::duration< Rep, Period > closeResolution)
Calculates the close time for a ledger, given a close time resolution.
Definition: LedgerTiming.h:133
ripple::set
bool set(T &target, std::string const &name, Section const &section)
Set a value from a configuration Section If the named value is not found or doesn't parse as a T,...
Definition: BasicConfig.h:315
ripple::ledgerDefaultTimeResolution
auto constexpr ledgerDefaultTimeResolution
Initial resolution of ledger close time.
Definition: LedgerTiming.h:44
@@ -1646,12 +1706,13 @@ $(function() {
ripple::ConsensusPhase::open
@ open
We haven't closed our ledger yet, but others might have.
ripple::ConsensusPhase::establish
@ establish
Establishing consensus by exchanging proposals with our peers.
ripple::ConsensusState
ConsensusState
Whether we have or don't have a consensus.
Definition: ConsensusTypes.h:188
+
ripple::ConsensusState::Expired
@ Expired
Consensus time limit has hard-expired.
ripple::ConsensusState::MovedOn
@ MovedOn
The network has consensus without us.
ripple::ConsensusState::No
@ No
We do not have consensus.
ripple::to_string
std::string to_string(base_uint< Bits, Tag > const &a)
Definition: base_uint.h:630
ripple::shouldCloseLedger
bool shouldCloseLedger(bool anyTransactions, std::size_t prevProposers, std::size_t proposersClosed, std::size_t proposersValidated, std::chrono::milliseconds prevRoundTime, std::chrono::milliseconds timeSincePrevClose, std::chrono::milliseconds openTime, std::chrono::milliseconds idleInterval, ConsensusParms const &parms, beast::Journal j, std::unique_ptr< std::stringstream > const &clog)
Determines whether the current ledger should close at this time.
Definition: Consensus.cpp:27
ripple::getJson
Json::Value getJson(LedgerFill const &fill)
Return a new Json::Value representing the ledger with given options.
Definition: LedgerToJson.cpp:360
-
ripple::participantsNeeded
int participantsNeeded(int participants, int percent)
How many of the participants must agree to reach a given threshold?
Definition: Consensus.h:1459
+
ripple::participantsNeeded
int participantsNeeded(int participants, int percent)
How many of the participants must agree to reach a given threshold?
Definition: Consensus.h:1481
ripple::getNextLedgerTimeResolution
std::chrono::duration< Rep, Period > getNextLedgerTimeResolution(std::chrono::duration< Rep, Period > previousResolution, bool previousAgree, Seq ledgerSeq)
Calculates the close time resolution for the specified ledger.
Definition: LedgerTiming.h:80
std
STL namespace.
@@ -1662,20 +1723,17 @@ $(function() {
std::stringstream::str
T str(T... args)
ripple::ConsensusCloseTimes
Stores the set of initial close times.
Definition: ConsensusTypes.h:177
-
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:34
-
ripple::ConsensusParms::avINIT_CONSENSUS_PCT
std::size_t avINIT_CONSENSUS_PCT
Percentage of nodes on our UNL that must vote yes.
Definition: ConsensusParms.h:116
-
ripple::ConsensusParms::ledgerMIN_CONSENSUS
std::chrono::milliseconds ledgerMIN_CONSENSUS
The number of seconds we wait minimum to ensure participation.
Definition: ConsensusParms.h:80
-
ripple::ConsensusParms::avMIN_CONSENSUS_TIME
std::chrono::milliseconds avMIN_CONSENSUS_TIME
The minimum amount of time to consider the previous round to have taken.
Definition: ConsensusParms.h:107
-
ripple::ConsensusParms::avLATE_CONSENSUS_PCT
std::size_t avLATE_CONSENSUS_PCT
Percentage of nodes that most vote yes after advancing.
Definition: ConsensusParms.h:128
-
ripple::ConsensusParms::avSTUCK_CONSENSUS_PCT
std::size_t avSTUCK_CONSENSUS_PCT
Percentage of nodes that must vote yes after we are stuck.
Definition: ConsensusParms.h:134
-
ripple::ConsensusParms::proposeFRESHNESS
std::chrono::seconds proposeFRESHNESS
How long we consider a proposal fresh.
Definition: ConsensusParms.h:64
-
ripple::ConsensusParms::avLATE_CONSENSUS_TIME
std::size_t avLATE_CONSENSUS_TIME
Percentage of previous round duration before we advance.
Definition: ConsensusParms.h:125
-
ripple::ConsensusParms::proposeINTERVAL
std::chrono::seconds proposeINTERVAL
How often we force generating a new proposal to keep ours fresh.
Definition: ConsensusParms.h:67
-
ripple::ConsensusParms::avCT_CONSENSUS_PCT
std::size_t avCT_CONSENSUS_PCT
Percentage of nodes required to reach agreement on ledger close time.
Definition: ConsensusParms.h:137
-
ripple::ConsensusParms::avMID_CONSENSUS_PCT
std::size_t avMID_CONSENSUS_PCT
Percentage of nodes that most vote yes after advancing.
Definition: ConsensusParms.h:122
-
ripple::ConsensusParms::avSTUCK_CONSENSUS_TIME
std::size_t avSTUCK_CONSENSUS_TIME
Percentage of previous round duration before we are stuck.
Definition: ConsensusParms.h:131
-
ripple::ConsensusParms::avMID_CONSENSUS_TIME
std::size_t avMID_CONSENSUS_TIME
Percentage of previous round duration before we advance.
Definition: ConsensusParms.h:119
-
ripple::ConsensusResult
Encapsulates the result of consensus.
Definition: ConsensusTypes.h:204
+
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:39
+
ripple::ConsensusParms::avCT_CONSENSUS_PCT
std::size_t const avCT_CONSENSUS_PCT
Percentage of nodes required to reach agreement on ledger close time.
Definition: ConsensusParms.h:160
+
ripple::ConsensusParms::proposeINTERVAL
std::chrono::seconds const proposeINTERVAL
How often we force generating a new proposal to keep ours fresh.
Definition: ConsensusParms.h:72
+
ripple::ConsensusParms::avMIN_ROUNDS
std::size_t const avMIN_ROUNDS
Number of rounds before certain actions can happen.
Definition: ConsensusParms.h:165
+
ripple::ConsensusParms::avMIN_CONSENSUS_TIME
std::chrono::milliseconds const avMIN_CONSENSUS_TIME
The minimum amount of time to consider the previous round to have taken.
Definition: ConsensusParms.h:126
+ + +
ripple::ConsensusParms::ledgerMIN_CONSENSUS
std::chrono::milliseconds const ledgerMIN_CONSENSUS
The number of seconds we wait minimum to ensure participation.
Definition: ConsensusParms.h:86
+
ripple::ConsensusParms::avalancheCutoffs
std::map< AvalancheState, AvalancheCutoff > const avalancheCutoffs
Map the consensus requirement avalanche state to the amount of time that must pass before moving to t...
Definition: ConsensusParms.h:146
+
ripple::ConsensusParms::proposeFRESHNESS
std::chrono::seconds const proposeFRESHNESS
How long we consider a proposal fresh.
Definition: ConsensusParms.h:69
+
ripple::ConsensusResult
Encapsulates the result of consensus.
Definition: ConsensusTypes.h:205
std::chrono::time_point::time_since_epoch
T time_since_epoch(T... args)
std::to_string
T to_string(T... args)
diff --git a/Consensus__test_8cpp_source.html b/Consensus__test_8cpp_source.html index 5dff2227fc..29719f828d 100644 --- a/Consensus__test_8cpp_source.html +++ b/Consensus__test_8cpp_source.html @@ -101,1078 +101,1442 @@ $(function() {
23#include <xrpld/consensus/Consensus.h>
24
25#include <xrpl/beast/unit_test.h>
-
26
-
27namespace ripple {
-
28namespace test {
-
29
-
30class Consensus_test : public beast::unit_test::suite
-
31{
-
32 SuiteJournal journal_;
-
33
-
34public:
-
35 Consensus_test() : journal_("Consensus_test", *this)
-
36 {
-
37 }
-
38
-
39 void
-
40 testShouldCloseLedger()
-
41 {
-
42 using namespace std::chrono_literals;
-
43
-
44 // Use default parameters
-
45 ConsensusParms const p{};
-
46
-
47 // Bizarre times forcibly close
-
48 BEAST_EXPECT(shouldCloseLedger(
-
49 true, 10, 10, 10, -10s, 10s, 1s, 1s, p, journal_));
+
26#include <xrpl/json/to_string.h>
+
27
+
28namespace ripple {
+
29namespace test {
+
30
+
31class Consensus_test : public beast::unit_test::suite
+
32{
+
33 SuiteJournal journal_;
+
34
+
35public:
+
36 Consensus_test() : journal_("Consensus_test", *this)
+
37 {
+
38 }
+
39
+
40 void
+
41 testShouldCloseLedger()
+
42 {
+
43 using namespace std::chrono_literals;
+
44 testcase("should close ledger");
+
45
+
46 // Use default parameters
+
47 ConsensusParms const p{};
+
48
+
49 // Bizarre times forcibly close
50 BEAST_EXPECT(shouldCloseLedger(
-
51 true, 10, 10, 10, 100h, 10s, 1s, 1s, p, journal_));
+
51 true, 10, 10, 10, -10s, 10s, 1s, 1s, p, journal_));
52 BEAST_EXPECT(shouldCloseLedger(
-
53 true, 10, 10, 10, 10s, 100h, 1s, 1s, p, journal_));
-
54
-
55 // Rest of network has closed
-
56 BEAST_EXPECT(
-
57 shouldCloseLedger(true, 10, 3, 5, 10s, 10s, 10s, 10s, p, journal_));
-
58
-
59 // No transactions means wait until end of internval
-
60 BEAST_EXPECT(
-
61 !shouldCloseLedger(false, 10, 0, 0, 1s, 1s, 1s, 10s, p, journal_));
+
53 true, 10, 10, 10, 100h, 10s, 1s, 1s, p, journal_));
+
54 BEAST_EXPECT(shouldCloseLedger(
+
55 true, 10, 10, 10, 10s, 100h, 1s, 1s, p, journal_));
+
56
+
57 // Rest of network has closed
+
58 BEAST_EXPECT(
+
59 shouldCloseLedger(true, 10, 3, 5, 10s, 10s, 10s, 10s, p, journal_));
+
60
+
61 // No transactions means wait until end of internval
62 BEAST_EXPECT(
-
63 shouldCloseLedger(false, 10, 0, 0, 1s, 10s, 1s, 10s, p, journal_));
-
64
-
65 // Enforce minimum ledger open time
-
66 BEAST_EXPECT(
-
67 !shouldCloseLedger(true, 10, 0, 0, 10s, 10s, 1s, 10s, p, journal_));
-
68
-
69 // Don't go too much faster than last time
-
70 BEAST_EXPECT(
-
71 !shouldCloseLedger(true, 10, 0, 0, 10s, 10s, 3s, 10s, p, journal_));
-
72
-
73 BEAST_EXPECT(
-
74 shouldCloseLedger(true, 10, 0, 0, 10s, 10s, 10s, 10s, p, journal_));
-
75 }
-
76
-
77 void
-
78 testCheckConsensus()
-
79 {
-
80 using namespace std::chrono_literals;
-
81
-
82 // Use default parameterss
-
83 ConsensusParms const p{};
+
63 !shouldCloseLedger(false, 10, 0, 0, 1s, 1s, 1s, 10s, p, journal_));
+
64 BEAST_EXPECT(
+
65 shouldCloseLedger(false, 10, 0, 0, 1s, 10s, 1s, 10s, p, journal_));
+
66
+
67 // Enforce minimum ledger open time
+
68 BEAST_EXPECT(
+
69 !shouldCloseLedger(true, 10, 0, 0, 10s, 10s, 1s, 10s, p, journal_));
+
70
+
71 // Don't go too much faster than last time
+
72 BEAST_EXPECT(
+
73 !shouldCloseLedger(true, 10, 0, 0, 10s, 10s, 3s, 10s, p, journal_));
+
74
+
75 BEAST_EXPECT(
+
76 shouldCloseLedger(true, 10, 0, 0, 10s, 10s, 10s, 10s, p, journal_));
+
77 }
+
78
+
79 void
+
80 testCheckConsensus()
+
81 {
+
82 using namespace std::chrono_literals;
+
83 testcase("check consensus");
84
-
85 // Not enough time has elapsed
-
86 BEAST_EXPECT(
-
87 ConsensusState::No ==
-
88 checkConsensus(10, 2, 2, 0, 3s, 2s, p, true, journal_));
-
89
-
90 // If not enough peers have propsed, ensure
-
91 // more time for proposals
+
85 // Use default parameterss
+
86 ConsensusParms const p{};
+
87
+
89 // Disputes still in doubt
+
90 //
+
91 // Not enough time has elapsed
92 BEAST_EXPECT(
93 ConsensusState::No ==
-
94 checkConsensus(10, 2, 2, 0, 3s, 4s, p, true, journal_));
+
94 checkConsensus(10, 2, 2, 0, 3s, 2s, false, p, true, journal_));
95
-
96 // Enough time has elapsed and we all agree
-
97 BEAST_EXPECT(
-
98 ConsensusState::Yes ==
-
99 checkConsensus(10, 2, 2, 0, 3s, 10s, p, true, journal_));
-
100
-
101 // Enough time has elapsed and we don't yet agree
-
102 BEAST_EXPECT(
-
103 ConsensusState::No ==
-
104 checkConsensus(10, 2, 1, 0, 3s, 10s, p, true, journal_));
-
105
-
106 // Our peers have moved on
-
107 // Enough time has elapsed and we all agree
+
96 // If not enough peers have propsed, ensure
+
97 // more time for proposals
+
98 BEAST_EXPECT(
+
99 ConsensusState::No ==
+
100 checkConsensus(10, 2, 2, 0, 3s, 4s, false, p, true, journal_));
+
101
+
102 // Enough time has elapsed and we all agree
+
103 BEAST_EXPECT(
+
104 ConsensusState::Yes ==
+
105 checkConsensus(10, 2, 2, 0, 3s, 10s, false, p, true, journal_));
+
106
+
107 // Enough time has elapsed and we don't yet agree
108 BEAST_EXPECT(
-
109 ConsensusState::MovedOn ==
-
110 checkConsensus(10, 2, 1, 8, 3s, 10s, p, true, journal_));
+
109 ConsensusState::No ==
+
110 checkConsensus(10, 2, 1, 0, 3s, 10s, false, p, true, journal_));
111
-
112 // If no peers, don't agree until time has passed.
-
113 BEAST_EXPECT(
-
114 ConsensusState::No ==
-
115 checkConsensus(0, 0, 0, 0, 3s, 10s, p, true, journal_));
-
116
-
117 // Agree if no peers and enough time has passed.
-
118 BEAST_EXPECT(
-
119 ConsensusState::Yes ==
-
120 checkConsensus(0, 0, 0, 0, 3s, 16s, p, true, journal_));
-
121 }
+
112 // Our peers have moved on
+
113 // Enough time has elapsed and we all agree
+
114 BEAST_EXPECT(
+
115 ConsensusState::MovedOn ==
+
116 checkConsensus(10, 2, 1, 8, 3s, 10s, false, p, true, journal_));
+
117
+
118 // If no peers, don't agree until time has passed.
+
119 BEAST_EXPECT(
+
120 ConsensusState::No ==
+
121 checkConsensus(0, 0, 0, 0, 3s, 10s, false, p, true, journal_));
122
-
123 void
-
124 testStandalone()
-
125 {
-
126 using namespace std::chrono_literals;
-
127 using namespace csf;
-
128
-
129 Sim s;
-
130 PeerGroup peers = s.createGroup(1);
-
131 Peer* peer = peers[0];
-
132 peer->targetLedgers = 1;
-
133 peer->start();
-
134 peer->submit(Tx{1});
-
135
-
136 s.scheduler.step();
-
137
-
138 // Inspect that the proper ledger was created
-
139 auto const& lcl = peer->lastClosedLedger;
-
140 BEAST_EXPECT(peer->prevLedgerID() == lcl.id());
-
141 BEAST_EXPECT(lcl.seq() == Ledger::Seq{1});
-
142 BEAST_EXPECT(lcl.txs().size() == 1);
-
143 BEAST_EXPECT(lcl.txs().find(Tx{1}) != lcl.txs().end());
-
144 BEAST_EXPECT(peer->prevProposers == 0);
-
145 }
+
123 // Agree if no peers and enough time has passed.
+
124 BEAST_EXPECT(
+
125 ConsensusState::Yes ==
+
126 checkConsensus(0, 0, 0, 0, 3s, 16s, false, p, true, journal_));
+
127
+
128 // Expire if too much time has passed without agreement
+
129 BEAST_EXPECT(
+
130 ConsensusState::Expired ==
+
131 checkConsensus(10, 8, 1, 0, 1s, 19s, false, p, true, journal_));
+
132
+
134 // Stalled
+
135 //
+
136 // Not enough time has elapsed
+
137 BEAST_EXPECT(
+
138 ConsensusState::No ==
+
139 checkConsensus(10, 2, 2, 0, 3s, 2s, true, p, true, journal_));
+
140
+
141 // If not enough peers have propsed, ensure
+
142 // more time for proposals
+
143 BEAST_EXPECT(
+
144 ConsensusState::No ==
+
145 checkConsensus(10, 2, 2, 0, 3s, 4s, true, p, true, journal_));
146
-
147 void
-
148 testPeersAgree()
-
149 {
-
150 using namespace csf;
-
151 using namespace std::chrono;
-
152
-
153 ConsensusParms const parms{};
-
154 Sim sim;
-
155 PeerGroup peers = sim.createGroup(5);
-
156
-
157 // Connected trust and network graphs with single fixed delay
-
158 peers.trustAndConnect(
-
159 peers, round<milliseconds>(0.2 * parms.ledgerGRANULARITY));
-
160
-
161 // everyone submits their own ID as a TX
-
162 for (Peer* p : peers)
-
163 p->submit(Tx(static_cast<std::uint32_t>(p->id)));
-
164
-
165 sim.run(1);
-
166
-
167 // All peers are in sync
-
168 if (BEAST_EXPECT(sim.synchronized()))
-
169 {
-
170 for (Peer const* peer : peers)
-
171 {
-
172 auto const& lcl = peer->lastClosedLedger;
-
173 BEAST_EXPECT(lcl.id() == peer->prevLedgerID());
-
174 BEAST_EXPECT(lcl.seq() == Ledger::Seq{1});
-
175 // All peers proposed
-
176 BEAST_EXPECT(peer->prevProposers == peers.size() - 1);
-
177 // All transactions were accepted
-
178 for (std::uint32_t i = 0; i < peers.size(); ++i)
-
179 BEAST_EXPECT(lcl.txs().find(Tx{i}) != lcl.txs().end());
-
180 }
-
181 }
-
182 }
-
183
-
184 void
-
185 testSlowPeers()
-
186 {
-
187 using namespace csf;
-
188 using namespace std::chrono;
-
189
-
190 // Several tests of a complete trust graph with a subset of peers
-
191 // that have significantly longer network delays to the rest of the
-
192 // network
-
193
-
194 // Test when a slow peer doesn't delay a consensus quorum (4/5 agree)
-
195 {
-
196 ConsensusParms const parms{};
-
197 Sim sim;
-
198 PeerGroup slow = sim.createGroup(1);
-
199 PeerGroup fast = sim.createGroup(4);
-
200 PeerGroup network = fast + slow;
-
201
-
202 // Fully connected trust graph
-
203 network.trust(network);
-
204
-
205 // Fast and slow network connections
-
206 fast.connect(
-
207 fast, round<milliseconds>(0.2 * parms.ledgerGRANULARITY));
-
208
-
209 slow.connect(
-
210 network, round<milliseconds>(1.1 * parms.ledgerGRANULARITY));
-
211
-
212 // All peers submit their own ID as a transaction
-
213 for (Peer* peer : network)
-
214 peer->submit(Tx{static_cast<std::uint32_t>(peer->id)});
-
215
-
216 sim.run(1);
-
217
-
218 // Verify all peers have same LCL but are missing transaction 0
-
219 // All peers are in sync even with a slower peer 0
-
220 if (BEAST_EXPECT(sim.synchronized()))
-
221 {
-
222 for (Peer* peer : network)
-
223 {
-
224 auto const& lcl = peer->lastClosedLedger;
-
225 BEAST_EXPECT(lcl.id() == peer->prevLedgerID());
-
226 BEAST_EXPECT(lcl.seq() == Ledger::Seq{1});
-
227
-
228 BEAST_EXPECT(peer->prevProposers == network.size() - 1);
-
229 BEAST_EXPECT(
-
230 peer->prevRoundTime == network[0]->prevRoundTime);
-
231
-
232 BEAST_EXPECT(lcl.txs().find(Tx{0}) == lcl.txs().end());
-
233 for (std::uint32_t i = 2; i < network.size(); ++i)
-
234 BEAST_EXPECT(lcl.txs().find(Tx{i}) != lcl.txs().end());
-
235
-
236 // Tx 0 didn't make it
-
237 BEAST_EXPECT(
-
238 peer->openTxs.find(Tx{0}) != peer->openTxs.end());
-
239 }
+
147 // Enough time has elapsed and we all agree
+
148 BEAST_EXPECT(
+
149 ConsensusState::Yes ==
+
150 checkConsensus(10, 2, 2, 0, 3s, 10s, true, p, true, journal_));
+
151
+
152 // Enough time has elapsed and we don't yet agree, but there's nothing
+
153 // left to dispute
+
154 BEAST_EXPECT(
+
155 ConsensusState::Yes ==
+
156 checkConsensus(10, 2, 1, 0, 3s, 10s, true, p, true, journal_));
+
157
+
158 // Our peers have moved on
+
159 // Enough time has elapsed and we all agree, nothing left to dispute
+
160 BEAST_EXPECT(
+
161 ConsensusState::Yes ==
+
162 checkConsensus(10, 2, 1, 8, 3s, 10s, true, p, true, journal_));
+
163
+
164 // If no peers, don't agree until time has passed.
+
165 BEAST_EXPECT(
+
166 ConsensusState::No ==
+
167 checkConsensus(0, 0, 0, 0, 3s, 10s, true, p, true, journal_));
+
168
+
169 // Agree if no peers and enough time has passed.
+
170 BEAST_EXPECT(
+
171 ConsensusState::Yes ==
+
172 checkConsensus(0, 0, 0, 0, 3s, 16s, true, p, true, journal_));
+
173
+
174 // We are done if there's nothing left to dispute, no matter how much
+
175 // time has passed
+
176 BEAST_EXPECT(
+
177 ConsensusState::Yes ==
+
178 checkConsensus(10, 8, 1, 0, 1s, 19s, true, p, true, journal_));
+
179 }
+
180
+
181 void
+
182 testStandalone()
+
183 {
+
184 using namespace std::chrono_literals;
+
185 using namespace csf;
+
186 testcase("standalone");
+
187
+
188 Sim s;
+
189 PeerGroup peers = s.createGroup(1);
+
190 Peer* peer = peers[0];
+
191 peer->targetLedgers = 1;
+
192 peer->start();
+
193 peer->submit(Tx{1});
+
194
+
195 s.scheduler.step();
+
196
+
197 // Inspect that the proper ledger was created
+
198 auto const& lcl = peer->lastClosedLedger;
+
199 BEAST_EXPECT(peer->prevLedgerID() == lcl.id());
+
200 BEAST_EXPECT(lcl.seq() == Ledger::Seq{1});
+
201 BEAST_EXPECT(lcl.txs().size() == 1);
+
202 BEAST_EXPECT(lcl.txs().find(Tx{1}) != lcl.txs().end());
+
203 BEAST_EXPECT(peer->prevProposers == 0);
+
204 }
+
205
+
206 void
+
207 testPeersAgree()
+
208 {
+
209 using namespace csf;
+
210 using namespace std::chrono;
+
211 testcase("peers agree");
+
212
+
213 ConsensusParms const parms{};
+
214 Sim sim;
+
215 PeerGroup peers = sim.createGroup(5);
+
216
+
217 // Connected trust and network graphs with single fixed delay
+
218 peers.trustAndConnect(
+
219 peers, round<milliseconds>(0.2 * parms.ledgerGRANULARITY));
+
220
+
221 // everyone submits their own ID as a TX
+
222 for (Peer* p : peers)
+
223 p->submit(Tx(static_cast<std::uint32_t>(p->id)));
+
224
+
225 sim.run(1);
+
226
+
227 // All peers are in sync
+
228 if (BEAST_EXPECT(sim.synchronized()))
+
229 {
+
230 for (Peer const* peer : peers)
+
231 {
+
232 auto const& lcl = peer->lastClosedLedger;
+
233 BEAST_EXPECT(lcl.id() == peer->prevLedgerID());
+
234 BEAST_EXPECT(lcl.seq() == Ledger::Seq{1});
+
235 // All peers proposed
+
236 BEAST_EXPECT(peer->prevProposers == peers.size() - 1);
+
237 // All transactions were accepted
+
238 for (std::uint32_t i = 0; i < peers.size(); ++i)
+
239 BEAST_EXPECT(lcl.txs().find(Tx{i}) != lcl.txs().end());
240 }
241 }
-
242
-
243 // Test when the slow peers delay a consensus quorum (4/6 agree)
-
244 {
-
245 // Run two tests
-
246 // 1. The slow peers are participating in consensus
-
247 // 2. The slow peers are just observing
-
248
-
249 for (auto isParticipant : {true, false})
-
250 {
-
251 ConsensusParms const parms{};
-
252
-
253 Sim sim;
-
254 PeerGroup slow = sim.createGroup(2);
-
255 PeerGroup fast = sim.createGroup(4);
-
256 PeerGroup network = fast + slow;
-
257
-
258 // Connected trust graph
-
259 network.trust(network);
-
260
-
261 // Fast and slow network connections
-
262 fast.connect(
-
263 fast, round<milliseconds>(0.2 * parms.ledgerGRANULARITY));
-
264
-
265 slow.connect(
-
266 network,
-
267 round<milliseconds>(1.1 * parms.ledgerGRANULARITY));
-
268
-
269 for (Peer* peer : slow)
-
270 peer->runAsValidator = isParticipant;
-
271
-
272 // All peers submit their own ID as a transaction and relay it
-
273 // to peers
-
274 for (Peer* peer : network)
-
275 peer->submit(Tx{static_cast<std::uint32_t>(peer->id)});
+
242 }
+
243
+
244 void
+
245 testSlowPeers()
+
246 {
+
247 using namespace csf;
+
248 using namespace std::chrono;
+
249 testcase("slow peers");
+
250
+
251 // Several tests of a complete trust graph with a subset of peers
+
252 // that have significantly longer network delays to the rest of the
+
253 // network
+
254
+
255 // Test when a slow peer doesn't delay a consensus quorum (4/5 agree)
+
256 {
+
257 ConsensusParms const parms{};
+
258 Sim sim;
+
259 PeerGroup slow = sim.createGroup(1);
+
260 PeerGroup fast = sim.createGroup(4);
+
261 PeerGroup network = fast + slow;
+
262
+
263 // Fully connected trust graph
+
264 network.trust(network);
+
265
+
266 // Fast and slow network connections
+
267 fast.connect(
+
268 fast, round<milliseconds>(0.2 * parms.ledgerGRANULARITY));
+
269
+
270 slow.connect(
+
271 network, round<milliseconds>(1.1 * parms.ledgerGRANULARITY));
+
272
+
273 // All peers submit their own ID as a transaction
+
274 for (Peer* peer : network)
+
275 peer->submit(Tx{static_cast<std::uint32_t>(peer->id)});
276
-
277 sim.run(1);
+
277 sim.run(1);
278
-
279 if (BEAST_EXPECT(sim.synchronized()))
-
280 {
-
281 // Verify all peers have same LCL but are missing
-
282 // transaction 0,1 which was not received by all peers
-
283 // before the ledger closed
-
284 for (Peer* peer : network)
-
285 {
-
286 // Closed ledger has all but transaction 0,1
-
287 auto const& lcl = peer->lastClosedLedger;
-
288 BEAST_EXPECT(lcl.seq() == Ledger::Seq{1});
-
289 BEAST_EXPECT(lcl.txs().find(Tx{0}) == lcl.txs().end());
-
290 BEAST_EXPECT(lcl.txs().find(Tx{1}) == lcl.txs().end());
-
291 for (std::uint32_t i = slow.size(); i < network.size();
-
292 ++i)
-
293 BEAST_EXPECT(
-
294 lcl.txs().find(Tx{i}) != lcl.txs().end());
-
295
-
296 // Tx 0-1 didn't make it
-
297 BEAST_EXPECT(
-
298 peer->openTxs.find(Tx{0}) != peer->openTxs.end());
-
299 BEAST_EXPECT(
-
300 peer->openTxs.find(Tx{1}) != peer->openTxs.end());
-
301 }
-
302
-
303 Peer const* slowPeer = slow[0];
-
304 if (isParticipant)
-
305 BEAST_EXPECT(
-
306 slowPeer->prevProposers == network.size() - 1);
-
307 else
-
308 BEAST_EXPECT(slowPeer->prevProposers == fast.size());
+
279 // Verify all peers have same LCL but are missing transaction 0
+
280 // All peers are in sync even with a slower peer 0
+
281 if (BEAST_EXPECT(sim.synchronized()))
+
282 {
+
283 for (Peer* peer : network)
+
284 {
+
285 auto const& lcl = peer->lastClosedLedger;
+
286 BEAST_EXPECT(lcl.id() == peer->prevLedgerID());
+
287 BEAST_EXPECT(lcl.seq() == Ledger::Seq{1});
+
288
+
289 BEAST_EXPECT(peer->prevProposers == network.size() - 1);
+
290 BEAST_EXPECT(
+
291 peer->prevRoundTime == network[0]->prevRoundTime);
+
292
+
293 BEAST_EXPECT(lcl.txs().find(Tx{0}) == lcl.txs().end());
+
294 for (std::uint32_t i = 2; i < network.size(); ++i)
+
295 BEAST_EXPECT(lcl.txs().find(Tx{i}) != lcl.txs().end());
+
296
+
297 // Tx 0 didn't make it
+
298 BEAST_EXPECT(
+
299 peer->openTxs.find(Tx{0}) != peer->openTxs.end());
+
300 }
+
301 }
+
302 }
+
303
+
304 // Test when the slow peers delay a consensus quorum (4/6 agree)
+
305 {
+
306 // Run two tests
+
307 // 1. The slow peers are participating in consensus
+
308 // 2. The slow peers are just observing
309
-
310 for (Peer* peer : fast)
-
311 {
-
312 // Due to the network link delay settings
-
313 // Peer 0 initially proposes {0}
-
314 // Peer 1 initially proposes {1}
-
315 // Peers 2-5 initially propose {2,3,4,5}
-
316 // Since peers 2-5 agree, 4/6 > the initial 50% needed
-
317 // to include a disputed transaction, so Peer 0/1 switch
-
318 // to agree with those peers. Peer 0/1 then closes with
-
319 // an 80% quorum of agreeing positions (5/6) match.
-
320 //
-
321 // Peers 2-5 do not change position, since tx 0 or tx 1
-
322 // have less than the 50% initial threshold. They also
-
323 // cannot declare consensus, since 4/6 agreeing
-
324 // positions are < 80% threshold. They therefore need an
-
325 // additional timerEntry call to see the updated
-
326 // positions from Peer 0 & 1.
-
327
-
328 if (isParticipant)
-
329 {
-
330 BEAST_EXPECT(
-
331 peer->prevProposers == network.size() - 1);
-
332 BEAST_EXPECT(
-
333 peer->prevRoundTime > slowPeer->prevRoundTime);
-
334 }
-
335 else
-
336 {
-
337 BEAST_EXPECT(
-
338 peer->prevProposers == fast.size() - 1);
-
339 // so all peers should have closed together
-
340 BEAST_EXPECT(
-
341 peer->prevRoundTime == slowPeer->prevRoundTime);
-
342 }
-
343 }
-
344 }
-
345 }
-
346 }
-
347 }
-
348
-
349 void
-
350 testCloseTimeDisagree()
-
351 {
-
352 using namespace csf;
-
353 using namespace std::chrono;
-
354
-
355 // This is a very specialized test to get ledgers to disagree on
-
356 // the close time. It unfortunately assumes knowledge about current
-
357 // timing constants. This is a necessary evil to get coverage up
-
358 // pending more extensive refactorings of timing constants.
-
359
-
360 // In order to agree-to-disagree on the close time, there must be no
-
361 // clear majority of nodes agreeing on a close time. This test
-
362 // sets a relative offset to the peers internal clocks so that they
-
363 // send proposals with differing times.
-
364
-
365 // However, agreement is on the effective close time, not the
-
366 // exact close time. The minimum closeTimeResolution is given by
-
367 // ledgerPossibleTimeResolutions[0], which is currently 10s. This means
-
368 // the skews need to be at least 10 seconds to have different effective
-
369 // close times.
+
310 for (auto isParticipant : {true, false})
+
311 {
+
312 ConsensusParms const parms{};
+
313
+
314 Sim sim;
+
315 PeerGroup slow = sim.createGroup(2);
+
316 PeerGroup fast = sim.createGroup(4);
+
317 PeerGroup network = fast + slow;
+
318
+
319 // Connected trust graph
+
320 network.trust(network);
+
321
+
322 // Fast and slow network connections
+
323 fast.connect(
+
324 fast, round<milliseconds>(0.2 * parms.ledgerGRANULARITY));
+
325
+
326 slow.connect(
+
327 network,
+
328 round<milliseconds>(1.1 * parms.ledgerGRANULARITY));
+
329
+
330 for (Peer* peer : slow)
+
331 peer->runAsValidator = isParticipant;
+
332
+
333 // All peers submit their own ID as a transaction and relay it
+
334 // to peers
+
335 for (Peer* peer : network)
+
336 peer->submit(Tx{static_cast<std::uint32_t>(peer->id)});
+
337
+
338 sim.run(1);
+
339
+
340 if (BEAST_EXPECT(sim.synchronized()))
+
341 {
+
342 // Verify all peers have same LCL but are missing
+
343 // transaction 0,1 which was not received by all peers
+
344 // before the ledger closed
+
345 for (Peer* peer : network)
+
346 {
+
347 // Closed ledger has all but transaction 0,1
+
348 auto const& lcl = peer->lastClosedLedger;
+
349 BEAST_EXPECT(lcl.seq() == Ledger::Seq{1});
+
350 BEAST_EXPECT(lcl.txs().find(Tx{0}) == lcl.txs().end());
+
351 BEAST_EXPECT(lcl.txs().find(Tx{1}) == lcl.txs().end());
+
352 for (std::uint32_t i = slow.size(); i < network.size();
+
353 ++i)
+
354 BEAST_EXPECT(
+
355 lcl.txs().find(Tx{i}) != lcl.txs().end());
+
356
+
357 // Tx 0-1 didn't make it
+
358 BEAST_EXPECT(
+
359 peer->openTxs.find(Tx{0}) != peer->openTxs.end());
+
360 BEAST_EXPECT(
+
361 peer->openTxs.find(Tx{1}) != peer->openTxs.end());
+
362 }
+
363
+
364 Peer const* slowPeer = slow[0];
+
365 if (isParticipant)
+
366 BEAST_EXPECT(
+
367 slowPeer->prevProposers == network.size() - 1);
+
368 else
+
369 BEAST_EXPECT(slowPeer->prevProposers == fast.size());
370
-
371 // Complicating this matter is that nodes will ignore proposals
-
372 // with times more than proposeFRESHNESS =20s in the past. So at
-
373 // the minimum granularity, we have at most 3 types of skews
-
374 // (0s,10s,20s).
-
375
-
376 // This test therefore has 6 nodes, with 2 nodes having each type of
-
377 // skew. Then no majority (1/3 < 1/2) of nodes will agree on an
-
378 // actual close time.
-
379
-
380 ConsensusParms const parms{};
-
381 Sim sim;
-
382
-
383 PeerGroup groupA = sim.createGroup(2);
-
384 PeerGroup groupB = sim.createGroup(2);
-
385 PeerGroup groupC = sim.createGroup(2);
-
386 PeerGroup network = groupA + groupB + groupC;
-
387
-
388 network.trust(network);
-
389 network.connect(
-
390 network, round<milliseconds>(0.2 * parms.ledgerGRANULARITY));
-
391
-
392 // Run consensus without skew until we have a short close time
-
393 // resolution
-
394 Peer* firstPeer = *groupA.begin();
-
395 while (firstPeer->lastClosedLedger.closeTimeResolution() >=
-
396 parms.proposeFRESHNESS)
-
397 sim.run(1);
-
398
-
399 // Introduce a shift on the time of 2/3 of peers
-
400 for (Peer* peer : groupA)
-
401 peer->clockSkew = parms.proposeFRESHNESS / 2;
-
402 for (Peer* peer : groupB)
-
403 peer->clockSkew = parms.proposeFRESHNESS;
-
404
-
405 sim.run(1);
-
406
-
407 // All nodes agreed to disagree on the close time
-
408 if (BEAST_EXPECT(sim.synchronized()))
-
409 {
-
410 for (Peer* peer : network)
-
411 BEAST_EXPECT(!peer->lastClosedLedger.closeAgree());
-
412 }
-
413 }
-
414
-
415 void
-
416 testWrongLCL()
-
417 {
-
418 using namespace csf;
-
419 using namespace std::chrono;
-
420 // Specialized test to exercise a temporary fork in which some peers
-
421 // are working on an incorrect prior ledger.
-
422
-
423 ConsensusParms const parms{};
-
424
-
425 // Vary the time it takes to process validations to exercise detecting
-
426 // the wrong LCL at different phases of consensus
-
427 for (auto validationDelay : {0ms, parms.ledgerMIN_CLOSE})
-
428 {
-
429 // Consider 10 peers:
-
430 // 0 1 2 3 4 5 6 7 8 9
-
431 // minority majorityA majorityB
-
432 //
-
433 // Nodes 0-1 trust nodes 0-4
-
434 // Nodes 2-9 trust nodes 2-9
-
435 //
-
436 // By submitting tx 0 to nodes 0-4 and tx 1 to nodes 5-9,
-
437 // nodes 0-1 will generate the wrong LCL (with tx 0). The remaining
-
438 // nodes will instead accept the ledger with tx 1.
-
439
-
440 // Nodes 0-1 will detect this mismatch during a subsequent round
-
441 // since nodes 2-4 will validate a different ledger.
-
442
-
443 // Nodes 0-1 will acquire the proper ledger from the network and
-
444 // resume consensus and eventually generate the dominant network
-
445 // ledger.
-
446
-
447 // This topology can potentially fork with the above trust relations
-
448 // but that is intended for this test.
+
371 for (Peer* peer : fast)
+
372 {
+
373 // Due to the network link delay settings
+
374 // Peer 0 initially proposes {0}
+
375 // Peer 1 initially proposes {1}
+
376 // Peers 2-5 initially propose {2,3,4,5}
+
377 // Since peers 2-5 agree, 4/6 > the initial 50% needed
+
378 // to include a disputed transaction, so Peer 0/1 switch
+
379 // to agree with those peers. Peer 0/1 then closes with
+
380 // an 80% quorum of agreeing positions (5/6) match.
+
381 //
+
382 // Peers 2-5 do not change position, since tx 0 or tx 1
+
383 // have less than the 50% initial threshold. They also
+
384 // cannot declare consensus, since 4/6 agreeing
+
385 // positions are < 80% threshold. They therefore need an
+
386 // additional timerEntry call to see the updated
+
387 // positions from Peer 0 & 1.
+
388
+
389 if (isParticipant)
+
390 {
+
391 BEAST_EXPECT(
+
392 peer->prevProposers == network.size() - 1);
+
393 BEAST_EXPECT(
+
394 peer->prevRoundTime > slowPeer->prevRoundTime);
+
395 }
+
396 else
+
397 {
+
398 BEAST_EXPECT(
+
399 peer->prevProposers == fast.size() - 1);
+
400 // so all peers should have closed together
+
401 BEAST_EXPECT(
+
402 peer->prevRoundTime == slowPeer->prevRoundTime);
+
403 }
+
404 }
+
405 }
+
406 }
+
407 }
+
408 }
+
409
+
410 void
+
411 testCloseTimeDisagree()
+
412 {
+
413 using namespace csf;
+
414 using namespace std::chrono;
+
415 testcase("close time disagree");
+
416
+
417 // This is a very specialized test to get ledgers to disagree on
+
418 // the close time. It unfortunately assumes knowledge about current
+
419 // timing constants. This is a necessary evil to get coverage up
+
420 // pending more extensive refactorings of timing constants.
+
421
+
422 // In order to agree-to-disagree on the close time, there must be no
+
423 // clear majority of nodes agreeing on a close time. This test
+
424 // sets a relative offset to the peers internal clocks so that they
+
425 // send proposals with differing times.
+
426
+
427 // However, agreement is on the effective close time, not the
+
428 // exact close time. The minimum closeTimeResolution is given by
+
429 // ledgerPossibleTimeResolutions[0], which is currently 10s. This means
+
430 // the skews need to be at least 10 seconds to have different effective
+
431 // close times.
+
432
+
433 // Complicating this matter is that nodes will ignore proposals
+
434 // with times more than proposeFRESHNESS =20s in the past. So at
+
435 // the minimum granularity, we have at most 3 types of skews
+
436 // (0s,10s,20s).
+
437
+
438 // This test therefore has 6 nodes, with 2 nodes having each type of
+
439 // skew. Then no majority (1/3 < 1/2) of nodes will agree on an
+
440 // actual close time.
+
441
+
442 ConsensusParms const parms{};
+
443 Sim sim;
+
444
+
445 PeerGroup groupA = sim.createGroup(2);
+
446 PeerGroup groupB = sim.createGroup(2);
+
447 PeerGroup groupC = sim.createGroup(2);
+
448 PeerGroup network = groupA + groupB + groupC;
449
-
450 Sim sim;
-
451
-
452 PeerGroup minority = sim.createGroup(2);
-
453 PeerGroup majorityA = sim.createGroup(3);
-
454 PeerGroup majorityB = sim.createGroup(5);
-
455
-
456 PeerGroup majority = majorityA + majorityB;
-
457 PeerGroup network = minority + majority;
-
458
-
459 SimDuration delay =
-
460 round<milliseconds>(0.2 * parms.ledgerGRANULARITY);
-
461 minority.trustAndConnect(minority + majorityA, delay);
-
462 majority.trustAndConnect(majority, delay);
-
463
-
464 CollectByNode<JumpCollector> jumps;
-
465 sim.collectors.add(jumps);
+
450 network.trust(network);
+
451 network.connect(
+
452 network, round<milliseconds>(0.2 * parms.ledgerGRANULARITY));
+
453
+
454 // Run consensus without skew until we have a short close time
+
455 // resolution
+
456 Peer* firstPeer = *groupA.begin();
+
457 while (firstPeer->lastClosedLedger.closeTimeResolution() >=
+
458 parms.proposeFRESHNESS)
+
459 sim.run(1);
+
460
+
461 // Introduce a shift on the time of 2/3 of peers
+
462 for (Peer* peer : groupA)
+
463 peer->clockSkew = parms.proposeFRESHNESS / 2;
+
464 for (Peer* peer : groupB)
+
465 peer->clockSkew = parms.proposeFRESHNESS;
466
-
467 BEAST_EXPECT(sim.trustGraph.canFork(parms.minCONSENSUS_PCT / 100.));
+
467 sim.run(1);
468
-
469 // initial round to set prior state
-
470 sim.run(1);
-
471
-
472 // Nodes in smaller UNL have seen tx 0, nodes in other unl have seen
-
473 // tx 1
-
474 for (Peer* peer : network)
-
475 peer->delays.recvValidation = validationDelay;
-
476 for (Peer* peer : (minority + majorityA))
-
477 peer->openTxs.insert(Tx{0});
-
478 for (Peer* peer : majorityB)
-
479 peer->openTxs.insert(Tx{1});
-
480
-
481 // Run for additional rounds
-
482 // With no validation delay, only 2 more rounds are needed.
-
483 // 1. Round to generate different ledgers
-
484 // 2. Round to detect different prior ledgers (but still generate
-
485 // wrong ones) and recover within that round since wrong LCL
-
486 // is detected before we close
-
487 //
-
488 // With a validation delay of ledgerMIN_CLOSE, we need 3 more
-
489 // rounds.
-
490 // 1. Round to generate different ledgers
-
491 // 2. Round to detect different prior ledgers (but still generate
-
492 // wrong ones) but end up declaring consensus on wrong LCL (but
-
493 // with the right transaction set!). This is because we detect
-
494 // the wrong LCL after we have closed the ledger, so we declare
-
495 // consensus based solely on our peer proposals. But we haven't
-
496 // had time to acquire the right ledger.
-
497 // 3. Round to correct
-
498 sim.run(3);
-
499
-
500 // The network never actually forks, since node 0-1 never see a
-
501 // quorum of validations to fully validate the incorrect chain.
-
502
-
503 // However, for a non zero-validation delay, the network is not
-
504 // synchronized because nodes 0 and 1 are running one ledger behind
-
505 if (BEAST_EXPECT(sim.branches() == 1))
-
506 {
-
507 for (Peer const* peer : majority)
-
508 {
-
509 // No jumps for majority nodes
-
510 BEAST_EXPECT(jumps[peer->id].closeJumps.empty());
-
511 BEAST_EXPECT(jumps[peer->id].fullyValidatedJumps.empty());
-
512 }
-
513 for (Peer const* peer : minority)
-
514 {
-
515 auto& peerJumps = jumps[peer->id];
-
516 // last closed ledger jump between chains
-
517 {
-
518 if (BEAST_EXPECT(peerJumps.closeJumps.size() == 1))
-
519 {
-
520 JumpCollector::Jump const& jump =
-
521 peerJumps.closeJumps.front();
-
522 // Jump is to a different chain
-
523 BEAST_EXPECT(jump.from.seq() <= jump.to.seq());
-
524 BEAST_EXPECT(!jump.to.isAncestor(jump.from));
-
525 }
-
526 }
-
527 // fully validated jump forward in same chain
-
528 {
-
529 if (BEAST_EXPECT(
-
530 peerJumps.fullyValidatedJumps.size() == 1))
-
531 {
-
532 JumpCollector::Jump const& jump =
-
533 peerJumps.fullyValidatedJumps.front();
-
534 // Jump is to a different chain with same seq
-
535 BEAST_EXPECT(jump.from.seq() < jump.to.seq());
-
536 BEAST_EXPECT(jump.to.isAncestor(jump.from));
-
537 }
-
538 }
-
539 }
-
540 }
-
541 }
-
542
-
543 {
-
544 // Additional test engineered to switch LCL during the establish
-
545 // phase. This was added to trigger a scenario that previously
-
546 // crashed, in which switchLCL switched from establish to open
-
547 // phase, but still processed the establish phase logic.
-
548
-
549 // Loner node will accept an initial ledger A, but all other nodes
-
550 // accept ledger B a bit later. By delaying the time it takes
-
551 // to process a validation, loner node will detect the wrongLCL
-
552 // after it is already in the establish phase of the next round.
-
553
-
554 Sim sim;
-
555 PeerGroup loner = sim.createGroup(1);
-
556 PeerGroup friends = sim.createGroup(3);
-
557 loner.trust(loner + friends);
-
558
-
559 PeerGroup others = sim.createGroup(6);
-
560 PeerGroup clique = friends + others;
-
561 clique.trust(clique);
-
562
-
563 PeerGroup network = loner + clique;
-
564 network.connect(
-
565 network, round<milliseconds>(0.2 * parms.ledgerGRANULARITY));
+
469 // All nodes agreed to disagree on the close time
+
470 if (BEAST_EXPECT(sim.synchronized()))
+
471 {
+
472 for (Peer* peer : network)
+
473 BEAST_EXPECT(!peer->lastClosedLedger.closeAgree());
+
474 }
+
475 }
+
476
+
477 void
+
478 testWrongLCL()
+
479 {
+
480 using namespace csf;
+
481 using namespace std::chrono;
+
482 testcase("wrong LCL");
+
483
+
484 // Specialized test to exercise a temporary fork in which some peers
+
485 // are working on an incorrect prior ledger.
+
486
+
487 ConsensusParms const parms{};
+
488
+
489 // Vary the time it takes to process validations to exercise detecting
+
490 // the wrong LCL at different phases of consensus
+
491 for (auto validationDelay : {0ms, parms.ledgerMIN_CLOSE})
+
492 {
+
493 // Consider 10 peers:
+
494 // 0 1 2 3 4 5 6 7 8 9
+
495 // minority majorityA majorityB
+
496 //
+
497 // Nodes 0-1 trust nodes 0-4
+
498 // Nodes 2-9 trust nodes 2-9
+
499 //
+
500 // By submitting tx 0 to nodes 0-4 and tx 1 to nodes 5-9,
+
501 // nodes 0-1 will generate the wrong LCL (with tx 0). The remaining
+
502 // nodes will instead accept the ledger with tx 1.
+
503
+
504 // Nodes 0-1 will detect this mismatch during a subsequent round
+
505 // since nodes 2-4 will validate a different ledger.
+
506
+
507 // Nodes 0-1 will acquire the proper ledger from the network and
+
508 // resume consensus and eventually generate the dominant network
+
509 // ledger.
+
510
+
511 // This topology can potentially fork with the above trust relations
+
512 // but that is intended for this test.
+
513
+
514 Sim sim;
+
515
+
516 PeerGroup minority = sim.createGroup(2);
+
517 PeerGroup majorityA = sim.createGroup(3);
+
518 PeerGroup majorityB = sim.createGroup(5);
+
519
+
520 PeerGroup majority = majorityA + majorityB;
+
521 PeerGroup network = minority + majority;
+
522
+
523 SimDuration delay =
+
524 round<milliseconds>(0.2 * parms.ledgerGRANULARITY);
+
525 minority.trustAndConnect(minority + majorityA, delay);
+
526 majority.trustAndConnect(majority, delay);
+
527
+
528 CollectByNode<JumpCollector> jumps;
+
529 sim.collectors.add(jumps);
+
530
+
531 BEAST_EXPECT(sim.trustGraph.canFork(parms.minCONSENSUS_PCT / 100.));
+
532
+
533 // initial round to set prior state
+
534 sim.run(1);
+
535
+
536 // Nodes in smaller UNL have seen tx 0, nodes in other unl have seen
+
537 // tx 1
+
538 for (Peer* peer : network)
+
539 peer->delays.recvValidation = validationDelay;
+
540 for (Peer* peer : (minority + majorityA))
+
541 peer->openTxs.insert(Tx{0});
+
542 for (Peer* peer : majorityB)
+
543 peer->openTxs.insert(Tx{1});
+
544
+
545 // Run for additional rounds
+
546 // With no validation delay, only 2 more rounds are needed.
+
547 // 1. Round to generate different ledgers
+
548 // 2. Round to detect different prior ledgers (but still generate
+
549 // wrong ones) and recover within that round since wrong LCL
+
550 // is detected before we close
+
551 //
+
552 // With a validation delay of ledgerMIN_CLOSE, we need 3 more
+
553 // rounds.
+
554 // 1. Round to generate different ledgers
+
555 // 2. Round to detect different prior ledgers (but still generate
+
556 // wrong ones) but end up declaring consensus on wrong LCL (but
+
557 // with the right transaction set!). This is because we detect
+
558 // the wrong LCL after we have closed the ledger, so we declare
+
559 // consensus based solely on our peer proposals. But we haven't
+
560 // had time to acquire the right ledger.
+
561 // 3. Round to correct
+
562 sim.run(3);
+
563
+
564 // The network never actually forks, since node 0-1 never see a
+
565 // quorum of validations to fully validate the incorrect chain.
566
-
567 // initial round to set prior state
-
568 sim.run(1);
-
569 for (Peer* peer : (loner + friends))
-
570 peer->openTxs.insert(Tx(0));
-
571 for (Peer* peer : others)
-
572 peer->openTxs.insert(Tx(1));
-
573
-
574 // Delay validation processing
-
575 for (Peer* peer : network)
-
576 peer->delays.recvValidation = parms.ledgerGRANULARITY;
-
577
-
578 // additional rounds to generate wrongLCL and recover
-
579 sim.run(2);
-
580
-
581 // Check all peers recovered
-
582 for (Peer* p : network)
-
583 BEAST_EXPECT(p->prevLedgerID() == network[0]->prevLedgerID());
-
584 }
-
585 }
-
586
-
587 void
-
588 testConsensusCloseTimeRounding()
-
589 {
-
590 using namespace csf;
-
591 using namespace std::chrono;
-
592
-
593 // This is a specialized test engineered to yield ledgers with different
-
594 // close times even though the peers believe they had close time
-
595 // consensus on the ledger.
-
596 ConsensusParms parms;
-
597
-
598 Sim sim;
-
599
-
600 // This requires a group of 4 fast and 2 slow peers to create a
-
601 // situation in which a subset of peers requires seeing additional
-
602 // proposals to declare consensus.
-
603 PeerGroup slow = sim.createGroup(2);
-
604 PeerGroup fast = sim.createGroup(4);
-
605 PeerGroup network = fast + slow;
+
567 // However, for a non zero-validation delay, the network is not
+
568 // synchronized because nodes 0 and 1 are running one ledger behind
+
569 if (BEAST_EXPECT(sim.branches() == 1))
+
570 {
+
571 for (Peer const* peer : majority)
+
572 {
+
573 // No jumps for majority nodes
+
574 BEAST_EXPECT(jumps[peer->id].closeJumps.empty());
+
575 BEAST_EXPECT(jumps[peer->id].fullyValidatedJumps.empty());
+
576 }
+
577 for (Peer const* peer : minority)
+
578 {
+
579 auto& peerJumps = jumps[peer->id];
+
580 // last closed ledger jump between chains
+
581 {
+
582 if (BEAST_EXPECT(peerJumps.closeJumps.size() == 1))
+
583 {
+
584 JumpCollector::Jump const& jump =
+
585 peerJumps.closeJumps.front();
+
586 // Jump is to a different chain
+
587 BEAST_EXPECT(jump.from.seq() <= jump.to.seq());
+
588 BEAST_EXPECT(!jump.to.isAncestor(jump.from));
+
589 }
+
590 }
+
591 // fully validated jump forward in same chain
+
592 {
+
593 if (BEAST_EXPECT(
+
594 peerJumps.fullyValidatedJumps.size() == 1))
+
595 {
+
596 JumpCollector::Jump const& jump =
+
597 peerJumps.fullyValidatedJumps.front();
+
598 // Jump is to a different chain with same seq
+
599 BEAST_EXPECT(jump.from.seq() < jump.to.seq());
+
600 BEAST_EXPECT(jump.to.isAncestor(jump.from));
+
601 }
+
602 }
+
603 }
+
604 }
+
605 }
606
-
607 for (Peer* peer : network)
-
608 peer->consensusParms = parms;
-
609
-
610 // Connected trust graph
-
611 network.trust(network);
+
607 {
+
608 // Additional test engineered to switch LCL during the establish
+
609 // phase. This was added to trigger a scenario that previously
+
610 // crashed, in which switchLCL switched from establish to open
+
611 // phase, but still processed the establish phase logic.
612
-
613 // Fast and slow network connections
-
614 fast.connect(fast, round<milliseconds>(0.2 * parms.ledgerGRANULARITY));
-
615 slow.connect(
-
616 network, round<milliseconds>(1.1 * parms.ledgerGRANULARITY));
+
613 // Loner node will accept an initial ledger A, but all other nodes
+
614 // accept ledger B a bit later. By delaying the time it takes
+
615 // to process a validation, loner node will detect the wrongLCL
+
616 // after it is already in the establish phase of the next round.
617
-
618 // Run to the ledger *prior* to decreasing the resolution
-
619 sim.run(increaseLedgerTimeResolutionEvery - 2);
-
620
-
621 // In order to create the discrepency, we want a case where if
-
622 // X = effCloseTime(closeTime, resolution, parentCloseTime)
-
623 // X != effCloseTime(X, resolution, parentCloseTime)
-
624 //
-
625 // That is, the effective close time is not a fixed point. This can
-
626 // happen if X = parentCloseTime + 1, but a subsequent rounding goes
-
627 // to the next highest multiple of resolution.
-
628
-
629 // So we want to find an offset (now + offset) % 30s = 15
-
630 // (now + offset) % 20s = 15
-
631 // This way, the next ledger will close and round up Due to the
-
632 // network delay settings, the round of consensus will take 5s, so
-
633 // the next ledger's close time will
-
634
-
635 NetClock::duration when = network[0]->now().time_since_epoch();
-
636
-
637 // Check we are before the 30s to 20s transition
-
638 NetClock::duration resolution =
-
639 network[0]->lastClosedLedger.closeTimeResolution();
-
640 BEAST_EXPECT(resolution == NetClock::duration{30s});
+
618 Sim sim;
+
619 PeerGroup loner = sim.createGroup(1);
+
620 PeerGroup friends = sim.createGroup(3);
+
621 loner.trust(loner + friends);
+
622
+
623 PeerGroup others = sim.createGroup(6);
+
624 PeerGroup clique = friends + others;
+
625 clique.trust(clique);
+
626
+
627 PeerGroup network = loner + clique;
+
628 network.connect(
+
629 network, round<milliseconds>(0.2 * parms.ledgerGRANULARITY));
+
630
+
631 // initial round to set prior state
+
632 sim.run(1);
+
633 for (Peer* peer : (loner + friends))
+
634 peer->openTxs.insert(Tx(0));
+
635 for (Peer* peer : others)
+
636 peer->openTxs.insert(Tx(1));
+
637
+
638 // Delay validation processing
+
639 for (Peer* peer : network)
+
640 peer->delays.recvValidation = parms.ledgerGRANULARITY;
641
-
642 while (((when % NetClock::duration{30s}) != NetClock::duration{15s}) ||
-
643 ((when % NetClock::duration{20s}) != NetClock::duration{15s}))
-
644 when += 1s;
-
645 // Advance the clock without consensus running (IS THIS WHAT
-
646 // PREVENTS IT IN PRACTICE?)
-
647 sim.scheduler.step_for(NetClock::time_point{when} - network[0]->now());
-
648
-
649 // Run one more ledger with 30s resolution
-
650 sim.run(1);
-
651 if (BEAST_EXPECT(sim.synchronized()))
-
652 {
-
653 // close time should be ahead of clock time since we engineered
-
654 // the close time to round up
-
655 for (Peer* peer : network)
-
656 {
-
657 BEAST_EXPECT(peer->lastClosedLedger.closeTime() > peer->now());
-
658 BEAST_EXPECT(peer->lastClosedLedger.closeAgree());
-
659 }
-
660 }
-
661
-
662 // All peers submit their own ID as a transaction
-
663 for (Peer* peer : network)
-
664 peer->submit(Tx{static_cast<std::uint32_t>(peer->id)});
-
665
-
666 // Run 1 more round, this time it will have a decreased
-
667 // resolution of 20 seconds.
-
668
-
669 // The network delays are engineered so that the slow peers
-
670 // initially have the wrong tx hash, but they see a majority
-
671 // of agreement from their peers and declare consensus
-
672 //
-
673 // The trick is that everyone starts with a raw close time of
-
674 // 84681s
-
675 // Which has
-
676 // effCloseTime(86481s, 20s, 86490s) = 86491s
-
677 // However, when the slow peers update their position, they change
-
678 // the close time to 86451s. The fast peers declare consensus with
-
679 // the 86481s as their position still.
-
680 //
-
681 // When accepted the ledger
-
682 // - fast peers use eff(86481s) -> 86491s as the close time
-
683 // - slow peers use eff(eff(86481s)) -> eff(86491s) -> 86500s!
-
684
-
685 sim.run(1);
-
686
-
687 BEAST_EXPECT(sim.synchronized());
-
688 }
-
689
-
690 void
-
691 testFork()
-
692 {
-
693 using namespace csf;
-
694 using namespace std::chrono;
-
695
-
696 std::uint32_t numPeers = 10;
-
697 // Vary overlap between two UNLs
-
698 for (std::uint32_t overlap = 0; overlap <= numPeers; ++overlap)
-
699 {
-
700 ConsensusParms const parms{};
-
701 Sim sim;
-
702
-
703 std::uint32_t numA = (numPeers - overlap) / 2;
-
704 std::uint32_t numB = numPeers - numA - overlap;
-
705
-
706 PeerGroup aOnly = sim.createGroup(numA);
-
707 PeerGroup bOnly = sim.createGroup(numB);
-
708 PeerGroup commonOnly = sim.createGroup(overlap);
-
709
-
710 PeerGroup a = aOnly + commonOnly;
-
711 PeerGroup b = bOnly + commonOnly;
-
712
-
713 PeerGroup network = a + b;
-
714
-
715 SimDuration delay =
-
716 round<milliseconds>(0.2 * parms.ledgerGRANULARITY);
-
717 a.trustAndConnect(a, delay);
-
718 b.trustAndConnect(b, delay);
-
719
-
720 // Initial round to set prior state
-
721 sim.run(1);
-
722 for (Peer* peer : network)
-
723 {
-
724 // Nodes have only seen transactions from their neighbors
-
725 peer->openTxs.insert(Tx{static_cast<std::uint32_t>(peer->id)});
-
726 for (Peer* to : sim.trustGraph.trustedPeers(peer))
-
727 peer->openTxs.insert(
-
728 Tx{static_cast<std::uint32_t>(to->id)});
-
729 }
-
730 sim.run(1);
-
731
-
732 // Fork should not happen for 40% or greater overlap
-
733 // Since the overlapped nodes have a UNL that is the union of the
-
734 // two cliques, the maximum sized UNL list is the number of peers
-
735 if (overlap > 0.4 * numPeers)
-
736 BEAST_EXPECT(sim.synchronized());
-
737 else
-
738 {
-
739 // Even if we do fork, there shouldn't be more than 3 ledgers
-
740 // One for cliqueA, one for cliqueB and one for nodes in both
-
741 BEAST_EXPECT(sim.branches() <= 3);
-
742 }
-
743 }
-
744 }
-
745
-
746 void
-
747 testHubNetwork()
-
748 {
-
749 using namespace csf;
-
750 using namespace std::chrono;
+
642 // additional rounds to generate wrongLCL and recover
+
643 sim.run(2);
+
644
+
645 // Check all peers recovered
+
646 for (Peer* p : network)
+
647 BEAST_EXPECT(p->prevLedgerID() == network[0]->prevLedgerID());
+
648 }
+
649 }
+
650
+
651 void
+
652 testConsensusCloseTimeRounding()
+
653 {
+
654 using namespace csf;
+
655 using namespace std::chrono;
+
656 testcase("consensus close time rounding");
+
657
+
658 // This is a specialized test engineered to yield ledgers with different
+
659 // close times even though the peers believe they had close time
+
660 // consensus on the ledger.
+
661 ConsensusParms parms;
+
662
+
663 Sim sim;
+
664
+
665 // This requires a group of 4 fast and 2 slow peers to create a
+
666 // situation in which a subset of peers requires seeing additional
+
667 // proposals to declare consensus.
+
668 PeerGroup slow = sim.createGroup(2);
+
669 PeerGroup fast = sim.createGroup(4);
+
670 PeerGroup network = fast + slow;
+
671
+
672 // Connected trust graph
+
673 network.trust(network);
+
674
+
675 // Fast and slow network connections
+
676 fast.connect(fast, round<milliseconds>(0.2 * parms.ledgerGRANULARITY));
+
677 slow.connect(
+
678 network, round<milliseconds>(1.1 * parms.ledgerGRANULARITY));
+
679
+
680 // Run to the ledger *prior* to decreasing the resolution
+
681 sim.run(increaseLedgerTimeResolutionEvery - 2);
+
682
+
683 // In order to create the discrepency, we want a case where if
+
684 // X = effCloseTime(closeTime, resolution, parentCloseTime)
+
685 // X != effCloseTime(X, resolution, parentCloseTime)
+
686 //
+
687 // That is, the effective close time is not a fixed point. This can
+
688 // happen if X = parentCloseTime + 1, but a subsequent rounding goes
+
689 // to the next highest multiple of resolution.
+
690
+
691 // So we want to find an offset (now + offset) % 30s = 15
+
692 // (now + offset) % 20s = 15
+
693 // This way, the next ledger will close and round up Due to the
+
694 // network delay settings, the round of consensus will take 5s, so
+
695 // the next ledger's close time will
+
696
+
697 NetClock::duration when = network[0]->now().time_since_epoch();
+
698
+
699 // Check we are before the 30s to 20s transition
+
700 NetClock::duration resolution =
+
701 network[0]->lastClosedLedger.closeTimeResolution();
+
702 BEAST_EXPECT(resolution == NetClock::duration{30s});
+
703
+
704 while (((when % NetClock::duration{30s}) != NetClock::duration{15s}) ||
+
705 ((when % NetClock::duration{20s}) != NetClock::duration{15s}))
+
706 when += 1s;
+
707 // Advance the clock without consensus running (IS THIS WHAT
+
708 // PREVENTS IT IN PRACTICE?)
+
709 sim.scheduler.step_for(NetClock::time_point{when} - network[0]->now());
+
710
+
711 // Run one more ledger with 30s resolution
+
712 sim.run(1);
+
713 if (BEAST_EXPECT(sim.synchronized()))
+
714 {
+
715 // close time should be ahead of clock time since we engineered
+
716 // the close time to round up
+
717 for (Peer* peer : network)
+
718 {
+
719 BEAST_EXPECT(peer->lastClosedLedger.closeTime() > peer->now());
+
720 BEAST_EXPECT(peer->lastClosedLedger.closeAgree());
+
721 }
+
722 }
+
723
+
724 // All peers submit their own ID as a transaction
+
725 for (Peer* peer : network)
+
726 peer->submit(Tx{static_cast<std::uint32_t>(peer->id)});
+
727
+
728 // Run 1 more round, this time it will have a decreased
+
729 // resolution of 20 seconds.
+
730
+
731 // The network delays are engineered so that the slow peers
+
732 // initially have the wrong tx hash, but they see a majority
+
733 // of agreement from their peers and declare consensus
+
734 //
+
735 // The trick is that everyone starts with a raw close time of
+
736 // 84681s
+
737 // Which has
+
738 // effCloseTime(86481s, 20s, 86490s) = 86491s
+
739 // However, when the slow peers update their position, they change
+
740 // the close time to 86451s. The fast peers declare consensus with
+
741 // the 86481s as their position still.
+
742 //
+
743 // When accepted the ledger
+
744 // - fast peers use eff(86481s) -> 86491s as the close time
+
745 // - slow peers use eff(eff(86481s)) -> eff(86491s) -> 86500s!
+
746
+
747 sim.run(1);
+
748
+
749 BEAST_EXPECT(sim.synchronized());
+
750 }
751
-
752 // Simulate a set of 5 validators that aren't directly connected but
-
753 // rely on a single hub node for communication
-
754
-
755 ConsensusParms const parms{};
-
756 Sim sim;
-
757 PeerGroup validators = sim.createGroup(5);
-
758 PeerGroup center = sim.createGroup(1);
-
759 validators.trust(validators);
-
760 center.trust(validators);
-
761
-
762 SimDuration delay = round<milliseconds>(0.2 * parms.ledgerGRANULARITY);
-
763 validators.connect(center, delay);
-
764
-
765 center[0]->runAsValidator = false;
-
766
-
767 // prep round to set initial state.
-
768 sim.run(1);
-
769
-
770 // everyone submits their own ID as a TX and relay it to peers
-
771 for (Peer* p : validators)
-
772 p->submit(Tx(static_cast<std::uint32_t>(p->id)));
-
773
-
774 sim.run(1);
+
752 void
+
753 testFork()
+
754 {
+
755 using namespace csf;
+
756 using namespace std::chrono;
+
757 testcase("fork");
+
758
+
759 std::uint32_t numPeers = 10;
+
760 // Vary overlap between two UNLs
+
761 for (std::uint32_t overlap = 0; overlap <= numPeers; ++overlap)
+
762 {
+
763 ConsensusParms const parms{};
+
764 Sim sim;
+
765
+
766 std::uint32_t numA = (numPeers - overlap) / 2;
+
767 std::uint32_t numB = numPeers - numA - overlap;
+
768
+
769 PeerGroup aOnly = sim.createGroup(numA);
+
770 PeerGroup bOnly = sim.createGroup(numB);
+
771 PeerGroup commonOnly = sim.createGroup(overlap);
+
772
+
773 PeerGroup a = aOnly + commonOnly;
+
774 PeerGroup b = bOnly + commonOnly;
775
-
776 // All peers are in sync
-
777 BEAST_EXPECT(sim.synchronized());
-
778 }
-
779
-
780 // Helper collector for testPreferredByBranch
-
781 // Invasively disconnects network at bad times to cause splits
-
782 struct Disruptor
-
783 {
-
784 csf::PeerGroup& network;
-
785 csf::PeerGroup& groupCfast;
-
786 csf::PeerGroup& groupCsplit;
-
787 csf::SimDuration delay;
-
788 bool reconnected = false;
-
789
-
790 Disruptor(
-
791 csf::PeerGroup& net,
-
792 csf::PeerGroup& c,
-
793 csf::PeerGroup& split,
-
794 csf::SimDuration d)
-
795 : network(net), groupCfast(c), groupCsplit(split), delay(d)
-
796 {
-
797 }
-
798
-
799 template <class E>
-
800 void
-
801 on(csf::PeerID, csf::SimTime, E const&)
-
802 {
-
803 }
-
804
-
805 void
-
806 on(csf::PeerID who, csf::SimTime, csf::FullyValidateLedger const& e)
-
807 {
-
808 using namespace std::chrono;
-
809 // As soon as the fastC node fully validates C, disconnect
-
810 // ALL c nodes from the network. The fast C node needs to disconnect
-
811 // as well to prevent it from relaying the validations it did see
-
812 if (who == groupCfast[0]->id &&
-
813 e.ledger.seq() == csf::Ledger::Seq{2})
-
814 {
-
815 network.disconnect(groupCsplit);
-
816 network.disconnect(groupCfast);
-
817 }
-
818 }
-
819
-
820 void
-
821 on(csf::PeerID who, csf::SimTime, csf::AcceptLedger const& e)
-
822 {
-
823 // As soon as anyone generates a child of B or C, reconnect the
-
824 // network so those validations make it through
-
825 if (!reconnected && e.ledger.seq() == csf::Ledger::Seq{3})
-
826 {
-
827 reconnected = true;
-
828 network.connect(groupCsplit, delay);
-
829 }
-
830 }
-
831 };
-
832
-
833 void
-
834 testPreferredByBranch()
-
835 {
-
836 using namespace csf;
-
837 using namespace std::chrono;
-
838
-
839 // Simulate network splits that are prevented from forking when using
-
840 // preferred ledger by trie. This is a contrived example that involves
-
841 // excessive network splits, but demonstrates the safety improvement
-
842 // from the preferred ledger by trie approach.
+
776 PeerGroup network = a + b;
+
777
+
778 SimDuration delay =
+
779 round<milliseconds>(0.2 * parms.ledgerGRANULARITY);
+
780 a.trustAndConnect(a, delay);
+
781 b.trustAndConnect(b, delay);
+
782
+
783 // Initial round to set prior state
+
784 sim.run(1);
+
785 for (Peer* peer : network)
+
786 {
+
787 // Nodes have only seen transactions from their neighbors
+
788 peer->openTxs.insert(Tx{static_cast<std::uint32_t>(peer->id)});
+
789 for (Peer* to : sim.trustGraph.trustedPeers(peer))
+
790 peer->openTxs.insert(
+
791 Tx{static_cast<std::uint32_t>(to->id)});
+
792 }
+
793 sim.run(1);
+
794
+
795 // Fork should not happen for 40% or greater overlap
+
796 // Since the overlapped nodes have a UNL that is the union of the
+
797 // two cliques, the maximum sized UNL list is the number of peers
+
798 if (overlap > 0.4 * numPeers)
+
799 BEAST_EXPECT(sim.synchronized());
+
800 else
+
801 {
+
802 // Even if we do fork, there shouldn't be more than 3 ledgers
+
803 // One for cliqueA, one for cliqueB and one for nodes in both
+
804 BEAST_EXPECT(sim.branches() <= 3);
+
805 }
+
806 }
+
807 }
+
808
+
809 void
+
810 testHubNetwork()
+
811 {
+
812 using namespace csf;
+
813 using namespace std::chrono;
+
814 testcase("hub network");
+
815
+
816 // Simulate a set of 5 validators that aren't directly connected but
+
817 // rely on a single hub node for communication
+
818
+
819 ConsensusParms const parms{};
+
820 Sim sim;
+
821 PeerGroup validators = sim.createGroup(5);
+
822 PeerGroup center = sim.createGroup(1);
+
823 validators.trust(validators);
+
824 center.trust(validators);
+
825
+
826 SimDuration delay = round<milliseconds>(0.2 * parms.ledgerGRANULARITY);
+
827 validators.connect(center, delay);
+
828
+
829 center[0]->runAsValidator = false;
+
830
+
831 // prep round to set initial state.
+
832 sim.run(1);
+
833
+
834 // everyone submits their own ID as a TX and relay it to peers
+
835 for (Peer* p : validators)
+
836 p->submit(Tx(static_cast<std::uint32_t>(p->id)));
+
837
+
838 sim.run(1);
+
839
+
840 // All peers are in sync
+
841 BEAST_EXPECT(sim.synchronized());
+
842 }
843
-
844 // Consider 10 validating nodes that comprise a single common UNL
-
845 // Ledger history:
-
846 // 1: A
-
847 // _/ \_
-
848 // 2: B C
-
849 // _/ _/ \_
-
850 // 3: D C' |||||||| (8 different ledgers)
-
851
-
852 // - All nodes generate the common ledger A
-
853 // - 2 nodes generate B and 8 nodes generate C
-
854 // - Only 1 of the C nodes sees all the C validations and fully
-
855 // validates C. The rest of the C nodes split at just the right time
-
856 // such that they never see any C validations but their own.
-
857 // - The C nodes continue and generate 8 different child ledgers.
-
858 // - Meanwhile, the D nodes only saw 1 validation for C and 2
-
859 // validations
-
860 // for B.
-
861 // - The network reconnects and the validations for generation 3 ledgers
-
862 // are observed (D and the 8 C's)
-
863 // - In the old approach, 2 votes for D outweights 1 vote for each C'
-
864 // so the network would avalanche towards D and fully validate it
-
865 // EVEN though C was fully validated by one node
-
866 // - In the new approach, 2 votes for D are not enough to outweight the
-
867 // 8 implicit votes for C, so nodes will avalanche to C instead
+
844 // Helper collector for testPreferredByBranch
+
845 // Invasively disconnects network at bad times to cause splits
+
846 struct Disruptor
+
847 {
+
848 csf::PeerGroup& network;
+
849 csf::PeerGroup& groupCfast;
+
850 csf::PeerGroup& groupCsplit;
+
851 csf::SimDuration delay;
+
852 bool reconnected = false;
+
853
+
854 Disruptor(
+
855 csf::PeerGroup& net,
+
856 csf::PeerGroup& c,
+
857 csf::PeerGroup& split,
+
858 csf::SimDuration d)
+
859 : network(net), groupCfast(c), groupCsplit(split), delay(d)
+
860 {
+
861 }
+
862
+
863 template <class E>
+
864 void
+
865 on(csf::PeerID, csf::SimTime, E const&)
+
866 {
+
867 }
868
-
869 ConsensusParms const parms{};
-
870 Sim sim;
-
871
-
872 // Goes A->B->D
-
873 PeerGroup groupABD = sim.createGroup(2);
-
874 // Single node that initially fully validates C before the split
-
875 PeerGroup groupCfast = sim.createGroup(1);
-
876 // Generates C, but fails to fully validate before the split
-
877 PeerGroup groupCsplit = sim.createGroup(7);
-
878
-
879 PeerGroup groupNotFastC = groupABD + groupCsplit;
-
880 PeerGroup network = groupABD + groupCsplit + groupCfast;
-
881
-
882 SimDuration delay = round<milliseconds>(0.2 * parms.ledgerGRANULARITY);
-
883 SimDuration fDelay = round<milliseconds>(0.1 * parms.ledgerGRANULARITY);
-
884
-
885 network.trust(network);
-
886 // C must have a shorter delay to see all the validations before the
-
887 // other nodes
-
888 network.connect(groupCfast, fDelay);
-
889 // The rest of the network is connected at the same speed
-
890 groupNotFastC.connect(groupNotFastC, delay);
-
891
-
892 Disruptor dc(network, groupCfast, groupCsplit, delay);
-
893 sim.collectors.add(dc);
-
894
-
895 // Consensus round to generate ledger A
-
896 sim.run(1);
-
897 BEAST_EXPECT(sim.synchronized());
-
898
-
899 // Next round generates B and C
-
900 // To force B, we inject an extra transaction in to those nodes
-
901 for (Peer* peer : groupABD)
-
902 {
-
903 peer->txInjections.emplace(peer->lastClosedLedger.seq(), Tx{42});
-
904 }
-
905 // The Disruptor will ensure that nodes disconnect before the C
-
906 // validations make it to all but the fastC node
-
907 sim.run(1);
+
869 void
+
870 on(csf::PeerID who, csf::SimTime, csf::FullyValidateLedger const& e)
+
871 {
+
872 using namespace std::chrono;
+
873 // As soon as the fastC node fully validates C, disconnect
+
874 // ALL c nodes from the network. The fast C node needs to disconnect
+
875 // as well to prevent it from relaying the validations it did see
+
876 if (who == groupCfast[0]->id &&
+
877 e.ledger.seq() == csf::Ledger::Seq{2})
+
878 {
+
879 network.disconnect(groupCsplit);
+
880 network.disconnect(groupCfast);
+
881 }
+
882 }
+
883
+
884 void
+
885 on(csf::PeerID who, csf::SimTime, csf::AcceptLedger const& e)
+
886 {
+
887 // As soon as anyone generates a child of B or C, reconnect the
+
888 // network so those validations make it through
+
889 if (!reconnected && e.ledger.seq() == csf::Ledger::Seq{3})
+
890 {
+
891 reconnected = true;
+
892 network.connect(groupCsplit, delay);
+
893 }
+
894 }
+
895 };
+
896
+
897 void
+
898 testPreferredByBranch()
+
899 {
+
900 using namespace csf;
+
901 using namespace std::chrono;
+
902 testcase("preferred by branch");
+
903
+
904 // Simulate network splits that are prevented from forking when using
+
905 // preferred ledger by trie. This is a contrived example that involves
+
906 // excessive network splits, but demonstrates the safety improvement
+
907 // from the preferred ledger by trie approach.
908
-
909 // We are no longer in sync, but have not yet forked:
-
910 // 9 nodes consider A the last fully validated ledger and fastC sees C
-
911 BEAST_EXPECT(!sim.synchronized());
-
912 BEAST_EXPECT(sim.branches() == 1);
-
913
-
914 // Run another round to generate the 8 different C' ledgers
-
915 for (Peer* p : network)
-
916 p->submit(Tx(static_cast<std::uint32_t>(p->id)));
-
917 sim.run(1);
-
918
-
919 // Still not forked
-
920 BEAST_EXPECT(!sim.synchronized());
-
921 BEAST_EXPECT(sim.branches() == 1);
-
922
-
923 // Disruptor will reconnect all but the fastC node
-
924 sim.run(1);
-
925
-
926 if (BEAST_EXPECT(sim.branches() == 1))
-
927 {
-
928 BEAST_EXPECT(sim.synchronized());
-
929 }
-
930 else // old approach caused a fork
-
931 {
-
932 BEAST_EXPECT(sim.branches(groupNotFastC) == 1);
-
933 BEAST_EXPECT(sim.synchronized(groupNotFastC) == 1);
-
934 }
-
935 }
+
909 // Consider 10 validating nodes that comprise a single common UNL
+
910 // Ledger history:
+
911 // 1: A
+
912 // _/ \_
+
913 // 2: B C
+
914 // _/ _/ \_
+
915 // 3: D C' |||||||| (8 different ledgers)
+
916
+
917 // - All nodes generate the common ledger A
+
918 // - 2 nodes generate B and 8 nodes generate C
+
919 // - Only 1 of the C nodes sees all the C validations and fully
+
920 // validates C. The rest of the C nodes split at just the right time
+
921 // such that they never see any C validations but their own.
+
922 // - The C nodes continue and generate 8 different child ledgers.
+
923 // - Meanwhile, the D nodes only saw 1 validation for C and 2
+
924 // validations
+
925 // for B.
+
926 // - The network reconnects and the validations for generation 3 ledgers
+
927 // are observed (D and the 8 C's)
+
928 // - In the old approach, 2 votes for D outweights 1 vote for each C'
+
929 // so the network would avalanche towards D and fully validate it
+
930 // EVEN though C was fully validated by one node
+
931 // - In the new approach, 2 votes for D are not enough to outweight the
+
932 // 8 implicit votes for C, so nodes will avalanche to C instead
+
933
+
934 ConsensusParms const parms{};
+
935 Sim sim;
936
-
937 // Helper collector for testPauseForLaggards
-
938 // This will remove the ledgerAccept delay used to
-
939 // initially create the slow vs. fast validator groups.
-
940 struct UndoDelay
-
941 {
-
942 csf::PeerGroup& g;
+
937 // Goes A->B->D
+
938 PeerGroup groupABD = sim.createGroup(2);
+
939 // Single node that initially fully validates C before the split
+
940 PeerGroup groupCfast = sim.createGroup(1);
+
941 // Generates C, but fails to fully validate before the split
+
942 PeerGroup groupCsplit = sim.createGroup(7);
943
-
944 UndoDelay(csf::PeerGroup& a) : g(a)
-
945 {
-
946 }
-
947
-
948 template <class E>
-
949 void
-
950 on(csf::PeerID, csf::SimTime, E const&)
-
951 {
-
952 }
-
953
-
954 void
-
955 on(csf::PeerID who, csf::SimTime, csf::AcceptLedger const& e)
-
956 {
-
957 for (csf::Peer* p : g)
-
958 {
-
959 if (p->id == who)
-
960 p->delays.ledgerAccept = std::chrono::seconds{0};
-
961 }
-
962 }
-
963 };
-
964
-
965 void
-
966 testPauseForLaggards()
-
967 {
-
968 using namespace csf;
-
969 using namespace std::chrono;
-
970
-
971 // Test that validators that jump ahead of the network slow
-
972 // down.
+
944 PeerGroup groupNotFastC = groupABD + groupCsplit;
+
945 PeerGroup network = groupABD + groupCsplit + groupCfast;
+
946
+
947 SimDuration delay = round<milliseconds>(0.2 * parms.ledgerGRANULARITY);
+
948 SimDuration fDelay = round<milliseconds>(0.1 * parms.ledgerGRANULARITY);
+
949
+
950 network.trust(network);
+
951 // C must have a shorter delay to see all the validations before the
+
952 // other nodes
+
953 network.connect(groupCfast, fDelay);
+
954 // The rest of the network is connected at the same speed
+
955 groupNotFastC.connect(groupNotFastC, delay);
+
956
+
957 Disruptor dc(network, groupCfast, groupCsplit, delay);
+
958 sim.collectors.add(dc);
+
959
+
960 // Consensus round to generate ledger A
+
961 sim.run(1);
+
962 BEAST_EXPECT(sim.synchronized());
+
963
+
964 // Next round generates B and C
+
965 // To force B, we inject an extra transaction in to those nodes
+
966 for (Peer* peer : groupABD)
+
967 {
+
968 peer->txInjections.emplace(peer->lastClosedLedger.seq(), Tx{42});
+
969 }
+
970 // The Disruptor will ensure that nodes disconnect before the C
+
971 // validations make it to all but the fastC node
+
972 sim.run(1);
973
-
974 // We engineer the following validated ledger history scenario:
-
975 //
-
976 // / --> B1 --> C1 --> ... -> G1 "ahead"
-
977 // A
-
978 // \ --> B2 --> C2 "behind"
-
979 //
-
980 // After validating a common ledger A, a set of "behind" validators
-
981 // briefly run slower and validate the lower chain of ledgers.
-
982 // The "ahead" validators run normal speed and run ahead validating the
-
983 // upper chain of ledgers.
-
984 //
-
985 // Due to the uncommited support definition of the preferred branch
-
986 // protocol, even if the "behind" validators are a majority, the "ahead"
-
987 // validators cannot jump to the proper branch until the "behind"
-
988 // validators catch up to the same sequence number. For this test to
-
989 // succeed, the ahead validators need to briefly slow down consensus.
+
974 // We are no longer in sync, but have not yet forked:
+
975 // 9 nodes consider A the last fully validated ledger and fastC sees C
+
976 BEAST_EXPECT(!sim.synchronized());
+
977 BEAST_EXPECT(sim.branches() == 1);
+
978
+
979 // Run another round to generate the 8 different C' ledgers
+
980 for (Peer* p : network)
+
981 p->submit(Tx(static_cast<std::uint32_t>(p->id)));
+
982 sim.run(1);
+
983
+
984 // Still not forked
+
985 BEAST_EXPECT(!sim.synchronized());
+
986 BEAST_EXPECT(sim.branches() == 1);
+
987
+
988 // Disruptor will reconnect all but the fastC node
+
989 sim.run(1);
990
-
991 ConsensusParms const parms{};
-
992 Sim sim;
-
993 SimDuration delay = round<milliseconds>(0.2 * parms.ledgerGRANULARITY);
-
994
-
995 PeerGroup behind = sim.createGroup(3);
-
996 PeerGroup ahead = sim.createGroup(2);
-
997 PeerGroup network = ahead + behind;
-
998
-
999 hash_set<Peer::NodeKey_t> trustedKeys;
-
1000 for (Peer* p : network)
-
1001 trustedKeys.insert(p->key);
-
1002 for (Peer* p : network)
-
1003 p->trustedKeys = trustedKeys;
-
1004
-
1005 network.trustAndConnect(network, delay);
-
1006
-
1007 // Initial seed round to set prior state
-
1008 sim.run(1);
-
1009
-
1010 // Have the "behind" group initially take a really long time to
-
1011 // accept a ledger after ending deliberation
-
1012 for (Peer* p : behind)
-
1013 p->delays.ledgerAccept = 20s;
-
1014
-
1015 // Use the collector to revert the delay after the single
-
1016 // slow ledger is generated
-
1017 UndoDelay undoDelay{behind};
-
1018 sim.collectors.add(undoDelay);
-
1019
-
1020#if 0
-
1021 // Have all beast::journal output printed to stdout
-
1022 for (Peer* p : network)
-
1023 p->sink.threshold(beast::severities::kAll);
-
1024
-
1025 // Print ledger accept and fully validated events to stdout
-
1026 StreamCollector sc{std::cout};
-
1027 sim.collectors.add(sc);
-
1028#endif
-
1029 // Run the simulation for 100 seconds of simulation time with
-
1030 std::chrono::nanoseconds const simDuration = 100s;
-
1031
-
1032 // Simulate clients submitting 1 tx every 5 seconds to a random
-
1033 // validator
-
1034 Rate const rate{1, 5s};
-
1035 auto peerSelector = makeSelector(
-
1036 network.begin(),
-
1037 network.end(),
-
1038 std::vector<double>(network.size(), 1.),
-
1039 sim.rng);
-
1040 auto txSubmitter = makeSubmitter(
-
1041 ConstantDistribution{rate.inv()},
-
1042 sim.scheduler.now(),
-
1043 sim.scheduler.now() + simDuration,
-
1044 peerSelector,
-
1045 sim.scheduler,
-
1046 sim.rng);
-
1047
-
1048 // Run simulation
-
1049 sim.run(simDuration);
-
1050
-
1051 // Verify that the network recovered
-
1052 BEAST_EXPECT(sim.synchronized());
-
1053 }
-
1054
-
1055 void
-
1056 run() override
-
1057 {
-
1058 testShouldCloseLedger();
-
1059 testCheckConsensus();
+
991 if (BEAST_EXPECT(sim.branches() == 1))
+
992 {
+
993 BEAST_EXPECT(sim.synchronized());
+
994 }
+
995 else // old approach caused a fork
+
996 {
+
997 BEAST_EXPECT(sim.branches(groupNotFastC) == 1);
+
998 BEAST_EXPECT(sim.synchronized(groupNotFastC) == 1);
+
999 }
+
1000 }
+
1001
+
1002 // Helper collector for testPauseForLaggards
+
1003 // This will remove the ledgerAccept delay used to
+
1004 // initially create the slow vs. fast validator groups.
+
1005 struct UndoDelay
+
1006 {
+
1007 csf::PeerGroup& g;
+
1008
+
1009 UndoDelay(csf::PeerGroup& a) : g(a)
+
1010 {
+
1011 }
+
1012
+
1013 template <class E>
+
1014 void
+
1015 on(csf::PeerID, csf::SimTime, E const&)
+
1016 {
+
1017 }
+
1018
+
1019 void
+
1020 on(csf::PeerID who, csf::SimTime, csf::AcceptLedger const& e)
+
1021 {
+
1022 for (csf::Peer* p : g)
+
1023 {
+
1024 if (p->id == who)
+
1025 p->delays.ledgerAccept = std::chrono::seconds{0};
+
1026 }
+
1027 }
+
1028 };
+
1029
+
1030 void
+
1031 testPauseForLaggards()
+
1032 {
+
1033 using namespace csf;
+
1034 using namespace std::chrono;
+
1035 testcase("pause for laggards");
+
1036
+
1037 // Test that validators that jump ahead of the network slow
+
1038 // down.
+
1039
+
1040 // We engineer the following validated ledger history scenario:
+
1041 //
+
1042 // / --> B1 --> C1 --> ... -> G1 "ahead"
+
1043 // A
+
1044 // \ --> B2 --> C2 "behind"
+
1045 //
+
1046 // After validating a common ledger A, a set of "behind" validators
+
1047 // briefly run slower and validate the lower chain of ledgers.
+
1048 // The "ahead" validators run normal speed and run ahead validating the
+
1049 // upper chain of ledgers.
+
1050 //
+
1051 // Due to the uncommited support definition of the preferred branch
+
1052 // protocol, even if the "behind" validators are a majority, the "ahead"
+
1053 // validators cannot jump to the proper branch until the "behind"
+
1054 // validators catch up to the same sequence number. For this test to
+
1055 // succeed, the ahead validators need to briefly slow down consensus.
+
1056
+
1057 ConsensusParms const parms{};
+
1058 Sim sim;
+
1059 SimDuration delay = round<milliseconds>(0.2 * parms.ledgerGRANULARITY);
1060
-
1061 testStandalone();
-
1062 testPeersAgree();
-
1063 testSlowPeers();
-
1064 testCloseTimeDisagree();
-
1065 testWrongLCL();
-
1066 testConsensusCloseTimeRounding();
-
1067 testFork();
-
1068 testHubNetwork();
-
1069 testPreferredByBranch();
-
1070 testPauseForLaggards();
-
1071 }
-
1072};
-
1073
-
1074BEAST_DEFINE_TESTSUITE(Consensus, consensus, ripple);
-
1075} // namespace test
-
1076} // namespace ripple
+
1061 PeerGroup behind = sim.createGroup(3);
+
1062 PeerGroup ahead = sim.createGroup(2);
+
1063 PeerGroup network = ahead + behind;
+
1064
+
1065 hash_set<Peer::NodeKey_t> trustedKeys;
+
1066 for (Peer* p : network)
+
1067 trustedKeys.insert(p->key);
+
1068 for (Peer* p : network)
+
1069 p->trustedKeys = trustedKeys;
+
1070
+
1071 network.trustAndConnect(network, delay);
+
1072
+
1073 // Initial seed round to set prior state
+
1074 sim.run(1);
+
1075
+
1076 // Have the "behind" group initially take a really long time to
+
1077 // accept a ledger after ending deliberation
+
1078 for (Peer* p : behind)
+
1079 p->delays.ledgerAccept = 20s;
+
1080
+
1081 // Use the collector to revert the delay after the single
+
1082 // slow ledger is generated
+
1083 UndoDelay undoDelay{behind};
+
1084 sim.collectors.add(undoDelay);
+
1085
+
1086#if 0
+
1087 // Have all beast::journal output printed to stdout
+
1088 for (Peer* p : network)
+
1089 p->sink.threshold(beast::severities::kAll);
+
1090
+
1091 // Print ledger accept and fully validated events to stdout
+
1092 StreamCollector sc{std::cout};
+
1093 sim.collectors.add(sc);
+
1094#endif
+
1095 // Run the simulation for 100 seconds of simulation time with
+
1096 std::chrono::nanoseconds const simDuration = 100s;
+
1097
+
1098 // Simulate clients submitting 1 tx every 5 seconds to a random
+
1099 // validator
+
1100 Rate const rate{1, 5s};
+
1101 auto peerSelector = makeSelector(
+
1102 network.begin(),
+
1103 network.end(),
+
1104 std::vector<double>(network.size(), 1.),
+
1105 sim.rng);
+
1106 auto txSubmitter = makeSubmitter(
+
1107 ConstantDistribution{rate.inv()},
+
1108 sim.scheduler.now(),
+
1109 sim.scheduler.now() + simDuration,
+
1110 peerSelector,
+
1111 sim.scheduler,
+
1112 sim.rng);
+
1113
+
1114 // Run simulation
+
1115 sim.run(simDuration);
+
1116
+
1117 // Verify that the network recovered
+
1118 BEAST_EXPECT(sim.synchronized());
+
1119 }
+
1120
+
1121 void
+
1122 testDisputes()
+
1123 {
+
1124 testcase("disputes");
+
1125
+
1126 using namespace csf;
+
1127
+
1128 // Test dispute objects directly
+
1129 using Dispute = DisputedTx<Tx, PeerID>;
+
1130
+
1131 Tx const txTrue{99};
+
1132 Tx const txFalse{98};
+
1133 Tx const txFollowingTrue{97};
+
1134 Tx const txFollowingFalse{96};
+
1135 int const numPeers = 100;
+
1136 ConsensusParms p;
+
1137 std::size_t peersUnchanged = 0;
+
1138
+
1139 // Three cases:
+
1140 // 1 proposing, initial vote yes
+
1141 // 2 proposing, initial vote no
+
1142 // 3 not proposing, initial vote doesn't matter after the first update,
+
1143 // use yes
+
1144 {
+
1145 Dispute proposingTrue{txTrue.id(), true, numPeers, journal_};
+
1146 Dispute proposingFalse{txFalse.id(), false, numPeers, journal_};
+
1147 Dispute followingTrue{
+
1148 txFollowingTrue.id(), true, numPeers, journal_};
+
1149 Dispute followingFalse{
+
1150 txFollowingFalse.id(), false, numPeers, journal_};
+
1151 BEAST_EXPECT(proposingTrue.ID() == 99);
+
1152 BEAST_EXPECT(proposingFalse.ID() == 98);
+
1153 BEAST_EXPECT(followingTrue.ID() == 97);
+
1154 BEAST_EXPECT(followingFalse.ID() == 96);
+
1155
+
1156 // Create an even split in the peer votes
+
1157 for (int i = 0; i < numPeers; ++i)
+
1158 {
+
1159 BEAST_EXPECT(proposingTrue.setVote(PeerID(i), i < 50));
+
1160 BEAST_EXPECT(proposingFalse.setVote(PeerID(i), i < 50));
+
1161 BEAST_EXPECT(followingTrue.setVote(PeerID(i), i < 50));
+
1162 BEAST_EXPECT(followingFalse.setVote(PeerID(i), i < 50));
+
1163 }
+
1164 // Switch the middle vote to match mine
+
1165 BEAST_EXPECT(proposingTrue.setVote(PeerID(50), true));
+
1166 BEAST_EXPECT(proposingFalse.setVote(PeerID(49), false));
+
1167 BEAST_EXPECT(followingTrue.setVote(PeerID(50), true));
+
1168 BEAST_EXPECT(followingFalse.setVote(PeerID(49), false));
+
1169
+
1170 // no changes yet
+
1171 BEAST_EXPECT(proposingTrue.getOurVote() == true);
+
1172 BEAST_EXPECT(proposingFalse.getOurVote() == false);
+
1173 BEAST_EXPECT(followingTrue.getOurVote() == true);
+
1174 BEAST_EXPECT(followingFalse.getOurVote() == false);
+
1175 BEAST_EXPECT(!proposingTrue.stalled(p, true, peersUnchanged));
+
1176 BEAST_EXPECT(!proposingFalse.stalled(p, true, peersUnchanged));
+
1177 BEAST_EXPECT(!followingTrue.stalled(p, false, peersUnchanged));
+
1178 BEAST_EXPECT(!followingFalse.stalled(p, false, peersUnchanged));
+
1179
+
1180 // I'm in the majority, my vote should not change
+
1181 BEAST_EXPECT(!proposingTrue.updateVote(5, true, p));
+
1182 BEAST_EXPECT(!proposingFalse.updateVote(5, true, p));
+
1183 BEAST_EXPECT(!followingTrue.updateVote(5, false, p));
+
1184 BEAST_EXPECT(!followingFalse.updateVote(5, false, p));
+
1185
+
1186 BEAST_EXPECT(!proposingTrue.updateVote(10, true, p));
+
1187 BEAST_EXPECT(!proposingFalse.updateVote(10, true, p));
+
1188 BEAST_EXPECT(!followingTrue.updateVote(10, false, p));
+
1189 BEAST_EXPECT(!followingFalse.updateVote(10, false, p));
+
1190
+
1191 peersUnchanged = 2;
+
1192 BEAST_EXPECT(!proposingTrue.stalled(p, true, peersUnchanged));
+
1193 BEAST_EXPECT(!proposingFalse.stalled(p, true, peersUnchanged));
+
1194 BEAST_EXPECT(!followingTrue.stalled(p, false, peersUnchanged));
+
1195 BEAST_EXPECT(!followingFalse.stalled(p, false, peersUnchanged));
+
1196
+
1197 // Right now, the vote is 51%. The requirement is about to jump to
+
1198 // 65%
+
1199 BEAST_EXPECT(proposingTrue.updateVote(55, true, p));
+
1200 BEAST_EXPECT(!proposingFalse.updateVote(55, true, p));
+
1201 BEAST_EXPECT(!followingTrue.updateVote(55, false, p));
+
1202 BEAST_EXPECT(!followingFalse.updateVote(55, false, p));
+
1203
+
1204 BEAST_EXPECT(proposingTrue.getOurVote() == false);
+
1205 BEAST_EXPECT(proposingFalse.getOurVote() == false);
+
1206 BEAST_EXPECT(followingTrue.getOurVote() == true);
+
1207 BEAST_EXPECT(followingFalse.getOurVote() == false);
+
1208 // 16 validators change their vote to match my original vote
+
1209 for (int i = 0; i < 16; ++i)
+
1210 {
+
1211 auto pTrue = PeerID(numPeers - i - 1);
+
1212 auto pFalse = PeerID(i);
+
1213 BEAST_EXPECT(proposingTrue.setVote(pTrue, true));
+
1214 BEAST_EXPECT(proposingFalse.setVote(pFalse, false));
+
1215 BEAST_EXPECT(followingTrue.setVote(pTrue, true));
+
1216 BEAST_EXPECT(followingFalse.setVote(pFalse, false));
+
1217 }
+
1218 // The vote should now be 66%, threshold is 65%
+
1219 BEAST_EXPECT(proposingTrue.updateVote(60, true, p));
+
1220 BEAST_EXPECT(!proposingFalse.updateVote(60, true, p));
+
1221 BEAST_EXPECT(!followingTrue.updateVote(60, false, p));
+
1222 BEAST_EXPECT(!followingFalse.updateVote(60, false, p));
+
1223
+
1224 BEAST_EXPECT(proposingTrue.getOurVote() == true);
+
1225 BEAST_EXPECT(proposingFalse.getOurVote() == false);
+
1226 BEAST_EXPECT(followingTrue.getOurVote() == true);
+
1227 BEAST_EXPECT(followingFalse.getOurVote() == false);
+
1228
+
1229 // Threshold jumps to 70%
+
1230 BEAST_EXPECT(proposingTrue.updateVote(86, true, p));
+
1231 BEAST_EXPECT(!proposingFalse.updateVote(86, true, p));
+
1232 BEAST_EXPECT(!followingTrue.updateVote(86, false, p));
+
1233 BEAST_EXPECT(!followingFalse.updateVote(86, false, p));
+
1234
+
1235 BEAST_EXPECT(proposingTrue.getOurVote() == false);
+
1236 BEAST_EXPECT(proposingFalse.getOurVote() == false);
+
1237 BEAST_EXPECT(followingTrue.getOurVote() == true);
+
1238 BEAST_EXPECT(followingFalse.getOurVote() == false);
+
1239
+
1240 // 5 more validators change their vote to match my original vote
+
1241 for (int i = 16; i < 21; ++i)
+
1242 {
+
1243 auto pTrue = PeerID(numPeers - i - 1);
+
1244 auto pFalse = PeerID(i);
+
1245 BEAST_EXPECT(proposingTrue.setVote(pTrue, true));
+
1246 BEAST_EXPECT(proposingFalse.setVote(pFalse, false));
+
1247 BEAST_EXPECT(followingTrue.setVote(pTrue, true));
+
1248 BEAST_EXPECT(followingFalse.setVote(pFalse, false));
+
1249 }
+
1250
+
1251 // The vote should now be 71%, threshold is 70%
+
1252 BEAST_EXPECT(proposingTrue.updateVote(90, true, p));
+
1253 BEAST_EXPECT(!proposingFalse.updateVote(90, true, p));
+
1254 BEAST_EXPECT(!followingTrue.updateVote(90, false, p));
+
1255 BEAST_EXPECT(!followingFalse.updateVote(90, false, p));
+
1256
+
1257 BEAST_EXPECT(proposingTrue.getOurVote() == true);
+
1258 BEAST_EXPECT(proposingFalse.getOurVote() == false);
+
1259 BEAST_EXPECT(followingTrue.getOurVote() == true);
+
1260 BEAST_EXPECT(followingFalse.getOurVote() == false);
+
1261
+
1262 // The vote should now be 71%, threshold is 70%
+
1263 BEAST_EXPECT(!proposingTrue.updateVote(150, true, p));
+
1264 BEAST_EXPECT(!proposingFalse.updateVote(150, true, p));
+
1265 BEAST_EXPECT(!followingTrue.updateVote(150, false, p));
+
1266 BEAST_EXPECT(!followingFalse.updateVote(150, false, p));
+
1267
+
1268 BEAST_EXPECT(proposingTrue.getOurVote() == true);
+
1269 BEAST_EXPECT(proposingFalse.getOurVote() == false);
+
1270 BEAST_EXPECT(followingTrue.getOurVote() == true);
+
1271 BEAST_EXPECT(followingFalse.getOurVote() == false);
+
1272
+
1273 // The vote should now be 71%, threshold is 70%
+
1274 BEAST_EXPECT(!proposingTrue.updateVote(190, true, p));
+
1275 BEAST_EXPECT(!proposingFalse.updateVote(190, true, p));
+
1276 BEAST_EXPECT(!followingTrue.updateVote(190, false, p));
+
1277 BEAST_EXPECT(!followingFalse.updateVote(190, false, p));
+
1278
+
1279 BEAST_EXPECT(proposingTrue.getOurVote() == true);
+
1280 BEAST_EXPECT(proposingFalse.getOurVote() == false);
+
1281 BEAST_EXPECT(followingTrue.getOurVote() == true);
+
1282 BEAST_EXPECT(followingFalse.getOurVote() == false);
+
1283
+
1284 peersUnchanged = 3;
+
1285 BEAST_EXPECT(!proposingTrue.stalled(p, true, peersUnchanged));
+
1286 BEAST_EXPECT(!proposingFalse.stalled(p, true, peersUnchanged));
+
1287 BEAST_EXPECT(!followingTrue.stalled(p, false, peersUnchanged));
+
1288 BEAST_EXPECT(!followingFalse.stalled(p, false, peersUnchanged));
+
1289
+
1290 // Threshold jumps to 95%
+
1291 BEAST_EXPECT(proposingTrue.updateVote(220, true, p));
+
1292 BEAST_EXPECT(!proposingFalse.updateVote(220, true, p));
+
1293 BEAST_EXPECT(!followingTrue.updateVote(220, false, p));
+
1294 BEAST_EXPECT(!followingFalse.updateVote(220, false, p));
+
1295
+
1296 BEAST_EXPECT(proposingTrue.getOurVote() == false);
+
1297 BEAST_EXPECT(proposingFalse.getOurVote() == false);
+
1298 BEAST_EXPECT(followingTrue.getOurVote() == true);
+
1299 BEAST_EXPECT(followingFalse.getOurVote() == false);
+
1300
+
1301 // 25 more validators change their vote to match my original vote
+
1302 for (int i = 21; i < 46; ++i)
+
1303 {
+
1304 auto pTrue = PeerID(numPeers - i - 1);
+
1305 auto pFalse = PeerID(i);
+
1306 BEAST_EXPECT(proposingTrue.setVote(pTrue, true));
+
1307 BEAST_EXPECT(proposingFalse.setVote(pFalse, false));
+
1308 BEAST_EXPECT(followingTrue.setVote(pTrue, true));
+
1309 BEAST_EXPECT(followingFalse.setVote(pFalse, false));
+
1310 }
+
1311
+
1312 // The vote should now be 96%, threshold is 95%
+
1313 BEAST_EXPECT(proposingTrue.updateVote(250, true, p));
+
1314 BEAST_EXPECT(!proposingFalse.updateVote(250, true, p));
+
1315 BEAST_EXPECT(!followingTrue.updateVote(250, false, p));
+
1316 BEAST_EXPECT(!followingFalse.updateVote(250, false, p));
+
1317
+
1318 BEAST_EXPECT(proposingTrue.getOurVote() == true);
+
1319 BEAST_EXPECT(proposingFalse.getOurVote() == false);
+
1320 BEAST_EXPECT(followingTrue.getOurVote() == true);
+
1321 BEAST_EXPECT(followingFalse.getOurVote() == false);
+
1322
+
1323 for (peersUnchanged = 0; peersUnchanged < 6; ++peersUnchanged)
+
1324 {
+
1325 BEAST_EXPECT(!proposingTrue.stalled(p, true, peersUnchanged));
+
1326 BEAST_EXPECT(!proposingFalse.stalled(p, true, peersUnchanged));
+
1327 BEAST_EXPECT(!followingTrue.stalled(p, false, peersUnchanged));
+
1328 BEAST_EXPECT(!followingFalse.stalled(p, false, peersUnchanged));
+
1329 }
+
1330
+
1331 for (int i = 0; i < 1; ++i)
+
1332 {
+
1333 BEAST_EXPECT(!proposingTrue.updateVote(250 + 10 * i, true, p));
+
1334 BEAST_EXPECT(!proposingFalse.updateVote(250 + 10 * i, true, p));
+
1335 BEAST_EXPECT(!followingTrue.updateVote(250 + 10 * i, false, p));
+
1336 BEAST_EXPECT(
+
1337 !followingFalse.updateVote(250 + 10 * i, false, p));
+
1338
+
1339 BEAST_EXPECT(proposingTrue.getOurVote() == true);
+
1340 BEAST_EXPECT(proposingFalse.getOurVote() == false);
+
1341 BEAST_EXPECT(followingTrue.getOurVote() == true);
+
1342 BEAST_EXPECT(followingFalse.getOurVote() == false);
+
1343
+
1344 // true vote has changed recently, so not stalled
+
1345 BEAST_EXPECT(!proposingTrue.stalled(p, true, 0));
+
1346 // remaining votes have been unchanged in so long that we only
+
1347 // need to hit the second round at 95% to be stalled, regardless
+
1348 // of peers
+
1349 BEAST_EXPECT(proposingFalse.stalled(p, true, 0));
+
1350 BEAST_EXPECT(followingTrue.stalled(p, false, 0));
+
1351 BEAST_EXPECT(followingFalse.stalled(p, false, 0));
+
1352
+
1353 // true vote has changed recently, so not stalled
+
1354 BEAST_EXPECT(!proposingTrue.stalled(p, true, peersUnchanged));
+
1355 // remaining votes have been unchanged in so long that we only
+
1356 // need to hit the second round at 95% to be stalled, regardless
+
1357 // of peers
+
1358 BEAST_EXPECT(proposingFalse.stalled(p, true, peersUnchanged));
+
1359 BEAST_EXPECT(followingTrue.stalled(p, false, peersUnchanged));
+
1360 BEAST_EXPECT(followingFalse.stalled(p, false, peersUnchanged));
+
1361 }
+
1362 for (int i = 1; i < 3; ++i)
+
1363 {
+
1364 BEAST_EXPECT(!proposingTrue.updateVote(250 + 10 * i, true, p));
+
1365 BEAST_EXPECT(!proposingFalse.updateVote(250 + 10 * i, true, p));
+
1366 BEAST_EXPECT(!followingTrue.updateVote(250 + 10 * i, false, p));
+
1367 BEAST_EXPECT(
+
1368 !followingFalse.updateVote(250 + 10 * i, false, p));
+
1369
+
1370 BEAST_EXPECT(proposingTrue.getOurVote() == true);
+
1371 BEAST_EXPECT(proposingFalse.getOurVote() == false);
+
1372 BEAST_EXPECT(followingTrue.getOurVote() == true);
+
1373 BEAST_EXPECT(followingFalse.getOurVote() == false);
+
1374
+
1375 // true vote changed 2 rounds ago, and peers are changing, so
+
1376 // not stalled
+
1377 BEAST_EXPECT(!proposingTrue.stalled(p, true, 0));
+
1378 // still stalled
+
1379 BEAST_EXPECT(proposingFalse.stalled(p, true, 0));
+
1380 BEAST_EXPECT(followingTrue.stalled(p, false, 0));
+
1381 BEAST_EXPECT(followingFalse.stalled(p, false, 0));
+
1382
+
1383 // true vote changed 2 rounds ago, and peers are NOT changing,
+
1384 // so stalled
+
1385 BEAST_EXPECT(proposingTrue.stalled(p, true, peersUnchanged));
+
1386 // still stalled
+
1387 BEAST_EXPECT(proposingFalse.stalled(p, true, peersUnchanged));
+
1388 BEAST_EXPECT(followingTrue.stalled(p, false, peersUnchanged));
+
1389 BEAST_EXPECT(followingFalse.stalled(p, false, peersUnchanged));
+
1390 }
+
1391 for (int i = 3; i < 5; ++i)
+
1392 {
+
1393 BEAST_EXPECT(!proposingTrue.updateVote(250 + 10 * i, true, p));
+
1394 BEAST_EXPECT(!proposingFalse.updateVote(250 + 10 * i, true, p));
+
1395 BEAST_EXPECT(!followingTrue.updateVote(250 + 10 * i, false, p));
+
1396 BEAST_EXPECT(
+
1397 !followingFalse.updateVote(250 + 10 * i, false, p));
+
1398
+
1399 BEAST_EXPECT(proposingTrue.getOurVote() == true);
+
1400 BEAST_EXPECT(proposingFalse.getOurVote() == false);
+
1401 BEAST_EXPECT(followingTrue.getOurVote() == true);
+
1402 BEAST_EXPECT(followingFalse.getOurVote() == false);
+
1403
+
1404 BEAST_EXPECT(proposingTrue.stalled(p, true, 0));
+
1405 BEAST_EXPECT(proposingFalse.stalled(p, true, 0));
+
1406 BEAST_EXPECT(followingTrue.stalled(p, false, 0));
+
1407 BEAST_EXPECT(followingFalse.stalled(p, false, 0));
+
1408
+
1409 BEAST_EXPECT(proposingTrue.stalled(p, true, peersUnchanged));
+
1410 BEAST_EXPECT(proposingFalse.stalled(p, true, peersUnchanged));
+
1411 BEAST_EXPECT(followingTrue.stalled(p, false, peersUnchanged));
+
1412 BEAST_EXPECT(followingFalse.stalled(p, false, peersUnchanged));
+
1413 }
+
1414 }
+
1415 }
+
1416
+
1417 void
+
1418 run() override
+
1419 {
+
1420 testShouldCloseLedger();
+
1421 testCheckConsensus();
+
1422
+
1423 testStandalone();
+
1424 testPeersAgree();
+
1425 testSlowPeers();
+
1426 testCloseTimeDisagree();
+
1427 testWrongLCL();
+
1428 testConsensusCloseTimeRounding();
+
1429 testFork();
+
1430 testHubNetwork();
+
1431 testPreferredByBranch();
+
1432 testPauseForLaggards();
+
1433 testDisputes();
+
1434 }
+
1435};
+
1436
+
1437BEAST_DEFINE_TESTSUITE(Consensus, consensus, ripple);
+
1438} // namespace test
+
1439} // namespace ripple
beast::unit_test::suite
A testsuite class.
Definition: suite.h:55
-
ripple::Consensus
Generic implementation of consensus algorithm.
Definition: Consensus.h:292
+
beast::unit_test::suite::testcase
testcase_t testcase
Memberspace for declaring test cases.
Definition: suite.h:155
+
ripple::Consensus
Generic implementation of consensus algorithm.
Definition: Consensus.h:298
+
ripple::DisputedTx
A transaction discovered to be in dispute during consensus.
Definition: DisputedTx.h:49
ripple::Peer
Represents a peer connection in the overlay.
Definition: xrpld/overlay/Peer.h:44
ripple::Peer::id
virtual id_t id() const =0
ripple::tagged_integer< std::uint32_t, PeerIDTag >
-
ripple::test::Consensus_test
Definition: Consensus_test.cpp:31
-
ripple::test::Consensus_test::testCloseTimeDisagree
void testCloseTimeDisagree()
Definition: Consensus_test.cpp:350
-
ripple::test::Consensus_test::testSlowPeers
void testSlowPeers()
Definition: Consensus_test.cpp:185
-
ripple::test::Consensus_test::journal_
SuiteJournal journal_
Definition: Consensus_test.cpp:32
-
ripple::test::Consensus_test::testPauseForLaggards
void testPauseForLaggards()
Definition: Consensus_test.cpp:966
-
ripple::test::Consensus_test::run
void run() override
Runs the suite.
Definition: Consensus_test.cpp:1056
-
ripple::test::Consensus_test::testConsensusCloseTimeRounding
void testConsensusCloseTimeRounding()
Definition: Consensus_test.cpp:588
-
ripple::test::Consensus_test::testPeersAgree
void testPeersAgree()
Definition: Consensus_test.cpp:148
-
ripple::test::Consensus_test::testHubNetwork
void testHubNetwork()
Definition: Consensus_test.cpp:747
-
ripple::test::Consensus_test::testPreferredByBranch
void testPreferredByBranch()
Definition: Consensus_test.cpp:834
-
ripple::test::Consensus_test::testStandalone
void testStandalone()
Definition: Consensus_test.cpp:124
-
ripple::test::Consensus_test::testFork
void testFork()
Definition: Consensus_test.cpp:691
-
ripple::test::Consensus_test::testCheckConsensus
void testCheckConsensus()
Definition: Consensus_test.cpp:78
-
ripple::test::Consensus_test::testShouldCloseLedger
void testShouldCloseLedger()
Definition: Consensus_test.cpp:40
-
ripple::test::Consensus_test::Consensus_test
Consensus_test()
Definition: Consensus_test.cpp:35
-
ripple::test::Consensus_test::testWrongLCL
void testWrongLCL()
Definition: Consensus_test.cpp:416
+
ripple::test::Consensus_test
Definition: Consensus_test.cpp:32
+
ripple::test::Consensus_test::testCloseTimeDisagree
void testCloseTimeDisagree()
Definition: Consensus_test.cpp:411
+
ripple::test::Consensus_test::testDisputes
void testDisputes()
Definition: Consensus_test.cpp:1122
+
ripple::test::Consensus_test::testSlowPeers
void testSlowPeers()
Definition: Consensus_test.cpp:245
+
ripple::test::Consensus_test::journal_
SuiteJournal journal_
Definition: Consensus_test.cpp:33
+
ripple::test::Consensus_test::testPauseForLaggards
void testPauseForLaggards()
Definition: Consensus_test.cpp:1031
+
ripple::test::Consensus_test::run
void run() override
Runs the suite.
Definition: Consensus_test.cpp:1418
+
ripple::test::Consensus_test::testConsensusCloseTimeRounding
void testConsensusCloseTimeRounding()
Definition: Consensus_test.cpp:652
+
ripple::test::Consensus_test::testPeersAgree
void testPeersAgree()
Definition: Consensus_test.cpp:207
+
ripple::test::Consensus_test::testHubNetwork
void testHubNetwork()
Definition: Consensus_test.cpp:810
+
ripple::test::Consensus_test::testPreferredByBranch
void testPreferredByBranch()
Definition: Consensus_test.cpp:898
+
ripple::test::Consensus_test::testStandalone
void testStandalone()
Definition: Consensus_test.cpp:182
+
ripple::test::Consensus_test::testFork
void testFork()
Definition: Consensus_test.cpp:753
+
ripple::test::Consensus_test::testCheckConsensus
void testCheckConsensus()
Definition: Consensus_test.cpp:80
+
ripple::test::Consensus_test::testShouldCloseLedger
void testShouldCloseLedger()
Definition: Consensus_test.cpp:41
+
ripple::test::Consensus_test::Consensus_test
Consensus_test()
Definition: Consensus_test.cpp:36
+
ripple::test::Consensus_test::testWrongLCL
void testWrongLCL()
Definition: Consensus_test.cpp:478
ripple::test::csf::PeerGroup
A group of simulation Peers.
Definition: PeerGroup.h:42
@@ -1187,30 +1551,32 @@ $(function() {
ripple::test::csf::SimTime
typename SimClock::time_point SimTime
Definition: SimTime.h:37
ripple::test::jtx::rate
Json::Value rate(Account const &account, double multiplier)
Set a transfer rate.
Definition: rate.cpp:32
ripple
Use hash_* containers for keys that do not need a cryptographically secure hashing algorithm.
Definition: algorithm.h:26
-
ripple::checkConsensus
ConsensusState checkConsensus(std::size_t prevProposers, std::size_t currentProposers, std::size_t currentAgree, std::size_t currentFinished, std::chrono::milliseconds previousAgreeTime, std::chrono::milliseconds currentAgreeTime, ConsensusParms const &parms, bool proposing, beast::Journal j, std::unique_ptr< std::stringstream > const &clog)
Determine whether the network reached consensus and whether we joined.
Definition: Consensus.cpp:164
+
ripple::checkConsensus
ConsensusState checkConsensus(std::size_t prevProposers, std::size_t currentProposers, std::size_t currentAgree, std::size_t currentFinished, std::chrono::milliseconds previousAgreeTime, std::chrono::milliseconds currentAgreeTime, bool stalled, ConsensusParms const &parms, bool proposing, beast::Journal j, std::unique_ptr< std::stringstream > const &clog)
Determine whether the network reached consensus and whether we joined.
Definition: Consensus.cpp:177
+
ripple::ConsensusState::Expired
@ Expired
Consensus time limit has hard-expired.
ripple::ConsensusState::MovedOn
@ MovedOn
The network has consensus without us.
ripple::ConsensusState::Yes
@ Yes
We have consensus along with the network.
ripple::ConsensusState::No
@ No
We do not have consensus.
ripple::shouldCloseLedger
bool shouldCloseLedger(bool anyTransactions, std::size_t prevProposers, std::size_t proposersClosed, std::size_t proposersValidated, std::chrono::milliseconds prevRoundTime, std::chrono::milliseconds timeSincePrevClose, std::chrono::milliseconds openTime, std::chrono::milliseconds idleInterval, ConsensusParms const &parms, beast::Journal j, std::unique_ptr< std::stringstream > const &clog)
Determines whether the current ledger should close at this time.
Definition: Consensus.cpp:27
ripple::increaseLedgerTimeResolutionEvery
auto constexpr increaseLedgerTimeResolutionEvery
How often we increase the close time resolution (in numbers of ledgers)
Definition: LedgerTiming.h:50
-
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:34
-
ripple::ConsensusParms::ledgerGRANULARITY
std::chrono::milliseconds ledgerGRANULARITY
How often we check state or change positions.
Definition: ConsensusParms.h:95
+ +
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:39
+
ripple::ConsensusParms::ledgerGRANULARITY
std::chrono::milliseconds const ledgerGRANULARITY
How often we check state or change positions.
Definition: ConsensusParms.h:102
ripple::Rate
Represents a transfer rate.
Definition: Rate.h:40
-
ripple::test::Consensus_test::Disruptor
Definition: Consensus_test.cpp:783
-
ripple::test::Consensus_test::Disruptor::network
csf::PeerGroup & network
Definition: Consensus_test.cpp:784
-
ripple::test::Consensus_test::Disruptor::groupCsplit
csf::PeerGroup & groupCsplit
Definition: Consensus_test.cpp:786
-
ripple::test::Consensus_test::Disruptor::groupCfast
csf::PeerGroup & groupCfast
Definition: Consensus_test.cpp:785
-
ripple::test::Consensus_test::Disruptor::on
void on(csf::PeerID, csf::SimTime, E const &)
Definition: Consensus_test.cpp:801
-
ripple::test::Consensus_test::Disruptor::Disruptor
Disruptor(csf::PeerGroup &net, csf::PeerGroup &c, csf::PeerGroup &split, csf::SimDuration d)
Definition: Consensus_test.cpp:790
-
ripple::test::Consensus_test::Disruptor::on
void on(csf::PeerID who, csf::SimTime, csf::AcceptLedger const &e)
Definition: Consensus_test.cpp:821
-
ripple::test::Consensus_test::Disruptor::on
void on(csf::PeerID who, csf::SimTime, csf::FullyValidateLedger const &e)
Definition: Consensus_test.cpp:806
-
ripple::test::Consensus_test::Disruptor::delay
csf::SimDuration delay
Definition: Consensus_test.cpp:787
-
ripple::test::Consensus_test::UndoDelay
Definition: Consensus_test.cpp:941
-
ripple::test::Consensus_test::UndoDelay::on
void on(csf::PeerID, csf::SimTime, E const &)
Definition: Consensus_test.cpp:950
-
ripple::test::Consensus_test::UndoDelay::on
void on(csf::PeerID who, csf::SimTime, csf::AcceptLedger const &e)
Definition: Consensus_test.cpp:955
-
ripple::test::Consensus_test::UndoDelay::UndoDelay
UndoDelay(csf::PeerGroup &a)
Definition: Consensus_test.cpp:944
-
ripple::test::Consensus_test::UndoDelay::g
csf::PeerGroup & g
Definition: Consensus_test.cpp:942
+
ripple::test::Consensus_test::Disruptor
Definition: Consensus_test.cpp:847
+
ripple::test::Consensus_test::Disruptor::network
csf::PeerGroup & network
Definition: Consensus_test.cpp:848
+
ripple::test::Consensus_test::Disruptor::groupCsplit
csf::PeerGroup & groupCsplit
Definition: Consensus_test.cpp:850
+
ripple::test::Consensus_test::Disruptor::groupCfast
csf::PeerGroup & groupCfast
Definition: Consensus_test.cpp:849
+
ripple::test::Consensus_test::Disruptor::on
void on(csf::PeerID, csf::SimTime, E const &)
Definition: Consensus_test.cpp:865
+
ripple::test::Consensus_test::Disruptor::Disruptor
Disruptor(csf::PeerGroup &net, csf::PeerGroup &c, csf::PeerGroup &split, csf::SimDuration d)
Definition: Consensus_test.cpp:854
+
ripple::test::Consensus_test::Disruptor::on
void on(csf::PeerID who, csf::SimTime, csf::AcceptLedger const &e)
Definition: Consensus_test.cpp:885
+
ripple::test::Consensus_test::Disruptor::on
void on(csf::PeerID who, csf::SimTime, csf::FullyValidateLedger const &e)
Definition: Consensus_test.cpp:870
+
ripple::test::Consensus_test::Disruptor::delay
csf::SimDuration delay
Definition: Consensus_test.cpp:851
+
ripple::test::Consensus_test::UndoDelay
Definition: Consensus_test.cpp:1006
+
ripple::test::Consensus_test::UndoDelay::on
void on(csf::PeerID, csf::SimTime, E const &)
Definition: Consensus_test.cpp:1015
+
ripple::test::Consensus_test::UndoDelay::on
void on(csf::PeerID who, csf::SimTime, csf::AcceptLedger const &e)
Definition: Consensus_test.cpp:1020
+
ripple::test::Consensus_test::UndoDelay::UndoDelay
UndoDelay(csf::PeerGroup &a)
Definition: Consensus_test.cpp:1009
+
ripple::test::Consensus_test::UndoDelay::g
csf::PeerGroup & g
Definition: Consensus_test.cpp:1007
ripple::test::csf::AcceptLedger
Peer accepted consensus results.
Definition: events.h:121
ripple::test::csf::FullyValidateLedger
Peer fully validated a new ledger.
Definition: events.h:140
diff --git a/DisputedTx_8h_source.html b/DisputedTx_8h_source.html index 3058a771e4..51d7397385 100644 --- a/DisputedTx_8h_source.html +++ b/DisputedTx_8h_source.html @@ -137,215 +137,278 @@ $(function() {
82 return ourVote_;
83 }
84
-
86 Tx_t const&
-
87 tx() const
-
88 {
-
89 return tx_;
-
90 }
-
91
-
93 void
-
94 setOurVote(bool o)
-
95 {
-
96 ourVote_ = o;
-
97 }
-
98
-
104 void
-
105 setVote(NodeID_t const& peer, bool votesYes);
+
87 bool
+
88 stalled(ConsensusParms const& p, bool proposing, int peersUnchanged) const
+
89 {
+
90 // at() can throw, but the map is built by hand to ensure all valid
+
91 // values are available.
+
92 auto const& currentCutoff = p.avalancheCutoffs.at(avalancheState_);
+
93 auto const& nextCutoff = p.avalancheCutoffs.at(currentCutoff.next);
+
94
+
95 // We're have not reached the final avalanche state, or been there long
+
96 // enough, so there's room for change. Check the times in case the state
+
97 // machine is altered to allow states to loop.
+
98 if (nextCutoff.consensusTime > currentCutoff.consensusTime ||
+
99 avalancheCounter_ < p.avMIN_ROUNDS)
+
100 return false;
+
101
+
102 // We've haven't had this vote for minimum rounds yet. Things could
+
103 // change.
+
104 if (proposing && currentVoteCounter_ < p.avMIN_ROUNDS)
+
105 return false;
106
-
111 void
-
112 unVote(NodeID_t const& peer);
-
113
-
125 bool
-
126 updateVote(int percentTime, bool proposing, ConsensusParms const& p);
-
127
-
129 Json::Value
-
130 getJson() const;
-
131
-
132private:
-
133 int yays_; //< Number of yes votes
-
134 int nays_; //< Number of no votes
-
135 bool ourVote_; //< Our vote (true is yes)
-
136 Tx_t tx_; //< Transaction under dispute
-
137 Map_t votes_; //< Map from NodeID to vote
-
138 beast::Journal const j_;
-
139};
-
140
-
141// Track a peer's yes/no vote on a particular disputed tx_
-
142template <class Tx_t, class NodeID_t>
-
143void
-
144DisputedTx<Tx_t, NodeID_t>::setVote(NodeID_t const& peer, bool votesYes)
-
145{
-
146 auto const [it, inserted] = votes_.insert(std::make_pair(peer, votesYes));
-
147
-
148 // new vote
-
149 if (inserted)
-
150 {
-
151 if (votesYes)
-
152 {
-
153 JLOG(j_.debug()) << "Peer " << peer << " votes YES on " << tx_.id();
-
154 ++yays_;
-
155 }
-
156 else
-
157 {
-
158 JLOG(j_.debug()) << "Peer " << peer << " votes NO on " << tx_.id();
-
159 ++nays_;
-
160 }
-
161 }
-
162 // changes vote to yes
-
163 else if (votesYes && !it->second)
-
164 {
-
165 JLOG(j_.debug()) << "Peer " << peer << " now votes YES on " << tx_.id();
-
166 --nays_;
-
167 ++yays_;
-
168 it->second = true;
-
169 }
-
170 // changes vote to no
-
171 else if (!votesYes && it->second)
-
172 {
-
173 JLOG(j_.debug()) << "Peer " << peer << " now votes NO on " << tx_.id();
-
174 ++nays_;
-
175 --yays_;
-
176 it->second = false;
-
177 }
-
178}
-
179
-
180// Remove a peer's vote on this disputed transaction
-
181template <class Tx_t, class NodeID_t>
-
182void
-
183DisputedTx<Tx_t, NodeID_t>::unVote(NodeID_t const& peer)
-
184{
-
185 auto it = votes_.find(peer);
-
186
-
187 if (it != votes_.end())
-
188 {
-
189 if (it->second)
-
190 --yays_;
-
191 else
-
192 --nays_;
-
193
-
194 votes_.erase(it);
-
195 }
-
196}
-
197
-
198template <class Tx_t, class NodeID_t>
-
199bool
-
200DisputedTx<Tx_t, NodeID_t>::updateVote(
-
201 int percentTime,
-
202 bool proposing,
-
203 ConsensusParms const& p)
-
204{
-
205 if (ourVote_ && (nays_ == 0))
-
206 return false;
-
207
-
208 if (!ourVote_ && (yays_ == 0))
-
209 return false;
-
210
-
211 bool newPosition;
-
212 int weight;
-
213
-
214 if (proposing) // give ourselves full weight
-
215 {
-
216 // This is basically the percentage of nodes voting 'yes' (including us)
-
217 weight = (yays_ * 100 + (ourVote_ ? 100 : 0)) / (nays_ + yays_ + 1);
-
218
-
219 // To prevent avalanche stalls, we increase the needed weight slightly
-
220 // over time.
-
221 if (percentTime < p.avMID_CONSENSUS_TIME)
-
222 newPosition = weight > p.avINIT_CONSENSUS_PCT;
-
223 else if (percentTime < p.avLATE_CONSENSUS_TIME)
-
224 newPosition = weight > p.avMID_CONSENSUS_PCT;
-
225 else if (percentTime < p.avSTUCK_CONSENSUS_TIME)
-
226 newPosition = weight > p.avLATE_CONSENSUS_PCT;
-
227 else
-
228 newPosition = weight > p.avSTUCK_CONSENSUS_PCT;
-
229 }
-
230 else
-
231 {
-
232 // don't let us outweigh a proposing node, just recognize consensus
-
233 weight = -1;
-
234 newPosition = yays_ > nays_;
+
107 // If we or any peers have changed a vote in several rounds, then
+
108 // things could still change. But if _either_ has not changed in that
+
109 // long, we're unlikely to change our vote any time soon. (This prevents
+
110 // a malicious peer from flip-flopping a vote to prevent consensus.)
+
111 if (peersUnchanged < p.avSTALLED_ROUNDS &&
+
112 (proposing && currentVoteCounter_ < p.avSTALLED_ROUNDS))
+
113 return false;
+
114
+
115 // Does this transaction have more than 80% agreement
+
116
+
117 // Compute the percentage of nodes voting 'yes' (possibly including us)
+
118 int const support = (yays_ + (proposing && ourVote_ ? 1 : 0)) * 100;
+
119 int total = nays_ + yays_ + (proposing ? 1 : 0);
+
120 if (!total)
+
121 // There are no votes, so we know nothing
+
122 return false;
+
123 int const weight = support / total;
+
124 // Returns true if the tx has more than minCONSENSUS_PCT (80) percent
+
125 // agreement. Either voting for _or_ voting against the tx.
+
126 return weight > p.minCONSENSUS_PCT ||
+
127 weight < (100 - p.minCONSENSUS_PCT);
+
128 }
+
129
+
131 Tx_t const&
+
132 tx() const
+
133 {
+
134 return tx_;
+
135 }
+
136
+
138 void
+
139 setOurVote(bool o)
+
140 {
+
141 ourVote_ = o;
+
142 }
+
143
+
152 [[nodiscard]]
+
153 bool
+
154 setVote(NodeID_t const& peer, bool votesYes);
+
155
+
160 void
+
161 unVote(NodeID_t const& peer);
+
162
+
174 bool
+
175 updateVote(int percentTime, bool proposing, ConsensusParms const& p);
+
176
+
178 Json::Value
+
179 getJson() const;
+
180
+
181private:
+
182 int yays_; //< Number of yes votes
+
183 int nays_; //< Number of no votes
+
184 bool ourVote_; //< Our vote (true is yes)
+
185 Tx_t tx_; //< Transaction under dispute
+
186 Map_t votes_; //< Map from NodeID to vote
+
188 std::size_t currentVoteCounter_ = 0;
+
190 ConsensusParms::AvalancheState avalancheState_ = ConsensusParms::init;
+
192 std::size_t avalancheCounter_ = 0;
+
193 beast::Journal const j_;
+
194};
+
195
+
196// Track a peer's yes/no vote on a particular disputed tx_
+
197template <class Tx_t, class NodeID_t>
+
198bool
+
199DisputedTx<Tx_t, NodeID_t>::setVote(NodeID_t const& peer, bool votesYes)
+
200{
+
201 auto const [it, inserted] = votes_.insert(std::make_pair(peer, votesYes));
+
202
+
203 // new vote
+
204 if (inserted)
+
205 {
+
206 if (votesYes)
+
207 {
+
208 JLOG(j_.debug()) << "Peer " << peer << " votes YES on " << tx_.id();
+
209 ++yays_;
+
210 }
+
211 else
+
212 {
+
213 JLOG(j_.debug()) << "Peer " << peer << " votes NO on " << tx_.id();
+
214 ++nays_;
+
215 }
+
216 return true;
+
217 }
+
218 // changes vote to yes
+
219 else if (votesYes && !it->second)
+
220 {
+
221 JLOG(j_.debug()) << "Peer " << peer << " now votes YES on " << tx_.id();
+
222 --nays_;
+
223 ++yays_;
+
224 it->second = true;
+
225 return true;
+
226 }
+
227 // changes vote to no
+
228 else if (!votesYes && it->second)
+
229 {
+
230 JLOG(j_.debug()) << "Peer " << peer << " now votes NO on " << tx_.id();
+
231 ++nays_;
+
232 --yays_;
+
233 it->second = false;
+
234 return true;
235 }
-
236
-
237 if (newPosition == ourVote_)
-
238 {
-
239 JLOG(j_.info()) << "No change (" << (ourVote_ ? "YES" : "NO")
-
240 << ") : weight " << weight << ", percent "
-
241 << percentTime;
-
242 JLOG(j_.debug()) << Json::Compact{getJson()};
-
243 return false;
-
244 }
+
236 return false;
+
237}
+
238
+
239// Remove a peer's vote on this disputed transaction
+
240template <class Tx_t, class NodeID_t>
+
241void
+
242DisputedTx<Tx_t, NodeID_t>::unVote(NodeID_t const& peer)
+
243{
+
244 auto it = votes_.find(peer);
245
-
246 ourVote_ = newPosition;
-
247 JLOG(j_.debug()) << "We now vote " << (ourVote_ ? "YES" : "NO") << " on "
-
248 << tx_.id();
-
249 JLOG(j_.debug()) << Json::Compact{getJson()};
-
250 return true;
-
251}
+
246 if (it != votes_.end())
+
247 {
+
248 if (it->second)
+
249 --yays_;
+
250 else
+
251 --nays_;
252
-
253template <class Tx_t, class NodeID_t>
-
254Json::Value
-
255DisputedTx<Tx_t, NodeID_t>::getJson() const
-
256{
-
257 using std::to_string;
-
258
-
259 Json::Value ret(Json::objectValue);
-
260
-
261 ret["yays"] = yays_;
-
262 ret["nays"] = nays_;
-
263 ret["our_vote"] = ourVote_;
-
264
-
265 if (!votes_.empty())
-
266 {
-
267 Json::Value votesj(Json::objectValue);
-
268 for (auto const& [nodeId, vote] : votes_)
-
269 votesj[to_string(nodeId)] = vote;
-
270 ret["votes"] = std::move(votesj);
-
271 }
+
253 votes_.erase(it);
+
254 }
+
255}
+
256
+
257template <class Tx_t, class NodeID_t>
+
258bool
+
259DisputedTx<Tx_t, NodeID_t>::updateVote(
+
260 int percentTime,
+
261 bool proposing,
+
262 ConsensusParms const& p)
+
263{
+
264 if (ourVote_ && (nays_ == 0))
+
265 return false;
+
266
+
267 if (!ourVote_ && (yays_ == 0))
+
268 return false;
+
269
+
270 bool newPosition;
+
271 int weight;
272
-
273 return ret;
-
274}
-
275
-
276} // namespace ripple
-
277
-
278#endif
+
273 // When proposing, to prevent avalanche stalls, we increase the needed
+
274 // weight slightly over time. We also need to ensure that the consensus has
+
275 // made a minimum number of attempts at each "state" before moving
+
276 // to the next.
+
277 // Proposing or not, we need to keep track of which state we've reached so
+
278 // we can determine if the vote has stalled.
+
279 auto const [requiredPct, newState] = getNeededWeight(
+
280 p, avalancheState_, percentTime, ++avalancheCounter_, p.avMIN_ROUNDS);
+
281 if (newState)
+
282 {
+
283 avalancheState_ = *newState;
+
284 avalancheCounter_ = 0;
+
285 }
+
286
+
287 if (proposing) // give ourselves full weight
+
288 {
+
289 // This is basically the percentage of nodes voting 'yes' (including us)
+
290 weight = (yays_ * 100 + (ourVote_ ? 100 : 0)) / (nays_ + yays_ + 1);
+
291
+
292 newPosition = weight > requiredPct;
+
293 }
+
294 else
+
295 {
+
296 // don't let us outweigh a proposing node, just recognize consensus
+
297 weight = -1;
+
298 newPosition = yays_ > nays_;
+
299 }
+
300
+
301 if (newPosition == ourVote_)
+
302 {
+
303 ++currentVoteCounter_;
+
304 JLOG(j_.info()) << "No change (" << (ourVote_ ? "YES" : "NO") << ") on "
+
305 << tx_.id() << " : weight " << weight << ", percent "
+
306 << percentTime
+
307 << ", round(s) with this vote: " << currentVoteCounter_;
+
308 JLOG(j_.debug()) << Json::Compact{getJson()};
+
309 return false;
+
310 }
+
311
+
312 currentVoteCounter_ = 0;
+
313 ourVote_ = newPosition;
+
314 JLOG(j_.debug()) << "We now vote " << (ourVote_ ? "YES" : "NO") << " on "
+
315 << tx_.id();
+
316 JLOG(j_.debug()) << Json::Compact{getJson()};
+
317 return true;
+
318}
+
319
+
320template <class Tx_t, class NodeID_t>
+
321Json::Value
+
322DisputedTx<Tx_t, NodeID_t>::getJson() const
+
323{
+
324 using std::to_string;
+
325
+
326 Json::Value ret(Json::objectValue);
+
327
+
328 ret["yays"] = yays_;
+
329 ret["nays"] = nays_;
+
330 ret["our_vote"] = ourVote_;
+
331
+
332 if (!votes_.empty())
+
333 {
+
334 Json::Value votesj(Json::objectValue);
+
335 for (auto const& [nodeId, vote] : votes_)
+
336 votesj[to_string(nodeId)] = vote;
+
337 ret["votes"] = std::move(votesj);
+
338 }
+
339
+
340 return ret;
+
341}
+
342
+
343} // namespace ripple
+
344
+
345#endif
Json::Compact
Decorator for streaming out compact json.
Definition: json_writer.h:318
Json::Value
Represents a JSON value.
Definition: json_value.h:148
beast::Journal
A generic endpoint for log messages.
Definition: Journal.h:60
beast::Journal::debug
Stream debug() const
Definition: Journal.h:328
beast::Journal::info
Stream info() const
Definition: Journal.h:334
ripple::DisputedTx
A transaction discovered to be in dispute during consensus.
Definition: DisputedTx.h:49
- -
ripple::DisputedTx::getJson
Json::Value getJson() const
JSON representation of dispute, used for debugging.
Definition: DisputedTx.h:255
-
ripple::DisputedTx::j_
beast::Journal const j_
Definition: DisputedTx.h:138
-
ripple::DisputedTx::updateVote
bool updateVote(int percentTime, bool proposing, ConsensusParms const &p)
Update our vote given progression of consensus.
Definition: DisputedTx.h:200
+ +
ripple::DisputedTx::avalancheCounter_
std::size_t avalancheCounter_
How long we have been in the current acceptance phase.
Definition: DisputedTx.h:192
+
ripple::DisputedTx::currentVoteCounter_
std::size_t currentVoteCounter_
The number of rounds we've gone without changing our vote.
Definition: DisputedTx.h:188
+
ripple::DisputedTx::getJson
Json::Value getJson() const
JSON representation of dispute, used for debugging.
Definition: DisputedTx.h:322
+
ripple::DisputedTx::j_
beast::Journal const j_
Definition: DisputedTx.h:193
+
ripple::DisputedTx::updateVote
bool updateVote(int percentTime, bool proposing, ConsensusParms const &p)
Update our vote given progression of consensus.
Definition: DisputedTx.h:259
ripple::DisputedTx::Map_t
boost::container::flat_map< NodeID_t, bool > Map_t
Definition: DisputedTx.h:51
- -
ripple::DisputedTx::tx
Tx_t const & tx() const
The disputed transaction.
Definition: DisputedTx.h:87
-
ripple::DisputedTx::setVote
void setVote(NodeID_t const &peer, bool votesYes)
Change a peer's vote.
Definition: DisputedTx.h:144
+
ripple::DisputedTx::setVote
bool setVote(NodeID_t const &peer, bool votesYes)
Change a peer's vote.
Definition: DisputedTx.h:199
+
ripple::DisputedTx::avalancheState_
ConsensusParms::AvalancheState avalancheState_
Which minimum acceptance percentage phase we are currently in.
Definition: DisputedTx.h:190
+ +
ripple::DisputedTx::tx
Tx_t const & tx() const
The disputed transaction.
Definition: DisputedTx.h:132
ripple::DisputedTx::TxID_t
typename Tx_t::ID TxID_t
Definition: DisputedTx.h:50
ripple::DisputedTx::DisputedTx
DisputedTx(Tx_t const &tx, bool ourVote, std::size_t numPeers, beast::Journal j)
Constructor.
Definition: DisputedTx.h:61
- +
ripple::DisputedTx::getOurVote
bool getOurVote() const
Our vote on whether the transaction should be included.
Definition: DisputedTx.h:80
-
ripple::DisputedTx::setOurVote
void setOurVote(bool o)
Change our vote.
Definition: DisputedTx.h:94
- +
ripple::DisputedTx::setOurVote
void setOurVote(bool o)
Change our vote.
Definition: DisputedTx.h:139
+
ripple::DisputedTx::ID
TxID_t const & ID() const
The unique id/hash of the disputed transaction.
Definition: DisputedTx.h:73
-
ripple::DisputedTx::unVote
void unVote(NodeID_t const &peer)
Remove a peer's vote.
Definition: DisputedTx.h:183
- +
ripple::DisputedTx::unVote
void unVote(NodeID_t const &peer)
Remove a peer's vote.
Definition: DisputedTx.h:242
+
ripple::DisputedTx::stalled
bool stalled(ConsensusParms const &p, bool proposing, int peersUnchanged) const
Are we and our peers "stalled" where we probably won't change our vote?
Definition: DisputedTx.h:88
+
std::make_pair
T make_pair(T... args)
Json::objectValue
@ objectValue
object value (collection of name/value pairs).
Definition: json_value.h:44
ripple
Use hash_* containers for keys that do not need a cryptographically secure hashing algorithm.
Definition: algorithm.h:26
+
ripple::getNeededWeight
std::pair< std::size_t, std::optional< ConsensusParms::AvalancheState > > getNeededWeight(ConsensusParms const &p, ConsensusParms::AvalancheState currentState, int percentTime, std::size_t currentRounds, std::size_t minimumRounds)
Definition: ConsensusParms.h:173
ripple::ConsensusMode::proposing
@ proposing
We are normal participant in consensus and propose our position.
ripple::to_string
std::string to_string(base_uint< Bits, Tag > const &a)
Definition: base_uint.h:630
ripple::getJson
Json::Value getJson(LedgerFill const &fill)
Return a new Json::Value representing the ledger with given options.
Definition: LedgerToJson.cpp:360
-
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:34
-
ripple::ConsensusParms::avINIT_CONSENSUS_PCT
std::size_t avINIT_CONSENSUS_PCT
Percentage of nodes on our UNL that must vote yes.
Definition: ConsensusParms.h:116
-
ripple::ConsensusParms::avLATE_CONSENSUS_PCT
std::size_t avLATE_CONSENSUS_PCT
Percentage of nodes that most vote yes after advancing.
Definition: ConsensusParms.h:128
-
ripple::ConsensusParms::avSTUCK_CONSENSUS_PCT
std::size_t avSTUCK_CONSENSUS_PCT
Percentage of nodes that must vote yes after we are stuck.
Definition: ConsensusParms.h:134
-
ripple::ConsensusParms::avLATE_CONSENSUS_TIME
std::size_t avLATE_CONSENSUS_TIME
Percentage of previous round duration before we advance.
Definition: ConsensusParms.h:125
-
ripple::ConsensusParms::avMID_CONSENSUS_PCT
std::size_t avMID_CONSENSUS_PCT
Percentage of nodes that most vote yes after advancing.
Definition: ConsensusParms.h:122
-
ripple::ConsensusParms::avSTUCK_CONSENSUS_TIME
std::size_t avSTUCK_CONSENSUS_TIME
Percentage of previous round duration before we are stuck.
Definition: ConsensusParms.h:131
-
ripple::ConsensusParms::avMID_CONSENSUS_TIME
std::size_t avMID_CONSENSUS_TIME
Percentage of previous round duration before we advance.
Definition: ConsensusParms.h:119
+
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:39
+
ripple::ConsensusParms::avSTALLED_ROUNDS
std::size_t const avSTALLED_ROUNDS
Number of rounds before a stuck vote is considered unlikely to change because voting stalled.
Definition: ConsensusParms.h:169
+
ripple::ConsensusParms::avMIN_ROUNDS
std::size_t const avMIN_ROUNDS
Number of rounds before certain actions can happen.
Definition: ConsensusParms.h:165
+ + +
ripple::ConsensusParms::minCONSENSUS_PCT
std::size_t const minCONSENSUS_PCT
The percentage threshold above which we can declare consensus.
Definition: ConsensusParms.h:79
+
ripple::ConsensusParms::avalancheCutoffs
std::map< AvalancheState, AvalancheCutoff > const avalancheCutoffs
Map the consensus requirement avalanche state to the amount of time that must pass before moving to t...
Definition: ConsensusParms.h:146
std::to_string
T to_string(T... args)
diff --git a/NetworkOPs_8cpp_source.html b/NetworkOPs_8cpp_source.html index fcc77764ad..3402b84852 100644 --- a/NetworkOPs_8cpp_source.html +++ b/NetworkOPs_8cpp_source.html @@ -113,4544 +113,4571 @@ $(function() {
35#include <xrpld/app/misc/NetworkOPs.h>
36#include <xrpld/app/misc/Transaction.h>
37#include <xrpld/app/misc/TxQ.h>
-
38#include <xrpld/app/misc/ValidatorList.h>
-
39#include <xrpld/app/misc/detail/AccountTxPaging.h>
-
40#include <xrpld/app/rdb/backend/SQLiteDatabase.h>
-
41#include <xrpld/app/tx/apply.h>
-
42#include <xrpld/consensus/Consensus.h>
-
43#include <xrpld/consensus/ConsensusParms.h>
-
44#include <xrpld/overlay/Cluster.h>
-
45#include <xrpld/overlay/Overlay.h>
-
46#include <xrpld/overlay/predicates.h>
-
47#include <xrpld/perflog/PerfLog.h>
-
48#include <xrpld/rpc/BookChanges.h>
-
49#include <xrpld/rpc/DeliveredAmount.h>
-
50#include <xrpld/rpc/MPTokenIssuanceID.h>
-
51#include <xrpld/rpc/ServerHandler.h>
-
52
-
53#include <xrpl/basics/UptimeClock.h>
-
54#include <xrpl/basics/mulDiv.h>
-
55#include <xrpl/basics/safe_cast.h>
-
56#include <xrpl/basics/scope.h>
-
57#include <xrpl/beast/utility/rngfill.h>
-
58#include <xrpl/crypto/RFC1751.h>
-
59#include <xrpl/crypto/csprng.h>
-
60#include <xrpl/protocol/BuildInfo.h>
-
61#include <xrpl/protocol/Feature.h>
-
62#include <xrpl/protocol/MultiApiJson.h>
-
63#include <xrpl/protocol/RPCErr.h>
-
64#include <xrpl/protocol/jss.h>
-
65#include <xrpl/resource/Fees.h>
-
66#include <xrpl/resource/ResourceManager.h>
-
67
-
68#include <boost/asio/ip/host_name.hpp>
-
69#include <boost/asio/steady_timer.hpp>
-
70
-
71#include <algorithm>
-
72#include <exception>
-
73#include <mutex>
-
74#include <optional>
-
75#include <set>
-
76#include <sstream>
-
77#include <string>
-
78#include <tuple>
-
79#include <unordered_map>
-
80
-
81namespace ripple {
-
82
-
83class NetworkOPsImp final : public NetworkOPs
-
84{
-
89 class TransactionStatus
-
90 {
-
91 public:
-
92 std::shared_ptr<Transaction> const transaction;
-
93 bool const admin;
-
94 bool const local;
-
95 FailHard const failType;
-
96 bool applied = false;
-
97 TER result;
-
98
-
99 TransactionStatus(
-
100 std::shared_ptr<Transaction> t,
-
101 bool a,
-
102 bool l,
-
103 FailHard f)
-
104 : transaction(t), admin(a), local(l), failType(f)
-
105 {
-
106 XRPL_ASSERT(
-
107 local || failType == FailHard::no,
-
108 "ripple::NetworkOPsImp::TransactionStatus::TransactionStatus : "
-
109 "valid inputs");
-
110 }
-
111 };
-
112
-
116 enum class DispatchState : unsigned char {
-
117 none,
-
118 scheduled,
-
119 running,
-
120 };
-
121
-
122 static std::array<char const*, 5> const states_;
-
123
-
138 class StateAccounting
-
139 {
-
140 struct Counters
-
141 {
-
142 explicit Counters() = default;
-
143
-
144 std::uint64_t transitions = 0;
-
145 std::chrono::microseconds dur = std::chrono::microseconds(0);
-
146 };
-
147
-
148 OperatingMode mode_ = OperatingMode::DISCONNECTED;
-
149 std::array<Counters, 5> counters_;
-
150 mutable std::mutex mutex_;
-
151 std::chrono::steady_clock::time_point start_ =
-
152 std::chrono::steady_clock::now();
-
153 std::chrono::steady_clock::time_point const processStart_ = start_;
-
154 std::uint64_t initialSyncUs_{0};
-
155 static std::array<Json::StaticString const, 5> const states_;
-
156
-
157 public:
-
158 explicit StateAccounting()
-
159 {
-
160 counters_[static_cast<std::size_t>(OperatingMode::DISCONNECTED)]
-
161 .transitions = 1;
-
162 }
-
163
-
170 void
-
171 mode(OperatingMode om);
-
172
-
178 void
-
179 json(Json::Value& obj) const;
-
180
-
181 struct CounterData
-
182 {
-
183 decltype(counters_) counters;
-
184 decltype(mode_) mode;
-
185 decltype(start_) start;
-
186 decltype(initialSyncUs_) initialSyncUs;
-
187 };
-
188
-
189 CounterData
-
190 getCounterData() const
-
191 {
-
192 std::lock_guard lock(mutex_);
-
193 return {counters_, mode_, start_, initialSyncUs_};
-
194 }
-
195 };
-
196
-
198 struct ServerFeeSummary
-
199 {
-
200 ServerFeeSummary() = default;
-
201
-
202 ServerFeeSummary(
-
203 XRPAmount fee,
-
204 TxQ::Metrics&& escalationMetrics,
-
205 LoadFeeTrack const& loadFeeTrack);
-
206 bool
-
207 operator!=(ServerFeeSummary const& b) const;
-
208
-
209 bool
-
210 operator==(ServerFeeSummary const& b) const
-
211 {
-
212 return !(*this != b);
-
213 }
-
214
-
215 std::uint32_t loadFactorServer = 256;
-
216 std::uint32_t loadBaseServer = 256;
-
217 XRPAmount baseFee{10};
-
218 std::optional<TxQ::Metrics> em = std::nullopt;
-
219 };
-
220
-
221public:
-
222 NetworkOPsImp(
-
223 Application& app,
-
224 NetworkOPs::clock_type& clock,
-
225 bool standalone,
-
226 std::size_t minPeerCount,
-
227 bool start_valid,
-
228 JobQueue& job_queue,
-
229 LedgerMaster& ledgerMaster,
-
230 ValidatorKeys const& validatorKeys,
-
231 boost::asio::io_service& io_svc,
-
232 beast::Journal journal,
-
233 beast::insight::Collector::ptr const& collector)
-
234 : app_(app)
-
235 , m_journal(journal)
-
236 , m_localTX(make_LocalTxs())
-
237 , mMode(start_valid ? OperatingMode::FULL : OperatingMode::DISCONNECTED)
-
238 , heartbeatTimer_(io_svc)
-
239 , clusterTimer_(io_svc)
-
240 , accountHistoryTxTimer_(io_svc)
-
241 , mConsensus(
-
242 app,
-
243 make_FeeVote(
-
244 setup_FeeVote(app_.config().section("voting")),
-
245 app_.logs().journal("FeeVote")),
-
246 ledgerMaster,
-
247 *m_localTX,
-
248 app.getInboundTransactions(),
-
249 beast::get_abstract_clock<std::chrono::steady_clock>(),
-
250 validatorKeys,
-
251 app_.logs().journal("LedgerConsensus"))
-
252 , m_ledgerMaster(ledgerMaster)
-
253 , m_job_queue(job_queue)
-
254 , m_standalone(standalone)
-
255 , minPeerCount_(start_valid ? 0 : minPeerCount)
-
256 , m_stats(std::bind(&NetworkOPsImp::collect_metrics, this), collector)
-
257 {
-
258 }
-
259
-
260 ~NetworkOPsImp() override
-
261 {
-
262 // This clear() is necessary to ensure the shared_ptrs in this map get
-
263 // destroyed NOW because the objects in this map invoke methods on this
-
264 // class when they are destroyed
-
265 mRpcSubMap.clear();
-
266 }
-
267
-
268public:
-
269 OperatingMode
-
270 getOperatingMode() const override;
-
271
-
272 std::string
-
273 strOperatingMode(OperatingMode const mode, bool const admin) const override;
+
38#include <xrpld/app/misc/ValidatorKeys.h>
+
39#include <xrpld/app/misc/ValidatorList.h>
+
40#include <xrpld/app/misc/detail/AccountTxPaging.h>
+
41#include <xrpld/app/rdb/backend/SQLiteDatabase.h>
+
42#include <xrpld/app/tx/apply.h>
+
43#include <xrpld/consensus/Consensus.h>
+
44#include <xrpld/consensus/ConsensusParms.h>
+
45#include <xrpld/overlay/Cluster.h>
+
46#include <xrpld/overlay/Overlay.h>
+
47#include <xrpld/overlay/predicates.h>
+
48#include <xrpld/perflog/PerfLog.h>
+
49#include <xrpld/rpc/BookChanges.h>
+
50#include <xrpld/rpc/DeliveredAmount.h>
+
51#include <xrpld/rpc/MPTokenIssuanceID.h>
+
52#include <xrpld/rpc/ServerHandler.h>
+
53
+
54#include <xrpl/basics/UptimeClock.h>
+
55#include <xrpl/basics/mulDiv.h>
+
56#include <xrpl/basics/safe_cast.h>
+
57#include <xrpl/basics/scope.h>
+
58#include <xrpl/beast/utility/rngfill.h>
+
59#include <xrpl/crypto/RFC1751.h>
+
60#include <xrpl/crypto/csprng.h>
+
61#include <xrpl/protocol/BuildInfo.h>
+
62#include <xrpl/protocol/Feature.h>
+
63#include <xrpl/protocol/MultiApiJson.h>
+
64#include <xrpl/protocol/RPCErr.h>
+
65#include <xrpl/protocol/jss.h>
+
66#include <xrpl/resource/Fees.h>
+
67#include <xrpl/resource/ResourceManager.h>
+
68
+
69#include <boost/asio/ip/host_name.hpp>
+
70#include <boost/asio/steady_timer.hpp>
+
71
+
72#include <algorithm>
+
73#include <exception>
+
74#include <mutex>
+
75#include <optional>
+
76#include <set>
+
77#include <sstream>
+
78#include <string>
+
79#include <tuple>
+
80#include <unordered_map>
+
81
+
82namespace ripple {
+
83
+
84class NetworkOPsImp final : public NetworkOPs
+
85{
+
90 class TransactionStatus
+
91 {
+
92 public:
+
93 std::shared_ptr<Transaction> const transaction;
+
94 bool const admin;
+
95 bool const local;
+
96 FailHard const failType;
+
97 bool applied = false;
+
98 TER result;
+
99
+
100 TransactionStatus(
+
101 std::shared_ptr<Transaction> t,
+
102 bool a,
+
103 bool l,
+
104 FailHard f)
+
105 : transaction(t), admin(a), local(l), failType(f)
+
106 {
+
107 XRPL_ASSERT(
+
108 local || failType == FailHard::no,
+
109 "ripple::NetworkOPsImp::TransactionStatus::TransactionStatus : "
+
110 "valid inputs");
+
111 }
+
112 };
+
113
+
117 enum class DispatchState : unsigned char {
+
118 none,
+
119 scheduled,
+
120 running,
+
121 };
+
122
+
123 static std::array<char const*, 5> const states_;
+
124
+
139 class StateAccounting
+
140 {
+
141 struct Counters
+
142 {
+
143 explicit Counters() = default;
+
144
+
145 std::uint64_t transitions = 0;
+
146 std::chrono::microseconds dur = std::chrono::microseconds(0);
+
147 };
+
148
+
149 OperatingMode mode_ = OperatingMode::DISCONNECTED;
+
150 std::array<Counters, 5> counters_;
+
151 mutable std::mutex mutex_;
+
152 std::chrono::steady_clock::time_point start_ =
+
153 std::chrono::steady_clock::now();
+
154 std::chrono::steady_clock::time_point const processStart_ = start_;
+
155 std::uint64_t initialSyncUs_{0};
+
156 static std::array<Json::StaticString const, 5> const states_;
+
157
+
158 public:
+
159 explicit StateAccounting()
+
160 {
+
161 counters_[static_cast<std::size_t>(OperatingMode::DISCONNECTED)]
+
162 .transitions = 1;
+
163 }
+
164
+
171 void
+
172 mode(OperatingMode om);
+
173
+
179 void
+
180 json(Json::Value& obj) const;
+
181
+
182 struct CounterData
+
183 {
+
184 decltype(counters_) counters;
+
185 decltype(mode_) mode;
+
186 decltype(start_) start;
+
187 decltype(initialSyncUs_) initialSyncUs;
+
188 };
+
189
+
190 CounterData
+
191 getCounterData() const
+
192 {
+
193 std::lock_guard lock(mutex_);
+
194 return {counters_, mode_, start_, initialSyncUs_};
+
195 }
+
196 };
+
197
+
199 struct ServerFeeSummary
+
200 {
+
201 ServerFeeSummary() = default;
+
202
+
203 ServerFeeSummary(
+
204 XRPAmount fee,
+
205 TxQ::Metrics&& escalationMetrics,
+
206 LoadFeeTrack const& loadFeeTrack);
+
207 bool
+
208 operator!=(ServerFeeSummary const& b) const;
+
209
+
210 bool
+
211 operator==(ServerFeeSummary const& b) const
+
212 {
+
213 return !(*this != b);
+
214 }
+
215
+
216 std::uint32_t loadFactorServer = 256;
+
217 std::uint32_t loadBaseServer = 256;
+
218 XRPAmount baseFee{10};
+
219 std::optional<TxQ::Metrics> em = std::nullopt;
+
220 };
+
221
+
222public:
+
223 NetworkOPsImp(
+
224 Application& app,
+
225 NetworkOPs::clock_type& clock,
+
226 bool standalone,
+
227 std::size_t minPeerCount,
+
228 bool start_valid,
+
229 JobQueue& job_queue,
+
230 LedgerMaster& ledgerMaster,
+
231 ValidatorKeys const& validatorKeys,
+
232 boost::asio::io_service& io_svc,
+
233 beast::Journal journal,
+
234 beast::insight::Collector::ptr const& collector)
+
235 : app_(app)
+
236 , m_journal(journal)
+
237 , m_localTX(make_LocalTxs())
+
238 , mMode(start_valid ? OperatingMode::FULL : OperatingMode::DISCONNECTED)
+
239 , heartbeatTimer_(io_svc)
+
240 , clusterTimer_(io_svc)
+
241 , accountHistoryTxTimer_(io_svc)
+
242 , mConsensus(
+
243 app,
+
244 make_FeeVote(
+
245 setup_FeeVote(app_.config().section("voting")),
+
246 app_.logs().journal("FeeVote")),
+
247 ledgerMaster,
+
248 *m_localTX,
+
249 app.getInboundTransactions(),
+
250 beast::get_abstract_clock<std::chrono::steady_clock>(),
+
251 validatorKeys,
+
252 app_.logs().journal("LedgerConsensus"))
+
253 , validatorPK_(
+
254 validatorKeys.keys ? validatorKeys.keys->publicKey
+
255 : decltype(validatorPK_){})
+
256 , validatorMasterPK_(
+
257 validatorKeys.keys ? validatorKeys.keys->masterPublicKey
+
258 : decltype(validatorMasterPK_){})
+
259 , m_ledgerMaster(ledgerMaster)
+
260 , m_job_queue(job_queue)
+
261 , m_standalone(standalone)
+
262 , minPeerCount_(start_valid ? 0 : minPeerCount)
+
263 , m_stats(std::bind(&NetworkOPsImp::collect_metrics, this), collector)
+
264 {
+
265 }
+
266
+
267 ~NetworkOPsImp() override
+
268 {
+
269 // This clear() is necessary to ensure the shared_ptrs in this map get
+
270 // destroyed NOW because the objects in this map invoke methods on this
+
271 // class when they are destroyed
+
272 mRpcSubMap.clear();
+
273 }
274
-
275 std::string
-
276 strOperatingMode(bool const admin = false) const override;
-
277
-
278 //
-
279 // Transaction operations.
-
280 //
+
275public:
+
276 OperatingMode
+
277 getOperatingMode() const override;
+
278
+
279 std::string
+
280 strOperatingMode(OperatingMode const mode, bool const admin) const override;
281
-
282 // Must complete immediately.
-
283 void
-
284 submitTransaction(std::shared_ptr<STTx const> const&) override;
-
285
-
286 void
-
287 processTransaction(
-
288 std::shared_ptr<Transaction>& transaction,
-
289 bool bUnlimited,
-
290 bool bLocal,
-
291 FailHard failType) override;
+
282 std::string
+
283 strOperatingMode(bool const admin = false) const override;
+
284
+
285 //
+
286 // Transaction operations.
+
287 //
+
288
+
289 // Must complete immediately.
+
290 void
+
291 submitTransaction(std::shared_ptr<STTx const> const&) override;
292
-
301 void
-
302 doTransactionSync(
-
303 std::shared_ptr<Transaction> transaction,
-
304 bool bUnlimited,
-
305 FailHard failType);
-
306
-
316 void
-
317 doTransactionAsync(
-
318 std::shared_ptr<Transaction> transaction,
-
319 bool bUnlimited,
-
320 FailHard failtype);
-
321
-
325 void
-
326 transactionBatch();
-
327
-
333 void
-
334 apply(std::unique_lock<std::mutex>& batchLock);
-
335
-
336 //
-
337 // Owner functions.
-
338 //
-
339
-
340 Json::Value
-
341 getOwnerInfo(
-
342 std::shared_ptr<ReadView const> lpLedger,
-
343 AccountID const& account) override;
-
344
+
293 void
+
294 processTransaction(
+
295 std::shared_ptr<Transaction>& transaction,
+
296 bool bUnlimited,
+
297 bool bLocal,
+
298 FailHard failType) override;
+
299
+
308 void
+
309 doTransactionSync(
+
310 std::shared_ptr<Transaction> transaction,
+
311 bool bUnlimited,
+
312 FailHard failType);
+
313
+
323 void
+
324 doTransactionAsync(
+
325 std::shared_ptr<Transaction> transaction,
+
326 bool bUnlimited,
+
327 FailHard failtype);
+
328
+
332 void
+
333 transactionBatch();
+
334
+
340 void
+
341 apply(std::unique_lock<std::mutex>& batchLock);
+
342
+
343 //
+
344 // Owner functions.
345 //
-
346 // Book functions.
-
347 //
-
348
-
349 void
-
350 getBookPage(
-
351 std::shared_ptr<ReadView const>& lpLedger,
-
352 Book const&,
-
353 AccountID const& uTakerID,
-
354 const bool bProof,
-
355 unsigned int iLimit,
-
356 Json::Value const& jvMarker,
-
357 Json::Value& jvResult) override;
-
358
-
359 // Ledger proposal/close functions.
-
360 bool
-
361 processTrustedProposal(RCLCxPeerPos proposal) override;
-
362
-
363 bool
-
364 recvValidation(
-
365 std::shared_ptr<STValidation> const& val,
-
366 std::string const& source) override;
-
367
-
368 void
-
369 mapComplete(std::shared_ptr<SHAMap> const& map, bool fromAcquire) override;
-
370
-
371 // Network state machine.
-
372
-
373 // Used for the "jump" case.
-
374private:
+
346
+
347 Json::Value
+
348 getOwnerInfo(
+
349 std::shared_ptr<ReadView const> lpLedger,
+
350 AccountID const& account) override;
+
351
+
352 //
+
353 // Book functions.
+
354 //
+
355
+
356 void
+
357 getBookPage(
+
358 std::shared_ptr<ReadView const>& lpLedger,
+
359 Book const&,
+
360 AccountID const& uTakerID,
+
361 const bool bProof,
+
362 unsigned int iLimit,
+
363 Json::Value const& jvMarker,
+
364 Json::Value& jvResult) override;
+
365
+
366 // Ledger proposal/close functions.
+
367 bool
+
368 processTrustedProposal(RCLCxPeerPos proposal) override;
+
369
+
370 bool
+
371 recvValidation(
+
372 std::shared_ptr<STValidation> const& val,
+
373 std::string const& source) override;
+
374
375 void
-
376 switchLastClosedLedger(std::shared_ptr<Ledger const> const& newLCL);
-
377 bool
-
378 checkLastClosedLedger(const Overlay::PeerSequence&, uint256& networkClosed);
+
376 mapComplete(std::shared_ptr<SHAMap> const& map, bool fromAcquire) override;
+
377
+
378 // Network state machine.
379
-
380public:
-
381 bool
-
382 beginConsensus(
-
383 uint256 const& networkClosed,
-
384 std::unique_ptr<std::stringstream> const& clog) override;
-
385 void
-
386 endConsensus(std::unique_ptr<std::stringstream> const& clog) override;
-
387 void
-
388 setStandAlone() override;
-
389
-
393 void
-
394 setStateTimer() override;
-
395
-
396 void
-
397 setNeedNetworkLedger() override;
-
398 void
-
399 clearNeedNetworkLedger() override;
-
400 bool
-
401 isNeedNetworkLedger() override;
-
402 bool
-
403 isFull() override;
-
404
+
380 // Used for the "jump" case.
+
381private:
+
382 void
+
383 switchLastClosedLedger(std::shared_ptr<Ledger const> const& newLCL);
+
384 bool
+
385 checkLastClosedLedger(const Overlay::PeerSequence&, uint256& networkClosed);
+
386
+
387public:
+
388 bool
+
389 beginConsensus(
+
390 uint256 const& networkClosed,
+
391 std::unique_ptr<std::stringstream> const& clog) override;
+
392 void
+
393 endConsensus(std::unique_ptr<std::stringstream> const& clog) override;
+
394 void
+
395 setStandAlone() override;
+
396
+
400 void
+
401 setStateTimer() override;
+
402
+
403 void
+
404 setNeedNetworkLedger() override;
405 void
-
406 setMode(OperatingMode om) override;
-
407
-
408 bool
-
409 isBlocked() override;
-
410 bool
-
411 isAmendmentBlocked() override;
+
406 clearNeedNetworkLedger() override;
+
407 bool
+
408 isNeedNetworkLedger() override;
+
409 bool
+
410 isFull() override;
+
411
412 void
-
413 setAmendmentBlocked() override;
-
414 bool
-
415 isAmendmentWarned() override;
-
416 void
-
417 setAmendmentWarned() override;
-
418 void
-
419 clearAmendmentWarned() override;
-
420 bool
-
421 isUNLBlocked() override;
-
422 void
-
423 setUNLBlocked() override;
-
424 void
-
425 clearUNLBlocked() override;
-
426 void
-
427 consensusViewChange() override;
-
428
-
429 Json::Value
-
430 getConsensusInfo() override;
-
431 Json::Value
-
432 getServerInfo(bool human, bool admin, bool counters) override;
+
413 setMode(OperatingMode om) override;
+
414
+
415 bool
+
416 isBlocked() override;
+
417 bool
+
418 isAmendmentBlocked() override;
+
419 void
+
420 setAmendmentBlocked() override;
+
421 bool
+
422 isAmendmentWarned() override;
+
423 void
+
424 setAmendmentWarned() override;
+
425 void
+
426 clearAmendmentWarned() override;
+
427 bool
+
428 isUNLBlocked() override;
+
429 void
+
430 setUNLBlocked() override;
+
431 void
+
432 clearUNLBlocked() override;
433 void
-
434 clearLedgerFetch() override;
-
435 Json::Value
-
436 getLedgerFetchInfo() override;
-
437 std::uint32_t
-
438 acceptLedger(
-
439 std::optional<std::chrono::milliseconds> consensusDelay) override;
+
434 consensusViewChange() override;
+
435
+
436 Json::Value
+
437 getConsensusInfo() override;
+
438 Json::Value
+
439 getServerInfo(bool human, bool admin, bool counters) override;
440 void
-
441 reportFeeChange() override;
-
442 void
-
443 reportConsensusStateChange(ConsensusPhase phase);
-
444
-
445 void
-
446 updateLocalTx(ReadView const& view) override;
-
447 std::size_t
-
448 getLocalTxCount() override;
-
449
-
450 //
-
451 // Monitoring: publisher side.
-
452 //
-
453 void
-
454 pubLedger(std::shared_ptr<ReadView const> const& lpAccepted) override;
-
455 void
-
456 pubProposedTransaction(
-
457 std::shared_ptr<ReadView const> const& ledger,
-
458 std::shared_ptr<STTx const> const& transaction,
-
459 TER result) override;
+
441 clearLedgerFetch() override;
+
442 Json::Value
+
443 getLedgerFetchInfo() override;
+
444 std::uint32_t
+
445 acceptLedger(
+
446 std::optional<std::chrono::milliseconds> consensusDelay) override;
+
447 void
+
448 reportFeeChange() override;
+
449 void
+
450 reportConsensusStateChange(ConsensusPhase phase);
+
451
+
452 void
+
453 updateLocalTx(ReadView const& view) override;
+
454 std::size_t
+
455 getLocalTxCount() override;
+
456
+
457 //
+
458 // Monitoring: publisher side.
+
459 //
460 void
-
461 pubValidation(std::shared_ptr<STValidation> const& val) override;
-
462
-
463 //--------------------------------------------------------------------------
-
464 //
-
465 // InfoSub::Source.
-
466 //
+
461 pubLedger(std::shared_ptr<ReadView const> const& lpAccepted) override;
+
462 void
+
463 pubProposedTransaction(
+
464 std::shared_ptr<ReadView const> const& ledger,
+
465 std::shared_ptr<STTx const> const& transaction,
+
466 TER result) override;
467 void
-
468 subAccount(
-
469 InfoSub::ref ispListener,
-
470 hash_set<AccountID> const& vnaAccountIDs,
-
471 bool rt) override;
-
472 void
-
473 unsubAccount(
-
474 InfoSub::ref ispListener,
-
475 hash_set<AccountID> const& vnaAccountIDs,
-
476 bool rt) override;
-
477
-
478 // Just remove the subscription from the tracking
-
479 // not from the InfoSub. Needed for InfoSub destruction
-
480 void
-
481 unsubAccountInternal(
-
482 std::uint64_t seq,
-
483 hash_set<AccountID> const& vnaAccountIDs,
-
484 bool rt) override;
-
485
-
486 error_code_i
-
487 subAccountHistory(InfoSub::ref ispListener, AccountID const& account)
-
488 override;
-
489 void
-
490 unsubAccountHistory(
-
491 InfoSub::ref ispListener,
-
492 AccountID const& account,
-
493 bool historyOnly) override;
-
494
-
495 void
-
496 unsubAccountHistoryInternal(
-
497 std::uint64_t seq,
-
498 AccountID const& account,
-
499 bool historyOnly) override;
-
500
-
501 bool
-
502 subLedger(InfoSub::ref ispListener, Json::Value& jvResult) override;
-
503 bool
-
504 unsubLedger(std::uint64_t uListener) override;
-
505
-
506 bool
-
507 subBookChanges(InfoSub::ref ispListener) override;
+
468 pubValidation(std::shared_ptr<STValidation> const& val) override;
+
469
+
470 //--------------------------------------------------------------------------
+
471 //
+
472 // InfoSub::Source.
+
473 //
+
474 void
+
475 subAccount(
+
476 InfoSub::ref ispListener,
+
477 hash_set<AccountID> const& vnaAccountIDs,
+
478 bool rt) override;
+
479 void
+
480 unsubAccount(
+
481 InfoSub::ref ispListener,
+
482 hash_set<AccountID> const& vnaAccountIDs,
+
483 bool rt) override;
+
484
+
485 // Just remove the subscription from the tracking
+
486 // not from the InfoSub. Needed for InfoSub destruction
+
487 void
+
488 unsubAccountInternal(
+
489 std::uint64_t seq,
+
490 hash_set<AccountID> const& vnaAccountIDs,
+
491 bool rt) override;
+
492
+
493 error_code_i
+
494 subAccountHistory(InfoSub::ref ispListener, AccountID const& account)
+
495 override;
+
496 void
+
497 unsubAccountHistory(
+
498 InfoSub::ref ispListener,
+
499 AccountID const& account,
+
500 bool historyOnly) override;
+
501
+
502 void
+
503 unsubAccountHistoryInternal(
+
504 std::uint64_t seq,
+
505 AccountID const& account,
+
506 bool historyOnly) override;
+
507
508 bool
-
509 unsubBookChanges(std::uint64_t uListener) override;
-
510
-
511 bool
-
512 subServer(InfoSub::ref ispListener, Json::Value& jvResult, bool admin)
-
513 override;
-
514 bool
-
515 unsubServer(std::uint64_t uListener) override;
-
516
-
517 bool
-
518 subBook(InfoSub::ref ispListener, Book const&) override;
-
519 bool
-
520 unsubBook(std::uint64_t uListener, Book const&) override;
-
521
-
522 bool
-
523 subManifests(InfoSub::ref ispListener) override;
+
509 subLedger(InfoSub::ref ispListener, Json::Value& jvResult) override;
+
510 bool
+
511 unsubLedger(std::uint64_t uListener) override;
+
512
+
513 bool
+
514 subBookChanges(InfoSub::ref ispListener) override;
+
515 bool
+
516 unsubBookChanges(std::uint64_t uListener) override;
+
517
+
518 bool
+
519 subServer(InfoSub::ref ispListener, Json::Value& jvResult, bool admin)
+
520 override;
+
521 bool
+
522 unsubServer(std::uint64_t uListener) override;
+
523
524 bool
-
525 unsubManifests(std::uint64_t uListener) override;
-
526 void
-
527 pubManifest(Manifest const&) override;
+
525 subBook(InfoSub::ref ispListener, Book const&) override;
+
526 bool
+
527 unsubBook(std::uint64_t uListener, Book const&) override;
528
529 bool
-
530 subTransactions(InfoSub::ref ispListener) override;
+
530 subManifests(InfoSub::ref ispListener) override;
531 bool
-
532 unsubTransactions(std::uint64_t uListener) override;
-
533
-
534 bool
-
535 subRTTransactions(InfoSub::ref ispListener) override;
+
532 unsubManifests(std::uint64_t uListener) override;
+
533 void
+
534 pubManifest(Manifest const&) override;
+
535
536 bool
-
537 unsubRTTransactions(std::uint64_t uListener) override;
-
538
-
539 bool
-
540 subValidations(InfoSub::ref ispListener) override;
+
537 subTransactions(InfoSub::ref ispListener) override;
+
538 bool
+
539 unsubTransactions(std::uint64_t uListener) override;
+
540
541 bool
-
542 unsubValidations(std::uint64_t uListener) override;
-
543
-
544 bool
-
545 subPeerStatus(InfoSub::ref ispListener) override;
+
542 subRTTransactions(InfoSub::ref ispListener) override;
+
543 bool
+
544 unsubRTTransactions(std::uint64_t uListener) override;
+
545
546 bool
-
547 unsubPeerStatus(std::uint64_t uListener) override;
-
548 void
-
549 pubPeerStatus(std::function<Json::Value(void)> const&) override;
+
547 subValidations(InfoSub::ref ispListener) override;
+
548 bool
+
549 unsubValidations(std::uint64_t uListener) override;
550
551 bool
-
552 subConsensus(InfoSub::ref ispListener) override;
+
552 subPeerStatus(InfoSub::ref ispListener) override;
553 bool
-
554 unsubConsensus(std::uint64_t uListener) override;
-
555
-
556 InfoSub::pointer
-
557 findRpcSub(std::string const& strUrl) override;
-
558 InfoSub::pointer
-
559 addRpcSub(std::string const& strUrl, InfoSub::ref) override;
+
554 unsubPeerStatus(std::uint64_t uListener) override;
+
555 void
+
556 pubPeerStatus(std::function<Json::Value(void)> const&) override;
+
557
+
558 bool
+
559 subConsensus(InfoSub::ref ispListener) override;
560 bool
-
561 tryRemoveRpcSub(std::string const& strUrl) override;
+
561 unsubConsensus(std::uint64_t uListener) override;
562
-
563 void
-
564 stop() override
-
565 {
-
566 {
-
567 boost::system::error_code ec;
-
568 heartbeatTimer_.cancel(ec);
-
569 if (ec)
-
570 {
-
571 JLOG(m_journal.error())
-
572 << "NetworkOPs: heartbeatTimer cancel error: "
-
573 << ec.message();
-
574 }
-
575
-
576 ec.clear();
-
577 clusterTimer_.cancel(ec);
-
578 if (ec)
-
579 {
-
580 JLOG(m_journal.error())
-
581 << "NetworkOPs: clusterTimer cancel error: "
-
582 << ec.message();
-
583 }
-
584
-
585 ec.clear();
-
586 accountHistoryTxTimer_.cancel(ec);
-
587 if (ec)
-
588 {
-
589 JLOG(m_journal.error())
-
590 << "NetworkOPs: accountHistoryTxTimer cancel error: "
-
591 << ec.message();
-
592 }
-
593 }
-
594 // Make sure that any waitHandlers pending in our timers are done.
-
595 using namespace std::chrono_literals;
-
596 waitHandlerCounter_.join("NetworkOPs", 1s, m_journal);
-
597 }
-
598
-
599 void
-
600 stateAccounting(Json::Value& obj) override;
-
601
-
602private:
-
603 void
-
604 setTimer(
-
605 boost::asio::steady_timer& timer,
-
606 std::chrono::milliseconds const& expiry_time,
-
607 std::function<void()> onExpire,
-
608 std::function<void()> onError);
-
609 void
-
610 setHeartbeatTimer();
-
611 void
-
612 setClusterTimer();
-
613 void
-
614 processHeartbeatTimer();
-
615 void
-
616 processClusterTimer();
-
617
-
618 MultiApiJson
-
619 transJson(
-
620 std::shared_ptr<STTx const> const& transaction,
-
621 TER result,
-
622 bool validated,
-
623 std::shared_ptr<ReadView const> const& ledger,
-
624 std::optional<std::reference_wrapper<TxMeta const>> meta);
-
625
-
626 void
-
627 pubValidatedTransaction(
-
628 std::shared_ptr<ReadView const> const& ledger,
-
629 AcceptedLedgerTx const& transaction,
-
630 bool last);
-
631
-
632 void
-
633 pubAccountTransaction(
-
634 std::shared_ptr<ReadView const> const& ledger,
-
635 AcceptedLedgerTx const& transaction,
-
636 bool last);
-
637
-
638 void
-
639 pubProposedAccountTransaction(
-
640 std::shared_ptr<ReadView const> const& ledger,
-
641 std::shared_ptr<STTx const> const& transaction,
-
642 TER result);
-
643
-
644 void
-
645 pubServer();
-
646 void
-
647 pubConsensus(ConsensusPhase phase);
-
648
-
649 std::string
-
650 getHostId(bool forAdmin);
-
651
-
652private:
-
653 using SubMapType = hash_map<std::uint64_t, InfoSub::wptr>;
-
654 using SubInfoMapType = hash_map<AccountID, SubMapType>;
-
655 using subRpcMapType = hash_map<std::string, InfoSub::pointer>;
-
656
-
657 /*
-
658 * With a validated ledger to separate history and future, the node
-
659 * streams historical txns with negative indexes starting from -1,
-
660 * and streams future txns starting from index 0.
-
661 * The SubAccountHistoryIndex struct maintains these indexes.
-
662 * It also has a flag stopHistorical_ for stopping streaming
-
663 * the historical txns.
-
664 */
-
665 struct SubAccountHistoryIndex
-
666 {
-
667 AccountID const accountId_;
-
668 // forward
-
669 std::uint32_t forwardTxIndex_;
-
670 // separate backward and forward
-
671 std::uint32_t separationLedgerSeq_;
-
672 // history, backward
-
673 std::uint32_t historyLastLedgerSeq_;
-
674 std::int32_t historyTxIndex_;
-
675 bool haveHistorical_;
-
676 std::atomic<bool> stopHistorical_;
-
677
-
678 SubAccountHistoryIndex(AccountID const& accountId)
-
679 : accountId_(accountId)
-
680 , forwardTxIndex_(0)
-
681 , separationLedgerSeq_(0)
-
682 , historyLastLedgerSeq_(0)
-
683 , historyTxIndex_(-1)
-
684 , haveHistorical_(false)
-
685 , stopHistorical_(false)
-
686 {
-
687 }
-
688 };
-
689 struct SubAccountHistoryInfo
-
690 {
-
691 InfoSub::pointer sink_;
-
692 std::shared_ptr<SubAccountHistoryIndex> index_;
-
693 };
-
694 struct SubAccountHistoryInfoWeak
-
695 {
-
696 InfoSub::wptr sinkWptr_;
-
697 std::shared_ptr<SubAccountHistoryIndex> index_;
-
698 };
-
699 using SubAccountHistoryMapType =
-
700 hash_map<AccountID, hash_map<std::uint64_t, SubAccountHistoryInfoWeak>>;
-
701
-
705 void
-
706 subAccountHistoryStart(
-
707 std::shared_ptr<ReadView const> const& ledger,
-
708 SubAccountHistoryInfoWeak& subInfo);
-
709 void
-
710 addAccountHistoryJob(SubAccountHistoryInfoWeak subInfo);
-
711 void
-
712 setAccountHistoryJobTimer(SubAccountHistoryInfoWeak subInfo);
-
713
-
714 Application& app_;
-
715 beast::Journal m_journal;
-
716
-
717 std::unique_ptr<LocalTxs> m_localTX;
-
718
-
719 std::recursive_mutex mSubLock;
+
563 InfoSub::pointer
+
564 findRpcSub(std::string const& strUrl) override;
+
565 InfoSub::pointer
+
566 addRpcSub(std::string const& strUrl, InfoSub::ref) override;
+
567 bool
+
568 tryRemoveRpcSub(std::string const& strUrl) override;
+
569
+
570 void
+
571 stop() override
+
572 {
+
573 {
+
574 boost::system::error_code ec;
+
575 heartbeatTimer_.cancel(ec);
+
576 if (ec)
+
577 {
+
578 JLOG(m_journal.error())
+
579 << "NetworkOPs: heartbeatTimer cancel error: "
+
580 << ec.message();
+
581 }
+
582
+
583 ec.clear();
+
584 clusterTimer_.cancel(ec);
+
585 if (ec)
+
586 {
+
587 JLOG(m_journal.error())
+
588 << "NetworkOPs: clusterTimer cancel error: "
+
589 << ec.message();
+
590 }
+
591
+
592 ec.clear();
+
593 accountHistoryTxTimer_.cancel(ec);
+
594 if (ec)
+
595 {
+
596 JLOG(m_journal.error())
+
597 << "NetworkOPs: accountHistoryTxTimer cancel error: "
+
598 << ec.message();
+
599 }
+
600 }
+
601 // Make sure that any waitHandlers pending in our timers are done.
+
602 using namespace std::chrono_literals;
+
603 waitHandlerCounter_.join("NetworkOPs", 1s, m_journal);
+
604 }
+
605
+
606 void
+
607 stateAccounting(Json::Value& obj) override;
+
608
+
609private:
+
610 void
+
611 setTimer(
+
612 boost::asio::steady_timer& timer,
+
613 std::chrono::milliseconds const& expiry_time,
+
614 std::function<void()> onExpire,
+
615 std::function<void()> onError);
+
616 void
+
617 setHeartbeatTimer();
+
618 void
+
619 setClusterTimer();
+
620 void
+
621 processHeartbeatTimer();
+
622 void
+
623 processClusterTimer();
+
624
+
625 MultiApiJson
+
626 transJson(
+
627 std::shared_ptr<STTx const> const& transaction,
+
628 TER result,
+
629 bool validated,
+
630 std::shared_ptr<ReadView const> const& ledger,
+
631 std::optional<std::reference_wrapper<TxMeta const>> meta);
+
632
+
633 void
+
634 pubValidatedTransaction(
+
635 std::shared_ptr<ReadView const> const& ledger,
+
636 AcceptedLedgerTx const& transaction,
+
637 bool last);
+
638
+
639 void
+
640 pubAccountTransaction(
+
641 std::shared_ptr<ReadView const> const& ledger,
+
642 AcceptedLedgerTx const& transaction,
+
643 bool last);
+
644
+
645 void
+
646 pubProposedAccountTransaction(
+
647 std::shared_ptr<ReadView const> const& ledger,
+
648 std::shared_ptr<STTx const> const& transaction,
+
649 TER result);
+
650
+
651 void
+
652 pubServer();
+
653 void
+
654 pubConsensus(ConsensusPhase phase);
+
655
+
656 std::string
+
657 getHostId(bool forAdmin);
+
658
+
659private:
+
660 using SubMapType = hash_map<std::uint64_t, InfoSub::wptr>;
+
661 using SubInfoMapType = hash_map<AccountID, SubMapType>;
+
662 using subRpcMapType = hash_map<std::string, InfoSub::pointer>;
+
663
+
664 /*
+
665 * With a validated ledger to separate history and future, the node
+
666 * streams historical txns with negative indexes starting from -1,
+
667 * and streams future txns starting from index 0.
+
668 * The SubAccountHistoryIndex struct maintains these indexes.
+
669 * It also has a flag stopHistorical_ for stopping streaming
+
670 * the historical txns.
+
671 */
+
672 struct SubAccountHistoryIndex
+
673 {
+
674 AccountID const accountId_;
+
675 // forward
+
676 std::uint32_t forwardTxIndex_;
+
677 // separate backward and forward
+
678 std::uint32_t separationLedgerSeq_;
+
679 // history, backward
+
680 std::uint32_t historyLastLedgerSeq_;
+
681 std::int32_t historyTxIndex_;
+
682 bool haveHistorical_;
+
683 std::atomic<bool> stopHistorical_;
+
684
+
685 SubAccountHistoryIndex(AccountID const& accountId)
+
686 : accountId_(accountId)
+
687 , forwardTxIndex_(0)
+
688 , separationLedgerSeq_(0)
+
689 , historyLastLedgerSeq_(0)
+
690 , historyTxIndex_(-1)
+
691 , haveHistorical_(false)
+
692 , stopHistorical_(false)
+
693 {
+
694 }
+
695 };
+
696 struct SubAccountHistoryInfo
+
697 {
+
698 InfoSub::pointer sink_;
+
699 std::shared_ptr<SubAccountHistoryIndex> index_;
+
700 };
+
701 struct SubAccountHistoryInfoWeak
+
702 {
+
703 InfoSub::wptr sinkWptr_;
+
704 std::shared_ptr<SubAccountHistoryIndex> index_;
+
705 };
+
706 using SubAccountHistoryMapType =
+
707 hash_map<AccountID, hash_map<std::uint64_t, SubAccountHistoryInfoWeak>>;
+
708
+
712 void
+
713 subAccountHistoryStart(
+
714 std::shared_ptr<ReadView const> const& ledger,
+
715 SubAccountHistoryInfoWeak& subInfo);
+
716 void
+
717 addAccountHistoryJob(SubAccountHistoryInfoWeak subInfo);
+
718 void
+
719 setAccountHistoryJobTimer(SubAccountHistoryInfoWeak subInfo);
720
-
721 std::atomic<OperatingMode> mMode;
-
722
-
723 std::atomic<bool> needNetworkLedger_{false};
-
724 std::atomic<bool> amendmentBlocked_{false};
-
725 std::atomic<bool> amendmentWarned_{false};
-
726 std::atomic<bool> unlBlocked_{false};
+
721 Application& app_;
+
722 beast::Journal m_journal;
+
723
+
724 std::unique_ptr<LocalTxs> m_localTX;
+
725
+
726 std::recursive_mutex mSubLock;
727
-
728 ClosureCounter<void, boost::system::error_code const&> waitHandlerCounter_;
-
729 boost::asio::steady_timer heartbeatTimer_;
-
730 boost::asio::steady_timer clusterTimer_;
-
731 boost::asio::steady_timer accountHistoryTxTimer_;
-
732
-
733 RCLConsensus mConsensus;
+
728 std::atomic<OperatingMode> mMode;
+
729
+
730 std::atomic<bool> needNetworkLedger_{false};
+
731 std::atomic<bool> amendmentBlocked_{false};
+
732 std::atomic<bool> amendmentWarned_{false};
+
733 std::atomic<bool> unlBlocked_{false};
734
-
735 ConsensusPhase mLastConsensusPhase;
-
736
-
737 LedgerMaster& m_ledgerMaster;
-
738
-
739 SubInfoMapType mSubAccount;
-
740 SubInfoMapType mSubRTAccount;
+
735 ClosureCounter<void, boost::system::error_code const&> waitHandlerCounter_;
+
736 boost::asio::steady_timer heartbeatTimer_;
+
737 boost::asio::steady_timer clusterTimer_;
+
738 boost::asio::steady_timer accountHistoryTxTimer_;
+
739
+
740 RCLConsensus mConsensus;
741
-
742 subRpcMapType mRpcSubMap;
-
743
-
744 SubAccountHistoryMapType mSubAccountHistory;
-
745
-
746 enum SubTypes {
-
747 sLedger, // Accepted ledgers.
-
748 sManifests, // Received validator manifests.
-
749 sServer, // When server changes connectivity state.
-
750 sTransactions, // All accepted transactions.
-
751 sRTTransactions, // All proposed and accepted transactions.
-
752 sValidations, // Received validations.
-
753 sPeerStatus, // Peer status changes.
-
754 sConsensusPhase, // Consensus phase
-
755 sBookChanges, // Per-ledger order book changes
-
756 sLastEntry // Any new entry must be ADDED ABOVE this one
-
757 };
-
758
-
759 std::array<SubMapType, SubTypes::sLastEntry> mStreamMaps;
-
760
-
761 ServerFeeSummary mLastFeeSummary;
-
762
-
763 JobQueue& m_job_queue;
-
764
-
765 // Whether we are in standalone mode.
-
766 bool const m_standalone;
-
767
-
768 // The number of nodes that we need to consider ourselves connected.
-
769 std::size_t const minPeerCount_;
+
742 std::optional<PublicKey> const validatorPK_;
+
743 std::optional<PublicKey> const validatorMasterPK_;
+
744
+
745 ConsensusPhase mLastConsensusPhase;
+
746
+
747 LedgerMaster& m_ledgerMaster;
+
748
+
749 SubInfoMapType mSubAccount;
+
750 SubInfoMapType mSubRTAccount;
+
751
+
752 subRpcMapType mRpcSubMap;
+
753
+
754 SubAccountHistoryMapType mSubAccountHistory;
+
755
+
756 enum SubTypes {
+
757 sLedger, // Accepted ledgers.
+
758 sManifests, // Received validator manifests.
+
759 sServer, // When server changes connectivity state.
+
760 sTransactions, // All accepted transactions.
+
761 sRTTransactions, // All proposed and accepted transactions.
+
762 sValidations, // Received validations.
+
763 sPeerStatus, // Peer status changes.
+
764 sConsensusPhase, // Consensus phase
+
765 sBookChanges, // Per-ledger order book changes
+
766 sLastEntry // Any new entry must be ADDED ABOVE this one
+
767 };
+
768
+
769 std::array<SubMapType, SubTypes::sLastEntry> mStreamMaps;
770
-
771 // Transaction batching.
-
772 std::condition_variable mCond;
-
773 std::mutex mMutex;
-
774 DispatchState mDispatchState = DispatchState::none;
-
775 std::vector<TransactionStatus> mTransactions;
-
776
-
777 StateAccounting accounting_{};
-
778
-
779 std::set<uint256> pendingValidations_;
-
780 std::mutex validationsMutex_;
-
781
-
782private:
-
783 struct Stats
-
784 {
-
785 template <class Handler>
-
786 Stats(
-
787 Handler const& handler,
-
788 beast::insight::Collector::ptr const& collector)
-
789 : hook(collector->make_hook(handler))
-
790 , disconnected_duration(collector->make_gauge(
-
791 "State_Accounting",
-
792 "Disconnected_duration"))
-
793 , connected_duration(collector->make_gauge(
-
794 "State_Accounting",
-
795 "Connected_duration"))
-
796 , syncing_duration(
-
797 collector->make_gauge("State_Accounting", "Syncing_duration"))
-
798 , tracking_duration(collector->make_gauge(
-
799 "State_Accounting",
-
800 "Tracking_duration"))
-
801 , full_duration(
-
802 collector->make_gauge("State_Accounting", "Full_duration"))
-
803 , disconnected_transitions(collector->make_gauge(
+
771 ServerFeeSummary mLastFeeSummary;
+
772
+
773 JobQueue& m_job_queue;
+
774
+
775 // Whether we are in standalone mode.
+
776 bool const m_standalone;
+
777
+
778 // The number of nodes that we need to consider ourselves connected.
+
779 std::size_t const minPeerCount_;
+
780
+
781 // Transaction batching.
+
782 std::condition_variable mCond;
+
783 std::mutex mMutex;
+
784 DispatchState mDispatchState = DispatchState::none;
+
785 std::vector<TransactionStatus> mTransactions;
+
786
+
787 StateAccounting accounting_{};
+
788
+
789 std::set<uint256> pendingValidations_;
+
790 std::mutex validationsMutex_;
+
791
+
792private:
+
793 struct Stats
+
794 {
+
795 template <class Handler>
+
796 Stats(
+
797 Handler const& handler,
+
798 beast::insight::Collector::ptr const& collector)
+
799 : hook(collector->make_hook(handler))
+
800 , disconnected_duration(collector->make_gauge(
+
801 "State_Accounting",
+
802 "Disconnected_duration"))
+
803 , connected_duration(collector->make_gauge(
804 "State_Accounting",
-
805 "Disconnected_transitions"))
-
806 , connected_transitions(collector->make_gauge(
-
807 "State_Accounting",
-
808 "Connected_transitions"))
-
809 , syncing_transitions(collector->make_gauge(
-
810 "State_Accounting",
-
811 "Syncing_transitions"))
-
812 , tracking_transitions(collector->make_gauge(
-
813 "State_Accounting",
-
814 "Tracking_transitions"))
-
815 , full_transitions(
-
816 collector->make_gauge("State_Accounting", "Full_transitions"))
-
817 {
-
818 }
-
819
-
820 beast::insight::Hook hook;
-
821 beast::insight::Gauge disconnected_duration;
-
822 beast::insight::Gauge connected_duration;
-
823 beast::insight::Gauge syncing_duration;
-
824 beast::insight::Gauge tracking_duration;
-
825 beast::insight::Gauge full_duration;
-
826
-
827 beast::insight::Gauge disconnected_transitions;
-
828 beast::insight::Gauge connected_transitions;
-
829 beast::insight::Gauge syncing_transitions;
-
830 beast::insight::Gauge tracking_transitions;
-
831 beast::insight::Gauge full_transitions;
-
832 };
-
833
-
834 std::mutex m_statsMutex; // Mutex to lock m_stats
-
835 Stats m_stats;
+
805 "Connected_duration"))
+
806 , syncing_duration(
+
807 collector->make_gauge("State_Accounting", "Syncing_duration"))
+
808 , tracking_duration(collector->make_gauge(
+
809 "State_Accounting",
+
810 "Tracking_duration"))
+
811 , full_duration(
+
812 collector->make_gauge("State_Accounting", "Full_duration"))
+
813 , disconnected_transitions(collector->make_gauge(
+
814 "State_Accounting",
+
815 "Disconnected_transitions"))
+
816 , connected_transitions(collector->make_gauge(
+
817 "State_Accounting",
+
818 "Connected_transitions"))
+
819 , syncing_transitions(collector->make_gauge(
+
820 "State_Accounting",
+
821 "Syncing_transitions"))
+
822 , tracking_transitions(collector->make_gauge(
+
823 "State_Accounting",
+
824 "Tracking_transitions"))
+
825 , full_transitions(
+
826 collector->make_gauge("State_Accounting", "Full_transitions"))
+
827 {
+
828 }
+
829
+
830 beast::insight::Hook hook;
+
831 beast::insight::Gauge disconnected_duration;
+
832 beast::insight::Gauge connected_duration;
+
833 beast::insight::Gauge syncing_duration;
+
834 beast::insight::Gauge tracking_duration;
+
835 beast::insight::Gauge full_duration;
836
-
837private:
-
838 void
-
839 collect_metrics();
-
840};
-
841
-
842//------------------------------------------------------------------------------
+
837 beast::insight::Gauge disconnected_transitions;
+
838 beast::insight::Gauge connected_transitions;
+
839 beast::insight::Gauge syncing_transitions;
+
840 beast::insight::Gauge tracking_transitions;
+
841 beast::insight::Gauge full_transitions;
+
842 };
843
-
844static std::array<char const*, 5> const stateNames{
-
845 {"disconnected", "connected", "syncing", "tracking", "full"}};
+
844 std::mutex m_statsMutex; // Mutex to lock m_stats
+
845 Stats m_stats;
846
-
847std::array<char const*, 5> const NetworkOPsImp::states_ = stateNames;
-
848
-
849std::array<Json::StaticString const, 5> const
-
850 NetworkOPsImp::StateAccounting::states_ = {
-
851 {Json::StaticString(stateNames[0]),
-
852 Json::StaticString(stateNames[1]),
-
853 Json::StaticString(stateNames[2]),
-
854 Json::StaticString(stateNames[3]),
-
855 Json::StaticString(stateNames[4])}};
+
847private:
+
848 void
+
849 collect_metrics();
+
850};
+
851
+
852//------------------------------------------------------------------------------
+
853
+
854static std::array<char const*, 5> const stateNames{
+
855 {"disconnected", "connected", "syncing", "tracking", "full"}};
856
-
857static auto const genesisAccountId = calcAccountID(
-
858 generateKeyPair(KeyType::secp256k1, generateSeed("masterpassphrase"))
-
859 .first);
-
860
-
861//------------------------------------------------------------------------------
-
862inline OperatingMode
-
863NetworkOPsImp::getOperatingMode() const
-
864{
-
865 return mMode;
-
866}
-
867
-
868inline std::string
-
869NetworkOPsImp::strOperatingMode(bool const admin /* = false */) const
-
870{
-
871 return strOperatingMode(mMode, admin);
-
872}
-
873
-
874inline void
-
875NetworkOPsImp::setStandAlone()
-
876{
-
877 setMode(OperatingMode::FULL);
-
878}
-
879
-
880inline void
-
881NetworkOPsImp::setNeedNetworkLedger()
-
882{
-
883 needNetworkLedger_ = true;
-
884}
-
885
-
886inline void
-
887NetworkOPsImp::clearNeedNetworkLedger()
-
888{
-
889 needNetworkLedger_ = false;
-
890}
-
891
-
892inline bool
-
893NetworkOPsImp::isNeedNetworkLedger()
-
894{
-
895 return needNetworkLedger_;
-
896}
-
897
-
898inline bool
-
899NetworkOPsImp::isFull()
-
900{
-
901 return !needNetworkLedger_ && (mMode == OperatingMode::FULL);
-
902}
-
903
-
904std::string
-
905NetworkOPsImp::getHostId(bool forAdmin)
-
906{
-
907 static std::string const hostname = boost::asio::ip::host_name();
-
908
-
909 if (forAdmin)
-
910 return hostname;
-
911
-
912 // For non-admin uses hash the node public key into a
-
913 // single RFC1751 word:
-
914 static std::string const shroudedHostId = [this]() {
-
915 auto const& id = app_.nodeIdentity();
-
916
-
917 return RFC1751::getWordFromBlob(id.first.data(), id.first.size());
-
918 }();
-
919
-
920 return shroudedHostId;
-
921}
-
922
-
923void
-
924NetworkOPsImp::setStateTimer()
-
925{
-
926 setHeartbeatTimer();
-
927
-
928 // Only do this work if a cluster is configured
-
929 if (app_.cluster().size() != 0)
-
930 setClusterTimer();
+
857std::array<char const*, 5> const NetworkOPsImp::states_ = stateNames;
+
858
+
859std::array<Json::StaticString const, 5> const
+
860 NetworkOPsImp::StateAccounting::states_ = {
+
861 {Json::StaticString(stateNames[0]),
+
862 Json::StaticString(stateNames[1]),
+
863 Json::StaticString(stateNames[2]),
+
864 Json::StaticString(stateNames[3]),
+
865 Json::StaticString(stateNames[4])}};
+
866
+
867static auto const genesisAccountId = calcAccountID(
+
868 generateKeyPair(KeyType::secp256k1, generateSeed("masterpassphrase"))
+
869 .first);
+
870
+
871//------------------------------------------------------------------------------
+
872inline OperatingMode
+
873NetworkOPsImp::getOperatingMode() const
+
874{
+
875 return mMode;
+
876}
+
877
+
878inline std::string
+
879NetworkOPsImp::strOperatingMode(bool const admin /* = false */) const
+
880{
+
881 return strOperatingMode(mMode, admin);
+
882}
+
883
+
884inline void
+
885NetworkOPsImp::setStandAlone()
+
886{
+
887 setMode(OperatingMode::FULL);
+
888}
+
889
+
890inline void
+
891NetworkOPsImp::setNeedNetworkLedger()
+
892{
+
893 needNetworkLedger_ = true;
+
894}
+
895
+
896inline void
+
897NetworkOPsImp::clearNeedNetworkLedger()
+
898{
+
899 needNetworkLedger_ = false;
+
900}
+
901
+
902inline bool
+
903NetworkOPsImp::isNeedNetworkLedger()
+
904{
+
905 return needNetworkLedger_;
+
906}
+
907
+
908inline bool
+
909NetworkOPsImp::isFull()
+
910{
+
911 return !needNetworkLedger_ && (mMode == OperatingMode::FULL);
+
912}
+
913
+
914std::string
+
915NetworkOPsImp::getHostId(bool forAdmin)
+
916{
+
917 static std::string const hostname = boost::asio::ip::host_name();
+
918
+
919 if (forAdmin)
+
920 return hostname;
+
921
+
922 // For non-admin uses hash the node public key into a
+
923 // single RFC1751 word:
+
924 static std::string const shroudedHostId = [this]() {
+
925 auto const& id = app_.nodeIdentity();
+
926
+
927 return RFC1751::getWordFromBlob(id.first.data(), id.first.size());
+
928 }();
+
929
+
930 return shroudedHostId;
931}
932
933void
-
934NetworkOPsImp::setTimer(
-
935 boost::asio::steady_timer& timer,
-
936 const std::chrono::milliseconds& expiry_time,
-
937 std::function<void()> onExpire,
-
938 std::function<void()> onError)
-
939{
-
940 // Only start the timer if waitHandlerCounter_ is not yet joined.
-
941 if (auto optionalCountedHandler = waitHandlerCounter_.wrap(
-
942 [this, onExpire, onError](boost::system::error_code const& e) {
-
943 if ((e.value() == boost::system::errc::success) &&
-
944 (!m_job_queue.isStopped()))
-
945 {
-
946 onExpire();
-
947 }
-
948 // Recover as best we can if an unexpected error occurs.
-
949 if (e.value() != boost::system::errc::success &&
-
950 e.value() != boost::asio::error::operation_aborted)
-
951 {
-
952 // Try again later and hope for the best.
-
953 JLOG(m_journal.error())
-
954 << "Timer got error '" << e.message()
-
955 << "'. Restarting timer.";
-
956 onError();
+
934NetworkOPsImp::setStateTimer()
+
935{
+
936 setHeartbeatTimer();
+
937
+
938 // Only do this work if a cluster is configured
+
939 if (app_.cluster().size() != 0)
+
940 setClusterTimer();
+
941}
+
942
+
943void
+
944NetworkOPsImp::setTimer(
+
945 boost::asio::steady_timer& timer,
+
946 const std::chrono::milliseconds& expiry_time,
+
947 std::function<void()> onExpire,
+
948 std::function<void()> onError)
+
949{
+
950 // Only start the timer if waitHandlerCounter_ is not yet joined.
+
951 if (auto optionalCountedHandler = waitHandlerCounter_.wrap(
+
952 [this, onExpire, onError](boost::system::error_code const& e) {
+
953 if ((e.value() == boost::system::errc::success) &&
+
954 (!m_job_queue.isStopped()))
+
955 {
+
956 onExpire();
957 }
-
958 }))
-
959 {
-
960 timer.expires_from_now(expiry_time);
-
961 timer.async_wait(std::move(*optionalCountedHandler));
-
962 }
-
963}
-
964
-
965void
-
966NetworkOPsImp::setHeartbeatTimer()
-
967{
-
968 setTimer(
-
969 heartbeatTimer_,
-
970 mConsensus.parms().ledgerGRANULARITY,
-
971 [this]() {
-
972 m_job_queue.addJob(jtNETOP_TIMER, "NetOPs.heartbeat", [this]() {
-
973 processHeartbeatTimer();
-
974 });
-
975 },
-
976 [this]() { setHeartbeatTimer(); });
-
977}
-
978
-
979void
-
980NetworkOPsImp::setClusterTimer()
-
981{
-
982 using namespace std::chrono_literals;
-
983
-
984 setTimer(
-
985 clusterTimer_,
-
986 10s,
-
987 [this]() {
-
988 m_job_queue.addJob(jtNETOP_CLUSTER, "NetOPs.cluster", [this]() {
-
989 processClusterTimer();
-
990 });
-
991 },
-
992 [this]() { setClusterTimer(); });
-
993}
-
994
-
995void
-
996NetworkOPsImp::setAccountHistoryJobTimer(SubAccountHistoryInfoWeak subInfo)
-
997{
-
998 JLOG(m_journal.debug()) << "Scheduling AccountHistory job for account "
-
999 << toBase58(subInfo.index_->accountId_);
-
1000 using namespace std::chrono_literals;
-
1001 setTimer(
-
1002 accountHistoryTxTimer_,
-
1003 4s,
-
1004 [this, subInfo]() { addAccountHistoryJob(subInfo); },
-
1005 [this, subInfo]() { setAccountHistoryJobTimer(subInfo); });
-
1006}
-
1007
-
1008void
-
1009NetworkOPsImp::processHeartbeatTimer()
-
1010{
-
1011 RclConsensusLogger clog(
-
1012 "Heartbeat Timer", mConsensus.validating(), m_journal);
-
1013 {
-
1014 std::unique_lock lock{app_.getMasterMutex()};
-
1015
-
1016 // VFALCO NOTE This is for diagnosing a crash on exit
-
1017 LoadManager& mgr(app_.getLoadManager());
-
1018 mgr.heartbeat();
-
1019
-
1020 std::size_t const numPeers = app_.overlay().size();
-
1021
-
1022 // do we have sufficient peers? If not, we are disconnected.
-
1023 if (numPeers < minPeerCount_)
-
1024 {
-
1025 if (mMode != OperatingMode::DISCONNECTED)
-
1026 {
-
1027 setMode(OperatingMode::DISCONNECTED);
-
1028 std::stringstream ss;
-
1029 ss << "Node count (" << numPeers << ") has fallen "
-
1030 << "below required minimum (" << minPeerCount_ << ").";
-
1031 JLOG(m_journal.warn()) << ss.str();
-
1032 CLOG(clog.ss()) << "set mode to DISCONNECTED: " << ss.str();
-
1033 }
-
1034 else
-
1035 {
-
1036 CLOG(clog.ss())
-
1037 << "already DISCONNECTED. too few peers (" << numPeers
-
1038 << "), need at least " << minPeerCount_;
-
1039 }
-
1040
-
1041 // MasterMutex lock need not be held to call setHeartbeatTimer()
-
1042 lock.unlock();
-
1043 // We do not call mConsensus.timerEntry until there are enough
-
1044 // peers providing meaningful inputs to consensus
-
1045 setHeartbeatTimer();
-
1046
-
1047 return;
-
1048 }
-
1049
-
1050 if (mMode == OperatingMode::DISCONNECTED)
-
1051 {
-
1052 setMode(OperatingMode::CONNECTED);
-
1053 JLOG(m_journal.info())
-
1054 << "Node count (" << numPeers << ") is sufficient.";
-
1055 CLOG(clog.ss()) << "setting mode to CONNECTED based on " << numPeers
-
1056 << " peers. ";
-
1057 }
-
1058
-
1059 // Check if the last validated ledger forces a change between these
-
1060 // states.
-
1061 auto origMode = mMode.load();
-
1062 CLOG(clog.ss()) << "mode: " << strOperatingMode(origMode, true);
-
1063 if (mMode == OperatingMode::SYNCING)
-
1064 setMode(OperatingMode::SYNCING);
-
1065 else if (mMode == OperatingMode::CONNECTED)
-
1066 setMode(OperatingMode::CONNECTED);
-
1067 auto newMode = mMode.load();
-
1068 if (origMode != newMode)
-
1069 {
-
1070 CLOG(clog.ss())
-
1071 << ", changing to " << strOperatingMode(newMode, true);
-
1072 }
-
1073 CLOG(clog.ss()) << ". ";
-
1074 }
-
1075
-
1076 mConsensus.timerEntry(app_.timeKeeper().closeTime(), clog.ss());
-
1077
-
1078 CLOG(clog.ss()) << "consensus phase " << to_string(mLastConsensusPhase);
-
1079 const ConsensusPhase currPhase = mConsensus.phase();
-
1080 if (mLastConsensusPhase != currPhase)
-
1081 {
-
1082 reportConsensusStateChange(currPhase);
-
1083 mLastConsensusPhase = currPhase;
-
1084 CLOG(clog.ss()) << " changed to " << to_string(mLastConsensusPhase);
-
1085 }
-
1086 CLOG(clog.ss()) << ". ";
+
958 // Recover as best we can if an unexpected error occurs.
+
959 if (e.value() != boost::system::errc::success &&
+
960 e.value() != boost::asio::error::operation_aborted)
+
961 {
+
962 // Try again later and hope for the best.
+
963 JLOG(m_journal.error())
+
964 << "Timer got error '" << e.message()
+
965 << "'. Restarting timer.";
+
966 onError();
+
967 }
+
968 }))
+
969 {
+
970 timer.expires_from_now(expiry_time);
+
971 timer.async_wait(std::move(*optionalCountedHandler));
+
972 }
+
973}
+
974
+
975void
+
976NetworkOPsImp::setHeartbeatTimer()
+
977{
+
978 setTimer(
+
979 heartbeatTimer_,
+
980 mConsensus.parms().ledgerGRANULARITY,
+
981 [this]() {
+
982 m_job_queue.addJob(jtNETOP_TIMER, "NetOPs.heartbeat", [this]() {
+
983 processHeartbeatTimer();
+
984 });
+
985 },
+
986 [this]() { setHeartbeatTimer(); });
+
987}
+
988
+
989void
+
990NetworkOPsImp::setClusterTimer()
+
991{
+
992 using namespace std::chrono_literals;
+
993
+
994 setTimer(
+
995 clusterTimer_,
+
996 10s,
+
997 [this]() {
+
998 m_job_queue.addJob(jtNETOP_CLUSTER, "NetOPs.cluster", [this]() {
+
999 processClusterTimer();
+
1000 });
+
1001 },
+
1002 [this]() { setClusterTimer(); });
+
1003}
+
1004
+
1005void
+
1006NetworkOPsImp::setAccountHistoryJobTimer(SubAccountHistoryInfoWeak subInfo)
+
1007{
+
1008 JLOG(m_journal.debug()) << "Scheduling AccountHistory job for account "
+
1009 << toBase58(subInfo.index_->accountId_);
+
1010 using namespace std::chrono_literals;
+
1011 setTimer(
+
1012 accountHistoryTxTimer_,
+
1013 4s,
+
1014 [this, subInfo]() { addAccountHistoryJob(subInfo); },
+
1015 [this, subInfo]() { setAccountHistoryJobTimer(subInfo); });
+
1016}
+
1017
+
1018void
+
1019NetworkOPsImp::processHeartbeatTimer()
+
1020{
+
1021 RclConsensusLogger clog(
+
1022 "Heartbeat Timer", mConsensus.validating(), m_journal);
+
1023 {
+
1024 std::unique_lock lock{app_.getMasterMutex()};
+
1025
+
1026 // VFALCO NOTE This is for diagnosing a crash on exit
+
1027 LoadManager& mgr(app_.getLoadManager());
+
1028 mgr.heartbeat();
+
1029
+
1030 std::size_t const numPeers = app_.overlay().size();
+
1031
+
1032 // do we have sufficient peers? If not, we are disconnected.
+
1033 if (numPeers < minPeerCount_)
+
1034 {
+
1035 if (mMode != OperatingMode::DISCONNECTED)
+
1036 {
+
1037 setMode(OperatingMode::DISCONNECTED);
+
1038 std::stringstream ss;
+
1039 ss << "Node count (" << numPeers << ") has fallen "
+
1040 << "below required minimum (" << minPeerCount_ << ").";
+
1041 JLOG(m_journal.warn()) << ss.str();
+
1042 CLOG(clog.ss()) << "set mode to DISCONNECTED: " << ss.str();
+
1043 }
+
1044 else
+
1045 {
+
1046 CLOG(clog.ss())
+
1047 << "already DISCONNECTED. too few peers (" << numPeers
+
1048 << "), need at least " << minPeerCount_;
+
1049 }
+
1050
+
1051 // MasterMutex lock need not be held to call setHeartbeatTimer()
+
1052 lock.unlock();
+
1053 // We do not call mConsensus.timerEntry until there are enough
+
1054 // peers providing meaningful inputs to consensus
+
1055 setHeartbeatTimer();
+
1056
+
1057 return;
+
1058 }
+
1059
+
1060 if (mMode == OperatingMode::DISCONNECTED)
+
1061 {
+
1062 setMode(OperatingMode::CONNECTED);
+
1063 JLOG(m_journal.info())
+
1064 << "Node count (" << numPeers << ") is sufficient.";
+
1065 CLOG(clog.ss()) << "setting mode to CONNECTED based on " << numPeers
+
1066 << " peers. ";
+
1067 }
+
1068
+
1069 // Check if the last validated ledger forces a change between these
+
1070 // states.
+
1071 auto origMode = mMode.load();
+
1072 CLOG(clog.ss()) << "mode: " << strOperatingMode(origMode, true);
+
1073 if (mMode == OperatingMode::SYNCING)
+
1074 setMode(OperatingMode::SYNCING);
+
1075 else if (mMode == OperatingMode::CONNECTED)
+
1076 setMode(OperatingMode::CONNECTED);
+
1077 auto newMode = mMode.load();
+
1078 if (origMode != newMode)
+
1079 {
+
1080 CLOG(clog.ss())
+
1081 << ", changing to " << strOperatingMode(newMode, true);
+
1082 }
+
1083 CLOG(clog.ss()) << ". ";
+
1084 }
+
1085
+
1086 mConsensus.timerEntry(app_.timeKeeper().closeTime(), clog.ss());
1087
-
1088 setHeartbeatTimer();
-
1089}
-
1090
-
1091void
-
1092NetworkOPsImp::processClusterTimer()
-
1093{
-
1094 if (app_.cluster().size() == 0)
-
1095 return;
-
1096
-
1097 using namespace std::chrono_literals;
-
1098
-
1099 bool const update = app_.cluster().update(
-
1100 app_.nodeIdentity().first,
-
1101 "",
-
1102 (m_ledgerMaster.getValidatedLedgerAge() <= 4min)
-
1103 ? app_.getFeeTrack().getLocalFee()
-
1104 : 0,
-
1105 app_.timeKeeper().now());
+
1088 CLOG(clog.ss()) << "consensus phase " << to_string(mLastConsensusPhase);
+
1089 const ConsensusPhase currPhase = mConsensus.phase();
+
1090 if (mLastConsensusPhase != currPhase)
+
1091 {
+
1092 reportConsensusStateChange(currPhase);
+
1093 mLastConsensusPhase = currPhase;
+
1094 CLOG(clog.ss()) << " changed to " << to_string(mLastConsensusPhase);
+
1095 }
+
1096 CLOG(clog.ss()) << ". ";
+
1097
+
1098 setHeartbeatTimer();
+
1099}
+
1100
+
1101void
+
1102NetworkOPsImp::processClusterTimer()
+
1103{
+
1104 if (app_.cluster().size() == 0)
+
1105 return;
1106
-
1107 if (!update)
-
1108 {
-
1109 JLOG(m_journal.debug()) << "Too soon to send cluster update";
-
1110 setClusterTimer();
-
1111 return;
-
1112 }
-
1113
-
1114 protocol::TMCluster cluster;
-
1115 app_.cluster().for_each([&cluster](ClusterNode const& node) {
-
1116 protocol::TMClusterNode& n = *cluster.add_clusternodes();
-
1117 n.set_publickey(toBase58(TokenType::NodePublic, node.identity()));
-
1118 n.set_reporttime(node.getReportTime().time_since_epoch().count());
-
1119 n.set_nodeload(node.getLoadFee());
-
1120 if (!node.name().empty())
-
1121 n.set_nodename(node.name());
-
1122 });
+
1107 using namespace std::chrono_literals;
+
1108
+
1109 bool const update = app_.cluster().update(
+
1110 app_.nodeIdentity().first,
+
1111 "",
+
1112 (m_ledgerMaster.getValidatedLedgerAge() <= 4min)
+
1113 ? app_.getFeeTrack().getLocalFee()
+
1114 : 0,
+
1115 app_.timeKeeper().now());
+
1116
+
1117 if (!update)
+
1118 {
+
1119 JLOG(m_journal.debug()) << "Too soon to send cluster update";
+
1120 setClusterTimer();
+
1121 return;
+
1122 }
1123
-
1124 Resource::Gossip gossip = app_.getResourceManager().exportConsumers();
-
1125 for (auto& item : gossip.items)
-
1126 {
-
1127 protocol::TMLoadSource& node = *cluster.add_loadsources();
-
1128 node.set_name(to_string(item.address));
-
1129 node.set_cost(item.balance);
-
1130 }
-
1131 app_.overlay().foreach(send_if(
-
1132 std::make_shared<Message>(cluster, protocol::mtCLUSTER),
-
1133 peer_in_cluster()));
-
1134 setClusterTimer();
-
1135}
-
1136
-
1137//------------------------------------------------------------------------------
-
1138
-
1139std::string
-
1140NetworkOPsImp::strOperatingMode(OperatingMode const mode, bool const admin)
-
1141 const
-
1142{
-
1143 if (mode == OperatingMode::FULL && admin)
-
1144 {
-
1145 auto const consensusMode = mConsensus.mode();
-
1146 if (consensusMode != ConsensusMode::wrongLedger)
-
1147 {
-
1148 if (consensusMode == ConsensusMode::proposing)
-
1149 return "proposing";
-
1150
-
1151 if (mConsensus.validating())
-
1152 return "validating";
-
1153 }
-
1154 }
-
1155
-
1156 return states_[static_cast<std::size_t>(mode)];
-
1157}
-
1158
-
1159void
-
1160NetworkOPsImp::submitTransaction(std::shared_ptr<STTx const> const& iTrans)
-
1161{
-
1162 if (isNeedNetworkLedger())
-
1163 {
-
1164 // Nothing we can do if we've never been in sync
-
1165 return;
-
1166 }
-
1167
-
1168 // this is an asynchronous interface
-
1169 auto const trans = sterilize(*iTrans);
-
1170
-
1171 auto const txid = trans->getTransactionID();
-
1172 auto const flags = app_.getHashRouter().getFlags(txid);
-
1173
-
1174 if ((flags & SF_BAD) != 0)
-
1175 {
-
1176 JLOG(m_journal.warn()) << "Submitted transaction cached bad";
-
1177 return;
-
1178 }
-
1179
-
1180 try
-
1181 {
-
1182 auto const [validity, reason] = checkValidity(
-
1183 app_.getHashRouter(),
-
1184 *trans,
-
1185 m_ledgerMaster.getValidatedRules(),
-
1186 app_.config());
-
1187
-
1188 if (validity != Validity::Valid)
-
1189 {
-
1190 JLOG(m_journal.warn())
-
1191 << "Submitted transaction invalid: " << reason;
-
1192 return;
-
1193 }
-
1194 }
-
1195 catch (std::exception const& ex)
-
1196 {
-
1197 JLOG(m_journal.warn())
-
1198 << "Exception checking transaction " << txid << ": " << ex.what();
-
1199
-
1200 return;
-
1201 }
-
1202
-
1203 std::string reason;
-
1204
-
1205 auto tx = std::make_shared<Transaction>(trans, reason, app_);
-
1206
-
1207 m_job_queue.addJob(jtTRANSACTION, "submitTxn", [this, tx]() {
-
1208 auto t = tx;
-
1209 processTransaction(t, false, false, FailHard::no);
-
1210 });
-
1211}
+
1124 protocol::TMCluster cluster;
+
1125 app_.cluster().for_each([&cluster](ClusterNode const& node) {
+
1126 protocol::TMClusterNode& n = *cluster.add_clusternodes();
+
1127 n.set_publickey(toBase58(TokenType::NodePublic, node.identity()));
+
1128 n.set_reporttime(node.getReportTime().time_since_epoch().count());
+
1129 n.set_nodeload(node.getLoadFee());
+
1130 if (!node.name().empty())
+
1131 n.set_nodename(node.name());
+
1132 });
+
1133
+
1134 Resource::Gossip gossip = app_.getResourceManager().exportConsumers();
+
1135 for (auto& item : gossip.items)
+
1136 {
+
1137 protocol::TMLoadSource& node = *cluster.add_loadsources();
+
1138 node.set_name(to_string(item.address));
+
1139 node.set_cost(item.balance);
+
1140 }
+
1141 app_.overlay().foreach(send_if(
+
1142 std::make_shared<Message>(cluster, protocol::mtCLUSTER),
+
1143 peer_in_cluster()));
+
1144 setClusterTimer();
+
1145}
+
1146
+
1147//------------------------------------------------------------------------------
+
1148
+
1149std::string
+
1150NetworkOPsImp::strOperatingMode(OperatingMode const mode, bool const admin)
+
1151 const
+
1152{
+
1153 if (mode == OperatingMode::FULL && admin)
+
1154 {
+
1155 auto const consensusMode = mConsensus.mode();
+
1156 if (consensusMode != ConsensusMode::wrongLedger)
+
1157 {
+
1158 if (consensusMode == ConsensusMode::proposing)
+
1159 return "proposing";
+
1160
+
1161 if (mConsensus.validating())
+
1162 return "validating";
+
1163 }
+
1164 }
+
1165
+
1166 return states_[static_cast<std::size_t>(mode)];
+
1167}
+
1168
+
1169void
+
1170NetworkOPsImp::submitTransaction(std::shared_ptr<STTx const> const& iTrans)
+
1171{
+
1172 if (isNeedNetworkLedger())
+
1173 {
+
1174 // Nothing we can do if we've never been in sync
+
1175 return;
+
1176 }
+
1177
+
1178 // this is an asynchronous interface
+
1179 auto const trans = sterilize(*iTrans);
+
1180
+
1181 auto const txid = trans->getTransactionID();
+
1182 auto const flags = app_.getHashRouter().getFlags(txid);
+
1183
+
1184 if ((flags & SF_BAD) != 0)
+
1185 {
+
1186 JLOG(m_journal.warn()) << "Submitted transaction cached bad";
+
1187 return;
+
1188 }
+
1189
+
1190 try
+
1191 {
+
1192 auto const [validity, reason] = checkValidity(
+
1193 app_.getHashRouter(),
+
1194 *trans,
+
1195 m_ledgerMaster.getValidatedRules(),
+
1196 app_.config());
+
1197
+
1198 if (validity != Validity::Valid)
+
1199 {
+
1200 JLOG(m_journal.warn())
+
1201 << "Submitted transaction invalid: " << reason;
+
1202 return;
+
1203 }
+
1204 }
+
1205 catch (std::exception const& ex)
+
1206 {
+
1207 JLOG(m_journal.warn())
+
1208 << "Exception checking transaction " << txid << ": " << ex.what();
+
1209
+
1210 return;
+
1211 }
1212
-
1213void
-
1214NetworkOPsImp::processTransaction(
-
1215 std::shared_ptr<Transaction>& transaction,
-
1216 bool bUnlimited,
-
1217 bool bLocal,
-
1218 FailHard failType)
-
1219{
-
1220 auto ev = m_job_queue.makeLoadEvent(jtTXN_PROC, "ProcessTXN");
-
1221 auto const newFlags = app_.getHashRouter().getFlags(transaction->getID());
+
1213 std::string reason;
+
1214
+
1215 auto tx = std::make_shared<Transaction>(trans, reason, app_);
+
1216
+
1217 m_job_queue.addJob(jtTRANSACTION, "submitTxn", [this, tx]() {
+
1218 auto t = tx;
+
1219 processTransaction(t, false, false, FailHard::no);
+
1220 });
+
1221}
1222
-
1223 if ((newFlags & SF_BAD) != 0)
-
1224 {
-
1225 // cached bad
-
1226 JLOG(m_journal.warn()) << transaction->getID() << ": cached bad!\n";
-
1227 transaction->setStatus(INVALID);
-
1228 transaction->setResult(temBAD_SIGNATURE);
-
1229 return;
-
1230 }
-
1231
-
1232 // NOTE eahennis - I think this check is redundant,
-
1233 // but I'm not 100% sure yet.
-
1234 // If so, only cost is looking up HashRouter flags.
-
1235 auto const view = m_ledgerMaster.getCurrentLedger();
-
1236 auto const [validity, reason] = checkValidity(
-
1237 app_.getHashRouter(),
-
1238 *transaction->getSTransaction(),
-
1239 view->rules(),
-
1240 app_.config());
-
1241 XRPL_ASSERT(
-
1242 validity == Validity::Valid,
-
1243 "ripple::NetworkOPsImp::processTransaction : valid validity");
-
1244
-
1245 // Not concerned with local checks at this point.
-
1246 if (validity == Validity::SigBad)
-
1247 {
-
1248 JLOG(m_journal.info()) << "Transaction has bad signature: " << reason;
-
1249 transaction->setStatus(INVALID);
-
1250 transaction->setResult(temBAD_SIGNATURE);
-
1251 app_.getHashRouter().setFlags(transaction->getID(), SF_BAD);
-
1252 return;
-
1253 }
+
1223void
+
1224NetworkOPsImp::processTransaction(
+
1225 std::shared_ptr<Transaction>& transaction,
+
1226 bool bUnlimited,
+
1227 bool bLocal,
+
1228 FailHard failType)
+
1229{
+
1230 auto ev = m_job_queue.makeLoadEvent(jtTXN_PROC, "ProcessTXN");
+
1231 auto const newFlags = app_.getHashRouter().getFlags(transaction->getID());
+
1232
+
1233 if ((newFlags & SF_BAD) != 0)
+
1234 {
+
1235 // cached bad
+
1236 JLOG(m_journal.warn()) << transaction->getID() << ": cached bad!\n";
+
1237 transaction->setStatus(INVALID);
+
1238 transaction->setResult(temBAD_SIGNATURE);
+
1239 return;
+
1240 }
+
1241
+
1242 // NOTE eahennis - I think this check is redundant,
+
1243 // but I'm not 100% sure yet.
+
1244 // If so, only cost is looking up HashRouter flags.
+
1245 auto const view = m_ledgerMaster.getCurrentLedger();
+
1246 auto const [validity, reason] = checkValidity(
+
1247 app_.getHashRouter(),
+
1248 *transaction->getSTransaction(),
+
1249 view->rules(),
+
1250 app_.config());
+
1251 XRPL_ASSERT(
+
1252 validity == Validity::Valid,
+
1253 "ripple::NetworkOPsImp::processTransaction : valid validity");
1254
-
1255 // canonicalize can change our pointer
-
1256 app_.getMasterTransaction().canonicalize(&transaction);
-
1257
-
1258 if (bLocal)
-
1259 doTransactionSync(transaction, bUnlimited, failType);
-
1260 else
-
1261 doTransactionAsync(transaction, bUnlimited, failType);
-
1262}
-
1263
-
1264void
-
1265NetworkOPsImp::doTransactionAsync(
-
1266 std::shared_ptr<Transaction> transaction,
-
1267 bool bUnlimited,
-
1268 FailHard failType)
-
1269{
-
1270 std::lock_guard lock(mMutex);
-
1271
-
1272 if (transaction->getApplying())
-
1273 return;
-
1274
-
1275 mTransactions.push_back(
-
1276 TransactionStatus(transaction, bUnlimited, false, failType));
-
1277 transaction->setApplying();
-
1278
-
1279 if (mDispatchState == DispatchState::none)
-
1280 {
-
1281 if (m_job_queue.addJob(
-
1282 jtBATCH, "transactionBatch", [this]() { transactionBatch(); }))
-
1283 {
-
1284 mDispatchState = DispatchState::scheduled;
-
1285 }
-
1286 }
-
1287}
+
1255 // Not concerned with local checks at this point.
+
1256 if (validity == Validity::SigBad)
+
1257 {
+
1258 JLOG(m_journal.info()) << "Transaction has bad signature: " << reason;
+
1259 transaction->setStatus(INVALID);
+
1260 transaction->setResult(temBAD_SIGNATURE);
+
1261 app_.getHashRouter().setFlags(transaction->getID(), SF_BAD);
+
1262 return;
+
1263 }
+
1264
+
1265 // canonicalize can change our pointer
+
1266 app_.getMasterTransaction().canonicalize(&transaction);
+
1267
+
1268 if (bLocal)
+
1269 doTransactionSync(transaction, bUnlimited, failType);
+
1270 else
+
1271 doTransactionAsync(transaction, bUnlimited, failType);
+
1272}
+
1273
+
1274void
+
1275NetworkOPsImp::doTransactionAsync(
+
1276 std::shared_ptr<Transaction> transaction,
+
1277 bool bUnlimited,
+
1278 FailHard failType)
+
1279{
+
1280 std::lock_guard lock(mMutex);
+
1281
+
1282 if (transaction->getApplying())
+
1283 return;
+
1284
+
1285 mTransactions.push_back(
+
1286 TransactionStatus(transaction, bUnlimited, false, failType));
+
1287 transaction->setApplying();
1288
-
1289void
-
1290NetworkOPsImp::doTransactionSync(
-
1291 std::shared_ptr<Transaction> transaction,
-
1292 bool bUnlimited,
-
1293 FailHard failType)
-
1294{
-
1295 std::unique_lock<std::mutex> lock(mMutex);
-
1296
-
1297 if (!transaction->getApplying())
-
1298 {
-
1299 mTransactions.push_back(
-
1300 TransactionStatus(transaction, bUnlimited, true, failType));
-
1301 transaction->setApplying();
-
1302 }
-
1303
-
1304 do
-
1305 {
-
1306 if (mDispatchState == DispatchState::running)
-
1307 {
-
1308 // A batch processing job is already running, so wait.
-
1309 mCond.wait(lock);
-
1310 }
-
1311 else
-
1312 {
-
1313 apply(lock);
-
1314
-
1315 if (mTransactions.size())
-
1316 {
-
1317 // More transactions need to be applied, but by another job.
-
1318 if (m_job_queue.addJob(jtBATCH, "transactionBatch", [this]() {
-
1319 transactionBatch();
-
1320 }))
-
1321 {
-
1322 mDispatchState = DispatchState::scheduled;
-
1323 }
-
1324 }
-
1325 }
-
1326 } while (transaction->getApplying());
-
1327}
-
1328
-
1329void
-
1330NetworkOPsImp::transactionBatch()
-
1331{
-
1332 std::unique_lock<std::mutex> lock(mMutex);
-
1333
-
1334 if (mDispatchState == DispatchState::running)
-
1335 return;
-
1336
-
1337 while (mTransactions.size())
-
1338 {
-
1339 apply(lock);
-
1340 }
-
1341}
-
1342
-
1343void
-
1344NetworkOPsImp::apply(std::unique_lock<std::mutex>& batchLock)
-
1345{
-
1346 std::vector<TransactionStatus> submit_held;
-
1347 std::vector<TransactionStatus> transactions;
-
1348 mTransactions.swap(transactions);
-
1349 XRPL_ASSERT(
-
1350 !transactions.empty(),
-
1351 "ripple::NetworkOPsImp::apply : non-empty transactions");
-
1352 XRPL_ASSERT(
-
1353 mDispatchState != DispatchState::running,
-
1354 "ripple::NetworkOPsImp::apply : is not running");
-
1355
-
1356 mDispatchState = DispatchState::running;
-
1357
-
1358 batchLock.unlock();
-
1359
-
1360 {
-
1361 std::unique_lock masterLock{app_.getMasterMutex(), std::defer_lock};
-
1362 bool changed = false;
-
1363 {
-
1364 std::unique_lock ledgerLock{
-
1365 m_ledgerMaster.peekMutex(), std::defer_lock};
-
1366 std::lock(masterLock, ledgerLock);
+
1289 if (mDispatchState == DispatchState::none)
+
1290 {
+
1291 if (m_job_queue.addJob(
+
1292 jtBATCH, "transactionBatch", [this]() { transactionBatch(); }))
+
1293 {
+
1294 mDispatchState = DispatchState::scheduled;
+
1295 }
+
1296 }
+
1297}
+
1298
+
1299void
+
1300NetworkOPsImp::doTransactionSync(
+
1301 std::shared_ptr<Transaction> transaction,
+
1302 bool bUnlimited,
+
1303 FailHard failType)
+
1304{
+
1305 std::unique_lock<std::mutex> lock(mMutex);
+
1306
+
1307 if (!transaction->getApplying())
+
1308 {
+
1309 mTransactions.push_back(
+
1310 TransactionStatus(transaction, bUnlimited, true, failType));
+
1311 transaction->setApplying();
+
1312 }
+
1313
+
1314 do
+
1315 {
+
1316 if (mDispatchState == DispatchState::running)
+
1317 {
+
1318 // A batch processing job is already running, so wait.
+
1319 mCond.wait(lock);
+
1320 }
+
1321 else
+
1322 {
+
1323 apply(lock);
+
1324
+
1325 if (mTransactions.size())
+
1326 {
+
1327 // More transactions need to be applied, but by another job.
+
1328 if (m_job_queue.addJob(jtBATCH, "transactionBatch", [this]() {
+
1329 transactionBatch();
+
1330 }))
+
1331 {
+
1332 mDispatchState = DispatchState::scheduled;
+
1333 }
+
1334 }
+
1335 }
+
1336 } while (transaction->getApplying());
+
1337}
+
1338
+
1339void
+
1340NetworkOPsImp::transactionBatch()
+
1341{
+
1342 std::unique_lock<std::mutex> lock(mMutex);
+
1343
+
1344 if (mDispatchState == DispatchState::running)
+
1345 return;
+
1346
+
1347 while (mTransactions.size())
+
1348 {
+
1349 apply(lock);
+
1350 }
+
1351}
+
1352
+
1353void
+
1354NetworkOPsImp::apply(std::unique_lock<std::mutex>& batchLock)
+
1355{
+
1356 std::vector<TransactionStatus> submit_held;
+
1357 std::vector<TransactionStatus> transactions;
+
1358 mTransactions.swap(transactions);
+
1359 XRPL_ASSERT(
+
1360 !transactions.empty(),
+
1361 "ripple::NetworkOPsImp::apply : non-empty transactions");
+
1362 XRPL_ASSERT(
+
1363 mDispatchState != DispatchState::running,
+
1364 "ripple::NetworkOPsImp::apply : is not running");
+
1365
+
1366 mDispatchState = DispatchState::running;
1367
-
1368 app_.openLedger().modify([&](OpenView& view, beast::Journal j) {
-
1369 for (TransactionStatus& e : transactions)
-
1370 {
-
1371 // we check before adding to the batch
-
1372 ApplyFlags flags = tapNONE;
-
1373 if (e.admin)
-
1374 flags |= tapUNLIMITED;
-
1375
-
1376 if (e.failType == FailHard::yes)
-
1377 flags |= tapFAIL_HARD;
-
1378
-
1379 auto const result = app_.getTxQ().apply(
-
1380 app_, view, e.transaction->getSTransaction(), flags, j);
-
1381 e.result = result.ter;
-
1382 e.applied = result.applied;
-
1383 changed = changed || result.applied;
-
1384 }
-
1385 return changed;
-
1386 });
-
1387 }
-
1388 if (changed)
-
1389 reportFeeChange();
-
1390
-
1391 std::optional<LedgerIndex> validatedLedgerIndex;
-
1392 if (auto const l = m_ledgerMaster.getValidatedLedger())
-
1393 validatedLedgerIndex = l->info().seq;
-
1394
-
1395 auto newOL = app_.openLedger().current();
-
1396 for (TransactionStatus& e : transactions)
-
1397 {
-
1398 e.transaction->clearSubmitResult();
-
1399
-
1400 if (e.applied)
-
1401 {
-
1402 pubProposedTransaction(
-
1403 newOL, e.transaction->getSTransaction(), e.result);
-
1404 e.transaction->setApplied();
-
1405 }
-
1406
-
1407 e.transaction->setResult(e.result);
-
1408
-
1409 if (isTemMalformed(e.result))
-
1410 app_.getHashRouter().setFlags(e.transaction->getID(), SF_BAD);
-
1411
-
1412#ifdef DEBUG
-
1413 if (e.result != tesSUCCESS)
-
1414 {
-
1415 std::string token, human;
+
1368 batchLock.unlock();
+
1369
+
1370 {
+
1371 std::unique_lock masterLock{app_.getMasterMutex(), std::defer_lock};
+
1372 bool changed = false;
+
1373 {
+
1374 std::unique_lock ledgerLock{
+
1375 m_ledgerMaster.peekMutex(), std::defer_lock};
+
1376 std::lock(masterLock, ledgerLock);
+
1377
+
1378 app_.openLedger().modify([&](OpenView& view, beast::Journal j) {
+
1379 for (TransactionStatus& e : transactions)
+
1380 {
+
1381 // we check before adding to the batch
+
1382 ApplyFlags flags = tapNONE;
+
1383 if (e.admin)
+
1384 flags |= tapUNLIMITED;
+
1385
+
1386 if (e.failType == FailHard::yes)
+
1387 flags |= tapFAIL_HARD;
+
1388
+
1389 auto const result = app_.getTxQ().apply(
+
1390 app_, view, e.transaction->getSTransaction(), flags, j);
+
1391 e.result = result.ter;
+
1392 e.applied = result.applied;
+
1393 changed = changed || result.applied;
+
1394 }
+
1395 return changed;
+
1396 });
+
1397 }
+
1398 if (changed)
+
1399 reportFeeChange();
+
1400
+
1401 std::optional<LedgerIndex> validatedLedgerIndex;
+
1402 if (auto const l = m_ledgerMaster.getValidatedLedger())
+
1403 validatedLedgerIndex = l->info().seq;
+
1404
+
1405 auto newOL = app_.openLedger().current();
+
1406 for (TransactionStatus& e : transactions)
+
1407 {
+
1408 e.transaction->clearSubmitResult();
+
1409
+
1410 if (e.applied)
+
1411 {
+
1412 pubProposedTransaction(
+
1413 newOL, e.transaction->getSTransaction(), e.result);
+
1414 e.transaction->setApplied();
+
1415 }
1416
-
1417 if (transResultInfo(e.result, token, human))
-
1418 {
-
1419 JLOG(m_journal.info())
-
1420 << "TransactionResult: " << token << ": " << human;
-
1421 }
-
1422 }
-
1423#endif
-
1424
-
1425 bool addLocal = e.local;
+
1417 e.transaction->setResult(e.result);
+
1418
+
1419 if (isTemMalformed(e.result))
+
1420 app_.getHashRouter().setFlags(e.transaction->getID(), SF_BAD);
+
1421
+
1422#ifdef DEBUG
+
1423 if (e.result != tesSUCCESS)
+
1424 {
+
1425 std::string token, human;
1426
-
1427 if (e.result == tesSUCCESS)
-
1428 {
-
1429 JLOG(m_journal.debug())
-
1430 << "Transaction is now included in open ledger";
-
1431 e.transaction->setStatus(INCLUDED);
-
1432
-
1433 auto const& txCur = e.transaction->getSTransaction();
-
1434 auto const txNext = m_ledgerMaster.popAcctTransaction(txCur);
-
1435 if (txNext)
-
1436 {
-
1437 std::string reason;
-
1438 auto const trans = sterilize(*txNext);
-
1439 auto t = std::make_shared<Transaction>(trans, reason, app_);
-
1440 submit_held.emplace_back(t, false, false, FailHard::no);
-
1441 t->setApplying();
-
1442 }
-
1443 }
-
1444 else if (e.result == tefPAST_SEQ)
-
1445 {
-
1446 // duplicate or conflict
-
1447 JLOG(m_journal.info()) << "Transaction is obsolete";
-
1448 e.transaction->setStatus(OBSOLETE);
-
1449 }
-
1450 else if (e.result == terQUEUED)
-
1451 {
-
1452 JLOG(m_journal.debug())
-
1453 << "Transaction is likely to claim a"
-
1454 << " fee, but is queued until fee drops";
-
1455
-
1456 e.transaction->setStatus(HELD);
-
1457 // Add to held transactions, because it could get
-
1458 // kicked out of the queue, and this will try to
-
1459 // put it back.
-
1460 m_ledgerMaster.addHeldTransaction(e.transaction);
-
1461 e.transaction->setQueued();
-
1462 e.transaction->setKept();
-
1463 }
-
1464 else if (isTerRetry(e.result))
-
1465 {
-
1466 if (e.failType != FailHard::yes)
-
1467 {
-
1468 // transaction should be held
-
1469 JLOG(m_journal.debug())
-
1470 << "Transaction should be held: " << e.result;
-
1471 e.transaction->setStatus(HELD);
-
1472 m_ledgerMaster.addHeldTransaction(e.transaction);
-
1473 e.transaction->setKept();
-
1474 }
-
1475 }
-
1476 else
-
1477 {
-
1478 JLOG(m_journal.debug())
-
1479 << "Status other than success " << e.result;
-
1480 e.transaction->setStatus(INVALID);
-
1481 }
-
1482
-
1483 auto const enforceFailHard =
-
1484 e.failType == FailHard::yes && !isTesSuccess(e.result);
-
1485
-
1486 if (addLocal && !enforceFailHard)
+
1427 if (transResultInfo(e.result, token, human))
+
1428 {
+
1429 JLOG(m_journal.info())
+
1430 << "TransactionResult: " << token << ": " << human;
+
1431 }
+
1432 }
+
1433#endif
+
1434
+
1435 bool addLocal = e.local;
+
1436
+
1437 if (e.result == tesSUCCESS)
+
1438 {
+
1439 JLOG(m_journal.debug())
+
1440 << "Transaction is now included in open ledger";
+
1441 e.transaction->setStatus(INCLUDED);
+
1442
+
1443 auto const& txCur = e.transaction->getSTransaction();
+
1444 auto const txNext = m_ledgerMaster.popAcctTransaction(txCur);
+
1445 if (txNext)
+
1446 {
+
1447 std::string reason;
+
1448 auto const trans = sterilize(*txNext);
+
1449 auto t = std::make_shared<Transaction>(trans, reason, app_);
+
1450 submit_held.emplace_back(t, false, false, FailHard::no);
+
1451 t->setApplying();
+
1452 }
+
1453 }
+
1454 else if (e.result == tefPAST_SEQ)
+
1455 {
+
1456 // duplicate or conflict
+
1457 JLOG(m_journal.info()) << "Transaction is obsolete";
+
1458 e.transaction->setStatus(OBSOLETE);
+
1459 }
+
1460 else if (e.result == terQUEUED)
+
1461 {
+
1462 JLOG(m_journal.debug())
+
1463 << "Transaction is likely to claim a"
+
1464 << " fee, but is queued until fee drops";
+
1465
+
1466 e.transaction->setStatus(HELD);
+
1467 // Add to held transactions, because it could get
+
1468 // kicked out of the queue, and this will try to
+
1469 // put it back.
+
1470 m_ledgerMaster.addHeldTransaction(e.transaction);
+
1471 e.transaction->setQueued();
+
1472 e.transaction->setKept();
+
1473 }
+
1474 else if (isTerRetry(e.result))
+
1475 {
+
1476 if (e.failType != FailHard::yes)
+
1477 {
+
1478 // transaction should be held
+
1479 JLOG(m_journal.debug())
+
1480 << "Transaction should be held: " << e.result;
+
1481 e.transaction->setStatus(HELD);
+
1482 m_ledgerMaster.addHeldTransaction(e.transaction);
+
1483 e.transaction->setKept();
+
1484 }
+
1485 }
+
1486 else
1487 {
-
1488 m_localTX->push_back(
-
1489 m_ledgerMaster.getCurrentLedgerIndex(),
-
1490 e.transaction->getSTransaction());
-
1491 e.transaction->setKept();
-
1492 }
-
1493
-
1494 if ((e.applied ||
-
1495 ((mMode != OperatingMode::FULL) &&
-
1496 (e.failType != FailHard::yes) && e.local) ||
-
1497 (e.result == terQUEUED)) &&
-
1498 !enforceFailHard)
-
1499 {
-
1500 auto const toSkip =
-
1501 app_.getHashRouter().shouldRelay(e.transaction->getID());
-
1502
-
1503 if (toSkip)
-
1504 {
-
1505 protocol::TMTransaction tx;
-
1506 Serializer s;
-
1507
-
1508 e.transaction->getSTransaction()->add(s);
-
1509 tx.set_rawtransaction(s.data(), s.size());
-
1510 tx.set_status(protocol::tsCURRENT);
-
1511 tx.set_receivetimestamp(
-
1512 app_.timeKeeper().now().time_since_epoch().count());
-
1513 tx.set_deferred(e.result == terQUEUED);
-
1514 // FIXME: This should be when we received it
-
1515 app_.overlay().relay(e.transaction->getID(), tx, *toSkip);
-
1516 e.transaction->setBroadcast();
-
1517 }
-
1518 }
-
1519
-
1520 if (validatedLedgerIndex)
-
1521 {
-
1522 auto [fee, accountSeq, availableSeq] =
-
1523 app_.getTxQ().getTxRequiredFeeAndSeq(
-
1524 *newOL, e.transaction->getSTransaction());
-
1525 e.transaction->setCurrentLedgerState(
-
1526 *validatedLedgerIndex, fee, accountSeq, availableSeq);
-
1527 }
-
1528 }
-
1529 }
-
1530
-
1531 batchLock.lock();
-
1532
-
1533 for (TransactionStatus& e : transactions)
-
1534 e.transaction->clearApplying();
-
1535
-
1536 if (!submit_held.empty())
-
1537 {
-
1538 if (mTransactions.empty())
-
1539 mTransactions.swap(submit_held);
-
1540 else
-
1541 for (auto& e : submit_held)
-
1542 mTransactions.push_back(std::move(e));
-
1543 }
-
1544
-
1545 mCond.notify_all();
-
1546
-
1547 mDispatchState = DispatchState::none;
-
1548}
-
1549
-
1550//
-
1551// Owner functions
-
1552//
-
1553
-
1554Json::Value
-
1555NetworkOPsImp::getOwnerInfo(
-
1556 std::shared_ptr<ReadView const> lpLedger,
-
1557 AccountID const& account)
-
1558{
-
1559 Json::Value jvObjects(Json::objectValue);
-
1560 auto root = keylet::ownerDir(account);
-
1561 auto sleNode = lpLedger->read(keylet::page(root));
-
1562 if (sleNode)
-
1563 {
-
1564 std::uint64_t uNodeDir;
-
1565
-
1566 do
-
1567 {
-
1568 for (auto const& uDirEntry : sleNode->getFieldV256(sfIndexes))
-
1569 {
-
1570 auto sleCur = lpLedger->read(keylet::child(uDirEntry));
-
1571 XRPL_ASSERT(
-
1572 sleCur,
-
1573 "ripple::NetworkOPsImp::getOwnerInfo : non-null child SLE");
-
1574
-
1575 switch (sleCur->getType())
-
1576 {
-
1577 case ltOFFER:
-
1578 if (!jvObjects.isMember(jss::offers))
-
1579 jvObjects[jss::offers] =
-
1580 Json::Value(Json::arrayValue);
-
1581
-
1582 jvObjects[jss::offers].append(
-
1583 sleCur->getJson(JsonOptions::none));
-
1584 break;
-
1585
-
1586 case ltRIPPLE_STATE:
-
1587 if (!jvObjects.isMember(jss::ripple_lines))
-
1588 {
-
1589 jvObjects[jss::ripple_lines] =
+
1488 JLOG(m_journal.debug())
+
1489 << "Status other than success " << e.result;
+
1490 e.transaction->setStatus(INVALID);
+
1491 }
+
1492
+
1493 auto const enforceFailHard =
+
1494 e.failType == FailHard::yes && !isTesSuccess(e.result);
+
1495
+
1496 if (addLocal && !enforceFailHard)
+
1497 {
+
1498 m_localTX->push_back(
+
1499 m_ledgerMaster.getCurrentLedgerIndex(),
+
1500 e.transaction->getSTransaction());
+
1501 e.transaction->setKept();
+
1502 }
+
1503
+
1504 if ((e.applied ||
+
1505 ((mMode != OperatingMode::FULL) &&
+
1506 (e.failType != FailHard::yes) && e.local) ||
+
1507 (e.result == terQUEUED)) &&
+
1508 !enforceFailHard)
+
1509 {
+
1510 auto const toSkip =
+
1511 app_.getHashRouter().shouldRelay(e.transaction->getID());
+
1512
+
1513 if (toSkip)
+
1514 {
+
1515 protocol::TMTransaction tx;
+
1516 Serializer s;
+
1517
+
1518 e.transaction->getSTransaction()->add(s);
+
1519 tx.set_rawtransaction(s.data(), s.size());
+
1520 tx.set_status(protocol::tsCURRENT);
+
1521 tx.set_receivetimestamp(
+
1522 app_.timeKeeper().now().time_since_epoch().count());
+
1523 tx.set_deferred(e.result == terQUEUED);
+
1524 // FIXME: This should be when we received it
+
1525 app_.overlay().relay(e.transaction->getID(), tx, *toSkip);
+
1526 e.transaction->setBroadcast();
+
1527 }
+
1528 }
+
1529
+
1530 if (validatedLedgerIndex)
+
1531 {
+
1532 auto [fee, accountSeq, availableSeq] =
+
1533 app_.getTxQ().getTxRequiredFeeAndSeq(
+
1534 *newOL, e.transaction->getSTransaction());
+
1535 e.transaction->setCurrentLedgerState(
+
1536 *validatedLedgerIndex, fee, accountSeq, availableSeq);
+
1537 }
+
1538 }
+
1539 }
+
1540
+
1541 batchLock.lock();
+
1542
+
1543 for (TransactionStatus& e : transactions)
+
1544 e.transaction->clearApplying();
+
1545
+
1546 if (!submit_held.empty())
+
1547 {
+
1548 if (mTransactions.empty())
+
1549 mTransactions.swap(submit_held);
+
1550 else
+
1551 for (auto& e : submit_held)
+
1552 mTransactions.push_back(std::move(e));
+
1553 }
+
1554
+
1555 mCond.notify_all();
+
1556
+
1557 mDispatchState = DispatchState::none;
+
1558}
+
1559
+
1560//
+
1561// Owner functions
+
1562//
+
1563
+
1564Json::Value
+
1565NetworkOPsImp::getOwnerInfo(
+
1566 std::shared_ptr<ReadView const> lpLedger,
+
1567 AccountID const& account)
+
1568{
+
1569 Json::Value jvObjects(Json::objectValue);
+
1570 auto root = keylet::ownerDir(account);
+
1571 auto sleNode = lpLedger->read(keylet::page(root));
+
1572 if (sleNode)
+
1573 {
+
1574 std::uint64_t uNodeDir;
+
1575
+
1576 do
+
1577 {
+
1578 for (auto const& uDirEntry : sleNode->getFieldV256(sfIndexes))
+
1579 {
+
1580 auto sleCur = lpLedger->read(keylet::child(uDirEntry));
+
1581 XRPL_ASSERT(
+
1582 sleCur,
+
1583 "ripple::NetworkOPsImp::getOwnerInfo : non-null child SLE");
+
1584
+
1585 switch (sleCur->getType())
+
1586 {
+
1587 case ltOFFER:
+
1588 if (!jvObjects.isMember(jss::offers))
+
1589 jvObjects[jss::offers] =
1590 Json::Value(Json::arrayValue);
-
1591 }
-
1592
-
1593 jvObjects[jss::ripple_lines].append(
-
1594 sleCur->getJson(JsonOptions::none));
-
1595 break;
-
1596
-
1597 case ltACCOUNT_ROOT:
-
1598 case ltDIR_NODE:
-
1599 default:
-
1600 UNREACHABLE(
-
1601 "ripple::NetworkOPsImp::getOwnerInfo : invalid "
-
1602 "type");
-
1603 break;
-
1604 }
-
1605 }
+
1591
+
1592 jvObjects[jss::offers].append(
+
1593 sleCur->getJson(JsonOptions::none));
+
1594 break;
+
1595
+
1596 case ltRIPPLE_STATE:
+
1597 if (!jvObjects.isMember(jss::ripple_lines))
+
1598 {
+
1599 jvObjects[jss::ripple_lines] =
+
1600 Json::Value(Json::arrayValue);
+
1601 }
+
1602
+
1603 jvObjects[jss::ripple_lines].append(
+
1604 sleCur->getJson(JsonOptions::none));
+
1605 break;
1606
-
1607 uNodeDir = sleNode->getFieldU64(sfIndexNext);
-
1608
-
1609 if (uNodeDir)
-
1610 {
-
1611 sleNode = lpLedger->read(keylet::page(root, uNodeDir));
-
1612 XRPL_ASSERT(
-
1613 sleNode,
-
1614 "ripple::NetworkOPsImp::getOwnerInfo : read next page");
+
1607 case ltACCOUNT_ROOT:
+
1608 case ltDIR_NODE:
+
1609 default:
+
1610 UNREACHABLE(
+
1611 "ripple::NetworkOPsImp::getOwnerInfo : invalid "
+
1612 "type");
+
1613 break;
+
1614 }
1615 }
-
1616 } while (uNodeDir);
-
1617 }
+
1616
+
1617 uNodeDir = sleNode->getFieldU64(sfIndexNext);
1618
-
1619 return jvObjects;
-
1620}
-
1621
-
1622//
-
1623// Other
-
1624//
-
1625
-
1626inline bool
-
1627NetworkOPsImp::isBlocked()
-
1628{
-
1629 return isAmendmentBlocked() || isUNLBlocked();
+
1619 if (uNodeDir)
+
1620 {
+
1621 sleNode = lpLedger->read(keylet::page(root, uNodeDir));
+
1622 XRPL_ASSERT(
+
1623 sleNode,
+
1624 "ripple::NetworkOPsImp::getOwnerInfo : read next page");
+
1625 }
+
1626 } while (uNodeDir);
+
1627 }
+
1628
+
1629 return jvObjects;
1630}
1631
-
1632inline bool
-
1633NetworkOPsImp::isAmendmentBlocked()
-
1634{
-
1635 return amendmentBlocked_;
-
1636}
-
1637
-
1638void
-
1639NetworkOPsImp::setAmendmentBlocked()
-
1640{
-
1641 amendmentBlocked_ = true;
-
1642 setMode(OperatingMode::CONNECTED);
-
1643}
-
1644
-
1645inline bool
-
1646NetworkOPsImp::isAmendmentWarned()
-
1647{
-
1648 return !amendmentBlocked_ && amendmentWarned_;
-
1649}
-
1650
-
1651inline void
-
1652NetworkOPsImp::setAmendmentWarned()
-
1653{
-
1654 amendmentWarned_ = true;
-
1655}
-
1656
-
1657inline void
-
1658NetworkOPsImp::clearAmendmentWarned()
-
1659{
-
1660 amendmentWarned_ = false;
-
1661}
-
1662
-
1663inline bool
-
1664NetworkOPsImp::isUNLBlocked()
-
1665{
-
1666 return unlBlocked_;
-
1667}
-
1668
-
1669void
-
1670NetworkOPsImp::setUNLBlocked()
-
1671{
-
1672 unlBlocked_ = true;
-
1673 setMode(OperatingMode::CONNECTED);
-
1674}
-
1675
-
1676inline void
-
1677NetworkOPsImp::clearUNLBlocked()
-
1678{
-
1679 unlBlocked_ = false;
-
1680}
-
1681
-
1682bool
-
1683NetworkOPsImp::checkLastClosedLedger(
-
1684 const Overlay::PeerSequence& peerList,
-
1685 uint256& networkClosed)
-
1686{
-
1687 // Returns true if there's an *abnormal* ledger issue, normal changing in
-
1688 // TRACKING mode should return false. Do we have sufficient validations for
-
1689 // our last closed ledger? Or do sufficient nodes agree? And do we have no
-
1690 // better ledger available? If so, we are either tracking or full.
+
1632//
+
1633// Other
+
1634//
+
1635
+
1636inline bool
+
1637NetworkOPsImp::isBlocked()
+
1638{
+
1639 return isAmendmentBlocked() || isUNLBlocked();
+
1640}
+
1641
+
1642inline bool
+
1643NetworkOPsImp::isAmendmentBlocked()
+
1644{
+
1645 return amendmentBlocked_;
+
1646}
+
1647
+
1648void
+
1649NetworkOPsImp::setAmendmentBlocked()
+
1650{
+
1651 amendmentBlocked_ = true;
+
1652 setMode(OperatingMode::CONNECTED);
+
1653}
+
1654
+
1655inline bool
+
1656NetworkOPsImp::isAmendmentWarned()
+
1657{
+
1658 return !amendmentBlocked_ && amendmentWarned_;
+
1659}
+
1660
+
1661inline void
+
1662NetworkOPsImp::setAmendmentWarned()
+
1663{
+
1664 amendmentWarned_ = true;
+
1665}
+
1666
+
1667inline void
+
1668NetworkOPsImp::clearAmendmentWarned()
+
1669{
+
1670 amendmentWarned_ = false;
+
1671}
+
1672
+
1673inline bool
+
1674NetworkOPsImp::isUNLBlocked()
+
1675{
+
1676 return unlBlocked_;
+
1677}
+
1678
+
1679void
+
1680NetworkOPsImp::setUNLBlocked()
+
1681{
+
1682 unlBlocked_ = true;
+
1683 setMode(OperatingMode::CONNECTED);
+
1684}
+
1685
+
1686inline void
+
1687NetworkOPsImp::clearUNLBlocked()
+
1688{
+
1689 unlBlocked_ = false;
+
1690}
1691
-
1692 JLOG(m_journal.trace()) << "NetworkOPsImp::checkLastClosedLedger";
-
1693
-
1694 auto const ourClosed = m_ledgerMaster.getClosedLedger();
-
1695
-
1696 if (!ourClosed)
-
1697 return false;
-
1698
-
1699 uint256 closedLedger = ourClosed->info().hash;
-
1700 uint256 prevClosedLedger = ourClosed->info().parentHash;
-
1701 JLOG(m_journal.trace()) << "OurClosed: " << closedLedger;
-
1702 JLOG(m_journal.trace()) << "PrevClosed: " << prevClosedLedger;
+
1692bool
+
1693NetworkOPsImp::checkLastClosedLedger(
+
1694 const Overlay::PeerSequence& peerList,
+
1695 uint256& networkClosed)
+
1696{
+
1697 // Returns true if there's an *abnormal* ledger issue, normal changing in
+
1698 // TRACKING mode should return false. Do we have sufficient validations for
+
1699 // our last closed ledger? Or do sufficient nodes agree? And do we have no
+
1700 // better ledger available? If so, we are either tracking or full.
+
1701
+
1702 JLOG(m_journal.trace()) << "NetworkOPsImp::checkLastClosedLedger";
1703
-
1704 //-------------------------------------------------------------------------
-
1705 // Determine preferred last closed ledger
-
1706
-
1707 auto& validations = app_.getValidations();
-
1708 JLOG(m_journal.debug())
-
1709 << "ValidationTrie " << Json::Compact(validations.getJsonTrie());
-
1710
-
1711 // Will rely on peer LCL if no trusted validations exist
-
1712 hash_map<uint256, std::uint32_t> peerCounts;
-
1713 peerCounts[closedLedger] = 0;
-
1714 if (mMode >= OperatingMode::TRACKING)
-
1715 peerCounts[closedLedger]++;
+
1704 auto const ourClosed = m_ledgerMaster.getClosedLedger();
+
1705
+
1706 if (!ourClosed)
+
1707 return false;
+
1708
+
1709 uint256 closedLedger = ourClosed->info().hash;
+
1710 uint256 prevClosedLedger = ourClosed->info().parentHash;
+
1711 JLOG(m_journal.trace()) << "OurClosed: " << closedLedger;
+
1712 JLOG(m_journal.trace()) << "PrevClosed: " << prevClosedLedger;
+
1713
+
1714 //-------------------------------------------------------------------------
+
1715 // Determine preferred last closed ledger
1716
-
1717 for (auto& peer : peerList)
-
1718 {
-
1719 uint256 peerLedger = peer->getClosedLedgerHash();
+
1717 auto& validations = app_.getValidations();
+
1718 JLOG(m_journal.debug())
+
1719 << "ValidationTrie " << Json::Compact(validations.getJsonTrie());
1720
-
1721 if (peerLedger.isNonZero())
-
1722 ++peerCounts[peerLedger];
-
1723 }
-
1724
-
1725 for (auto const& it : peerCounts)
-
1726 JLOG(m_journal.debug()) << "L: " << it.first << " n=" << it.second;
-
1727
-
1728 uint256 preferredLCL = validations.getPreferredLCL(
-
1729 RCLValidatedLedger{ourClosed, validations.adaptor().journal()},
-
1730 m_ledgerMaster.getValidLedgerIndex(),
-
1731 peerCounts);
-
1732
-
1733 bool switchLedgers = preferredLCL != closedLedger;
-
1734 if (switchLedgers)
-
1735 closedLedger = preferredLCL;
-
1736 //-------------------------------------------------------------------------
-
1737 if (switchLedgers && (closedLedger == prevClosedLedger))
-
1738 {
-
1739 // don't switch to our own previous ledger
-
1740 JLOG(m_journal.info()) << "We won't switch to our own previous ledger";
-
1741 networkClosed = ourClosed->info().hash;
-
1742 switchLedgers = false;
-
1743 }
-
1744 else
-
1745 networkClosed = closedLedger;
-
1746
-
1747 if (!switchLedgers)
-
1748 return false;
-
1749
-
1750 auto consensus = m_ledgerMaster.getLedgerByHash(closedLedger);
-
1751
-
1752 if (!consensus)
-
1753 consensus = app_.getInboundLedgers().acquire(
-
1754 closedLedger, 0, InboundLedger::Reason::CONSENSUS);
-
1755
-
1756 if (consensus &&
-
1757 (!m_ledgerMaster.canBeCurrent(consensus) ||
-
1758 !m_ledgerMaster.isCompatible(
-
1759 *consensus, m_journal.debug(), "Not switching")))
-
1760 {
-
1761 // Don't switch to a ledger not on the validated chain
-
1762 // or with an invalid close time or sequence
-
1763 networkClosed = ourClosed->info().hash;
-
1764 return false;
-
1765 }
-
1766
-
1767 JLOG(m_journal.warn()) << "We are not running on the consensus ledger";
-
1768 JLOG(m_journal.info()) << "Our LCL: " << ourClosed->info().hash
-
1769 << getJson({*ourClosed, {}});
-
1770 JLOG(m_journal.info()) << "Net LCL " << closedLedger;
-
1771
-
1772 if ((mMode == OperatingMode::TRACKING) || (mMode == OperatingMode::FULL))
-
1773 {
-
1774 setMode(OperatingMode::CONNECTED);
+
1721 // Will rely on peer LCL if no trusted validations exist
+
1722 hash_map<uint256, std::uint32_t> peerCounts;
+
1723 peerCounts[closedLedger] = 0;
+
1724 if (mMode >= OperatingMode::TRACKING)
+
1725 peerCounts[closedLedger]++;
+
1726
+
1727 for (auto& peer : peerList)
+
1728 {
+
1729 uint256 peerLedger = peer->getClosedLedgerHash();
+
1730
+
1731 if (peerLedger.isNonZero())
+
1732 ++peerCounts[peerLedger];
+
1733 }
+
1734
+
1735 for (auto const& it : peerCounts)
+
1736 JLOG(m_journal.debug()) << "L: " << it.first << " n=" << it.second;
+
1737
+
1738 uint256 preferredLCL = validations.getPreferredLCL(
+
1739 RCLValidatedLedger{ourClosed, validations.adaptor().journal()},
+
1740 m_ledgerMaster.getValidLedgerIndex(),
+
1741 peerCounts);
+
1742
+
1743 bool switchLedgers = preferredLCL != closedLedger;
+
1744 if (switchLedgers)
+
1745 closedLedger = preferredLCL;
+
1746 //-------------------------------------------------------------------------
+
1747 if (switchLedgers && (closedLedger == prevClosedLedger))
+
1748 {
+
1749 // don't switch to our own previous ledger
+
1750 JLOG(m_journal.info()) << "We won't switch to our own previous ledger";
+
1751 networkClosed = ourClosed->info().hash;
+
1752 switchLedgers = false;
+
1753 }
+
1754 else
+
1755 networkClosed = closedLedger;
+
1756
+
1757 if (!switchLedgers)
+
1758 return false;
+
1759
+
1760 auto consensus = m_ledgerMaster.getLedgerByHash(closedLedger);
+
1761
+
1762 if (!consensus)
+
1763 consensus = app_.getInboundLedgers().acquire(
+
1764 closedLedger, 0, InboundLedger::Reason::CONSENSUS);
+
1765
+
1766 if (consensus &&
+
1767 (!m_ledgerMaster.canBeCurrent(consensus) ||
+
1768 !m_ledgerMaster.isCompatible(
+
1769 *consensus, m_journal.debug(), "Not switching")))
+
1770 {
+
1771 // Don't switch to a ledger not on the validated chain
+
1772 // or with an invalid close time or sequence
+
1773 networkClosed = ourClosed->info().hash;
+
1774 return false;
1775 }
1776
-
1777 if (consensus)
-
1778 {
-
1779 // FIXME: If this rewinds the ledger sequence, or has the same
-
1780 // sequence, we should update the status on any stored transactions
-
1781 // in the invalidated ledgers.
-
1782 switchLastClosedLedger(consensus);
-
1783 }
-
1784
-
1785 return true;
-
1786}
-
1787
-
1788void
-
1789NetworkOPsImp::switchLastClosedLedger(
-
1790 std::shared_ptr<Ledger const> const& newLCL)
-
1791{
-
1792 // set the newLCL as our last closed ledger -- this is abnormal code
-
1793 JLOG(m_journal.error())
-
1794 << "JUMP last closed ledger to " << newLCL->info().hash;
-
1795
-
1796 clearNeedNetworkLedger();
+
1777 JLOG(m_journal.warn()) << "We are not running on the consensus ledger";
+
1778 JLOG(m_journal.info()) << "Our LCL: " << ourClosed->info().hash
+
1779 << getJson({*ourClosed, {}});
+
1780 JLOG(m_journal.info()) << "Net LCL " << closedLedger;
+
1781
+
1782 if ((mMode == OperatingMode::TRACKING) || (mMode == OperatingMode::FULL))
+
1783 {
+
1784 setMode(OperatingMode::CONNECTED);
+
1785 }
+
1786
+
1787 if (consensus)
+
1788 {
+
1789 // FIXME: If this rewinds the ledger sequence, or has the same
+
1790 // sequence, we should update the status on any stored transactions
+
1791 // in the invalidated ledgers.
+
1792 switchLastClosedLedger(consensus);
+
1793 }
+
1794
+
1795 return true;
+
1796}
1797
-
1798 // Update fee computations.
-
1799 app_.getTxQ().processClosedLedger(app_, *newLCL, true);
-
1800
-
1801 // Caller must own master lock
-
1802 {
-
1803 // Apply tx in old open ledger to new
-
1804 // open ledger. Then apply local tx.
+
1798void
+
1799NetworkOPsImp::switchLastClosedLedger(
+
1800 std::shared_ptr<Ledger const> const& newLCL)
+
1801{
+
1802 // set the newLCL as our last closed ledger -- this is abnormal code
+
1803 JLOG(m_journal.error())
+
1804 << "JUMP last closed ledger to " << newLCL->info().hash;
1805
-
1806 auto retries = m_localTX->getTxSet();
-
1807 auto const lastVal = app_.getLedgerMaster().getValidatedLedger();
-
1808 std::optional<Rules> rules;
-
1809 if (lastVal)
-
1810 rules = makeRulesGivenLedger(*lastVal, app_.config().features);
-
1811 else
-
1812 rules.emplace(app_.config().features);
-
1813 app_.openLedger().accept(
-
1814 app_,
-
1815 *rules,
-
1816 newLCL,
-
1817 OrderedTxs({}),
-
1818 false,
-
1819 retries,
-
1820 tapNONE,
-
1821 "jump",
-
1822 [&](OpenView& view, beast::Journal j) {
-
1823 // Stuff the ledger with transactions from the queue.
-
1824 return app_.getTxQ().accept(app_, view);
-
1825 });
-
1826 }
-
1827
-
1828 m_ledgerMaster.switchLCL(newLCL);
-
1829
-
1830 protocol::TMStatusChange s;
-
1831 s.set_newevent(protocol::neSWITCHED_LEDGER);
-
1832 s.set_ledgerseq(newLCL->info().seq);
-
1833 s.set_networktime(app_.timeKeeper().now().time_since_epoch().count());
-
1834 s.set_ledgerhashprevious(
-
1835 newLCL->info().parentHash.begin(), newLCL->info().parentHash.size());
-
1836 s.set_ledgerhash(newLCL->info().hash.begin(), newLCL->info().hash.size());
+
1806 clearNeedNetworkLedger();
+
1807
+
1808 // Update fee computations.
+
1809 app_.getTxQ().processClosedLedger(app_, *newLCL, true);
+
1810
+
1811 // Caller must own master lock
+
1812 {
+
1813 // Apply tx in old open ledger to new
+
1814 // open ledger. Then apply local tx.
+
1815
+
1816 auto retries = m_localTX->getTxSet();
+
1817 auto const lastVal = app_.getLedgerMaster().getValidatedLedger();
+
1818 std::optional<Rules> rules;
+
1819 if (lastVal)
+
1820 rules = makeRulesGivenLedger(*lastVal, app_.config().features);
+
1821 else
+
1822 rules.emplace(app_.config().features);
+
1823 app_.openLedger().accept(
+
1824 app_,
+
1825 *rules,
+
1826 newLCL,
+
1827 OrderedTxs({}),
+
1828 false,
+
1829 retries,
+
1830 tapNONE,
+
1831 "jump",
+
1832 [&](OpenView& view, beast::Journal j) {
+
1833 // Stuff the ledger with transactions from the queue.
+
1834 return app_.getTxQ().accept(app_, view);
+
1835 });
+
1836 }
1837
-
1838 app_.overlay().foreach(
-
1839 send_always(std::make_shared<Message>(s, protocol::mtSTATUS_CHANGE)));
-
1840}
-
1841
-
1842bool
-
1843NetworkOPsImp::beginConsensus(
-
1844 uint256 const& networkClosed,
-
1845 std::unique_ptr<std::stringstream> const& clog)
-
1846{
-
1847 XRPL_ASSERT(
-
1848 networkClosed.isNonZero(),
-
1849 "ripple::NetworkOPsImp::beginConsensus : nonzero input");
-
1850
-
1851 auto closingInfo = m_ledgerMaster.getCurrentLedger()->info();
-
1852
-
1853 JLOG(m_journal.info()) << "Consensus time for #" << closingInfo.seq
-
1854 << " with LCL " << closingInfo.parentHash;
-
1855
-
1856 auto prevLedger = m_ledgerMaster.getLedgerByHash(closingInfo.parentHash);
-
1857
-
1858 if (!prevLedger)
-
1859 {
-
1860 // this shouldn't happen unless we jump ledgers
-
1861 if (mMode == OperatingMode::FULL)
-
1862 {
-
1863 JLOG(m_journal.warn()) << "Don't have LCL, going to tracking";
-
1864 setMode(OperatingMode::TRACKING);
-
1865 CLOG(clog) << "beginConsensus Don't have LCL, going to tracking. ";
-
1866 }
+
1838 m_ledgerMaster.switchLCL(newLCL);
+
1839
+
1840 protocol::TMStatusChange s;
+
1841 s.set_newevent(protocol::neSWITCHED_LEDGER);
+
1842 s.set_ledgerseq(newLCL->info().seq);
+
1843 s.set_networktime(app_.timeKeeper().now().time_since_epoch().count());
+
1844 s.set_ledgerhashprevious(
+
1845 newLCL->info().parentHash.begin(), newLCL->info().parentHash.size());
+
1846 s.set_ledgerhash(newLCL->info().hash.begin(), newLCL->info().hash.size());
+
1847
+
1848 app_.overlay().foreach(
+
1849 send_always(std::make_shared<Message>(s, protocol::mtSTATUS_CHANGE)));
+
1850}
+
1851
+
1852bool
+
1853NetworkOPsImp::beginConsensus(
+
1854 uint256 const& networkClosed,
+
1855 std::unique_ptr<std::stringstream> const& clog)
+
1856{
+
1857 XRPL_ASSERT(
+
1858 networkClosed.isNonZero(),
+
1859 "ripple::NetworkOPsImp::beginConsensus : nonzero input");
+
1860
+
1861 auto closingInfo = m_ledgerMaster.getCurrentLedger()->info();
+
1862
+
1863 JLOG(m_journal.info()) << "Consensus time for #" << closingInfo.seq
+
1864 << " with LCL " << closingInfo.parentHash;
+
1865
+
1866 auto prevLedger = m_ledgerMaster.getLedgerByHash(closingInfo.parentHash);
1867
-
1868 CLOG(clog) << "beginConsensus no previous ledger. ";
-
1869 return false;
-
1870 }
-
1871
-
1872 XRPL_ASSERT(
-
1873 prevLedger->info().hash == closingInfo.parentHash,
-
1874 "ripple::NetworkOPsImp::beginConsensus : prevLedger hash matches "
-
1875 "parent");
-
1876 XRPL_ASSERT(
-
1877 closingInfo.parentHash == m_ledgerMaster.getClosedLedger()->info().hash,
-
1878 "ripple::NetworkOPsImp::beginConsensus : closedLedger parent matches "
-
1879 "hash");
-
1880
-
1881 if (prevLedger->rules().enabled(featureNegativeUNL))
-
1882 app_.validators().setNegativeUNL(prevLedger->negativeUNL());
-
1883 TrustChanges const changes = app_.validators().updateTrusted(
-
1884 app_.getValidations().getCurrentNodeIDs(),
-
1885 closingInfo.parentCloseTime,
-
1886 *this,
-
1887 app_.overlay(),
-
1888 app_.getHashRouter());
-
1889
-
1890 if (!changes.added.empty() || !changes.removed.empty())
-
1891 {
-
1892 app_.getValidations().trustChanged(changes.added, changes.removed);
-
1893 // Update the AmendmentTable so it tracks the current validators.
-
1894 app_.getAmendmentTable().trustChanged(
-
1895 app_.validators().getQuorumKeys().second);
-
1896 }
-
1897
-
1898 mConsensus.startRound(
-
1899 app_.timeKeeper().closeTime(),
-
1900 networkClosed,
-
1901 prevLedger,
-
1902 changes.removed,
-
1903 changes.added,
-
1904 clog);
-
1905
-
1906 const ConsensusPhase currPhase = mConsensus.phase();
-
1907 if (mLastConsensusPhase != currPhase)
-
1908 {
-
1909 reportConsensusStateChange(currPhase);
-
1910 mLastConsensusPhase = currPhase;
-
1911 }
-
1912
-
1913 JLOG(m_journal.debug()) << "Initiating consensus engine";
-
1914 return true;
-
1915}
-
1916
-
1917bool
-
1918NetworkOPsImp::processTrustedProposal(RCLCxPeerPos peerPos)
-
1919{
-
1920 return mConsensus.peerProposal(app_.timeKeeper().closeTime(), peerPos);
-
1921}
+
1868 if (!prevLedger)
+
1869 {
+
1870 // this shouldn't happen unless we jump ledgers
+
1871 if (mMode == OperatingMode::FULL)
+
1872 {
+
1873 JLOG(m_journal.warn()) << "Don't have LCL, going to tracking";
+
1874 setMode(OperatingMode::TRACKING);
+
1875 CLOG(clog) << "beginConsensus Don't have LCL, going to tracking. ";
+
1876 }
+
1877
+
1878 CLOG(clog) << "beginConsensus no previous ledger. ";
+
1879 return false;
+
1880 }
+
1881
+
1882 XRPL_ASSERT(
+
1883 prevLedger->info().hash == closingInfo.parentHash,
+
1884 "ripple::NetworkOPsImp::beginConsensus : prevLedger hash matches "
+
1885 "parent");
+
1886 XRPL_ASSERT(
+
1887 closingInfo.parentHash == m_ledgerMaster.getClosedLedger()->info().hash,
+
1888 "ripple::NetworkOPsImp::beginConsensus : closedLedger parent matches "
+
1889 "hash");
+
1890
+
1891 if (prevLedger->rules().enabled(featureNegativeUNL))
+
1892 app_.validators().setNegativeUNL(prevLedger->negativeUNL());
+
1893 TrustChanges const changes = app_.validators().updateTrusted(
+
1894 app_.getValidations().getCurrentNodeIDs(),
+
1895 closingInfo.parentCloseTime,
+
1896 *this,
+
1897 app_.overlay(),
+
1898 app_.getHashRouter());
+
1899
+
1900 if (!changes.added.empty() || !changes.removed.empty())
+
1901 {
+
1902 app_.getValidations().trustChanged(changes.added, changes.removed);
+
1903 // Update the AmendmentTable so it tracks the current validators.
+
1904 app_.getAmendmentTable().trustChanged(
+
1905 app_.validators().getQuorumKeys().second);
+
1906 }
+
1907
+
1908 mConsensus.startRound(
+
1909 app_.timeKeeper().closeTime(),
+
1910 networkClosed,
+
1911 prevLedger,
+
1912 changes.removed,
+
1913 changes.added,
+
1914 clog);
+
1915
+
1916 const ConsensusPhase currPhase = mConsensus.phase();
+
1917 if (mLastConsensusPhase != currPhase)
+
1918 {
+
1919 reportConsensusStateChange(currPhase);
+
1920 mLastConsensusPhase = currPhase;
+
1921 }
1922
-
1923void
-
1924NetworkOPsImp::mapComplete(std::shared_ptr<SHAMap> const& map, bool fromAcquire)
-
1925{
-
1926 // We now have an additional transaction set
-
1927 // either created locally during the consensus process
-
1928 // or acquired from a peer
-
1929
-
1930 // Inform peers we have this set
-
1931 protocol::TMHaveTransactionSet msg;
-
1932 msg.set_hash(map->getHash().as_uint256().begin(), 256 / 8);
-
1933 msg.set_status(protocol::tsHAVE);
-
1934 app_.overlay().foreach(
-
1935 send_always(std::make_shared<Message>(msg, protocol::mtHAVE_SET)));
-
1936
-
1937 // We acquired it because consensus asked us to
-
1938 if (fromAcquire)
-
1939 mConsensus.gotTxSet(app_.timeKeeper().closeTime(), RCLTxSet{map});
-
1940}
-
1941
-
1942void
-
1943NetworkOPsImp::endConsensus(std::unique_ptr<std::stringstream> const& clog)
-
1944{
-
1945 uint256 deadLedger = m_ledgerMaster.getClosedLedger()->info().parentHash;
+
1923 JLOG(m_journal.debug()) << "Initiating consensus engine";
+
1924 return true;
+
1925}
+
1926
+
1927bool
+
1928NetworkOPsImp::processTrustedProposal(RCLCxPeerPos peerPos)
+
1929{
+
1930 auto const& peerKey = peerPos.publicKey();
+
1931 if (validatorPK_ == peerKey || validatorMasterPK_ == peerKey)
+
1932 {
+
1933 // Could indicate a operator misconfiguration where two nodes are
+
1934 // running with the same validator key configured, so this isn't fatal,
+
1935 // and it doesn't necessarily indicate peer misbehavior. But since this
+
1936 // is a trusted message, it could be a very big deal. Either way, we
+
1937 // don't want to relay the proposal. Note that the byzantine behavior
+
1938 // detection in handleNewValidation will notify other peers.
+
1939 UNREACHABLE(
+
1940 "ripple::NetworkOPsImp::processTrustedProposal : received own "
+
1941 "proposal");
+
1942 JLOG(m_journal.error())
+
1943 << "Received a TRUSTED proposal signed with my key from a peer";
+
1944 return false;
+
1945 }
1946
-
1947 for (auto const& it : app_.overlay().getActivePeers())
-
1948 {
-
1949 if (it && (it->getClosedLedgerHash() == deadLedger))
-
1950 {
-
1951 JLOG(m_journal.trace()) << "Killing obsolete peer status";
-
1952 it->cycleStatus();
-
1953 }
-
1954 }
-
1955
-
1956 uint256 networkClosed;
-
1957 bool ledgerChange =
-
1958 checkLastClosedLedger(app_.overlay().getActivePeers(), networkClosed);
-
1959
-
1960 if (networkClosed.isZero())
-
1961 {
-
1962 CLOG(clog) << "endConsensus last closed ledger is zero. ";
-
1963 return;
-
1964 }
-
1965
-
1966 // WRITEME: Unless we are in FULL and in the process of doing a consensus,
-
1967 // we must count how many nodes share our LCL, how many nodes disagree with
-
1968 // our LCL, and how many validations our LCL has. We also want to check
-
1969 // timing to make sure there shouldn't be a newer LCL. We need this
-
1970 // information to do the next three tests.
-
1971
-
1972 if (((mMode == OperatingMode::CONNECTED) ||
-
1973 (mMode == OperatingMode::SYNCING)) &&
-
1974 !ledgerChange)
+
1947 return mConsensus.peerProposal(app_.timeKeeper().closeTime(), peerPos);
+
1948}
+
1949
+
1950void
+
1951NetworkOPsImp::mapComplete(std::shared_ptr<SHAMap> const& map, bool fromAcquire)
+
1952{
+
1953 // We now have an additional transaction set
+
1954 // either created locally during the consensus process
+
1955 // or acquired from a peer
+
1956
+
1957 // Inform peers we have this set
+
1958 protocol::TMHaveTransactionSet msg;
+
1959 msg.set_hash(map->getHash().as_uint256().begin(), 256 / 8);
+
1960 msg.set_status(protocol::tsHAVE);
+
1961 app_.overlay().foreach(
+
1962 send_always(std::make_shared<Message>(msg, protocol::mtHAVE_SET)));
+
1963
+
1964 // We acquired it because consensus asked us to
+
1965 if (fromAcquire)
+
1966 mConsensus.gotTxSet(app_.timeKeeper().closeTime(), RCLTxSet{map});
+
1967}
+
1968
+
1969void
+
1970NetworkOPsImp::endConsensus(std::unique_ptr<std::stringstream> const& clog)
+
1971{
+
1972 uint256 deadLedger = m_ledgerMaster.getClosedLedger()->info().parentHash;
+
1973
+
1974 for (auto const& it : app_.overlay().getActivePeers())
1975 {
-
1976 // Count number of peers that agree with us and UNL nodes whose
-
1977 // validations we have for LCL. If the ledger is good enough, go to
-
1978 // TRACKING - TODO
-
1979 if (!needNetworkLedger_)
-
1980 setMode(OperatingMode::TRACKING);
+
1976 if (it && (it->getClosedLedgerHash() == deadLedger))
+
1977 {
+
1978 JLOG(m_journal.trace()) << "Killing obsolete peer status";
+
1979 it->cycleStatus();
+
1980 }
1981 }
1982
-
1983 if (((mMode == OperatingMode::CONNECTED) ||
-
1984 (mMode == OperatingMode::TRACKING)) &&
-
1985 !ledgerChange)
-
1986 {
-
1987 // check if the ledger is good enough to go to FULL
-
1988 // Note: Do not go to FULL if we don't have the previous ledger
-
1989 // check if the ledger is bad enough to go to CONNECTE D -- TODO
-
1990 auto current = m_ledgerMaster.getCurrentLedger();
-
1991 if (app_.timeKeeper().now() < (current->info().parentCloseTime +
-
1992 2 * current->info().closeTimeResolution))
-
1993 {
-
1994 setMode(OperatingMode::FULL);
-
1995 }
-
1996 }
-
1997
-
1998 beginConsensus(networkClosed, clog);
-
1999}
-
2000
-
2001void
-
2002NetworkOPsImp::consensusViewChange()
-
2003{
-
2004 if ((mMode == OperatingMode::FULL) || (mMode == OperatingMode::TRACKING))
-
2005 {
-
2006 setMode(OperatingMode::CONNECTED);
-
2007 }
-
2008}
+
1983 uint256 networkClosed;
+
1984 bool ledgerChange =
+
1985 checkLastClosedLedger(app_.overlay().getActivePeers(), networkClosed);
+
1986
+
1987 if (networkClosed.isZero())
+
1988 {
+
1989 CLOG(clog) << "endConsensus last closed ledger is zero. ";
+
1990 return;
+
1991 }
+
1992
+
1993 // WRITEME: Unless we are in FULL and in the process of doing a consensus,
+
1994 // we must count how many nodes share our LCL, how many nodes disagree with
+
1995 // our LCL, and how many validations our LCL has. We also want to check
+
1996 // timing to make sure there shouldn't be a newer LCL. We need this
+
1997 // information to do the next three tests.
+
1998
+
1999 if (((mMode == OperatingMode::CONNECTED) ||
+
2000 (mMode == OperatingMode::SYNCING)) &&
+
2001 !ledgerChange)
+
2002 {
+
2003 // Count number of peers that agree with us and UNL nodes whose
+
2004 // validations we have for LCL. If the ledger is good enough, go to
+
2005 // TRACKING - TODO
+
2006 if (!needNetworkLedger_)
+
2007 setMode(OperatingMode::TRACKING);
+
2008 }
2009
-
2010void
-
2011NetworkOPsImp::pubManifest(Manifest const& mo)
-
2012{
-
2013 // VFALCO consider std::shared_mutex
-
2014 std::lock_guard sl(mSubLock);
-
2015
-
2016 if (!mStreamMaps[sManifests].empty())
-
2017 {
-
2018 Json::Value jvObj(Json::objectValue);
-
2019
-
2020 jvObj[jss::type] = "manifestReceived";
-
2021 jvObj[jss::master_key] = toBase58(TokenType::NodePublic, mo.masterKey);
-
2022 if (mo.signingKey)
-
2023 jvObj[jss::signing_key] =
-
2024 toBase58(TokenType::NodePublic, *mo.signingKey);
-
2025 jvObj[jss::seq] = Json::UInt(mo.sequence);
-
2026 if (auto sig = mo.getSignature())
-
2027 jvObj[jss::signature] = strHex(*sig);
-
2028 jvObj[jss::master_signature] = strHex(mo.getMasterSignature());
-
2029 if (!mo.domain.empty())
-
2030 jvObj[jss::domain] = mo.domain;
-
2031 jvObj[jss::manifest] = strHex(mo.serialized);
-
2032
-
2033 for (auto i = mStreamMaps[sManifests].begin();
-
2034 i != mStreamMaps[sManifests].end();)
-
2035 {
-
2036 if (auto p = i->second.lock())
-
2037 {
-
2038 p->send(jvObj, true);
-
2039 ++i;
-
2040 }
-
2041 else
-
2042 {
-
2043 i = mStreamMaps[sManifests].erase(i);
-
2044 }
-
2045 }
-
2046 }
-
2047}
-
2048
-
2049NetworkOPsImp::ServerFeeSummary::ServerFeeSummary(
-
2050 XRPAmount fee,
-
2051 TxQ::Metrics&& escalationMetrics,
-
2052 LoadFeeTrack const& loadFeeTrack)
-
2053 : loadFactorServer{loadFeeTrack.getLoadFactor()}
-
2054 , loadBaseServer{loadFeeTrack.getLoadBase()}
-
2055 , baseFee{fee}
-
2056 , em{std::move(escalationMetrics)}
-
2057{
-
2058}
+
2010 if (((mMode == OperatingMode::CONNECTED) ||
+
2011 (mMode == OperatingMode::TRACKING)) &&
+
2012 !ledgerChange)
+
2013 {
+
2014 // check if the ledger is good enough to go to FULL
+
2015 // Note: Do not go to FULL if we don't have the previous ledger
+
2016 // check if the ledger is bad enough to go to CONNECTE D -- TODO
+
2017 auto current = m_ledgerMaster.getCurrentLedger();
+
2018 if (app_.timeKeeper().now() < (current->info().parentCloseTime +
+
2019 2 * current->info().closeTimeResolution))
+
2020 {
+
2021 setMode(OperatingMode::FULL);
+
2022 }
+
2023 }
+
2024
+
2025 beginConsensus(networkClosed, clog);
+
2026}
+
2027
+
2028void
+
2029NetworkOPsImp::consensusViewChange()
+
2030{
+
2031 if ((mMode == OperatingMode::FULL) || (mMode == OperatingMode::TRACKING))
+
2032 {
+
2033 setMode(OperatingMode::CONNECTED);
+
2034 }
+
2035}
+
2036
+
2037void
+
2038NetworkOPsImp::pubManifest(Manifest const& mo)
+
2039{
+
2040 // VFALCO consider std::shared_mutex
+
2041 std::lock_guard sl(mSubLock);
+
2042
+
2043 if (!mStreamMaps[sManifests].empty())
+
2044 {
+
2045 Json::Value jvObj(Json::objectValue);
+
2046
+
2047 jvObj[jss::type] = "manifestReceived";
+
2048 jvObj[jss::master_key] = toBase58(TokenType::NodePublic, mo.masterKey);
+
2049 if (mo.signingKey)
+
2050 jvObj[jss::signing_key] =
+
2051 toBase58(TokenType::NodePublic, *mo.signingKey);
+
2052 jvObj[jss::seq] = Json::UInt(mo.sequence);
+
2053 if (auto sig = mo.getSignature())
+
2054 jvObj[jss::signature] = strHex(*sig);
+
2055 jvObj[jss::master_signature] = strHex(mo.getMasterSignature());
+
2056 if (!mo.domain.empty())
+
2057 jvObj[jss::domain] = mo.domain;
+
2058 jvObj[jss::manifest] = strHex(mo.serialized);
2059
-
2060bool
-
2061NetworkOPsImp::ServerFeeSummary::operator!=(
-
2062 NetworkOPsImp::ServerFeeSummary const& b) const
-
2063{
-
2064 if (loadFactorServer != b.loadFactorServer ||
-
2065 loadBaseServer != b.loadBaseServer || baseFee != b.baseFee ||
-
2066 em.has_value() != b.em.has_value())
-
2067 return true;
-
2068
-
2069 if (em && b.em)
-
2070 {
-
2071 return (
-
2072 em->minProcessingFeeLevel != b.em->minProcessingFeeLevel ||
-
2073 em->openLedgerFeeLevel != b.em->openLedgerFeeLevel ||
-
2074 em->referenceFeeLevel != b.em->referenceFeeLevel);
-
2075 }
-
2076
-
2077 return false;
-
2078}
-
2079
-
2080// Need to cap to uint64 to uint32 due to JSON limitations
-
2081static std::uint32_t
-
2082trunc32(std::uint64_t v)
-
2083{
-
2084 constexpr std::uint64_t max32 = std::numeric_limits<std::uint32_t>::max();
-
2085
-
2086 return std::min(max32, v);
-
2087};
-
2088
-
2089void
-
2090NetworkOPsImp::pubServer()
-
2091{
-
2092 // VFALCO TODO Don't hold the lock across calls to send...make a copy of the
-
2093 // list into a local array while holding the lock then release
-
2094 // the lock and call send on everyone.
-
2095 //
-
2096 std::lock_guard sl(mSubLock);
-
2097
-
2098 if (!mStreamMaps[sServer].empty())
-
2099 {
-
2100 Json::Value jvObj(Json::objectValue);
-
2101
-
2102 ServerFeeSummary f{
-
2103 app_.openLedger().current()->fees().base,
-
2104 app_.getTxQ().getMetrics(*app_.openLedger().current()),
-
2105 app_.getFeeTrack()};
+
2060 for (auto i = mStreamMaps[sManifests].begin();
+
2061 i != mStreamMaps[sManifests].end();)
+
2062 {
+
2063 if (auto p = i->second.lock())
+
2064 {
+
2065 p->send(jvObj, true);
+
2066 ++i;
+
2067 }
+
2068 else
+
2069 {
+
2070 i = mStreamMaps[sManifests].erase(i);
+
2071 }
+
2072 }
+
2073 }
+
2074}
+
2075
+
2076NetworkOPsImp::ServerFeeSummary::ServerFeeSummary(
+
2077 XRPAmount fee,
+
2078 TxQ::Metrics&& escalationMetrics,
+
2079 LoadFeeTrack const& loadFeeTrack)
+
2080 : loadFactorServer{loadFeeTrack.getLoadFactor()}
+
2081 , loadBaseServer{loadFeeTrack.getLoadBase()}
+
2082 , baseFee{fee}
+
2083 , em{std::move(escalationMetrics)}
+
2084{
+
2085}
+
2086
+
2087bool
+
2088NetworkOPsImp::ServerFeeSummary::operator!=(
+
2089 NetworkOPsImp::ServerFeeSummary const& b) const
+
2090{
+
2091 if (loadFactorServer != b.loadFactorServer ||
+
2092 loadBaseServer != b.loadBaseServer || baseFee != b.baseFee ||
+
2093 em.has_value() != b.em.has_value())
+
2094 return true;
+
2095
+
2096 if (em && b.em)
+
2097 {
+
2098 return (
+
2099 em->minProcessingFeeLevel != b.em->minProcessingFeeLevel ||
+
2100 em->openLedgerFeeLevel != b.em->openLedgerFeeLevel ||
+
2101 em->referenceFeeLevel != b.em->referenceFeeLevel);
+
2102 }
+
2103
+
2104 return false;
+
2105}
2106
-
2107 jvObj[jss::type] = "serverStatus";
-
2108 jvObj[jss::server_status] = strOperatingMode();
-
2109 jvObj[jss::load_base] = f.loadBaseServer;
-
2110 jvObj[jss::load_factor_server] = f.loadFactorServer;
-
2111 jvObj[jss::base_fee] = f.baseFee.jsonClipped();
+
2107// Need to cap to uint64 to uint32 due to JSON limitations
+
2108static std::uint32_t
+
2109trunc32(std::uint64_t v)
+
2110{
+
2111 constexpr std::uint64_t max32 = std::numeric_limits<std::uint32_t>::max();
2112
-
2113 if (f.em)
-
2114 {
-
2115 auto const loadFactor = std::max(
-
2116 safe_cast<std::uint64_t>(f.loadFactorServer),
-
2117 mulDiv(
-
2118 f.em->openLedgerFeeLevel,
-
2119 f.loadBaseServer,
-
2120 f.em->referenceFeeLevel)
-
2121 .value_or(ripple::muldiv_max));
-
2122
-
2123 jvObj[jss::load_factor] = trunc32(loadFactor);
-
2124 jvObj[jss::load_factor_fee_escalation] =
-
2125 f.em->openLedgerFeeLevel.jsonClipped();
-
2126 jvObj[jss::load_factor_fee_queue] =
-
2127 f.em->minProcessingFeeLevel.jsonClipped();
-
2128 jvObj[jss::load_factor_fee_reference] =
-
2129 f.em->referenceFeeLevel.jsonClipped();
-
2130 }
-
2131 else
-
2132 jvObj[jss::load_factor] = f.loadFactorServer;
+
2113 return std::min(max32, v);
+
2114};
+
2115
+
2116void
+
2117NetworkOPsImp::pubServer()
+
2118{
+
2119 // VFALCO TODO Don't hold the lock across calls to send...make a copy of the
+
2120 // list into a local array while holding the lock then release
+
2121 // the lock and call send on everyone.
+
2122 //
+
2123 std::lock_guard sl(mSubLock);
+
2124
+
2125 if (!mStreamMaps[sServer].empty())
+
2126 {
+
2127 Json::Value jvObj(Json::objectValue);
+
2128
+
2129 ServerFeeSummary f{
+
2130 app_.openLedger().current()->fees().base,
+
2131 app_.getTxQ().getMetrics(*app_.openLedger().current()),
+
2132 app_.getFeeTrack()};
2133
-
2134 mLastFeeSummary = f;
-
2135
-
2136 for (auto i = mStreamMaps[sServer].begin();
-
2137 i != mStreamMaps[sServer].end();)
-
2138 {
-
2139 InfoSub::pointer p = i->second.lock();
-
2140
-
2141 // VFALCO TODO research the possibility of using thread queues and
-
2142 // linearizing the deletion of subscribers with the
-
2143 // sending of JSON data.
-
2144 if (p)
-
2145 {
-
2146 p->send(jvObj, true);
-
2147 ++i;
-
2148 }
-
2149 else
-
2150 {
-
2151 i = mStreamMaps[sServer].erase(i);
-
2152 }
-
2153 }
-
2154 }
-
2155}
-
2156
-
2157void
-
2158NetworkOPsImp::pubConsensus(ConsensusPhase phase)
-
2159{
-
2160 std::lock_guard sl(mSubLock);
-
2161
-
2162 auto& streamMap = mStreamMaps[sConsensusPhase];
-
2163 if (!streamMap.empty())
-
2164 {
-
2165 Json::Value jvObj(Json::objectValue);
-
2166 jvObj[jss::type] = "consensusPhase";
-
2167 jvObj[jss::consensus] = to_string(phase);
-
2168
-
2169 for (auto i = streamMap.begin(); i != streamMap.end();)
-
2170 {
-
2171 if (auto p = i->second.lock())
+
2134 jvObj[jss::type] = "serverStatus";
+
2135 jvObj[jss::server_status] = strOperatingMode();
+
2136 jvObj[jss::load_base] = f.loadBaseServer;
+
2137 jvObj[jss::load_factor_server] = f.loadFactorServer;
+
2138 jvObj[jss::base_fee] = f.baseFee.jsonClipped();
+
2139
+
2140 if (f.em)
+
2141 {
+
2142 auto const loadFactor = std::max(
+
2143 safe_cast<std::uint64_t>(f.loadFactorServer),
+
2144 mulDiv(
+
2145 f.em->openLedgerFeeLevel,
+
2146 f.loadBaseServer,
+
2147 f.em->referenceFeeLevel)
+
2148 .value_or(ripple::muldiv_max));
+
2149
+
2150 jvObj[jss::load_factor] = trunc32(loadFactor);
+
2151 jvObj[jss::load_factor_fee_escalation] =
+
2152 f.em->openLedgerFeeLevel.jsonClipped();
+
2153 jvObj[jss::load_factor_fee_queue] =
+
2154 f.em->minProcessingFeeLevel.jsonClipped();
+
2155 jvObj[jss::load_factor_fee_reference] =
+
2156 f.em->referenceFeeLevel.jsonClipped();
+
2157 }
+
2158 else
+
2159 jvObj[jss::load_factor] = f.loadFactorServer;
+
2160
+
2161 mLastFeeSummary = f;
+
2162
+
2163 for (auto i = mStreamMaps[sServer].begin();
+
2164 i != mStreamMaps[sServer].end();)
+
2165 {
+
2166 InfoSub::pointer p = i->second.lock();
+
2167
+
2168 // VFALCO TODO research the possibility of using thread queues and
+
2169 // linearizing the deletion of subscribers with the
+
2170 // sending of JSON data.
+
2171 if (p)
2172 {
2173 p->send(jvObj, true);
2174 ++i;
2175 }
2176 else
2177 {
-
2178 i = streamMap.erase(i);
+
2178 i = mStreamMaps[sServer].erase(i);
2179 }
2180 }
2181 }
2182}
2183
2184void
-
2185NetworkOPsImp::pubValidation(std::shared_ptr<STValidation> const& val)
+
2185NetworkOPsImp::pubConsensus(ConsensusPhase phase)
2186{
-
2187 // VFALCO consider std::shared_mutex
-
2188 std::lock_guard sl(mSubLock);
-
2189
-
2190 if (!mStreamMaps[sValidations].empty())
+
2187 std::lock_guard sl(mSubLock);
+
2188
+
2189 auto& streamMap = mStreamMaps[sConsensusPhase];
+
2190 if (!streamMap.empty())
2191 {
2192 Json::Value jvObj(Json::objectValue);
-
2193
-
2194 auto const signerPublic = val->getSignerPublic();
+
2193 jvObj[jss::type] = "consensusPhase";
+
2194 jvObj[jss::consensus] = to_string(phase);
2195
-
2196 jvObj[jss::type] = "validationReceived";
-
2197 jvObj[jss::validation_public_key] =
-
2198 toBase58(TokenType::NodePublic, signerPublic);
-
2199 jvObj[jss::ledger_hash] = to_string(val->getLedgerHash());
-
2200 jvObj[jss::signature] = strHex(val->getSignature());
-
2201 jvObj[jss::full] = val->isFull();
-
2202 jvObj[jss::flags] = val->getFlags();
-
2203 jvObj[jss::signing_time] = *(*val)[~sfSigningTime];
-
2204 jvObj[jss::data] = strHex(val->getSerializer().slice());
-
2205
-
2206 if (auto version = (*val)[~sfServerVersion])
-
2207 jvObj[jss::server_version] = std::to_string(*version);
-
2208
-
2209 if (auto cookie = (*val)[~sfCookie])
-
2210 jvObj[jss::cookie] = std::to_string(*cookie);
-
2211
-
2212 if (auto hash = (*val)[~sfValidatedHash])
-
2213 jvObj[jss::validated_hash] = strHex(*hash);
-
2214
-
2215 auto const masterKey =
-
2216 app_.validatorManifests().getMasterKey(signerPublic);
-
2217
-
2218 if (masterKey != signerPublic)
-
2219 jvObj[jss::master_key] = toBase58(TokenType::NodePublic, masterKey);
+
2196 for (auto i = streamMap.begin(); i != streamMap.end();)
+
2197 {
+
2198 if (auto p = i->second.lock())
+
2199 {
+
2200 p->send(jvObj, true);
+
2201 ++i;
+
2202 }
+
2203 else
+
2204 {
+
2205 i = streamMap.erase(i);
+
2206 }
+
2207 }
+
2208 }
+
2209}
+
2210
+
2211void
+
2212NetworkOPsImp::pubValidation(std::shared_ptr<STValidation> const& val)
+
2213{
+
2214 // VFALCO consider std::shared_mutex
+
2215 std::lock_guard sl(mSubLock);
+
2216
+
2217 if (!mStreamMaps[sValidations].empty())
+
2218 {
+
2219 Json::Value jvObj(Json::objectValue);
2220
-
2221 // NOTE *seq is a number, but old API versions used string. We replace
-
2222 // number with a string using MultiApiJson near end of this function
-
2223 if (auto const seq = (*val)[~sfLedgerSequence])
-
2224 jvObj[jss::ledger_index] = *seq;
-
2225
-
2226 if (val->isFieldPresent(sfAmendments))
-
2227 {
-
2228 jvObj[jss::amendments] = Json::Value(Json::arrayValue);
-
2229 for (auto const& amendment : val->getFieldV256(sfAmendments))
-
2230 jvObj[jss::amendments].append(to_string(amendment));
-
2231 }
+
2221 auto const signerPublic = val->getSignerPublic();
+
2222
+
2223 jvObj[jss::type] = "validationReceived";
+
2224 jvObj[jss::validation_public_key] =
+
2225 toBase58(TokenType::NodePublic, signerPublic);
+
2226 jvObj[jss::ledger_hash] = to_string(val->getLedgerHash());
+
2227 jvObj[jss::signature] = strHex(val->getSignature());
+
2228 jvObj[jss::full] = val->isFull();
+
2229 jvObj[jss::flags] = val->getFlags();
+
2230 jvObj[jss::signing_time] = *(*val)[~sfSigningTime];
+
2231 jvObj[jss::data] = strHex(val->getSerializer().slice());
2232
-
2233 if (auto const closeTime = (*val)[~sfCloseTime])
-
2234 jvObj[jss::close_time] = *closeTime;
+
2233 if (auto version = (*val)[~sfServerVersion])
+
2234 jvObj[jss::server_version] = std::to_string(*version);
2235
-
2236 if (auto const loadFee = (*val)[~sfLoadFee])
-
2237 jvObj[jss::load_fee] = *loadFee;
+
2236 if (auto cookie = (*val)[~sfCookie])
+
2237 jvObj[jss::cookie] = std::to_string(*cookie);
2238
-
2239 if (auto const baseFee = val->at(~sfBaseFee))
-
2240 jvObj[jss::base_fee] = static_cast<double>(*baseFee);
+
2239 if (auto hash = (*val)[~sfValidatedHash])
+
2240 jvObj[jss::validated_hash] = strHex(*hash);
2241
-
2242 if (auto const reserveBase = val->at(~sfReserveBase))
-
2243 jvObj[jss::reserve_base] = *reserveBase;
+
2242 auto const masterKey =
+
2243 app_.validatorManifests().getMasterKey(signerPublic);
2244
-
2245 if (auto const reserveInc = val->at(~sfReserveIncrement))
-
2246 jvObj[jss::reserve_inc] = *reserveInc;
+
2245 if (masterKey != signerPublic)
+
2246 jvObj[jss::master_key] = toBase58(TokenType::NodePublic, masterKey);
2247
-
2248 // (The ~ operator converts the Proxy to a std::optional, which
-
2249 // simplifies later operations)
-
2250 if (auto const baseFeeXRP = ~val->at(~sfBaseFeeDrops);
-
2251 baseFeeXRP && baseFeeXRP->native())
-
2252 jvObj[jss::base_fee] = baseFeeXRP->xrp().jsonClipped();
-
2253
-
2254 if (auto const reserveBaseXRP = ~val->at(~sfReserveBaseDrops);
-
2255 reserveBaseXRP && reserveBaseXRP->native())
-
2256 jvObj[jss::reserve_base] = reserveBaseXRP->xrp().jsonClipped();
-
2257
-
2258 if (auto const reserveIncXRP = ~val->at(~sfReserveIncrementDrops);
-
2259 reserveIncXRP && reserveIncXRP->native())
-
2260 jvObj[jss::reserve_inc] = reserveIncXRP->xrp().jsonClipped();
-
2261
-
2262 // NOTE Use MultiApiJson to publish two slightly different JSON objects
-
2263 // for consumers supporting different API versions
-
2264 MultiApiJson multiObj{jvObj};
-
2265 multiObj.visit(
-
2266 RPC::apiVersion<1>, //
-
2267 [](Json::Value& jvTx) {
-
2268 // Type conversion for older API versions to string
-
2269 if (jvTx.isMember(jss::ledger_index))
-
2270 {
-
2271 jvTx[jss::ledger_index] =
-
2272 std::to_string(jvTx[jss::ledger_index].asUInt());
-
2273 }
-
2274 });
-
2275
-
2276 for (auto i = mStreamMaps[sValidations].begin();
-
2277 i != mStreamMaps[sValidations].end();)
-
2278 {
-
2279 if (auto p = i->second.lock())
-
2280 {
-
2281 multiObj.visit(
-
2282 p->getApiVersion(), //
-
2283 [&](Json::Value const& jv) { p->send(jv, true); });
-
2284 ++i;
-
2285 }
-
2286 else
-
2287 {
-
2288 i = mStreamMaps[sValidations].erase(i);
-
2289 }
-
2290 }
-
2291 }
-
2292}
-
2293
-
2294void
-
2295NetworkOPsImp::pubPeerStatus(std::function<Json::Value(void)> const& func)
-
2296{
-
2297 std::lock_guard sl(mSubLock);
-
2298
-
2299 if (!mStreamMaps[sPeerStatus].empty())
-
2300 {
-
2301 Json::Value jvObj(func());
+
2248 // NOTE *seq is a number, but old API versions used string. We replace
+
2249 // number with a string using MultiApiJson near end of this function
+
2250 if (auto const seq = (*val)[~sfLedgerSequence])
+
2251 jvObj[jss::ledger_index] = *seq;
+
2252
+
2253 if (val->isFieldPresent(sfAmendments))
+
2254 {
+
2255 jvObj[jss::amendments] = Json::Value(Json::arrayValue);
+
2256 for (auto const& amendment : val->getFieldV256(sfAmendments))
+
2257 jvObj[jss::amendments].append(to_string(amendment));
+
2258 }
+
2259
+
2260 if (auto const closeTime = (*val)[~sfCloseTime])
+
2261 jvObj[jss::close_time] = *closeTime;
+
2262
+
2263 if (auto const loadFee = (*val)[~sfLoadFee])
+
2264 jvObj[jss::load_fee] = *loadFee;
+
2265
+
2266 if (auto const baseFee = val->at(~sfBaseFee))
+
2267 jvObj[jss::base_fee] = static_cast<double>(*baseFee);
+
2268
+
2269 if (auto const reserveBase = val->at(~sfReserveBase))
+
2270 jvObj[jss::reserve_base] = *reserveBase;
+
2271
+
2272 if (auto const reserveInc = val->at(~sfReserveIncrement))
+
2273 jvObj[jss::reserve_inc] = *reserveInc;
+
2274
+
2275 // (The ~ operator converts the Proxy to a std::optional, which
+
2276 // simplifies later operations)
+
2277 if (auto const baseFeeXRP = ~val->at(~sfBaseFeeDrops);
+
2278 baseFeeXRP && baseFeeXRP->native())
+
2279 jvObj[jss::base_fee] = baseFeeXRP->xrp().jsonClipped();
+
2280
+
2281 if (auto const reserveBaseXRP = ~val->at(~sfReserveBaseDrops);
+
2282 reserveBaseXRP && reserveBaseXRP->native())
+
2283 jvObj[jss::reserve_base] = reserveBaseXRP->xrp().jsonClipped();
+
2284
+
2285 if (auto const reserveIncXRP = ~val->at(~sfReserveIncrementDrops);
+
2286 reserveIncXRP && reserveIncXRP->native())
+
2287 jvObj[jss::reserve_inc] = reserveIncXRP->xrp().jsonClipped();
+
2288
+
2289 // NOTE Use MultiApiJson to publish two slightly different JSON objects
+
2290 // for consumers supporting different API versions
+
2291 MultiApiJson multiObj{jvObj};
+
2292 multiObj.visit(
+
2293 RPC::apiVersion<1>, //
+
2294 [](Json::Value& jvTx) {
+
2295 // Type conversion for older API versions to string
+
2296 if (jvTx.isMember(jss::ledger_index))
+
2297 {
+
2298 jvTx[jss::ledger_index] =
+
2299 std::to_string(jvTx[jss::ledger_index].asUInt());
+
2300 }
+
2301 });
2302
-
2303 jvObj[jss::type] = "peerStatusChange";
-
2304
-
2305 for (auto i = mStreamMaps[sPeerStatus].begin();
-
2306 i != mStreamMaps[sPeerStatus].end();)
-
2307 {
-
2308 InfoSub::pointer p = i->second.lock();
-
2309
-
2310 if (p)
-
2311 {
-
2312 p->send(jvObj, true);
-
2313 ++i;
-
2314 }
-
2315 else
-
2316 {
-
2317 i = mStreamMaps[sPeerStatus].erase(i);
-
2318 }
-
2319 }
-
2320 }
-
2321}
-
2322
-
2323void
-
2324NetworkOPsImp::setMode(OperatingMode om)
-
2325{
-
2326 using namespace std::chrono_literals;
-
2327 if (om == OperatingMode::CONNECTED)
-
2328 {
-
2329 if (app_.getLedgerMaster().getValidatedLedgerAge() < 1min)
-
2330 om = OperatingMode::SYNCING;
-
2331 }
-
2332 else if (om == OperatingMode::SYNCING)
-
2333 {
-
2334 if (app_.getLedgerMaster().getValidatedLedgerAge() >= 1min)
-
2335 om = OperatingMode::CONNECTED;
-
2336 }
-
2337
-
2338 if ((om > OperatingMode::CONNECTED) && isBlocked())
-
2339 om = OperatingMode::CONNECTED;
-
2340
-
2341 if (mMode == om)
-
2342 return;
-
2343
-
2344 mMode = om;
-
2345
-
2346 accounting_.mode(om);
-
2347
-
2348 JLOG(m_journal.info()) << "STATE->" << strOperatingMode();
-
2349 pubServer();
-
2350}
-
2351
-
2352bool
-
2353NetworkOPsImp::recvValidation(
-
2354 std::shared_ptr<STValidation> const& val,
-
2355 std::string const& source)
-
2356{
-
2357 JLOG(m_journal.trace())
-
2358 << "recvValidation " << val->getLedgerHash() << " from " << source;
-
2359
-
2360 std::unique_lock lock(validationsMutex_);
-
2361 BypassAccept bypassAccept = BypassAccept::no;
-
2362 try
-
2363 {
-
2364 if (pendingValidations_.contains(val->getLedgerHash()))
-
2365 bypassAccept = BypassAccept::yes;
-
2366 else
-
2367 pendingValidations_.insert(val->getLedgerHash());
-
2368 scope_unlock unlock(lock);
-
2369 handleNewValidation(app_, val, source, bypassAccept, m_journal);
-
2370 }
-
2371 catch (std::exception const& e)
-
2372 {
-
2373 JLOG(m_journal.warn())
-
2374 << "Exception thrown for handling new validation "
-
2375 << val->getLedgerHash() << ": " << e.what();
-
2376 }
-
2377 catch (...)
-
2378 {
-
2379 JLOG(m_journal.warn())
-
2380 << "Unknown exception thrown for handling new validation "
-
2381 << val->getLedgerHash();
-
2382 }
-
2383 if (bypassAccept == BypassAccept::no)
-
2384 {
-
2385 pendingValidations_.erase(val->getLedgerHash());
-
2386 }
-
2387 lock.unlock();
-
2388
-
2389 pubValidation(val);
-
2390
-
2391 JLOG(m_journal.debug()) << [this, &val]() -> auto {
-
2392 std::stringstream ss;
-
2393 ss << "VALIDATION: " << val->render() << " master_key: ";
-
2394 auto master = app_.validators().getTrustedKey(val->getSignerPublic());
-
2395 if (master)
-
2396 {
-
2397 ss << toBase58(TokenType::NodePublic, *master);
-
2398 }
-
2399 else
-
2400 {
-
2401 ss << "none";
-
2402 }
-
2403 return ss.str();
-
2404 }();
-
2405
-
2406 // We will always relay trusted validations; if configured, we will
-
2407 // also relay all untrusted validations.
-
2408 return app_.config().RELAY_UNTRUSTED_VALIDATIONS == 1 || val->isTrusted();
-
2409}
-
2410
-
2411Json::Value
-
2412NetworkOPsImp::getConsensusInfo()
-
2413{
-
2414 return mConsensus.getJson(true);
-
2415}
-
2416
-
2417Json::Value
-
2418NetworkOPsImp::getServerInfo(bool human, bool admin, bool counters)
-
2419{
-
2420 Json::Value info = Json::objectValue;
-
2421
-
2422 // System-level warnings
-
2423 {
-
2424 Json::Value warnings{Json::arrayValue};
-
2425 if (isAmendmentBlocked())
-
2426 {
-
2427 Json::Value& w = warnings.append(Json::objectValue);
-
2428 w[jss::id] = warnRPC_AMENDMENT_BLOCKED;
-
2429 w[jss::message] =
-
2430 "This server is amendment blocked, and must be updated to be "
-
2431 "able to stay in sync with the network.";
-
2432 }
-
2433 if (isUNLBlocked())
-
2434 {
-
2435 Json::Value& w = warnings.append(Json::objectValue);
-
2436 w[jss::id] = warnRPC_EXPIRED_VALIDATOR_LIST;
-
2437 w[jss::message] =
-
2438 "This server has an expired validator list. validators.txt "
-
2439 "may be incorrectly configured or some [validator_list_sites] "
-
2440 "may be unreachable.";
-
2441 }
-
2442 if (admin && isAmendmentWarned())
-
2443 {
-
2444 Json::Value& w = warnings.append(Json::objectValue);
-
2445 w[jss::id] = warnRPC_UNSUPPORTED_MAJORITY;
-
2446 w[jss::message] =
-
2447 "One or more unsupported amendments have reached majority. "
-
2448 "Upgrade to the latest version before they are activated "
-
2449 "to avoid being amendment blocked.";
-
2450 if (auto const expected =
-
2451 app_.getAmendmentTable().firstUnsupportedExpected())
-
2452 {
-
2453 auto& d = w[jss::details] = Json::objectValue;
-
2454 d[jss::expected_date] = expected->time_since_epoch().count();
-
2455 d[jss::expected_date_UTC] = to_string(*expected);
-
2456 }
-
2457 }
-
2458
-
2459 if (warnings.size())
-
2460 info[jss::warnings] = std::move(warnings);
-
2461 }
-
2462
-
2463 // hostid: unique string describing the machine
-
2464 if (human)
-
2465 info[jss::hostid] = getHostId(admin);
-
2466
-
2467 // domain: if configured with a domain, report it:
-
2468 if (!app_.config().SERVER_DOMAIN.empty())
-
2469 info[jss::server_domain] = app_.config().SERVER_DOMAIN;
-
2470
-
2471 info[jss::build_version] = BuildInfo::getVersionString();
-
2472
-
2473 info[jss::server_state] = strOperatingMode(admin);
-
2474
-
2475 info[jss::time] = to_string(std::chrono::floor<std::chrono::microseconds>(
-
2476 std::chrono::system_clock::now()));
-
2477
-
2478 if (needNetworkLedger_)
-
2479 info[jss::network_ledger] = "waiting";
-
2480
-
2481 info[jss::validation_quorum] =
-
2482 static_cast<Json::UInt>(app_.validators().quorum());
-
2483
-
2484 if (admin)
-
2485 {
-
2486 switch (app_.config().NODE_SIZE)
-
2487 {
-
2488 case 0:
-
2489 info[jss::node_size] = "tiny";
-
2490 break;
-
2491 case 1:
-
2492 info[jss::node_size] = "small";
-
2493 break;
-
2494 case 2:
-
2495 info[jss::node_size] = "medium";
-
2496 break;
-
2497 case 3:
-
2498 info[jss::node_size] = "large";
-
2499 break;
-
2500 case 4:
-
2501 info[jss::node_size] = "huge";
-
2502 break;
-
2503 }
+
2303 for (auto i = mStreamMaps[sValidations].begin();
+
2304 i != mStreamMaps[sValidations].end();)
+
2305 {
+
2306 if (auto p = i->second.lock())
+
2307 {
+
2308 multiObj.visit(
+
2309 p->getApiVersion(), //
+
2310 [&](Json::Value const& jv) { p->send(jv, true); });
+
2311 ++i;
+
2312 }
+
2313 else
+
2314 {
+
2315 i = mStreamMaps[sValidations].erase(i);
+
2316 }
+
2317 }
+
2318 }
+
2319}
+
2320
+
2321void
+
2322NetworkOPsImp::pubPeerStatus(std::function<Json::Value(void)> const& func)
+
2323{
+
2324 std::lock_guard sl(mSubLock);
+
2325
+
2326 if (!mStreamMaps[sPeerStatus].empty())
+
2327 {
+
2328 Json::Value jvObj(func());
+
2329
+
2330 jvObj[jss::type] = "peerStatusChange";
+
2331
+
2332 for (auto i = mStreamMaps[sPeerStatus].begin();
+
2333 i != mStreamMaps[sPeerStatus].end();)
+
2334 {
+
2335 InfoSub::pointer p = i->second.lock();
+
2336
+
2337 if (p)
+
2338 {
+
2339 p->send(jvObj, true);
+
2340 ++i;
+
2341 }
+
2342 else
+
2343 {
+
2344 i = mStreamMaps[sPeerStatus].erase(i);
+
2345 }
+
2346 }
+
2347 }
+
2348}
+
2349
+
2350void
+
2351NetworkOPsImp::setMode(OperatingMode om)
+
2352{
+
2353 using namespace std::chrono_literals;
+
2354 if (om == OperatingMode::CONNECTED)
+
2355 {
+
2356 if (app_.getLedgerMaster().getValidatedLedgerAge() < 1min)
+
2357 om = OperatingMode::SYNCING;
+
2358 }
+
2359 else if (om == OperatingMode::SYNCING)
+
2360 {
+
2361 if (app_.getLedgerMaster().getValidatedLedgerAge() >= 1min)
+
2362 om = OperatingMode::CONNECTED;
+
2363 }
+
2364
+
2365 if ((om > OperatingMode::CONNECTED) && isBlocked())
+
2366 om = OperatingMode::CONNECTED;
+
2367
+
2368 if (mMode == om)
+
2369 return;
+
2370
+
2371 mMode = om;
+
2372
+
2373 accounting_.mode(om);
+
2374
+
2375 JLOG(m_journal.info()) << "STATE->" << strOperatingMode();
+
2376 pubServer();
+
2377}
+
2378
+
2379bool
+
2380NetworkOPsImp::recvValidation(
+
2381 std::shared_ptr<STValidation> const& val,
+
2382 std::string const& source)
+
2383{
+
2384 JLOG(m_journal.trace())
+
2385 << "recvValidation " << val->getLedgerHash() << " from " << source;
+
2386
+
2387 std::unique_lock lock(validationsMutex_);
+
2388 BypassAccept bypassAccept = BypassAccept::no;
+
2389 try
+
2390 {
+
2391 if (pendingValidations_.contains(val->getLedgerHash()))
+
2392 bypassAccept = BypassAccept::yes;
+
2393 else
+
2394 pendingValidations_.insert(val->getLedgerHash());
+
2395 scope_unlock unlock(lock);
+
2396 handleNewValidation(app_, val, source, bypassAccept, m_journal);
+
2397 }
+
2398 catch (std::exception const& e)
+
2399 {
+
2400 JLOG(m_journal.warn())
+
2401 << "Exception thrown for handling new validation "
+
2402 << val->getLedgerHash() << ": " << e.what();
+
2403 }
+
2404 catch (...)
+
2405 {
+
2406 JLOG(m_journal.warn())
+
2407 << "Unknown exception thrown for handling new validation "
+
2408 << val->getLedgerHash();
+
2409 }
+
2410 if (bypassAccept == BypassAccept::no)
+
2411 {
+
2412 pendingValidations_.erase(val->getLedgerHash());
+
2413 }
+
2414 lock.unlock();
+
2415
+
2416 pubValidation(val);
+
2417
+
2418 JLOG(m_journal.debug()) << [this, &val]() -> auto {
+
2419 std::stringstream ss;
+
2420 ss << "VALIDATION: " << val->render() << " master_key: ";
+
2421 auto master = app_.validators().getTrustedKey(val->getSignerPublic());
+
2422 if (master)
+
2423 {
+
2424 ss << toBase58(TokenType::NodePublic, *master);
+
2425 }
+
2426 else
+
2427 {
+
2428 ss << "none";
+
2429 }
+
2430 return ss.str();
+
2431 }();
+
2432
+
2433 // We will always relay trusted validations; if configured, we will
+
2434 // also relay all untrusted validations.
+
2435 return app_.config().RELAY_UNTRUSTED_VALIDATIONS == 1 || val->isTrusted();
+
2436}
+
2437
+
2438Json::Value
+
2439NetworkOPsImp::getConsensusInfo()
+
2440{
+
2441 return mConsensus.getJson(true);
+
2442}
+
2443
+
2444Json::Value
+
2445NetworkOPsImp::getServerInfo(bool human, bool admin, bool counters)
+
2446{
+
2447 Json::Value info = Json::objectValue;
+
2448
+
2449 // System-level warnings
+
2450 {
+
2451 Json::Value warnings{Json::arrayValue};
+
2452 if (isAmendmentBlocked())
+
2453 {
+
2454 Json::Value& w = warnings.append(Json::objectValue);
+
2455 w[jss::id] = warnRPC_AMENDMENT_BLOCKED;
+
2456 w[jss::message] =
+
2457 "This server is amendment blocked, and must be updated to be "
+
2458 "able to stay in sync with the network.";
+
2459 }
+
2460 if (isUNLBlocked())
+
2461 {
+
2462 Json::Value& w = warnings.append(Json::objectValue);
+
2463 w[jss::id] = warnRPC_EXPIRED_VALIDATOR_LIST;
+
2464 w[jss::message] =
+
2465 "This server has an expired validator list. validators.txt "
+
2466 "may be incorrectly configured or some [validator_list_sites] "
+
2467 "may be unreachable.";
+
2468 }
+
2469 if (admin && isAmendmentWarned())
+
2470 {
+
2471 Json::Value& w = warnings.append(Json::objectValue);
+
2472 w[jss::id] = warnRPC_UNSUPPORTED_MAJORITY;
+
2473 w[jss::message] =
+
2474 "One or more unsupported amendments have reached majority. "
+
2475 "Upgrade to the latest version before they are activated "
+
2476 "to avoid being amendment blocked.";
+
2477 if (auto const expected =
+
2478 app_.getAmendmentTable().firstUnsupportedExpected())
+
2479 {
+
2480 auto& d = w[jss::details] = Json::objectValue;
+
2481 d[jss::expected_date] = expected->time_since_epoch().count();
+
2482 d[jss::expected_date_UTC] = to_string(*expected);
+
2483 }
+
2484 }
+
2485
+
2486 if (warnings.size())
+
2487 info[jss::warnings] = std::move(warnings);
+
2488 }
+
2489
+
2490 // hostid: unique string describing the machine
+
2491 if (human)
+
2492 info[jss::hostid] = getHostId(admin);
+
2493
+
2494 // domain: if configured with a domain, report it:
+
2495 if (!app_.config().SERVER_DOMAIN.empty())
+
2496 info[jss::server_domain] = app_.config().SERVER_DOMAIN;
+
2497
+
2498 info[jss::build_version] = BuildInfo::getVersionString();
+
2499
+
2500 info[jss::server_state] = strOperatingMode(admin);
+
2501
+
2502 info[jss::time] = to_string(std::chrono::floor<std::chrono::microseconds>(
+
2503 std::chrono::system_clock::now()));
2504
-
2505 auto when = app_.validators().expires();
-
2506
-
2507 if (!human)
-
2508 {
-
2509 if (when)
-
2510 info[jss::validator_list_expires] =
-
2511 safe_cast<Json::UInt>(when->time_since_epoch().count());
-
2512 else
-
2513 info[jss::validator_list_expires] = 0;
-
2514 }
-
2515 else
-
2516 {
-
2517 auto& x = (info[jss::validator_list] = Json::objectValue);
-
2518
-
2519 x[jss::count] = static_cast<Json::UInt>(app_.validators().count());
-
2520
-
2521 if (when)
-
2522 {
-
2523 if (*when == TimeKeeper::time_point::max())
-
2524 {
-
2525 x[jss::expiration] = "never";
-
2526 x[jss::status] = "active";
-
2527 }
-
2528 else
-
2529 {
-
2530 x[jss::expiration] = to_string(*when);
+
2505 if (needNetworkLedger_)
+
2506 info[jss::network_ledger] = "waiting";
+
2507
+
2508 info[jss::validation_quorum] =
+
2509 static_cast<Json::UInt>(app_.validators().quorum());
+
2510
+
2511 if (admin)
+
2512 {
+
2513 switch (app_.config().NODE_SIZE)
+
2514 {
+
2515 case 0:
+
2516 info[jss::node_size] = "tiny";
+
2517 break;
+
2518 case 1:
+
2519 info[jss::node_size] = "small";
+
2520 break;
+
2521 case 2:
+
2522 info[jss::node_size] = "medium";
+
2523 break;
+
2524 case 3:
+
2525 info[jss::node_size] = "large";
+
2526 break;
+
2527 case 4:
+
2528 info[jss::node_size] = "huge";
+
2529 break;
+
2530 }
2531
-
2532 if (*when > app_.timeKeeper().now())
-
2533 x[jss::status] = "active";
-
2534 else
-
2535 x[jss::status] = "expired";
-
2536 }
-
2537 }
-
2538 else
-
2539 {
-
2540 x[jss::status] = "unknown";
-
2541 x[jss::expiration] = "unknown";
-
2542 }
-
2543 }
-
2544
-
2545#if defined(GIT_COMMIT_HASH) || defined(GIT_BRANCH)
-
2546 {
-
2547 auto& x = (info[jss::git] = Json::objectValue);
-
2548#ifdef GIT_COMMIT_HASH
-
2549 x[jss::hash] = GIT_COMMIT_HASH;
-
2550#endif
-
2551#ifdef GIT_BRANCH
-
2552 x[jss::branch] = GIT_BRANCH;
-
2553#endif
-
2554 }
-
2555#endif
-
2556 }
-
2557 info[jss::io_latency_ms] =
-
2558 static_cast<Json::UInt>(app_.getIOLatency().count());
-
2559
-
2560 if (admin)
-
2561 {
-
2562 if (auto const localPubKey = app_.validators().localPublicKey();
-
2563 localPubKey && app_.getValidationPublicKey())
-
2564 {
-
2565 info[jss::pubkey_validator] =
-
2566 toBase58(TokenType::NodePublic, localPubKey.value());
-
2567 }
-
2568 else
-
2569 {
-
2570 info[jss::pubkey_validator] = "none";
-
2571 }
-
2572 }
-
2573
-
2574 if (counters)
-
2575 {
-
2576 info[jss::counters] = app_.getPerfLog().countersJson();
-
2577
-
2578 Json::Value nodestore(Json::objectValue);
-
2579 app_.getNodeStore().getCountsJson(nodestore);
-
2580 info[jss::counters][jss::nodestore] = nodestore;
-
2581 info[jss::current_activities] = app_.getPerfLog().currentJson();
-
2582 }
-
2583
-
2584 info[jss::pubkey_node] =
-
2585 toBase58(TokenType::NodePublic, app_.nodeIdentity().first);
+
2532 auto when = app_.validators().expires();
+
2533
+
2534 if (!human)
+
2535 {
+
2536 if (when)
+
2537 info[jss::validator_list_expires] =
+
2538 safe_cast<Json::UInt>(when->time_since_epoch().count());
+
2539 else
+
2540 info[jss::validator_list_expires] = 0;
+
2541 }
+
2542 else
+
2543 {
+
2544 auto& x = (info[jss::validator_list] = Json::objectValue);
+
2545
+
2546 x[jss::count] = static_cast<Json::UInt>(app_.validators().count());
+
2547
+
2548 if (when)
+
2549 {
+
2550 if (*when == TimeKeeper::time_point::max())
+
2551 {
+
2552 x[jss::expiration] = "never";
+
2553 x[jss::status] = "active";
+
2554 }
+
2555 else
+
2556 {
+
2557 x[jss::expiration] = to_string(*when);
+
2558
+
2559 if (*when > app_.timeKeeper().now())
+
2560 x[jss::status] = "active";
+
2561 else
+
2562 x[jss::status] = "expired";
+
2563 }
+
2564 }
+
2565 else
+
2566 {
+
2567 x[jss::status] = "unknown";
+
2568 x[jss::expiration] = "unknown";
+
2569 }
+
2570 }
+
2571
+
2572#if defined(GIT_COMMIT_HASH) || defined(GIT_BRANCH)
+
2573 {
+
2574 auto& x = (info[jss::git] = Json::objectValue);
+
2575#ifdef GIT_COMMIT_HASH
+
2576 x[jss::hash] = GIT_COMMIT_HASH;
+
2577#endif
+
2578#ifdef GIT_BRANCH
+
2579 x[jss::branch] = GIT_BRANCH;
+
2580#endif
+
2581 }
+
2582#endif
+
2583 }
+
2584 info[jss::io_latency_ms] =
+
2585 static_cast<Json::UInt>(app_.getIOLatency().count());
2586
-
2587 info[jss::complete_ledgers] = app_.getLedgerMaster().getCompleteLedgers();
-
2588
-
2589 if (amendmentBlocked_)
-
2590 info[jss::amendment_blocked] = true;
-
2591
-
2592 auto const fp = m_ledgerMaster.getFetchPackCacheSize();
-
2593
-
2594 if (fp != 0)
-
2595 info[jss::fetch_pack] = Json::UInt(fp);
-
2596
-
2597 info[jss::peers] = Json::UInt(app_.overlay().size());
-
2598
-
2599 Json::Value lastClose = Json::objectValue;
-
2600 lastClose[jss::proposers] = Json::UInt(mConsensus.prevProposers());
-
2601
-
2602 if (human)
-
2603 {
-
2604 lastClose[jss::converge_time_s] =
-
2605 std::chrono::duration<double>{mConsensus.prevRoundTime()}.count();
-
2606 }
-
2607 else
-
2608 {
-
2609 lastClose[jss::converge_time] =
-
2610 Json::Int(mConsensus.prevRoundTime().count());
-
2611 }
-
2612
-
2613 info[jss::last_close] = lastClose;
-
2614
-
2615 // info[jss::consensus] = mConsensus.getJson();
-
2616
-
2617 if (admin)
-
2618 info[jss::load] = m_job_queue.getJson();
-
2619
-
2620 if (auto const netid = app_.overlay().networkID())
-
2621 info[jss::network_id] = static_cast<Json::UInt>(*netid);
-
2622
-
2623 auto const escalationMetrics =
-
2624 app_.getTxQ().getMetrics(*app_.openLedger().current());
+
2587 if (admin)
+
2588 {
+
2589 if (auto const localPubKey = app_.validators().localPublicKey();
+
2590 localPubKey && app_.getValidationPublicKey())
+
2591 {
+
2592 info[jss::pubkey_validator] =
+
2593 toBase58(TokenType::NodePublic, localPubKey.value());
+
2594 }
+
2595 else
+
2596 {
+
2597 info[jss::pubkey_validator] = "none";
+
2598 }
+
2599 }
+
2600
+
2601 if (counters)
+
2602 {
+
2603 info[jss::counters] = app_.getPerfLog().countersJson();
+
2604
+
2605 Json::Value nodestore(Json::objectValue);
+
2606 app_.getNodeStore().getCountsJson(nodestore);
+
2607 info[jss::counters][jss::nodestore] = nodestore;
+
2608 info[jss::current_activities] = app_.getPerfLog().currentJson();
+
2609 }
+
2610
+
2611 info[jss::pubkey_node] =
+
2612 toBase58(TokenType::NodePublic, app_.nodeIdentity().first);
+
2613
+
2614 info[jss::complete_ledgers] = app_.getLedgerMaster().getCompleteLedgers();
+
2615
+
2616 if (amendmentBlocked_)
+
2617 info[jss::amendment_blocked] = true;
+
2618
+
2619 auto const fp = m_ledgerMaster.getFetchPackCacheSize();
+
2620
+
2621 if (fp != 0)
+
2622 info[jss::fetch_pack] = Json::UInt(fp);
+
2623
+
2624 info[jss::peers] = Json::UInt(app_.overlay().size());
2625
-
2626 auto const loadFactorServer = app_.getFeeTrack().getLoadFactor();
-
2627 auto const loadBaseServer = app_.getFeeTrack().getLoadBase();
-
2628 /* Scale the escalated fee level to unitless "load factor".
-
2629 In practice, this just strips the units, but it will continue
-
2630 to work correctly if either base value ever changes. */
-
2631 auto const loadFactorFeeEscalation =
-
2632 mulDiv(
-
2633 escalationMetrics.openLedgerFeeLevel,
-
2634 loadBaseServer,
-
2635 escalationMetrics.referenceFeeLevel)
-
2636 .value_or(ripple::muldiv_max);
-
2637
-
2638 auto const loadFactor = std::max(
-
2639 safe_cast<std::uint64_t>(loadFactorServer), loadFactorFeeEscalation);
-
2640
-
2641 if (!human)
-
2642 {
-
2643 info[jss::load_base] = loadBaseServer;
-
2644 info[jss::load_factor] = trunc32(loadFactor);
-
2645 info[jss::load_factor_server] = loadFactorServer;
+
2626 Json::Value lastClose = Json::objectValue;
+
2627 lastClose[jss::proposers] = Json::UInt(mConsensus.prevProposers());
+
2628
+
2629 if (human)
+
2630 {
+
2631 lastClose[jss::converge_time_s] =
+
2632 std::chrono::duration<double>{mConsensus.prevRoundTime()}.count();
+
2633 }
+
2634 else
+
2635 {
+
2636 lastClose[jss::converge_time] =
+
2637 Json::Int(mConsensus.prevRoundTime().count());
+
2638 }
+
2639
+
2640 info[jss::last_close] = lastClose;
+
2641
+
2642 // info[jss::consensus] = mConsensus.getJson();
+
2643
+
2644 if (admin)
+
2645 info[jss::load] = m_job_queue.getJson();
2646
-
2647 /* Json::Value doesn't support uint64, so clamp to max
-
2648 uint32 value. This is mostly theoretical, since there
-
2649 probably isn't enough extant XRP to drive the factor
-
2650 that high.
-
2651 */
-
2652 info[jss::load_factor_fee_escalation] =
-
2653 escalationMetrics.openLedgerFeeLevel.jsonClipped();
-
2654 info[jss::load_factor_fee_queue] =
-
2655 escalationMetrics.minProcessingFeeLevel.jsonClipped();
-
2656 info[jss::load_factor_fee_reference] =
-
2657 escalationMetrics.referenceFeeLevel.jsonClipped();
-
2658 }
-
2659 else
-
2660 {
-
2661 info[jss::load_factor] =
-
2662 static_cast<double>(loadFactor) / loadBaseServer;
-
2663
-
2664 if (loadFactorServer != loadFactor)
-
2665 info[jss::load_factor_server] =
-
2666 static_cast<double>(loadFactorServer) / loadBaseServer;
+
2647 if (auto const netid = app_.overlay().networkID())
+
2648 info[jss::network_id] = static_cast<Json::UInt>(*netid);
+
2649
+
2650 auto const escalationMetrics =
+
2651 app_.getTxQ().getMetrics(*app_.openLedger().current());
+
2652
+
2653 auto const loadFactorServer = app_.getFeeTrack().getLoadFactor();
+
2654 auto const loadBaseServer = app_.getFeeTrack().getLoadBase();
+
2655 /* Scale the escalated fee level to unitless "load factor".
+
2656 In practice, this just strips the units, but it will continue
+
2657 to work correctly if either base value ever changes. */
+
2658 auto const loadFactorFeeEscalation =
+
2659 mulDiv(
+
2660 escalationMetrics.openLedgerFeeLevel,
+
2661 loadBaseServer,
+
2662 escalationMetrics.referenceFeeLevel)
+
2663 .value_or(ripple::muldiv_max);
+
2664
+
2665 auto const loadFactor = std::max(
+
2666 safe_cast<std::uint64_t>(loadFactorServer), loadFactorFeeEscalation);
2667
-
2668 if (admin)
-
2669 {
-
2670 std::uint32_t fee = app_.getFeeTrack().getLocalFee();
-
2671 if (fee != loadBaseServer)
-
2672 info[jss::load_factor_local] =
-
2673 static_cast<double>(fee) / loadBaseServer;
-
2674 fee = app_.getFeeTrack().getRemoteFee();
-
2675 if (fee != loadBaseServer)
-
2676 info[jss::load_factor_net] =
-
2677 static_cast<double>(fee) / loadBaseServer;
-
2678 fee = app_.getFeeTrack().getClusterFee();
-
2679 if (fee != loadBaseServer)
-
2680 info[jss::load_factor_cluster] =
-
2681 static_cast<double>(fee) / loadBaseServer;
-
2682 }
-
2683 if (escalationMetrics.openLedgerFeeLevel !=
-
2684 escalationMetrics.referenceFeeLevel &&
-
2685 (admin || loadFactorFeeEscalation != loadFactor))
-
2686 info[jss::load_factor_fee_escalation] =
-
2687 escalationMetrics.openLedgerFeeLevel.decimalFromReference(
-
2688 escalationMetrics.referenceFeeLevel);
-
2689 if (escalationMetrics.minProcessingFeeLevel !=
-
2690 escalationMetrics.referenceFeeLevel)
-
2691 info[jss::load_factor_fee_queue] =
-
2692 escalationMetrics.minProcessingFeeLevel.decimalFromReference(
-
2693 escalationMetrics.referenceFeeLevel);
-
2694 }
-
2695
-
2696 bool valid = false;
-
2697 auto lpClosed = m_ledgerMaster.getValidatedLedger();
-
2698
-
2699 if (lpClosed)
-
2700 valid = true;
-
2701 else
-
2702 lpClosed = m_ledgerMaster.getClosedLedger();
-
2703
-
2704 if (lpClosed)
-
2705 {
-
2706 XRPAmount const baseFee = lpClosed->fees().base;
-
2707 Json::Value l(Json::objectValue);
-
2708 l[jss::seq] = Json::UInt(lpClosed->info().seq);
-
2709 l[jss::hash] = to_string(lpClosed->info().hash);
-
2710
-
2711 if (!human)
-
2712 {
-
2713 l[jss::base_fee] = baseFee.jsonClipped();
-
2714 l[jss::reserve_base] =
-
2715 lpClosed->fees().accountReserve(0).jsonClipped();
-
2716 l[jss::reserve_inc] = lpClosed->fees().increment.jsonClipped();
-
2717 l[jss::close_time] = Json::Value::UInt(
-
2718 lpClosed->info().closeTime.time_since_epoch().count());
-
2719 }
-
2720 else
-
2721 {
-
2722 l[jss::base_fee_xrp] = baseFee.decimalXRP();
-
2723 l[jss::reserve_base_xrp] =
-
2724 lpClosed->fees().accountReserve(0).decimalXRP();
-
2725 l[jss::reserve_inc_xrp] = lpClosed->fees().increment.decimalXRP();
-
2726
-
2727 if (auto const closeOffset = app_.timeKeeper().closeOffset();
-
2728 std::abs(closeOffset.count()) >= 60)
-
2729 l[jss::close_time_offset] =
-
2730 static_cast<std::uint32_t>(closeOffset.count());
-
2731
-
2732 constexpr std::chrono::seconds highAgeThreshold{1000000};
-
2733 if (m_ledgerMaster.haveValidated())
-
2734 {
-
2735 auto const age = m_ledgerMaster.getValidatedLedgerAge();
-
2736 l[jss::age] =
-
2737 Json::UInt(age < highAgeThreshold ? age.count() : 0);
-
2738 }
-
2739 else
-
2740 {
-
2741 auto lCloseTime = lpClosed->info().closeTime;
-
2742 auto closeTime = app_.timeKeeper().closeTime();
-
2743 if (lCloseTime <= closeTime)
-
2744 {
-
2745 using namespace std::chrono_literals;
-
2746 auto age = closeTime - lCloseTime;
-
2747 l[jss::age] =
-
2748 Json::UInt(age < highAgeThreshold ? age.count() : 0);
-
2749 }
-
2750 }
-
2751 }
-
2752
-
2753 if (valid)
-
2754 info[jss::validated_ledger] = l;
-
2755 else
-
2756 info[jss::closed_ledger] = l;
-
2757
-
2758 auto lpPublished = m_ledgerMaster.getPublishedLedger();
-
2759 if (!lpPublished)
-
2760 info[jss::published_ledger] = "none";
-
2761 else if (lpPublished->info().seq != lpClosed->info().seq)
-
2762 info[jss::published_ledger] = lpPublished->info().seq;
-
2763 }
-
2764
-
2765 accounting_.json(info);
-
2766 info[jss::uptime] = UptimeClock::now().time_since_epoch().count();
-
2767 info[jss::jq_trans_overflow] =
-
2768 std::to_string(app_.overlay().getJqTransOverflow());
-
2769 info[jss::peer_disconnects] =
-
2770 std::to_string(app_.overlay().getPeerDisconnect());
-
2771 info[jss::peer_disconnects_resources] =
-
2772 std::to_string(app_.overlay().getPeerDisconnectCharges());
-
2773
-
2774 // This array must be sorted in increasing order.
-
2775 static constexpr std::array<std::string_view, 7> protocols{
-
2776 "http", "https", "peer", "ws", "ws2", "wss", "wss2"};
-
2777 static_assert(std::is_sorted(std::begin(protocols), std::end(protocols)));
-
2778 {
-
2779 Json::Value ports{Json::arrayValue};
-
2780 for (auto const& port : app_.getServerHandler().setup().ports)
-
2781 {
-
2782 // Don't publish admin ports for non-admin users
-
2783 if (!admin &&
-
2784 !(port.admin_nets_v4.empty() && port.admin_nets_v6.empty() &&
-
2785 port.admin_user.empty() && port.admin_password.empty()))
-
2786 continue;
-
2787 std::vector<std::string> proto;
-
2788 std::set_intersection(
-
2789 std::begin(port.protocol),
-
2790 std::end(port.protocol),
-
2791 std::begin(protocols),
-
2792 std::end(protocols),
-
2793 std::back_inserter(proto));
-
2794 if (!proto.empty())
-
2795 {
-
2796 auto& jv = ports.append(Json::Value(Json::objectValue));
-
2797 jv[jss::port] = std::to_string(port.port);
-
2798 jv[jss::protocol] = Json::Value{Json::arrayValue};
-
2799 for (auto const& p : proto)
-
2800 jv[jss::protocol].append(p);
-
2801 }
-
2802 }
-
2803
-
2804 if (app_.config().exists(SECTION_PORT_GRPC))
-
2805 {
-
2806 auto const& grpcSection = app_.config().section(SECTION_PORT_GRPC);
-
2807 auto const optPort = grpcSection.get("port");
-
2808 if (optPort && grpcSection.get("ip"))
-
2809 {
-
2810 auto& jv = ports.append(Json::Value(Json::objectValue));
-
2811 jv[jss::port] = *optPort;
-
2812 jv[jss::protocol] = Json::Value{Json::arrayValue};
-
2813 jv[jss::protocol].append("grpc");
-
2814 }
-
2815 }
-
2816 info[jss::ports] = std::move(ports);
-
2817 }
-
2818
-
2819 return info;
-
2820}
-
2821
-
2822void
-
2823NetworkOPsImp::clearLedgerFetch()
-
2824{
-
2825 app_.getInboundLedgers().clearFailures();
-
2826}
-
2827
-
2828Json::Value
-
2829NetworkOPsImp::getLedgerFetchInfo()
-
2830{
-
2831 return app_.getInboundLedgers().getInfo();
-
2832}
-
2833
-
2834void
-
2835NetworkOPsImp::pubProposedTransaction(
-
2836 std::shared_ptr<ReadView const> const& ledger,
-
2837 std::shared_ptr<STTx const> const& transaction,
-
2838 TER result)
-
2839{
-
2840 MultiApiJson jvObj =
-
2841 transJson(transaction, result, false, ledger, std::nullopt);
-
2842
-
2843 {
-
2844 std::lock_guard sl(mSubLock);
+
2668 if (!human)
+
2669 {
+
2670 info[jss::load_base] = loadBaseServer;
+
2671 info[jss::load_factor] = trunc32(loadFactor);
+
2672 info[jss::load_factor_server] = loadFactorServer;
+
2673
+
2674 /* Json::Value doesn't support uint64, so clamp to max
+
2675 uint32 value. This is mostly theoretical, since there
+
2676 probably isn't enough extant XRP to drive the factor
+
2677 that high.
+
2678 */
+
2679 info[jss::load_factor_fee_escalation] =
+
2680 escalationMetrics.openLedgerFeeLevel.jsonClipped();
+
2681 info[jss::load_factor_fee_queue] =
+
2682 escalationMetrics.minProcessingFeeLevel.jsonClipped();
+
2683 info[jss::load_factor_fee_reference] =
+
2684 escalationMetrics.referenceFeeLevel.jsonClipped();
+
2685 }
+
2686 else
+
2687 {
+
2688 info[jss::load_factor] =
+
2689 static_cast<double>(loadFactor) / loadBaseServer;
+
2690
+
2691 if (loadFactorServer != loadFactor)
+
2692 info[jss::load_factor_server] =
+
2693 static_cast<double>(loadFactorServer) / loadBaseServer;
+
2694
+
2695 if (admin)
+
2696 {
+
2697 std::uint32_t fee = app_.getFeeTrack().getLocalFee();
+
2698 if (fee != loadBaseServer)
+
2699 info[jss::load_factor_local] =
+
2700 static_cast<double>(fee) / loadBaseServer;
+
2701 fee = app_.getFeeTrack().getRemoteFee();
+
2702 if (fee != loadBaseServer)
+
2703 info[jss::load_factor_net] =
+
2704 static_cast<double>(fee) / loadBaseServer;
+
2705 fee = app_.getFeeTrack().getClusterFee();
+
2706 if (fee != loadBaseServer)
+
2707 info[jss::load_factor_cluster] =
+
2708 static_cast<double>(fee) / loadBaseServer;
+
2709 }
+
2710 if (escalationMetrics.openLedgerFeeLevel !=
+
2711 escalationMetrics.referenceFeeLevel &&
+
2712 (admin || loadFactorFeeEscalation != loadFactor))
+
2713 info[jss::load_factor_fee_escalation] =
+
2714 escalationMetrics.openLedgerFeeLevel.decimalFromReference(
+
2715 escalationMetrics.referenceFeeLevel);
+
2716 if (escalationMetrics.minProcessingFeeLevel !=
+
2717 escalationMetrics.referenceFeeLevel)
+
2718 info[jss::load_factor_fee_queue] =
+
2719 escalationMetrics.minProcessingFeeLevel.decimalFromReference(
+
2720 escalationMetrics.referenceFeeLevel);
+
2721 }
+
2722
+
2723 bool valid = false;
+
2724 auto lpClosed = m_ledgerMaster.getValidatedLedger();
+
2725
+
2726 if (lpClosed)
+
2727 valid = true;
+
2728 else
+
2729 lpClosed = m_ledgerMaster.getClosedLedger();
+
2730
+
2731 if (lpClosed)
+
2732 {
+
2733 XRPAmount const baseFee = lpClosed->fees().base;
+
2734 Json::Value l(Json::objectValue);
+
2735 l[jss::seq] = Json::UInt(lpClosed->info().seq);
+
2736 l[jss::hash] = to_string(lpClosed->info().hash);
+
2737
+
2738 if (!human)
+
2739 {
+
2740 l[jss::base_fee] = baseFee.jsonClipped();
+
2741 l[jss::reserve_base] =
+
2742 lpClosed->fees().accountReserve(0).jsonClipped();
+
2743 l[jss::reserve_inc] = lpClosed->fees().increment.jsonClipped();
+
2744 l[jss::close_time] = Json::Value::UInt(
+
2745 lpClosed->info().closeTime.time_since_epoch().count());
+
2746 }
+
2747 else
+
2748 {
+
2749 l[jss::base_fee_xrp] = baseFee.decimalXRP();
+
2750 l[jss::reserve_base_xrp] =
+
2751 lpClosed->fees().accountReserve(0).decimalXRP();
+
2752 l[jss::reserve_inc_xrp] = lpClosed->fees().increment.decimalXRP();
+
2753
+
2754 if (auto const closeOffset = app_.timeKeeper().closeOffset();
+
2755 std::abs(closeOffset.count()) >= 60)
+
2756 l[jss::close_time_offset] =
+
2757 static_cast<std::uint32_t>(closeOffset.count());
+
2758
+
2759 constexpr std::chrono::seconds highAgeThreshold{1000000};
+
2760 if (m_ledgerMaster.haveValidated())
+
2761 {
+
2762 auto const age = m_ledgerMaster.getValidatedLedgerAge();
+
2763 l[jss::age] =
+
2764 Json::UInt(age < highAgeThreshold ? age.count() : 0);
+
2765 }
+
2766 else
+
2767 {
+
2768 auto lCloseTime = lpClosed->info().closeTime;
+
2769 auto closeTime = app_.timeKeeper().closeTime();
+
2770 if (lCloseTime <= closeTime)
+
2771 {
+
2772 using namespace std::chrono_literals;
+
2773 auto age = closeTime - lCloseTime;
+
2774 l[jss::age] =
+
2775 Json::UInt(age < highAgeThreshold ? age.count() : 0);
+
2776 }
+
2777 }
+
2778 }
+
2779
+
2780 if (valid)
+
2781 info[jss::validated_ledger] = l;
+
2782 else
+
2783 info[jss::closed_ledger] = l;
+
2784
+
2785 auto lpPublished = m_ledgerMaster.getPublishedLedger();
+
2786 if (!lpPublished)
+
2787 info[jss::published_ledger] = "none";
+
2788 else if (lpPublished->info().seq != lpClosed->info().seq)
+
2789 info[jss::published_ledger] = lpPublished->info().seq;
+
2790 }
+
2791
+
2792 accounting_.json(info);
+
2793 info[jss::uptime] = UptimeClock::now().time_since_epoch().count();
+
2794 info[jss::jq_trans_overflow] =
+
2795 std::to_string(app_.overlay().getJqTransOverflow());
+
2796 info[jss::peer_disconnects] =
+
2797 std::to_string(app_.overlay().getPeerDisconnect());
+
2798 info[jss::peer_disconnects_resources] =
+
2799 std::to_string(app_.overlay().getPeerDisconnectCharges());
+
2800
+
2801 // This array must be sorted in increasing order.
+
2802 static constexpr std::array<std::string_view, 7> protocols{
+
2803 "http", "https", "peer", "ws", "ws2", "wss", "wss2"};
+
2804 static_assert(std::is_sorted(std::begin(protocols), std::end(protocols)));
+
2805 {
+
2806 Json::Value ports{Json::arrayValue};
+
2807 for (auto const& port : app_.getServerHandler().setup().ports)
+
2808 {
+
2809 // Don't publish admin ports for non-admin users
+
2810 if (!admin &&
+
2811 !(port.admin_nets_v4.empty() && port.admin_nets_v6.empty() &&
+
2812 port.admin_user.empty() && port.admin_password.empty()))
+
2813 continue;
+
2814 std::vector<std::string> proto;
+
2815 std::set_intersection(
+
2816 std::begin(port.protocol),
+
2817 std::end(port.protocol),
+
2818 std::begin(protocols),
+
2819 std::end(protocols),
+
2820 std::back_inserter(proto));
+
2821 if (!proto.empty())
+
2822 {
+
2823 auto& jv = ports.append(Json::Value(Json::objectValue));
+
2824 jv[jss::port] = std::to_string(port.port);
+
2825 jv[jss::protocol] = Json::Value{Json::arrayValue};
+
2826 for (auto const& p : proto)
+
2827 jv[jss::protocol].append(p);
+
2828 }
+
2829 }
+
2830
+
2831 if (app_.config().exists(SECTION_PORT_GRPC))
+
2832 {
+
2833 auto const& grpcSection = app_.config().section(SECTION_PORT_GRPC);
+
2834 auto const optPort = grpcSection.get("port");
+
2835 if (optPort && grpcSection.get("ip"))
+
2836 {
+
2837 auto& jv = ports.append(Json::Value(Json::objectValue));
+
2838 jv[jss::port] = *optPort;
+
2839 jv[jss::protocol] = Json::Value{Json::arrayValue};
+
2840 jv[jss::protocol].append("grpc");
+
2841 }
+
2842 }
+
2843 info[jss::ports] = std::move(ports);
+
2844 }
2845
-
2846 auto it = mStreamMaps[sRTTransactions].begin();
-
2847 while (it != mStreamMaps[sRTTransactions].end())
-
2848 {
-
2849 InfoSub::pointer p = it->second.lock();
-
2850
-
2851 if (p)
-
2852 {
-
2853 jvObj.visit(
-
2854 p->getApiVersion(), //
-
2855 [&](Json::Value const& jv) { p->send(jv, true); });
-
2856 ++it;
-
2857 }
-
2858 else
-
2859 {
-
2860 it = mStreamMaps[sRTTransactions].erase(it);
-
2861 }
-
2862 }
-
2863 }
-
2864
-
2865 pubProposedAccountTransaction(ledger, transaction, result);
-
2866}
-
2867
-
2868void
-
2869NetworkOPsImp::pubLedger(std::shared_ptr<ReadView const> const& lpAccepted)
-
2870{
-
2871 // Ledgers are published only when they acquire sufficient validations
-
2872 // Holes are filled across connection loss or other catastrophe
-
2873
-
2874 std::shared_ptr<AcceptedLedger> alpAccepted =
-
2875 app_.getAcceptedLedgerCache().fetch(lpAccepted->info().hash);
-
2876 if (!alpAccepted)
-
2877 {
-
2878 alpAccepted = std::make_shared<AcceptedLedger>(lpAccepted, app_);
-
2879 app_.getAcceptedLedgerCache().canonicalize_replace_client(
-
2880 lpAccepted->info().hash, alpAccepted);
-
2881 }
-
2882
-
2883 XRPL_ASSERT(
-
2884 alpAccepted->getLedger().get() == lpAccepted.get(),
-
2885 "ripple::NetworkOPsImp::pubLedger : accepted input");
-
2886
-
2887 {
-
2888 JLOG(m_journal.debug())
-
2889 << "Publishing ledger " << lpAccepted->info().seq << " "
-
2890 << lpAccepted->info().hash;
+
2846 return info;
+
2847}
+
2848
+
2849void
+
2850NetworkOPsImp::clearLedgerFetch()
+
2851{
+
2852 app_.getInboundLedgers().clearFailures();
+
2853}
+
2854
+
2855Json::Value
+
2856NetworkOPsImp::getLedgerFetchInfo()
+
2857{
+
2858 return app_.getInboundLedgers().getInfo();
+
2859}
+
2860
+
2861void
+
2862NetworkOPsImp::pubProposedTransaction(
+
2863 std::shared_ptr<ReadView const> const& ledger,
+
2864 std::shared_ptr<STTx const> const& transaction,
+
2865 TER result)
+
2866{
+
2867 MultiApiJson jvObj =
+
2868 transJson(transaction, result, false, ledger, std::nullopt);
+
2869
+
2870 {
+
2871 std::lock_guard sl(mSubLock);
+
2872
+
2873 auto it = mStreamMaps[sRTTransactions].begin();
+
2874 while (it != mStreamMaps[sRTTransactions].end())
+
2875 {
+
2876 InfoSub::pointer p = it->second.lock();
+
2877
+
2878 if (p)
+
2879 {
+
2880 jvObj.visit(
+
2881 p->getApiVersion(), //
+
2882 [&](Json::Value const& jv) { p->send(jv, true); });
+
2883 ++it;
+
2884 }
+
2885 else
+
2886 {
+
2887 it = mStreamMaps[sRTTransactions].erase(it);
+
2888 }
+
2889 }
+
2890 }
2891
-
2892 std::lock_guard sl(mSubLock);
-
2893
-
2894 if (!mStreamMaps[sLedger].empty())
-
2895 {
-
2896 Json::Value jvObj(Json::objectValue);
-
2897
-
2898 jvObj[jss::type] = "ledgerClosed";
-
2899 jvObj[jss::ledger_index] = lpAccepted->info().seq;
-
2900 jvObj[jss::ledger_hash] = to_string(lpAccepted->info().hash);
-
2901 jvObj[jss::ledger_time] = Json::Value::UInt(
-
2902 lpAccepted->info().closeTime.time_since_epoch().count());
-
2903
-
2904 if (!lpAccepted->rules().enabled(featureXRPFees))
-
2905 jvObj[jss::fee_ref] = Config::FEE_UNITS_DEPRECATED;
-
2906 jvObj[jss::fee_base] = lpAccepted->fees().base.jsonClipped();
-
2907 jvObj[jss::reserve_base] =
-
2908 lpAccepted->fees().accountReserve(0).jsonClipped();
-
2909 jvObj[jss::reserve_inc] =
-
2910 lpAccepted->fees().increment.jsonClipped();
-
2911
-
2912 jvObj[jss::txn_count] = Json::UInt(alpAccepted->size());
+
2892 pubProposedAccountTransaction(ledger, transaction, result);
+
2893}
+
2894
+
2895void
+
2896NetworkOPsImp::pubLedger(std::shared_ptr<ReadView const> const& lpAccepted)
+
2897{
+
2898 // Ledgers are published only when they acquire sufficient validations
+
2899 // Holes are filled across connection loss or other catastrophe
+
2900
+
2901 std::shared_ptr<AcceptedLedger> alpAccepted =
+
2902 app_.getAcceptedLedgerCache().fetch(lpAccepted->info().hash);
+
2903 if (!alpAccepted)
+
2904 {
+
2905 alpAccepted = std::make_shared<AcceptedLedger>(lpAccepted, app_);
+
2906 app_.getAcceptedLedgerCache().canonicalize_replace_client(
+
2907 lpAccepted->info().hash, alpAccepted);
+
2908 }
+
2909
+
2910 XRPL_ASSERT(
+
2911 alpAccepted->getLedger().get() == lpAccepted.get(),
+
2912 "ripple::NetworkOPsImp::pubLedger : accepted input");
2913
-
2914 if (mMode >= OperatingMode::SYNCING)
-
2915 {
-
2916 jvObj[jss::validated_ledgers] =
-
2917 app_.getLedgerMaster().getCompleteLedgers();
-
2918 }
-
2919
-
2920 auto it = mStreamMaps[sLedger].begin();
-
2921 while (it != mStreamMaps[sLedger].end())
-
2922 {
-
2923 InfoSub::pointer p = it->second.lock();
-
2924 if (p)
-
2925 {
-
2926 p->send(jvObj, true);
-
2927 ++it;
-
2928 }
-
2929 else
-
2930 it = mStreamMaps[sLedger].erase(it);
-
2931 }
-
2932 }
-
2933
-
2934 if (!mStreamMaps[sBookChanges].empty())
-
2935 {
-
2936 Json::Value jvObj = ripple::RPC::computeBookChanges(lpAccepted);
-
2937
-
2938 auto it = mStreamMaps[sBookChanges].begin();
-
2939 while (it != mStreamMaps[sBookChanges].end())
-
2940 {
-
2941 InfoSub::pointer p = it->second.lock();
-
2942 if (p)
-
2943 {
-
2944 p->send(jvObj, true);
-
2945 ++it;
-
2946 }
-
2947 else
-
2948 it = mStreamMaps[sBookChanges].erase(it);
-
2949 }
-
2950 }
-
2951
-
2952 {
-
2953 static bool firstTime = true;
-
2954 if (firstTime)
-
2955 {
-
2956 // First validated ledger, start delayed SubAccountHistory
-
2957 firstTime = false;
-
2958 for (auto& outer : mSubAccountHistory)
-
2959 {
-
2960 for (auto& inner : outer.second)
-
2961 {
-
2962 auto& subInfo = inner.second;
-
2963 if (subInfo.index_->separationLedgerSeq_ == 0)
-
2964 {
-
2965 subAccountHistoryStart(
-
2966 alpAccepted->getLedger(), subInfo);
-
2967 }
-
2968 }
-
2969 }
-
2970 }
-
2971 }
-
2972 }
-
2973
-
2974 // Don't lock since pubAcceptedTransaction is locking.
-
2975 for (auto const& accTx : *alpAccepted)
-
2976 {
-
2977 JLOG(m_journal.trace()) << "pubAccepted: " << accTx->getJson();
-
2978 pubValidatedTransaction(
-
2979 lpAccepted, *accTx, accTx == *(--alpAccepted->end()));
-
2980 }
-
2981}
-
2982
-
2983void
-
2984NetworkOPsImp::reportFeeChange()
-
2985{
-
2986 ServerFeeSummary f{
-
2987 app_.openLedger().current()->fees().base,
-
2988 app_.getTxQ().getMetrics(*app_.openLedger().current()),
-
2989 app_.getFeeTrack()};
-
2990
-
2991 // only schedule the job if something has changed
-
2992 if (f != mLastFeeSummary)
-
2993 {
-
2994 m_job_queue.addJob(
-
2995 jtCLIENT_FEE_CHANGE, "reportFeeChange->pubServer", [this]() {
-
2996 pubServer();
-
2997 });
-
2998 }
-
2999}
+
2914 {
+
2915 JLOG(m_journal.debug())
+
2916 << "Publishing ledger " << lpAccepted->info().seq << " "
+
2917 << lpAccepted->info().hash;
+
2918
+
2919 std::lock_guard sl(mSubLock);
+
2920
+
2921 if (!mStreamMaps[sLedger].empty())
+
2922 {
+
2923 Json::Value jvObj(Json::objectValue);
+
2924
+
2925 jvObj[jss::type] = "ledgerClosed";
+
2926 jvObj[jss::ledger_index] = lpAccepted->info().seq;
+
2927 jvObj[jss::ledger_hash] = to_string(lpAccepted->info().hash);
+
2928 jvObj[jss::ledger_time] = Json::Value::UInt(
+
2929 lpAccepted->info().closeTime.time_since_epoch().count());
+
2930
+
2931 if (!lpAccepted->rules().enabled(featureXRPFees))
+
2932 jvObj[jss::fee_ref] = Config::FEE_UNITS_DEPRECATED;
+
2933 jvObj[jss::fee_base] = lpAccepted->fees().base.jsonClipped();
+
2934 jvObj[jss::reserve_base] =
+
2935 lpAccepted->fees().accountReserve(0).jsonClipped();
+
2936 jvObj[jss::reserve_inc] =
+
2937 lpAccepted->fees().increment.jsonClipped();
+
2938
+
2939 jvObj[jss::txn_count] = Json::UInt(alpAccepted->size());
+
2940
+
2941 if (mMode >= OperatingMode::SYNCING)
+
2942 {
+
2943 jvObj[jss::validated_ledgers] =
+
2944 app_.getLedgerMaster().getCompleteLedgers();
+
2945 }
+
2946
+
2947 auto it = mStreamMaps[sLedger].begin();
+
2948 while (it != mStreamMaps[sLedger].end())
+
2949 {
+
2950 InfoSub::pointer p = it->second.lock();
+
2951 if (p)
+
2952 {
+
2953 p->send(jvObj, true);
+
2954 ++it;
+
2955 }
+
2956 else
+
2957 it = mStreamMaps[sLedger].erase(it);
+
2958 }
+
2959 }
+
2960
+
2961 if (!mStreamMaps[sBookChanges].empty())
+
2962 {
+
2963 Json::Value jvObj = ripple::RPC::computeBookChanges(lpAccepted);
+
2964
+
2965 auto it = mStreamMaps[sBookChanges].begin();
+
2966 while (it != mStreamMaps[sBookChanges].end())
+
2967 {
+
2968 InfoSub::pointer p = it->second.lock();
+
2969 if (p)
+
2970 {
+
2971 p->send(jvObj, true);
+
2972 ++it;
+
2973 }
+
2974 else
+
2975 it = mStreamMaps[sBookChanges].erase(it);
+
2976 }
+
2977 }
+
2978
+
2979 {
+
2980 static bool firstTime = true;
+
2981 if (firstTime)
+
2982 {
+
2983 // First validated ledger, start delayed SubAccountHistory
+
2984 firstTime = false;
+
2985 for (auto& outer : mSubAccountHistory)
+
2986 {
+
2987 for (auto& inner : outer.second)
+
2988 {
+
2989 auto& subInfo = inner.second;
+
2990 if (subInfo.index_->separationLedgerSeq_ == 0)
+
2991 {
+
2992 subAccountHistoryStart(
+
2993 alpAccepted->getLedger(), subInfo);
+
2994 }
+
2995 }
+
2996 }
+
2997 }
+
2998 }
+
2999 }
3000
-
3001void
-
3002NetworkOPsImp::reportConsensusStateChange(ConsensusPhase phase)
-
3003{
-
3004 m_job_queue.addJob(
-
3005 jtCLIENT_CONSENSUS,
-
3006 "reportConsensusStateChange->pubConsensus",
-
3007 [this, phase]() { pubConsensus(phase); });
+
3001 // Don't lock since pubAcceptedTransaction is locking.
+
3002 for (auto const& accTx : *alpAccepted)
+
3003 {
+
3004 JLOG(m_journal.trace()) << "pubAccepted: " << accTx->getJson();
+
3005 pubValidatedTransaction(
+
3006 lpAccepted, *accTx, accTx == *(--alpAccepted->end()));
+
3007 }
3008}
3009
-
3010inline void
-
3011NetworkOPsImp::updateLocalTx(ReadView const& view)
+
3010void
+
3011NetworkOPsImp::reportFeeChange()
3012{
-
3013 m_localTX->sweep(view);
-
3014}
-
3015inline std::size_t
-
3016NetworkOPsImp::getLocalTxCount()
-
3017{
-
3018 return m_localTX->size();
-
3019}
-
3020
-
3021// This routine should only be used to publish accepted or validated
-
3022// transactions.
-
3023MultiApiJson
-
3024NetworkOPsImp::transJson(
-
3025 std::shared_ptr<STTx const> const& transaction,
-
3026 TER result,
-
3027 bool validated,
-
3028 std::shared_ptr<ReadView const> const& ledger,
-
3029 std::optional<std::reference_wrapper<TxMeta const>> meta)
+
3013 ServerFeeSummary f{
+
3014 app_.openLedger().current()->fees().base,
+
3015 app_.getTxQ().getMetrics(*app_.openLedger().current()),
+
3016 app_.getFeeTrack()};
+
3017
+
3018 // only schedule the job if something has changed
+
3019 if (f != mLastFeeSummary)
+
3020 {
+
3021 m_job_queue.addJob(
+
3022 jtCLIENT_FEE_CHANGE, "reportFeeChange->pubServer", [this]() {
+
3023 pubServer();
+
3024 });
+
3025 }
+
3026}
+
3027
+
3028void
+
3029NetworkOPsImp::reportConsensusStateChange(ConsensusPhase phase)
3030{
-
3031 Json::Value jvObj(Json::objectValue);
-
3032 std::string sToken;
-
3033 std::string sHuman;
-
3034
-
3035 transResultInfo(result, sToken, sHuman);
+
3031 m_job_queue.addJob(
+
3032 jtCLIENT_CONSENSUS,
+
3033 "reportConsensusStateChange->pubConsensus",
+
3034 [this, phase]() { pubConsensus(phase); });
+
3035}
3036
-
3037 jvObj[jss::type] = "transaction";
-
3038 // NOTE jvObj is not a finished object for either API version. After
-
3039 // it's populated, we need to finish it for a specific API version. This is
-
3040 // done in a loop, near the end of this function.
-
3041 jvObj[jss::transaction] =
-
3042 transaction->getJson(JsonOptions::disable_API_prior_V2, false);
-
3043
-
3044 if (meta)
-
3045 {
-
3046 jvObj[jss::meta] = meta->get().getJson(JsonOptions::none);
-
3047 RPC::insertDeliveredAmount(
-
3048 jvObj[jss::meta], *ledger, transaction, meta->get());
-
3049 RPC::insertMPTokenIssuanceID(
-
3050 jvObj[jss::meta], transaction, meta->get());
-
3051 }
-
3052
-
3053 if (!ledger->open())
-
3054 jvObj[jss::ledger_hash] = to_string(ledger->info().hash);
-
3055
-
3056 if (validated)
-
3057 {
-
3058 jvObj[jss::ledger_index] = ledger->info().seq;
-
3059 jvObj[jss::transaction][jss::date] =
-
3060 ledger->info().closeTime.time_since_epoch().count();
-
3061 jvObj[jss::validated] = true;
-
3062 jvObj[jss::close_time_iso] = to_string_iso(ledger->info().closeTime);
+
3037inline void
+
3038NetworkOPsImp::updateLocalTx(ReadView const& view)
+
3039{
+
3040 m_localTX->sweep(view);
+
3041}
+
3042inline std::size_t
+
3043NetworkOPsImp::getLocalTxCount()
+
3044{
+
3045 return m_localTX->size();
+
3046}
+
3047
+
3048// This routine should only be used to publish accepted or validated
+
3049// transactions.
+
3050MultiApiJson
+
3051NetworkOPsImp::transJson(
+
3052 std::shared_ptr<STTx const> const& transaction,
+
3053 TER result,
+
3054 bool validated,
+
3055 std::shared_ptr<ReadView const> const& ledger,
+
3056 std::optional<std::reference_wrapper<TxMeta const>> meta)
+
3057{
+
3058 Json::Value jvObj(Json::objectValue);
+
3059 std::string sToken;
+
3060 std::string sHuman;
+
3061
+
3062 transResultInfo(result, sToken, sHuman);
3063
-
3064 // WRITEME: Put the account next seq here
-
3065 }
-
3066 else
-
3067 {
-
3068 jvObj[jss::validated] = false;
-
3069 jvObj[jss::ledger_current_index] = ledger->info().seq;
-
3070 }
-
3071
-
3072 jvObj[jss::status] = validated ? "closed" : "proposed";
-
3073 jvObj[jss::engine_result] = sToken;
-
3074 jvObj[jss::engine_result_code] = result;
-
3075 jvObj[jss::engine_result_message] = sHuman;
-
3076
-
3077 if (transaction->getTxnType() == ttOFFER_CREATE)
-
3078 {
-
3079 auto const account = transaction->getAccountID(sfAccount);
-
3080 auto const amount = transaction->getFieldAmount(sfTakerGets);
-
3081
-
3082 // If the offer create is not self funded then add the owner balance
-
3083 if (account != amount.issue().account)
-
3084 {
-
3085 auto const ownerFunds = accountFunds(
-
3086 *ledger,
-
3087 account,
-
3088 amount,
-
3089 fhIGNORE_FREEZE,
-
3090 app_.journal("View"));
-
3091 jvObj[jss::transaction][jss::owner_funds] = ownerFunds.getText();
-
3092 }
-
3093 }
-
3094
-
3095 std::string const hash = to_string(transaction->getTransactionID());
-
3096 MultiApiJson multiObj{jvObj};
-
3097 forAllApiVersions(
-
3098 multiObj.visit(), //
-
3099 [&]<unsigned Version>(
-
3100 Json::Value& jvTx, std::integral_constant<unsigned, Version>) {
-
3101 RPC::insertDeliverMax(
-
3102 jvTx[jss::transaction], transaction->getTxnType(), Version);
+
3064 jvObj[jss::type] = "transaction";
+
3065 // NOTE jvObj is not a finished object for either API version. After
+
3066 // it's populated, we need to finish it for a specific API version. This is
+
3067 // done in a loop, near the end of this function.
+
3068 jvObj[jss::transaction] =
+
3069 transaction->getJson(JsonOptions::disable_API_prior_V2, false);
+
3070
+
3071 if (meta)
+
3072 {
+
3073 jvObj[jss::meta] = meta->get().getJson(JsonOptions::none);
+
3074 RPC::insertDeliveredAmount(
+
3075 jvObj[jss::meta], *ledger, transaction, meta->get());
+
3076 RPC::insertMPTokenIssuanceID(
+
3077 jvObj[jss::meta], transaction, meta->get());
+
3078 }
+
3079
+
3080 if (!ledger->open())
+
3081 jvObj[jss::ledger_hash] = to_string(ledger->info().hash);
+
3082
+
3083 if (validated)
+
3084 {
+
3085 jvObj[jss::ledger_index] = ledger->info().seq;
+
3086 jvObj[jss::transaction][jss::date] =
+
3087 ledger->info().closeTime.time_since_epoch().count();
+
3088 jvObj[jss::validated] = true;
+
3089 jvObj[jss::close_time_iso] = to_string_iso(ledger->info().closeTime);
+
3090
+
3091 // WRITEME: Put the account next seq here
+
3092 }
+
3093 else
+
3094 {
+
3095 jvObj[jss::validated] = false;
+
3096 jvObj[jss::ledger_current_index] = ledger->info().seq;
+
3097 }
+
3098
+
3099 jvObj[jss::status] = validated ? "closed" : "proposed";
+
3100 jvObj[jss::engine_result] = sToken;
+
3101 jvObj[jss::engine_result_code] = result;
+
3102 jvObj[jss::engine_result_message] = sHuman;
3103
-
3104 if constexpr (Version > 1)
-
3105 {
-
3106 jvTx[jss::tx_json] = jvTx.removeMember(jss::transaction);
-
3107 jvTx[jss::hash] = hash;
-
3108 }
-
3109 else
-
3110 {
-
3111 jvTx[jss::transaction][jss::hash] = hash;
-
3112 }
-
3113 });
-
3114
-
3115 return multiObj;
-
3116}
-
3117
-
3118void
-
3119NetworkOPsImp::pubValidatedTransaction(
-
3120 std::shared_ptr<ReadView const> const& ledger,
-
3121 const AcceptedLedgerTx& transaction,
-
3122 bool last)
-
3123{
-
3124 auto const& stTxn = transaction.getTxn();
-
3125
-
3126 // Create two different Json objects, for different API versions
-
3127 auto const metaRef = std::ref(transaction.getMeta());
-
3128 auto const trResult = transaction.getResult();
-
3129 MultiApiJson jvObj = transJson(stTxn, trResult, true, ledger, metaRef);
+
3104 if (transaction->getTxnType() == ttOFFER_CREATE)
+
3105 {
+
3106 auto const account = transaction->getAccountID(sfAccount);
+
3107 auto const amount = transaction->getFieldAmount(sfTakerGets);
+
3108
+
3109 // If the offer create is not self funded then add the owner balance
+
3110 if (account != amount.issue().account)
+
3111 {
+
3112 auto const ownerFunds = accountFunds(
+
3113 *ledger,
+
3114 account,
+
3115 amount,
+
3116 fhIGNORE_FREEZE,
+
3117 app_.journal("View"));
+
3118 jvObj[jss::transaction][jss::owner_funds] = ownerFunds.getText();
+
3119 }
+
3120 }
+
3121
+
3122 std::string const hash = to_string(transaction->getTransactionID());
+
3123 MultiApiJson multiObj{jvObj};
+
3124 forAllApiVersions(
+
3125 multiObj.visit(), //
+
3126 [&]<unsigned Version>(
+
3127 Json::Value& jvTx, std::integral_constant<unsigned, Version>) {
+
3128 RPC::insertDeliverMax(
+
3129 jvTx[jss::transaction], transaction->getTxnType(), Version);
3130
-
3131 {
-
3132 std::lock_guard sl(mSubLock);
-
3133
-
3134 auto it = mStreamMaps[sTransactions].begin();
-
3135 while (it != mStreamMaps[sTransactions].end())
-
3136 {
-
3137 InfoSub::pointer p = it->second.lock();
-
3138
-
3139 if (p)
-
3140 {
-
3141 jvObj.visit(
-
3142 p->getApiVersion(), //
-
3143 [&](Json::Value const& jv) { p->send(jv, true); });
-
3144 ++it;
-
3145 }
-
3146 else
-
3147 it = mStreamMaps[sTransactions].erase(it);
-
3148 }
-
3149
-
3150 it = mStreamMaps[sRTTransactions].begin();
-
3151
-
3152 while (it != mStreamMaps[sRTTransactions].end())
-
3153 {
-
3154 InfoSub::pointer p = it->second.lock();
-
3155
-
3156 if (p)
-
3157 {
-
3158 jvObj.visit(
-
3159 p->getApiVersion(), //
-
3160 [&](Json::Value const& jv) { p->send(jv, true); });
-
3161 ++it;
-
3162 }
-
3163 else
-
3164 it = mStreamMaps[sRTTransactions].erase(it);
-
3165 }
-
3166 }
-
3167
-
3168 if (transaction.getResult() == tesSUCCESS)
-
3169 app_.getOrderBookDB().processTxn(ledger, transaction, jvObj);
-
3170
-
3171 pubAccountTransaction(ledger, transaction, last);
-
3172}
-
3173
-
3174void
-
3175NetworkOPsImp::pubAccountTransaction(
-
3176 std::shared_ptr<ReadView const> const& ledger,
-
3177 AcceptedLedgerTx const& transaction,
-
3178 bool last)
-
3179{
-
3180 hash_set<InfoSub::pointer> notify;
-
3181 int iProposed = 0;
-
3182 int iAccepted = 0;
-
3183
-
3184 std::vector<SubAccountHistoryInfo> accountHistoryNotify;
-
3185 auto const currLedgerSeq = ledger->seq();
-
3186 {
-
3187 std::lock_guard sl(mSubLock);
-
3188
-
3189 if (!mSubAccount.empty() || !mSubRTAccount.empty() ||
-
3190 !mSubAccountHistory.empty())
-
3191 {
-
3192 for (auto const& affectedAccount : transaction.getAffected())
-
3193 {
-
3194 if (auto simiIt = mSubRTAccount.find(affectedAccount);
-
3195 simiIt != mSubRTAccount.end())
-
3196 {
-
3197 auto it = simiIt->second.begin();
-
3198
-
3199 while (it != simiIt->second.end())
-
3200 {
-
3201 InfoSub::pointer p = it->second.lock();
-
3202
-
3203 if (p)
-
3204 {
-
3205 notify.insert(p);
-
3206 ++it;
-
3207 ++iProposed;
-
3208 }
-
3209 else
-
3210 it = simiIt->second.erase(it);
-
3211 }
-
3212 }
-
3213
-
3214 if (auto simiIt = mSubAccount.find(affectedAccount);
-
3215 simiIt != mSubAccount.end())
-
3216 {
-
3217 auto it = simiIt->second.begin();
-
3218 while (it != simiIt->second.end())
-
3219 {
-
3220 InfoSub::pointer p = it->second.lock();
-
3221
-
3222 if (p)
-
3223 {
-
3224 notify.insert(p);
-
3225 ++it;
-
3226 ++iAccepted;
-
3227 }
-
3228 else
-
3229 it = simiIt->second.erase(it);
-
3230 }
-
3231 }
-
3232
-
3233 if (auto histoIt = mSubAccountHistory.find(affectedAccount);
-
3234 histoIt != mSubAccountHistory.end())
-
3235 {
-
3236 auto& subs = histoIt->second;
-
3237 auto it = subs.begin();
-
3238 while (it != subs.end())
-
3239 {
-
3240 SubAccountHistoryInfoWeak const& info = it->second;
-
3241 if (currLedgerSeq <= info.index_->separationLedgerSeq_)
-
3242 {
-
3243 ++it;
-
3244 continue;
-
3245 }
-
3246
-
3247 if (auto isSptr = info.sinkWptr_.lock(); isSptr)
-
3248 {
-
3249 accountHistoryNotify.emplace_back(
-
3250 SubAccountHistoryInfo{isSptr, info.index_});
-
3251 ++it;
-
3252 }
-
3253 else
-
3254 {
-
3255 it = subs.erase(it);
-
3256 }
+
3131 if constexpr (Version > 1)
+
3132 {
+
3133 jvTx[jss::tx_json] = jvTx.removeMember(jss::transaction);
+
3134 jvTx[jss::hash] = hash;
+
3135 }
+
3136 else
+
3137 {
+
3138 jvTx[jss::transaction][jss::hash] = hash;
+
3139 }
+
3140 });
+
3141
+
3142 return multiObj;
+
3143}
+
3144
+
3145void
+
3146NetworkOPsImp::pubValidatedTransaction(
+
3147 std::shared_ptr<ReadView const> const& ledger,
+
3148 const AcceptedLedgerTx& transaction,
+
3149 bool last)
+
3150{
+
3151 auto const& stTxn = transaction.getTxn();
+
3152
+
3153 // Create two different Json objects, for different API versions
+
3154 auto const metaRef = std::ref(transaction.getMeta());
+
3155 auto const trResult = transaction.getResult();
+
3156 MultiApiJson jvObj = transJson(stTxn, trResult, true, ledger, metaRef);
+
3157
+
3158 {
+
3159 std::lock_guard sl(mSubLock);
+
3160
+
3161 auto it = mStreamMaps[sTransactions].begin();
+
3162 while (it != mStreamMaps[sTransactions].end())
+
3163 {
+
3164 InfoSub::pointer p = it->second.lock();
+
3165
+
3166 if (p)
+
3167 {
+
3168 jvObj.visit(
+
3169 p->getApiVersion(), //
+
3170 [&](Json::Value const& jv) { p->send(jv, true); });
+
3171 ++it;
+
3172 }
+
3173 else
+
3174 it = mStreamMaps[sTransactions].erase(it);
+
3175 }
+
3176
+
3177 it = mStreamMaps[sRTTransactions].begin();
+
3178
+
3179 while (it != mStreamMaps[sRTTransactions].end())
+
3180 {
+
3181 InfoSub::pointer p = it->second.lock();
+
3182
+
3183 if (p)
+
3184 {
+
3185 jvObj.visit(
+
3186 p->getApiVersion(), //
+
3187 [&](Json::Value const& jv) { p->send(jv, true); });
+
3188 ++it;
+
3189 }
+
3190 else
+
3191 it = mStreamMaps[sRTTransactions].erase(it);
+
3192 }
+
3193 }
+
3194
+
3195 if (transaction.getResult() == tesSUCCESS)
+
3196 app_.getOrderBookDB().processTxn(ledger, transaction, jvObj);
+
3197
+
3198 pubAccountTransaction(ledger, transaction, last);
+
3199}
+
3200
+
3201void
+
3202NetworkOPsImp::pubAccountTransaction(
+
3203 std::shared_ptr<ReadView const> const& ledger,
+
3204 AcceptedLedgerTx const& transaction,
+
3205 bool last)
+
3206{
+
3207 hash_set<InfoSub::pointer> notify;
+
3208 int iProposed = 0;
+
3209 int iAccepted = 0;
+
3210
+
3211 std::vector<SubAccountHistoryInfo> accountHistoryNotify;
+
3212 auto const currLedgerSeq = ledger->seq();
+
3213 {
+
3214 std::lock_guard sl(mSubLock);
+
3215
+
3216 if (!mSubAccount.empty() || !mSubRTAccount.empty() ||
+
3217 !mSubAccountHistory.empty())
+
3218 {
+
3219 for (auto const& affectedAccount : transaction.getAffected())
+
3220 {
+
3221 if (auto simiIt = mSubRTAccount.find(affectedAccount);
+
3222 simiIt != mSubRTAccount.end())
+
3223 {
+
3224 auto it = simiIt->second.begin();
+
3225
+
3226 while (it != simiIt->second.end())
+
3227 {
+
3228 InfoSub::pointer p = it->second.lock();
+
3229
+
3230 if (p)
+
3231 {
+
3232 notify.insert(p);
+
3233 ++it;
+
3234 ++iProposed;
+
3235 }
+
3236 else
+
3237 it = simiIt->second.erase(it);
+
3238 }
+
3239 }
+
3240
+
3241 if (auto simiIt = mSubAccount.find(affectedAccount);
+
3242 simiIt != mSubAccount.end())
+
3243 {
+
3244 auto it = simiIt->second.begin();
+
3245 while (it != simiIt->second.end())
+
3246 {
+
3247 InfoSub::pointer p = it->second.lock();
+
3248
+
3249 if (p)
+
3250 {
+
3251 notify.insert(p);
+
3252 ++it;
+
3253 ++iAccepted;
+
3254 }
+
3255 else
+
3256 it = simiIt->second.erase(it);
3257 }
-
3258 if (subs.empty())
-
3259 mSubAccountHistory.erase(histoIt);
-
3260 }
-
3261 }
-
3262 }
-
3263 }
-
3264
-
3265 JLOG(m_journal.trace())
-
3266 << "pubAccountTransaction: " << "proposed=" << iProposed
-
3267 << ", accepted=" << iAccepted;
-
3268
-
3269 if (!notify.empty() || !accountHistoryNotify.empty())
-
3270 {
-
3271 auto const& stTxn = transaction.getTxn();
-
3272
-
3273 // Create two different Json objects, for different API versions
-
3274 auto const metaRef = std::ref(transaction.getMeta());
-
3275 auto const trResult = transaction.getResult();
-
3276 MultiApiJson jvObj = transJson(stTxn, trResult, true, ledger, metaRef);
-
3277
-
3278 for (InfoSub::ref isrListener : notify)
-
3279 {
-
3280 jvObj.visit(
-
3281 isrListener->getApiVersion(), //
-
3282 [&](Json::Value const& jv) { isrListener->send(jv, true); });
-
3283 }
-
3284
-
3285 if (last)
-
3286 jvObj.set(jss::account_history_boundary, true);
-
3287
-
3288 XRPL_ASSERT(
-
3289 jvObj.isMember(jss::account_history_tx_stream) ==
-
3290 MultiApiJson::none,
-
3291 "ripple::NetworkOPsImp::pubAccountTransaction : "
-
3292 "account_history_tx_stream not set");
-
3293 for (auto& info : accountHistoryNotify)
-
3294 {
-
3295 auto& index = info.index_;
-
3296 if (index->forwardTxIndex_ == 0 && !index->haveHistorical_)
-
3297 jvObj.set(jss::account_history_tx_first, true);
-
3298
-
3299 jvObj.set(jss::account_history_tx_index, index->forwardTxIndex_++);
-
3300
-
3301 jvObj.visit(
-
3302 info.sink_->getApiVersion(), //
-
3303 [&](Json::Value const& jv) { info.sink_->send(jv, true); });
-
3304 }
-
3305 }
-
3306}
-
3307
-
3308void
-
3309NetworkOPsImp::pubProposedAccountTransaction(
-
3310 std::shared_ptr<ReadView const> const& ledger,
-
3311 std::shared_ptr<STTx const> const& tx,
-
3312 TER result)
-
3313{
-
3314 hash_set<InfoSub::pointer> notify;
-
3315 int iProposed = 0;
-
3316
-
3317 std::vector<SubAccountHistoryInfo> accountHistoryNotify;
-
3318
-
3319 {
-
3320 std::lock_guard sl(mSubLock);
-
3321
-
3322 if (mSubRTAccount.empty())
-
3323 return;
-
3324
-
3325 if (!mSubAccount.empty() || !mSubRTAccount.empty() ||
-
3326 !mSubAccountHistory.empty())
-
3327 {
-
3328 for (auto const& affectedAccount : tx->getMentionedAccounts())
-
3329 {
-
3330 if (auto simiIt = mSubRTAccount.find(affectedAccount);
-
3331 simiIt != mSubRTAccount.end())
-
3332 {
-
3333 auto it = simiIt->second.begin();
+
3258 }
+
3259
+
3260 if (auto histoIt = mSubAccountHistory.find(affectedAccount);
+
3261 histoIt != mSubAccountHistory.end())
+
3262 {
+
3263 auto& subs = histoIt->second;
+
3264 auto it = subs.begin();
+
3265 while (it != subs.end())
+
3266 {
+
3267 SubAccountHistoryInfoWeak const& info = it->second;
+
3268 if (currLedgerSeq <= info.index_->separationLedgerSeq_)
+
3269 {
+
3270 ++it;
+
3271 continue;
+
3272 }
+
3273
+
3274 if (auto isSptr = info.sinkWptr_.lock(); isSptr)
+
3275 {
+
3276 accountHistoryNotify.emplace_back(
+
3277 SubAccountHistoryInfo{isSptr, info.index_});
+
3278 ++it;
+
3279 }
+
3280 else
+
3281 {
+
3282 it = subs.erase(it);
+
3283 }
+
3284 }
+
3285 if (subs.empty())
+
3286 mSubAccountHistory.erase(histoIt);
+
3287 }
+
3288 }
+
3289 }
+
3290 }
+
3291
+
3292 JLOG(m_journal.trace())
+
3293 << "pubAccountTransaction: " << "proposed=" << iProposed
+
3294 << ", accepted=" << iAccepted;
+
3295
+
3296 if (!notify.empty() || !accountHistoryNotify.empty())
+
3297 {
+
3298 auto const& stTxn = transaction.getTxn();
+
3299
+
3300 // Create two different Json objects, for different API versions
+
3301 auto const metaRef = std::ref(transaction.getMeta());
+
3302 auto const trResult = transaction.getResult();
+
3303 MultiApiJson jvObj = transJson(stTxn, trResult, true, ledger, metaRef);
+
3304
+
3305 for (InfoSub::ref isrListener : notify)
+
3306 {
+
3307 jvObj.visit(
+
3308 isrListener->getApiVersion(), //
+
3309 [&](Json::Value const& jv) { isrListener->send(jv, true); });
+
3310 }
+
3311
+
3312 if (last)
+
3313 jvObj.set(jss::account_history_boundary, true);
+
3314
+
3315 XRPL_ASSERT(
+
3316 jvObj.isMember(jss::account_history_tx_stream) ==
+
3317 MultiApiJson::none,
+
3318 "ripple::NetworkOPsImp::pubAccountTransaction : "
+
3319 "account_history_tx_stream not set");
+
3320 for (auto& info : accountHistoryNotify)
+
3321 {
+
3322 auto& index = info.index_;
+
3323 if (index->forwardTxIndex_ == 0 && !index->haveHistorical_)
+
3324 jvObj.set(jss::account_history_tx_first, true);
+
3325
+
3326 jvObj.set(jss::account_history_tx_index, index->forwardTxIndex_++);
+
3327
+
3328 jvObj.visit(
+
3329 info.sink_->getApiVersion(), //
+
3330 [&](Json::Value const& jv) { info.sink_->send(jv, true); });
+
3331 }
+
3332 }
+
3333}
3334
-
3335 while (it != simiIt->second.end())
-
3336 {
-
3337 InfoSub::pointer p = it->second.lock();
-
3338
-
3339 if (p)
-
3340 {
-
3341 notify.insert(p);
-
3342 ++it;
-
3343 ++iProposed;
-
3344 }
-
3345 else
-
3346 it = simiIt->second.erase(it);
-
3347 }
-
3348 }
-
3349 }
-
3350 }
-
3351 }
-
3352
-
3353 JLOG(m_journal.trace()) << "pubProposedAccountTransaction: " << iProposed;
-
3354
-
3355 if (!notify.empty() || !accountHistoryNotify.empty())
-
3356 {
-
3357 // Create two different Json objects, for different API versions
-
3358 MultiApiJson jvObj = transJson(tx, result, false, ledger, std::nullopt);
-
3359
-
3360 for (InfoSub::ref isrListener : notify)
-
3361 jvObj.visit(
-
3362 isrListener->getApiVersion(), //
-
3363 [&](Json::Value const& jv) { isrListener->send(jv, true); });
-
3364
-
3365 XRPL_ASSERT(
-
3366 jvObj.isMember(jss::account_history_tx_stream) ==
-
3367 MultiApiJson::none,
-
3368 "ripple::NetworkOPs::pubProposedAccountTransaction : "
-
3369 "account_history_tx_stream not set");
-
3370 for (auto& info : accountHistoryNotify)
-
3371 {
-
3372 auto& index = info.index_;
-
3373 if (index->forwardTxIndex_ == 0 && !index->haveHistorical_)
-
3374 jvObj.set(jss::account_history_tx_first, true);
-
3375 jvObj.set(jss::account_history_tx_index, index->forwardTxIndex_++);
-
3376 jvObj.visit(
-
3377 info.sink_->getApiVersion(), //
-
3378 [&](Json::Value const& jv) { info.sink_->send(jv, true); });
-
3379 }
-
3380 }
-
3381}
-
3382
-
3383//
-
3384// Monitoring
-
3385//
+
3335void
+
3336NetworkOPsImp::pubProposedAccountTransaction(
+
3337 std::shared_ptr<ReadView const> const& ledger,
+
3338 std::shared_ptr<STTx const> const& tx,
+
3339 TER result)
+
3340{
+
3341 hash_set<InfoSub::pointer> notify;
+
3342 int iProposed = 0;
+
3343
+
3344 std::vector<SubAccountHistoryInfo> accountHistoryNotify;
+
3345
+
3346 {
+
3347 std::lock_guard sl(mSubLock);
+
3348
+
3349 if (mSubRTAccount.empty())
+
3350 return;
+
3351
+
3352 if (!mSubAccount.empty() || !mSubRTAccount.empty() ||
+
3353 !mSubAccountHistory.empty())
+
3354 {
+
3355 for (auto const& affectedAccount : tx->getMentionedAccounts())
+
3356 {
+
3357 if (auto simiIt = mSubRTAccount.find(affectedAccount);
+
3358 simiIt != mSubRTAccount.end())
+
3359 {
+
3360 auto it = simiIt->second.begin();
+
3361
+
3362 while (it != simiIt->second.end())
+
3363 {
+
3364 InfoSub::pointer p = it->second.lock();
+
3365
+
3366 if (p)
+
3367 {
+
3368 notify.insert(p);
+
3369 ++it;
+
3370 ++iProposed;
+
3371 }
+
3372 else
+
3373 it = simiIt->second.erase(it);
+
3374 }
+
3375 }
+
3376 }
+
3377 }
+
3378 }
+
3379
+
3380 JLOG(m_journal.trace()) << "pubProposedAccountTransaction: " << iProposed;
+
3381
+
3382 if (!notify.empty() || !accountHistoryNotify.empty())
+
3383 {
+
3384 // Create two different Json objects, for different API versions
+
3385 MultiApiJson jvObj = transJson(tx, result, false, ledger, std::nullopt);
3386
-
3387void
-
3388NetworkOPsImp::subAccount(
-
3389 InfoSub::ref isrListener,
-
3390 hash_set<AccountID> const& vnaAccountIDs,
-
3391 bool rt)
-
3392{
-
3393 SubInfoMapType& subMap = rt ? mSubRTAccount : mSubAccount;
-
3394
-
3395 for (auto const& naAccountID : vnaAccountIDs)
-
3396 {
-
3397 JLOG(m_journal.trace())
-
3398 << "subAccount: account: " << toBase58(naAccountID);
-
3399
-
3400 isrListener->insertSubAccountInfo(naAccountID, rt);
-
3401 }
-
3402
-
3403 std::lock_guard sl(mSubLock);
-
3404
-
3405 for (auto const& naAccountID : vnaAccountIDs)
-
3406 {
-
3407 auto simIterator = subMap.find(naAccountID);
-
3408 if (simIterator == subMap.end())
-
3409 {
-
3410 // Not found, note that account has a new single listner.
-
3411 SubMapType usisElement;
-
3412 usisElement[isrListener->getSeq()] = isrListener;
-
3413 // VFALCO NOTE This is making a needless copy of naAccountID
-
3414 subMap.insert(simIterator, make_pair(naAccountID, usisElement));
-
3415 }
-
3416 else
-
3417 {
-
3418 // Found, note that the account has another listener.
-
3419 simIterator->second[isrListener->getSeq()] = isrListener;
-
3420 }
-
3421 }
-
3422}
-
3423
-
3424void
-
3425NetworkOPsImp::unsubAccount(
-
3426 InfoSub::ref isrListener,
-
3427 hash_set<AccountID> const& vnaAccountIDs,
-
3428 bool rt)
-
3429{
-
3430 for (auto const& naAccountID : vnaAccountIDs)
-
3431 {
-
3432 // Remove from the InfoSub
-
3433 isrListener->deleteSubAccountInfo(naAccountID, rt);
-
3434 }
-
3435
-
3436 // Remove from the server
-
3437 unsubAccountInternal(isrListener->getSeq(), vnaAccountIDs, rt);
-
3438}
-
3439
-
3440void
-
3441NetworkOPsImp::unsubAccountInternal(
-
3442 std::uint64_t uSeq,
-
3443 hash_set<AccountID> const& vnaAccountIDs,
-
3444 bool rt)
-
3445{
-
3446 std::lock_guard sl(mSubLock);
-
3447
-
3448 SubInfoMapType& subMap = rt ? mSubRTAccount : mSubAccount;
-
3449
-
3450 for (auto const& naAccountID : vnaAccountIDs)
-
3451 {
-
3452 auto simIterator = subMap.find(naAccountID);
-
3453
-
3454 if (simIterator != subMap.end())
-
3455 {
-
3456 // Found
-
3457 simIterator->second.erase(uSeq);
-
3458
-
3459 if (simIterator->second.empty())
-
3460 {
-
3461 // Don't need hash entry.
-
3462 subMap.erase(simIterator);
-
3463 }
-
3464 }
-
3465 }
-
3466}
-
3467
-
3468void
-
3469NetworkOPsImp::addAccountHistoryJob(SubAccountHistoryInfoWeak subInfo)
-
3470{
-
3471 enum DatabaseType { Sqlite, None };
-
3472 static const auto databaseType = [&]() -> DatabaseType {
-
3473 // Use a dynamic_cast to return DatabaseType::None
-
3474 // on failure.
-
3475 if (dynamic_cast<SQLiteDatabase*>(&app_.getRelationalDatabase()))
-
3476 {
-
3477 return DatabaseType::Sqlite;
-
3478 }
-
3479 return DatabaseType::None;
-
3480 }();
-
3481
-
3482 if (databaseType == DatabaseType::None)
-
3483 {
-
3484 JLOG(m_journal.error())
-
3485 << "AccountHistory job for account "
-
3486 << toBase58(subInfo.index_->accountId_) << " no database";
-
3487 if (auto sptr = subInfo.sinkWptr_.lock(); sptr)
-
3488 {
-
3489 sptr->send(rpcError(rpcINTERNAL), true);
-
3490 unsubAccountHistory(sptr, subInfo.index_->accountId_, false);
+
3387 for (InfoSub::ref isrListener : notify)
+
3388 jvObj.visit(
+
3389 isrListener->getApiVersion(), //
+
3390 [&](Json::Value const& jv) { isrListener->send(jv, true); });
+
3391
+
3392 XRPL_ASSERT(
+
3393 jvObj.isMember(jss::account_history_tx_stream) ==
+
3394 MultiApiJson::none,
+
3395 "ripple::NetworkOPs::pubProposedAccountTransaction : "
+
3396 "account_history_tx_stream not set");
+
3397 for (auto& info : accountHistoryNotify)
+
3398 {
+
3399 auto& index = info.index_;
+
3400 if (index->forwardTxIndex_ == 0 && !index->haveHistorical_)
+
3401 jvObj.set(jss::account_history_tx_first, true);
+
3402 jvObj.set(jss::account_history_tx_index, index->forwardTxIndex_++);
+
3403 jvObj.visit(
+
3404 info.sink_->getApiVersion(), //
+
3405 [&](Json::Value const& jv) { info.sink_->send(jv, true); });
+
3406 }
+
3407 }
+
3408}
+
3409
+
3410//
+
3411// Monitoring
+
3412//
+
3413
+
3414void
+
3415NetworkOPsImp::subAccount(
+
3416 InfoSub::ref isrListener,
+
3417 hash_set<AccountID> const& vnaAccountIDs,
+
3418 bool rt)
+
3419{
+
3420 SubInfoMapType& subMap = rt ? mSubRTAccount : mSubAccount;
+
3421
+
3422 for (auto const& naAccountID : vnaAccountIDs)
+
3423 {
+
3424 JLOG(m_journal.trace())
+
3425 << "subAccount: account: " << toBase58(naAccountID);
+
3426
+
3427 isrListener->insertSubAccountInfo(naAccountID, rt);
+
3428 }
+
3429
+
3430 std::lock_guard sl(mSubLock);
+
3431
+
3432 for (auto const& naAccountID : vnaAccountIDs)
+
3433 {
+
3434 auto simIterator = subMap.find(naAccountID);
+
3435 if (simIterator == subMap.end())
+
3436 {
+
3437 // Not found, note that account has a new single listner.
+
3438 SubMapType usisElement;
+
3439 usisElement[isrListener->getSeq()] = isrListener;
+
3440 // VFALCO NOTE This is making a needless copy of naAccountID
+
3441 subMap.insert(simIterator, make_pair(naAccountID, usisElement));
+
3442 }
+
3443 else
+
3444 {
+
3445 // Found, note that the account has another listener.
+
3446 simIterator->second[isrListener->getSeq()] = isrListener;
+
3447 }
+
3448 }
+
3449}
+
3450
+
3451void
+
3452NetworkOPsImp::unsubAccount(
+
3453 InfoSub::ref isrListener,
+
3454 hash_set<AccountID> const& vnaAccountIDs,
+
3455 bool rt)
+
3456{
+
3457 for (auto const& naAccountID : vnaAccountIDs)
+
3458 {
+
3459 // Remove from the InfoSub
+
3460 isrListener->deleteSubAccountInfo(naAccountID, rt);
+
3461 }
+
3462
+
3463 // Remove from the server
+
3464 unsubAccountInternal(isrListener->getSeq(), vnaAccountIDs, rt);
+
3465}
+
3466
+
3467void
+
3468NetworkOPsImp::unsubAccountInternal(
+
3469 std::uint64_t uSeq,
+
3470 hash_set<AccountID> const& vnaAccountIDs,
+
3471 bool rt)
+
3472{
+
3473 std::lock_guard sl(mSubLock);
+
3474
+
3475 SubInfoMapType& subMap = rt ? mSubRTAccount : mSubAccount;
+
3476
+
3477 for (auto const& naAccountID : vnaAccountIDs)
+
3478 {
+
3479 auto simIterator = subMap.find(naAccountID);
+
3480
+
3481 if (simIterator != subMap.end())
+
3482 {
+
3483 // Found
+
3484 simIterator->second.erase(uSeq);
+
3485
+
3486 if (simIterator->second.empty())
+
3487 {
+
3488 // Don't need hash entry.
+
3489 subMap.erase(simIterator);
+
3490 }
3491 }
-
3492 return;
-
3493 }
+
3492 }
+
3493}
3494
-
3495 app_.getJobQueue().addJob(
-
3496 jtCLIENT_ACCT_HIST,
-
3497 "AccountHistoryTxStream",
-
3498 [this, dbType = databaseType, subInfo]() {
-
3499 auto const& accountId = subInfo.index_->accountId_;
-
3500 auto& lastLedgerSeq = subInfo.index_->historyLastLedgerSeq_;
-
3501 auto& txHistoryIndex = subInfo.index_->historyTxIndex_;
-
3502
-
3503 JLOG(m_journal.trace())
-
3504 << "AccountHistory job for account " << toBase58(accountId)
-
3505 << " started. lastLedgerSeq=" << lastLedgerSeq;
-
3506
-
3507 auto isFirstTx = [&](std::shared_ptr<Transaction> const& tx,
-
3508 std::shared_ptr<TxMeta> const& meta) -> bool {
-
3509 /*
-
3510 * genesis account: first tx is the one with seq 1
-
3511 * other account: first tx is the one created the account
-
3512 */
-
3513 if (accountId == genesisAccountId)
-
3514 {
-
3515 auto stx = tx->getSTransaction();
-
3516 if (stx->getAccountID(sfAccount) == accountId &&
-
3517 stx->getSeqProxy().value() == 1)
-
3518 return true;
-
3519 }
-
3520
-
3521 for (auto& node : meta->getNodes())
-
3522 {
-
3523 if (node.getFieldU16(sfLedgerEntryType) != ltACCOUNT_ROOT)
-
3524 continue;
-
3525
-
3526 if (node.isFieldPresent(sfNewFields))
-
3527 {
-
3528 if (auto inner = dynamic_cast<const STObject*>(
-
3529 node.peekAtPField(sfNewFields));
-
3530 inner)
-
3531 {
-
3532 if (inner->isFieldPresent(sfAccount) &&
-
3533 inner->getAccountID(sfAccount) == accountId)
-
3534 {
-
3535 return true;
-
3536 }
-
3537 }
-
3538 }
-
3539 }
-
3540
-
3541 return false;
-
3542 };
-
3543
-
3544 auto send = [&](Json::Value const& jvObj,
-
3545 bool unsubscribe) -> bool {
-
3546 if (auto sptr = subInfo.sinkWptr_.lock())
-
3547 {
-
3548 sptr->send(jvObj, true);
-
3549 if (unsubscribe)
-
3550 unsubAccountHistory(sptr, accountId, false);
-
3551 return true;
-
3552 }
-
3553
-
3554 return false;
-
3555 };
-
3556
-
3557 auto sendMultiApiJson = [&](MultiApiJson const& jvObj,
-
3558 bool unsubscribe) -> bool {
-
3559 if (auto sptr = subInfo.sinkWptr_.lock())
-
3560 {
-
3561 jvObj.visit(
-
3562 sptr->getApiVersion(), //
-
3563 [&](Json::Value const& jv) { sptr->send(jv, true); });
-
3564
-
3565 if (unsubscribe)
-
3566 unsubAccountHistory(sptr, accountId, false);
-
3567 return true;
-
3568 }
-
3569
-
3570 return false;
-
3571 };
-
3572
-
3573 auto getMoreTxns =
-
3574 [&](std::uint32_t minLedger,
-
3575 std::uint32_t maxLedger,
-
3576 std::optional<RelationalDatabase::AccountTxMarker> marker)
-
3577 -> std::optional<std::pair<
-
3578 RelationalDatabase::AccountTxs,
-
3579 std::optional<RelationalDatabase::AccountTxMarker>>> {
-
3580 switch (dbType)
-
3581 {
-
3582 case Sqlite: {
-
3583 auto db = static_cast<SQLiteDatabase*>(
-
3584 &app_.getRelationalDatabase());
-
3585 RelationalDatabase::AccountTxPageOptions options{
-
3586 accountId, minLedger, maxLedger, marker, 0, true};
-
3587 return db->newestAccountTxPage(options);
-
3588 }
-
3589 default: {
-
3590 UNREACHABLE(
-
3591 "ripple::NetworkOPsImp::addAccountHistoryJob::"
-
3592 "getMoreTxns : invalid database type");
-
3593 return {};
-
3594 }
+
3495void
+
3496NetworkOPsImp::addAccountHistoryJob(SubAccountHistoryInfoWeak subInfo)
+
3497{
+
3498 enum DatabaseType { Sqlite, None };
+
3499 static const auto databaseType = [&]() -> DatabaseType {
+
3500 // Use a dynamic_cast to return DatabaseType::None
+
3501 // on failure.
+
3502 if (dynamic_cast<SQLiteDatabase*>(&app_.getRelationalDatabase()))
+
3503 {
+
3504 return DatabaseType::Sqlite;
+
3505 }
+
3506 return DatabaseType::None;
+
3507 }();
+
3508
+
3509 if (databaseType == DatabaseType::None)
+
3510 {
+
3511 JLOG(m_journal.error())
+
3512 << "AccountHistory job for account "
+
3513 << toBase58(subInfo.index_->accountId_) << " no database";
+
3514 if (auto sptr = subInfo.sinkWptr_.lock(); sptr)
+
3515 {
+
3516 sptr->send(rpcError(rpcINTERNAL), true);
+
3517 unsubAccountHistory(sptr, subInfo.index_->accountId_, false);
+
3518 }
+
3519 return;
+
3520 }
+
3521
+
3522 app_.getJobQueue().addJob(
+
3523 jtCLIENT_ACCT_HIST,
+
3524 "AccountHistoryTxStream",
+
3525 [this, dbType = databaseType, subInfo]() {
+
3526 auto const& accountId = subInfo.index_->accountId_;
+
3527 auto& lastLedgerSeq = subInfo.index_->historyLastLedgerSeq_;
+
3528 auto& txHistoryIndex = subInfo.index_->historyTxIndex_;
+
3529
+
3530 JLOG(m_journal.trace())
+
3531 << "AccountHistory job for account " << toBase58(accountId)
+
3532 << " started. lastLedgerSeq=" << lastLedgerSeq;
+
3533
+
3534 auto isFirstTx = [&](std::shared_ptr<Transaction> const& tx,
+
3535 std::shared_ptr<TxMeta> const& meta) -> bool {
+
3536 /*
+
3537 * genesis account: first tx is the one with seq 1
+
3538 * other account: first tx is the one created the account
+
3539 */
+
3540 if (accountId == genesisAccountId)
+
3541 {
+
3542 auto stx = tx->getSTransaction();
+
3543 if (stx->getAccountID(sfAccount) == accountId &&
+
3544 stx->getSeqProxy().value() == 1)
+
3545 return true;
+
3546 }
+
3547
+
3548 for (auto& node : meta->getNodes())
+
3549 {
+
3550 if (node.getFieldU16(sfLedgerEntryType) != ltACCOUNT_ROOT)
+
3551 continue;
+
3552
+
3553 if (node.isFieldPresent(sfNewFields))
+
3554 {
+
3555 if (auto inner = dynamic_cast<const STObject*>(
+
3556 node.peekAtPField(sfNewFields));
+
3557 inner)
+
3558 {
+
3559 if (inner->isFieldPresent(sfAccount) &&
+
3560 inner->getAccountID(sfAccount) == accountId)
+
3561 {
+
3562 return true;
+
3563 }
+
3564 }
+
3565 }
+
3566 }
+
3567
+
3568 return false;
+
3569 };
+
3570
+
3571 auto send = [&](Json::Value const& jvObj,
+
3572 bool unsubscribe) -> bool {
+
3573 if (auto sptr = subInfo.sinkWptr_.lock())
+
3574 {
+
3575 sptr->send(jvObj, true);
+
3576 if (unsubscribe)
+
3577 unsubAccountHistory(sptr, accountId, false);
+
3578 return true;
+
3579 }
+
3580
+
3581 return false;
+
3582 };
+
3583
+
3584 auto sendMultiApiJson = [&](MultiApiJson const& jvObj,
+
3585 bool unsubscribe) -> bool {
+
3586 if (auto sptr = subInfo.sinkWptr_.lock())
+
3587 {
+
3588 jvObj.visit(
+
3589 sptr->getApiVersion(), //
+
3590 [&](Json::Value const& jv) { sptr->send(jv, true); });
+
3591
+
3592 if (unsubscribe)
+
3593 unsubAccountHistory(sptr, accountId, false);
+
3594 return true;
3595 }
-
3596 };
-
3597
-
3598 /*
-
3599 * search backward until the genesis ledger or asked to stop
-
3600 */
-
3601 while (lastLedgerSeq >= 2 && !subInfo.index_->stopHistorical_)
-
3602 {
-
3603 int feeChargeCount = 0;
-
3604 if (auto sptr = subInfo.sinkWptr_.lock(); sptr)
-
3605 {
-
3606 sptr->getConsumer().charge(Resource::feeMediumBurdenRPC);
-
3607 ++feeChargeCount;
-
3608 }
-
3609 else
-
3610 {
-
3611 JLOG(m_journal.trace())
-
3612 << "AccountHistory job for account "
-
3613 << toBase58(accountId) << " no InfoSub. Fee charged "
-
3614 << feeChargeCount << " times.";
-
3615 return;
-
3616 }
-
3617
-
3618 // try to search in 1024 ledgers till reaching genesis ledgers
-
3619 auto startLedgerSeq =
-
3620 (lastLedgerSeq > 1024 + 2 ? lastLedgerSeq - 1024 : 2);
-
3621 JLOG(m_journal.trace())
-
3622 << "AccountHistory job for account " << toBase58(accountId)
-
3623 << ", working on ledger range [" << startLedgerSeq << ","
-
3624 << lastLedgerSeq << "]";
-
3625
-
3626 auto haveRange = [&]() -> bool {
-
3627 std::uint32_t validatedMin = UINT_MAX;
-
3628 std::uint32_t validatedMax = 0;
-
3629 auto haveSomeValidatedLedgers =
-
3630 app_.getLedgerMaster().getValidatedRange(
-
3631 validatedMin, validatedMax);
-
3632
-
3633 return haveSomeValidatedLedgers &&
-
3634 validatedMin <= startLedgerSeq &&
-
3635 lastLedgerSeq <= validatedMax;
-
3636 }();
-
3637
-
3638 if (!haveRange)
-
3639 {
-
3640 JLOG(m_journal.debug())
-
3641 << "AccountHistory reschedule job for account "
-
3642 << toBase58(accountId) << ", incomplete ledger range ["
-
3643 << startLedgerSeq << "," << lastLedgerSeq << "]";
-
3644 setAccountHistoryJobTimer(subInfo);
-
3645 return;
-
3646 }
-
3647
-
3648 std::optional<RelationalDatabase::AccountTxMarker> marker{};
-
3649 while (!subInfo.index_->stopHistorical_)
-
3650 {
-
3651 auto dbResult =
-
3652 getMoreTxns(startLedgerSeq, lastLedgerSeq, marker);
-
3653 if (!dbResult)
-
3654 {
-
3655 JLOG(m_journal.debug())
-
3656 << "AccountHistory job for account "
-
3657 << toBase58(accountId) << " getMoreTxns failed.";
-
3658 send(rpcError(rpcINTERNAL), true);
-
3659 return;
-
3660 }
-
3661
-
3662 auto const& txns = dbResult->first;
-
3663 marker = dbResult->second;
-
3664 size_t num_txns = txns.size();
-
3665 for (size_t i = 0; i < num_txns; ++i)
-
3666 {
-
3667 auto const& [tx, meta] = txns[i];
-
3668
-
3669 if (!tx || !meta)
-
3670 {
-
3671 JLOG(m_journal.debug())
-
3672 << "AccountHistory job for account "
-
3673 << toBase58(accountId) << " empty tx or meta.";
-
3674 send(rpcError(rpcINTERNAL), true);
-
3675 return;
-
3676 }
-
3677 auto curTxLedger =
-
3678 app_.getLedgerMaster().getLedgerBySeq(
-
3679 tx->getLedger());
-
3680 if (!curTxLedger)
-
3681 {
-
3682 JLOG(m_journal.debug())
-
3683 << "AccountHistory job for account "
-
3684 << toBase58(accountId) << " no ledger.";
-
3685 send(rpcError(rpcINTERNAL), true);
-
3686 return;
-
3687 }
-
3688 std::shared_ptr<STTx const> stTxn =
-
3689 tx->getSTransaction();
-
3690 if (!stTxn)
-
3691 {
-
3692 JLOG(m_journal.debug())
-
3693 << "AccountHistory job for account "
-
3694 << toBase58(accountId)
-
3695 << " getSTransaction failed.";
-
3696 send(rpcError(rpcINTERNAL), true);
-
3697 return;
-
3698 }
-
3699
-
3700 auto const mRef = std::ref(*meta);
-
3701 auto const trR = meta->getResultTER();
-
3702 MultiApiJson jvTx =
-
3703 transJson(stTxn, trR, true, curTxLedger, mRef);
-
3704
-
3705 jvTx.set(
-
3706 jss::account_history_tx_index, txHistoryIndex--);
-
3707 if (i + 1 == num_txns ||
-
3708 txns[i + 1].first->getLedger() != tx->getLedger())
-
3709 jvTx.set(jss::account_history_boundary, true);
-
3710
-
3711 if (isFirstTx(tx, meta))
-
3712 {
-
3713 jvTx.set(jss::account_history_tx_first, true);
-
3714 sendMultiApiJson(jvTx, false);
-
3715
-
3716 JLOG(m_journal.trace())
-
3717 << "AccountHistory job for account "
-
3718 << toBase58(accountId)
-
3719 << " done, found last tx.";
-
3720 return;
-
3721 }
-
3722 else
-
3723 {
-
3724 sendMultiApiJson(jvTx, false);
+
3596
+
3597 return false;
+
3598 };
+
3599
+
3600 auto getMoreTxns =
+
3601 [&](std::uint32_t minLedger,
+
3602 std::uint32_t maxLedger,
+
3603 std::optional<RelationalDatabase::AccountTxMarker> marker)
+
3604 -> std::optional<std::pair<
+
3605 RelationalDatabase::AccountTxs,
+
3606 std::optional<RelationalDatabase::AccountTxMarker>>> {
+
3607 switch (dbType)
+
3608 {
+
3609 case Sqlite: {
+
3610 auto db = static_cast<SQLiteDatabase*>(
+
3611 &app_.getRelationalDatabase());
+
3612 RelationalDatabase::AccountTxPageOptions options{
+
3613 accountId, minLedger, maxLedger, marker, 0, true};
+
3614 return db->newestAccountTxPage(options);
+
3615 }
+
3616 default: {
+
3617 UNREACHABLE(
+
3618 "ripple::NetworkOPsImp::addAccountHistoryJob::"
+
3619 "getMoreTxns : invalid database type");
+
3620 return {};
+
3621 }
+
3622 }
+
3623 };
+
3624
+
3625 /*
+
3626 * search backward until the genesis ledger or asked to stop
+
3627 */
+
3628 while (lastLedgerSeq >= 2 && !subInfo.index_->stopHistorical_)
+
3629 {
+
3630 int feeChargeCount = 0;
+
3631 if (auto sptr = subInfo.sinkWptr_.lock(); sptr)
+
3632 {
+
3633 sptr->getConsumer().charge(Resource::feeMediumBurdenRPC);
+
3634 ++feeChargeCount;
+
3635 }
+
3636 else
+
3637 {
+
3638 JLOG(m_journal.trace())
+
3639 << "AccountHistory job for account "
+
3640 << toBase58(accountId) << " no InfoSub. Fee charged "
+
3641 << feeChargeCount << " times.";
+
3642 return;
+
3643 }
+
3644
+
3645 // try to search in 1024 ledgers till reaching genesis ledgers
+
3646 auto startLedgerSeq =
+
3647 (lastLedgerSeq > 1024 + 2 ? lastLedgerSeq - 1024 : 2);
+
3648 JLOG(m_journal.trace())
+
3649 << "AccountHistory job for account " << toBase58(accountId)
+
3650 << ", working on ledger range [" << startLedgerSeq << ","
+
3651 << lastLedgerSeq << "]";
+
3652
+
3653 auto haveRange = [&]() -> bool {
+
3654 std::uint32_t validatedMin = UINT_MAX;
+
3655 std::uint32_t validatedMax = 0;
+
3656 auto haveSomeValidatedLedgers =
+
3657 app_.getLedgerMaster().getValidatedRange(
+
3658 validatedMin, validatedMax);
+
3659
+
3660 return haveSomeValidatedLedgers &&
+
3661 validatedMin <= startLedgerSeq &&
+
3662 lastLedgerSeq <= validatedMax;
+
3663 }();
+
3664
+
3665 if (!haveRange)
+
3666 {
+
3667 JLOG(m_journal.debug())
+
3668 << "AccountHistory reschedule job for account "
+
3669 << toBase58(accountId) << ", incomplete ledger range ["
+
3670 << startLedgerSeq << "," << lastLedgerSeq << "]";
+
3671 setAccountHistoryJobTimer(subInfo);
+
3672 return;
+
3673 }
+
3674
+
3675 std::optional<RelationalDatabase::AccountTxMarker> marker{};
+
3676 while (!subInfo.index_->stopHistorical_)
+
3677 {
+
3678 auto dbResult =
+
3679 getMoreTxns(startLedgerSeq, lastLedgerSeq, marker);
+
3680 if (!dbResult)
+
3681 {
+
3682 JLOG(m_journal.debug())
+
3683 << "AccountHistory job for account "
+
3684 << toBase58(accountId) << " getMoreTxns failed.";
+
3685 send(rpcError(rpcINTERNAL), true);
+
3686 return;
+
3687 }
+
3688
+
3689 auto const& txns = dbResult->first;
+
3690 marker = dbResult->second;
+
3691 size_t num_txns = txns.size();
+
3692 for (size_t i = 0; i < num_txns; ++i)
+
3693 {
+
3694 auto const& [tx, meta] = txns[i];
+
3695
+
3696 if (!tx || !meta)
+
3697 {
+
3698 JLOG(m_journal.debug())
+
3699 << "AccountHistory job for account "
+
3700 << toBase58(accountId) << " empty tx or meta.";
+
3701 send(rpcError(rpcINTERNAL), true);
+
3702 return;
+
3703 }
+
3704 auto curTxLedger =
+
3705 app_.getLedgerMaster().getLedgerBySeq(
+
3706 tx->getLedger());
+
3707 if (!curTxLedger)
+
3708 {
+
3709 JLOG(m_journal.debug())
+
3710 << "AccountHistory job for account "
+
3711 << toBase58(accountId) << " no ledger.";
+
3712 send(rpcError(rpcINTERNAL), true);
+
3713 return;
+
3714 }
+
3715 std::shared_ptr<STTx const> stTxn =
+
3716 tx->getSTransaction();
+
3717 if (!stTxn)
+
3718 {
+
3719 JLOG(m_journal.debug())
+
3720 << "AccountHistory job for account "
+
3721 << toBase58(accountId)
+
3722 << " getSTransaction failed.";
+
3723 send(rpcError(rpcINTERNAL), true);
+
3724 return;
3725 }
-
3726 }
-
3727
-
3728 if (marker)
-
3729 {
-
3730 JLOG(m_journal.trace())
-
3731 << "AccountHistory job for account "
-
3732 << toBase58(accountId)
-
3733 << " paging, marker=" << marker->ledgerSeq << ":"
-
3734 << marker->txnSeq;
-
3735 }
-
3736 else
-
3737 {
-
3738 break;
-
3739 }
-
3740 }
-
3741
-
3742 if (!subInfo.index_->stopHistorical_)
-
3743 {
-
3744 lastLedgerSeq = startLedgerSeq - 1;
-
3745 if (lastLedgerSeq <= 1)
-
3746 {
-
3747 JLOG(m_journal.trace())
-
3748 << "AccountHistory job for account "
-
3749 << toBase58(accountId)
-
3750 << " done, reached genesis ledger.";
-
3751 return;
-
3752 }
-
3753 }
-
3754 }
-
3755 });
-
3756}
-
3757
-
3758void
-
3759NetworkOPsImp::subAccountHistoryStart(
-
3760 std::shared_ptr<ReadView const> const& ledger,
-
3761 SubAccountHistoryInfoWeak& subInfo)
-
3762{
-
3763 subInfo.index_->separationLedgerSeq_ = ledger->seq();
-
3764 auto const& accountId = subInfo.index_->accountId_;
-
3765 auto const accountKeylet = keylet::account(accountId);
-
3766 if (!ledger->exists(accountKeylet))
-
3767 {
-
3768 JLOG(m_journal.debug())
-
3769 << "subAccountHistoryStart, no account " << toBase58(accountId)
-
3770 << ", no need to add AccountHistory job.";
-
3771 return;
-
3772 }
-
3773 if (accountId == genesisAccountId)
-
3774 {
-
3775 if (auto const sleAcct = ledger->read(accountKeylet); sleAcct)
-
3776 {
-
3777 if (sleAcct->getFieldU32(sfSequence) == 1)
-
3778 {
-
3779 JLOG(m_journal.debug())
-
3780 << "subAccountHistoryStart, genesis account "
-
3781 << toBase58(accountId)
-
3782 << " does not have tx, no need to add AccountHistory job.";
-
3783 return;
-
3784 }
-
3785 }
-
3786 else
-
3787 {
-
3788 UNREACHABLE(
-
3789 "ripple::NetworkOPsImp::subAccountHistoryStart : failed to "
-
3790 "access genesis account");
-
3791 return;
-
3792 }
-
3793 }
-
3794 subInfo.index_->historyLastLedgerSeq_ = ledger->seq();
-
3795 subInfo.index_->haveHistorical_ = true;
-
3796
-
3797 JLOG(m_journal.debug())
-
3798 << "subAccountHistoryStart, add AccountHistory job: accountId="
-
3799 << toBase58(accountId) << ", currentLedgerSeq=" << ledger->seq();
-
3800
-
3801 addAccountHistoryJob(subInfo);
-
3802}
-
3803
-
3804error_code_i
-
3805NetworkOPsImp::subAccountHistory(
-
3806 InfoSub::ref isrListener,
-
3807 AccountID const& accountId)
-
3808{
-
3809 if (!isrListener->insertSubAccountHistory(accountId))
-
3810 {
-
3811 JLOG(m_journal.debug())
-
3812 << "subAccountHistory, already subscribed to account "
-
3813 << toBase58(accountId);
-
3814 return rpcINVALID_PARAMS;
-
3815 }
-
3816
-
3817 std::lock_guard sl(mSubLock);
-
3818 SubAccountHistoryInfoWeak ahi{
-
3819 isrListener, std::make_shared<SubAccountHistoryIndex>(accountId)};
-
3820 auto simIterator = mSubAccountHistory.find(accountId);
-
3821 if (simIterator == mSubAccountHistory.end())
-
3822 {
-
3823 hash_map<std::uint64_t, SubAccountHistoryInfoWeak> inner;
-
3824 inner.emplace(isrListener->getSeq(), ahi);
-
3825 mSubAccountHistory.insert(
-
3826 simIterator, std::make_pair(accountId, inner));
-
3827 }
-
3828 else
-
3829 {
-
3830 simIterator->second.emplace(isrListener->getSeq(), ahi);
-
3831 }
-
3832
-
3833 auto const ledger = app_.getLedgerMaster().getValidatedLedger();
-
3834 if (ledger)
-
3835 {
-
3836 subAccountHistoryStart(ledger, ahi);
-
3837 }
-
3838 else
-
3839 {
-
3840 // The node does not have validated ledgers, so wait for
-
3841 // one before start streaming.
-
3842 // In this case, the subscription is also considered successful.
-
3843 JLOG(m_journal.debug())
-
3844 << "subAccountHistory, no validated ledger yet, delay start";
-
3845 }
-
3846
-
3847 return rpcSUCCESS;
-
3848}
-
3849
-
3850void
-
3851NetworkOPsImp::unsubAccountHistory(
-
3852 InfoSub::ref isrListener,
-
3853 AccountID const& account,
-
3854 bool historyOnly)
-
3855{
-
3856 if (!historyOnly)
-
3857 isrListener->deleteSubAccountHistory(account);
-
3858 unsubAccountHistoryInternal(isrListener->getSeq(), account, historyOnly);
-
3859}
-
3860
-
3861void
-
3862NetworkOPsImp::unsubAccountHistoryInternal(
-
3863 std::uint64_t seq,
-
3864 const AccountID& account,
-
3865 bool historyOnly)
-
3866{
-
3867 std::lock_guard sl(mSubLock);
-
3868 auto simIterator = mSubAccountHistory.find(account);
-
3869 if (simIterator != mSubAccountHistory.end())
-
3870 {
-
3871 auto& subInfoMap = simIterator->second;
-
3872 auto subInfoIter = subInfoMap.find(seq);
-
3873 if (subInfoIter != subInfoMap.end())
-
3874 {
-
3875 subInfoIter->second.index_->stopHistorical_ = true;
-
3876 }
-
3877
-
3878 if (!historyOnly)
-
3879 {
-
3880 simIterator->second.erase(seq);
-
3881 if (simIterator->second.empty())
-
3882 {
-
3883 mSubAccountHistory.erase(simIterator);
-
3884 }
-
3885 }
-
3886 JLOG(m_journal.debug())
-
3887 << "unsubAccountHistory, account " << toBase58(account)
-
3888 << ", historyOnly = " << (historyOnly ? "true" : "false");
-
3889 }
-
3890}
-
3891
-
3892bool
-
3893NetworkOPsImp::subBook(InfoSub::ref isrListener, Book const& book)
-
3894{
-
3895 if (auto listeners = app_.getOrderBookDB().makeBookListeners(book))
-
3896 listeners->addSubscriber(isrListener);
-
3897 else
-
3898 UNREACHABLE("ripple::NetworkOPsImp::subBook : null book listeners");
-
3899 return true;
-
3900}
-
3901
-
3902bool
-
3903NetworkOPsImp::unsubBook(std::uint64_t uSeq, Book const& book)
-
3904{
-
3905 if (auto listeners = app_.getOrderBookDB().getBookListeners(book))
-
3906 listeners->removeSubscriber(uSeq);
-
3907
-
3908 return true;
-
3909}
-
3910
-
3911std::uint32_t
-
3912NetworkOPsImp::acceptLedger(
-
3913 std::optional<std::chrono::milliseconds> consensusDelay)
-
3914{
-
3915 // This code-path is exclusively used when the server is in standalone
-
3916 // mode via `ledger_accept`
-
3917 XRPL_ASSERT(
-
3918 m_standalone, "ripple::NetworkOPsImp::acceptLedger : is standalone");
-
3919
-
3920 if (!m_standalone)
-
3921 Throw<std::runtime_error>(
-
3922 "Operation only possible in STANDALONE mode.");
-
3923
-
3924 // FIXME Could we improve on this and remove the need for a specialized
-
3925 // API in Consensus?
-
3926 beginConsensus(m_ledgerMaster.getClosedLedger()->info().hash, {});
-
3927 mConsensus.simulate(app_.timeKeeper().closeTime(), consensusDelay);
-
3928 return m_ledgerMaster.getCurrentLedger()->info().seq;
-
3929}
-
3930
-
3931// <-- bool: true=added, false=already there
-
3932bool
-
3933NetworkOPsImp::subLedger(InfoSub::ref isrListener, Json::Value& jvResult)
-
3934{
-
3935 if (auto lpClosed = m_ledgerMaster.getValidatedLedger())
-
3936 {
-
3937 jvResult[jss::ledger_index] = lpClosed->info().seq;
-
3938 jvResult[jss::ledger_hash] = to_string(lpClosed->info().hash);
-
3939 jvResult[jss::ledger_time] = Json::Value::UInt(
-
3940 lpClosed->info().closeTime.time_since_epoch().count());
-
3941 if (!lpClosed->rules().enabled(featureXRPFees))
-
3942 jvResult[jss::fee_ref] = Config::FEE_UNITS_DEPRECATED;
-
3943 jvResult[jss::fee_base] = lpClosed->fees().base.jsonClipped();
-
3944 jvResult[jss::reserve_base] =
-
3945 lpClosed->fees().accountReserve(0).jsonClipped();
-
3946 jvResult[jss::reserve_inc] = lpClosed->fees().increment.jsonClipped();
-
3947 }
-
3948
-
3949 if ((mMode >= OperatingMode::SYNCING) && !isNeedNetworkLedger())
-
3950 {
-
3951 jvResult[jss::validated_ledgers] =
-
3952 app_.getLedgerMaster().getCompleteLedgers();
-
3953 }
-
3954
-
3955 std::lock_guard sl(mSubLock);
-
3956 return mStreamMaps[sLedger]
-
3957 .emplace(isrListener->getSeq(), isrListener)
-
3958 .second;
-
3959}
-
3960
-
3961// <-- bool: true=added, false=already there
-
3962bool
-
3963NetworkOPsImp::subBookChanges(InfoSub::ref isrListener)
-
3964{
-
3965 std::lock_guard sl(mSubLock);
-
3966 return mStreamMaps[sBookChanges]
-
3967 .emplace(isrListener->getSeq(), isrListener)
-
3968 .second;
-
3969}
-
3970
-
3971// <-- bool: true=erased, false=was not there
-
3972bool
-
3973NetworkOPsImp::unsubLedger(std::uint64_t uSeq)
-
3974{
-
3975 std::lock_guard sl(mSubLock);
-
3976 return mStreamMaps[sLedger].erase(uSeq);
-
3977}
-
3978
-
3979// <-- bool: true=erased, false=was not there
-
3980bool
-
3981NetworkOPsImp::unsubBookChanges(std::uint64_t uSeq)
-
3982{
-
3983 std::lock_guard sl(mSubLock);
-
3984 return mStreamMaps[sBookChanges].erase(uSeq);
-
3985}
-
3986
-
3987// <-- bool: true=added, false=already there
-
3988bool
-
3989NetworkOPsImp::subManifests(InfoSub::ref isrListener)
-
3990{
-
3991 std::lock_guard sl(mSubLock);
-
3992 return mStreamMaps[sManifests]
-
3993 .emplace(isrListener->getSeq(), isrListener)
-
3994 .second;
-
3995}
-
3996
-
3997// <-- bool: true=erased, false=was not there
-
3998bool
-
3999NetworkOPsImp::unsubManifests(std::uint64_t uSeq)
-
4000{
-
4001 std::lock_guard sl(mSubLock);
-
4002 return mStreamMaps[sManifests].erase(uSeq);
-
4003}
-
4004
-
4005// <-- bool: true=added, false=already there
-
4006bool
-
4007NetworkOPsImp::subServer(
-
4008 InfoSub::ref isrListener,
-
4009 Json::Value& jvResult,
-
4010 bool admin)
-
4011{
-
4012 uint256 uRandom;
+
3726
+
3727 auto const mRef = std::ref(*meta);
+
3728 auto const trR = meta->getResultTER();
+
3729 MultiApiJson jvTx =
+
3730 transJson(stTxn, trR, true, curTxLedger, mRef);
+
3731
+
3732 jvTx.set(
+
3733 jss::account_history_tx_index, txHistoryIndex--);
+
3734 if (i + 1 == num_txns ||
+
3735 txns[i + 1].first->getLedger() != tx->getLedger())
+
3736 jvTx.set(jss::account_history_boundary, true);
+
3737
+
3738 if (isFirstTx(tx, meta))
+
3739 {
+
3740 jvTx.set(jss::account_history_tx_first, true);
+
3741 sendMultiApiJson(jvTx, false);
+
3742
+
3743 JLOG(m_journal.trace())
+
3744 << "AccountHistory job for account "
+
3745 << toBase58(accountId)
+
3746 << " done, found last tx.";
+
3747 return;
+
3748 }
+
3749 else
+
3750 {
+
3751 sendMultiApiJson(jvTx, false);
+
3752 }
+
3753 }
+
3754
+
3755 if (marker)
+
3756 {
+
3757 JLOG(m_journal.trace())
+
3758 << "AccountHistory job for account "
+
3759 << toBase58(accountId)
+
3760 << " paging, marker=" << marker->ledgerSeq << ":"
+
3761 << marker->txnSeq;
+
3762 }
+
3763 else
+
3764 {
+
3765 break;
+
3766 }
+
3767 }
+
3768
+
3769 if (!subInfo.index_->stopHistorical_)
+
3770 {
+
3771 lastLedgerSeq = startLedgerSeq - 1;
+
3772 if (lastLedgerSeq <= 1)
+
3773 {
+
3774 JLOG(m_journal.trace())
+
3775 << "AccountHistory job for account "
+
3776 << toBase58(accountId)
+
3777 << " done, reached genesis ledger.";
+
3778 return;
+
3779 }
+
3780 }
+
3781 }
+
3782 });
+
3783}
+
3784
+
3785void
+
3786NetworkOPsImp::subAccountHistoryStart(
+
3787 std::shared_ptr<ReadView const> const& ledger,
+
3788 SubAccountHistoryInfoWeak& subInfo)
+
3789{
+
3790 subInfo.index_->separationLedgerSeq_ = ledger->seq();
+
3791 auto const& accountId = subInfo.index_->accountId_;
+
3792 auto const accountKeylet = keylet::account(accountId);
+
3793 if (!ledger->exists(accountKeylet))
+
3794 {
+
3795 JLOG(m_journal.debug())
+
3796 << "subAccountHistoryStart, no account " << toBase58(accountId)
+
3797 << ", no need to add AccountHistory job.";
+
3798 return;
+
3799 }
+
3800 if (accountId == genesisAccountId)
+
3801 {
+
3802 if (auto const sleAcct = ledger->read(accountKeylet); sleAcct)
+
3803 {
+
3804 if (sleAcct->getFieldU32(sfSequence) == 1)
+
3805 {
+
3806 JLOG(m_journal.debug())
+
3807 << "subAccountHistoryStart, genesis account "
+
3808 << toBase58(accountId)
+
3809 << " does not have tx, no need to add AccountHistory job.";
+
3810 return;
+
3811 }
+
3812 }
+
3813 else
+
3814 {
+
3815 UNREACHABLE(
+
3816 "ripple::NetworkOPsImp::subAccountHistoryStart : failed to "
+
3817 "access genesis account");
+
3818 return;
+
3819 }
+
3820 }
+
3821 subInfo.index_->historyLastLedgerSeq_ = ledger->seq();
+
3822 subInfo.index_->haveHistorical_ = true;
+
3823
+
3824 JLOG(m_journal.debug())
+
3825 << "subAccountHistoryStart, add AccountHistory job: accountId="
+
3826 << toBase58(accountId) << ", currentLedgerSeq=" << ledger->seq();
+
3827
+
3828 addAccountHistoryJob(subInfo);
+
3829}
+
3830
+
3831error_code_i
+
3832NetworkOPsImp::subAccountHistory(
+
3833 InfoSub::ref isrListener,
+
3834 AccountID const& accountId)
+
3835{
+
3836 if (!isrListener->insertSubAccountHistory(accountId))
+
3837 {
+
3838 JLOG(m_journal.debug())
+
3839 << "subAccountHistory, already subscribed to account "
+
3840 << toBase58(accountId);
+
3841 return rpcINVALID_PARAMS;
+
3842 }
+
3843
+
3844 std::lock_guard sl(mSubLock);
+
3845 SubAccountHistoryInfoWeak ahi{
+
3846 isrListener, std::make_shared<SubAccountHistoryIndex>(accountId)};
+
3847 auto simIterator = mSubAccountHistory.find(accountId);
+
3848 if (simIterator == mSubAccountHistory.end())
+
3849 {
+
3850 hash_map<std::uint64_t, SubAccountHistoryInfoWeak> inner;
+
3851 inner.emplace(isrListener->getSeq(), ahi);
+
3852 mSubAccountHistory.insert(
+
3853 simIterator, std::make_pair(accountId, inner));
+
3854 }
+
3855 else
+
3856 {
+
3857 simIterator->second.emplace(isrListener->getSeq(), ahi);
+
3858 }
+
3859
+
3860 auto const ledger = app_.getLedgerMaster().getValidatedLedger();
+
3861 if (ledger)
+
3862 {
+
3863 subAccountHistoryStart(ledger, ahi);
+
3864 }
+
3865 else
+
3866 {
+
3867 // The node does not have validated ledgers, so wait for
+
3868 // one before start streaming.
+
3869 // In this case, the subscription is also considered successful.
+
3870 JLOG(m_journal.debug())
+
3871 << "subAccountHistory, no validated ledger yet, delay start";
+
3872 }
+
3873
+
3874 return rpcSUCCESS;
+
3875}
+
3876
+
3877void
+
3878NetworkOPsImp::unsubAccountHistory(
+
3879 InfoSub::ref isrListener,
+
3880 AccountID const& account,
+
3881 bool historyOnly)
+
3882{
+
3883 if (!historyOnly)
+
3884 isrListener->deleteSubAccountHistory(account);
+
3885 unsubAccountHistoryInternal(isrListener->getSeq(), account, historyOnly);
+
3886}
+
3887
+
3888void
+
3889NetworkOPsImp::unsubAccountHistoryInternal(
+
3890 std::uint64_t seq,
+
3891 const AccountID& account,
+
3892 bool historyOnly)
+
3893{
+
3894 std::lock_guard sl(mSubLock);
+
3895 auto simIterator = mSubAccountHistory.find(account);
+
3896 if (simIterator != mSubAccountHistory.end())
+
3897 {
+
3898 auto& subInfoMap = simIterator->second;
+
3899 auto subInfoIter = subInfoMap.find(seq);
+
3900 if (subInfoIter != subInfoMap.end())
+
3901 {
+
3902 subInfoIter->second.index_->stopHistorical_ = true;
+
3903 }
+
3904
+
3905 if (!historyOnly)
+
3906 {
+
3907 simIterator->second.erase(seq);
+
3908 if (simIterator->second.empty())
+
3909 {
+
3910 mSubAccountHistory.erase(simIterator);
+
3911 }
+
3912 }
+
3913 JLOG(m_journal.debug())
+
3914 << "unsubAccountHistory, account " << toBase58(account)
+
3915 << ", historyOnly = " << (historyOnly ? "true" : "false");
+
3916 }
+
3917}
+
3918
+
3919bool
+
3920NetworkOPsImp::subBook(InfoSub::ref isrListener, Book const& book)
+
3921{
+
3922 if (auto listeners = app_.getOrderBookDB().makeBookListeners(book))
+
3923 listeners->addSubscriber(isrListener);
+
3924 else
+
3925 UNREACHABLE("ripple::NetworkOPsImp::subBook : null book listeners");
+
3926 return true;
+
3927}
+
3928
+
3929bool
+
3930NetworkOPsImp::unsubBook(std::uint64_t uSeq, Book const& book)
+
3931{
+
3932 if (auto listeners = app_.getOrderBookDB().getBookListeners(book))
+
3933 listeners->removeSubscriber(uSeq);
+
3934
+
3935 return true;
+
3936}
+
3937
+
3938std::uint32_t
+
3939NetworkOPsImp::acceptLedger(
+
3940 std::optional<std::chrono::milliseconds> consensusDelay)
+
3941{
+
3942 // This code-path is exclusively used when the server is in standalone
+
3943 // mode via `ledger_accept`
+
3944 XRPL_ASSERT(
+
3945 m_standalone, "ripple::NetworkOPsImp::acceptLedger : is standalone");
+
3946
+
3947 if (!m_standalone)
+
3948 Throw<std::runtime_error>(
+
3949 "Operation only possible in STANDALONE mode.");
+
3950
+
3951 // FIXME Could we improve on this and remove the need for a specialized
+
3952 // API in Consensus?
+
3953 beginConsensus(m_ledgerMaster.getClosedLedger()->info().hash, {});
+
3954 mConsensus.simulate(app_.timeKeeper().closeTime(), consensusDelay);
+
3955 return m_ledgerMaster.getCurrentLedger()->info().seq;
+
3956}
+
3957
+
3958// <-- bool: true=added, false=already there
+
3959bool
+
3960NetworkOPsImp::subLedger(InfoSub::ref isrListener, Json::Value& jvResult)
+
3961{
+
3962 if (auto lpClosed = m_ledgerMaster.getValidatedLedger())
+
3963 {
+
3964 jvResult[jss::ledger_index] = lpClosed->info().seq;
+
3965 jvResult[jss::ledger_hash] = to_string(lpClosed->info().hash);
+
3966 jvResult[jss::ledger_time] = Json::Value::UInt(
+
3967 lpClosed->info().closeTime.time_since_epoch().count());
+
3968 if (!lpClosed->rules().enabled(featureXRPFees))
+
3969 jvResult[jss::fee_ref] = Config::FEE_UNITS_DEPRECATED;
+
3970 jvResult[jss::fee_base] = lpClosed->fees().base.jsonClipped();
+
3971 jvResult[jss::reserve_base] =
+
3972 lpClosed->fees().accountReserve(0).jsonClipped();
+
3973 jvResult[jss::reserve_inc] = lpClosed->fees().increment.jsonClipped();
+
3974 }
+
3975
+
3976 if ((mMode >= OperatingMode::SYNCING) && !isNeedNetworkLedger())
+
3977 {
+
3978 jvResult[jss::validated_ledgers] =
+
3979 app_.getLedgerMaster().getCompleteLedgers();
+
3980 }
+
3981
+
3982 std::lock_guard sl(mSubLock);
+
3983 return mStreamMaps[sLedger]
+
3984 .emplace(isrListener->getSeq(), isrListener)
+
3985 .second;
+
3986}
+
3987
+
3988// <-- bool: true=added, false=already there
+
3989bool
+
3990NetworkOPsImp::subBookChanges(InfoSub::ref isrListener)
+
3991{
+
3992 std::lock_guard sl(mSubLock);
+
3993 return mStreamMaps[sBookChanges]
+
3994 .emplace(isrListener->getSeq(), isrListener)
+
3995 .second;
+
3996}
+
3997
+
3998// <-- bool: true=erased, false=was not there
+
3999bool
+
4000NetworkOPsImp::unsubLedger(std::uint64_t uSeq)
+
4001{
+
4002 std::lock_guard sl(mSubLock);
+
4003 return mStreamMaps[sLedger].erase(uSeq);
+
4004}
+
4005
+
4006// <-- bool: true=erased, false=was not there
+
4007bool
+
4008NetworkOPsImp::unsubBookChanges(std::uint64_t uSeq)
+
4009{
+
4010 std::lock_guard sl(mSubLock);
+
4011 return mStreamMaps[sBookChanges].erase(uSeq);
+
4012}
4013
-
4014 if (m_standalone)
-
4015 jvResult[jss::stand_alone] = m_standalone;
-
4016
-
4017 // CHECKME: is it necessary to provide a random number here?
-
4018 beast::rngfill(uRandom.begin(), uRandom.size(), crypto_prng());
-
4019
-
4020 auto const& feeTrack = app_.getFeeTrack();
-
4021 jvResult[jss::random] = to_string(uRandom);
-
4022 jvResult[jss::server_status] = strOperatingMode(admin);
-
4023 jvResult[jss::load_base] = feeTrack.getLoadBase();
-
4024 jvResult[jss::load_factor] = feeTrack.getLoadFactor();
-
4025 jvResult[jss::hostid] = getHostId(admin);
-
4026 jvResult[jss::pubkey_node] =
-
4027 toBase58(TokenType::NodePublic, app_.nodeIdentity().first);
-
4028
-
4029 std::lock_guard sl(mSubLock);
-
4030 return mStreamMaps[sServer]
-
4031 .emplace(isrListener->getSeq(), isrListener)
-
4032 .second;
-
4033}
-
4034
-
4035// <-- bool: true=erased, false=was not there
-
4036bool
-
4037NetworkOPsImp::unsubServer(std::uint64_t uSeq)
+
4014// <-- bool: true=added, false=already there
+
4015bool
+
4016NetworkOPsImp::subManifests(InfoSub::ref isrListener)
+
4017{
+
4018 std::lock_guard sl(mSubLock);
+
4019 return mStreamMaps[sManifests]
+
4020 .emplace(isrListener->getSeq(), isrListener)
+
4021 .second;
+
4022}
+
4023
+
4024// <-- bool: true=erased, false=was not there
+
4025bool
+
4026NetworkOPsImp::unsubManifests(std::uint64_t uSeq)
+
4027{
+
4028 std::lock_guard sl(mSubLock);
+
4029 return mStreamMaps[sManifests].erase(uSeq);
+
4030}
+
4031
+
4032// <-- bool: true=added, false=already there
+
4033bool
+
4034NetworkOPsImp::subServer(
+
4035 InfoSub::ref isrListener,
+
4036 Json::Value& jvResult,
+
4037 bool admin)
4038{
-
4039 std::lock_guard sl(mSubLock);
-
4040 return mStreamMaps[sServer].erase(uSeq);
-
4041}
-
4042
-
4043// <-- bool: true=added, false=already there
-
4044bool
-
4045NetworkOPsImp::subTransactions(InfoSub::ref isrListener)
-
4046{
-
4047 std::lock_guard sl(mSubLock);
-
4048 return mStreamMaps[sTransactions]
-
4049 .emplace(isrListener->getSeq(), isrListener)
-
4050 .second;
-
4051}
-
4052
-
4053// <-- bool: true=erased, false=was not there
-
4054bool
-
4055NetworkOPsImp::unsubTransactions(std::uint64_t uSeq)
-
4056{
-
4057 std::lock_guard sl(mSubLock);
-
4058 return mStreamMaps[sTransactions].erase(uSeq);
-
4059}
-
4060
-
4061// <-- bool: true=added, false=already there
-
4062bool
-
4063NetworkOPsImp::subRTTransactions(InfoSub::ref isrListener)
-
4064{
-
4065 std::lock_guard sl(mSubLock);
-
4066 return mStreamMaps[sRTTransactions]
-
4067 .emplace(isrListener->getSeq(), isrListener)
-
4068 .second;
-
4069}
-
4070
-
4071// <-- bool: true=erased, false=was not there
-
4072bool
-
4073NetworkOPsImp::unsubRTTransactions(std::uint64_t uSeq)
-
4074{
-
4075 std::lock_guard sl(mSubLock);
-
4076 return mStreamMaps[sRTTransactions].erase(uSeq);
-
4077}
-
4078
-
4079// <-- bool: true=added, false=already there
-
4080bool
-
4081NetworkOPsImp::subValidations(InfoSub::ref isrListener)
-
4082{
-
4083 std::lock_guard sl(mSubLock);
-
4084 return mStreamMaps[sValidations]
-
4085 .emplace(isrListener->getSeq(), isrListener)
-
4086 .second;
-
4087}
-
4088
-
4089void
-
4090NetworkOPsImp::stateAccounting(Json::Value& obj)
+
4039 uint256 uRandom;
+
4040
+
4041 if (m_standalone)
+
4042 jvResult[jss::stand_alone] = m_standalone;
+
4043
+
4044 // CHECKME: is it necessary to provide a random number here?
+
4045 beast::rngfill(uRandom.begin(), uRandom.size(), crypto_prng());
+
4046
+
4047 auto const& feeTrack = app_.getFeeTrack();
+
4048 jvResult[jss::random] = to_string(uRandom);
+
4049 jvResult[jss::server_status] = strOperatingMode(admin);
+
4050 jvResult[jss::load_base] = feeTrack.getLoadBase();
+
4051 jvResult[jss::load_factor] = feeTrack.getLoadFactor();
+
4052 jvResult[jss::hostid] = getHostId(admin);
+
4053 jvResult[jss::pubkey_node] =
+
4054 toBase58(TokenType::NodePublic, app_.nodeIdentity().first);
+
4055
+
4056 std::lock_guard sl(mSubLock);
+
4057 return mStreamMaps[sServer]
+
4058 .emplace(isrListener->getSeq(), isrListener)
+
4059 .second;
+
4060}
+
4061
+
4062// <-- bool: true=erased, false=was not there
+
4063bool
+
4064NetworkOPsImp::unsubServer(std::uint64_t uSeq)
+
4065{
+
4066 std::lock_guard sl(mSubLock);
+
4067 return mStreamMaps[sServer].erase(uSeq);
+
4068}
+
4069
+
4070// <-- bool: true=added, false=already there
+
4071bool
+
4072NetworkOPsImp::subTransactions(InfoSub::ref isrListener)
+
4073{
+
4074 std::lock_guard sl(mSubLock);
+
4075 return mStreamMaps[sTransactions]
+
4076 .emplace(isrListener->getSeq(), isrListener)
+
4077 .second;
+
4078}
+
4079
+
4080// <-- bool: true=erased, false=was not there
+
4081bool
+
4082NetworkOPsImp::unsubTransactions(std::uint64_t uSeq)
+
4083{
+
4084 std::lock_guard sl(mSubLock);
+
4085 return mStreamMaps[sTransactions].erase(uSeq);
+
4086}
+
4087
+
4088// <-- bool: true=added, false=already there
+
4089bool
+
4090NetworkOPsImp::subRTTransactions(InfoSub::ref isrListener)
4091{
-
4092 accounting_.json(obj);
-
4093}
-
4094
-
4095// <-- bool: true=erased, false=was not there
-
4096bool
-
4097NetworkOPsImp::unsubValidations(std::uint64_t uSeq)
-
4098{
-
4099 std::lock_guard sl(mSubLock);
-
4100 return mStreamMaps[sValidations].erase(uSeq);
-
4101}
-
4102
-
4103// <-- bool: true=added, false=already there
-
4104bool
-
4105NetworkOPsImp::subPeerStatus(InfoSub::ref isrListener)
-
4106{
-
4107 std::lock_guard sl(mSubLock);
-
4108 return mStreamMaps[sPeerStatus]
-
4109 .emplace(isrListener->getSeq(), isrListener)
-
4110 .second;
-
4111}
-
4112
-
4113// <-- bool: true=erased, false=was not there
-
4114bool
-
4115NetworkOPsImp::unsubPeerStatus(std::uint64_t uSeq)
-
4116{
-
4117 std::lock_guard sl(mSubLock);
-
4118 return mStreamMaps[sPeerStatus].erase(uSeq);
-
4119}
-
4120
-
4121// <-- bool: true=added, false=already there
-
4122bool
-
4123NetworkOPsImp::subConsensus(InfoSub::ref isrListener)
-
4124{
-
4125 std::lock_guard sl(mSubLock);
-
4126 return mStreamMaps[sConsensusPhase]
-
4127 .emplace(isrListener->getSeq(), isrListener)
-
4128 .second;
-
4129}
-
4130
-
4131// <-- bool: true=erased, false=was not there
-
4132bool
-
4133NetworkOPsImp::unsubConsensus(std::uint64_t uSeq)
-
4134{
-
4135 std::lock_guard sl(mSubLock);
-
4136 return mStreamMaps[sConsensusPhase].erase(uSeq);
-
4137}
-
4138
-
4139InfoSub::pointer
-
4140NetworkOPsImp::findRpcSub(std::string const& strUrl)
-
4141{
-
4142 std::lock_guard sl(mSubLock);
-
4143
-
4144 subRpcMapType::iterator it = mRpcSubMap.find(strUrl);
-
4145
-
4146 if (it != mRpcSubMap.end())
-
4147 return it->second;
-
4148
-
4149 return InfoSub::pointer();
-
4150}
-
4151
-
4152InfoSub::pointer
-
4153NetworkOPsImp::addRpcSub(std::string const& strUrl, InfoSub::ref rspEntry)
-
4154{
-
4155 std::lock_guard sl(mSubLock);
-
4156
-
4157 mRpcSubMap.emplace(strUrl, rspEntry);
-
4158
-
4159 return rspEntry;
-
4160}
-
4161
-
4162bool
-
4163NetworkOPsImp::tryRemoveRpcSub(std::string const& strUrl)
-
4164{
-
4165 std::lock_guard sl(mSubLock);
-
4166 auto pInfo = findRpcSub(strUrl);
-
4167
-
4168 if (!pInfo)
-
4169 return false;
+
4092 std::lock_guard sl(mSubLock);
+
4093 return mStreamMaps[sRTTransactions]
+
4094 .emplace(isrListener->getSeq(), isrListener)
+
4095 .second;
+
4096}
+
4097
+
4098// <-- bool: true=erased, false=was not there
+
4099bool
+
4100NetworkOPsImp::unsubRTTransactions(std::uint64_t uSeq)
+
4101{
+
4102 std::lock_guard sl(mSubLock);
+
4103 return mStreamMaps[sRTTransactions].erase(uSeq);
+
4104}
+
4105
+
4106// <-- bool: true=added, false=already there
+
4107bool
+
4108NetworkOPsImp::subValidations(InfoSub::ref isrListener)
+
4109{
+
4110 std::lock_guard sl(mSubLock);
+
4111 return mStreamMaps[sValidations]
+
4112 .emplace(isrListener->getSeq(), isrListener)
+
4113 .second;
+
4114}
+
4115
+
4116void
+
4117NetworkOPsImp::stateAccounting(Json::Value& obj)
+
4118{
+
4119 accounting_.json(obj);
+
4120}
+
4121
+
4122// <-- bool: true=erased, false=was not there
+
4123bool
+
4124NetworkOPsImp::unsubValidations(std::uint64_t uSeq)
+
4125{
+
4126 std::lock_guard sl(mSubLock);
+
4127 return mStreamMaps[sValidations].erase(uSeq);
+
4128}
+
4129
+
4130// <-- bool: true=added, false=already there
+
4131bool
+
4132NetworkOPsImp::subPeerStatus(InfoSub::ref isrListener)
+
4133{
+
4134 std::lock_guard sl(mSubLock);
+
4135 return mStreamMaps[sPeerStatus]
+
4136 .emplace(isrListener->getSeq(), isrListener)
+
4137 .second;
+
4138}
+
4139
+
4140// <-- bool: true=erased, false=was not there
+
4141bool
+
4142NetworkOPsImp::unsubPeerStatus(std::uint64_t uSeq)
+
4143{
+
4144 std::lock_guard sl(mSubLock);
+
4145 return mStreamMaps[sPeerStatus].erase(uSeq);
+
4146}
+
4147
+
4148// <-- bool: true=added, false=already there
+
4149bool
+
4150NetworkOPsImp::subConsensus(InfoSub::ref isrListener)
+
4151{
+
4152 std::lock_guard sl(mSubLock);
+
4153 return mStreamMaps[sConsensusPhase]
+
4154 .emplace(isrListener->getSeq(), isrListener)
+
4155 .second;
+
4156}
+
4157
+
4158// <-- bool: true=erased, false=was not there
+
4159bool
+
4160NetworkOPsImp::unsubConsensus(std::uint64_t uSeq)
+
4161{
+
4162 std::lock_guard sl(mSubLock);
+
4163 return mStreamMaps[sConsensusPhase].erase(uSeq);
+
4164}
+
4165
+
4166InfoSub::pointer
+
4167NetworkOPsImp::findRpcSub(std::string const& strUrl)
+
4168{
+
4169 std::lock_guard sl(mSubLock);
4170
-
4171 // check to see if any of the stream maps still hold a weak reference to
-
4172 // this entry before removing
-
4173 for (SubMapType const& map : mStreamMaps)
-
4174 {
-
4175 if (map.find(pInfo->getSeq()) != map.end())
-
4176 return false;
-
4177 }
-
4178 mRpcSubMap.erase(strUrl);
-
4179 return true;
-
4180}
-
4181
-
4182#ifndef USE_NEW_BOOK_PAGE
+
4171 subRpcMapType::iterator it = mRpcSubMap.find(strUrl);
+
4172
+
4173 if (it != mRpcSubMap.end())
+
4174 return it->second;
+
4175
+
4176 return InfoSub::pointer();
+
4177}
+
4178
+
4179InfoSub::pointer
+
4180NetworkOPsImp::addRpcSub(std::string const& strUrl, InfoSub::ref rspEntry)
+
4181{
+
4182 std::lock_guard sl(mSubLock);
4183
-
4184// NIKB FIXME this should be looked at. There's no reason why this shouldn't
-
4185// work, but it demonstrated poor performance.
-
4186//
-
4187void
-
4188NetworkOPsImp::getBookPage(
-
4189 std::shared_ptr<ReadView const>& lpLedger,
-
4190 Book const& book,
-
4191 AccountID const& uTakerID,
-
4192 bool const bProof,
-
4193 unsigned int iLimit,
-
4194 Json::Value const& jvMarker,
-
4195 Json::Value& jvResult)
-
4196{ // CAUTION: This is the old get book page logic
-
4197 Json::Value& jvOffers =
-
4198 (jvResult[jss::offers] = Json::Value(Json::arrayValue));
-
4199
-
4200 std::unordered_map<AccountID, STAmount> umBalance;
-
4201 const uint256 uBookBase = getBookBase(book);
-
4202 const uint256 uBookEnd = getQualityNext(uBookBase);
-
4203 uint256 uTipIndex = uBookBase;
-
4204
-
4205 if (auto stream = m_journal.trace())
-
4206 {
-
4207 stream << "getBookPage:" << book;
-
4208 stream << "getBookPage: uBookBase=" << uBookBase;
-
4209 stream << "getBookPage: uBookEnd=" << uBookEnd;
-
4210 stream << "getBookPage: uTipIndex=" << uTipIndex;
-
4211 }
-
4212
-
4213 ReadView const& view = *lpLedger;
-
4214
-
4215 bool const bGlobalFreeze = isGlobalFrozen(view, book.out.account) ||
-
4216 isGlobalFrozen(view, book.in.account);
-
4217
-
4218 bool bDone = false;
-
4219 bool bDirectAdvance = true;
-
4220
-
4221 std::shared_ptr<SLE const> sleOfferDir;
-
4222 uint256 offerIndex;
-
4223 unsigned int uBookEntry;
-
4224 STAmount saDirRate;
-
4225
-
4226 auto const rate = transferRate(view, book.out.account);
-
4227 auto viewJ = app_.journal("View");
-
4228
-
4229 while (!bDone && iLimit-- > 0)
-
4230 {
-
4231 if (bDirectAdvance)
-
4232 {
-
4233 bDirectAdvance = false;
-
4234
-
4235 JLOG(m_journal.trace()) << "getBookPage: bDirectAdvance";
-
4236
-
4237 auto const ledgerIndex = view.succ(uTipIndex, uBookEnd);
-
4238 if (ledgerIndex)
-
4239 sleOfferDir = view.read(keylet::page(*ledgerIndex));
-
4240 else
-
4241 sleOfferDir.reset();
-
4242
-
4243 if (!sleOfferDir)
-
4244 {
-
4245 JLOG(m_journal.trace()) << "getBookPage: bDone";
-
4246 bDone = true;
-
4247 }
-
4248 else
-
4249 {
-
4250 uTipIndex = sleOfferDir->key();
-
4251 saDirRate = amountFromQuality(getQuality(uTipIndex));
+
4184 mRpcSubMap.emplace(strUrl, rspEntry);
+
4185
+
4186 return rspEntry;
+
4187}
+
4188
+
4189bool
+
4190NetworkOPsImp::tryRemoveRpcSub(std::string const& strUrl)
+
4191{
+
4192 std::lock_guard sl(mSubLock);
+
4193 auto pInfo = findRpcSub(strUrl);
+
4194
+
4195 if (!pInfo)
+
4196 return false;
+
4197
+
4198 // check to see if any of the stream maps still hold a weak reference to
+
4199 // this entry before removing
+
4200 for (SubMapType const& map : mStreamMaps)
+
4201 {
+
4202 if (map.find(pInfo->getSeq()) != map.end())
+
4203 return false;
+
4204 }
+
4205 mRpcSubMap.erase(strUrl);
+
4206 return true;
+
4207}
+
4208
+
4209#ifndef USE_NEW_BOOK_PAGE
+
4210
+
4211// NIKB FIXME this should be looked at. There's no reason why this shouldn't
+
4212// work, but it demonstrated poor performance.
+
4213//
+
4214void
+
4215NetworkOPsImp::getBookPage(
+
4216 std::shared_ptr<ReadView const>& lpLedger,
+
4217 Book const& book,
+
4218 AccountID const& uTakerID,
+
4219 bool const bProof,
+
4220 unsigned int iLimit,
+
4221 Json::Value const& jvMarker,
+
4222 Json::Value& jvResult)
+
4223{ // CAUTION: This is the old get book page logic
+
4224 Json::Value& jvOffers =
+
4225 (jvResult[jss::offers] = Json::Value(Json::arrayValue));
+
4226
+
4227 std::unordered_map<AccountID, STAmount> umBalance;
+
4228 const uint256 uBookBase = getBookBase(book);
+
4229 const uint256 uBookEnd = getQualityNext(uBookBase);
+
4230 uint256 uTipIndex = uBookBase;
+
4231
+
4232 if (auto stream = m_journal.trace())
+
4233 {
+
4234 stream << "getBookPage:" << book;
+
4235 stream << "getBookPage: uBookBase=" << uBookBase;
+
4236 stream << "getBookPage: uBookEnd=" << uBookEnd;
+
4237 stream << "getBookPage: uTipIndex=" << uTipIndex;
+
4238 }
+
4239
+
4240 ReadView const& view = *lpLedger;
+
4241
+
4242 bool const bGlobalFreeze = isGlobalFrozen(view, book.out.account) ||
+
4243 isGlobalFrozen(view, book.in.account);
+
4244
+
4245 bool bDone = false;
+
4246 bool bDirectAdvance = true;
+
4247
+
4248 std::shared_ptr<SLE const> sleOfferDir;
+
4249 uint256 offerIndex;
+
4250 unsigned int uBookEntry;
+
4251 STAmount saDirRate;
4252
-
4253 cdirFirst(view, uTipIndex, sleOfferDir, uBookEntry, offerIndex);
-
4254
-
4255 JLOG(m_journal.trace())
-
4256 << "getBookPage: uTipIndex=" << uTipIndex;
-
4257 JLOG(m_journal.trace())
-
4258 << "getBookPage: offerIndex=" << offerIndex;
-
4259 }
-
4260 }
+
4253 auto const rate = transferRate(view, book.out.account);
+
4254 auto viewJ = app_.journal("View");
+
4255
+
4256 while (!bDone && iLimit-- > 0)
+
4257 {
+
4258 if (bDirectAdvance)
+
4259 {
+
4260 bDirectAdvance = false;
4261
-
4262 if (!bDone)
-
4263 {
-
4264 auto sleOffer = view.read(keylet::offer(offerIndex));
-
4265
-
4266 if (sleOffer)
-
4267 {
-
4268 auto const uOfferOwnerID = sleOffer->getAccountID(sfAccount);
-
4269 auto const& saTakerGets = sleOffer->getFieldAmount(sfTakerGets);
-
4270 auto const& saTakerPays = sleOffer->getFieldAmount(sfTakerPays);
-
4271 STAmount saOwnerFunds;
-
4272 bool firstOwnerOffer(true);
-
4273
-
4274 if (book.out.account == uOfferOwnerID)
-
4275 {
-
4276 // If an offer is selling issuer's own IOUs, it is fully
-
4277 // funded.
-
4278 saOwnerFunds = saTakerGets;
-
4279 }
-
4280 else if (bGlobalFreeze)
-
4281 {
-
4282 // If either asset is globally frozen, consider all offers
-
4283 // that aren't ours to be totally unfunded
-
4284 saOwnerFunds.clear(book.out);
-
4285 }
-
4286 else
-
4287 {
-
4288 auto umBalanceEntry = umBalance.find(uOfferOwnerID);
-
4289 if (umBalanceEntry != umBalance.end())
-
4290 {
-
4291 // Found in running balance table.
+
4262 JLOG(m_journal.trace()) << "getBookPage: bDirectAdvance";
+
4263
+
4264 auto const ledgerIndex = view.succ(uTipIndex, uBookEnd);
+
4265 if (ledgerIndex)
+
4266 sleOfferDir = view.read(keylet::page(*ledgerIndex));
+
4267 else
+
4268 sleOfferDir.reset();
+
4269
+
4270 if (!sleOfferDir)
+
4271 {
+
4272 JLOG(m_journal.trace()) << "getBookPage: bDone";
+
4273 bDone = true;
+
4274 }
+
4275 else
+
4276 {
+
4277 uTipIndex = sleOfferDir->key();
+
4278 saDirRate = amountFromQuality(getQuality(uTipIndex));
+
4279
+
4280 cdirFirst(view, uTipIndex, sleOfferDir, uBookEntry, offerIndex);
+
4281
+
4282 JLOG(m_journal.trace())
+
4283 << "getBookPage: uTipIndex=" << uTipIndex;
+
4284 JLOG(m_journal.trace())
+
4285 << "getBookPage: offerIndex=" << offerIndex;
+
4286 }
+
4287 }
+
4288
+
4289 if (!bDone)
+
4290 {
+
4291 auto sleOffer = view.read(keylet::offer(offerIndex));
4292
-
4293 saOwnerFunds = umBalanceEntry->second;
-
4294 firstOwnerOffer = false;
-
4295 }
-
4296 else
-
4297 {
-
4298 // Did not find balance in table.
-
4299
-
4300 saOwnerFunds = accountHolds(
-
4301 view,
-
4302 uOfferOwnerID,
-
4303 book.out.currency,
-
4304 book.out.account,
-
4305 fhZERO_IF_FROZEN,
-
4306 viewJ);
-
4307
-
4308 if (saOwnerFunds < beast::zero)
-
4309 {
-
4310 // Treat negative funds as zero.
-
4311
-
4312 saOwnerFunds.clear();
-
4313 }
-
4314 }
-
4315 }
-
4316
-
4317 Json::Value jvOffer = sleOffer->getJson(JsonOptions::none);
-
4318
-
4319 STAmount saTakerGetsFunded;
-
4320 STAmount saOwnerFundsLimit = saOwnerFunds;
-
4321 Rate offerRate = parityRate;
-
4322
-
4323 if (rate != parityRate
-
4324 // Have a tranfer fee.
-
4325 && uTakerID != book.out.account
-
4326 // Not taking offers of own IOUs.
-
4327 && book.out.account != uOfferOwnerID)
-
4328 // Offer owner not issuing ownfunds
-
4329 {
-
4330 // Need to charge a transfer fee to offer owner.
-
4331 offerRate = rate;
-
4332 saOwnerFundsLimit = divide(saOwnerFunds, offerRate);
-
4333 }
+
4293 if (sleOffer)
+
4294 {
+
4295 auto const uOfferOwnerID = sleOffer->getAccountID(sfAccount);
+
4296 auto const& saTakerGets = sleOffer->getFieldAmount(sfTakerGets);
+
4297 auto const& saTakerPays = sleOffer->getFieldAmount(sfTakerPays);
+
4298 STAmount saOwnerFunds;
+
4299 bool firstOwnerOffer(true);
+
4300
+
4301 if (book.out.account == uOfferOwnerID)
+
4302 {
+
4303 // If an offer is selling issuer's own IOUs, it is fully
+
4304 // funded.
+
4305 saOwnerFunds = saTakerGets;
+
4306 }
+
4307 else if (bGlobalFreeze)
+
4308 {
+
4309 // If either asset is globally frozen, consider all offers
+
4310 // that aren't ours to be totally unfunded
+
4311 saOwnerFunds.clear(book.out);
+
4312 }
+
4313 else
+
4314 {
+
4315 auto umBalanceEntry = umBalance.find(uOfferOwnerID);
+
4316 if (umBalanceEntry != umBalance.end())
+
4317 {
+
4318 // Found in running balance table.
+
4319
+
4320 saOwnerFunds = umBalanceEntry->second;
+
4321 firstOwnerOffer = false;
+
4322 }
+
4323 else
+
4324 {
+
4325 // Did not find balance in table.
+
4326
+
4327 saOwnerFunds = accountHolds(
+
4328 view,
+
4329 uOfferOwnerID,
+
4330 book.out.currency,
+
4331 book.out.account,
+
4332 fhZERO_IF_FROZEN,
+
4333 viewJ);
4334
-
4335 if (saOwnerFundsLimit >= saTakerGets)
-
4336 {
-
4337 // Sufficient funds no shenanigans.
-
4338 saTakerGetsFunded = saTakerGets;
-
4339 }
-
4340 else
-
4341 {
-
4342 // Only provide, if not fully funded.
+
4335 if (saOwnerFunds < beast::zero)
+
4336 {
+
4337 // Treat negative funds as zero.
+
4338
+
4339 saOwnerFunds.clear();
+
4340 }
+
4341 }
+
4342 }
4343
-
4344 saTakerGetsFunded = saOwnerFundsLimit;
+
4344 Json::Value jvOffer = sleOffer->getJson(JsonOptions::none);
4345
-
4346 saTakerGetsFunded.setJson(jvOffer[jss::taker_gets_funded]);
-
4347 std::min(
-
4348 saTakerPays,
-
4349 multiply(
-
4350 saTakerGetsFunded, saDirRate, saTakerPays.issue()))
-
4351 .setJson(jvOffer[jss::taker_pays_funded]);
-
4352 }
-
4353
-
4354 STAmount saOwnerPays = (parityRate == offerRate)
-
4355 ? saTakerGetsFunded
-
4356 : std::min(
-
4357 saOwnerFunds, multiply(saTakerGetsFunded, offerRate));
-
4358
-
4359 umBalance[uOfferOwnerID] = saOwnerFunds - saOwnerPays;
-
4360
-
4361 // Include all offers funded and unfunded
-
4362 Json::Value& jvOf = jvOffers.append(jvOffer);
-
4363 jvOf[jss::quality] = saDirRate.getText();
-
4364
-
4365 if (firstOwnerOffer)
-
4366 jvOf[jss::owner_funds] = saOwnerFunds.getText();
-
4367 }
-
4368 else
-
4369 {
-
4370 JLOG(m_journal.warn()) << "Missing offer";
-
4371 }
+
4346 STAmount saTakerGetsFunded;
+
4347 STAmount saOwnerFundsLimit = saOwnerFunds;
+
4348 Rate offerRate = parityRate;
+
4349
+
4350 if (rate != parityRate
+
4351 // Have a tranfer fee.
+
4352 && uTakerID != book.out.account
+
4353 // Not taking offers of own IOUs.
+
4354 && book.out.account != uOfferOwnerID)
+
4355 // Offer owner not issuing ownfunds
+
4356 {
+
4357 // Need to charge a transfer fee to offer owner.
+
4358 offerRate = rate;
+
4359 saOwnerFundsLimit = divide(saOwnerFunds, offerRate);
+
4360 }
+
4361
+
4362 if (saOwnerFundsLimit >= saTakerGets)
+
4363 {
+
4364 // Sufficient funds no shenanigans.
+
4365 saTakerGetsFunded = saTakerGets;
+
4366 }
+
4367 else
+
4368 {
+
4369 // Only provide, if not fully funded.
+
4370
+
4371 saTakerGetsFunded = saOwnerFundsLimit;
4372
-
4373 if (!cdirNext(view, uTipIndex, sleOfferDir, uBookEntry, offerIndex))
-
4374 {
-
4375 bDirectAdvance = true;
-
4376 }
-
4377 else
-
4378 {
-
4379 JLOG(m_journal.trace())
-
4380 << "getBookPage: offerIndex=" << offerIndex;
-
4381 }
-
4382 }
-
4383 }
-
4384
-
4385 // jvResult[jss::marker] = Json::Value(Json::arrayValue);
-
4386 // jvResult[jss::nodes] = Json::Value(Json::arrayValue);
-
4387}
-
4388
-
4389#else
-
4390
-
4391// This is the new code that uses the book iterators
-
4392// It has temporarily been disabled
-
4393
-
4394void
-
4395NetworkOPsImp::getBookPage(
-
4396 std::shared_ptr<ReadView const> lpLedger,
-
4397 Book const& book,
-
4398 AccountID const& uTakerID,
-
4399 bool const bProof,
-
4400 unsigned int iLimit,
-
4401 Json::Value const& jvMarker,
-
4402 Json::Value& jvResult)
-
4403{
-
4404 auto& jvOffers = (jvResult[jss::offers] = Json::Value(Json::arrayValue));
-
4405
-
4406 std::map<AccountID, STAmount> umBalance;
-
4407
-
4408 MetaView lesActive(lpLedger, tapNONE, true);
-
4409 OrderBookIterator obIterator(lesActive, book);
-
4410
-
4411 auto const rate = transferRate(lesActive, book.out.account);
-
4412
-
4413 const bool bGlobalFreeze = lesActive.isGlobalFrozen(book.out.account) ||
-
4414 lesActive.isGlobalFrozen(book.in.account);
+
4373 saTakerGetsFunded.setJson(jvOffer[jss::taker_gets_funded]);
+
4374 std::min(
+
4375 saTakerPays,
+
4376 multiply(
+
4377 saTakerGetsFunded, saDirRate, saTakerPays.issue()))
+
4378 .setJson(jvOffer[jss::taker_pays_funded]);
+
4379 }
+
4380
+
4381 STAmount saOwnerPays = (parityRate == offerRate)
+
4382 ? saTakerGetsFunded
+
4383 : std::min(
+
4384 saOwnerFunds, multiply(saTakerGetsFunded, offerRate));
+
4385
+
4386 umBalance[uOfferOwnerID] = saOwnerFunds - saOwnerPays;
+
4387
+
4388 // Include all offers funded and unfunded
+
4389 Json::Value& jvOf = jvOffers.append(jvOffer);
+
4390 jvOf[jss::quality] = saDirRate.getText();
+
4391
+
4392 if (firstOwnerOffer)
+
4393 jvOf[jss::owner_funds] = saOwnerFunds.getText();
+
4394 }
+
4395 else
+
4396 {
+
4397 JLOG(m_journal.warn()) << "Missing offer";
+
4398 }
+
4399
+
4400 if (!cdirNext(view, uTipIndex, sleOfferDir, uBookEntry, offerIndex))
+
4401 {
+
4402 bDirectAdvance = true;
+
4403 }
+
4404 else
+
4405 {
+
4406 JLOG(m_journal.trace())
+
4407 << "getBookPage: offerIndex=" << offerIndex;
+
4408 }
+
4409 }
+
4410 }
+
4411
+
4412 // jvResult[jss::marker] = Json::Value(Json::arrayValue);
+
4413 // jvResult[jss::nodes] = Json::Value(Json::arrayValue);
+
4414}
4415
-
4416 while (iLimit-- > 0 && obIterator.nextOffer())
-
4417 {
-
4418 SLE::pointer sleOffer = obIterator.getCurrentOffer();
-
4419 if (sleOffer)
-
4420 {
-
4421 auto const uOfferOwnerID = sleOffer->getAccountID(sfAccount);
-
4422 auto const& saTakerGets = sleOffer->getFieldAmount(sfTakerGets);
-
4423 auto const& saTakerPays = sleOffer->getFieldAmount(sfTakerPays);
-
4424 STAmount saDirRate = obIterator.getCurrentRate();
-
4425 STAmount saOwnerFunds;
-
4426
-
4427 if (book.out.account == uOfferOwnerID)
-
4428 {
-
4429 // If offer is selling issuer's own IOUs, it is fully funded.
-
4430 saOwnerFunds = saTakerGets;
-
4431 }
-
4432 else if (bGlobalFreeze)
-
4433 {
-
4434 // If either asset is globally frozen, consider all offers
-
4435 // that aren't ours to be totally unfunded
-
4436 saOwnerFunds.clear(book.out);
-
4437 }
-
4438 else
-
4439 {
-
4440 auto umBalanceEntry = umBalance.find(uOfferOwnerID);
-
4441
-
4442 if (umBalanceEntry != umBalance.end())
-
4443 {
-
4444 // Found in running balance table.
-
4445
-
4446 saOwnerFunds = umBalanceEntry->second;
-
4447 }
-
4448 else
-
4449 {
-
4450 // Did not find balance in table.
-
4451
-
4452 saOwnerFunds = lesActive.accountHolds(
-
4453 uOfferOwnerID,
-
4454 book.out.currency,
-
4455 book.out.account,
-
4456 fhZERO_IF_FROZEN);
-
4457
-
4458 if (saOwnerFunds.isNegative())
-
4459 {
-
4460 // Treat negative funds as zero.
-
4461
-
4462 saOwnerFunds.zero();
-
4463 }
-
4464 }
-
4465 }
-
4466
-
4467 Json::Value jvOffer = sleOffer->getJson(JsonOptions::none);
+
4416#else
+
4417
+
4418// This is the new code that uses the book iterators
+
4419// It has temporarily been disabled
+
4420
+
4421void
+
4422NetworkOPsImp::getBookPage(
+
4423 std::shared_ptr<ReadView const> lpLedger,
+
4424 Book const& book,
+
4425 AccountID const& uTakerID,
+
4426 bool const bProof,
+
4427 unsigned int iLimit,
+
4428 Json::Value const& jvMarker,
+
4429 Json::Value& jvResult)
+
4430{
+
4431 auto& jvOffers = (jvResult[jss::offers] = Json::Value(Json::arrayValue));
+
4432
+
4433 std::map<AccountID, STAmount> umBalance;
+
4434
+
4435 MetaView lesActive(lpLedger, tapNONE, true);
+
4436 OrderBookIterator obIterator(lesActive, book);
+
4437
+
4438 auto const rate = transferRate(lesActive, book.out.account);
+
4439
+
4440 const bool bGlobalFreeze = lesActive.isGlobalFrozen(book.out.account) ||
+
4441 lesActive.isGlobalFrozen(book.in.account);
+
4442
+
4443 while (iLimit-- > 0 && obIterator.nextOffer())
+
4444 {
+
4445 SLE::pointer sleOffer = obIterator.getCurrentOffer();
+
4446 if (sleOffer)
+
4447 {
+
4448 auto const uOfferOwnerID = sleOffer->getAccountID(sfAccount);
+
4449 auto const& saTakerGets = sleOffer->getFieldAmount(sfTakerGets);
+
4450 auto const& saTakerPays = sleOffer->getFieldAmount(sfTakerPays);
+
4451 STAmount saDirRate = obIterator.getCurrentRate();
+
4452 STAmount saOwnerFunds;
+
4453
+
4454 if (book.out.account == uOfferOwnerID)
+
4455 {
+
4456 // If offer is selling issuer's own IOUs, it is fully funded.
+
4457 saOwnerFunds = saTakerGets;
+
4458 }
+
4459 else if (bGlobalFreeze)
+
4460 {
+
4461 // If either asset is globally frozen, consider all offers
+
4462 // that aren't ours to be totally unfunded
+
4463 saOwnerFunds.clear(book.out);
+
4464 }
+
4465 else
+
4466 {
+
4467 auto umBalanceEntry = umBalance.find(uOfferOwnerID);
4468
-
4469 STAmount saTakerGetsFunded;
-
4470 STAmount saOwnerFundsLimit = saOwnerFunds;
-
4471 Rate offerRate = parityRate;
+
4469 if (umBalanceEntry != umBalance.end())
+
4470 {
+
4471 // Found in running balance table.
4472
-
4473 if (rate != parityRate
-
4474 // Have a tranfer fee.
-
4475 && uTakerID != book.out.account
-
4476 // Not taking offers of own IOUs.
-
4477 && book.out.account != uOfferOwnerID)
-
4478 // Offer owner not issuing ownfunds
-
4479 {
-
4480 // Need to charge a transfer fee to offer owner.
-
4481 offerRate = rate;
-
4482 saOwnerFundsLimit = divide(saOwnerFunds, offerRate);
-
4483 }
+
4473 saOwnerFunds = umBalanceEntry->second;
+
4474 }
+
4475 else
+
4476 {
+
4477 // Did not find balance in table.
+
4478
+
4479 saOwnerFunds = lesActive.accountHolds(
+
4480 uOfferOwnerID,
+
4481 book.out.currency,
+
4482 book.out.account,
+
4483 fhZERO_IF_FROZEN);
4484
-
4485 if (saOwnerFundsLimit >= saTakerGets)
-
4486 {
-
4487 // Sufficient funds no shenanigans.
-
4488 saTakerGetsFunded = saTakerGets;
-
4489 }
-
4490 else
-
4491 {
-
4492 // Only provide, if not fully funded.
-
4493 saTakerGetsFunded = saOwnerFundsLimit;
-
4494
-
4495 saTakerGetsFunded.setJson(jvOffer[jss::taker_gets_funded]);
-
4496
-
4497 // TOOD(tom): The result of this expression is not used - what's
-
4498 // going on here?
-
4499 std::min(
-
4500 saTakerPays,
-
4501 multiply(saTakerGetsFunded, saDirRate, saTakerPays.issue()))
-
4502 .setJson(jvOffer[jss::taker_pays_funded]);
-
4503 }
-
4504
-
4505 STAmount saOwnerPays = (parityRate == offerRate)
-
4506 ? saTakerGetsFunded
-
4507 : std::min(
-
4508 saOwnerFunds, multiply(saTakerGetsFunded, offerRate));
-
4509
-
4510 umBalance[uOfferOwnerID] = saOwnerFunds - saOwnerPays;
+
4485 if (saOwnerFunds.isNegative())
+
4486 {
+
4487 // Treat negative funds as zero.
+
4488
+
4489 saOwnerFunds.zero();
+
4490 }
+
4491 }
+
4492 }
+
4493
+
4494 Json::Value jvOffer = sleOffer->getJson(JsonOptions::none);
+
4495
+
4496 STAmount saTakerGetsFunded;
+
4497 STAmount saOwnerFundsLimit = saOwnerFunds;
+
4498 Rate offerRate = parityRate;
+
4499
+
4500 if (rate != parityRate
+
4501 // Have a tranfer fee.
+
4502 && uTakerID != book.out.account
+
4503 // Not taking offers of own IOUs.
+
4504 && book.out.account != uOfferOwnerID)
+
4505 // Offer owner not issuing ownfunds
+
4506 {
+
4507 // Need to charge a transfer fee to offer owner.
+
4508 offerRate = rate;
+
4509 saOwnerFundsLimit = divide(saOwnerFunds, offerRate);
+
4510 }
4511
-
4512 if (!saOwnerFunds.isZero() || uOfferOwnerID == uTakerID)
+
4512 if (saOwnerFundsLimit >= saTakerGets)
4513 {
-
4514 // Only provide funded offers and offers of the taker.
-
4515 Json::Value& jvOf = jvOffers.append(jvOffer);
-
4516 jvOf[jss::quality] = saDirRate.getText();
-
4517 }
-
4518 }
-
4519 }
-
4520
-
4521 // jvResult[jss::marker] = Json::Value(Json::arrayValue);
-
4522 // jvResult[jss::nodes] = Json::Value(Json::arrayValue);
-
4523}
-
4524
-
4525#endif
-
4526
-
4527inline void
-
4528NetworkOPsImp::collect_metrics()
-
4529{
-
4530 auto [counters, mode, start, initialSync] = accounting_.getCounterData();
-
4531 auto const current = std::chrono::duration_cast<std::chrono::microseconds>(
-
4532 std::chrono::steady_clock::now() - start);
-
4533 counters[static_cast<std::size_t>(mode)].dur += current;
-
4534
-
4535 std::lock_guard lock(m_statsMutex);
-
4536 m_stats.disconnected_duration.set(
-
4537 counters[static_cast<std::size_t>(OperatingMode::DISCONNECTED)]
-
4538 .dur.count());
-
4539 m_stats.connected_duration.set(
-
4540 counters[static_cast<std::size_t>(OperatingMode::CONNECTED)]
-
4541 .dur.count());
-
4542 m_stats.syncing_duration.set(
-
4543 counters[static_cast<std::size_t>(OperatingMode::SYNCING)].dur.count());
-
4544 m_stats.tracking_duration.set(
-
4545 counters[static_cast<std::size_t>(OperatingMode::TRACKING)]
-
4546 .dur.count());
-
4547 m_stats.full_duration.set(
-
4548 counters[static_cast<std::size_t>(OperatingMode::FULL)].dur.count());
-
4549
-
4550 m_stats.disconnected_transitions.set(
-
4551 counters[static_cast<std::size_t>(OperatingMode::DISCONNECTED)]
-
4552 .transitions);
-
4553 m_stats.connected_transitions.set(
-
4554 counters[static_cast<std::size_t>(OperatingMode::CONNECTED)]
-
4555 .transitions);
-
4556 m_stats.syncing_transitions.set(
-
4557 counters[static_cast<std::size_t>(OperatingMode::SYNCING)].transitions);
-
4558 m_stats.tracking_transitions.set(
-
4559 counters[static_cast<std::size_t>(OperatingMode::TRACKING)]
-
4560 .transitions);
-
4561 m_stats.full_transitions.set(
-
4562 counters[static_cast<std::size_t>(OperatingMode::FULL)].transitions);
-
4563}
-
4564
-
4565void
-
4566NetworkOPsImp::StateAccounting::mode(OperatingMode om)
-
4567{
-
4568 auto now = std::chrono::steady_clock::now();
-
4569
-
4570 std::lock_guard lock(mutex_);
-
4571 ++counters_[static_cast<std::size_t>(om)].transitions;
-
4572 if (om == OperatingMode::FULL &&
-
4573 counters_[static_cast<std::size_t>(om)].transitions == 1)
-
4574 {
-
4575 initialSyncUs_ = std::chrono::duration_cast<std::chrono::microseconds>(
-
4576 now - processStart_)
-
4577 .count();
-
4578 }
-
4579 counters_[static_cast<std::size_t>(mode_)].dur +=
-
4580 std::chrono::duration_cast<std::chrono::microseconds>(now - start_);
-
4581
-
4582 mode_ = om;
-
4583 start_ = now;
-
4584}
-
4585
-
4586void
-
4587NetworkOPsImp::StateAccounting::json(Json::Value& obj) const
-
4588{
-
4589 auto [counters, mode, start, initialSync] = getCounterData();
-
4590 auto const current = std::chrono::duration_cast<std::chrono::microseconds>(
-
4591 std::chrono::steady_clock::now() - start);
-
4592 counters[static_cast<std::size_t>(mode)].dur += current;
-
4593
-
4594 obj[jss::state_accounting] = Json::objectValue;
-
4595 for (std::size_t i = static_cast<std::size_t>(OperatingMode::DISCONNECTED);
-
4596 i <= static_cast<std::size_t>(OperatingMode::FULL);
-
4597 ++i)
-
4598 {
-
4599 obj[jss::state_accounting][states_[i]] = Json::objectValue;
-
4600 auto& state = obj[jss::state_accounting][states_[i]];
-
4601 state[jss::transitions] = std::to_string(counters[i].transitions);
-
4602 state[jss::duration_us] = std::to_string(counters[i].dur.count());
-
4603 }
-
4604 obj[jss::server_state_duration_us] = std::to_string(current.count());
-
4605 if (initialSync)
-
4606 obj[jss::initial_sync_duration_us] = std::to_string(initialSync);
-
4607}
+
4514 // Sufficient funds no shenanigans.
+
4515 saTakerGetsFunded = saTakerGets;
+
4516 }
+
4517 else
+
4518 {
+
4519 // Only provide, if not fully funded.
+
4520 saTakerGetsFunded = saOwnerFundsLimit;
+
4521
+
4522 saTakerGetsFunded.setJson(jvOffer[jss::taker_gets_funded]);
+
4523
+
4524 // TOOD(tom): The result of this expression is not used - what's
+
4525 // going on here?
+
4526 std::min(
+
4527 saTakerPays,
+
4528 multiply(saTakerGetsFunded, saDirRate, saTakerPays.issue()))
+
4529 .setJson(jvOffer[jss::taker_pays_funded]);
+
4530 }
+
4531
+
4532 STAmount saOwnerPays = (parityRate == offerRate)
+
4533 ? saTakerGetsFunded
+
4534 : std::min(
+
4535 saOwnerFunds, multiply(saTakerGetsFunded, offerRate));
+
4536
+
4537 umBalance[uOfferOwnerID] = saOwnerFunds - saOwnerPays;
+
4538
+
4539 if (!saOwnerFunds.isZero() || uOfferOwnerID == uTakerID)
+
4540 {
+
4541 // Only provide funded offers and offers of the taker.
+
4542 Json::Value& jvOf = jvOffers.append(jvOffer);
+
4543 jvOf[jss::quality] = saDirRate.getText();
+
4544 }
+
4545 }
+
4546 }
+
4547
+
4548 // jvResult[jss::marker] = Json::Value(Json::arrayValue);
+
4549 // jvResult[jss::nodes] = Json::Value(Json::arrayValue);
+
4550}
+
4551
+
4552#endif
+
4553
+
4554inline void
+
4555NetworkOPsImp::collect_metrics()
+
4556{
+
4557 auto [counters, mode, start, initialSync] = accounting_.getCounterData();
+
4558 auto const current = std::chrono::duration_cast<std::chrono::microseconds>(
+
4559 std::chrono::steady_clock::now() - start);
+
4560 counters[static_cast<std::size_t>(mode)].dur += current;
+
4561
+
4562 std::lock_guard lock(m_statsMutex);
+
4563 m_stats.disconnected_duration.set(
+
4564 counters[static_cast<std::size_t>(OperatingMode::DISCONNECTED)]
+
4565 .dur.count());
+
4566 m_stats.connected_duration.set(
+
4567 counters[static_cast<std::size_t>(OperatingMode::CONNECTED)]
+
4568 .dur.count());
+
4569 m_stats.syncing_duration.set(
+
4570 counters[static_cast<std::size_t>(OperatingMode::SYNCING)].dur.count());
+
4571 m_stats.tracking_duration.set(
+
4572 counters[static_cast<std::size_t>(OperatingMode::TRACKING)]
+
4573 .dur.count());
+
4574 m_stats.full_duration.set(
+
4575 counters[static_cast<std::size_t>(OperatingMode::FULL)].dur.count());
+
4576
+
4577 m_stats.disconnected_transitions.set(
+
4578 counters[static_cast<std::size_t>(OperatingMode::DISCONNECTED)]
+
4579 .transitions);
+
4580 m_stats.connected_transitions.set(
+
4581 counters[static_cast<std::size_t>(OperatingMode::CONNECTED)]
+
4582 .transitions);
+
4583 m_stats.syncing_transitions.set(
+
4584 counters[static_cast<std::size_t>(OperatingMode::SYNCING)].transitions);
+
4585 m_stats.tracking_transitions.set(
+
4586 counters[static_cast<std::size_t>(OperatingMode::TRACKING)]
+
4587 .transitions);
+
4588 m_stats.full_transitions.set(
+
4589 counters[static_cast<std::size_t>(OperatingMode::FULL)].transitions);
+
4590}
+
4591
+
4592void
+
4593NetworkOPsImp::StateAccounting::mode(OperatingMode om)
+
4594{
+
4595 auto now = std::chrono::steady_clock::now();
+
4596
+
4597 std::lock_guard lock(mutex_);
+
4598 ++counters_[static_cast<std::size_t>(om)].transitions;
+
4599 if (om == OperatingMode::FULL &&
+
4600 counters_[static_cast<std::size_t>(om)].transitions == 1)
+
4601 {
+
4602 initialSyncUs_ = std::chrono::duration_cast<std::chrono::microseconds>(
+
4603 now - processStart_)
+
4604 .count();
+
4605 }
+
4606 counters_[static_cast<std::size_t>(mode_)].dur +=
+
4607 std::chrono::duration_cast<std::chrono::microseconds>(now - start_);
4608
-
4609//------------------------------------------------------------------------------
-
4610
-
4611std::unique_ptr<NetworkOPs>
-
4612make_NetworkOPs(
-
4613 Application& app,
-
4614 NetworkOPs::clock_type& clock,
-
4615 bool standalone,
-
4616 std::size_t minPeerCount,
-
4617 bool startvalid,
-
4618 JobQueue& job_queue,
-
4619 LedgerMaster& ledgerMaster,
-
4620 ValidatorKeys const& validatorKeys,
-
4621 boost::asio::io_service& io_svc,
-
4622 beast::Journal journal,
-
4623 beast::insight::Collector::ptr const& collector)
-
4624{
-
4625 return std::make_unique<NetworkOPsImp>(
-
4626 app,
-
4627 clock,
-
4628 standalone,
-
4629 minPeerCount,
-
4630 startvalid,
-
4631 job_queue,
-
4632 ledgerMaster,
-
4633 validatorKeys,
-
4634 io_svc,
-
4635 journal,
-
4636 collector);
-
4637}
-
4638
-
4639} // namespace ripple
+
4609 mode_ = om;
+
4610 start_ = now;
+
4611}
+
4612
+
4613void
+
4614NetworkOPsImp::StateAccounting::json(Json::Value& obj) const
+
4615{
+
4616 auto [counters, mode, start, initialSync] = getCounterData();
+
4617 auto const current = std::chrono::duration_cast<std::chrono::microseconds>(
+
4618 std::chrono::steady_clock::now() - start);
+
4619 counters[static_cast<std::size_t>(mode)].dur += current;
+
4620
+
4621 obj[jss::state_accounting] = Json::objectValue;
+
4622 for (std::size_t i = static_cast<std::size_t>(OperatingMode::DISCONNECTED);
+
4623 i <= static_cast<std::size_t>(OperatingMode::FULL);
+
4624 ++i)
+
4625 {
+
4626 obj[jss::state_accounting][states_[i]] = Json::objectValue;
+
4627 auto& state = obj[jss::state_accounting][states_[i]];
+
4628 state[jss::transitions] = std::to_string(counters[i].transitions);
+
4629 state[jss::duration_us] = std::to_string(counters[i].dur.count());
+
4630 }
+
4631 obj[jss::server_state_duration_us] = std::to_string(current.count());
+
4632 if (initialSync)
+
4633 obj[jss::initial_sync_duration_us] = std::to_string(initialSync);
+
4634}
+
4635
+
4636//------------------------------------------------------------------------------
+
4637
+
4638std::unique_ptr<NetworkOPs>
+
4639make_NetworkOPs(
+
4640 Application& app,
+
4641 NetworkOPs::clock_type& clock,
+
4642 bool standalone,
+
4643 std::size_t minPeerCount,
+
4644 bool startvalid,
+
4645 JobQueue& job_queue,
+
4646 LedgerMaster& ledgerMaster,
+
4647 ValidatorKeys const& validatorKeys,
+
4648 boost::asio::io_service& io_svc,
+
4649 beast::Journal journal,
+
4650 beast::insight::Collector::ptr const& collector)
+
4651{
+
4652 return std::make_unique<NetworkOPsImp>(
+
4653 app,
+
4654 clock,
+
4655 standalone,
+
4656 minPeerCount,
+
4657 startvalid,
+
4658 job_queue,
+
4659 ledgerMaster,
+
4660 validatorKeys,
+
4661 io_svc,
+
4662 journal,
+
4663 collector);
+
4664}
+
4665
+
4666} // namespace ripple
@@ -4658,6 +4685,7 @@ $(function() {
std::begin
T begin(T... args)
+
std::bind
T bind(T... args)
Json::Compact
Decorator for streaming out compact json.
Definition: json_writer.h:318
Json::StaticString
Lightweight wrapper to tag static string.
Definition: json_value.h:62
Json::Value
Represents a JSON value.
Definition: json_value.h:148
@@ -4750,174 +4778,176 @@ $(function() {
ripple::LoadManager
Manages load sources.
Definition: LoadManager.h:46
ripple::LoadManager::heartbeat
void heartbeat()
Reset the stall detection timer.
Definition: LoadManager.cpp:64
ripple::ManifestCache::getMasterKey
PublicKey getMasterKey(PublicKey const &pk) const
Returns ephemeral signing key's master public key.
Definition: app/misc/detail/Manifest.cpp:323
-
ripple::NetworkOPsImp::StateAccounting
State accounting records two attributes for each possible server state: 1) Amount of time spent in ea...
Definition: NetworkOPs.cpp:139
-
ripple::NetworkOPsImp::StateAccounting::mode
void mode(OperatingMode om)
Record state transition.
Definition: NetworkOPs.cpp:4566
-
ripple::NetworkOPsImp::StateAccounting::json
void json(Json::Value &obj) const
Output state counters in JSON format.
Definition: NetworkOPs.cpp:4587
-
ripple::NetworkOPsImp::StateAccounting::counters_
std::array< Counters, 5 > counters_
Definition: NetworkOPs.cpp:149
- - -
ripple::NetworkOPsImp::StateAccounting::start_
std::chrono::steady_clock::time_point start_
Definition: NetworkOPs.cpp:151
- -
ripple::NetworkOPsImp::StateAccounting::states_
static std::array< Json::StaticString const, 5 > const states_
Definition: NetworkOPs.cpp:155
- -
ripple::NetworkOPsImp::StateAccounting::processStart_
std::chrono::steady_clock::time_point const processStart_
Definition: NetworkOPs.cpp:153
- -
ripple::NetworkOPsImp::TransactionStatus
Transaction with input flags and results to be applied in batches.
Definition: NetworkOPs.cpp:90
-
ripple::NetworkOPsImp::TransactionStatus::TransactionStatus
TransactionStatus(std::shared_ptr< Transaction > t, bool a, bool l, FailHard f)
Definition: NetworkOPs.cpp:99
- - -
ripple::NetworkOPsImp::TransactionStatus::transaction
std::shared_ptr< Transaction > const transaction
Definition: NetworkOPs.cpp:92
- - - - - -
ripple::NetworkOPsImp::accountHistoryTxTimer_
boost::asio::steady_timer accountHistoryTxTimer_
Definition: NetworkOPs.cpp:731
-
ripple::NetworkOPsImp::pubProposedTransaction
void pubProposedTransaction(std::shared_ptr< ReadView const > const &ledger, std::shared_ptr< STTx const > const &transaction, TER result) override
Definition: NetworkOPs.cpp:2835
-
ripple::NetworkOPsImp::getOperatingMode
OperatingMode getOperatingMode() const override
Definition: NetworkOPs.cpp:863
-
ripple::NetworkOPsImp::strOperatingMode
std::string strOperatingMode(OperatingMode const mode, bool const admin) const override
Definition: NetworkOPs.cpp:1140
-
ripple::NetworkOPsImp::mTransactions
std::vector< TransactionStatus > mTransactions
Definition: NetworkOPs.cpp:775
-
ripple::NetworkOPsImp::unsubBookChanges
bool unsubBookChanges(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:3981
-
ripple::NetworkOPsImp::mMode
std::atomic< OperatingMode > mMode
Definition: NetworkOPs.cpp:721
- -
ripple::NetworkOPsImp::getLedgerFetchInfo
Json::Value getLedgerFetchInfo() override
Definition: NetworkOPs.cpp:2829
-
ripple::NetworkOPsImp::isUNLBlocked
bool isUNLBlocked() override
Definition: NetworkOPs.cpp:1664
-
ripple::NetworkOPsImp::mConsensus
RCLConsensus mConsensus
Definition: NetworkOPs.cpp:733
-
ripple::NetworkOPsImp::unsubAccount
void unsubAccount(InfoSub::ref ispListener, hash_set< AccountID > const &vnaAccountIDs, bool rt) override
Definition: NetworkOPs.cpp:3425
-
ripple::NetworkOPsImp::getOwnerInfo
Json::Value getOwnerInfo(std::shared_ptr< ReadView const > lpLedger, AccountID const &account) override
Definition: NetworkOPs.cpp:1555
-
ripple::NetworkOPsImp::setNeedNetworkLedger
void setNeedNetworkLedger() override
Definition: NetworkOPs.cpp:881
-
ripple::NetworkOPsImp::setUNLBlocked
void setUNLBlocked() override
Definition: NetworkOPs.cpp:1670
-
ripple::NetworkOPsImp::pubConsensus
void pubConsensus(ConsensusPhase phase)
Definition: NetworkOPs.cpp:2158
-
ripple::NetworkOPsImp::transactionBatch
void transactionBatch()
Apply transactions in batches.
Definition: NetworkOPs.cpp:1330
-
ripple::NetworkOPsImp::apply
void apply(std::unique_lock< std::mutex > &batchLock)
Attempt to apply transactions and post-process based on the results.
Definition: NetworkOPs.cpp:1344
-
ripple::NetworkOPsImp::setAmendmentBlocked
void setAmendmentBlocked() override
Definition: NetworkOPs.cpp:1639
-
ripple::NetworkOPsImp::processTransaction
void processTransaction(std::shared_ptr< Transaction > &transaction, bool bUnlimited, bool bLocal, FailHard failType) override
Process transactions as they arrive from the network or which are submitted by clients.
Definition: NetworkOPs.cpp:1214
- - - - - - - - - - - -
ripple::NetworkOPsImp::clearUNLBlocked
void clearUNLBlocked() override
Definition: NetworkOPs.cpp:1677
-
ripple::NetworkOPsImp::heartbeatTimer_
boost::asio::steady_timer heartbeatTimer_
Definition: NetworkOPs.cpp:729
-
ripple::NetworkOPsImp::updateLocalTx
void updateLocalTx(ReadView const &view) override
Definition: NetworkOPs.cpp:3011
-
ripple::NetworkOPsImp::unsubManifests
bool unsubManifests(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:3999
-
ripple::NetworkOPsImp::DispatchState
DispatchState
Synchronization states for transaction batches.
Definition: NetworkOPs.cpp:116
+
ripple::NetworkOPsImp::StateAccounting
State accounting records two attributes for each possible server state: 1) Amount of time spent in ea...
Definition: NetworkOPs.cpp:140
+
ripple::NetworkOPsImp::StateAccounting::mode
void mode(OperatingMode om)
Record state transition.
Definition: NetworkOPs.cpp:4593
+
ripple::NetworkOPsImp::StateAccounting::json
void json(Json::Value &obj) const
Output state counters in JSON format.
Definition: NetworkOPs.cpp:4614
+
ripple::NetworkOPsImp::StateAccounting::counters_
std::array< Counters, 5 > counters_
Definition: NetworkOPs.cpp:150
+ + +
ripple::NetworkOPsImp::StateAccounting::start_
std::chrono::steady_clock::time_point start_
Definition: NetworkOPs.cpp:152
+ +
ripple::NetworkOPsImp::StateAccounting::states_
static std::array< Json::StaticString const, 5 > const states_
Definition: NetworkOPs.cpp:156
+ +
ripple::NetworkOPsImp::StateAccounting::processStart_
std::chrono::steady_clock::time_point const processStart_
Definition: NetworkOPs.cpp:154
+ +
ripple::NetworkOPsImp::TransactionStatus
Transaction with input flags and results to be applied in batches.
Definition: NetworkOPs.cpp:91
+
ripple::NetworkOPsImp::TransactionStatus::TransactionStatus
TransactionStatus(std::shared_ptr< Transaction > t, bool a, bool l, FailHard f)
Definition: NetworkOPs.cpp:100
+ + +
ripple::NetworkOPsImp::TransactionStatus::transaction
std::shared_ptr< Transaction > const transaction
Definition: NetworkOPs.cpp:93
+ + + + + +
ripple::NetworkOPsImp::accountHistoryTxTimer_
boost::asio::steady_timer accountHistoryTxTimer_
Definition: NetworkOPs.cpp:738
+
ripple::NetworkOPsImp::pubProposedTransaction
void pubProposedTransaction(std::shared_ptr< ReadView const > const &ledger, std::shared_ptr< STTx const > const &transaction, TER result) override
Definition: NetworkOPs.cpp:2862
+
ripple::NetworkOPsImp::getOperatingMode
OperatingMode getOperatingMode() const override
Definition: NetworkOPs.cpp:873
+
ripple::NetworkOPsImp::strOperatingMode
std::string strOperatingMode(OperatingMode const mode, bool const admin) const override
Definition: NetworkOPs.cpp:1150
+
ripple::NetworkOPsImp::mTransactions
std::vector< TransactionStatus > mTransactions
Definition: NetworkOPs.cpp:785
+
ripple::NetworkOPsImp::unsubBookChanges
bool unsubBookChanges(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4008
+
ripple::NetworkOPsImp::mMode
std::atomic< OperatingMode > mMode
Definition: NetworkOPs.cpp:728
+ +
ripple::NetworkOPsImp::getLedgerFetchInfo
Json::Value getLedgerFetchInfo() override
Definition: NetworkOPs.cpp:2856
+
ripple::NetworkOPsImp::isUNLBlocked
bool isUNLBlocked() override
Definition: NetworkOPs.cpp:1674
+
ripple::NetworkOPsImp::mConsensus
RCLConsensus mConsensus
Definition: NetworkOPs.cpp:740
+
ripple::NetworkOPsImp::unsubAccount
void unsubAccount(InfoSub::ref ispListener, hash_set< AccountID > const &vnaAccountIDs, bool rt) override
Definition: NetworkOPs.cpp:3452
+
ripple::NetworkOPsImp::getOwnerInfo
Json::Value getOwnerInfo(std::shared_ptr< ReadView const > lpLedger, AccountID const &account) override
Definition: NetworkOPs.cpp:1565
+
ripple::NetworkOPsImp::setNeedNetworkLedger
void setNeedNetworkLedger() override
Definition: NetworkOPs.cpp:891
+
ripple::NetworkOPsImp::setUNLBlocked
void setUNLBlocked() override
Definition: NetworkOPs.cpp:1680
+
ripple::NetworkOPsImp::pubConsensus
void pubConsensus(ConsensusPhase phase)
Definition: NetworkOPs.cpp:2185
+
ripple::NetworkOPsImp::transactionBatch
void transactionBatch()
Apply transactions in batches.
Definition: NetworkOPs.cpp:1340
+
ripple::NetworkOPsImp::apply
void apply(std::unique_lock< std::mutex > &batchLock)
Attempt to apply transactions and post-process based on the results.
Definition: NetworkOPs.cpp:1354
+
ripple::NetworkOPsImp::setAmendmentBlocked
void setAmendmentBlocked() override
Definition: NetworkOPs.cpp:1649
+
ripple::NetworkOPsImp::processTransaction
void processTransaction(std::shared_ptr< Transaction > &transaction, bool bUnlimited, bool bLocal, FailHard failType) override
Process transactions as they arrive from the network or which are submitted by clients.
Definition: NetworkOPs.cpp:1224
+ + + + + + + + + + + +
ripple::NetworkOPsImp::clearUNLBlocked
void clearUNLBlocked() override
Definition: NetworkOPs.cpp:1687
+
ripple::NetworkOPsImp::heartbeatTimer_
boost::asio::steady_timer heartbeatTimer_
Definition: NetworkOPs.cpp:736
+
ripple::NetworkOPsImp::updateLocalTx
void updateLocalTx(ReadView const &view) override
Definition: NetworkOPs.cpp:3038
+
ripple::NetworkOPsImp::unsubManifests
bool unsubManifests(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4026
+
ripple::NetworkOPsImp::DispatchState
DispatchState
Synchronization states for transaction batches.
Definition: NetworkOPs.cpp:117
-
ripple::NetworkOPsImp::unsubTransactions
bool unsubTransactions(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4055
- -
ripple::NetworkOPsImp::clearAmendmentWarned
void clearAmendmentWarned() override
Definition: NetworkOPs.cpp:1658
-
ripple::NetworkOPsImp::getLocalTxCount
std::size_t getLocalTxCount() override
Definition: NetworkOPs.cpp:3016
-
ripple::NetworkOPsImp::m_localTX
std::unique_ptr< LocalTxs > m_localTX
Definition: NetworkOPs.cpp:717
-
ripple::NetworkOPsImp::subValidations
bool subValidations(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:4081
-
ripple::NetworkOPsImp::subLedger
bool subLedger(InfoSub::ref ispListener, Json::Value &jvResult) override
Definition: NetworkOPs.cpp:3933
-
ripple::NetworkOPsImp::~NetworkOPsImp
~NetworkOPsImp() override
Definition: NetworkOPs.cpp:260
-
ripple::NetworkOPsImp::isAmendmentBlocked
bool isAmendmentBlocked() override
Definition: NetworkOPs.cpp:1633
-
ripple::NetworkOPsImp::unsubAccountHistoryInternal
void unsubAccountHistoryInternal(std::uint64_t seq, AccountID const &account, bool historyOnly) override
Definition: NetworkOPs.cpp:3862
-
ripple::NetworkOPsImp::mSubAccountHistory
SubAccountHistoryMapType mSubAccountHistory
Definition: NetworkOPs.cpp:744
-
ripple::NetworkOPsImp::getBookPage
void getBookPage(std::shared_ptr< ReadView const > &lpLedger, Book const &, AccountID const &uTakerID, const bool bProof, unsigned int iLimit, Json::Value const &jvMarker, Json::Value &jvResult) override
Definition: NetworkOPs.cpp:4188
-
ripple::NetworkOPsImp::getServerInfo
Json::Value getServerInfo(bool human, bool admin, bool counters) override
Definition: NetworkOPs.cpp:2418
-
ripple::NetworkOPsImp::addRpcSub
InfoSub::pointer addRpcSub(std::string const &strUrl, InfoSub::ref) override
Definition: NetworkOPs.cpp:4153
-
ripple::NetworkOPsImp::clusterTimer_
boost::asio::steady_timer clusterTimer_
Definition: NetworkOPs.cpp:730
-
ripple::NetworkOPsImp::isAmendmentWarned
bool isAmendmentWarned() override
Definition: NetworkOPs.cpp:1646
-
ripple::NetworkOPsImp::states_
static std::array< char const *, 5 > const states_
Definition: NetworkOPs.cpp:122
-
ripple::NetworkOPsImp::subServer
bool subServer(InfoSub::ref ispListener, Json::Value &jvResult, bool admin) override
Definition: NetworkOPs.cpp:4007
-
ripple::NetworkOPsImp::NetworkOPsImp
NetworkOPsImp(Application &app, NetworkOPs::clock_type &clock, bool standalone, std::size_t minPeerCount, bool start_valid, JobQueue &job_queue, LedgerMaster &ledgerMaster, ValidatorKeys const &validatorKeys, boost::asio::io_service &io_svc, beast::Journal journal, beast::insight::Collector::ptr const &collector)
Definition: NetworkOPs.cpp:222
-
ripple::NetworkOPsImp::unsubAccountInternal
void unsubAccountInternal(std::uint64_t seq, hash_set< AccountID > const &vnaAccountIDs, bool rt) override
Definition: NetworkOPs.cpp:3441
-
ripple::NetworkOPsImp::amendmentBlocked_
std::atomic< bool > amendmentBlocked_
Definition: NetworkOPs.cpp:724
-
ripple::NetworkOPsImp::m_journal
beast::Journal m_journal
Definition: NetworkOPs.cpp:715
-
ripple::NetworkOPsImp::mSubAccount
SubInfoMapType mSubAccount
Definition: NetworkOPs.cpp:739
-
ripple::NetworkOPsImp::unsubAccountHistory
void unsubAccountHistory(InfoSub::ref ispListener, AccountID const &account, bool historyOnly) override
unsubscribe an account's transactions
Definition: NetworkOPs.cpp:3851
-
ripple::NetworkOPsImp::pendingValidations_
std::set< uint256 > pendingValidations_
Definition: NetworkOPs.cpp:779
-
ripple::NetworkOPsImp::beginConsensus
bool beginConsensus(uint256 const &networkClosed, std::unique_ptr< std::stringstream > const &clog) override
Definition: NetworkOPs.cpp:1843
-
ripple::NetworkOPsImp::doTransactionAsync
void doTransactionAsync(std::shared_ptr< Transaction > transaction, bool bUnlimited, FailHard failtype)
For transactions not submitted by a locally connected client, fire and forget.
Definition: NetworkOPs.cpp:1265
-
ripple::NetworkOPsImp::setAccountHistoryJobTimer
void setAccountHistoryJobTimer(SubAccountHistoryInfoWeak subInfo)
Definition: NetworkOPs.cpp:996
-
ripple::NetworkOPsImp::unsubValidations
bool unsubValidations(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4097
-
ripple::NetworkOPsImp::endConsensus
void endConsensus(std::unique_ptr< std::stringstream > const &clog) override
Definition: NetworkOPs.cpp:1943
- -
ripple::NetworkOPsImp::waitHandlerCounter_
ClosureCounter< void, boost::system::error_code const & > waitHandlerCounter_
Definition: NetworkOPs.cpp:728
-
ripple::NetworkOPsImp::pubLedger
void pubLedger(std::shared_ptr< ReadView const > const &lpAccepted) override
Definition: NetworkOPs.cpp:2869
-
ripple::NetworkOPsImp::addAccountHistoryJob
void addAccountHistoryJob(SubAccountHistoryInfoWeak subInfo)
Definition: NetworkOPs.cpp:3469
-
ripple::NetworkOPsImp::doTransactionSync
void doTransactionSync(std::shared_ptr< Transaction > transaction, bool bUnlimited, FailHard failType)
For transactions submitted directly by a client, apply batch of transactions and wait for this transa...
Definition: NetworkOPs.cpp:1290
-
ripple::NetworkOPsImp::setTimer
void setTimer(boost::asio::steady_timer &timer, std::chrono::milliseconds const &expiry_time, std::function< void()> onExpire, std::function< void()> onError)
Definition: NetworkOPs.cpp:934
- -
ripple::NetworkOPsImp::mStreamMaps
std::array< SubMapType, SubTypes::sLastEntry > mStreamMaps
Definition: NetworkOPs.cpp:759
-
ripple::NetworkOPsImp::unsubPeerStatus
bool unsubPeerStatus(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4115
-
ripple::NetworkOPsImp::pubValidation
void pubValidation(std::shared_ptr< STValidation > const &val) override
Definition: NetworkOPs.cpp:2185
-
ripple::NetworkOPsImp::minPeerCount_
std::size_t const minPeerCount_
Definition: NetworkOPs.cpp:769
-
ripple::NetworkOPsImp::unlBlocked_
std::atomic< bool > unlBlocked_
Definition: NetworkOPs.cpp:726
-
ripple::NetworkOPsImp::subBook
bool subBook(InfoSub::ref ispListener, Book const &) override
Definition: NetworkOPs.cpp:3893
-
ripple::NetworkOPsImp::acceptLedger
std::uint32_t acceptLedger(std::optional< std::chrono::milliseconds > consensusDelay) override
Accepts the current transaction tree, return the new ledger's sequence.
Definition: NetworkOPs.cpp:3912
-
ripple::NetworkOPsImp::stateAccounting
void stateAccounting(Json::Value &obj) override
Definition: NetworkOPs.cpp:4090
-
ripple::NetworkOPsImp::submitTransaction
void submitTransaction(std::shared_ptr< STTx const > const &) override
Definition: NetworkOPs.cpp:1160
-
ripple::NetworkOPsImp::unsubRTTransactions
bool unsubRTTransactions(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4073
- -
ripple::NetworkOPsImp::getConsensusInfo
Json::Value getConsensusInfo() override
Definition: NetworkOPs.cpp:2412
- -
ripple::NetworkOPsImp::mSubLock
std::recursive_mutex mSubLock
Definition: NetworkOPs.cpp:719
-
ripple::NetworkOPsImp::needNetworkLedger_
std::atomic< bool > needNetworkLedger_
Definition: NetworkOPs.cpp:723
-
ripple::NetworkOPsImp::recvValidation
bool recvValidation(std::shared_ptr< STValidation > const &val, std::string const &source) override
Definition: NetworkOPs.cpp:2353
-
ripple::NetworkOPsImp::switchLastClosedLedger
void switchLastClosedLedger(std::shared_ptr< Ledger const > const &newLCL)
Definition: NetworkOPs.cpp:1789
-
ripple::NetworkOPsImp::accounting_
StateAccounting accounting_
Definition: NetworkOPs.cpp:777
-
ripple::NetworkOPsImp::reportConsensusStateChange
void reportConsensusStateChange(ConsensusPhase phase)
Definition: NetworkOPs.cpp:3002
-
ripple::NetworkOPsImp::subConsensus
bool subConsensus(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:4123
-
ripple::NetworkOPsImp::isNeedNetworkLedger
bool isNeedNetworkLedger() override
Definition: NetworkOPs.cpp:893
- -
ripple::NetworkOPsImp::setAmendmentWarned
void setAmendmentWarned() override
Definition: NetworkOPs.cpp:1652
-
ripple::NetworkOPsImp::processTrustedProposal
bool processTrustedProposal(RCLCxPeerPos proposal) override
Definition: NetworkOPs.cpp:1918
-
ripple::NetworkOPsImp::subPeerStatus
bool subPeerStatus(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:4105
-
ripple::NetworkOPsImp::mapComplete
void mapComplete(std::shared_ptr< SHAMap > const &map, bool fromAcquire) override
Definition: NetworkOPs.cpp:1924
-
ripple::NetworkOPsImp::tryRemoveRpcSub
bool tryRemoveRpcSub(std::string const &strUrl) override
Definition: NetworkOPs.cpp:4163
-
ripple::NetworkOPsImp::pubAccountTransaction
void pubAccountTransaction(std::shared_ptr< ReadView const > const &ledger, AcceptedLedgerTx const &transaction, bool last)
Definition: NetworkOPs.cpp:3175
-
ripple::NetworkOPsImp::m_ledgerMaster
LedgerMaster & m_ledgerMaster
Definition: NetworkOPs.cpp:737
-
ripple::NetworkOPsImp::clearLedgerFetch
void clearLedgerFetch() override
Definition: NetworkOPs.cpp:2823
-
ripple::NetworkOPsImp::isBlocked
bool isBlocked() override
Definition: NetworkOPs.cpp:1627
-
ripple::NetworkOPsImp::consensusViewChange
void consensusViewChange() override
Definition: NetworkOPs.cpp:2002
-
ripple::NetworkOPsImp::setStateTimer
void setStateTimer() override
Called to initially start our timers.
Definition: NetworkOPs.cpp:924
-
ripple::NetworkOPsImp::subManifests
bool subManifests(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:3989
-
ripple::NetworkOPsImp::pubValidatedTransaction
void pubValidatedTransaction(std::shared_ptr< ReadView const > const &ledger, AcceptedLedgerTx const &transaction, bool last)
Definition: NetworkOPs.cpp:3119
-
ripple::NetworkOPsImp::subAccount
void subAccount(InfoSub::ref ispListener, hash_set< AccountID > const &vnaAccountIDs, bool rt) override
Definition: NetworkOPs.cpp:3388
-
ripple::NetworkOPsImp::unsubServer
bool unsubServer(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4037
-
ripple::NetworkOPsImp::transJson
MultiApiJson transJson(std::shared_ptr< STTx const > const &transaction, TER result, bool validated, std::shared_ptr< ReadView const > const &ledger, std::optional< std::reference_wrapper< TxMeta const > > meta)
Definition: NetworkOPs.cpp:3024
-
ripple::NetworkOPsImp::mLastFeeSummary
ServerFeeSummary mLastFeeSummary
Definition: NetworkOPs.cpp:761
-
ripple::NetworkOPsImp::pubPeerStatus
void pubPeerStatus(std::function< Json::Value(void)> const &) override
Definition: NetworkOPs.cpp:2295
-
ripple::NetworkOPsImp::setStandAlone
void setStandAlone() override
Definition: NetworkOPs.cpp:875
-
ripple::NetworkOPsImp::subRTTransactions
bool subRTTransactions(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:4063
-
ripple::NetworkOPsImp::pubProposedAccountTransaction
void pubProposedAccountTransaction(std::shared_ptr< ReadView const > const &ledger, std::shared_ptr< STTx const > const &transaction, TER result)
Definition: NetworkOPs.cpp:3309
- -
ripple::NetworkOPsImp::mCond
std::condition_variable mCond
Definition: NetworkOPs.cpp:772
-
ripple::NetworkOPsImp::setMode
void setMode(OperatingMode om) override
Definition: NetworkOPs.cpp:2324
-
ripple::NetworkOPsImp::stop
void stop() override
Definition: NetworkOPs.cpp:564
-
ripple::NetworkOPsImp::clearNeedNetworkLedger
void clearNeedNetworkLedger() override
Definition: NetworkOPs.cpp:887
-
ripple::NetworkOPsImp::mDispatchState
DispatchState mDispatchState
Definition: NetworkOPs.cpp:774
-
ripple::NetworkOPsImp::subBookChanges
bool subBookChanges(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:3963
-
ripple::NetworkOPsImp::mSubRTAccount
SubInfoMapType mSubRTAccount
Definition: NetworkOPs.cpp:740
- -
ripple::NetworkOPsImp::checkLastClosedLedger
bool checkLastClosedLedger(const Overlay::PeerSequence &, uint256 &networkClosed)
Definition: NetworkOPs.cpp:1683
-
ripple::NetworkOPsImp::reportFeeChange
void reportFeeChange() override
Definition: NetworkOPs.cpp:2984
- -
ripple::NetworkOPsImp::unsubBook
bool unsubBook(std::uint64_t uListener, Book const &) override
Definition: NetworkOPs.cpp:3903
-
ripple::NetworkOPsImp::subAccountHistoryStart
void subAccountHistoryStart(std::shared_ptr< ReadView const > const &ledger, SubAccountHistoryInfoWeak &subInfo)
Definition: NetworkOPs.cpp:3759
-
ripple::NetworkOPsImp::isFull
bool isFull() override
Definition: NetworkOPs.cpp:899
-
ripple::NetworkOPsImp::subAccountHistory
error_code_i subAccountHistory(InfoSub::ref ispListener, AccountID const &account) override
subscribe an account's new transactions and retrieve the account's historical transactions
Definition: NetworkOPs.cpp:3805
-
ripple::NetworkOPsImp::validationsMutex_
std::mutex validationsMutex_
Definition: NetworkOPs.cpp:780
-
ripple::NetworkOPsImp::app_
Application & app_
Definition: NetworkOPs.cpp:714
-
ripple::NetworkOPsImp::pubManifest
void pubManifest(Manifest const &) override
Definition: NetworkOPs.cpp:2011
-
ripple::NetworkOPsImp::mLastConsensusPhase
ConsensusPhase mLastConsensusPhase
Definition: NetworkOPs.cpp:735
-
ripple::NetworkOPsImp::subTransactions
bool subTransactions(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:4045
-
ripple::NetworkOPsImp::mRpcSubMap
subRpcMapType mRpcSubMap
Definition: NetworkOPs.cpp:742
-
ripple::NetworkOPsImp::amendmentWarned_
std::atomic< bool > amendmentWarned_
Definition: NetworkOPs.cpp:725
-
ripple::NetworkOPsImp::findRpcSub
InfoSub::pointer findRpcSub(std::string const &strUrl) override
Definition: NetworkOPs.cpp:4140
-
ripple::NetworkOPsImp::unsubLedger
bool unsubLedger(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:3973
-
ripple::NetworkOPsImp::getHostId
std::string getHostId(bool forAdmin)
Definition: NetworkOPs.cpp:905
-
ripple::NetworkOPsImp::unsubConsensus
bool unsubConsensus(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4133
+
ripple::NetworkOPsImp::validatorPK_
std::optional< PublicKey > const validatorPK_
Definition: NetworkOPs.cpp:742
+
ripple::NetworkOPsImp::unsubTransactions
bool unsubTransactions(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4082
+ +
ripple::NetworkOPsImp::clearAmendmentWarned
void clearAmendmentWarned() override
Definition: NetworkOPs.cpp:1668
+
ripple::NetworkOPsImp::getLocalTxCount
std::size_t getLocalTxCount() override
Definition: NetworkOPs.cpp:3043
+
ripple::NetworkOPsImp::m_localTX
std::unique_ptr< LocalTxs > m_localTX
Definition: NetworkOPs.cpp:724
+
ripple::NetworkOPsImp::subValidations
bool subValidations(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:4108
+
ripple::NetworkOPsImp::subLedger
bool subLedger(InfoSub::ref ispListener, Json::Value &jvResult) override
Definition: NetworkOPs.cpp:3960
+
ripple::NetworkOPsImp::~NetworkOPsImp
~NetworkOPsImp() override
Definition: NetworkOPs.cpp:267
+
ripple::NetworkOPsImp::isAmendmentBlocked
bool isAmendmentBlocked() override
Definition: NetworkOPs.cpp:1643
+
ripple::NetworkOPsImp::unsubAccountHistoryInternal
void unsubAccountHistoryInternal(std::uint64_t seq, AccountID const &account, bool historyOnly) override
Definition: NetworkOPs.cpp:3889
+
ripple::NetworkOPsImp::mSubAccountHistory
SubAccountHistoryMapType mSubAccountHistory
Definition: NetworkOPs.cpp:754
+
ripple::NetworkOPsImp::getBookPage
void getBookPage(std::shared_ptr< ReadView const > &lpLedger, Book const &, AccountID const &uTakerID, const bool bProof, unsigned int iLimit, Json::Value const &jvMarker, Json::Value &jvResult) override
Definition: NetworkOPs.cpp:4215
+
ripple::NetworkOPsImp::getServerInfo
Json::Value getServerInfo(bool human, bool admin, bool counters) override
Definition: NetworkOPs.cpp:2445
+
ripple::NetworkOPsImp::addRpcSub
InfoSub::pointer addRpcSub(std::string const &strUrl, InfoSub::ref) override
Definition: NetworkOPs.cpp:4180
+
ripple::NetworkOPsImp::clusterTimer_
boost::asio::steady_timer clusterTimer_
Definition: NetworkOPs.cpp:737
+
ripple::NetworkOPsImp::isAmendmentWarned
bool isAmendmentWarned() override
Definition: NetworkOPs.cpp:1656
+
ripple::NetworkOPsImp::states_
static std::array< char const *, 5 > const states_
Definition: NetworkOPs.cpp:123
+
ripple::NetworkOPsImp::subServer
bool subServer(InfoSub::ref ispListener, Json::Value &jvResult, bool admin) override
Definition: NetworkOPs.cpp:4034
+
ripple::NetworkOPsImp::NetworkOPsImp
NetworkOPsImp(Application &app, NetworkOPs::clock_type &clock, bool standalone, std::size_t minPeerCount, bool start_valid, JobQueue &job_queue, LedgerMaster &ledgerMaster, ValidatorKeys const &validatorKeys, boost::asio::io_service &io_svc, beast::Journal journal, beast::insight::Collector::ptr const &collector)
Definition: NetworkOPs.cpp:223
+
ripple::NetworkOPsImp::unsubAccountInternal
void unsubAccountInternal(std::uint64_t seq, hash_set< AccountID > const &vnaAccountIDs, bool rt) override
Definition: NetworkOPs.cpp:3468
+
ripple::NetworkOPsImp::amendmentBlocked_
std::atomic< bool > amendmentBlocked_
Definition: NetworkOPs.cpp:731
+
ripple::NetworkOPsImp::m_journal
beast::Journal m_journal
Definition: NetworkOPs.cpp:722
+
ripple::NetworkOPsImp::mSubAccount
SubInfoMapType mSubAccount
Definition: NetworkOPs.cpp:749
+
ripple::NetworkOPsImp::validatorMasterPK_
std::optional< PublicKey > const validatorMasterPK_
Definition: NetworkOPs.cpp:743
+
ripple::NetworkOPsImp::unsubAccountHistory
void unsubAccountHistory(InfoSub::ref ispListener, AccountID const &account, bool historyOnly) override
unsubscribe an account's transactions
Definition: NetworkOPs.cpp:3878
+
ripple::NetworkOPsImp::pendingValidations_
std::set< uint256 > pendingValidations_
Definition: NetworkOPs.cpp:789
+
ripple::NetworkOPsImp::beginConsensus
bool beginConsensus(uint256 const &networkClosed, std::unique_ptr< std::stringstream > const &clog) override
Definition: NetworkOPs.cpp:1853
+
ripple::NetworkOPsImp::doTransactionAsync
void doTransactionAsync(std::shared_ptr< Transaction > transaction, bool bUnlimited, FailHard failtype)
For transactions not submitted by a locally connected client, fire and forget.
Definition: NetworkOPs.cpp:1275
+
ripple::NetworkOPsImp::setAccountHistoryJobTimer
void setAccountHistoryJobTimer(SubAccountHistoryInfoWeak subInfo)
Definition: NetworkOPs.cpp:1006
+
ripple::NetworkOPsImp::unsubValidations
bool unsubValidations(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4124
+
ripple::NetworkOPsImp::endConsensus
void endConsensus(std::unique_ptr< std::stringstream > const &clog) override
Definition: NetworkOPs.cpp:1970
+ +
ripple::NetworkOPsImp::waitHandlerCounter_
ClosureCounter< void, boost::system::error_code const & > waitHandlerCounter_
Definition: NetworkOPs.cpp:735
+
ripple::NetworkOPsImp::pubLedger
void pubLedger(std::shared_ptr< ReadView const > const &lpAccepted) override
Definition: NetworkOPs.cpp:2896
+
ripple::NetworkOPsImp::addAccountHistoryJob
void addAccountHistoryJob(SubAccountHistoryInfoWeak subInfo)
Definition: NetworkOPs.cpp:3496
+
ripple::NetworkOPsImp::doTransactionSync
void doTransactionSync(std::shared_ptr< Transaction > transaction, bool bUnlimited, FailHard failType)
For transactions submitted directly by a client, apply batch of transactions and wait for this transa...
Definition: NetworkOPs.cpp:1300
+
ripple::NetworkOPsImp::setTimer
void setTimer(boost::asio::steady_timer &timer, std::chrono::milliseconds const &expiry_time, std::function< void()> onExpire, std::function< void()> onError)
Definition: NetworkOPs.cpp:944
+ +
ripple::NetworkOPsImp::mStreamMaps
std::array< SubMapType, SubTypes::sLastEntry > mStreamMaps
Definition: NetworkOPs.cpp:769
+
ripple::NetworkOPsImp::unsubPeerStatus
bool unsubPeerStatus(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4142
+
ripple::NetworkOPsImp::pubValidation
void pubValidation(std::shared_ptr< STValidation > const &val) override
Definition: NetworkOPs.cpp:2212
+
ripple::NetworkOPsImp::minPeerCount_
std::size_t const minPeerCount_
Definition: NetworkOPs.cpp:779
+
ripple::NetworkOPsImp::unlBlocked_
std::atomic< bool > unlBlocked_
Definition: NetworkOPs.cpp:733
+
ripple::NetworkOPsImp::subBook
bool subBook(InfoSub::ref ispListener, Book const &) override
Definition: NetworkOPs.cpp:3920
+
ripple::NetworkOPsImp::acceptLedger
std::uint32_t acceptLedger(std::optional< std::chrono::milliseconds > consensusDelay) override
Accepts the current transaction tree, return the new ledger's sequence.
Definition: NetworkOPs.cpp:3939
+
ripple::NetworkOPsImp::stateAccounting
void stateAccounting(Json::Value &obj) override
Definition: NetworkOPs.cpp:4117
+
ripple::NetworkOPsImp::submitTransaction
void submitTransaction(std::shared_ptr< STTx const > const &) override
Definition: NetworkOPs.cpp:1170
+
ripple::NetworkOPsImp::unsubRTTransactions
bool unsubRTTransactions(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4100
+ +
ripple::NetworkOPsImp::getConsensusInfo
Json::Value getConsensusInfo() override
Definition: NetworkOPs.cpp:2439
+ +
ripple::NetworkOPsImp::mSubLock
std::recursive_mutex mSubLock
Definition: NetworkOPs.cpp:726
+
ripple::NetworkOPsImp::needNetworkLedger_
std::atomic< bool > needNetworkLedger_
Definition: NetworkOPs.cpp:730
+
ripple::NetworkOPsImp::recvValidation
bool recvValidation(std::shared_ptr< STValidation > const &val, std::string const &source) override
Definition: NetworkOPs.cpp:2380
+
ripple::NetworkOPsImp::switchLastClosedLedger
void switchLastClosedLedger(std::shared_ptr< Ledger const > const &newLCL)
Definition: NetworkOPs.cpp:1799
+
ripple::NetworkOPsImp::accounting_
StateAccounting accounting_
Definition: NetworkOPs.cpp:787
+
ripple::NetworkOPsImp::reportConsensusStateChange
void reportConsensusStateChange(ConsensusPhase phase)
Definition: NetworkOPs.cpp:3029
+
ripple::NetworkOPsImp::subConsensus
bool subConsensus(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:4150
+
ripple::NetworkOPsImp::isNeedNetworkLedger
bool isNeedNetworkLedger() override
Definition: NetworkOPs.cpp:903
+ +
ripple::NetworkOPsImp::setAmendmentWarned
void setAmendmentWarned() override
Definition: NetworkOPs.cpp:1662
+
ripple::NetworkOPsImp::processTrustedProposal
bool processTrustedProposal(RCLCxPeerPos proposal) override
Definition: NetworkOPs.cpp:1928
+
ripple::NetworkOPsImp::subPeerStatus
bool subPeerStatus(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:4132
+
ripple::NetworkOPsImp::mapComplete
void mapComplete(std::shared_ptr< SHAMap > const &map, bool fromAcquire) override
Definition: NetworkOPs.cpp:1951
+
ripple::NetworkOPsImp::tryRemoveRpcSub
bool tryRemoveRpcSub(std::string const &strUrl) override
Definition: NetworkOPs.cpp:4190
+
ripple::NetworkOPsImp::pubAccountTransaction
void pubAccountTransaction(std::shared_ptr< ReadView const > const &ledger, AcceptedLedgerTx const &transaction, bool last)
Definition: NetworkOPs.cpp:3202
+
ripple::NetworkOPsImp::m_ledgerMaster
LedgerMaster & m_ledgerMaster
Definition: NetworkOPs.cpp:747
+
ripple::NetworkOPsImp::clearLedgerFetch
void clearLedgerFetch() override
Definition: NetworkOPs.cpp:2850
+
ripple::NetworkOPsImp::isBlocked
bool isBlocked() override
Definition: NetworkOPs.cpp:1637
+
ripple::NetworkOPsImp::consensusViewChange
void consensusViewChange() override
Definition: NetworkOPs.cpp:2029
+
ripple::NetworkOPsImp::setStateTimer
void setStateTimer() override
Called to initially start our timers.
Definition: NetworkOPs.cpp:934
+
ripple::NetworkOPsImp::subManifests
bool subManifests(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:4016
+
ripple::NetworkOPsImp::pubValidatedTransaction
void pubValidatedTransaction(std::shared_ptr< ReadView const > const &ledger, AcceptedLedgerTx const &transaction, bool last)
Definition: NetworkOPs.cpp:3146
+
ripple::NetworkOPsImp::subAccount
void subAccount(InfoSub::ref ispListener, hash_set< AccountID > const &vnaAccountIDs, bool rt) override
Definition: NetworkOPs.cpp:3415
+
ripple::NetworkOPsImp::unsubServer
bool unsubServer(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4064
+
ripple::NetworkOPsImp::transJson
MultiApiJson transJson(std::shared_ptr< STTx const > const &transaction, TER result, bool validated, std::shared_ptr< ReadView const > const &ledger, std::optional< std::reference_wrapper< TxMeta const > > meta)
Definition: NetworkOPs.cpp:3051
+
ripple::NetworkOPsImp::mLastFeeSummary
ServerFeeSummary mLastFeeSummary
Definition: NetworkOPs.cpp:771
+
ripple::NetworkOPsImp::pubPeerStatus
void pubPeerStatus(std::function< Json::Value(void)> const &) override
Definition: NetworkOPs.cpp:2322
+
ripple::NetworkOPsImp::setStandAlone
void setStandAlone() override
Definition: NetworkOPs.cpp:885
+
ripple::NetworkOPsImp::subRTTransactions
bool subRTTransactions(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:4090
+
ripple::NetworkOPsImp::pubProposedAccountTransaction
void pubProposedAccountTransaction(std::shared_ptr< ReadView const > const &ledger, std::shared_ptr< STTx const > const &transaction, TER result)
Definition: NetworkOPs.cpp:3336
+ +
ripple::NetworkOPsImp::mCond
std::condition_variable mCond
Definition: NetworkOPs.cpp:782
+
ripple::NetworkOPsImp::setMode
void setMode(OperatingMode om) override
Definition: NetworkOPs.cpp:2351
+
ripple::NetworkOPsImp::stop
void stop() override
Definition: NetworkOPs.cpp:571
+
ripple::NetworkOPsImp::clearNeedNetworkLedger
void clearNeedNetworkLedger() override
Definition: NetworkOPs.cpp:897
+
ripple::NetworkOPsImp::mDispatchState
DispatchState mDispatchState
Definition: NetworkOPs.cpp:784
+
ripple::NetworkOPsImp::subBookChanges
bool subBookChanges(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:3990
+
ripple::NetworkOPsImp::mSubRTAccount
SubInfoMapType mSubRTAccount
Definition: NetworkOPs.cpp:750
+ +
ripple::NetworkOPsImp::checkLastClosedLedger
bool checkLastClosedLedger(const Overlay::PeerSequence &, uint256 &networkClosed)
Definition: NetworkOPs.cpp:1693
+
ripple::NetworkOPsImp::reportFeeChange
void reportFeeChange() override
Definition: NetworkOPs.cpp:3011
+ +
ripple::NetworkOPsImp::unsubBook
bool unsubBook(std::uint64_t uListener, Book const &) override
Definition: NetworkOPs.cpp:3930
+
ripple::NetworkOPsImp::subAccountHistoryStart
void subAccountHistoryStart(std::shared_ptr< ReadView const > const &ledger, SubAccountHistoryInfoWeak &subInfo)
Definition: NetworkOPs.cpp:3786
+
ripple::NetworkOPsImp::isFull
bool isFull() override
Definition: NetworkOPs.cpp:909
+
ripple::NetworkOPsImp::subAccountHistory
error_code_i subAccountHistory(InfoSub::ref ispListener, AccountID const &account) override
subscribe an account's new transactions and retrieve the account's historical transactions
Definition: NetworkOPs.cpp:3832
+
ripple::NetworkOPsImp::validationsMutex_
std::mutex validationsMutex_
Definition: NetworkOPs.cpp:790
+
ripple::NetworkOPsImp::app_
Application & app_
Definition: NetworkOPs.cpp:721
+
ripple::NetworkOPsImp::pubManifest
void pubManifest(Manifest const &) override
Definition: NetworkOPs.cpp:2038
+
ripple::NetworkOPsImp::mLastConsensusPhase
ConsensusPhase mLastConsensusPhase
Definition: NetworkOPs.cpp:745
+
ripple::NetworkOPsImp::subTransactions
bool subTransactions(InfoSub::ref ispListener) override
Definition: NetworkOPs.cpp:4072
+
ripple::NetworkOPsImp::mRpcSubMap
subRpcMapType mRpcSubMap
Definition: NetworkOPs.cpp:752
+
ripple::NetworkOPsImp::amendmentWarned_
std::atomic< bool > amendmentWarned_
Definition: NetworkOPs.cpp:732
+
ripple::NetworkOPsImp::findRpcSub
InfoSub::pointer findRpcSub(std::string const &strUrl) override
Definition: NetworkOPs.cpp:4167
+
ripple::NetworkOPsImp::unsubLedger
bool unsubLedger(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4000
+
ripple::NetworkOPsImp::getHostId
std::string getHostId(bool forAdmin)
Definition: NetworkOPs.cpp:915
+
ripple::NetworkOPsImp::unsubConsensus
bool unsubConsensus(std::uint64_t uListener) override
Definition: NetworkOPs.cpp:4160
ripple::NetworkOPs
Provides server functionality for clients.
Definition: NetworkOPs.h:88
@@ -4938,6 +4968,7 @@ $(function() {
ripple::RCLConsensus::prevRoundTime
std::chrono::milliseconds prevRoundTime() const
Get duration of the previous round.
Definition: RCLConsensus.h:460
ripple::RCLConsensus::getJson
Json::Value getJson(bool full) const
Definition: RCLConsensus.cpp:930
ripple::RCLCxPeerPos
A peer's signed, proposed position for use in RCLConsensus.
Definition: RCLCxPeerPos.h:44
+
ripple::RCLCxPeerPos::publicKey
PublicKey const & publicKey() const
Public key of peer that sent the proposal.
Definition: RCLCxPeerPos.h:78
ripple::RCLTxSet
Represents a set of transactions in RCLConsensus.
Definition: RCLCxTx.h:63
ripple::RCLValidatedLedger
Wraps a ledger instance for use in generic Validations LedgerTrie.
Definition: RCLValidations.h:159
ripple::RFC1751::getWordFromBlob
static std::string getWordFromBlob(void const *blob, size_t bytes)
Chooses a single dictionary word from the data.
Definition: RFC1751.cpp:507
@@ -5046,7 +5077,7 @@ $(function() {
ripple::transferRate
Rate transferRate(ReadView const &view, AccountID const &issuer)
Returns IOU issuer transfer fee as Rate.
Definition: View.cpp:650
ripple::amountFromQuality
STAmount amountFromQuality(std::uint64_t rate)
Definition: STAmount.cpp:854
ripple::handleNewValidation
void handleNewValidation(Application &app, std::shared_ptr< STValidation > const &val, std::string const &source, BypassAccept const bypassAccept, std::optional< beast::Journal > j)
Handle a new validation.
Definition: RCLValidations.cpp:165
-
ripple::make_NetworkOPs
std::unique_ptr< NetworkOPs > make_NetworkOPs(Application &app, NetworkOPs::clock_type &clock, bool standalone, std::size_t minPeerCount, bool startvalid, JobQueue &job_queue, LedgerMaster &ledgerMaster, ValidatorKeys const &validatorKeys, boost::asio::io_service &io_svc, beast::Journal journal, beast::insight::Collector::ptr const &collector)
Definition: NetworkOPs.cpp:4612
+
ripple::make_NetworkOPs
std::unique_ptr< NetworkOPs > make_NetworkOPs(Application &app, NetworkOPs::clock_type &clock, bool standalone, std::size_t minPeerCount, bool startvalid, JobQueue &job_queue, LedgerMaster &ledgerMaster, ValidatorKeys const &validatorKeys, boost::asio::io_service &io_svc, beast::Journal journal, beast::insight::Collector::ptr const &collector)
Definition: NetworkOPs.cpp:4639
ripple::warnRPC_EXPIRED_VALIDATOR_LIST
@ warnRPC_EXPIRED_VALIDATOR_LIST
Definition: ErrorCodes.h:167
ripple::warnRPC_UNSUPPORTED_MAJORITY
@ warnRPC_UNSUPPORTED_MAJORITY
Definition: ErrorCodes.h:165
ripple::warnRPC_AMENDMENT_BLOCKED
@ warnRPC_AMENDMENT_BLOCKED
Definition: ErrorCodes.h:166
@@ -5066,7 +5097,7 @@ $(function() {
ripple::rpcError
Json::Value rpcError(int iError)
Definition: RPCErr.cpp:31
ripple::tefPAST_SEQ
@ tefPAST_SEQ
Definition: TER.h:175
ripple::ConsensusPhase
ConsensusPhase
Phases of consensus for a single ledger round.
Definition: ConsensusTypes.h:105
-
ripple::stateNames
static std::array< char const *, 5 > const stateNames
Definition: NetworkOPs.cpp:844
+
ripple::stateNames
static std::array< char const *, 5 > const stateNames
Definition: NetworkOPs.cpp:854
ripple::strHex
std::string strHex(FwdIt begin, FwdIt end)
Definition: strHex.h:30
ripple::isTemMalformed
bool isTemMalformed(TER x)
Definition: TER.h:638
ripple::cdirNext
bool cdirNext(ReadView const &view, uint256 const &root, std::shared_ptr< SLE const > &page, unsigned int &index, uint256 &entry)
Returns the next entry in the directory, advancing the index.
Definition: View.cpp:148
@@ -5103,12 +5134,12 @@ $(function() {
ripple::getBookBase
uint256 getBookBase(Book const &book)
Definition: Indexes.cpp:113
ripple::parityRate
Rate const parityRate
A transfer rate signifying a 1:1 exchange.
ripple::isGlobalFrozen
bool isGlobalFrozen(ReadView const &view, AccountID const &issuer)
Definition: View.cpp:174
-
ripple::trunc32
static std::uint32_t trunc32(std::uint64_t v)
Definition: NetworkOPs.cpp:2082
+
ripple::trunc32
static std::uint32_t trunc32(std::uint64_t v)
Definition: NetworkOPs.cpp:2109
ripple::temBAD_SIGNATURE
@ temBAD_SIGNATURE
Definition: TER.h:105
-
ripple::genesisAccountId
static auto const genesisAccountId
Definition: NetworkOPs.cpp:857
+
ripple::genesisAccountId
static auto const genesisAccountId
Definition: NetworkOPs.cpp:867
std
STL namespace.
@@ -5134,51 +5165,51 @@ $(function() {
ripple::Manifest::signingKey
std::optional< PublicKey > signingKey
The ephemeral key associated with this manifest.
Definition: Manifest.h:92
ripple::Manifest::getMasterSignature
Blob getMasterSignature() const
Returns manifest master key signature.
Definition: app/misc/detail/Manifest.cpp:255
ripple::Manifest::masterKey
PublicKey masterKey
The master key associated with this manifest.
Definition: Manifest.h:86
-
ripple::NetworkOPsImp::ServerFeeSummary
Server fees published on server subscription.
Definition: NetworkOPs.cpp:199
-
ripple::NetworkOPsImp::ServerFeeSummary::operator!=
bool operator!=(ServerFeeSummary const &b) const
Definition: NetworkOPs.cpp:2061
+
ripple::NetworkOPsImp::ServerFeeSummary
Server fees published on server subscription.
Definition: NetworkOPs.cpp:200
+
ripple::NetworkOPsImp::ServerFeeSummary::operator!=
bool operator!=(ServerFeeSummary const &b) const
Definition: NetworkOPs.cpp:2088
- -
ripple::NetworkOPsImp::ServerFeeSummary::em
std::optional< TxQ::Metrics > em
Definition: NetworkOPs.cpp:218
- -
ripple::NetworkOPsImp::ServerFeeSummary::operator==
bool operator==(ServerFeeSummary const &b) const
Definition: NetworkOPs.cpp:210
- - - - - - - + +
ripple::NetworkOPsImp::ServerFeeSummary::em
std::optional< TxQ::Metrics > em
Definition: NetworkOPs.cpp:219
+ +
ripple::NetworkOPsImp::ServerFeeSummary::operator==
bool operator==(ServerFeeSummary const &b) const
Definition: NetworkOPs.cpp:211
+ + + + + + + - - - -
ripple::NetworkOPsImp::Stats::full_transitions
beast::insight::Gauge full_transitions
Definition: NetworkOPs.cpp:831
-
ripple::NetworkOPsImp::Stats::Stats
Stats(Handler const &handler, beast::insight::Collector::ptr const &collector)
Definition: NetworkOPs.cpp:786
-
ripple::NetworkOPsImp::Stats::hook
beast::insight::Hook hook
Definition: NetworkOPs.cpp:820
-
ripple::NetworkOPsImp::Stats::connected_duration
beast::insight::Gauge connected_duration
Definition: NetworkOPs.cpp:822
-
ripple::NetworkOPsImp::Stats::tracking_duration
beast::insight::Gauge tracking_duration
Definition: NetworkOPs.cpp:824
-
ripple::NetworkOPsImp::Stats::connected_transitions
beast::insight::Gauge connected_transitions
Definition: NetworkOPs.cpp:828
-
ripple::NetworkOPsImp::Stats::disconnected_transitions
beast::insight::Gauge disconnected_transitions
Definition: NetworkOPs.cpp:827
-
ripple::NetworkOPsImp::Stats::syncing_duration
beast::insight::Gauge syncing_duration
Definition: NetworkOPs.cpp:823
-
ripple::NetworkOPsImp::Stats::tracking_transitions
beast::insight::Gauge tracking_transitions
Definition: NetworkOPs.cpp:830
-
ripple::NetworkOPsImp::Stats::full_duration
beast::insight::Gauge full_duration
Definition: NetworkOPs.cpp:825
-
ripple::NetworkOPsImp::Stats::disconnected_duration
beast::insight::Gauge disconnected_duration
Definition: NetworkOPs.cpp:821
-
ripple::NetworkOPsImp::Stats::syncing_transitions
beast::insight::Gauge syncing_transitions
Definition: NetworkOPs.cpp:829
- - - - - - - -
ripple::NetworkOPsImp::SubAccountHistoryIndex::SubAccountHistoryIndex
SubAccountHistoryIndex(AccountID const &accountId)
Definition: NetworkOPs.cpp:678
- - -
ripple::NetworkOPsImp::SubAccountHistoryInfoWeak::index_
std::shared_ptr< SubAccountHistoryIndex > index_
Definition: NetworkOPs.cpp:697
- - -
ripple::NetworkOPsImp::SubAccountHistoryInfo::index_
std::shared_ptr< SubAccountHistoryIndex > index_
Definition: NetworkOPs.cpp:692
- + + + +
ripple::NetworkOPsImp::Stats::full_transitions
beast::insight::Gauge full_transitions
Definition: NetworkOPs.cpp:841
+
ripple::NetworkOPsImp::Stats::Stats
Stats(Handler const &handler, beast::insight::Collector::ptr const &collector)
Definition: NetworkOPs.cpp:796
+
ripple::NetworkOPsImp::Stats::hook
beast::insight::Hook hook
Definition: NetworkOPs.cpp:830
+
ripple::NetworkOPsImp::Stats::connected_duration
beast::insight::Gauge connected_duration
Definition: NetworkOPs.cpp:832
+
ripple::NetworkOPsImp::Stats::tracking_duration
beast::insight::Gauge tracking_duration
Definition: NetworkOPs.cpp:834
+
ripple::NetworkOPsImp::Stats::connected_transitions
beast::insight::Gauge connected_transitions
Definition: NetworkOPs.cpp:838
+
ripple::NetworkOPsImp::Stats::disconnected_transitions
beast::insight::Gauge disconnected_transitions
Definition: NetworkOPs.cpp:837
+
ripple::NetworkOPsImp::Stats::syncing_duration
beast::insight::Gauge syncing_duration
Definition: NetworkOPs.cpp:833
+
ripple::NetworkOPsImp::Stats::tracking_transitions
beast::insight::Gauge tracking_transitions
Definition: NetworkOPs.cpp:840
+
ripple::NetworkOPsImp::Stats::full_duration
beast::insight::Gauge full_duration
Definition: NetworkOPs.cpp:835
+
ripple::NetworkOPsImp::Stats::disconnected_duration
beast::insight::Gauge disconnected_duration
Definition: NetworkOPs.cpp:831
+
ripple::NetworkOPsImp::Stats::syncing_transitions
beast::insight::Gauge syncing_transitions
Definition: NetworkOPs.cpp:839
+ + + + + + + +
ripple::NetworkOPsImp::SubAccountHistoryIndex::SubAccountHistoryIndex
SubAccountHistoryIndex(AccountID const &accountId)
Definition: NetworkOPs.cpp:685
+ + +
ripple::NetworkOPsImp::SubAccountHistoryInfoWeak::index_
std::shared_ptr< SubAccountHistoryIndex > index_
Definition: NetworkOPs.cpp:704
+ + +
ripple::NetworkOPsImp::SubAccountHistoryInfo::index_
std::shared_ptr< SubAccountHistoryIndex > index_
Definition: NetworkOPs.cpp:699
+
ripple::Rate
Represents a transfer rate.
Definition: Rate.h:40
ripple::Resource::Gossip
Data format for exchanging consumption information across peers.
Definition: Gossip.h:30
diff --git a/NetworkOPs_8h_source.html b/NetworkOPs_8h_source.html index ea5cba4e20..20c6f2886b 100644 --- a/NetworkOPs_8h_source.html +++ b/NetworkOPs_8h_source.html @@ -394,7 +394,7 @@ $(function() {
ripple
Use hash_* containers for keys that do not need a cryptographically secure hashing algorithm.
Definition: algorithm.h:26
-
ripple::make_NetworkOPs
std::unique_ptr< NetworkOPs > make_NetworkOPs(Application &app, NetworkOPs::clock_type &clock, bool standalone, std::size_t minPeerCount, bool startvalid, JobQueue &job_queue, LedgerMaster &ledgerMaster, ValidatorKeys const &validatorKeys, boost::asio::io_service &io_svc, beast::Journal journal, beast::insight::Collector::ptr const &collector)
Definition: NetworkOPs.cpp:4612
+
ripple::make_NetworkOPs
std::unique_ptr< NetworkOPs > make_NetworkOPs(Application &app, NetworkOPs::clock_type &clock, bool standalone, std::size_t minPeerCount, bool startvalid, JobQueue &job_queue, LedgerMaster &ledgerMaster, ValidatorKeys const &validatorKeys, boost::asio::io_service &io_svc, beast::Journal journal, beast::insight::Collector::ptr const &collector)
Definition: NetworkOPs.cpp:4639
ripple::OperatingMode
OperatingMode
Specifies the mode under which the server believes it's operating.
Definition: NetworkOPs.h:67
ripple::OperatingMode::TRACKING
@ TRACKING
convinced we agree with the network
ripple::OperatingMode::DISCONNECTED
@ DISCONNECTED
not ready to process requests
diff --git a/RCLConsensus_8cpp_source.html b/RCLConsensus_8cpp_source.html index 7cfff729e2..26de747866 100644 --- a/RCLConsensus_8cpp_source.html +++ b/RCLConsensus_8cpp_source.html @@ -1384,12 +1384,12 @@ $(function() {
std::stringstream::str
T str(T... args)
ripple::ConsensusCloseTimes
Stores the set of initial close times.
Definition: ConsensusTypes.h:177
-
ripple::ConsensusResult
Encapsulates the result of consensus.
Definition: ConsensusTypes.h:204
-
ripple::ConsensusResult::txns
TxSet_t txns
The set of transactions consensus agrees go in the ledger.
Definition: ConsensusTypes.h:225
- -
ripple::ConsensusResult::roundTime
ConsensusTimer roundTime
Definition: ConsensusTypes.h:237
- -
ripple::ConsensusResult::position
Proposal_t position
Our proposed position on transactions/close time.
Definition: ConsensusTypes.h:228
+
ripple::ConsensusResult
Encapsulates the result of consensus.
Definition: ConsensusTypes.h:205
+
ripple::ConsensusResult::txns
TxSet_t txns
The set of transactions consensus agrees go in the ledger.
Definition: ConsensusTypes.h:226
+ +
ripple::ConsensusResult::roundTime
ConsensusTimer roundTime
Definition: ConsensusTypes.h:238
+ +
ripple::ConsensusResult::position
Proposal_t position
Our proposed position on transactions/close time.
Definition: ConsensusTypes.h:229
ripple::send_always
Sends a message to all peers.
Definition: predicates.h:32
std::to_string
T to_string(T... args)
diff --git a/RCLConsensus_8h_source.html b/RCLConsensus_8h_source.html index 246c063290..6d7854c56f 100644 --- a/RCLConsensus_8h_source.html +++ b/RCLConsensus_8h_source.html @@ -474,7 +474,7 @@ $(function() {
ripple::CanonicalTXSet
Holds transactions which were deferred to the next pass of consensus.
Definition: CanonicalTXSet.h:39
-
ripple::Consensus
Generic implementation of consensus algorithm.
Definition: Consensus.h:292
+
ripple::Consensus
Generic implementation of consensus algorithm.
Definition: Consensus.h:298
ripple::InboundTransactions
Manages the acquisition and lifetime of transaction sets.
Definition: InboundTransactions.h:38
@@ -587,8 +587,8 @@ $(function() {
ripple::ConsensusCloseTimes
Stores the set of initial close times.
Definition: ConsensusTypes.h:177
-
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:34
-
ripple::ConsensusResult
Encapsulates the result of consensus.
Definition: ConsensusTypes.h:204
+
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:39
+
ripple::ConsensusResult
Encapsulates the result of consensus.
Definition: ConsensusTypes.h:205
diff --git a/ScaleFreeSim__test_8cpp_source.html b/ScaleFreeSim__test_8cpp_source.html index 1e0715f930..bac33cf766 100644 --- a/ScaleFreeSim__test_8cpp_source.html +++ b/ScaleFreeSim__test_8cpp_source.html @@ -210,7 +210,7 @@ $(function() {
ripple::test::jtx::rate
Json::Value rate(Account const &account, double multiplier)
Set a transfer rate.
Definition: rate.cpp:32
ripple
Use hash_* containers for keys that do not need a cryptographically secure hashing algorithm.
Definition: algorithm.h:26
-
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:34
+
ripple::ConsensusParms
Consensus algorithm parameters.
Definition: ConsensusParms.h:39
ripple::Rate
Represents a transfer rate.
Definition: Rate.h:40
diff --git a/Tx_8h_source.html b/Tx_8h_source.html index 8919984f25..69332d104b 100644 --- a/Tx_8h_source.html +++ b/Tx_8h_source.html @@ -129,8 +129,8 @@ $(function() {
52 {
53 }
54
-
55 ID
-
56 id() const
+
55 ID const&
+
56 id() const
57 {
58 return id_;
59 }
@@ -258,7 +258,7 @@ $(function() {
190inline std::ostream&
191operator<<(std::ostream& o, const Tx& t)
192{
-
193 return o << t.id();
+
193 return o << t.id();
194}
195
196template <class T>
@@ -292,7 +292,7 @@ $(function() {
224hash_append(Hasher& h, Tx const& tx)
225{
226 using beast::hash_append;
-
227 hash_append(h, tx.id());
+
227 hash_append(h, tx.id());
228}
229
230} // namespace csf
@@ -325,10 +325,10 @@ $(function() {
ripple::test::csf::Tx
A single transaction.
Definition: Tx.h:42
ripple::test::csf::Tx::operator<
bool operator<(Tx const &o) const
Definition: Tx.h:62
ripple::test::csf::Tx::ID
std::uint32_t ID
Definition: Tx.h:44
+
ripple::test::csf::Tx::id
ID const & id() const
Definition: Tx.h:56
ripple::test::csf::Tx::operator==
bool operator==(Tx const &o) const
Definition: Tx.h:68
-
ripple::test::csf::Tx::id
ID id() const
Definition: Tx.h:56
ripple::test::csf::Tx::Tx
Tx(T const *t)
Definition: Tx.h:51
diff --git a/annotated.html b/annotated.html index abac4428cf..5124874aa2 100644 --- a/annotated.html +++ b/annotated.html @@ -1081,7 +1081,8 @@ $(function() {  ►CConsensusGeneric implementation of consensus algorithm  CMonitoredMode  CConsensusCloseTimesStores the set of initial close times - CConsensusParmsConsensus algorithm parameters + ►CConsensusParmsConsensus algorithm parameters + CAvalancheCutoff  CConsensusProposalRepresents a proposed position taken during a round of consensus  CConsensusResultEncapsulates the result of consensus  CConsensusTimerMeasures the duration of phases of consensus diff --git a/classes.html b/classes.html index f5ee0c4ca7..5f51971eb4 100644 --- a/classes.html +++ b/classes.html @@ -76,7 +76,7 @@ $(function() {
A
-
suite::abort_exception (beast::unit_test)
abstract_clock (beast)
abstract_clock_test (beast)
abstract_clock_wrapper (beast::detail)
AbstractClient (ripple::test)
AbstractFetchPackContainer (ripple)
AcceptedLedger (ripple)
AcceptedLedgerTx (ripple)
AcceptLedger (ripple::test::csf)
short_read_test::Server::Acceptor (ripple)
Account (ripple::test::jtx)
account_txn_id (ripple::test::jtx)
XChainSim_test::AccountCreate (ripple::test)
AccountCurrencies_test (ripple)
AccountDelete_test (ripple::test)
AccountIdCache (ripple::detail)
AccountIDTag (ripple::detail)
AccountInfo_test (ripple::test)
RippleLineCache::AccountKey (ripple)
AccountLines_test (ripple::RPC)
AccountObjects_test (ripple::test)
AccountOffers_test (ripple::test)
AccountRootsDeletedClean (ripple)
AccountRootsNotDeleted (ripple)
AccountSet_test (ripple)
AccountStateSF (ripple)
XChainSim_test::AccountStateTrack (ripple::test)
AccountTx_test (ripple::test)
RelationalDatabase::AccountTxArgs (ripple)
RelationalDatabase::AccountTxMarker (ripple)
RelationalDatabase::AccountTxOptions (ripple)
RelationalDatabase::AccountTxPageOptions (ripple)
AccountTxPaging_test (ripple)
RelationalDatabase::AccountTxResult (ripple)
RCLConsensus::Adaptor (ripple)
Validations_test::Adaptor (ripple::test::csf)
DeferredCredits::Adjustment (ripple::detail)
adl_tester (beast)
adl_tester2 (beast::inner_adl_test)
aged_associative_container_extract_t (beast::detail)
aged_associative_container_extract_t< false > (beast::detail)
aged_associative_container_test_base (beast)
aged_container_iterator (beast::detail)
aged_map_test (beast)
aged_multimap_test (beast)
aged_multiset_test (beast)
aged_ordered_container (beast)
aged_ordered_container (beast::detail)
aged_set_test (beast)
aged_unordered_container (beast::detail)
aged_unordered_map_test (beast)
aged_unordered_multimap_test (beast)
aged_unordered_multiset_test (beast)
aged_unordered_set_test (beast)
aged_associative_container_test_base::AllocT (beast)
AmendmentBlocked_test (ripple)
AmendmentSet (ripple)
AmendmentState (ripple)
AmendmentTable (ripple)
AmendmentTable_test (ripple)
AmendmentTableImpl (ripple)
AMM (ripple::test::jtx)
AMM_test (ripple::test)
AMMBid (ripple)
AMMCalc_test (ripple::test)
AMMClawback (ripple)
AMMClawback_test (ripple::test)
AMMContext (ripple)
AMMCreate (ripple)
AMMDelete (ripple)
AMMDeposit (ripple)
AMMExtended_test (ripple::test)
AMMInfo_test (ripple::test)
AMMLiquidity (ripple)
AMMOffer (ripple)
QualityFunction::AMMTag (ripple)
AMMTest (ripple::test::jtx)
AMMTestBase (ripple::test::jtx)
AMMVote (ripple)
AMMWithdraw (ripple)
amount (beast::unit_test)
amount (ripple::test::jtx::token)
AmountSpec (ripple)
CollectorRef::Any (ripple::test::csf)
any_t (ripple::test::jtx)
AnyAmount (ripple::test::jtx)
ApiVersion_test (ripple::test)
Env::AppBundle (ripple::test::jtx)
Application (ripple)
ApplicationImp (ripple)
Apply_test (ripple)
ApplyContext (ripple)
ApplyResult (ripple)
ApplyStateTable (ripple::detail)
ApplyView (ripple)
ApplyViewBase (ripple::detail)
ApplyViewImpl (ripple)
Array (Json)
Asset (ripple)
Checker::async_op (ripple::PeerFinder)
AsyncObject (ripple)
AttestationBase (ripple::Attestations)
AttestationClaim (ripple::Attestations)
AttestationCreateAccount (ripple::Attestations)
AuthorizeCredentials (ripple::test::jtx::deposit)
autofill_t (ripple::test::jtx)
AutoSocket
+
suite::abort_exception (beast::unit_test)
abstract_clock (beast)
abstract_clock_test (beast)
abstract_clock_wrapper (beast::detail)
AbstractClient (ripple::test)
AbstractFetchPackContainer (ripple)
AcceptedLedger (ripple)
AcceptedLedgerTx (ripple)
AcceptLedger (ripple::test::csf)
short_read_test::Server::Acceptor (ripple)
Account (ripple::test::jtx)
account_txn_id (ripple::test::jtx)
XChainSim_test::AccountCreate (ripple::test)
AccountCurrencies_test (ripple)
AccountDelete_test (ripple::test)
AccountIdCache (ripple::detail)
AccountIDTag (ripple::detail)
AccountInfo_test (ripple::test)
RippleLineCache::AccountKey (ripple)
AccountLines_test (ripple::RPC)
AccountObjects_test (ripple::test)
AccountOffers_test (ripple::test)
AccountRootsDeletedClean (ripple)
AccountRootsNotDeleted (ripple)
AccountSet_test (ripple)
AccountStateSF (ripple)
XChainSim_test::AccountStateTrack (ripple::test)
AccountTx_test (ripple::test)
RelationalDatabase::AccountTxArgs (ripple)
RelationalDatabase::AccountTxMarker (ripple)
RelationalDatabase::AccountTxOptions (ripple)
RelationalDatabase::AccountTxPageOptions (ripple)
AccountTxPaging_test (ripple)
RelationalDatabase::AccountTxResult (ripple)
RCLConsensus::Adaptor (ripple)
Validations_test::Adaptor (ripple::test::csf)
DeferredCredits::Adjustment (ripple::detail)
adl_tester (beast)
adl_tester2 (beast::inner_adl_test)
aged_associative_container_extract_t (beast::detail)
aged_associative_container_extract_t< false > (beast::detail)
aged_associative_container_test_base (beast)
aged_container_iterator (beast::detail)
aged_map_test (beast)
aged_multimap_test (beast)
aged_multiset_test (beast)
aged_ordered_container (beast)
aged_ordered_container (beast::detail)
aged_set_test (beast)
aged_unordered_container (beast::detail)
aged_unordered_map_test (beast)
aged_unordered_multimap_test (beast)
aged_unordered_multiset_test (beast)
aged_unordered_set_test (beast)
aged_associative_container_test_base::AllocT (beast)
AmendmentBlocked_test (ripple)
AmendmentSet (ripple)
AmendmentState (ripple)
AmendmentTable (ripple)
AmendmentTable_test (ripple)
AmendmentTableImpl (ripple)
AMM (ripple::test::jtx)
AMM_test (ripple::test)
AMMBid (ripple)
AMMCalc_test (ripple::test)
AMMClawback (ripple)
AMMClawback_test (ripple::test)
AMMContext (ripple)
AMMCreate (ripple)
AMMDelete (ripple)
AMMDeposit (ripple)
AMMExtended_test (ripple::test)
AMMInfo_test (ripple::test)
AMMLiquidity (ripple)
AMMOffer (ripple)
QualityFunction::AMMTag (ripple)
AMMTest (ripple::test::jtx)
AMMTestBase (ripple::test::jtx)
AMMVote (ripple)
AMMWithdraw (ripple)
amount (ripple::test::jtx::token)
amount (beast::unit_test)
AmountSpec (ripple)
CollectorRef::Any (ripple::test::csf)
any_t (ripple::test::jtx)
AnyAmount (ripple::test::jtx)
ApiVersion_test (ripple::test)
Env::AppBundle (ripple::test::jtx)
Application (ripple)
ApplicationImp (ripple)
Apply_test (ripple)
ApplyContext (ripple)
ApplyResult (ripple)
ApplyStateTable (ripple::detail)
ApplyView (ripple)
ApplyViewBase (ripple::detail)
ApplyViewImpl (ripple)
Array (Json)
Asset (ripple)
Checker::async_op (ripple::PeerFinder)
AsyncObject (ripple)
AttestationBase (ripple::Attestations)
AttestationClaim (ripple::Attestations)
AttestationCreateAccount (ripple::Attestations)
AuthorizeCredentials (ripple::test::jtx::deposit)
autofill_t (ripple::test::jtx)
AutoSocket
ConsensusParms::AvalancheCutoff (ripple)
B
Backend (ripple::NodeStore)
Backend_test (ripple::NodeStore)
bad_expected_access (ripple)
BadLexicalCast (beast)
Balance (ripple::test)
balance (ripple::test::jtx)
TransfersNotFrozen::BalanceChange (ripple)
BalanceTransfer (ripple::test)
short_read_test::Base (ripple)
base64_test (ripple)
base_uint (ripple)
base_uint_test (ripple::test)
BaseHTTPPeer (ripple)
BasePeer (ripple)
BaseWSPeer (ripple)
Checker::basic_async_op (ripple::PeerFinder)
basic_logstream (beast)
basic_prop (ripple::test::jtx)
basic_seconds_clock (beast)
basic_seconds_clock_test (beast)
basic_semaphore (ripple)
basic_sha512_half_hasher (ripple::detail)
BasicApp
BasicConfig (ripple)
BasicFullBelowCache (ripple::detail)
BasicNetwork (ripple::test::csf)
BasicNetwork_test (ripple::test)
BasicSink (ripple::test::csf)
BasicTaker (ripple)
LocalValues::BasicValue (ripple::detail)
BatchWriter (ripple::NodeStore)
BatchWriteReport (ripple::NodeStore)
BidArg (ripple::test::jtx)
TrustedPublisherServer::BlobInfo (ripple::test)
Book (ripple)
book_t (ripple::keylet)
Book_test (ripple::test)
BookChanges_test (ripple::test)
BookDirs (ripple)
BookDirs_test (ripple::test)
BookListeners (ripple)
BookOfferCrossingStep (ripple)
BookPaymentStep (ripple)
BookSpec (ripple::test::jtx)
BookStep (ripple)
BookTip (ripple)
Bootcache (ripple::PeerFinder)
XChainSim_test::ChainStateTrack::BridgeCounters (ripple::test)
BridgeDef (ripple::test)
BridgeModify (ripple)
Peer::BroadcastMesg (ripple::test::csf)
brokerFee (ripple::test::jtx::token)
aged_unordered_container::Buckets (beast::detail)
BaseHTTPPeer::buffer (ripple)
Buffer (ripple)
Buffer_test (ripple::test)
BuildInfo_test (ripple)
ByzantineFailureSim_test (ripple::test)
diff --git a/classripple_1_1Consensus-members.html b/classripple_1_1Consensus-members.html index bbf15d1348..670c52bdea 100644 --- a/classripple_1_1Consensus-members.html +++ b/classripple_1_1Consensus-members.html @@ -87,12 +87,14 @@ $(function() { clock_type typedefripple::Consensus< Adaptor > closeLedger(std::unique_ptr< std::stringstream > const &clog)ripple::Consensus< Adaptor >private closeResolution_ripple::Consensus< Adaptor >private - Consensus(Consensus &&) noexcept=defaultripple::Consensus< Adaptor > - Consensus(clock_type const &clock, Adaptor &adaptor, beast::Journal j)ripple::Consensus< Adaptor > - convergePercent_ripple::Consensus< Adaptor >private - createDisputes(TxSet_t const &o, std::unique_ptr< std::stringstream > const &clog={})ripple::Consensus< Adaptor >private - currPeerPositions_ripple::Consensus< Adaptor >private - deadNodes_ripple::Consensus< Adaptor >private + closeTimeAvalancheState_ripple::Consensus< Adaptor >private + Consensus(Consensus &&) noexcept=defaultripple::Consensus< Adaptor > + Consensus(clock_type const &clock, Adaptor &adaptor, beast::Journal j)ripple::Consensus< Adaptor > + convergePercent_ripple::Consensus< Adaptor >private + createDisputes(TxSet_t const &o, std::unique_ptr< std::stringstream > const &clog={})ripple::Consensus< Adaptor >private + currPeerPositions_ripple::Consensus< Adaptor >private + deadNodes_ripple::Consensus< Adaptor >private + establishCounter_ripple::Consensus< Adaptor >private firstRound_ripple::Consensus< Adaptor >private getJson(bool full) constripple::Consensus< Adaptor > gotTxSet(NetClock::time_point const &now, TxSet_t const &txSet)ripple::Consensus< Adaptor > @@ -109,31 +111,32 @@ $(function() { PeerPosition_t typedefripple::Consensus< Adaptor >private peerProposal(NetClock::time_point const &now, PeerPosition_t const &newProposal)ripple::Consensus< Adaptor > peerProposalInternal(NetClock::time_point const &now, PeerPosition_t const &newProposal)ripple::Consensus< Adaptor >private - phase() constripple::Consensus< Adaptor > - phase_ripple::Consensus< Adaptor >private - phaseEstablish(std::unique_ptr< std::stringstream > const &clog)ripple::Consensus< Adaptor >private - phaseOpen(std::unique_ptr< std::stringstream > const &clog)ripple::Consensus< Adaptor >private - playbackProposals()ripple::Consensus< Adaptor >private - prevCloseTime_ripple::Consensus< Adaptor >private - previousLedger_ripple::Consensus< Adaptor >private - prevLedgerID() constripple::Consensus< Adaptor > - prevLedgerID_ripple::Consensus< Adaptor >private - prevProposers_ripple::Consensus< Adaptor >private - prevRoundTime_ripple::Consensus< Adaptor >private - Proposal_t typedefripple::Consensus< Adaptor >private - rawCloseTimes_ripple::Consensus< Adaptor >private - recentPeerPositions_ripple::Consensus< Adaptor >private - Result typedefripple::Consensus< Adaptor >private - result_ripple::Consensus< Adaptor >private - shouldPause(std::unique_ptr< std::stringstream > const &clog) constripple::Consensus< Adaptor >private - simulate(NetClock::time_point const &now, std::optional< std::chrono::milliseconds > consensusDelay)ripple::Consensus< Adaptor > - startRound(NetClock::time_point const &now, typename Ledger_t::ID const &prevLedgerID, Ledger_t prevLedger, hash_set< NodeID_t > const &nowUntrusted, bool proposing, std::unique_ptr< std::stringstream > const &clog={})ripple::Consensus< Adaptor > - startRoundInternal(NetClock::time_point const &now, typename Ledger_t::ID const &prevLedgerID, Ledger_t const &prevLedger, ConsensusMode mode, std::unique_ptr< std::stringstream > const &clog)ripple::Consensus< Adaptor >private - timerEntry(NetClock::time_point const &now, std::unique_ptr< std::stringstream > const &clog={})ripple::Consensus< Adaptor > - Tx_t typedefripple::Consensus< Adaptor >private - TxSet_t typedefripple::Consensus< Adaptor >private - updateDisputes(NodeID_t const &node, TxSet_t const &other)ripple::Consensus< Adaptor >private - updateOurPositions(std::unique_ptr< std::stringstream > const &clog)ripple::Consensus< Adaptor >private + peerUnchangedCounter_ripple::Consensus< Adaptor >private + phase() constripple::Consensus< Adaptor > + phase_ripple::Consensus< Adaptor >private + phaseEstablish(std::unique_ptr< std::stringstream > const &clog)ripple::Consensus< Adaptor >private + phaseOpen(std::unique_ptr< std::stringstream > const &clog)ripple::Consensus< Adaptor >private + playbackProposals()ripple::Consensus< Adaptor >private + prevCloseTime_ripple::Consensus< Adaptor >private + previousLedger_ripple::Consensus< Adaptor >private + prevLedgerID() constripple::Consensus< Adaptor > + prevLedgerID_ripple::Consensus< Adaptor >private + prevProposers_ripple::Consensus< Adaptor >private + prevRoundTime_ripple::Consensus< Adaptor >private + Proposal_t typedefripple::Consensus< Adaptor >private + rawCloseTimes_ripple::Consensus< Adaptor >private + recentPeerPositions_ripple::Consensus< Adaptor >private + Result typedefripple::Consensus< Adaptor >private + result_ripple::Consensus< Adaptor >private + shouldPause(std::unique_ptr< std::stringstream > const &clog) constripple::Consensus< Adaptor >private + simulate(NetClock::time_point const &now, std::optional< std::chrono::milliseconds > consensusDelay)ripple::Consensus< Adaptor > + startRound(NetClock::time_point const &now, typename Ledger_t::ID const &prevLedgerID, Ledger_t prevLedger, hash_set< NodeID_t > const &nowUntrusted, bool proposing, std::unique_ptr< std::stringstream > const &clog={})ripple::Consensus< Adaptor > + startRoundInternal(NetClock::time_point const &now, typename Ledger_t::ID const &prevLedgerID, Ledger_t const &prevLedger, ConsensusMode mode, std::unique_ptr< std::stringstream > const &clog)ripple::Consensus< Adaptor >private + timerEntry(NetClock::time_point const &now, std::unique_ptr< std::stringstream > const &clog={})ripple::Consensus< Adaptor > + Tx_t typedefripple::Consensus< Adaptor >private + TxSet_t typedefripple::Consensus< Adaptor >private + updateDisputes(NodeID_t const &node, TxSet_t const &other)ripple::Consensus< Adaptor >private + updateOurPositions(std::unique_ptr< std::stringstream > const &clog)ripple::Consensus< Adaptor >private
diff --git a/classripple_1_1Consensus.html b/classripple_1_1Consensus.html index 8bbc85bdd4..4ccc018b40 100644 --- a/classripple_1_1Consensus.html +++ b/classripple_1_1Consensus.html @@ -94,25 +94,25 @@ Collaboration diagram for ripple::Consensus< Adaptor >:
Collaboration graph
- - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + +
[legend]
@@ -234,6 +234,8 @@ Private Attributes + + @@ -250,6 +252,10 @@ Private Attributes + + + + @@ -438,7 +444,7 @@ class ripple::Consensus< Adaptor >

Generic implementation of cons -

Definition at line 291 of file Consensus.h.

+

Definition at line 297 of file Consensus.h.

Member Typedef Documentation

◆ Ledger_t

@@ -462,7 +468,7 @@ template<class Adaptor >
 
NetClock::duration closeResolution_ = ledgerDefaultTimeResolution
 
ConsensusParms::AvalancheState closeTimeAvalancheState_
 
std::chrono::milliseconds prevRoundTime_
 
NetClock::time_point now_
 
ConsensusCloseTimes rawCloseTimes_
 
std::size_t peerUnchangedCounter_ = 0
 
std::size_t establishCounter_ = 0
 
hash_map< NodeID_t, PeerPosition_t > currPeerPositions_
 
hash_map< NodeID_t, std::deque< PeerPosition_t > > recentPeerPositions_
-

Definition at line 293 of file Consensus.h.

+

Definition at line 299 of file Consensus.h.

@@ -488,7 +494,7 @@ template<class Adaptor >
-

Definition at line 294 of file Consensus.h.

+

Definition at line 300 of file Consensus.h.

@@ -514,7 +520,7 @@ template<class Adaptor >
-

Definition at line 295 of file Consensus.h.

+

Definition at line 301 of file Consensus.h.

@@ -540,7 +546,7 @@ template<class Adaptor >
-

Definition at line 296 of file Consensus.h.

+

Definition at line 302 of file Consensus.h.

@@ -566,7 +572,7 @@ template<class Adaptor >
-

Definition at line 297 of file Consensus.h.

+

Definition at line 303 of file Consensus.h.

@@ -592,7 +598,7 @@ template<class Adaptor >
-

Definition at line 298 of file Consensus.h.

+

Definition at line 304 of file Consensus.h.

@@ -618,7 +624,7 @@ template<class Adaptor >
-

Definition at line 303 of file Consensus.h.

+

Definition at line 309 of file Consensus.h.

@@ -638,7 +644,7 @@ template<class Adaptor >

Clock type for measuring time within the consensus code.

-

Definition at line 331 of file Consensus.h.

+

Definition at line 337 of file Consensus.h.

@@ -715,7 +721,7 @@ template<class Adaptor > -

Definition at line 623 of file Consensus.h.

+

Definition at line 639 of file Consensus.h.

@@ -787,7 +793,7 @@ template<class Adaptor >
Note
prevLedgerID is not required to the ID of prevLedger since the ID may be known locally before the contents of the ledger arrive
-

Definition at line 634 of file Consensus.h.

+

Definition at line 650 of file Consensus.h.

@@ -829,7 +835,7 @@ template<class Adaptor >
Returns
Whether we should do delayed relay of this proposal.
-

Definition at line 726 of file Consensus.h.

+

Definition at line 743 of file Consensus.h.

@@ -870,7 +876,7 @@ template<class Adaptor > -

Definition at line 842 of file Consensus.h.

+

Definition at line 859 of file Consensus.h.

@@ -911,7 +917,7 @@ template<class Adaptor > -

Definition at line 875 of file Consensus.h.

+

Definition at line 892 of file Consensus.h.

@@ -955,7 +961,7 @@ template<class Adaptor > -

Definition at line 923 of file Consensus.h.

+

Definition at line 940 of file Consensus.h.

@@ -980,7 +986,7 @@ template<class Adaptor >

The previous ledger is the last ledger seen by the consensus code and should correspond to the most recent validated ledger seen by this peer.

Returns
ID of previous ledger
-

Definition at line 425 of file Consensus.h.

+

Definition at line 431 of file Consensus.h.

@@ -1001,7 +1007,7 @@ template<class Adaptor >
-

Definition at line 431 of file Consensus.h.

+

Definition at line 437 of file Consensus.h.

@@ -1033,7 +1039,7 @@ template<class Adaptor >
Returns
The Json state.
-

Definition at line 947 of file Consensus.h.

+

Definition at line 964 of file Consensus.h.

@@ -1091,7 +1097,7 @@ template<class Adaptor >
-

Definition at line 681 of file Consensus.h.

+

Definition at line 697 of file Consensus.h.

@@ -1131,7 +1137,7 @@ template<class Adaptor >
-

Definition at line 1045 of file Consensus.h.

+

Definition at line 1062 of file Consensus.h.

@@ -1164,7 +1170,7 @@ template<class Adaptor >

Check if our previous ledger matches the network's.

If the previous ledger differs, we are no longer in sync with the network and need to bow out/switch modes.

-

Definition at line 1101 of file Consensus.h.

+

Definition at line 1118 of file Consensus.h.

@@ -1192,7 +1198,7 @@ template<class Adaptor >

If we radically changed our consensus context for some reason, we need to replay recent proposals so that they're not lost.

-

Definition at line 1134 of file Consensus.h.

+

Definition at line 1151 of file Consensus.h.

@@ -1234,7 +1240,7 @@ template<class Adaptor >

Handle a replayed or a new peer proposal.

-

Definition at line 747 of file Consensus.h.

+

Definition at line 764 of file Consensus.h.

@@ -1267,7 +1273,7 @@ template<class Adaptor >

Handle pre-close phase.

In the pre-close phase, the ledger is open as we wait for new transactions. After enough time has elapsed, we will close the ledger, switch to the establish phase and start the consensus process.

-

Definition at line 1151 of file Consensus.h.

+

Definition at line 1168 of file Consensus.h.

@@ -1301,7 +1307,7 @@ template<class Adaptor >

In the establish phase, the ledger has closed and we work with peers to reach consensus. Update our position only on the timer, and in this phase.

If we have consensus, move to the accepted phase.

-

Definition at line 1347 of file Consensus.h.

+

Definition at line 1364 of file Consensus.h.

@@ -1339,7 +1345,7 @@ template<class Adaptor >

No particular threshold guarantees consensus. Lower thresholds are easier to achieve than higher, but higher thresholds are more likely to reach consensus. Cycle through the phases if lack of synchronization continues.

Current information indicates that no phase is likely to be intrinsically better than any other: the lower the threshold, the less likely that up-to-date nodes will be able to reach consensus without the laggards. But the higher the threshold, the longer the likely resulting pause. 100% is slightly less desirable in the long run because the potential of a single dawdling peer to slow down everything else. So if we accept that no phase is any better than any other phase, but that all of them will potentially enable us to arrive at consensus, cycling through them seems to be appropriate. Further, if we do reach the point of having to cycle back around, then it's likely that something else out of the scope of this delay mechanism is wrong with the network.

-

Definition at line 1225 of file Consensus.h.

+

Definition at line 1242 of file Consensus.h.

@@ -1369,7 +1375,7 @@ template<class Adaptor >
-

Definition at line 1412 of file Consensus.h.

+

Definition at line 1432 of file Consensus.h.

@@ -1399,7 +1405,7 @@ template<class Adaptor >
-

Definition at line 1468 of file Consensus.h.

+

Definition at line 1490 of file Consensus.h.

@@ -1429,7 +1435,7 @@ template<class Adaptor >
-

Definition at line 1663 of file Consensus.h.

+

Definition at line 1680 of file Consensus.h.

@@ -1469,7 +1475,7 @@ template<class Adaptor >
-

Definition at line 1748 of file Consensus.h.

+

Definition at line 1805 of file Consensus.h.

@@ -1509,7 +1515,7 @@ template<class Adaptor >
-

Definition at line 1818 of file Consensus.h.

+

Definition at line 1876 of file Consensus.h.

@@ -1539,7 +1545,7 @@ template<class Adaptor >
-

Definition at line 1729 of file Consensus.h.

+

Definition at line 1786 of file Consensus.h.

@@ -1569,7 +1575,7 @@ template<class Adaptor >
-

Definition at line 1837 of file Consensus.h.

+

Definition at line 1896 of file Consensus.h.

@@ -1596,7 +1602,7 @@ template<class Adaptor >
-

Definition at line 559 of file Consensus.h.

+

Definition at line 565 of file Consensus.h.

@@ -1622,7 +1628,7 @@ template<class Adaptor >
-

Definition at line 561 of file Consensus.h.

+

Definition at line 567 of file Consensus.h.

@@ -1648,7 +1654,7 @@ template<class Adaptor >
-

Definition at line 562 of file Consensus.h.

+

Definition at line 568 of file Consensus.h.

@@ -1674,7 +1680,7 @@ template<class Adaptor >
-

Definition at line 563 of file Consensus.h.

+

Definition at line 569 of file Consensus.h.

@@ -1700,7 +1706,7 @@ template<class Adaptor >
-

Definition at line 564 of file Consensus.h.

+

Definition at line 570 of file Consensus.h.

@@ -1726,7 +1732,7 @@ template<class Adaptor >
-

Definition at line 566 of file Consensus.h.

+

Definition at line 572 of file Consensus.h.

@@ -1752,7 +1758,7 @@ template<class Adaptor >
-

Definition at line 570 of file Consensus.h.

+

Definition at line 576 of file Consensus.h.

@@ -1778,7 +1784,7 @@ template<class Adaptor >
-

Definition at line 573 of file Consensus.h.

+

Definition at line 579 of file Consensus.h.

@@ -1804,7 +1810,36 @@ template<class Adaptor >
-

Definition at line 575 of file Consensus.h.

+

Definition at line 581 of file Consensus.h.

+ +
+ + +

◆ closeTimeAvalancheState_

+ +
+
+
+template<class Adaptor >
+ + + + + +
+ + + + +
ConsensusParms::AvalancheState ripple::Consensus< Adaptor >::closeTimeAvalancheState_
+ 		+private
+
+Initial value:
=
+
ConsensusParms::init
+ +
+

Definition at line 583 of file Consensus.h.

@@ -1830,7 +1865,7 @@ template<class Adaptor >
-

Definition at line 578 of file Consensus.h.

+

Definition at line 587 of file Consensus.h.

@@ -1856,7 +1891,7 @@ template<class Adaptor >
-

Definition at line 585 of file Consensus.h.

+

Definition at line 594 of file Consensus.h.

@@ -1882,7 +1917,7 @@ template<class Adaptor >
-

Definition at line 586 of file Consensus.h.

+

Definition at line 595 of file Consensus.h.

@@ -1908,7 +1943,7 @@ template<class Adaptor >
-

Definition at line 592 of file Consensus.h.

+

Definition at line 601 of file Consensus.h.

@@ -1934,7 +1969,7 @@ template<class Adaptor >
-

Definition at line 594 of file Consensus.h.

+

Definition at line 603 of file Consensus.h.

@@ -1960,7 +1995,7 @@ template<class Adaptor >
-

Definition at line 597 of file Consensus.h.

+

Definition at line 606 of file Consensus.h.

@@ -1986,7 +2021,7 @@ template<class Adaptor >
-

Definition at line 599 of file Consensus.h.

+

Definition at line 608 of file Consensus.h.

@@ -2012,7 +2047,59 @@ template<class Adaptor >
-

Definition at line 600 of file Consensus.h.

+

Definition at line 609 of file Consensus.h.

+ +
+ + +

◆ peerUnchangedCounter_

+ +
+
+
+template<class Adaptor >
+ + + + + +
+ + + + +
std::size_t ripple::Consensus< Adaptor >::peerUnchangedCounter_ = 0
+ 		+private
+
+ +

Definition at line 613 of file Consensus.h.

+ +
+
+ +

◆ establishCounter_

+ +
+
+
+template<class Adaptor >
+ + + + + +
+ + + + +
std::size_t ripple::Consensus< Adaptor >::establishCounter_ = 0
+ 		+private
+
+ +

Definition at line 616 of file Consensus.h.

@@ -2038,7 +2125,7 @@ template<class Adaptor >
-

Definition at line 606 of file Consensus.h.

+

Definition at line 622 of file Consensus.h.

@@ -2064,7 +2151,7 @@ template<class Adaptor >
-

Definition at line 610 of file Consensus.h.

+

Definition at line 626 of file Consensus.h.

@@ -2090,7 +2177,7 @@ template<class Adaptor >
-

Definition at line 613 of file Consensus.h.

+

Definition at line 629 of file Consensus.h.

@@ -2116,7 +2203,7 @@ template<class Adaptor >
-

Definition at line 616 of file Consensus.h.

+

Definition at line 632 of file Consensus.h.

@@ -2142,7 +2229,7 @@ template<class Adaptor >
-

Definition at line 619 of file Consensus.h.

+

Definition at line 635 of file Consensus.h.

diff --git a/classripple_1_1Consensus_1_1MonitoredMode.html b/classripple_1_1Consensus_1_1MonitoredMode.html index 7f8e7025fd..8cd449e3be 100644 --- a/classripple_1_1Consensus_1_1MonitoredMode.html +++ b/classripple_1_1Consensus_1_1MonitoredMode.html @@ -98,7 +98,7 @@ Private Attributes

Detailed Description

template<class Adaptor>
class ripple::Consensus< Adaptor >::MonitoredMode
-

Definition at line 307 of file Consensus.h.

+

Definition at line 313 of file Consensus.h.

Constructor & Destructor Documentation

◆ MonitoredMode()

@@ -118,7 +118,7 @@ template<class Adaptor >
-

Definition at line 312 of file Consensus.h.

+

Definition at line 318 of file Consensus.h.

@@ -140,7 +140,7 @@ template<class Adaptor >
-

Definition at line 316 of file Consensus.h.

+

Definition at line 322 of file Consensus.h.

@@ -172,7 +172,7 @@ template<class Adaptor >
-

Definition at line 322 of file Consensus.h.

+

Definition at line 328 of file Consensus.h.

@@ -199,7 +199,7 @@ template<class Adaptor >
-

Definition at line 309 of file Consensus.h.

+

Definition at line 315 of file Consensus.h.

diff --git a/classripple_1_1Consensus__coll__graph.map b/classripple_1_1Consensus__coll__graph.map index 072a1f3d18..72315cd2c6 100644 --- a/classripple_1_1Consensus__coll__graph.map +++ b/classripple_1_1Consensus__coll__graph.map @@ -1,21 +1,21 @@ - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + diff --git a/classripple_1_1Consensus__coll__graph.md5 b/classripple_1_1Consensus__coll__graph.md5 index 3d97da873f..fc48384fc8 100644 --- a/classripple_1_1Consensus__coll__graph.md5 +++ b/classripple_1_1Consensus__coll__graph.md5 @@ -1 +1 @@ -80b6f4570c69f3c4838c7b73cead5dd1 \ No newline at end of file +6117d9a4fca25929ee529a13145e8596 \ No newline at end of file diff --git a/classripple_1_1Consensus__coll__graph.png b/classripple_1_1Consensus__coll__graph.png index 6c402f9be8153bcb0e7cf1385034f53b39f231d2..2710a5205aed8832a42656d043aedefe54f25ea6 100644 GIT binary patch literal 118029 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 literal 117307 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 Hje6OQw`O8nl_oY5M85$m0Z_^f=tyf(G!4HN9V z3ybIWQ7P-zg$bN$9!$JN0{Sg(=*RjK8wpbOW>NF&Op9dr;}dA)9wpN#O>cL;{d#7E znLyQb@k#qxWM`}lf7mYNhTZA9WgT$>j`cmy$#!AdE{rmpAl+vKDZz-A4*7ARuKG|Z z0S2LKWhD)*nV=Izt(%;rg7XQsb+50WQBh@Un!?m%I0B8`-5(%6Z9_@&M?bv?uQ_rQ zBwRm792SmLA(0ZnV$rI(t4YI&WYBw_s$?HuM)pbxQv)+P$L%U>@Zn{ycx|I4^H1}u>-1l48{A&sKpfqKG`s*DKT#0W>5Dcpoa4!DK*_G7AQU%94uRr! z{5fPJ{n-LyfFER*)<5bofUA5cEbPT6!~VY%xSvj-YhD>To1ss&d2+J0K7tOoO}HTr z03hZADm6%O3kw+O+rfgjpCfBlj7-BooPQCuFUZ6$k#P73o$kMcEd444#W%>r{cpXi zIb3G^6goRQn+LT$bUzxOI{n{O#}7Zuy$W;9zLrO#?5|k)2(x4Udxt-#*R>J)*y&&t zx4QDKn!Tp)t>;MzM;t%v7IcBZ6n+<;#j^5`cnZSi1bQ(X*?(86zPb54lw{DIn_pPi z0PGG@sC8^h{~?PTYfpDsV`5{Wo<#?0k>2(@WEp-zL9BM8cz-)6xlH@s5NSGl1I>hx z!+%>Y!IihAzyF$(lM|%yP0%|fDJJG$egXjp@fL-e|5|g*pLR~T-(n}z&f z7DW6^w$RLl^pAqp<13KG#&FO6SuW}kr+mgbi=vcPBk&ctoSm@AKP6N2qWQkDgR2zk zQMsIO`Q439-N7LAxCfc>y@bvuEHeU#{2hf7jTAK~v46}&TjvrG4cC!u0y(+qbfBCW zu5#f-CPe^^nl6`W3kd*6r?i+@{lo;N(SiW(pnyHS#dYC+f|}pI>3vIW2 zyEu&JsHar#y-NK1*N*k@Q80^cwJRAn1z|_O=2@oYJ9FMNQ`5y$y*hW6AX%##@bPE4 zfzBn|BBWDK=hK9-vHNf~G*2f963gE=_$PMtrOCV_<-Qow+DI4g{sIs~&3XT zv=iXv<;~Hml~PrW;EHD|vlaUv-3X^zJrD8K|g~kJ*;({#rDv9)-eE{O79 z^qz*9NP0i&eL-RZujm2P=g5nxV24x((X9YMD@^9m^M~fU4{0ud75_*!(|$siJ`};_ zpkp=aj57cdfv{y1pdV<#js$K9mhu)YEeCWQzrv*oeEU{B-Gae?_&-ulD(21?$VBhh z&LW}a2M`!3ny^qGcjO!x_MHYG3{hvzoE(w(V2xH)uq@qeW5AUZ!r6-^!|>wLjd;90`Rv**ruFx&G%BWRMtvPy2*6gnmeMlLl8v1RR+#FO$>TYFb;fA^Zkl8}>hk zKKv0wrqDac3ryLQwD6$GnKA`e7ByOx7Kvb^ZQ)tn9Z) z433_)oGLD{k{hp%DcYFH+~DSR*i9MKpAWnu^5^l)CSJrvi;xj=nP;N=k1+NcXNFl~ zLpDCFxi!$7t?(gHfimx6N-5c^@|olE1d5QFCC4g$UC3``SgeOJH#3{2haL|`i*-ho zKUa2KavTp^Ywy=}|GbN-wL;fYQIX7*jXSI)SZg_5o5@r0e)jM0)kKQVw6rvicE}|g zfI~Ioy-wXIN?sHv4W9-m{P zYS=*S$%hYT4*twDl3GUmBpYrxOABcJm*pMYsaq+KrN^SKGKIaZx}r+O3(Ui7CKw6V$Opuzx>e`UUUTb*^M2Qhc00uql&kI@q-f30 ziC4XTgSt0LQBLoUt_Hd=9okLW)Jey$;XKT)pI*y+GVymc!j1d=}*tSRqXMg{4UOo4EhYuTuj#wsJwmm0?4r-!{ zQ_yHvE)0kft9{dhF~ap6B`|46rf4K_DlL8I>Y*jukZ@!xh1ad{)zhdl)*qF_9)p-g zZP*?UWj0=*y;XEQ{6d>b&drCYVQS=Mf_Mt`Mrf6&LM6E2on4C>l0du2w^~epk3c! zfC75!q*6lwhfEAba0V!;Evt72-Yx^(@)8JDD1EVoB_t%4m_mUq%u-~87j0m20^BF3 z#RwNr$QR(Q0}?C6LVQFBX+nkGe)vWZFn2(fBCC22WQU=$#INoH{mBXlyy%5+aH07u z9WMn%HeAp@V4T1Y01D>;o=E|R04|G>(8k7x61_WopBZhY>QDhPZUw+hEcY&86o@5F z>FBo~4X=mG?dTBn4uKMYFdcIk)W}jR{hsRFc32VGqIOblx6lK7w#PNRCin8~l6Rle z^K%}Pm%L+@NO2)Q7oJk@q$pr1}|!EV#`=M&OcEghZ+PdhCnkwu9gp@Cm>Pz4vmWk zt4 zu2rnCz|&uzl9Q-09k1YCuiCy0>}i8x;RnF}pxXP|)>f~Ze+9Hskcm1YhDZ=$*xA{+ z%!f9T?zO#5&B_&b$tilSkWE=LVtb=fPbicUdn_msebd}MlZ$JkuZLE(KXUeaaLo$Y z{F$>yUdopPTH%C5g^2W>fm^B7U20^nnP)tU6t4=)VNe_Q6Q@K^MT++BS2a4=LQ9z~93POZiM8Y@Ga;%e5T{MRxYD=50)SID85W|( zJ#2+5IT9RwAh(^bSjm}56*{@i68;trSV(mAikyU!F3cZBSSM&p3j)Y)GracLm&~#Z z6(xlL=^F=%2x=040H}3KN0C-3c#oMMoZApJ#U^~YczCA3WnXdS8Q1c|k`G=zgC_K{ zQC=LlzJnJZESa9D=O@erCU{L9KQgqg>3%{c`HTBrb#B$HsA<;9muY>mo7oCiuDsEC zMbJX@IqW%4tBKHZc6GyY2U?O>SG^z>7SpFYe!l15)z=womkxRrFMm$BEf)XmvrV78 zYmn?=(JOq_%wEd|LA8k!+H!LWV8h?sa(uX1P^l{ZGjyYbNY1anK}k*Or+&hK>3843 zYdD%c71m#aBRcYIRPyPbjbs;5x5hI3&1M?8^`UIAU!Ooa_z<~JP|yNEdGjy{f!=98 zkQW(JWLUTfs**Sa4uRkavvAyHViy+|+b0(0=L_6Q7Yf&WpGM(bTteRVbP^Y;Aoz})&MAcQ*==5aGU!xBe%`;L#Wpu zAZYi|ui7-QUVMSfSM&mgdgA$!1riycW_#77oBqMswEjS^Yxx<|k(X#Dp(D1XR2#FR*e7$k1i<#H7b7cAZmv~gIwp;ZP=L`m z9DgdKp|hU;a(G(*sS&CdVrXjsnuPe(7nn0u23>f$`W1ukmNcMu=M;D0S;0 z?tKSxAh#?RPaz9Yw3jI;#cqYRDy@n-^h~UND5OaHq|yMsZy|q-NQ^s_{wx?rzSGD zMI5q}DRY~n8%6vIV`rOQhAq{!uTbzbcq&=*T`l5GvX6OVuW&Opee72Maw%KkNpSmK zMD0vDo>=D5GuP3^tRV^_P2THx^p{L(7f_ZGLV3Ey_Ri&?{S#%95uy}88ARg-=8!_p z&>EytY#KJ$TcBEOis{mDF*N!=%4dxy84tbxU70)z@Lj<)vap=>P*pwm+{(zrp&d z>}wu*!um-hb8du0#~==SBt2BBZzJPsjHe#tB#%9tiXap-o}xyPuPg^D%8YQGx~e4h zta|n6UBU@XWEiS_9J<~{WQhH{*fj-=>7QbE@D4)c0d?pCbF08Cvr*Il?rP8&yo57% zc$;5F4Ja129aanNjJpIMu`EQT~+X(qEKa8Dz z;}9USH0UK9`utl@p7!ZYt<%|1AwAV03-L0VghexL-K6$C&zchPVt%VfnYZyd^ynD- zM33?XvcBVb>p_KQ>_wo~%zCL*luo}%GY$*y-UkDf-*ww=#6T1xk^y(6wc4}ip097_ z$Tp?2d!V@o>$XRv6(8PS#AFhi%q=#Rop{wQf;AZ_7SC2B#!X6CW&5N1$7xb`+tn%6 zPhX~4E{(ac-B1sw-Shm`Z?bUTkM zVX+l#Y-qg+Q{e$6I>)bv85U2a+^9F$H#VWX3zj+`PmwVGQQNbHCZmZ~TV_*y|I5Sh zRrINs7a0eF<)iH~dQ7i>wpsXORY8%P^ZZ)TgG^gqF(Rc$f2-16<<_gy6M#DP%icm0 zJi20%&6wjH_GWTmPH=7V%UWVJ`C3eD_{d@R zw*CWyKlQZF6@zw^=0kxu6}mQAnQ$4K1>U6HcJyqK{XpX}$jc?E$M^o~0K1!%!(KL< zrObOi>g30UO~t;s{{aqIG7kuw^-D^L=X3qL@Vz)M#+(MG-|%%w#O{K~ld!lz(-NkX z%p;a*l~La5DsA|;-eiXw0=M?CKbOTdH&o=dC_qYJ#({7m@7|f|J*pbF{8ce10czf* z>ag95SR1QOks$9e0)-S@r@dfP2nX*gfa$rWe);^%Z(SL&_nGrh?_j(`5%C(_B){o_ zwtwYKRl+xUZC>m1`$XE+2~0%9)?bczyw2CR5xdc7qkkkA9G35oPPdXZCsBOeUtX^p zA>frrfAUU|pMkpf(8#kzF^;#=92?b~{;rPup#@+6JugLzVjV@#+TEDH75lO`5IKp( z^RulXh;s^rLVsZ8^Ffa5`C5?%#4r!dG!833`|C3M;j!2x(Y0#_eVx_6Cd45Rg!Bva z5D0=d|2f!BJSLsc284rRtv%*| z$xntbQ1zbGRCIWF3*hOXUrYj;8AwkXgd7F`pn6bpK7=?3M3+891ag7BNjY~tU0vt3 z@`c68S|NZ-5fu@rJw6q=e|dochoig9Mh}@a*FJ})4gG|7Vx^D?gtGo+WsGO;F8^OE z!knU0=$VV;u^@#s0FEL%)T2<-s-+WqWD5b^^y0+}Vjgp15QI(p5@~7!^P%K^HXZfr z{KmDZX3kzidN$O~pD}{kv|Xr+Xar~rZ*z&JA}zM{S6{2w20(2u%vgOjdri!CI19kL ztzojmgO4UPV)Bl+KPI~k1kgD;-g!?RGMt{Zg_1Igc8=I^&38~P`+Fl2pBOklZ~RRy zAKu*s;t&yCoPtZhzPu--7G>%za8DzxE&0Rdh^pBO$TO)p!Ka|p0_ikRSIB7Xw%L+fJ z6?LQLueB_ioq#M3nGXp`g9~89U!l(dK+uV5w;Ag@;IG(tO$ggYvSOobF>PAt*Nh57 z%H}N(5$`=`ynDE4tTV%xT-dv+OVF;Jg)J5dg-4j2RMyUr+D#Wk>o)YoYMFCtNEf3V+h}jS{ z(n`W7M(vb{0UyXPaLek+P++Vp#{+ zz&m(Y8<4jsnq`F-C^I3$*pM&syRM-ir$dY*AiZ@4^?;eZxs5`ZwduHK z-MM;HtFs@^pB=+6crQ=1Y_CG$dsp1=k8fOT=3%^QRh^eN`f=lNsiV;J`kfs9SA1yM zif+*d$)T2+iPyVLj@Xx8tdL$x33IPi@a`D9id=?iskXL)wRbF_rtx+7^>g@TlP-Lw z%LaS+SFQ+yc2hhz?3R~UGYS^&+4{oQDecaM_TyuBpjMUhbur+;-U4J09=8zqAhB^d z7lbH+PYwd@6ll^R3KM`37)` z@@_HVww2@VTdj1kYhQuN4v|X&Tme&m(>C*)6pW}g?&T45p7IBHQ9AF9T|iqydyZ*; z4hWF5tT%6ccq^si^&?ChTZ`S9o{`9r0t%bWjNh0{4l|fvl5EU};9LhT50CCPZRs!O* zU|;~RE+sAPjmObxrRyyLfy$x|BG^UqfNU6oNCrW_V8EsIUY60MOhekCkcwn468A2V za=n2Lp*-hJ-CTzU4<1B<_zoJ{7NCl_#leBszy>Wui=xrIX4xcy&ekcqJ1M6~TN}`n zaF5_1uEhNOQJ~yGB&;A-#=>S?@wzF4`>wgrZ|ia0)hS%(;JXW6otrTUyH~Broyp%| zN)eUDVsNz-X01G!s=nCldV%OxmtBGAs%iMV-fIZFBw z)6Wtb!KRNkCP^u>mwKJChWNf1oQ$Z&CV3^Pv30a`s*Q!;t9(W8aS)~agYzGJ_$Gk9 z#|uJdI#7@zz!b1Wpj9pUc)Q=%7N}Yd|9gIWQG8 zsCR%O8Dz>j02V=OU!MI_MHi&aJ?{CT30U7EQ-xO@L*nCuOk52YOW`I3Bg+Lv+s2+w%^}HoL9ar$E&XfgTQa8d8oRdH{e13xN1X z`kjC%gl#_uB}SNkclaUVyA9wwx?cZmfezmXX%%nTN-;QD7gzDkdT$f!ZB1oqbWCeG;WJcr(d}AxaRqQz=0OR|oec)NIBk zu>i{;cw4Rq6SR0C0S^e&XgFOlQgooqK-UH}3`n!PvekIadB{LL2ruw}U=$`bK81!w zaPIvCmw89LP&^35@bU1_>cA)907i6UUA~;trzr>p&;m%IbfDn?(Xt>V`5*oiK`>xG z2Eq_RgH90AdkNb>R!&X@bZO}4FQEuV-=DPal|*a^H#V$+o~#FP4H&Lu$iJ)U^Mp1H zl`?B;P=6m?n=HJNw9GXm<0_;&PBx%p^tw@ErRrAdNm}hp28&qcAPVeW&dd=dpZW#F7M4!^zXsa3(7|1#}se>i-R9bov z+J6R*Iq+rlMz$yMD_A_3ch%&RWZ_kPxSZK5QOr-37I=!l`v9OQi0+arE=&S4EEHzr z;pyLh;Ox*StJT`9{JXk9+xWS8!{>_T&o6~OnNm-HT;UB3l>EB5nO>`xZV?#KK^zc? zRuwZm2`EuFm*>hTU-mSuw5r- zkv=tXU5*C$?aHtF5Au7K6L&>cbE?U~N7<-{MV6(5c*a;q| zie)~2_sD4Q`$SjnmO!zVo?$YMxYtT2>DU6gKjj-O{Pmn~o1?S7CA`$n%p6o~AIr!7 z$5Zt^rCxY3fGUJ~niCdx?l|RLNYt|LFnzE0HcobbX^_R*fu2QBuH<!iHAFTaZK zI(l6Hhs5)_;t;G8A%}fwJ3%OzL@D`UxJB{gd8K9kE=*dh726Rj_CB4z5gLJszNz%B zWUkO(GQUfm+)_HR9I8ZX8qU-4q-bPi{mwGO-vEVF^R!jNdfPbOqNugPOGn@Ab})F* zo%Z>%T%RU~i5%2?i7+W@U^~-zN!@Su_s4G(0`lSc`uaI=KiqJ_5(&M{M_U+DQ1+TW z`?+`YsLWxOh{rkCPgi5kpsZ5T;>*ezB){_#pf10A+-x0BaL$w(bo$l)`C<4CY_<}; z$A!I1J5KcQ;0j{-2Im+oJ~L+f7xk=!j&8N3PaR8twyL^2Iho&Ylv!zRX8q#D2h}Ad zj|?IA;<-kt{$_eT6-9sMf zGbgdp>8^C_+v^@5%osMlSszu7_w9^EUv)CWk6r5AwPQ46LxS@x+bO55XZDt&!ZHag zH_P>8DzZ&T3%{F$U3y}h8vGZKL-ykU^V$bW4gHKSuX@OUYa9BRtqH}hmHvz5PE|FH zT;nq7+reh0moR3y++*^J-EyRN$zrUsB^$CO^d?gbL@mX^s5@o(dobBu*e(I z(ogG$ub?P&GA+X-R-XOLXyQ8Cs{hzR4+JAWc+E0 zY${iEDae~OSiMB#?2$4raAnVPxUG_QH~};m<>n4-Vr#j5=YwZP>+6~l_9D`xu!Bwx z=|PSFS`@bishFH*wiSy1_Ej4D2-n4D{9256ztLaXak(9|F@D4C(BgBtBC0r4SA5*u z-_45>!^~n{m8Kdx@h^yz1t_MMS;~Hvnde}~Nvw;6YT=rKS>Eou|IUxR|0BlN--h{G zP0mV7`7f}H{;Fd&W6yG>fqOZ`B*UTZ71VAarnXu0r52WtWa@a($!kiU2DbVa3BMt$ zVJv*nBiYT6JMtnc^}m-_Z)CMM|RWam*PYI@o8oFdceI|Kc)f%$v5Hxm}iREYN} z#e_6_3$-Xm$F?79e+?_TfJI*+8h!r0s)v?h`KxCbbeS}DuK(145TV-U^7z*W*pzR3 z5Lr6hd>^E!Wt>8!d}+JagJh5DghJ0FY{Owp=X&d;jk5u%hS$kVfv$9@LYCx=9mbIv zUk3l<|9Er;4$b?R+RUmack`B7S(_~u=~Bu3E}Eq1bu+Z99YDAj^7b6iec}-O?;<5p z{-!?zI(dy_W{aqH73s1XzQ3LxY^*fnWRc-DzC^ZIdngcCA$1^t@+bWJTq!m}V5h4t ziQ~nJ=+9hHHt@A=lG=HOC-eO(S^y7w(Nl{nFvxc2xmx)4X<%wjaO6Kkzf4Pt<7iLw zCHkm@1YVb&o-6Nq+`MqaGC$qu-S3!W_uu;Vh%B+1=e*>kvs+EAUb%>O-TkLO`u;Rx6bGHhDgbW*S9CC!$#kiuMeF@o}|Z+^&Xd{ZREvda^KrPlUa$wzSQT39zJU(nK#X&M- z?vcu&owu8l}@oo(3ak4euTX3vf&QyZ$x-W!kkdqwF1;#tx4^ zL_5|U2u)P%zIr-oFR->wEV?UJ%(sxB5d7jbU4=OnJfz8Z2^Y&V(PZw9bP?VUZCv+q zN)jGMUh>4e{#UAyqxxg$TgGueMa^&nlOnMIhw6f_aTCQoC)mP&K_M*a#^Ntrr|DCiyyg;Z z?@lxmi)tU>al?Ca)lBxp5e!}|sFoX@F@s-}lP;_p-21$U!=uWfg-CMjfU7~=)@YML z>(%1%6y4b8O{b|*1|PNcr+>01*viM(0c5`)`3Uz?A*Sjs%ES}~j-|I}=F`8+=(v0~&NT*0`{j9#dsxE1THv1EQf=%r31 zd`niuuM(#0``?aLyravZ7uwVCtOB#^fmzPur5l2rggxv5>O!ySbMOE;pi5U=u(%MZ zm`c^)Oun!7qJ7W9fVA{Gwnz1q5n!%XtNUeM4HML{1yr^9(u@7g{ov_MU-l@t_eGNEmnr?CeZI6&%AdKxf51aB`@DQ2S@esYEe7S#%l%%k!4+u# zy?N6@MvZ@t^BBp4sA@}+6d!&x*6GpPb_sNFAi%wI8Z zYdKQvHA6NVI<~X|i-e5GznkjEOTdm2M3h10+XeXN&X zKR6IL?->=qWBI0aIe}@77$Oru$3|{P36XGRt=-5hl*?(aFym>BO*4eNe?PT;<>B4mXv0yK z?5K%)FLDEos}6TDJTkfV($)bzDj|$4rBuNDyU^5ZTIn9XI!|Qc%?yO-$++@svMVEn zqoWrB(1=Mt_Wonhep>yVuje?-?j=-6|6N@rlFIQlXYevTu@o7f@Us8lBo?*reinY-2uO1y!$T>ufJ9(g_+UKS3l*}qC{dy3Y zKlxRnG>Yz@jnK$#CX<_+!^mJf)bFMC>`*b=-WKlpfYL*Typ5dCt9ujyzw^I4z9`m> z`g_9BD_y3gJRrZ}Th%o3)5t`mM(6Aum1A*}cjnbz<(f2-dOlY8_3vr>QP>w3txD@o z;WVT*L#Gz|i`W{sOZ2|dHaRbG9J8%dLO)NoLgCg39ehVbt{IIyH4BgdI1eMuyl_U? zW&p3uG|VLlP`sRJR#3^d5sQQ=O=b@UitM5hM!&w1e+6L=ePy$yq92_o5?wvFv#msa zak?vm=+!~M1uFDOVqfn`8uQh-mD~uQw6D<`CB6w4Kcbmk_L-+4=(H?1{iLk%@{+Q) ziS;RCf@-jU@imN}IUj2t`u@F9Wr8U9?cadfdJ`}Wq$}0)wHzbNc8*}vK?9Zhh7^UKX zDMZi;c}(%BIGyoVA^cGfu`I@G4PzMuLYM@`=qU|aE4vET21gE!6>Cn)v9Hn5u!C-A z^Psk>F1cNcK_z5N5y~iuzB0{VTTJT+^(kuIYD9CD>8kP)Xy!V`(rGyC{?wX*1*5Bi zdqa9a0}f0khB7dMT9oI2HG$MRd$MzyGJ2Ho8it@B2VD|MfOpMecs;|cd9ty#TB|P& zd!){qR}xwAsBMTz#KBXk%E47R$$iZ)>Nu0Uc@d+(QbvD$eabJg-_Kb$`G=Xf3@NO) z@r`FAX0~+2qaS(r6BY+y6JmI-%_u1S69C_cM|^GtSuf&ETn-JApcDC6`yj*St)2$6 z|D|oeq#H9fp^C!S54T)N*+P%}2r>(wnK<0EwoBwt({#9s0Yp7a_UXz(P zdPPLt8>B!|$wv$gSpyzLOsb+$+U!LmbJ>BT(}6tN!72nBx( z5!f3c?ZAI8yuDDP9&8z``D5Ra@m@|L0QUkE#3T0p%kx)BN!yr9$LgU7ca!l1jYkU9 zcAAq^e6~KXDP7+{C5&jDKq-6&SZos)7;prVb1taiX}P!vGW*-WxLUa1;<2ApSVgcXtT@{f1U`Z)hH# zo|&m02=ep$5or{c2=aBLkqU@hO-G@*yZBmdtPaq51@HBdzWy!fZ%2?Tc!WcHPlMm} zmTcDdVNw6P#&N<+=YpfWg9ODka%Ao^K z0Plk`9eYVUjEI36{+~wM1wVwbxG4o3d?;Lkem^p zv$k7}^ez)OZ6>aY{3u>(R6*LH(%_O^qi#fy{9{jSSIdhj&vI=WHlWH;O|Wv=4Ko?@ z>Uo@764H>P@b_#_lU^exM#vp-3`_ys8WD0ro2*-QEp&$?c1@ctLZ=^KkAf|79bjdw z8QUQ50jn*I`6Iy8Hla^y8=8N5K$SF7V$lw#0x{=k253)w6d4Ev=nx+4e-KPh@jECm2;&JH${2w~)nj>)pz4(cy5vUV8Doz5~eo zR7wgl0=ow$os@1r*)3~N9GM8;4)R}v4IHlmZT6r+LuOR~n}i%XgmwptdKgqv2D{aK z;Yy9C-2U@IV?K{~72~uH;|8bNCwRRtT5h?p$xQ1BW{z-KU);Y~woOXO8TdAYhoo-k z;&R_p5D`X?Vc_r*vRaWU$GQ#neY!wqB}8~7iin%KL6bQ;0`nS1BP!urMXe)Qt=r>x zcjPJbu>a=n>V^LcHz&;9wX?G`fhJdQ~cFQyO>zV!v+5V%Xu$W@`-Ped&uOBo*V zAo2d(Ex|ZWmSRMjM?U07N8#p z6v?jOc**J?rO(-M=b81!)P0FweGsM)Tyu%voh&dAM|Ko=${ZYTcV583F#xg=klt+& z&M8K4Z5q6icIj*k-@^MN9|Ci?ZdI)vQh?`uZ9)yy6@U5x4Egq9>dEf8a0~gQ_JK`z zVHs?L2qDg}(}3n`3GN0b)l9kq zHvbwHQd#8`xjt?XP+dB$q2*p?z^M*3G2f~7HudY_uuF~ld#O&7?t)$L7O1#GKpv{2 zLk$5Gh#!gG!h+AxMh@mz#a#J_t=d}I%w^>GA+}10g;1{N$;#V9CaVW?05OAKLIbeh zNJ|XtXo*<L7}r3_P9%{(PI zCVx}U*)S(2g-eRC>^}+%V$9~AqVxY4PW?o&VWrJ{cG96J<6_XPj>Cnaiz3iP*jb3u z`7=w&>qFgcT}a(a%|jCJg~)&gPH`ygX2OVZ1Tn_E7UCvZ*0#l_(`|5~W5oKzfW_r zem66fa=};OoEM@H(y2dpy75{_yKs026zZ9Z**B=Ey%EG6#-}0N3iR-KP}%{|FL=5? z113Q@DFnbQ{W53`0hM)}%RC8UegdZVDu{Zixz3+En4?DrJJ zvnC`CKabi>6;3N@^js!>L1!ad@FR5Q;*m2t%cyW^mKlx6X2&zW03%0nGHv>}6giqg zA;alN(Y}=Z&aJlE^u~y8=eLtZ7F0;W;pFS;T4_%Gwc&B7M=`K0k53lYI4XkS7$)3MolO)44_;c(ANw8@Fq!qyShQ6* z{+Ms3x$yC{$)K8*zH*0q==E0HI~Te*pH^Q|!olk7{gbKbdmLU(!oRSWH7jN_vT(v! zvu4_zRh$jy)m1e)V)Lq;eW>`%Not`|!puq0n_3}N`AGBUsnR<4PzdWr*QO7IH!#-Q zRRa|jgR@|jqRC!QsZ_{wwCk|Og|tNxg=_5})*-(*@}&_?i?6^7r>cZ^(>3c~Lfj89 zH>49}Nc4o8=&}zuG(~f6QQBMxP{h{b7#)+xc2~k8_6k{T2%D%7OfkeCFSem|h*k z_gSj3OlDX62gmH~UWgnhMUhDH^zQM@T4R5B@Xs@4NJ0(=z0Fx=x_4yiz8~%u7FQk&jTdXGa*Wrqj3>K=li|V7=xMlbKKv|OncSTc=LlG4nH9-OCREfpwBP-R3Ht9s%BG;d+_sX8acPqtN7;vFvBMw zpc1Y7%4-Vt-++RL9?kzW?T4jyWJy`+;H+~o%?%#APp@(k%w~M@rIu@>L*A<1_}dw< zTn0{Jc5te@p&Esz)rZKKRtT6tW1e3AW`)p#p|bQTV)3m4>s2$Q&OaRmpjUf$bYG;; z2?4OIhd4ejc_n45E*WE><7t$11NCK zOS8cQ4aR!|8gKY>?oLSKsV$3RBCD-7=WCeMPmYsI7-K%d{Ka7V1rI;H&p^nT z+G~67)LR=?+eZu-bMi#j^`qLZT#FB{;)Pj(2ygj4l?|@4^!N7t9pACWSZ{b_Rng~j z?vHZQERUW08e2N*Yro$L3tXjhx$E*@Oe8fCH84Yc#HZTF7u6`iRu^>iU}ghs_NQ>J zN(Gi}4G#bZs5w?B5~RyA}Z{VGBf4@d?4tK-17s0BkOW(qxd?aX_!O}1 zBXw=d2L*X}K78XnYLA0HbF(H5=?nP z1R|9c!11iafhjCIO)l&V%D*15thHc{<%=50w~)5$OAhN@2rjm?AmHhFu2FC+zn9zQ zbQuawOVHQ@g}4)B+3=!G*waQrQLm(|jMAadDh~nvchbYEv%*fC&@0sQ$f5Q=z_+;u zMdp7a`Lo!c7}~MyN+pB9iZiiW_G4ej;`(({A=?(BF?^vqT0&*nQBhO(=2TwHD?L|S zUevCJR3NyAXi6N>kt6q^)c_(b_(ka4*Sav1F{a+jMo^I%ru%9npKaAq*#3paw_IB3 z*&D^8VWmuIw4=;X~ujB`6s}=Z#s2&D*CnP{RX@U=i zn$)RRy6^(M6?i^Aun=vbMS+JG1y0r|`2vb<@}R^2xfcJw@mTyeS=e$OFFmTSc+hwf z6|Te9g$~BrEI7y^p$HgOTl0@Sn_$Ml5&(}eJn2tWAD)mvpJR{ufv&8sI>US1muE;= zz1{MdA@Aa|GybmcZ>7|iMNmpV?v^gT8a_0-7&SwgWhYj{JN?G8A?JOpDdjwd=KGve z;NvCjxPR;vl5&_-ZNW>k4YLr4zDRUloerGYs^rQ6NAwU%vJP+tDgCin%|T=k#X zxcbfA;;{*?UQh0Md8-Lu{Av(IEZ3>7fvfl*PQ!1?gpAz}y(PzE2V+xj?JrVn@g)7~`*hJHz2?z8gnzL@Lg`7;k=H-it?ORq86eCwgOc!J3! zBBG|*DV;|seQ?TMYnEBw1cyep*mj~;$J4!~o0ofV-~lIdzp#SEe9_>1a#oM3S@SVp zbJrA*+@F>q<5iBD-QP9T$H6zkdJ!+Jy9qmuHLnX)WSd7_7}D;Y{1q((PZ9mficQXW z7J}PQD=lgKt`kJN3;B3^O@2#BVk(~*tXzH^FtTL)#Zifws3WP zhxZ9j_g#&|)ek)8avO@+fgFj!LG9UNI@Z%~Qu`D_PK?w}M8%~WTL1fA26I_e&n8|F)cgFmy3u?Tig+w(Rv3IMTr6g}JR&(U4v#*gd3P?RH`H@!wst)vv z?S@|;MV3Tm(rgJ$LKV53XYM!4gIRi}!Kp`Vis_A_;#fW6rO%132Eml!qjtL;OpIUK zg6n8%bN|;5P|&DZCdNG6mTruFQRF2Q(As(QGwyelDb6Iyb2nbh97oazB`F+_efmWL z94|%UPze68!=tCaDccq#aAM>_qU{HY7bL48-IXUYId_^bVRlSvtmXZ6wB$B;m>Q+? zwN!c4iZby1e?JtqXTEN@`U&j@Tk;hocnW45)xeu zO3i$sC)bI-a-PEy=ohemHM3(kLlh0)jWr1jlN>Cs$PEoV5y@nw((m%9#rbm` zWMr?}Sf7~mHaxr}-guGp7~T?%MCDn!nb_AF)^$>oi90e}{Wua2KH%t@O`R>vUdPZe zVjh-?21t>s4_p9kC49wc;3a8=izr^FIr-85#cS(07A7viGrTcVKdh3*DDn5Q-Wf8* z7n7W}s!U4$`1=vS=igRNnHuQ7T*3eGh?O;s-W{&~g-(g}H}jlXW(x+dX*pG~l?5~t z1j94hSkSvlMyB28NyJ5O96Z3;SE8bWi-A#@+4hBLtaC3P?=45nnTMsW;~eAt#mc03 zRTUddC2*Ver-2A^JO3XS;H%to zG&eD0Hyit-Q;P#z9SU=!=SJzG7^LgF>{8N`lX>=qF!dt8IQuENTQg-l@8~^DU}65x zXK6Cz?K?cCe+)~E{EsX6AQHG|2?||7I;Tl0$Qzj3!>*k!&6^HCl4=gRUJ$QwB9?F5<&&;VAXrB z|Mfe{q$>p1-o$_Fh~Jgyq*YEJVKj>NFtodr-t9`N(iOtt*b%;_lF-`Ld{&*aX^K-# zfa32p{>bIs-}J`&P;MoLCA22n^iOs~mI9f!Q`-Ad9U2{E&S5R2CR6=ScAu%)lp1&& z`=6aD^|&-wzu=V-i!a`Cjz%f41an{5u0wd9Ov>BVV#N{JX=N?<6l4?H(q?zZo8g5ruTb&@s-oN3F75e87b` z-W}#v**fM611jFaJLood_KeFFMSBWIJDpiVaiR9KlK4BHP9pzqg=XNob&y^JOX&%5 zVQEfj@3*mp`cKnyB&3)xDHxc% z-WXU%^ZTWcM2&cpo*#akEh`bUtG6 zx$*CHEF4y$saEdCYj-eiDva4-X|Gz<5Kkxjw~erMtux-g_l`jhtBo8glohEHiypT5 zR9Ee1w)cJEhZnL>nv*u+k(4n8VKigFwx+Y{7X&{K=)N%P#zWElL8ZVHc_MI=5HPq$6&0Iw>uPVVYkR8|8k48u)xr6;qgySL9*QYHE&0V znP@N8bXJ{}KgBDKj4w_;uuggL@0jU&)*)7B3rs#cc&a3HU`$$V4jaj5d(SQ;#I0UOydEBmFYX!$W9Sj;*w&4SIa^>ee6kc6FZWff2USgLel2&nQQm;4rQL> zlXmMdJ0mshm?D#!)}Z#%UCpobB@!)ixR$3GhpA$pder|tItp(y8)<#GG&62c8bvrF zsTUMGS~V6KF9PVLcl=Uw0$Q(&{i#_} zy{~!fU4unr1>|^b$m@`5SoR}(tu<<$uyco|BE!Fcb%bAZYDyo3XS_#U{feO8Ol8ygQ9(|t~^drBFya@wk9m9WQD30iiE@ zs99r)XHm;a+LM!s1zkoKF^PIYiVa3ab>yy{RTT_#1c*m;TtRD7eowu?!otW}Kd*?; zM1}klrPx2ayBPt6Kfdim^L5B{YFG5tj5%GvCVq$S(uMBZ#ygn&k}m{8>-gF?@hLqWQ8e5O&}8EabeQN%zRbqk&(RIbU!=3ZW#@-NYQ)j-*IyjDh)ED z-KWxBEP~&TOY`8X+>{wlp?jfPz=lJPPebIQ8gtZ|QhXzLcys<(d}>jt`uBGe4+3pv zamUD+oY@=iTjqJko-Sy?dv%?DM&R)-log1N(L%}U4GW9CaCJN@0^Os{D{@LJ65N6a zS}ADdL5>LOVFTR`s&bGjJ1n}R2UmJPt=e;4)%gxClI5)O!wxCNYlpi=n2&_Di% z6ATDZb9i(20aP8(U(~W+5+9F9GoL5# zoZ}N%R9>L(u1AemxzO+Q_WtO$pn#+s!K?hj*F- zc02k-3uuyuxBV$K)u@C=yMf<V=g1~1uhW;;zn0`@y2oG)fBO$FmB+f3auGRtoGutc-@=-{K#DEA+90($)f$05# z66@T)N8fm|>bYp0M!W=fc{Z-OgAxaY*irj!82X)o-^~GboX>zufvV}wLgLXv<)$tS zD9`Ur&d`1-ohF*Dx*RrzNsm{Xmkre=l75U(Zw zo0gD>hzXCF(9ny>7&wzIOv0Sy5;6urq;5+ej8yx|>@#+)Jv^$AmoT{Y_l4AlfK2tg zPnG)+28|^;CkT?1l=P(y>YQpZmyNmUAzkN2HIIWf znNaX{gjWf&wD1ss^vI=|nUY2(Cw)RfPJ#naYCV_8`f{Chx(lBiAhReSj7LbQ=9>NC zL)ZQmXqlfjKDYsL<}f7`ihw(t9(azN+`ewKsb9gKCi^%x;F|BiRGR~nJ_(jzl7YBJ z5>dcO+j2Z^OzK;m{XpDyf-#-LdPjsn@o>g2Z$F^NijYq+1aD-pVT0t_e3Nyr)+2so z>V1p{pI(rR{pdptv@;P!Z98DVMNpP)2uA7X>kElF=(TM!-U$b1q32*>l$e_OMW^IT zQ&UE-8wkm}{Z2|s4si%{K#T@tDvd(q&w>G%UDJ$y0M9Iw=;tsW1Fdpt zPiaOFJa=#cP7J>19&^na2lRRMkSZ4p#4ai@(^fAuBZp2qT;5i`!)L(oRJQ1+Y5bF=iiw9Ez{lfp{GV=qv)2B zpMMpU(_s-2WoKq!u7;*Ud~IsNl(dSLg7F4wH3QjRCt>wOiFtYya*42|Qd3d+gL%d2 zGiOF&3qf6%DqE?@$-Th~XcT~+TfhW>!5}I%1|WwLju+mI<*-s%5of{w5j<4T;qxA_ z2EG7^slik zE?>>e2jxkREbqoei_K|9ZQK>3lGwk}e!pnf<&mPz$(raM8`d93{}gI&BjD8|4iF0` z02|u2ExhWbHjEveon#j^nV7z~7iWTEeFS(;zCl4!aKwP>S2sr>l1=M5 z*j{1aLrB6Oo`+r31!a;D!{m<>K=G&+BXpsFWzW+0lC+O7h`XJ%LqkGxK}f0XxxelNgV<%rHnQS+ zNbCA&5!;DQcwm!MxkIvAdxxaJSv9$_lRmr4W)6q5pU@)p2s+e>3o~6g=y|#hwT)ZE z7^hhGX~R?K=%8E6okBS|;}*JMt+onDHJF4$3z8H z9mfhqU%O@7s?jNWkEOO?Qj`5{>7SWZ*VRm%c*G80pKwVH`Dwpl5^Gyz230Ax{anCH zJ_FZX8^(rA>mWj?%he424A?Z208T1h%(dTEL+i2S)Q62YOINWpR5kDjbS>nU$DNl2s$sV;mUsFAzNmQ=XEt75550cxa z6&^jEhVFak<8E{H*Wc_KI$bcYsTVxh5l-${Mux3cT8VAfn3DcGsJj2>{1w|`diU{F9gkzecL=|c ziL)Za*ah-k48o5%;nyf5u^3@ueH*q>r}8%Y7PYjZQO!8v;~|ujQP~m}$~BYT4y(+1 zL4%Y`a@FT*7tIar`8Cq2x`Mc|x)_p=2p+mo#nD{N+Y2wd>5+!RgB`pPe?j`4W(u*)gF% zZy4_donDkadGW#p4B&7X1r}(*1}wBs({_CK1Q$UwE5(cMEe?xqVRv zp_wUd3$J+H7P>RG{Chsp8~MzgNU<|4TO{gHai-;zx|C~YNV^(_Wn}V^mGv#=QVogu z42$ya2ehVvwydU8TV2=weqb+X7y#qe6$gqj`clG%XaJtK_8WI@-xj}f=LldxW)}DU zr(VKCcjsMhE-5%y5)l*M1PlKqD14P?Jt2Dty-ffDPIaZ70*13SkaKf3m^nE~(dGnf z5>Y=DG;onLZQ8Le4kF-=IF!@CO$EmE&F4<#6<^w5`^|mScNNZ~9vzdV543NK{)e{3 z)|A{iJr%~yxIh|I{98oU~n zW5hS+s|{U#7|X9ZD-8>u-^SOaK1O%<3@<$w%L2!7niNK>nID~qO^|@>VgJhmDwyUz zPrWVIJ0oaoOpX0{{OIk#KLdwX!Dxk(Q@KG2#XT6y1^xPE07f)qP&qhlk4Lt{%@Euz zems0$CW7@N+7m*BMA;8ia}0O`UI*$9D9h2Z0n9=-Hz4dI0iFli8$jNmTU`=ARN)PP z@}VvffH32s>^4xZ6Y6ZP-CCakVfYj9nE3^@RZhVmFxl?&y?GT8K|uB~Tc=6`r?%6> zsUQwi=nY_nrJ$`Ha3_?#+WK4gjNk^CiZyVz2|pFvpO)W(;w29<0D+5=R&QM)a_OzE zIRe&OxDo6+egJ->(N0l(7SRn)-W0EHE)LUz0ht8Y-0FgJHkho?@$pfBso~RZGf8Xf zyp)?g9dbVA?LXyzmUT^@fcwv``Y7&buM5W^He*SjAa}5->h0e78j})smX!^;pQf$# zM(K?bB|RgJ&&{uoC6ccqHD{~_!)Nc6^lUhvta;|Q!Mkh}HyaJ>YGQfnm2Bta z)!WI9yR!;f@m(Lw%aEum(yHuF(uaNAy*se^v+)eKHf?(}2gpYFn6}G4UjN+@Mc+_T z3W0zY-(u*xFCYvTE?ftkdDdQx>=n3hp`lq4z4qsLOkM)qsURWIY*YYjb!`a=uxi1_ zfQ{y9`-(a(pW142(2FhDVM|E2x81Rd7`HDIn85g9Y1 z(s0AiAS>YE>O8<-(8mfCl6BGZ;j3>2Y^8vm!vZ!xHV^|7y!*4oqyF>fFVLu0zU}PH zYinvky|^~FBB_L(a^EK>_c+U@7cKMXjf?*GwrobYsIX-*5Gw7jAdtYrqQ34!`#=o+ zQ@kuWTq-kz&dI}=w@)4>^i=ZZqP*&wkBly7G%m;nw(Kn?M?anU3mCXP=*xeI27sdB zvQXL!?@T3bLBNUd+dGQkN=Lycrv^v>R%<5fZ)V0OCu<=g1o#_vV!dE$yjcXSedu$b zo*SqX5!{(%yh(CimhehR1cLOkAs+6*O8ROs>wE=^Y?v^; zw5n*~s_L-EHD$%*2TX`cwz-ATtL&cV#Wya)=x^l}nDvZ6W%(H>952vVVl*-XNLdU( zKi3CarzjCuheEv`b6em=8iF5@danNU!bvc130hgPfyMe+Ckhs__2XTrnXMpl>ohre zspoV~nUpka>pXHd6&1fndAbc@f+mmQXy{zrnk>1#koQ!6Bfq}4QVT?Gw;C>I^xNyRl1F}oo z5>zUv7XKLYx86AQd)xwhKe`10WDm`70}xOu7OLUTAf%|zo#H40Bk22ZF-{Omt*EZ< z3+n-$m%#QU1xGUET3Pp76r+iG*TCXrWn~4mL2^7iFXEyPykrPUr~$RkG91kpE?&fi z&a}49|83+r6AMf2=CEfla3o03W&ubJ=BzKZ+3D$VV0kfda5#z;gAeTHYo_&aQ!&c& zINoKuIUx7>L6jdEtWx;?r=8Ohu-dZB&vo0$&cNMqj;2M>kXvZ|egO*)Xv2g{pu~vq zrZEd7`T14ISH*)dv*5u%gh75A7rSm}2ezMlX{R}}#PyV}hQMVi` zz8@qd$Bef0R~^OIf6fGW`PjBR8#+`_O9P1Gj;!pnIs-02={KDa#Dg;Za;yib%*w%9 zM!&d!SYA$!=CK_`nM);?zI;iw=XO8N09#GS4WH?x=R=Zy+TQs@1tJ>>p3bcUgEyrE zT5Svek{r6`s(^Tuc#*VSClJg+GF+wQ`dztT^!x6Pud$a8jZI}^rvaRb1L{CDQSRpxU+`a=*iod@ z{6nO=lG&bg{KPtD)O3#T0HhX3a{b@P1#XaqILy(1jxJ~8ld>m3X=~lM`ETS+Z#Iqs zPdO3~0gRL1vHGrs#5Y&R)WuQ+{YA^@&DLRpZ=l3>?qWde{V*BE`@uLT50Mn}&*4brQc?|wIow~r#-ZoFrBN&a(XW|b%)3$RRHG6Qbeu%Xl>*Qe(g*C*kr zlbDKwskh$~MXA&~4e`EYo8J54y>U2CtDqWXP-MT<=hmgKt?(MAiK!&8=)s_pSC9aD zWV*UX74JJGt(;ph;91JippsyKw^deeQNx6kht5UB z0q2$X*qA3Z)|4mNrK-~ysV00vG3~20ZP?z&$W_JK|3Kwr&Ma_Y_g?I9V+|Cq zUhcEp{yZfsl^;FVgkkUv83IuE^+XhR-6L*hMTaR(Z6#H0Romt}_M`u}H1zS^>;Jd_ zUD0#iA-$4!4l^oqS9jteQBRn?=CD`Wn+CzAwjaIrHj2DFrEh}aH_S>;Z|0ww_c{+6 zd~vV_$v9UPOWFYN&rH@VZWN3k*`u7VfC;z<#4}AYHa4O%=o=wAYgeMP+_VX>7 zC)(=F!vwX0>4kKWmMT@OcSY@A6pf5mD5LRw&g_;tMo6-&^2O^***||>hk_xcVDg6a zvG~m-~)M{jZG>nc|YxGLaTa`ME^nP zU4|FVe8o1`O7s0q~{o3dcFvG2&|`hCBnrS`iEOtCkt7v<>wBP-^#!6JH_YVv?Iz(_=QPb$;TdA1RYcM{LdYGT6jWa*I3aeMQNpIVU23_w(0;T zk-L!malJscJeA+7chpoaP+Y_4Lc^a!SfvbN=GGvO}`SlOh zJq>H#S^>XF1@MJJsn+VUO)m%4&`O5x2c838sFnF2+9Chm@z?OF4wVu_H#TjhTECtR zdu(?;{oG^kyXXlZA;GID#(D9pS&@jL9m&<8Wb;E@#dEB4A0BD{4Yb(>yyg;ZLL^gAui;@ zWrynaQr|B^e`s*2ufgx|E++u;?xxWZaUmi3om13ZA0#>*O%jr~9EDdS!C}5a-|lTj z`^*sG5A;rJwXdncgQX2_0dr@uXZBIs(=St$|?Nu3!P8S#PsJ$1H= z2;KA8w*@?t>@1$>`NW-f+nVifql|r#{eiEQi~3~>A{_Imc#QJojV?}n`}UWmY3=_G z60@5f2HZm7EazCH>m#pMtGzg>xN^pxIrkLMN;IQBd~d${P}-BQMh}qr;$s0PiEsOP zt=_x%k0jRxTo8**W<}ek_+eskflPFjD#jynujy3a*Id!o z){x>#Nz=e0^}sT) z;YI4D7q64~e`*FqYI^k&&MySmWGW@7iiVi(41D7(<0BOxLKzZU4O;m*USVuFOPuKE zKJstvX)<}GhLy+`D4jepQV$dJkoMPK_$ST{(1h1^Z;C@`!z-;o-z_&GIX z4f@DxN^1WZuRqtN`o$nmABtBf%Qyv(l5KxSPf(7n$YDap!|*FXyS#Kb(nslLLIFdk z>$7C$7QDDEm0&TVn#iqOBFXGbgV4=fFxeTNSU9g_V09^-@ITk(dpdMK7KkY)=#Ye~ zbTh%xajT&|77?uYjKE$hx)Zi`^_3VNu%&`=tuXpmGh#f$T&wZ7tRzbP{89ps31qDH9 zw3)e~m1KLn@T(Y!5pN3|nQy`&jW~n2w3; zo=D_IXTD^Gko|E7LOd=EZGrP5BORSMnt8~~#ug6pmai}!86C3Zd&9`amZcd7WqTtu z3ryg5_7ap1dFre%0C+3ROiy3EJGjUoDEMRWV5I@ZR^ed2SVlWJIZ2E_!uSVY-_M^v z-wr-6@&Le6GQ4$N^)6a8Pi40b@aCXm_ezD?s2;3e&MM zu-%VQT_GIyZNA{RjToZ8fDrE7iw=wgZNNEdjiO#ENnh*LgA;J-$;;svFo*pa(?) zMTTfyEU2X+3N`{_!YPaObO%7sN`|0m!<)7crng#Va^aVbwJ`*>EX)JcbP`cgP@pR< zEyWRsNx{@m6-2jS=%ClJ-PD7d)%%)dQp{y7)wR5HIt;RhHmytDWaZr{U1JOk48~xf zVlOsSwOe5E{>kl%DUv5*8Sj2Mqg3a)FTOA=n8THbha^E%u`8e!x@W%ozos7h+IDsy+H6&5#F&_f5Kw;lK`XqqyPF8JiiP>`NVoCH z$?~|__C%lF*C+mtMp(j>6r?}4wVi;Y;F{f(LLmA~{YTfpKeuCl5rjjDfDWOqk{jBl zrfIv&u8Wm~@bW`v&y>UodiK*0GC;+B<;sj-LuB#0o(oV%F?K&V`~Y0VFsS-#LZy{o z;hbOHwB5L!ucgZ=c#*fd>smuC9QxXcwq4_|WJ6o@lqEXee&7H7VV``3?L{q82kB99 zQzYj9KS9POn(Ni=5XXLevMuhGqT;J^t5=bcYB}2gKctg0`uX`)EcE|Rm~mL|>x&mJ zzB8qSzw!-CV>KtU1(Q=m;S~rJy}J%J$VX(~3ZFwQicxAC&|6R+&hH@ID|85#Op}Hs z0Ep_N(D8)i#BltWr*W&NdEBd#$C_Z@bl2vXoQW{Ye}lhLhNH^`sBpnmxyymA;>Xd# z7K4EPCa%NYJr(HLKcc(3x|XGk<9keDGX1^ET?mqAyunSncG@lhF#1Y`$1u16gH=Uc zT@p`EPf+lTf(ddhgxKdAwNRq4EMVn1d=romlV>?7=-58K(g1^PaLK5J{mBYe>Ffi6;OR+vyxK@HX>b)dw6JxI}zR{pi?+LRaQUO<@qu~L5-v^=?>OM$V< zIdFj}H-MMDLf~$d@^-ZS+;=iBFE5b3odJ=Ua~&6&stmFb(J0wV@87?V2mTREPR#SQ zmBnxrXW5FVV(wO7KRN|Q(dp}NE^!G>&|#UwgN^xRZkVMF1=wmYD(~DPU4NL8S|OQB z73=%s3YG)*sgwb0h>}c$7iT?Nr((MD(Jq>965owTaq?>u&LtFr z@0^m2)Pk~iCT3#q{=&iqMp!)cif`YLws+HUaV?7!^zCIpTv%cvY2gvRH^-re1}6%( zd1DLn64s0s3P&(1X5iu?qwuerV(NMV0YtyRapofsZ32UAyuo1e`~1dcPEi5rJ=qOy zdRX&x`ScO}2 zz~Cd$IK|p^?RVjuYHc8(EDSa-Ptt#B06)VB;Eb#2N`gqK=F>Ao4gw___Es z7m+oWfNd^pKcbGD#&N=_F-G`sIdN}iZ2dT{PlPQcU-ibdLZZ}`_2}tyvS_y~Hf>V$ z0+{kH1LwMsPkBWQbGLdA)d#ek4gT@6tE4#+Bb>@|u1|?r2<@i)Z111c4{g^-UH)CW znrZPNCMN(8rp4?L)c9DDE3Od~(GrfRAytIAlr^d)ew?_79l_GWI@`r=!{%wE9(Rjh zTk?$~qD`oO5<8UYG0}S5itUE;Wkd+8j)a1QVEa25bu09bH-bHO4cPj2S9oc1{ocxl ztS>{i{Y_$!A;I7@DK29kV$c*jbqta2l0c>l*X4_}Hu%(3&0Nt=?QU8KSy{;E2jvgT z+nvp9FY%X&VHJ|h%K^0y{LPqE>~BAweM43aX}ALO$r@8+AESNH$B*2` zX3zn+&Wyz2a(+}9SaxVuL9Uz;*uIFZL$V32K0M#Qf@^gIaC>4a9nGSQY~1Tzq%cT- zc6)WW3nrHteUp!l`qODX>l0Odp-FVDzjpmC|FdNC9N&;qa`Ul0Ev$&bidvGnD~`nc z&vOD@VH41mM~RBMtIKE`rd+`g;LgzRS)I@}?p9(!v8r6bM;K%OI-Oq5kWseb-A`yEI5fG?6|la-WT^j{QYgNL#`=Vrc~00K zrsfSa+@LCWSk-)EEHFa%I|gAockH@=#4(o7A&bBJ5mEjJUr5nCq`16Td=4~0sa z=d<}KRwe8{EB3p|Ulc;4*=cu6e#zi2k!nXik*rZMp{K{qTyT%qQJCs`LBDbmyMWM% z4d*hhp+hl|!quLRAGcCtdHHPVc=pK1 zPgqbD&t*3YL|;%;Q=-`a0KiJV>muj~7NvNRQd0WCOGT~+_SzY-wlLN0_T%Gq7t(=-Kn>p2iuzctpG2hD5$iwG)m0@2Q&)E zycKtHata;iHfW8Q0Te{a)RY;Vv!281d2gCR^&*Inv=$eynAnKojpUqh(YMG%a;aqw1y@6YiJOMt*c^W`?9Tt^_#e`E699N~J9A`BvKomoTq{r{Qk zYkml!XX4D>v>sNmeS-iHp)}*cs=qYjGp@WIDnKl(1#c`YpmgYhfd-`R*^yHfg4y6q zhK5@J#OV*+j0?X38^mXHc75Uu?3tHk4d6n~v z=_YF3kC5u@m69q$UF@t<(AOrWDgvuh+Q!qzyv(`AhimNv1eMngr@rbu?x$QS4SD$z z3&cxsXz%_}-|3o@7guS2r`&|wDwa*08J_IRwI zF92wSzC;f5HiKP8-~n#}ZZaTiUIHAxclWfD{C^c|>@Dkv~gLYdGE)~4T{84I$ zSz(#yeX~?_x|C)Oq|ZwYDf3_V<)>cqA_Pa`Pmk!8-j-Y)PVv#quLoD<|4M?;Zn-Sz z?6SzaQP8Ue8DJlQ0=NvVaBp90|E8VF-s|q%-toD1e}%YPiHDx`!B0Xi;}Jc}n3@T^ zN~Fpl(3}WktXm=T5lL{cv;Z)Z4HU;*U7?#@IBZW$>gL%iaOv)F9G|&w_jU)>l`2TI zJWnmOwcX*Fkkx^Cy(y%U4Fkb4%ZY`9L;lIrr;LzPQ9o}~paImHfnZx38$2w~IzH_W z06!Z3Q`os<)a~ugpSJ$LG^409p4kD=bH0N2-C#dU1JKGpG%QO>{5Ot)bzC~7fX#a# z;K)lzz!2#o)c@hI1O+_yN*YQl8!1kmx`+~}U0T8F2}1{bV!Ptua>pFxCGhy2-S*)R zSfO}aXo&QLL#DpdEqpf@>Wftk-ItH7zLjPHasddCI+jx%Ou1W% zMw++V>p(6A1MwO5(`3E7_aQ)n{?~S8@AtN$uhijjyu2dWAArw_q0@6;4{vbKSagjR zE68@!sR+*(mh<4A2p&$Z7f^z(ItaRI^BA4tXp1C!_XrKS4S&@F3(3{$Cg12=W-*50 z-4CjxK*`cO#k#JNSFiVxic3QWDy*tnUPs^5>n{Hb@~;C*7evkx=tCZh?~4~{dG5eL zfk&5-HGYzYW_}%>53R5hDe|pwHe4(bbtcTs&6R3dG~Ls(EX9YO;wBhIg3$%KSEBSA z^sTcf9wbQWBHw3+*o-SMFgOZ25EScP2A7m~pzzr0tv*nh90)fK>k2=PxU7||1WOmT zY{Lku<}c}?IICiS4%QMF1E%-RF5dC*@Q7Un5*i|2*vrB6#lCm0qk~}3H%aww%BeWd z1A!s;O&v7d1Cr?wl#~FB9~Tj+KKZ+2kCl8IV=%|JSR_t~hxvpCq+bPnv8ERBl5&1+ zMSjsdJSr7LKHsxx*7L(s|Btfn)Vw$r1UM7G#Xy@RhRc`L`X{C<)igDKq{35bqkRnI z3|#ThflD!B1?jAQYHTGkfot+Zh(jR|FF{Ezh#bdRcKQc8y3LX@PS3e@Rn8TL z`?rex`U^vQp{7qDpyD<<24@MbPH&#|sMIl9QEHITKm-{sPu7k~9Goh(Fq2VKRvtTu z>)y#U{*~tWUnvo8l83Mmf>#N_9*gBPI*1YxMeL?KeuwIyrW|_^AzBYsJx?LW^#UCo zf<8(x@u`m6KFU2uwx&Y%er)GlqdObYzHwEBk0$hOx;Q0(lzJu}ICSUwQ@1YGW zC!PmY^-DZr$p4Wqk-q7Mq1pRpQK9d6;2<$MwE2$cK*n_G6cOFm)%2o-6^TyId;LZ# z3)Lyv3uURr;mL~+4kLQ2x1w)OW0SHMx_LHilRD;$hl3#K?mkF-y5DZD4WWz>%Jn`i z+Qq6}c9e7vfw3PAwH^<3Mvk_z4o8){-adl0AlFmx^whg8K2mo9d4B!pUF0e90axOl z!Yk3(y_uq;*@Z2ikcwlyI!AU9ru2+c+p3cHjd`)RmJSOX7k?_MY#uZWn_s>_M|z#- zY^k1E7TwF&OiX@1I*zh^H(*pECkkWGB>%9kDX--b({qDGQi0`;0;g)Jx|!=E^WeyY zb(}BF4Dn8yM;u9sC`#{OA8hRGb6q&j73uYCPIkpvq)qs0!KUVHf$_;3RoR7n10fnw zJ1J#9cvP;;`TFwQODSWWh1ndSCu=VUbMHR|B4(=22a{KFw{NGa^I1V6OTX(vX+uOr zgz5)~Vo3#yoJ=-$_97~N%MXz{4t;m-HG?)r?+0WBDaYuoJL}9>uf{HZhnv_3CVF}s zt8HS%Fd(YhZ*{CPgz+k+$}ZL8iuRy$-1QzCeZ~&3+#P_7LVj-`ak^UYr`7kWjUVO? zz@c=2xhU^jwa%;Fr)DV2vq#~W{m>?|Ilvq!0D>qX;MMK|<>xz?C-#}=RQ7=3W{0NM z=A@pzhN`{Z36-`qi;9`-ckkbS#&H1B8?Ww7i&3@pTH1qeLk|5G8-tF+Sq0T5z)Y$) zdiYQSOYJ$5N$sisD2QXLS6eThwe1XRliYD{+YhW6bpqWFHM#}DtJSV>Tpoa1BquBT zVKT<{ZXLL&%^nP8EDl3*Y?C0I5&IAyWV#4*9x7Ve$A@5MC$WBBc~eAZ-B{}3&TI0) zw#*p_p&2$ZGO9W|-|G}4_VVQGRPo2ck^4hP7^E&07Bjokuis2g0C-JtGNl)A>hjCE_zK^O7=QZnP33Ta{_WE#z ziIs=einC`^GxnABxtE-sX{)3g%*uzNS9*H%LSN0E5DuRuKHs*A|9DBz|F+5x1r3S2 zP4EuL`H;|@6|iA|NBjT|KQw8_VV<79y%bIN8xL1Q-6-o~ZvolxD<~--i|z!Z`J!~! z6dog;`PJ3c(y0W0^asEg87)46!}k)#<0`vQb1uU|g7MoKG*t|SP*&3WY7N%ZXuL0I zd$eZf{brSVzo&#|vBO@T1jX^Ovz$ovFob{W0ELNg=3p-)ePQ;ea(zaQNqwA%D<5hE ztfp-(Ink(1_>T+lG(bbcfph*g{8Kmg^6<^wU&{|NUkBtprphIdE)2|%@$1}oO#%w* z02t(59y~%k^XK7pzZP<2uRn{%nu6o*7B~=tnBrkq@%5YqR~MK#9;4#R{IR;uopIlT zUE-opl&WTx>B?N@%foDL!6-*dTn`*O{0JOR{MHORx2sEr@wmBoUoKy5nxKpqT9O}O zq_6fDksn*YKD|=dMyIs(-R9`)^q|sX*UBq~dE%*-2AH*PS1T6nDQ0t+*ecz;wd!_VjoUFg=Xq4=#qQm&YE=d>&zrFi;I7Yz(?}7tO~Jp$HJX$k zjLnp8V9D{ElYali^LkP*^$22Ru$q`8VN`~krI(D=x)Q7BJaJcPyOhwYl{cWT+^zX- zxbCdpfu{87UPZNCU5Sl@G|Sawlk8%%p&vV;1Vx#{JF2AzHO|&QC8ZX4c~9+eE(_B{z@G(C23X4tt-BqQ?SQPmXq+Ky!g$wL>LxE!(3A0XbtpzVDo5DdmgUvH zbt~glmXwvz@fBNL{2-h}U)DxV9OX*#v4Iu7dF+Ln;SA~=;Ry$N{?;_@`8h50%E;t) zBfZEZ_`V$oEuElu#Yoy#s;u_(#PPg@y@wU){r*ney64ArT36~jlu-*2jPz_hK&1~B z@pio@)7b^ON~3iF%77%Sd`0VpU*QuQB7+KR+!=RD18-lyg!kao>-iO>hc3?b z#=fUre_{C~E|EyUb#=pKVV$3eI|RP zPzT=jVS1Z0U^Lo>b;Yi&tX?Ra&C1L^pj6rRa2j4RnB!*5sIb z*5O-{+okoj z^57PI$A|Ic=g+CkRnKmHq1lMAh?jkIaY@9t)CEz z!?iq{Evs0rr-IFr6C#r}+hQT$vquxm-ChhYPD09eN=eC9z{ILSbMnkBu^lq8t&b&X#cSp|ds*T8J=Ups#YD!3%@0lapAXp=E_Klcx%ftRa z-kZlW@8}ILmh|?$|7ofb;j4@)d%eVKX3x^Md`gy6S>$A~nSgZ8x2PlgWSr+)a2d3$ z+BO1JS)$n+h;oF(5}o#IfYNOEV53;TZHp5seNNB4QCb135d<7?8Ra2N5h@5Ib#*KL z`qQnR;;K5pEoC^*GH`I@v~v0T`L%5_zAjx%Yj8ds$BxSP$(PcqMnMl01hP4j6~ zkiC-IyThXIKCF;1I<}iLan+EJu8ww(y~nNZ({UtwwAG)RuW?q}#wfMqB0V|qb>HjV zmXt8~3^0W{JX zBJ8#QIOkXAHI3_Myw?<}?%g;=k7&CA^@B^z*dXlZ7_yoSZ>z06Rdn%gy|(;tx-$f~ zg}#4pMoiX5ag>2QSing1{P}T!4pkB-pbW4`P>wWD$zBBgt^jVW^nOB*!51{uncG0&0MJZ!Nv>ERPatF^cEF0! z#mTKt{|qGLhyyE_8y+4mYK#r8gp?!OJI!Orc+e3#b?7MJL2>^_Td zTQD&AUd}YH>$_OGauAv%uoQa(IR;7qXKM6U-Mhkwom526<_A@>L2-oq=FDrb*oH%# zDP_k(u+wM#7=DU3Wks-OnotA~FVA_L!b0tiL;4T{2G zqr3+A35h<2v8$?c(O>IlR1{TIQkU()6Ag&?S;-08Bt|+PXD|SSg9RVnpE-bN$e2S| zCrbf2Obk`DD_cU+VL2TnPK&Z90g+6zLNz+lBdD}Y#s0<&qk=tcQ1E;NIqSM`0ND6ft$Kp$-U7(7$;q(Fb45X#bzvzdLB57fHf2)B0 zcdJ_X2=8iWRKllo&hH9fmP~ju-~j7@L$%cpWifE_0x$|;8tbJ<$wKpvCRSR?U)a** z#@Km!VM!v<3dmcB4U0^bg-yWPS|Yh%#RunP$j%i|o(BR6Q3%n8Z*d(Q$?(7|018WJ z)r2*bzqv|+$pgKhqZk77GaOhiVYAtQZe8kiOc1CjM4@#+!oHD^Zy@W#A)gTXPnh!j z0^ALOJfKQ~Cibq5&MgVf_}JJzL`>3z5d0=k=kTr^boyI0_4_GhHs+hb8<7rRB{KD( z!F@6Fo4@GpPxnnwmr%(GB2`{e|6%}C(EEpu2=2jmmK5X7>OiRW(l80no*}P_8FV71NET)XI61^>(ULj>B@(K>Sm_4F|FRE{BV~$O^Np*@f@1k^=L+mVe zR11&0L%B75=HmrkCdcjKNF!xV!JR7ddAV85GE>c+ztwelKT4!p9|(mU)3maucV8&Oc0KGZ8lI8vWBY$yz9x zNF2iKk=b`9@Kyy5hpP ziMmDgEl0v^y7u1PdQlEpDF(y4I$7i~|9d4yBNg=a zE70U}N5p0->Gp(8@^%cA-&Z5uaKU$XYmgNl%-_D3h3P@*+^^DW^n@m7^0{f0!NZ zzK4?vs>aLzedMCN4J@1{e~r_7CVsy9qq+BFMuV7z-sw470EKCu`{0y%@rR=|RhVk+?eLBUmyhzbAD|Lfk_f5{w zdE!Zqsxuz)B-6iWPxFbaOF=~Po$sMAU`oKa2a0(#(5`r})UB*g5^|{a>Y_+`B`51% z@0{GQ*Y5KZ24b0ATWz~K1H`tf;c}`W-L7k$$(vTTK6tx8b{EZtR;ql$*=6OmK--R@l5My1Uy3XyQ>^=x0Lg=tZ`? z;bkmAs0&-tW1MEcZAXN^NAVpTQ})I6yFqlkyshb4bDc^A%)FG(tCpA#W;=f{>u5eD z&02fjbeqhT-149DUcU`29*n}5QrB=g{yzKo3;#Wp?Olf)nu3l-#`67n7q#)l`#DMu zwLKS83dAZE)f1Ya4hcyfWSL3LWWQs3L&g8!N^ZIhn`?h%1eq`y%8{&w6BVkmUvIU9 z*uH0WZ}Nm$f6W1}uH-jcCC#HK?b3ymCgPHGH}3a|N~Bzc*J+?YO1dzAcwC~t=GWBJ zaFAfDv)Q@+kQT|Y(QMr6eiA^!aQkYBJ7{-pekplu{IKb__svihfz>8#^XTaY7FQZ{ zcQya?M%HK1TjM*$1B0Y5so+n5$i-DxxwNkrlz@M-0FcN4|Hiz}w?@P9);@grxKT%f zSab;2to-k=@Dozh;)^RDtfbsZ1BZea(MXTkeoqkJcA7&frkr`_{EO8A%b39p%MTP@ zo_^BzgpjBDH}9*kgM^u$buSBUYfdUu;j#OJ5j6AKQJbd#_jor?B-G7l^rTlxsq|rq z9Ks*VkN!JLBhqKvCBLSd=XpK8B*BJqWF@X}RLZHpz4P609HqGFnQi?#B7?<~CF9Cw z(dxWeAlLrnj~TOmZU;kDOy2+73CdbuNO~qI;q*m5Vx=OLC2!eo>keZCC1n{22iIjT zioNTW;$-=zD$k6b-KT$J0DVs(cV38*6(d) z?MVw24X>$`)kQ3hrC`rUUs(_P(YNKhUt4Yu7R6Igen4So2i2Ji*NuSy7b&qPm&5z% zFnYtc(BpS*>R2W_>kcu z&^beta0TfMFB2@yM7TA*ei%RW!w!YLfICc#XzSsyerGM6$aXSE3)K&6^2yVu zfL2LKsUJx+K7Rb`-Adi;2kKt~n%jscv2|MZl12hD<|*3moff^8&=HBp4+oCF*M!Bhz;SYH6# z)x)%^Kfe+za1<#?g;`CZ4P-@aQ}vK)ZUSabDBf%#DJIi(Wj16r5}17GFH&ZlmHRK7 zY7@XLOomKvdMPqQ^BNqhU6QLH@Iz)bfu9k)t<(q}35+1As5>H6DI!hAaQb^uOXFAP zl3o&&Al-R+({v;$j~@}8{8=+nF&C8Ke}=$sx)}_=8B*OjKw=H#HkVOIwiFWT)iafl zp8f_#X7$glXu*(hsDTZ&N?=6z#o(x@+u$Sxkktg*nuF&J)Q?{e!0G7DxB>yQKC0^R z{Y)h?*bI!Av&j6ZM77gEPW}KB>ApP_5-N3DJX!Iiw{7qH=}(waH{U`_O{bMjs3{-ID^-;gzA@S8aLnHz6E6L6Mdw=va2sbh;fAe-f zosxxq1llTTr_s33wtV~3EP6KNWTmUEX(MgeG3C?522pY4<1Bv%{Gt^UC`0;wVHGL z!Jx%0Hf>~Hwe^%||rcoF?`FrU&wI)^|CF~Qd8iZmiA^uFSNq0{CR zYd-C4w3bfjci0d!Ckeptlo2L<1Dazd_|24xJqXozK~` zXMbSy$-pa$n3m1V%)lCp49hv5HJo1XFOz_AOO@2Zs+G9hye0Hi-gfEPHlcKot_>O zNb_3EM)ZS_@xw&lb?HBzzS6cI#R!;WEAfhGXSa(dawJJr&hf1?bJcnYnUvyu16w^2 z_3%KtA17;@rI4dulS>DRN%KFf&Ev4{@Do0&Z z(RRKT_*9}572qEr=E$Rbrr2X_>=-pifrqdDPGP24tmn4S3Q}%_%>|_H7bJjGWti1$ zC;NjfKpuK#1dYN^EoA~-4TQ-pbMsSftMi}X4R+b$xr%^Mfdjzo^kPf?Ol8QDs2ezF zkcck;kr0Fk_|FWB25y+)(QuVs_P&L2LOjXurS1U>o)MK)A&DN`!4K2UTK2RkRoaL< z`qGrCVvCmdy`zrNq-p;y80d-aI1z=3RgdBzE;?Dc>P7XR(nd>Bm@+LJq$OGh$v5J) zGC5Hp=|g%FZQT?Ej7nG866L4LK9$I(=k%|oCe6eJi@p}!Io=eTbpRiJ55ECWChpyP z&2j1D-dc0|$t(3Gt==9s*H=Ts%!=r?iy~zu;Is-v%&j17jCeO9`s-Sa(~4KND>IqB z-`0_fHeK0^qNrLr92MPtNi$WADi5?W^cLyjl7c1Uxw!ULdL#K?2jZ2J6WyF`0hDJE*+;v)XhNs}AvtqSvl0TkdZ2XdKdwxV{ zFn4H34mKB5USuVjdukM!h1{+`B|9SI)0Ca#?uO0hM8VYYJFt^N~DfY<~xOi~95^v|X+=VxJT%PFY= z-ep}_(1x?0ywi(*DaI6Rzd$+LtFHxYi-caO$rwOxMO7_oJBbJR_cp0sw1?VeU-pFd z+>g;ke%{|U$!yl2%h}f)0lsPey4zJVfe`hCUFdgFv{dEEDruZF4K-7j=1|@!p)FCX z`SrO>=K$>P2jt6@DQ1UNo`*PMYR*sxQ7AZ4Nu9`9UhPl`IU5`F9V_Lc};hAPqR}(0i zT28lH??i+_!8evn(ethe)O^sQqhnijXOB%utc4k!0-s-gnVVz2GoTEVBrf)+ODESQ!*{yMNCWS=t1l4Bl6 z3_oGM&ao^OEE^T;HL&_D*J%7ofSX%cfmh5$LY_8N$riS9@fTgZm1NX?rQN@X)kfEA z>TBl#wTn*CSHHZaSZ9;i=eox=w|d3_r)R{MUb^1J{XS?bysDOirHyu-<@DnWea$U0 zf6o&}_XH$EyjVO+*&t&1)N5aloj(7~HQB;z*z>U%4l_^1O_fUZ zY!Ky2zfV2n>#rK1b2Fx;1ENEjZm$IsofW?Cwol*RhlUPg_5^FSQ0E;Oxg9Hfk5*=1 zk%4;=pYYxh3fFs^9UC}{OY$luiLR_?$hc42CB(9P87a-Ez-7&Ddgu&lJ??$*Ni&X9 ztp=}3UjKaFMgtV;P@k8)~*(PX@P3>Pt9Z9Zd3SI=7J}I5nKHw;<^E zpf&|g6nDv_cD<#sBEQ5)J5^q|nZ&=-(epM*tR6aRb3)T)B56J0OjC4KK$MDD))ehK z@}6TEN2yywz1_^<$zHSGE4&p!N;QT`C(cV(p3Klx=CzRwKIqRU zWc591>w86XiNc5L8<8Q8Uu^)+;$VBj| zFEqitzkCaC|M~IjTJWO6Bejy?s-^^WTrOXBDNEZyPD%|5dx`u!HO(z`f9ZEi#*+DY z_Hw~)&WnfJ)rRwLxwR}w=`gf=TTt5UIdkGX$IUPE$UcNVZv6CGist3pW2R$rAZyxw zv8zGY|5HNSx)WM3Os}^S8a%6x-6|WlyOR}ytr=K+t7eyGUM@T!efZ$Nt|b;bA3Id| zP+*p~Q8YAlbfdje?gcD#&0^M4sX-;|b+XbWDgW}9PXG1U{@53%vSh2CWr+b7P_gk^ z#32DazU3S}{9Gd?=#SB{NhjBKo}zkQ?B#!LcWlKk<%5Ba`ojW8S&8uj5pZq@rirQx zJ3M+zK9nu+&+*nvOx;dn;gMx@IY1)4{gP%B;d_&0s?HX2EKp0JnM0UKq4 zj`*hqc%Js7jiVU8-M{98!HVG{_o~X;21n;QT^?Q7JMCUw1utTv3iEJYE_++gU(3i+ zfci~*{sjC4eR2IrM5A2nO0wEQq|)>Z^a+SrA;|@{kI@@*X95AkESf` zWM`KV>51a{V@+XMpLdf0F3?DBUb^*BH{J8C_>98jtCLN<5(d<}NLFGRoQ;lwVkDcc zv^>Ik8A*mW@Rt+UrJWCT;K|0~TMSqK;akIOc~n)_`pjEj_mlRzPhwKlL;$I(#SR&1 z7(e(-)IK4O@O;~^@>o4X;Xikzh|k1=q|b@kj2af#Kat`@4I7P18NL1g|IsL<%@b^){`a?vE3)CDP@a`FE_;jjzN zb#akJ^>=sxg>1(uvnFXnC*QG6sGish(~h?qF@I{{nP7j}M)g2ARWgF5+&8Xs!ku{D zZ!j(8S1!J@7EL@!1)(wa^^zAC$69MhXAYyTd_I&)D%l6PhKL!0bjYFgXE#vP_3q{m zeuoCZlDjQj>CU4ilPHWSg?E;dxD9|DJ`NJaYYq-MM3EDfBk1cUffW%&EzdX>rBA+Q zMHgh>lv+MEokPrL*ZC+klKbIuQ2$uu{W0aI|8U}vH=#L05i*9BCo2U-QyFcNS8kbC z^^6~oCJR62(a27UIh;4|1{d@Aj^qLM`%DXRdfC1lC1j(#h$+}m^B3#K((I$H+J9u3 zdjvK~{6h*E8rFwqmpUZy-N$tE=YMR+Q-Z8;$X2qluOO8xrTb*?8&x?p+U$nL16i~rU96>j}70Ut6PAn z9cfKsfhKG4dr~Uz5x=f?X3)>>@xF|tEsMN7cJ(D$IxsxYStFe$6cTGm^}V(H&esp zV8bYRkCH$Fcs{_oU_Aj+$M3ScoGRZ(7A7Wb+$79U>&u4E?GJ?m%5ui5ud#D8IGR@U`C6 zWF2e|8l3b#KgG|UP3&_^?6AOWRZW0jeQP3)8SoWHYi4GHrs8@0eW7t5#SJ8 zV1jQq?In<=mApYgm9J;_>!jgGW~w-t)Dt$gf9^>2*t4X@+>v&yP>}w&LIbzoML&|> zK1{5`VKxmNywX}oGEM6{xNOsHWbh!+()|U3$lzJfDx$!s6onyZGbz1QfiyNgM2!r> z2&NbQ%8@G8C$9nf3*>L2lYyQdC#Lg%GOhyKjH`-pr9w0kXDktP)z(%7GU>nDj#s-8 zTFqfiF1W-zSiSw_m(Bt#l!wUSoIMd4vT5RyCo)(5mVnp&6NIglnrudZqnq-_kSizR z^Z$h$B?r}oF=&L}y?;+0+p&52WP7AOp)q|gsP14S^B02i|SalcpkyA@IT|k+&3_esza94ml z1{u)D2@2E>Ino2hy0!Zu9daR-85$e43hY12&>C6w3sm@ll`Ay?VukkW6J-!t z8U+^r)Cx&bjvKtab413n75v}GRcW%x(k*ub=Rqb|C~CIDaX{YNK?El<1sb4>Fk#~| zP@n?;EVnVQRsi!J;eY1+eaWGcxbeTSxTJ?_xTBX9I*?dZfEb(xn$G8(xAKbIYD&b-F|FK2wDQr7?&T~Eefp2 zpi?c^`9rP~@d3fAN_%nbS8cn3wdRzoN7f>1dPws>-)p{W`JmbWnhv*xLpU3)9mx%uPvMb`8Qu~&(_+}h~bk{w+DA{@zryIyAtXNAYHP?47) z@Il zml1k-qi%32dq&D9YnSF$OaYHk1H@t=0T*HC%?{`nJUJ#STTBp#g~%!6^akcS5}Z`v zuz(S#q9ETzq$^-}$N;gdU;qCCw0H2xxrPCB3Fj6)0C_mr1Z@Qv^nGH>cXhrJP%F)m z47VbXiwlGft@&)T5Tm|tulH>Tt3}ZQ3z4{31i3LGVPRDu2F8V!%%4P{Zn%BERG*{} zhL+43gxK==CA}Zhv4Gk&Xrr2Glg|qaat1wZA_d$lPVgyd?k=b|?Br2$Z38)H#xBWa z2sxA7$Ru}HIUeLB1qD>mbQukD93f751dt&t0{A@?e1rS%Y5A4?KJ+}Pi&0>Sr{k2k z1ez+ZOP)|oh$8oNKVq4LKO6t;+pADR_Z6C&&!=vO;oweog3+GsIo2F3`cD|Z#`6R7 zN3DPW-jx?{Ys|vz_$0#I2Y&5mJyRBc%U)=qwSgze9$p|3UqcCie~-h0xOg- zn)(wFARQb1k8WiV`+%50GN1!Ij5>@V1RE8YA9x{e972GP+>v-EZR z(|;n_X1D$>VkrGN_>!U`GTw^Q>sU^(uZ0n{W6gfQtVUXqSt@#&X|e{nHGcS%L8Q0! z383eMF8or-k}OEn_~5bIHetc>HUnclk#Q!1dA$^50FdKPhU%4p)&#M&{jdB0 zIgFE_Mm+wAgv)X($#BCD%DD{p4Hv=ufw$l69UyMP6A9x?a1G3cS=ap#YO?(cq9e^f zoCiHXCSm~V9K2<5Wg5Thg-*IDj!#M+QG(gwRYJuos3mB3HX%>QT; z;$Ss0zBGE-fg-fEMG#st_PoU3&u)2dllgJukI>_)0HDRVMBmWar4k2dAS$8)^kg8v zNq`$MHX*^jMj%%hk~;!K?k*Sy7(=O|2PZQ8G%-&ef+P*WvjK|sBd#t^=-MVjDF8yF zw^31gwnb1QFnNHdNt6t>&q`SyD7hr#`szVPM9#jxIQG{j45A^u5#?m4fr~FfOF(kw zqk>;+J?#PnnP_I#BRNA-0N>Mw=4nc>;;)=VkT=-@>*}_J+PEo4J{tT6P1)&1eaUB7 zop^s9n~ zriq|8RM0i96(YAIr#UY0dgrRRm$a)3bB9WLcBynL8hILUdC%e~=@nYt3CY?>5f1NL zqlf_KI&9-g2*7!bSq9zb`n{Ls^($ zn91wD8cF=1PLu=B!hx2e$h-@DAmJpv{D_OljXx4A*f1~kCQEUb)40!xM^a&#*18pv zc0Cd@i*3Kw{K0Pg4q0J{qc7ku>|zv{Lr!xw)Yitrj({l<@1-a6ypc4dJ|}l~IY@Fa z0+Aa$B_H@i<{Gckx9YSZ4h!hsPKt;G!!?JHMb+>5ZYnAHkLe)g7GwdHL6;TOGnM9` zHVC0eH(H6|=09yLhi%`|Jvm;Ij8UZ|JoCn;j6I|=>Y9`+=@q?{D6%N}=?GDhmQ$pX z+dgnZAF+NYyKTE6Os;5G+)qen+$@@}(#EUGlx}z{EfVkRN&fEkrO9Z&gjxQ;9x}uWQJ85J?njAJ?#Hz=ANIUf(Nk%ni}omqQ{e)!flI*+kInj7tw9<=zgzrV~F zZ?mVj4XfdkA{K|KTb4Y=H}Lw=pHGUEcZ_co?TWef1s6VC_@7irAjb%8*!{2qo-k>y zwdIwP#$3+j&t6H1uA#|WFhcTP)+4^@6j{azk2^6c*Aybo?t+q@ptLrzu4xlQ0n0_Ls6kV^4 zBfXrGfICsFZQNC)Nn%aW^-spTXztOZ+V_=p7S}^u=7+Y&AcK1re5x2{J0GO4(g7!Bg zB%~ih%it?;wTP}!4|>)|S(Peesimkov%=!~8 zp8TM$s+y3plJS3#@W9R6r15f^|+Sm2=yV9;RI8l%6Z)4~7m$})dFhIv&)L0o> z>@Buc3^1?+7;~cN`Z368IOHY7uc&JuPLdL$j06U^Cj!y$7+4&Z(mDjc9)dde z0<-nEU4oKt=A^{H3)i1LrD|9&g~yZ5V#wwiXrt z84p;YQ4Aos_-)okrDfkDF^K^|rs14a$SW3jf5E4Yi;9Z=Va;qIaW=_lp*>i|%7zzHT8Y#TzN+nsdC6eJo&tydM@Jb^@`&Hzmz5pPP_#NWy*T#bcLDr3tSEE z&e4NyFf6o4N4eC3A;0jZ%o{pa?v0bTtf6=LREk2qL3Z9f7W}r3wdq?WnIq*e<5^tM zURO5OOR*#8*_R(3+0auor5w=pQo*_5mc}ea$(_<&$6b3ROPuU|=Dcz}RXs^}jc+K# zRzwE1PNnc-8ZUw>P_gDb{XPmG-y>Qb4B>8>^lfBCeZ}piWQP(0e%r*$Q)pJyt9o$OmEQIwo z_BBgV#xjj4jjL)>`tf_x$VomB;1_3T>TbXC)Y|>&FDWLbFLRh)hEGCo$jTYQU#P`+ z=)NP*CF7ysd&S>*m?4n=d*F2bCsDfKW7gS z=DnA6Ci&Y7(hL6&@7}3jwPa>KaydQL^jZxKWi7Lx;zdvxc3n|C>d8uR>x!aX_r~!< z*ns(o$K=^Bt$LW4YX#gC@_tH0?ojE#VmPaVay#m zsS_toG$w0{BHB3$FETQ4I+RZ>LG$etATmFuZp$SNI2%CT_uDs{h@nyrE4i=kCIz#H;J)ooO!$Z>4znzOKZ8*N86erJ-VloZpsrs+!^Ffi z1O6kVm#|r#Z|!+s{Hb$MI#XtojYigslV%IoR!Wv~`&!_!zVE6>o5-vJic3(*uU=JU zBdfFJDHx50<3bI1g@j%+9KSB?G;QR*j_srOf^kPRP}CqJTp&6m7QD~kHKrwE$d^aH zzD_6H)6uD>=5fWrP#CQeSIIjfe=I@0iOf4grqdOHQT}}=qB$gz%wR;F78;xY_9+<& zadEaV3>QIELD~4LuFecVQ_Uv?da<*I_-1$e=k(Nd=$WBb%yy#r~5F)>#b7PUtV`V z*Yh^rvC{bf4+v(0euAch4C%vwR!N6puY2jaYoTaFS}@2%B17yiFo^-wRyV;kGbjQx zj=&3r1UMlsAHbm?e*H3JQ@|LJ3y-?O42oUUH(fYuL3IHWadaAqEFIu>gwTQ$kRNlt z2S_Z%+qX~1%f|rB*Ya)awfv?8Y@DTQQ_3K9E1WE#@r1!s0Z0q^(}$jsg+~ zk`=+x;74Ht0tTj5K$fGhS@jVBx<7vkPpZiUAlty{FBRN~;4FF&DCgrJ71XA7=EVPu1pUOamEjhH*bhpoOLx3o(d?DSG+ z*abIWL?Z5*VNQcI*fJr{5%N;}fPKpV6t&t)9+`qcwtxSAn3@v>V<{rQ_ZI?;8%!1* zC8TtU{fdr^RC02X02nOIb!vV7SyxvVyP*@{B3nbnVPS?_rr#jUgAA03l=s_*J6-{@ z1I<50FQE6x>590XfOAtfIAm~B?%Q%)5&Q>`b~Ao+QEi$5nI*@qgK`uzhKWx^6vF&J zIPR~=(MtL3w3KNoPbMz-#<=#!`ZnX{i_=%;b1yr^*24Q&@0)?z@ z=w2)uziaPz!%G~OKxk`mEnNy>W4+k2qQHI*u9w(uX%8>k?%}|21~Rh!iZ>N5--k97 zk}J+YM(0mkPQa)t0UVi)bO1QW4D`c@77x+}JOT5X1KDkcNrhjv+dVb4o65=vdJ8Eq z;2Bkh#ul3U3ft62<|GISQPI|BgB_b(E_DBA5g|nY)#+ z!&*f6N(2>xFQyWhyl(+8gexQh0|WI2)?C=gNW_-3^Ar53ysMkP>V=j(qVhy1?Dd8l zSUbJ_s63ORUz+I+zaH%jkxy2hoZ(p2FHlVHNOFs|iuw4lq}qQeh)*`PvaLY0(ys-h z-JPPGBCsZps=BG!BS2K)ui5Z%#U=qLp9R-szc z%pr$th=V=uYXX3!yths@#WsMA6oJoy-Bg5U2M{MRD}|Q*!nawLK>$-S0XG6B6`?m}qI4W83>f2G(vl*4$#Ic88 zmjkRnTBx@%u}l0X+a6&pZgE1bkugNuNA*u!8c_-|0RE50YSwJ2cRO77X( z+9ING_}ykK>IQsTGb^sU?$D|48B#&s4Z~kOwl0lI;F}L0 zDuG%E1G6U(!22+q`Q`bYcw*GkSBkP&Ww*4c3Yh)MQ}Gg8yc*z^KVVuT z^s%io{{$Q?1G7k%mrt&dqQf+{kC*r0hf1wrw8eVPK)+ntmMBfLu!CE?{55p5Zwuva zlY2q909!ZhoBOsO{!iU*P@1OHo#sl2q={`TN)N_osEIjYf=d*2co~kock0pyvBjxy^2hF$jDA(wyDhvT7slx7v0R>_NRP84 z^Y>ycI(hxAUsmYUYI_G}X;B&p8(G;I>r&p~j_<3lORUnGd;j8Ma=&}{sH!CE*d<;& zH>A(TsAy=1>06#! zLmf`ax@dDxf=qIfm^cGUmbFm&XUyRz`cVO%j$-Mndn=CwA3{60?%X*vcE&EQulI@naet}t{L(ZpkBgo!UX5{d^z}_= zgt9p0a;LvxG=EsnhL>Gl{_s&=f2r0^o!MnQIvHV}3a|7UV&fArdgx=FtQ^9G^+RI; zy!Ud$?(E35f+K#-!q@}MN5=rJ$5_Fz?|w2Xm*^VlmbpsZm$s--_MAlL-rv?Aqe#)( z?hBPur4O6NADT*kGK-fVBpI!3q^#vE8V5z1fvmbr@O1L}+S|VP!c&t)bDTzyCIt6?9Nghz}u8=3H90bl0r_4)6)Jnn!3+g@CSxs+1&L7& z5~65Da~dTc`J&FSZzvWk_q)8xVNpjTaco(%7<{^7ahDJpZ_WmzW2+2_)! zbNKm*UpxjRdx6Q46m?%LmNCcKfvOX4Qg=nw$o~c5(uKy^CO5hp(SBjr&xYFRDE{eX zdHJQRDx+J1e>N?TIxD32y{TZ2Ii22Uq(i2qBpMKS!H7TWyiqe{H}{YFVx)2_bK_E4 zS#U`_bSBHD47Wc(Kym45^VkF1TMCcl3bs{m3b7xR=$*D$@}8F9JxVDv51x2$Xfs@& zeZl>y-7%($pii`whd*UFW$f003O6LgzmGpuVB|0$eEVKjPn%5X<(Bg$uc^t?zTN)5 ztvk=AR(+55Kps9t%!1$OQzJWCfUrmUddK%HJ2+p1;s{4J7YfVEY9>POwo?CdF5c5+ vMl+wF=Ke^uQdQm*)JJ&y|K}^Vd)XsMJ?W*U!$&qUc-_3FqL6yU=-K}V_E9n= diff --git a/classripple_1_1DisputedTx-members.html b/classripple_1_1DisputedTx-members.html index a0911036fd..4cfd3e0390 100644 --- a/classripple_1_1DisputedTx-members.html +++ b/classripple_1_1DisputedTx-members.html @@ -79,16 +79,20 @@ $(function() {

This is the complete list of members for ripple::DisputedTx< Tx_t, NodeID_t >, including all inherited members.

- - - - - - - - - - + + + + + + + + + + + + + + diff --git a/classripple_1_1DisputedTx.html b/classripple_1_1DisputedTx.html index 51a9b7d23e..9af350a348 100644 --- a/classripple_1_1DisputedTx.html +++ b/classripple_1_1DisputedTx.html @@ -91,9 +91,10 @@ Collaboration diagram for ripple::DisputedTx< Tx_t, NodeID_t >:
Collaboration graph
- - - + + + +
[legend]
DisputedTx(Tx_t const &tx, bool ourVote, std::size_t numPeers, beast::Journal j)ripple::DisputedTx< Tx_t, NodeID_t >
getJson() constripple::DisputedTx< Tx_t, NodeID_t >
getOurVote() constripple::DisputedTx< Tx_t, NodeID_t >
ID() constripple::DisputedTx< Tx_t, NodeID_t >
j_ripple::DisputedTx< Tx_t, NodeID_t >private
Map_t typedefripple::DisputedTx< Tx_t, NodeID_t >private
nays_ripple::DisputedTx< Tx_t, NodeID_t >private
ourVote_ripple::DisputedTx< Tx_t, NodeID_t >private
setOurVote(bool o)ripple::DisputedTx< Tx_t, NodeID_t >
setVote(NodeID_t const &peer, bool votesYes)ripple::DisputedTx< Tx_t, NodeID_t >
avalancheCounter_ripple::DisputedTx< Tx_t, NodeID_t >private
avalancheState_ripple::DisputedTx< Tx_t, NodeID_t >private
currentVoteCounter_ripple::DisputedTx< Tx_t, NodeID_t >private
DisputedTx(Tx_t const &tx, bool ourVote, std::size_t numPeers, beast::Journal j)ripple::DisputedTx< Tx_t, NodeID_t >
getJson() constripple::DisputedTx< Tx_t, NodeID_t >
getOurVote() constripple::DisputedTx< Tx_t, NodeID_t >
ID() constripple::DisputedTx< Tx_t, NodeID_t >
j_ripple::DisputedTx< Tx_t, NodeID_t >private
Map_t typedefripple::DisputedTx< Tx_t, NodeID_t >private
nays_ripple::DisputedTx< Tx_t, NodeID_t >private
ourVote_ripple::DisputedTx< Tx_t, NodeID_t >private
setOurVote(bool o)ripple::DisputedTx< Tx_t, NodeID_t >
setVote(NodeID_t const &peer, bool votesYes)ripple::DisputedTx< Tx_t, NodeID_t >
stalled(ConsensusParms const &p, bool proposing, int peersUnchanged) constripple::DisputedTx< Tx_t, NodeID_t >
tx() constripple::DisputedTx< Tx_t, NodeID_t >
tx_ripple::DisputedTx< Tx_t, NodeID_t >private
TxID_t typedefripple::DisputedTx< Tx_t, NodeID_t >private
@@ -108,15 +109,18 @@ Public Member Functions + + + - - - + + + @@ -146,6 +150,15 @@ Private Attributes + + + + + + + + +
bool getOurVote () const
 Our vote on whether the transaction should be included. More...
 
bool stalled (ConsensusParms const &p, bool proposing, int peersUnchanged) const
 Are we and our peers "stalled" where we probably won't change our vote? More...
 
Tx_t const & tx () const
 The disputed transaction. More...
 
void setOurVote (bool o)
 Change our vote. More...
 
void setVote (NodeID_t const &peer, bool votesYes)
 Change a peer's vote. More...
 
bool setVote (NodeID_t const &peer, bool votesYes)
 Change a peer's vote. More...
 
void unVote (NodeID_t const &peer)
 Remove a peer's vote. More...
 
 
Map_t votes_
 
std::size_t currentVoteCounter_ = 0
 The number of rounds we've gone without changing our vote. More...
 
ConsensusParms::AvalancheState avalancheState_ = ConsensusParms::init
 Which minimum acceptance percentage phase we are currently in. More...
 
std::size_t avalancheCounter_ = 0
 How long we have been in the current acceptance phase. More...
 
beast::Journal const j_
 
@@ -318,6 +331,46 @@ template<class Tx_t , class NodeID_t >

Definition at line 80 of file DisputedTx.h.

+ + + +

◆ stalled()

+ +
+
+
+template<class Tx_t , class NodeID_t >
+ + + + + + + + + + + + + + + + + + + + + + + + +
bool ripple::DisputedTx< Tx_t, NodeID_t >::stalled (ConsensusParms const & p,
bool proposing,
int peersUnchanged 
) const
+
+ +

Are we and our peers "stalled" where we probably won't change our vote?

+ +

Definition at line 88 of file DisputedTx.h.

+
@@ -339,7 +392,7 @@ template<class Tx_t , class NodeID_t >

The disputed transaction.

-

Definition at line 87 of file DisputedTx.h.

+

Definition at line 132 of file DisputedTx.h.

@@ -363,12 +416,12 @@ template<class Tx_t , class NodeID_t >

Change our vote.

-

Definition at line 94 of file DisputedTx.h.

+

Definition at line 139 of file DisputedTx.h.

- -

◆ setVote()

+ +

◆ setVote()

@@ -376,7 +429,7 @@ template<class Tx_t , class NodeID_t >
template<class Tx_t , class NodeID_t >
- + @@ -399,12 +452,13 @@ template<class Tx_t , class NodeID_t >
Parameters
void ripple::DisputedTx< Tx_t, NodeID_t >::setVote bool ripple::DisputedTx< Tx_t, NodeID_t >::setVote ( NodeID_t const &  peer,
- +
peerIdentifier of peer.
votesYesWhether peer votes to include the disputed transaction.
votesYesWhether peer votes to include the disputed transaction.
+
Returns
bool Whether the peer changed its vote. (A new vote counts as a change.)
-

Definition at line 144 of file DisputedTx.h.

+

Definition at line 199 of file DisputedTx.h.

@@ -434,7 +488,7 @@ template<class Tx_t , class NodeID_t > -

Definition at line 183 of file DisputedTx.h.

+

Definition at line 242 of file DisputedTx.h.

@@ -484,7 +538,7 @@ template<class Tx_t , class NodeID_t >
Returns
Whether our vote changed
-

Definition at line 200 of file DisputedTx.h.

+

Definition at line 259 of file DisputedTx.h.

@@ -504,7 +558,7 @@ template<class Tx_t , class NodeID_t >

JSON representation of dispute, used for debugging.

-

Definition at line 255 of file DisputedTx.h.

+

Definition at line 322 of file DisputedTx.h.

@@ -531,7 +585,7 @@ template<class Tx_t , class NodeID_t >
-

Definition at line 133 of file DisputedTx.h.

+

Definition at line 182 of file DisputedTx.h.

@@ -557,7 +611,7 @@ template<class Tx_t , class NodeID_t >
-

Definition at line 134 of file DisputedTx.h.

+

Definition at line 183 of file DisputedTx.h.

@@ -583,7 +637,7 @@ template<class Tx_t , class NodeID_t >
-

Definition at line 135 of file DisputedTx.h.

+

Definition at line 184 of file DisputedTx.h.

@@ -609,7 +663,7 @@ template<class Tx_t , class NodeID_t >
-

Definition at line 136 of file DisputedTx.h.

+

Definition at line 185 of file DisputedTx.h.

@@ -635,7 +689,91 @@ template<class Tx_t , class NodeID_t >
-

Definition at line 137 of file DisputedTx.h.

+

Definition at line 186 of file DisputedTx.h.

+ +
+ + +

◆ currentVoteCounter_

+ +
+
+
+template<class Tx_t , class NodeID_t >
+ + + + + +
+ + + + +
std::size_t ripple::DisputedTx< Tx_t, NodeID_t >::currentVoteCounter_ = 0
+ 		+private
+
+ +

The number of rounds we've gone without changing our vote.

+ +

Definition at line 188 of file DisputedTx.h.

+ +
+
+ +

◆ avalancheState_

+ +
+
+
+template<class Tx_t , class NodeID_t >
+ + + + + +
+ + + + +
ConsensusParms::AvalancheState ripple::DisputedTx< Tx_t, NodeID_t >::avalancheState_ = ConsensusParms::init
+ 		+private
+
+ +

Which minimum acceptance percentage phase we are currently in.

+ +

Definition at line 190 of file DisputedTx.h.

+ +
+
+ +

◆ avalancheCounter_

+ +
+
+
+template<class Tx_t , class NodeID_t >
+ + + + + +
+ + + + +
std::size_t ripple::DisputedTx< Tx_t, NodeID_t >::avalancheCounter_ = 0
+ 		+private
+
+ +

How long we have been in the current acceptance phase.

+ +

Definition at line 192 of file DisputedTx.h.

@@ -661,7 +799,7 @@ template<class Tx_t , class NodeID_t >
-

Definition at line 138 of file DisputedTx.h.

+

Definition at line 193 of file DisputedTx.h.

diff --git a/classripple_1_1DisputedTx__coll__graph.map b/classripple_1_1DisputedTx__coll__graph.map index bfb4e14e86..5b5c7867c7 100644 --- a/classripple_1_1DisputedTx__coll__graph.map +++ b/classripple_1_1DisputedTx__coll__graph.map @@ -1,5 +1,6 @@ - - - + + + + diff --git a/classripple_1_1DisputedTx__coll__graph.md5 b/classripple_1_1DisputedTx__coll__graph.md5 index 1eb1cbaac6..bd465a7d9f 100644 --- a/classripple_1_1DisputedTx__coll__graph.md5 +++ b/classripple_1_1DisputedTx__coll__graph.md5 @@ -1 +1 @@ -0675f444b2c9725d89b558417f993bbe \ No newline at end of file +b84f5985eb8139b5687316779d373902 \ No newline at end of file diff --git a/classripple_1_1DisputedTx__coll__graph.png b/classripple_1_1DisputedTx__coll__graph.png index 085e0dd54b8aae0f3a9ed57460568941899d4192..7570f7a1fdddc03334025fc20826e6c84d3c275c 100644 GIT binary patch literal 11109 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 F{tqaW;BNo` literal 7549 zcmbW6by!qyxAzB80Z9>2M?w$@5u^r`ZbWJ6ltzXWq&o&dIweP1$|0mvX(^HJW@v^O zI^LV#bDrzG=ef>bhnTtMn!RWCz3#Qv_p`n`SV=*K_!jgQ1Og$JeI=;^o{`{x0skg= zOg?SX22VGQ-pEKoF0X#S*5}4RAkQmA-^Bt{rn3f z#km!qJE)>v_~&~6a~hT6_0k_huLm|pzAqY?S#62k));hD*3xS{?PBFCGuZN@dm2@t zmFBA~5guaxPPkEokx`U{ySb@n7HzMmn{arZSdBhUbaka&zL-4pVUUdme}ls;AA3^x zY^OQu^=AsQKSzx-(zQg%C-bga_En7=3-Qh%Q3_>f?qZ#Ds|xYk>cLHhZ90VLdWx;pN9_cr;wRuBB6fCm!Glp_kBeh8<6(6L;v^P{>^t5=Yt^}MrlqBU6ZX2f`-;6U zy%rYWwoVTVP&E^kwtK$_pJUbyE|YXBZH9C*UxI}bKjba`u=LuIpE@ckO7L*ffr5ep z!eQJ-)SD*MrD5PHWn;tcd3x|fP>`x#pR_3#=@mlex4Zk{U~8&txJXA)3tyI-+08XUuR(@@^LK|(h|q25kMwxQLb%|nH4j3S3|yj z{W|nK;`8T%9jO0JVsiM%cbLMxd-n)MR~&1kPoD*l{rvfpo`t1zQFzsnpVRxoV{Uu< zITaOEOR-^dOPY}Tnx4KfR?Rb~p`n3ZSa^DoKmT)B*j-Le&f6cCy7S=;)AjBm97O}G zRW3X95bYvLDP@q20s;aylT|;n-y}d@$;&@^^auj7oI=WQ?pNT7Bf_B{d{|ai7G^ow zmYjm3rR#ZPHwX&6yk>8Ax45#h9sImNSvtfgB$)4hsH>}^`GVfsvN>~Z52wbdazK;( zu|u+@4_O`$ATL_R%FJ1wJu^AkUzJPb3Pd%Wb{QG zW-8_pFsSIv_xqIBbk^f;Xz2w`rWWCdE)A3u|kyYn?Vb zIyxTF(fzEN^v5GDwHo8~D<4#4sriAI)~ZoL!l!<$Ej>ZUO?L zTkjTES0_mMOjFdtf?3G@;5v~2y0f!0HaV=at>P-UsZ7M1&`_zMjgN@M=|8`pM6i|jWy_b&hrItrV#>QF=9xp)&T)laI zdN@#|!`D=74Ax;FE+Jv>?2IlS(KiOG`(Zmn141KwG>e;&kpYt55VSzKB%aQyN##uG z{%QyFtK%IU9@EkJf)ZO;T)f_-V_V;9j`WlUxez8(oAa$92Za2df`S4O)r-icCea_- zY!emM+!ZMO`lMgK#KB9@C}C@5lE$9A3F-w)aT@xD*tMafV!y2bIsX@p*@tH*1>WjjySsO84hr6eUI)6#lDIPVKM6^<_n4${yX9k8!Y)`*bOna8hCBVF4J(Al^>)k06#_7a)||LGA|lQh-Zv|%}X z`>gNBIi$^zp-zXFwzYo`oC(EVurhaYYWY4d(2HSF>h})DPE6wai6&cW49QQL%@Oj=;g0>yFDyN! zoWEbmFXI=D3x!rA3G(P3uXOl$2T`vHp!a@2m5zl8KOc z0p#+T3Do$l3b&)!R1_a#{^&Iu250%sxUETL6WUce?5qZzcC6gIDA zQN|HZUe|8TPWw;>pWyNt-g8$si$*(HC(9#c;^D%wFfNbb1Y(ctXL!vQLx-Xq#rOZ< zjQECqxtM+qVZT=CrEex$UNN3LW%cd}=7}Bd(QTKCv?Zr&7xzXc&_r=39?NV;>vC(w$B?@=N84R*t_ufYgg^4(5z+v0VQyU2R)uFr zq!}T&@;dL)OS-Jwg`o2cPKIPB|z1EH4`fC)M6&VH5!Wny4zdsfo~;56&5}b=5}?H|96JT!iv~EKxa2QJ=nBN z=+6lV2q=C(z*yepB3eL*+{Z-D6)-Y0e`3?A_<~I#xWkA!Sx50Hidlmul9i_ z96s`e*BT0l*KvC~HIds~MOW9#>TrL5@$>Tr4uy3`ehR7dA3rEKHul&J8dCZ*WfnFz zx`ARn5Om>SRWE$k{e`otstPk|9I*q`FL@F@oUewkZAK6m>QQr)`(DU&nGo$6&ZfsZqzEaTFrvdP0#%2sQ zr%<~*=2OchTy8^()IVo1Gl%%4rc(3SOwRtzegnzM$ss2r^NESM6OvI3CJ#sc z=4yKb0|ONm6_>ppK7w1f=9dx-mM3f*%eAM#Dn}0U0>?!>yvgn zIA1OW`SCmPoW+i(3Luc`@Na!ZS_MP~Y90ByRdzUvii%*Q>9^paproV^__o6bfMa)W zFE}J*e#&`fX>F)r1?xsmPX6uNHx73Ad`mFZ3p=0gZaEPC=8mYx)t;xk5UBjXbhv)K zo3gU9n2pVM`{`;2bg1<^d<8X&rs4?AW{`a8OY8X6j4&b%v@$Qm~i%YR_JITTJjAEtD z6r?%ad8WaWfS9;-YASU^-#rXmX@7&KyN8Fz(X2n|r;w0et*wDlpD8)t|7BSCAQJ|a zLieU#9pBRv2Cmm>dpZp4BgD2IONsP6ct9=S#6z>0lyQ<|Ir3fa#mkqRcC(__aB=%B z%dI9VdPW=Eu$BOk!OMWaz@cw_J?}o>2y%mH*#^o>p^izlHGMb*%NS0Dps9e%Z~zH{7vby9XNEeVE5j-G++uMaV8|o@b@d_V`Q}}9fyt4SNECY1RXdVh%#@A zis3Ud-lTC>t7X(-Xg0^Wae)_bfhG_L)8F&^{bUSWI=3~{DeE&$+s@uaDI|ctyY`jD zHGnNSjT3a@c@?NaA8Fs*7(ecs0<8qL=sE5LLpF^CQF-QTzp2L;J@J!ch>#C1P9)>; zI6}v_la+YHnYmS2ej@--rK@Bj5%g;((pqA-C5A~a+H$kurKVgS%VfWa_Cxf9ita*d zf9J7jM}z^w={N8X7rIIGZJV+C+MJJ)S%sYzuRNkp@~)dag_6EOtj2o=;V6cV8Sn6I8Odc^L_Y@Y;|J9AvpLeoyZtN3gVa|RzXQ~ol`S>175 z*76U|S;>|*pF2gD!X`yuCO2OHV}SfGsz_N{IY6uNbyF|?N*7_7CkQ;*_<|Fhh-YdA zkw7H1>8i)dg{#M4QD^y5S4tKbeNEvyV#ja~ zhuD8nc3`wL6q`t^zB>&$y??o4klXs&wg0!}AlYyjNyTbLYr5{G>wi2H-7l zy=#K>B1IHI(*o*9#qaoOt~rR?;|K$dc91Lv{z^jQ$ zP3=h)aK;=SGCh47B17YP-3J$sBr-l;T31&$bpSSf-QB&$dAoP9Gp73EIwhE=O)#@R znM1@ucMJ3KI9^Kd*lE278ur!51~34~3M1CAGx|w)66`ZDQgD=1RDJ=$l702+9heJ& zEmr(-UA@9)Dg+P=m{zTSAi?O0j!_hz+ZZbYh8(BczD0~kCD8Qw`S~wgrni6z0s(z5 z%+K$d*Ix3>*M6RDI^UsqU|jVAdg-9Oz~CW>9;l#=Noa+;37^+B0abdyWr7d3BeSru zd+}fmfJC*^CiL^Y=ZwO_X*5D^#a`!b0c7%P?SIlGSlHN}h=^SJR-B!ATwEMBa+~*3 z37@PyW>ie;20GKdX6$KXWP~|5Fazcr10y4p?=TF@&B8)}hlh7{g(BXQmfhMQ3ph7P$mLxtM(BKh08F+p&HZo6nJ)YNGOK^mae=+n4nzQO zP0U0AupKZxd^2R!)bgP3U%d@1f}F2keONWVLpTh71wi4|;{({$zuANkpgV3~dwP3G z+}+*z9ant({c-Ev56u9)m|^>=!mwrFv@-KPF6(igl+@JK;i88zjPhLTuoLWhdzJmd zQJ2Am`0LlV9G1I(wzjrrxb>Kpdp6{g7SZX|I(fdU0o1a1@H8+m5R5MBI)KZxi-xn3 z)&VvW0pu9KwFZZoZcSE$EeitHXU34_0|BRJU`xyne^P*Nmk1)cG7!ws23r!-z+xyf zFdzJ;4B!9)5ar}x6RunoU#xvZk-hT}rBRmt;{SfC9l_41QZr_-i4@ zngJvInO1242ssz1Q3a&1wZ|4f;js$qhX!89Pk?v#40OVNueP?f-A*PXrdMG5euUF= zy&4mhOYgHC84^Hcz;dyeX%LDKK4AvAf8|)2cEt~^XgIjcHag46$pvIE*A@z8SuXvK z6Fl80Ym;zun6MVpS@ADdBhDKKnTxAcmgrEcGI1q;Ijy|4f171(oOEz>plgFFSANYm z-u&#kx)fkWmrpyviH=K5KB){T72F`C{L|=t3GKQCzS8$^sSfe@2L0yaKlafd6K4cC-T<*V&7t1&%$4rbMIHx%T4q+B|I|d`(Ns zrvNX(==Z1A*|y+WnXo$P3~0nx&L21ToiOQU5NWmsqB0feFt)`=;^#E9f^Fg#;kgwjC7m|{a_Z9tNyn}fq=_caN?rdS+%O%b@|A2i+|L&NeV< zJ32e(2J_w)YL;a5!&HD5bmPViN^3JocI^V&b;g1s zHLiPR`tF;sCX694jqlvM*A6s8_I19iu|M$YLBU^TO5c|=d|m!R(!44nCx#Kg|uajZN0`wYOj19Kk#$2F4=p2Q`; zc}>C8voT$t45o#h)0xXOP(t7YB;yTKh_-|m=?D*GC>wubKRgYwD>i+wDUI8nSQRJm%&esOqaUY7H?PLzkVTrvwGz zfrWv)0%r0--R^HzF#1Oq7Z;lm(C{p1 zu!Us&K^cfFv~tB;tVJSg5X^V)-t7msVPfE*dH>V=`5nKtosEuaf^ny3+v`w(LTXN< z@g#0XpgR8mf#BETV(6ZvdzVv3TP~l-)tY6h)hyv`b69^kZT!>k1|#ulLelqihg#C9 zkG0$NhiT(aUWt^AVZgVPSdEqPPaudNwgFMlu6PtTHh*eZHs`(=C1aVA<~|Bu_PZ(Q zz9yyqZ>(e(8gy?`{@AM&os^M|LyAS98YV{GT-~Ys=TD{J@Dhg^E=M4beys-Xr$S_< L6ePckzw`Tl*vA@{ diff --git a/classripple_1_1NetworkOPsImp-members.html b/classripple_1_1NetworkOPsImp-members.html index fea7098036..683cc87623 100644 --- a/classripple_1_1NetworkOPsImp-members.html +++ b/classripple_1_1NetworkOPsImp-members.html @@ -229,6 +229,8 @@ $(function() { unsubValidations(std::uint64_t uListener) overrideripple::NetworkOPsImpvirtual updateLocalTx(ReadView const &view) overrideripple::NetworkOPsImpvirtual validationsMutex_ripple::NetworkOPsImpprivate + validatorMasterPK_ripple::NetworkOPsImpprivate + validatorPK_ripple::NetworkOPsImpprivate waitHandlerCounter_ripple::NetworkOPsImpprivate ~NetworkOPs() override=defaultripple::NetworkOPs ~NetworkOPsImp() overrideripple::NetworkOPsImp diff --git a/classripple_1_1NetworkOPsImp.html b/classripple_1_1NetworkOPsImp.html index 23269f6bdd..c3c3cd8b98 100644 --- a/classripple_1_1NetworkOPsImp.html +++ b/classripple_1_1NetworkOPsImp.html @@ -101,56 +101,56 @@ Collaboration diagram for ripple::NetworkOPsImp:
Collaboration graph
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
[legend]
@@ -462,6 +462,10 @@ Private Attributes + + + + @@ -510,7 +514,7 @@ Static Private Attributes
 
RCLConsensus mConsensus
 
std::optional< PublicKey > const validatorPK_
 
std::optional< PublicKey > const validatorMasterPK_
 
ConsensusPhase mLastConsensusPhase
 
LedgerMaster & m_ledgerMaster

Detailed Description

-

Definition at line 83 of file NetworkOPs.cpp.

+

Definition at line 84 of file NetworkOPs.cpp.

Member Typedef Documentation

◆ SubMapType

@@ -532,7 +536,7 @@ Static Private Attributes
-

Definition at line 653 of file NetworkOPs.cpp.

+

Definition at line 660 of file NetworkOPs.cpp.

@@ -556,7 +560,7 @@ Static Private Attributes
-

Definition at line 654 of file NetworkOPs.cpp.

+

Definition at line 661 of file NetworkOPs.cpp.

@@ -580,7 +584,7 @@ Static Private Attributes
-

Definition at line 655 of file NetworkOPs.cpp.

+

Definition at line 662 of file NetworkOPs.cpp.

@@ -604,7 +608,7 @@ Static Private Attributes
-

Definition at line 699 of file NetworkOPs.cpp.

+

Definition at line 706 of file NetworkOPs.cpp.

@@ -660,7 +664,7 @@ Static Private Attributes running  -

Definition at line 116 of file NetworkOPs.cpp.

+

Definition at line 117 of file NetworkOPs.cpp.

@@ -696,7 +700,7 @@ Static Private Attributes sLastEntry  -

Definition at line 746 of file NetworkOPs.cpp.

+

Definition at line 756 of file NetworkOPs.cpp.

@@ -809,7 +813,7 @@ Static Private Attributes
-

Definition at line 222 of file NetworkOPs.cpp.

+

Definition at line 223 of file NetworkOPs.cpp.

@@ -836,7 +840,7 @@ Static Private Attributes
-

Definition at line 260 of file NetworkOPs.cpp.

+

Definition at line 267 of file NetworkOPs.cpp.

@@ -866,7 +870,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 863 of file NetworkOPs.cpp.

+

Definition at line 873 of file NetworkOPs.cpp.

@@ -906,7 +910,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1140 of file NetworkOPs.cpp.

+

Definition at line 1150 of file NetworkOPs.cpp.

@@ -936,7 +940,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 869 of file NetworkOPs.cpp.

+

Definition at line 879 of file NetworkOPs.cpp.

@@ -966,7 +970,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1160 of file NetworkOPs.cpp.

+

Definition at line 1170 of file NetworkOPs.cpp.

@@ -1030,7 +1034,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1214 of file NetworkOPs.cpp.

+

Definition at line 1224 of file NetworkOPs.cpp.

@@ -1076,7 +1080,7 @@ Static Private Attributes -

Definition at line 1290 of file NetworkOPs.cpp.

+

Definition at line 1300 of file NetworkOPs.cpp.

@@ -1123,7 +1127,7 @@ Static Private Attributes -

Definition at line 1265 of file NetworkOPs.cpp.

+

Definition at line 1275 of file NetworkOPs.cpp.

@@ -1145,7 +1149,7 @@ Static Private Attributes

Apply transactions in batches.

Continue until none are queued.

-

Definition at line 1330 of file NetworkOPs.cpp.

+

Definition at line 1340 of file NetworkOPs.cpp.

@@ -1173,7 +1177,7 @@ Static Private Attributes -

Definition at line 1344 of file NetworkOPs.cpp.

+

Definition at line 1354 of file NetworkOPs.cpp.

@@ -1213,7 +1217,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1555 of file NetworkOPs.cpp.

+

Definition at line 1565 of file NetworkOPs.cpp.

@@ -1283,7 +1287,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 4188 of file NetworkOPs.cpp.

+

Definition at line 4215 of file NetworkOPs.cpp.

@@ -1313,7 +1317,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1918 of file NetworkOPs.cpp.

+

Definition at line 1928 of file NetworkOPs.cpp.

@@ -1353,7 +1357,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 2353 of file NetworkOPs.cpp.

+

Definition at line 2380 of file NetworkOPs.cpp.

@@ -1393,7 +1397,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1924 of file NetworkOPs.cpp.

+

Definition at line 1951 of file NetworkOPs.cpp.

@@ -1421,7 +1425,7 @@ Static Private Attributes
-

Definition at line 1789 of file NetworkOPs.cpp.

+

Definition at line 1799 of file NetworkOPs.cpp.

@@ -1459,7 +1463,7 @@ Static Private Attributes
-

Definition at line 1683 of file NetworkOPs.cpp.

+

Definition at line 1693 of file NetworkOPs.cpp.

@@ -1499,7 +1503,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1843 of file NetworkOPs.cpp.

+

Definition at line 1853 of file NetworkOPs.cpp.

@@ -1529,7 +1533,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1943 of file NetworkOPs.cpp.

+

Definition at line 1970 of file NetworkOPs.cpp.

@@ -1558,7 +1562,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 875 of file NetworkOPs.cpp.

+

Definition at line 885 of file NetworkOPs.cpp.

@@ -1590,7 +1594,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 924 of file NetworkOPs.cpp.

+

Definition at line 934 of file NetworkOPs.cpp.

@@ -1619,7 +1623,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 881 of file NetworkOPs.cpp.

+

Definition at line 891 of file NetworkOPs.cpp.

@@ -1648,7 +1652,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 887 of file NetworkOPs.cpp.

+

Definition at line 897 of file NetworkOPs.cpp.

@@ -1677,7 +1681,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 893 of file NetworkOPs.cpp.

+

Definition at line 903 of file NetworkOPs.cpp.

@@ -1706,7 +1710,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 899 of file NetworkOPs.cpp.

+

Definition at line 909 of file NetworkOPs.cpp.

@@ -1736,7 +1740,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 2324 of file NetworkOPs.cpp.

+

Definition at line 2351 of file NetworkOPs.cpp.

@@ -1765,7 +1769,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1627 of file NetworkOPs.cpp.

+

Definition at line 1637 of file NetworkOPs.cpp.

@@ -1794,7 +1798,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1633 of file NetworkOPs.cpp.

+

Definition at line 1643 of file NetworkOPs.cpp.

@@ -1823,7 +1827,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1639 of file NetworkOPs.cpp.

+

Definition at line 1649 of file NetworkOPs.cpp.

@@ -1852,7 +1856,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1646 of file NetworkOPs.cpp.

+

Definition at line 1656 of file NetworkOPs.cpp.

@@ -1881,7 +1885,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1652 of file NetworkOPs.cpp.

+

Definition at line 1662 of file NetworkOPs.cpp.

@@ -1910,7 +1914,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1658 of file NetworkOPs.cpp.

+

Definition at line 1668 of file NetworkOPs.cpp.

@@ -1939,7 +1943,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1664 of file NetworkOPs.cpp.

+

Definition at line 1674 of file NetworkOPs.cpp.

@@ -1968,7 +1972,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1670 of file NetworkOPs.cpp.

+

Definition at line 1680 of file NetworkOPs.cpp.

@@ -1997,7 +2001,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 1677 of file NetworkOPs.cpp.

+

Definition at line 1687 of file NetworkOPs.cpp.

@@ -2026,7 +2030,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 2002 of file NetworkOPs.cpp.

+

Definition at line 2029 of file NetworkOPs.cpp.

@@ -2055,7 +2059,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 2412 of file NetworkOPs.cpp.

+

Definition at line 2439 of file NetworkOPs.cpp.

@@ -2101,7 +2105,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 2418 of file NetworkOPs.cpp.

+

Definition at line 2445 of file NetworkOPs.cpp.

@@ -2130,7 +2134,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 2823 of file NetworkOPs.cpp.

+

Definition at line 2850 of file NetworkOPs.cpp.

@@ -2159,7 +2163,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 2829 of file NetworkOPs.cpp.

+

Definition at line 2856 of file NetworkOPs.cpp.

@@ -2192,7 +2196,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 3912 of file NetworkOPs.cpp.

+

Definition at line 3939 of file NetworkOPs.cpp.

@@ -2221,7 +2225,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 2984 of file NetworkOPs.cpp.

+

Definition at line 3011 of file NetworkOPs.cpp.

@@ -2241,7 +2245,7 @@ Static Private Attributes
-

Definition at line 3002 of file NetworkOPs.cpp.

+

Definition at line 3029 of file NetworkOPs.cpp.

@@ -2271,7 +2275,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 3011 of file NetworkOPs.cpp.

+

Definition at line 3038 of file NetworkOPs.cpp.

@@ -2300,7 +2304,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 3016 of file NetworkOPs.cpp.

+

Definition at line 3043 of file NetworkOPs.cpp.

@@ -2330,7 +2334,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 2869 of file NetworkOPs.cpp.

+

Definition at line 2896 of file NetworkOPs.cpp.

@@ -2376,7 +2380,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 2835 of file NetworkOPs.cpp.

+

Definition at line 2862 of file NetworkOPs.cpp.

@@ -2406,7 +2410,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 2185 of file NetworkOPs.cpp.

+

Definition at line 2212 of file NetworkOPs.cpp.

@@ -2452,7 +2456,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3388 of file NetworkOPs.cpp.

+

Definition at line 3415 of file NetworkOPs.cpp.

@@ -2498,7 +2502,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3425 of file NetworkOPs.cpp.

+

Definition at line 3452 of file NetworkOPs.cpp.

@@ -2544,7 +2548,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3441 of file NetworkOPs.cpp.

+

Definition at line 3468 of file NetworkOPs.cpp.

@@ -2587,7 +2591,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3805 of file NetworkOPs.cpp.

+

Definition at line 3832 of file NetworkOPs.cpp.

@@ -2642,7 +2646,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3851 of file NetworkOPs.cpp.

+

Definition at line 3878 of file NetworkOPs.cpp.

@@ -2688,7 +2692,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3862 of file NetworkOPs.cpp.

+

Definition at line 3889 of file NetworkOPs.cpp.

@@ -2728,7 +2732,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3933 of file NetworkOPs.cpp.

+

Definition at line 3960 of file NetworkOPs.cpp.

@@ -2758,7 +2762,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3973 of file NetworkOPs.cpp.

+

Definition at line 4000 of file NetworkOPs.cpp.

@@ -2788,7 +2792,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3963 of file NetworkOPs.cpp.

+

Definition at line 3990 of file NetworkOPs.cpp.

@@ -2818,7 +2822,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3981 of file NetworkOPs.cpp.

+

Definition at line 4008 of file NetworkOPs.cpp.

@@ -2864,7 +2868,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4007 of file NetworkOPs.cpp.

+

Definition at line 4034 of file NetworkOPs.cpp.

@@ -2894,7 +2898,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4037 of file NetworkOPs.cpp.

+

Definition at line 4064 of file NetworkOPs.cpp.

@@ -2934,7 +2938,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3893 of file NetworkOPs.cpp.

+

Definition at line 3920 of file NetworkOPs.cpp.

@@ -2974,7 +2978,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3903 of file NetworkOPs.cpp.

+

Definition at line 3930 of file NetworkOPs.cpp.

@@ -3004,7 +3008,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3989 of file NetworkOPs.cpp.

+

Definition at line 4016 of file NetworkOPs.cpp.

@@ -3034,7 +3038,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 3999 of file NetworkOPs.cpp.

+

Definition at line 4026 of file NetworkOPs.cpp.

@@ -3064,7 +3068,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 2011 of file NetworkOPs.cpp.

+

Definition at line 2038 of file NetworkOPs.cpp.

@@ -3094,7 +3098,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4045 of file NetworkOPs.cpp.

+

Definition at line 4072 of file NetworkOPs.cpp.

@@ -3124,7 +3128,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4055 of file NetworkOPs.cpp.

+

Definition at line 4082 of file NetworkOPs.cpp.

@@ -3154,7 +3158,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4063 of file NetworkOPs.cpp.

+

Definition at line 4090 of file NetworkOPs.cpp.

@@ -3184,7 +3188,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4073 of file NetworkOPs.cpp.

+

Definition at line 4100 of file NetworkOPs.cpp.

@@ -3214,7 +3218,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4081 of file NetworkOPs.cpp.

+

Definition at line 4108 of file NetworkOPs.cpp.

@@ -3244,7 +3248,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4097 of file NetworkOPs.cpp.

+

Definition at line 4124 of file NetworkOPs.cpp.

@@ -3274,7 +3278,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4105 of file NetworkOPs.cpp.

+

Definition at line 4132 of file NetworkOPs.cpp.

@@ -3304,7 +3308,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4115 of file NetworkOPs.cpp.

+

Definition at line 4142 of file NetworkOPs.cpp.

@@ -3334,7 +3338,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 2295 of file NetworkOPs.cpp.

+

Definition at line 2322 of file NetworkOPs.cpp.

@@ -3364,7 +3368,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4123 of file NetworkOPs.cpp.

+

Definition at line 4150 of file NetworkOPs.cpp.

@@ -3394,7 +3398,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4133 of file NetworkOPs.cpp.

+

Definition at line 4160 of file NetworkOPs.cpp.

@@ -3424,7 +3428,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4140 of file NetworkOPs.cpp.

+

Definition at line 4167 of file NetworkOPs.cpp.

@@ -3464,7 +3468,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4153 of file NetworkOPs.cpp.

+

Definition at line 4180 of file NetworkOPs.cpp.

@@ -3494,7 +3498,7 @@ Static Private Attributes

Implements ripple::InfoSub::Source.

-

Definition at line 4163 of file NetworkOPs.cpp.

+

Definition at line 4190 of file NetworkOPs.cpp.

@@ -3523,7 +3527,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 564 of file NetworkOPs.cpp.

+

Definition at line 571 of file NetworkOPs.cpp.

@@ -3553,7 +3557,7 @@ Static Private Attributes

Implements ripple::NetworkOPs.

-

Definition at line 4090 of file NetworkOPs.cpp.

+

Definition at line 4117 of file NetworkOPs.cpp.

@@ -3603,7 +3607,7 @@ Static Private Attributes
-

Definition at line 934 of file NetworkOPs.cpp.

+

Definition at line 944 of file NetworkOPs.cpp.

@@ -3630,7 +3634,7 @@ Static Private Attributes
-

Definition at line 966 of file NetworkOPs.cpp.

+

Definition at line 976 of file NetworkOPs.cpp.

@@ -3657,7 +3661,7 @@ Static Private Attributes
-

Definition at line 980 of file NetworkOPs.cpp.

+

Definition at line 990 of file NetworkOPs.cpp.

@@ -3684,7 +3688,7 @@ Static Private Attributes
-

Definition at line 1009 of file NetworkOPs.cpp.

+

Definition at line 1019 of file NetworkOPs.cpp.

@@ -3711,7 +3715,7 @@ Static Private Attributes
-

Definition at line 1092 of file NetworkOPs.cpp.

+

Definition at line 1102 of file NetworkOPs.cpp.

@@ -3767,7 +3771,7 @@ Static Private Attributes
-

Definition at line 3024 of file NetworkOPs.cpp.

+

Definition at line 3051 of file NetworkOPs.cpp.

@@ -3811,7 +3815,7 @@ Static Private Attributes
-

Definition at line 3119 of file NetworkOPs.cpp.

+

Definition at line 3146 of file NetworkOPs.cpp.

@@ -3855,7 +3859,7 @@ Static Private Attributes
-

Definition at line 3175 of file NetworkOPs.cpp.

+

Definition at line 3202 of file NetworkOPs.cpp.

@@ -3899,7 +3903,7 @@ Static Private Attributes
-

Definition at line 3309 of file NetworkOPs.cpp.

+

Definition at line 3336 of file NetworkOPs.cpp.

@@ -3926,7 +3930,7 @@ Static Private Attributes
-

Definition at line 2090 of file NetworkOPs.cpp.

+

Definition at line 2117 of file NetworkOPs.cpp.

@@ -3954,7 +3958,7 @@ Static Private Attributes
-

Definition at line 2158 of file NetworkOPs.cpp.

+

Definition at line 2185 of file NetworkOPs.cpp.

@@ -3982,7 +3986,7 @@ Static Private Attributes
-

Definition at line 905 of file NetworkOPs.cpp.

+

Definition at line 915 of file NetworkOPs.cpp.

@@ -4021,7 +4025,7 @@ Static Private Attributes
Note
called while holding mSubLock
-

Definition at line 3759 of file NetworkOPs.cpp.

+

Definition at line 3786 of file NetworkOPs.cpp.

@@ -4049,7 +4053,7 @@ Static Private Attributes
-

Definition at line 3469 of file NetworkOPs.cpp.

+

Definition at line 3496 of file NetworkOPs.cpp.

@@ -4077,7 +4081,7 @@ Static Private Attributes
-

Definition at line 996 of file NetworkOPs.cpp.

+

Definition at line 1006 of file NetworkOPs.cpp.

@@ -4104,7 +4108,7 @@ Static Private Attributes
-

Definition at line 4528 of file NetworkOPs.cpp.

+

Definition at line 4555 of file NetworkOPs.cpp.

@@ -4157,7 +4161,7 @@ Static Private Attributes
-

Definition at line 122 of file NetworkOPs.cpp.

+

Definition at line 123 of file NetworkOPs.cpp.

@@ -4181,7 +4185,7 @@ Static Private Attributes
-

Definition at line 714 of file NetworkOPs.cpp.

+

Definition at line 721 of file NetworkOPs.cpp.

@@ -4205,7 +4209,7 @@ Static Private Attributes
-

Definition at line 715 of file NetworkOPs.cpp.

+

Definition at line 722 of file NetworkOPs.cpp.

@@ -4229,7 +4233,7 @@ Static Private Attributes
-

Definition at line 717 of file NetworkOPs.cpp.

+

Definition at line 724 of file NetworkOPs.cpp.

@@ -4253,7 +4257,7 @@ Static Private Attributes
-

Definition at line 719 of file NetworkOPs.cpp.

+

Definition at line 726 of file NetworkOPs.cpp.

@@ -4277,7 +4281,7 @@ Static Private Attributes
-

Definition at line 721 of file NetworkOPs.cpp.

+

Definition at line 728 of file NetworkOPs.cpp.

@@ -4301,7 +4305,7 @@ Static Private Attributes
-

Definition at line 723 of file NetworkOPs.cpp.

+

Definition at line 730 of file NetworkOPs.cpp.

@@ -4325,7 +4329,7 @@ Static Private Attributes
-

Definition at line 724 of file NetworkOPs.cpp.

+

Definition at line 731 of file NetworkOPs.cpp.

@@ -4349,7 +4353,7 @@ Static Private Attributes
-

Definition at line 725 of file NetworkOPs.cpp.

+

Definition at line 732 of file NetworkOPs.cpp.

@@ -4373,7 +4377,7 @@ Static Private Attributes
-

Definition at line 726 of file NetworkOPs.cpp.

+

Definition at line 733 of file NetworkOPs.cpp.

@@ -4397,7 +4401,7 @@ Static Private Attributes
-

Definition at line 728 of file NetworkOPs.cpp.

+

Definition at line 735 of file NetworkOPs.cpp.

@@ -4421,7 +4425,7 @@ Static Private Attributes
-

Definition at line 729 of file NetworkOPs.cpp.

+

Definition at line 736 of file NetworkOPs.cpp.

@@ -4445,7 +4449,7 @@ Static Private Attributes
-

Definition at line 730 of file NetworkOPs.cpp.

+

Definition at line 737 of file NetworkOPs.cpp.

@@ -4469,7 +4473,7 @@ Static Private Attributes
-

Definition at line 731 of file NetworkOPs.cpp.

+

Definition at line 738 of file NetworkOPs.cpp.

@@ -4493,7 +4497,55 @@ Static Private Attributes
-

Definition at line 733 of file NetworkOPs.cpp.

+

Definition at line 740 of file NetworkOPs.cpp.

+ +
+ + +

◆ validatorPK_

+ +
+
+ + + + + +
+ + + + +
std::optional<PublicKey> const ripple::NetworkOPsImp::validatorPK_
+ 		+private
+
+ +

Definition at line 742 of file NetworkOPs.cpp.

+ +
+
+ +

◆ validatorMasterPK_

+ +
+
+ + + + + +
+ + + + +
std::optional<PublicKey> const ripple::NetworkOPsImp::validatorMasterPK_
+ 		+private
+
+ +

Definition at line 743 of file NetworkOPs.cpp.

@@ -4517,7 +4569,7 @@ Static Private Attributes
-

Definition at line 735 of file NetworkOPs.cpp.

+

Definition at line 745 of file NetworkOPs.cpp.

@@ -4541,7 +4593,7 @@ Static Private Attributes
-

Definition at line 737 of file NetworkOPs.cpp.

+

Definition at line 747 of file NetworkOPs.cpp.

@@ -4565,7 +4617,7 @@ Static Private Attributes
-

Definition at line 739 of file NetworkOPs.cpp.

+

Definition at line 749 of file NetworkOPs.cpp.

@@ -4589,7 +4641,7 @@ Static Private Attributes
-

Definition at line 740 of file NetworkOPs.cpp.

+

Definition at line 750 of file NetworkOPs.cpp.

@@ -4613,7 +4665,7 @@ Static Private Attributes
-

Definition at line 742 of file NetworkOPs.cpp.

+

Definition at line 752 of file NetworkOPs.cpp.

@@ -4637,7 +4689,7 @@ Static Private Attributes
-

Definition at line 744 of file NetworkOPs.cpp.

+

Definition at line 754 of file NetworkOPs.cpp.

@@ -4661,7 +4713,7 @@ Static Private Attributes
-

Definition at line 759 of file NetworkOPs.cpp.

+

Definition at line 769 of file NetworkOPs.cpp.

@@ -4685,7 +4737,7 @@ Static Private Attributes
-

Definition at line 761 of file NetworkOPs.cpp.

+

Definition at line 771 of file NetworkOPs.cpp.

@@ -4709,7 +4761,7 @@ Static Private Attributes
-

Definition at line 763 of file NetworkOPs.cpp.

+

Definition at line 773 of file NetworkOPs.cpp.

@@ -4733,7 +4785,7 @@ Static Private Attributes
-

Definition at line 766 of file NetworkOPs.cpp.

+

Definition at line 776 of file NetworkOPs.cpp.

@@ -4757,7 +4809,7 @@ Static Private Attributes
-

Definition at line 769 of file NetworkOPs.cpp.

+

Definition at line 779 of file NetworkOPs.cpp.

@@ -4781,7 +4833,7 @@ Static Private Attributes
-

Definition at line 772 of file NetworkOPs.cpp.

+

Definition at line 782 of file NetworkOPs.cpp.

@@ -4805,7 +4857,7 @@ Static Private Attributes
-

Definition at line 773 of file NetworkOPs.cpp.

+

Definition at line 783 of file NetworkOPs.cpp.

@@ -4829,7 +4881,7 @@ Static Private Attributes
-

Definition at line 774 of file NetworkOPs.cpp.

+

Definition at line 784 of file NetworkOPs.cpp.

@@ -4853,7 +4905,7 @@ Static Private Attributes
-

Definition at line 775 of file NetworkOPs.cpp.

+

Definition at line 785 of file NetworkOPs.cpp.

@@ -4877,7 +4929,7 @@ Static Private Attributes
-

Definition at line 777 of file NetworkOPs.cpp.

+

Definition at line 787 of file NetworkOPs.cpp.

@@ -4901,7 +4953,7 @@ Static Private Attributes
-

Definition at line 779 of file NetworkOPs.cpp.

+

Definition at line 789 of file NetworkOPs.cpp.

@@ -4925,7 +4977,7 @@ Static Private Attributes
-

Definition at line 780 of file NetworkOPs.cpp.

+

Definition at line 790 of file NetworkOPs.cpp.

@@ -4949,7 +5001,7 @@ Static Private Attributes
-

Definition at line 834 of file NetworkOPs.cpp.

+

Definition at line 844 of file NetworkOPs.cpp.

@@ -4973,7 +5025,7 @@ Static Private Attributes
-

Definition at line 835 of file NetworkOPs.cpp.

+

Definition at line 845 of file NetworkOPs.cpp.

diff --git a/classripple_1_1NetworkOPsImp_1_1StateAccounting.html b/classripple_1_1NetworkOPsImp_1_1StateAccounting.html index d5fad3f7c7..e2ee9a07a9 100644 --- a/classripple_1_1NetworkOPsImp_1_1StateAccounting.html +++ b/classripple_1_1NetworkOPsImp_1_1StateAccounting.html @@ -147,7 +147,7 @@ Static Private Attributes

This data can be polled through server_info and represented by monitoring systems similarly to how bandwidth, CPU, and other counter-based metrics are managed.

State accounting is more accurate than periodic sampling of server state. With periodic sampling, it is very likely that state transitions are missed, and accuracy of time spent in each state is very rough.

-

Definition at line 138 of file NetworkOPs.cpp.

+

Definition at line 139 of file NetworkOPs.cpp.

Constructor & Destructor Documentation

◆ StateAccounting()

@@ -172,7 +172,7 @@ Static Private Attributes
-

Definition at line 158 of file NetworkOPs.cpp.

+

Definition at line 159 of file NetworkOPs.cpp.

@@ -202,7 +202,7 @@ Static Private Attributes -

Definition at line 4566 of file NetworkOPs.cpp.

+

Definition at line 4593 of file NetworkOPs.cpp.

@@ -225,7 +225,7 @@ Static Private Attributes

Output state counters in JSON format.

@obj Json object to which to add state accounting data.

-

Definition at line 4587 of file NetworkOPs.cpp.

+

Definition at line 4614 of file NetworkOPs.cpp.

@@ -244,7 +244,7 @@ Static Private Attributes
-

Definition at line 190 of file NetworkOPs.cpp.

+

Definition at line 191 of file NetworkOPs.cpp.

@@ -269,7 +269,7 @@ Static Private Attributes
-

Definition at line 148 of file NetworkOPs.cpp.

+

Definition at line 149 of file NetworkOPs.cpp.

@@ -293,7 +293,7 @@ Static Private Attributes
-

Definition at line 149 of file NetworkOPs.cpp.

+

Definition at line 150 of file NetworkOPs.cpp.

@@ -317,7 +317,7 @@ Static Private Attributes
-

Definition at line 150 of file NetworkOPs.cpp.

+

Definition at line 151 of file NetworkOPs.cpp.

@@ -344,7 +344,7 @@ Static Private Attributes
std::chrono::steady_clock::now()
-

Definition at line 151 of file NetworkOPs.cpp.

+

Definition at line 152 of file NetworkOPs.cpp.

@@ -368,7 +368,7 @@ Static Private Attributes
-

Definition at line 153 of file NetworkOPs.cpp.

+

Definition at line 154 of file NetworkOPs.cpp.

@@ -392,7 +392,7 @@ Static Private Attributes
-

Definition at line 154 of file NetworkOPs.cpp.

+

Definition at line 155 of file NetworkOPs.cpp.

@@ -422,9 +422,9 @@ Static Private Attributes
Json::StaticString(stateNames[3]),
Json::StaticString(stateNames[4])}}
Json::StaticString
Lightweight wrapper to tag static string.
Definition: json_value.h:62
-
ripple::stateNames
static std::array< char const *, 5 > const stateNames
Definition: NetworkOPs.cpp:844
+
ripple::stateNames
static std::array< char const *, 5 > const stateNames
Definition: NetworkOPs.cpp:854
-

Definition at line 155 of file NetworkOPs.cpp.

+

Definition at line 156 of file NetworkOPs.cpp.

diff --git a/classripple_1_1NetworkOPsImp_1_1TransactionStatus.html b/classripple_1_1NetworkOPsImp_1_1TransactionStatus.html index 23662f4ebe..e3ad12af66 100644 --- a/classripple_1_1NetworkOPsImp_1_1TransactionStatus.html +++ b/classripple_1_1NetworkOPsImp_1_1TransactionStatus.html @@ -155,7 +155,7 @@ Public Attributes

Detailed Description

Transaction with input flags and results to be applied in batches.

-

Definition at line 89 of file NetworkOPs.cpp.

+

Definition at line 90 of file NetworkOPs.cpp.

Constructor & Destructor Documentation

◆ TransactionStatus()

@@ -195,7 +195,7 @@ Public Attributes
-

Definition at line 99 of file NetworkOPs.cpp.

+

Definition at line 100 of file NetworkOPs.cpp.

@@ -212,7 +212,7 @@ Public Attributes
-

Definition at line 92 of file NetworkOPs.cpp.

+

Definition at line 93 of file NetworkOPs.cpp.

@@ -228,7 +228,7 @@ Public Attributes
-

Definition at line 93 of file NetworkOPs.cpp.

+

Definition at line 94 of file NetworkOPs.cpp.

@@ -244,7 +244,7 @@ Public Attributes
-

Definition at line 94 of file NetworkOPs.cpp.

+

Definition at line 95 of file NetworkOPs.cpp.

@@ -260,7 +260,7 @@ Public Attributes
-

Definition at line 95 of file NetworkOPs.cpp.

+

Definition at line 96 of file NetworkOPs.cpp.

@@ -276,7 +276,7 @@ Public Attributes
-

Definition at line 96 of file NetworkOPs.cpp.

+

Definition at line 97 of file NetworkOPs.cpp.

@@ -292,7 +292,7 @@ Public Attributes
-

Definition at line 97 of file NetworkOPs.cpp.

+

Definition at line 98 of file NetworkOPs.cpp.

diff --git a/classripple_1_1NetworkOPsImp__coll__graph.map b/classripple_1_1NetworkOPsImp__coll__graph.map index b2f8a85034..ec3a211116 100644 --- a/classripple_1_1NetworkOPsImp__coll__graph.map +++ b/classripple_1_1NetworkOPsImp__coll__graph.map @@ -1,52 +1,52 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/classripple_1_1NetworkOPsImp__coll__graph.md5 b/classripple_1_1NetworkOPsImp__coll__graph.md5 index 9a3377eb0a..8bbcfcf8e6 100644 --- a/classripple_1_1NetworkOPsImp__coll__graph.md5 +++ b/classripple_1_1NetworkOPsImp__coll__graph.md5 @@ -1 +1 @@ -de8de2ced0113975b178bc1f02b49252 \ No newline at end of file +7d3bae2c8475e198e511e21ed90d6150 \ No newline at end of file diff --git a/classripple_1_1NetworkOPsImp__coll__graph.png b/classripple_1_1NetworkOPsImp__coll__graph.png index dad837cbba75e25d897b4443c132b4fd621b572d..35b976a5e84d7dc8e754f08b234c03a29c9b2d25 100644 GIT binary patch literal 711997 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

^=ALkbN7I+?EW=GBTWaV9^7J6=K5HOW$ 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 U7ckv7YD8V3 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

(voUNs7N$+jM6N#)u(*z^iN)J~BufQs8WYT6 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 z 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�r-eflCL8!tvtkp!7}WX!t$v%q=6@JQ9&l@;1lOYG7^(Yr z`;|MZxh3POGl}Pik|qp6aL)w3LVt8wJoR-7{`K&vliE0UQ1alQNOKu}e9A(5vA)RE z8)wovkbLIc7VJw*54f&INB_}|h#$V4cy?EtIpAw23r5pt-XCZ@TS@@W@*w(|ad(+T zNa2yw)6wkE&J|rSV6X85arjrxnW_>FuI(A}ugAOC6VQX6-+9$(M$(1Xd*VrIIe0j2 zkB+ZO8qd*Jm{mIpMzg;g&efh7STX}#Bxd|q0h*I;6prbNJ^Y-J zZHyCJ+yQxiGo|F^hc|jUt74%-#Id!E{~upp9TjE!MLV=eiAYH)C@3Hx-Kc<+bcv*d zBhm~#NQkt6lyrk22uL>!qS8Z1N(>?03|(`d!QXe+{p&t!!TLT0*Szn0o^$rud%w@Q zT5wBjvwiVyF=dsxJMf;FM!EP5RhH6rED$-kXG!A>X7UTi*{DgF`*lg-PL?gTi2lSq zyJE(qGjjjiQ(&}=IRUEc8-r;M%3*E`JY=BsjL3u*$z}uA70_r)kJ6uJ+DrFgeb)jJ zMRn5v+4aKOY48{#s2L}TS_A(N5M5ZNMrblp0Af!yO83{50;EJu`D?d^b;m0)!a|cb zG?eEoJYX?ePe%f9K<-gc~(QYC@6orT56 z19fcoqUuQvGRX6aR*Lprd9{sA<(HhlEC+IEOd~slCJ6=yM7Rx@Hw(@(R&`QO~ z@#2`yXVmz4gFTa8iAed|6Rq&gV@2x*EiKz@{g|!>WYiT0 z5}__Zc8odao!dF0Y^TEvs(`=n16tQSyuCGJv!V2Gt(8keK?q&=(;EuXaPh3lJ%* z)SrI<9(u2lsFvbU&105jc`Pd#uK;9d&;?BZK7ma;GX*ys%rC-r^Q?sfN z$m4Mg>J}|8HTdPD1OP~S9&Tt@naJvDk;T6|uOa@({b*-;RP%Q_Bbn%^&MP9OFfJ*q zZB91^+8+6{!lIq|o84@xSR!NS4AA$Uv=o*8I$`mZ3wGPsZkO1SQ&zqTnb{AeiWV}* z2UR1};P+=bY0E2%;|I+TO)^9&vnCuA);^F5+703dIMm{xZ5cW{J0TjYM^-z|f?-%r zn%2~n+HHL@6kCy6q%Mw{*Dx0srvqhh_mC?*&D&2toS`$i1vjyTslAW%iSb(@y;6gK ziiyhBI9gM=rh4$~4kvvif9Rm9Z(4VP*#(}esk3BK*>I~I19TFCRV#M)nXa27$P!B{O2Ua(%<&*sR_=wT5wM$yuaL!`H} z{X+^Gfds{pIa)N^yy{BAlmwZA^z2+}B;c>GwDCl_sCy&sXu<1OV`bC3_1GgE-w+Y_ zuswo8G$A1`%Hp$~^*>oOnY^T>RMi~_(C1Ru%6#22N*l8L{b~byd?-K^pbc^n{0~J$ z9y9mMBYmZhAT1<;+vwc|ll=aR|Iw1;4Zw!y71FijW18(bDHIfLN)e_nx&;f^E-E6CV z_#ajL3i$!JkxbHxJRaphS@NXQr3=ftCD2Q?;8O?o=cjT>Xqjz0OixOIJN%!LM^qvr6dfi%WX*#xzKHjU(#7lBT) z#}x2qxKv_mq-2`KpNyjAwN9s&Sc^XiR$_WSx;4+1IbfhnW!&4o=9i=ZvsY^;=$(l| ziT-$)vHhm%Dr@1?)w7-U*_&jO@3$ySYWky(r_Sh;#e3t7FvQ8hF*p{Mg#=!QqP#_`t0gwZVnzwFmu)8l-TTv@9Dv+SI^ z^*Z8eUYRefK?4fCb5;B7(vW12^~t<=>$U%VyJ7RmNC;&CP>^d^MOs>8$H%ePUyG>2 z<(?yR(lNpMZ*aWJm%xij1;4tSzt;7+Ukn2OUAn(a^K=n8o`(*BK+v<%^!bynB`c{u zRZeM59cC7m4{yWhnhScKvStTFkcmEi