LCOV - code coverage report
Current view: top level - discof/replay - fd_replay_tile.c (source / functions) Hit Total Coverage
Test: cov.lcov Lines: 0 1805 0.0 %
Date: 2026-03-05 05:37:44 Functions: 0 104 0.0 %

          Line data    Source code
       1             : #include "fd_replay_tile.h"
       2             : #include "fd_sched.h"
       3             : #include "fd_execrp.h"
       4             : #include "fd_vote_tracker.h"
       5             : #include "generated/fd_replay_tile_seccomp.h"
       6             : 
       7             : #include "../genesis/fd_genesi_tile.h"
       8             : #include "../poh/fd_poh.h"
       9             : #include "../poh/fd_poh_tile.h"
      10             : #include "../tower/fd_tower_tile.h"
      11             : #include "../resolv/fd_resolv_tile.h"
      12             : #include "../restore/utils/fd_ssload.h"
      13             : 
      14             : #include "../../disco/tiles.h"
      15             : #include "../../disco/fd_txn_m.h"
      16             : #include "../../disco/store/fd_store.h"
      17             : #include "../../disco/pack/fd_pack.h"
      18             : #include "../../discof/fd_accdb_topo.h"
      19             : #include "../../discof/reasm/fd_reasm.h"
      20             : #include "../../disco/keyguard/fd_keyload.h"
      21             : #include "../../disco/keyguard/fd_keyswitch.h"
      22             : #include "../../disco/genesis/fd_genesis_cluster.h"
      23             : #include "../../discof/genesis/genesis_hash.h"
      24             : #include "../../util/pod/fd_pod.h"
      25             : #include "../../flamenco/accdb/fd_accdb_admin_v1.h"
      26             : #include "../../flamenco/accdb/fd_accdb_admin_v2.h"
      27             : #include "../../flamenco/accdb/fd_accdb_impl_v1.h"
      28             : #include "../../flamenco/accdb/fd_accdb_sync.h"
      29             : #include "../../flamenco/accdb/fd_vinyl_req_pool.h"
      30             : #include "../../flamenco/rewards/fd_rewards.h"
      31             : #include "../../flamenco/leaders/fd_multi_epoch_leaders.h"
      32             : #include "../../flamenco/progcache/fd_progcache_admin.h"
      33             : #include "../../disco/metrics/fd_metrics.h"
      34             : 
      35             : #include "../../flamenco/runtime/fd_runtime.h"
      36             : #include "../../flamenco/runtime/fd_runtime_stack.h"
      37             : #include "../../flamenco/runtime/fd_genesis_parse.h"
      38             : #include "../../flamenco/fd_flamenco_base.h"
      39             : #include "../../flamenco/runtime/sysvar/fd_sysvar_epoch_schedule.h"
      40             : #include "../../flamenco/runtime/program/fd_precompiles.h"
      41             : 
      42             : # if FD_HAS_FLATCC
      43             : #include "../../flamenco/runtime/tests/fd_dump_pb.h"
      44             : #endif
      45             : 
      46             : #include <stdio.h>
      47             : 
      48             : /* Replay concepts:
      49             : 
      50             :    - Blocks are aggregations of entries aka. microblocks which are
      51             :      groupings of txns and are constructed by the block producer (see
      52             :      fd_pack).
      53             : 
      54             :    - Entries are grouped into entry batches by the block producer (see
      55             :      fd_pack / fd_shredder).
      56             : 
      57             :    - Entry batches are divided into chunks known as shreds by the block
      58             :      producer (see fd_shredder).
      59             : 
      60             :    - Shreds are grouped into forward-error-correction sets (FEC sets) by
      61             :      the block producer (see fd_shredder).
      62             : 
      63             :    - Shreds are transmitted to the rest of the cluster via the Turbine
      64             :      protocol (see fd_shredder / fd_shred).
      65             : 
      66             :    - Once enough shreds within a FEC set are received to recover the
      67             :      entirety of the shred data encoded by that FEC set, the receiver
      68             :      can "complete" the FEC set (see fd_fec_resolver).
      69             : 
      70             :    - If shreds in the FEC set are missing such that it can't complete,
      71             :      the receiver can use the Repair protocol to request missing shreds
      72             :      in FEC set (see fd_repair).
      73             : 
      74             :   -  The current Repair protocol does not support requesting coding
      75             :      shreds.  As a result, some FEC sets might be actually complete
      76             :      (contain all data shreds).  Repair currently hacks around this by
      77             :      forcing completion but the long-term solution is to add support for
      78             :      fec_repairing coding shreds via Repair.
      79             : 
      80             :   - FEC sets are delivered in partial-order to the Replay tile by the
      81             :     Repair tile.  Currently Replay only supports replaying entry batches
      82             :     so FEC sets need to reassembled into an entry batch before they can
      83             :     be replayed.  The new Dispatcher will change this by taking a FEC
      84             :     set as input instead. */
      85             : 
      86           0 : #define IN_KIND_SNAP       ( 0)
      87           0 : #define IN_KIND_GENESIS    ( 1)
      88           0 : #define IN_KIND_IPECHO     ( 2)
      89           0 : #define IN_KIND_TOWER      ( 3)
      90           0 : #define IN_KIND_RESOLV     ( 4)
      91           0 : #define IN_KIND_POH        ( 5)
      92           0 : #define IN_KIND_EXECRP     ( 6)
      93           0 : #define IN_KIND_SHRED      ( 7)
      94           0 : #define IN_KIND_TXSEND     ( 8)
      95           0 : #define IN_KIND_GUI        ( 9)
      96           0 : #define IN_KIND_RPC        (10)
      97           0 : #define IN_KIND_GOSSIP_OUT (11)
      98             : 
      99             : #define DEBUG_LOGGING 0
     100             : 
     101             : /* The first bank that the replay tile produces either for genesis
     102             :    or the snapshot boot will always be at bank index 0. */
     103           0 : #define FD_REPLAY_BOOT_BANK_IDX (0UL)
     104             : 
     105             : struct fd_replay_in_link {
     106             :   fd_wksp_t * mem;
     107             :   ulong       chunk0;
     108             :   ulong       wmark;
     109             :   ulong       mtu;
     110             : };
     111             : 
     112             : typedef struct fd_replay_in_link fd_replay_in_link_t;
     113             : 
     114             : struct fd_replay_out_link {
     115             :   ulong       idx;
     116             :   fd_wksp_t * mem;
     117             :   ulong       chunk0;
     118             :   ulong       wmark;
     119             :   ulong       chunk;
     120             : };
     121             : 
     122             : typedef struct fd_replay_out_link fd_replay_out_link_t;
     123             : 
     124             : /* fd_block_id_map is a simple map of block-ids to bank indices.  The
     125             :    map sits on top of an array of fd_block_id_ele_t.  This serves as a
     126             :    translation layer between block ids to bank indices.  The data
     127             :    array is indexed by bank index and the latest observed merkle root
     128             :    for the bank index is stored in the array.  Once the block id has
     129             :    been observed, the entry is keyed by the latest merkle root (aka the
     130             :    block id). */
     131             : 
     132             : struct fd_block_id_ele {
     133             :   fd_hash_t latest_mr;
     134             :   uint      latest_fec_idx;
     135             :   int       block_id_seen;
     136             :   ulong     slot;
     137             :   ulong     next_;
     138             : };
     139             : typedef struct fd_block_id_ele fd_block_id_ele_t;
     140             : 
     141             : #define MAP_NAME               fd_block_id_map
     142             : #define MAP_ELE_T              fd_block_id_ele_t
     143             : #define MAP_KEY_T              fd_hash_t
     144           0 : #define MAP_KEY                latest_mr
     145           0 : #define MAP_NEXT               next_
     146           0 : #define MAP_KEY_EQ(k0,k1)      (!memcmp((k0),(k1), sizeof(fd_hash_t)))
     147           0 : #define MAP_KEY_HASH(key,seed) (fd_hash((seed),(key),sizeof(fd_hash_t)))
     148             : #include "../../util/tmpl/fd_map_chain.c"
     149             : 
     150             : static inline ulong
     151           0 : fd_block_id_ele_get_idx( fd_block_id_ele_t * ele_arr, fd_block_id_ele_t * ele ) {
     152           0 :   return (ulong)(ele - ele_arr);
     153           0 : }
     154             : 
     155             : struct fd_replay_tile {
     156             :   fd_wksp_t * wksp;
     157             : 
     158             :   fd_accdb_admin_t     accdb_admin[1];
     159             :   fd_accdb_user_t      accdb[1];
     160             :   fd_progcache_admin_t progcache_admin[1];
     161             : 
     162             :   fd_txncache_t * txncache;
     163             :   fd_store_t *    store;
     164             :   fd_banks_t      banks[1];
     165             : 
     166             :   /* This flag is 1 If we have seen a vote signature that our node has
     167             :      sent out get rooted at least one time.  The value is 0 otherwise.
     168             :      We can't become leader and pack blocks until this flag has been
     169             :      set.  This parallels the Agave 'has_new_vote_been_rooted'. */
     170             :   int identity_vote_rooted;
     171             :   int wait_for_vote_to_start_leader;
     172             : 
     173             :   /* wfs_enabled is 1 if the validator is booted in
     174             :      wait_for_supermajority mode. In this mode replay (and, by extension,
     175             :      downstream consumers) is not allowed to make progress until 80% of
     176             :      the cluster has published their ContactInfo in Gossip with a
     177             :      shred version matching expected_shred_version. When this happens,
     178             :      wfs_complete will be set to 1. */
     179             :   int   wfs_enabled;
     180             :   int   wfs_complete;
     181             : 
     182             :   fd_hash_t expected_bank_hash;
     183             : 
     184             :   ulong        reasm_seed;
     185             :   fd_reasm_t * reasm;
     186             : 
     187             :   fd_sched_t * sched;
     188             : 
     189             :   ulong                vote_tracker_seed;
     190             :   fd_vote_tracker_t *  vote_tracker;
     191             : 
     192             :   int          has_genesis_hash;
     193             :   char         genesis_path[ PATH_MAX ];
     194             :   fd_hash_t    genesis_hash[1];
     195             :   fd_genesis_t genesis[1];
     196             :   ulong        cluster_type;
     197             : 
     198             :   int   has_genesis_timestamp;
     199             :   ulong genesis_timestamp;
     200             :   int   has_expected_genesis_timestamp;
     201             :   ulong expected_genesis_timestamp;
     202             : 
     203             : #define FD_REPLAY_HARD_FORKS_MAX (64UL)
     204             :   ulong hard_forks_cnt;
     205             :   ulong hard_forks[ FD_REPLAY_HARD_FORKS_MAX ];
     206             :   ulong hard_forks_cnts[ FD_REPLAY_HARD_FORKS_MAX ];
     207             : 
     208             :   ushort expected_shred_version;
     209             :   ushort ipecho_shred_version;
     210             : 
     211             :   /* A note on publishing ...
     212             : 
     213             :      The watermarks are used to publish our fork-aware structures.  For
     214             :      example, store, banks, and txncache need to be published to release
     215             :      resources occupied by rooted or dead blocks.  In general,
     216             :      publishing has the effect of pruning forks in those structures,
     217             :      indicating that it is ok to release the memory being occupied by
     218             :      the blocks on said forks.  Tower is responsible for informing us of
     219             :      the latest block on the consensus rooted fork.  As soon as we can,
     220             :      we should move the published root as close as possible to the
     221             :      latest consensus root, publishing/pruning everything on the fork
     222             :      tree along the way.  That is, all the blocks that directly descend
     223             :      from the current published root (inclusive) to the new published
     224             :      root (exclusive) on the rooted fork, as well as all the minority
     225             :      forks that branch from said blocks.
     226             : 
     227             :      Ideally, we'd move the published root to the consensus root
     228             :      immediately upon receiving a new consensus root.  However, that's
     229             :      not always safe to do.  One thing we need to be careful about is
     230             :      making sure that there are no more users/consumers of
     231             :      soon-to-be-pruned blocks, lest a use-after-free occurs.  This can
     232             :      be done by using a reference counter for each block.  Any
     233             :      concurrent activity, such as transaction execution in the exec
     234             :      tiles, should retain a refcnt on the block for as
     235             :      long as it needs access to the shared fork-aware structures related
     236             :      to that block.  Eventually, refcnt on a given block will drop down
     237             :      to 0 as the block either finishes replaying or gets marked as dead,
     238             :      and any other tile that has retained a refcnt on the block releases
     239             :      it.  At that point, it becomes a candidate for pruning.  The key to
     240             :      safe publishing then becomes figuring out how far we could advance
     241             :      the published root, such that every minority fork branching off of
     242             :      blocks in between the current published root (inclusive) and the
     243             :      new published root (exclusive) is safe to be pruned.  This is a
     244             :      straightforward tree traversal, where if a block B on the rooted
     245             :      fork has refcnt 0, and all minority forks branching off of B also
     246             :      have refcnt 0, then B is safe to be pruned.  We advance the
     247             :      published root to the farthest consecutively prunable block on the
     248             :      rooted fork.  Note that reasm presents the replay tile with a clean
     249             :      view of the world where every block is chained off of a parent
     250             :      block.  So there are no orpahned/dangling tree nodes to worry
     251             :      about.  The world is a nice single tree as far as replay is
     252             :      concerned.
     253             : 
     254             :      In the following fork tree, every node is a block and the number in
     255             :      parentheses is the refcnt on the block.  The chain marked with
     256             :      double slashes is the rooted fork.  Suppose the published root is
     257             :      at block P, and consensus root is at block T.  We can't publish
     258             :      past block P because Q has refcnt 1.
     259             : 
     260             : 
     261             :           P(0)
     262             :         /    \\
     263             :       Q(1)    A(0)
     264             :             / ||  \
     265             :         X(0) B(0)  C(0)
     266             :        /      || \
     267             :       Y(0)   M(0) R(0)
     268             :             / ||   /  \
     269             :         D(2) T(0) J(0) L(0)
     270             :               ||
     271             :               ..
     272             :               ..
     273             :               ..
     274             :               ||
     275             :       blocks we might be actively replaying
     276             : 
     277             : 
     278             :      When refcnt on Q drops to 0, we would be able to advance the
     279             :      published root to block M, because blocks P, A, and B, as well as
     280             :      all subtrees branching off of them, have refcnt 0, and therefore
     281             :      can be pruned.  Block M itself cannot be pruned yet because its
     282             :      child block D has refcnt 2.  After publishing/pruning, the fork
     283             :      tree would be:
     284             : 
     285             : 
     286             :              M(0)
     287             :             / ||
     288             :         D(2) T(0)
     289             :               ||
     290             :               ..
     291             :               ..
     292             :               ..
     293             :               ||
     294             :       blocks we might be actively replaying
     295             : 
     296             : 
     297             :      As a result, the shared fork-aware structures can free resources
     298             :      for blocks P, A, B, and all subtrees branching off of them.
     299             : 
     300             :      For the reference counting part, the replay tile is the sole entity
     301             :      that can update the refcnt.  This ensures that all refcnt increment
     302             :      and decrement attempts are serialized at the replay tile, and that
     303             :      there are no racy resurrection of a soon-to-be-pruned block.  If a
     304             :      refcnt increment request arrives after a block has been pruned,
     305             :      replay simply rejects the request.
     306             : 
     307             :      A note on the implementation of the above ...
     308             : 
     309             :      Upon receiving a new consensus root, we descend down the rooted
     310             :      fork from the current published root to the new consensus root.  On
     311             :      each node/block of the rooted fork, we do a summation of the refcnt
     312             :      on the block and all the minority fork blocks branching from the
     313             :      block.  If the summation is 0, the block is safe for pruning.  We
     314             :      advance the published root to the far end of the consecutive run of
     315             :      0 refcnt sums originating from the current published root.  On our
     316             :      descent down the minority forks, we also mark any block that hasn't
     317             :      finished replaying as dead, so we don't waste time executing them.
     318             :      No more transactions shall be dispatched for execution from dead
     319             :      blocks.
     320             : 
     321             :      Blocks start out with a refcnt of 0.  Other tiles may send a
     322             :      request to the replay tile for a reference on a block.  The
     323             :      transaction dispatcher is another source of refcnt updates.  On
     324             :      every dispatch of a transaction for block B, we increment the
     325             :      refcnt for B.  And on every transaction finalization, we decrement
     326             :      the refcnt for B.  This means that whenever the refcnt on a block
     327             :      is 0, there is no more reference on that block from the execution
     328             :      pipeline.  While it might be tempting to simply increment the
     329             :      refcnt once when we start replaying a block, and decrement the
     330             :      refcnt once when we finish a block, this more fine-grained refcnt
     331             :      update strategy allows for aborting and potentially immediate
     332             :      pruning of blocks under interleaved block replay.  Upon receiving a
     333             :      new consensus root, we can simply look at the refcnt on minority
     334             :      fork blocks, and a refcnt of 0 would imply that the block is safe
     335             :      for pruning, even if we haven't finished replaying it.  Without the
     336             :      fine-grained refcnt, we would need to first stop dispatching from
     337             :      the aborted block, and then wait for a full drain of the execution
     338             :      pipeline to know for sure that there are no more in-flight
     339             :      transactions executing on the aborted block.  Note that this will
     340             :      allow the refcnt on any block to transiently drop down to 0.  We
     341             :      will not mistakenly prune an actively replaying block, aka a leaf
     342             :      node, that is chaining off of the rooted fork, because the
     343             :      consensus root is always an ancestor of the actively replaying tip.
     344             :      */
     345             :   fd_hash_t consensus_root;          /* The most recent block to have reached max lockout in the tower. */
     346             :   ulong     consensus_root_slot;     /* slot number of the above. */
     347             :   ulong     consensus_root_bank_idx; /* bank index of the above. */
     348             :   ulong     published_root_slot;     /* slot number of the published root. */
     349             :   ulong     published_root_bank_idx; /* bank index of the published root. */
     350             : 
     351             :   /* Randomly generated block id for the initial genesis/snapshot slot.
     352             :      To be replaced with block id in the snapshot manifest when SIMD-333
     353             :      is activated. */
     354             : 
     355             :   fd_hash_t initial_block_id;
     356             : 
     357             :   /* We need to maintain a tile-local mapping of block-ids to bank index
     358             :      and vice versa.  This translation layer is needed for conversion
     359             :      since tower operates on block-ids and downstream consumers of FEC
     360             :      sets operate on bank indices.  This mapping must happen both ways:
     361             :      1. tower sends us block ids and we must map them to bank indices.
     362             :      2. when a block is completed, we must map the bank index to a block
     363             :         id to send a slot complete message to tower. */
     364             :   ulong               block_id_len;
     365             :   fd_block_id_ele_t * block_id_arr;
     366             :   ulong               block_id_map_seed;
     367             :   fd_block_id_map_t * block_id_map;
     368             : 
     369             :   /* Capture-related configs */
     370             :   fd_capture_ctx_t *     capture_ctx;
     371             :   FILE *                 capture_file;
     372             :   fd_capture_link_buf_t  cap_repl_out[1];
     373             : 
     374             :   /* Protobuf dumping context for debugging runtime execution and
     375             :      collecting seed corpora. */
     376             :   fd_dump_proto_ctx_t * dump_proto_ctx;
     377             : 
     378             :   /* Whether the runtime has been booted either from snapshot loading
     379             :      or from genesis. */
     380             :   int is_booted;
     381             : 
     382             :   /* Buffer to store vote towers that need to be published to the Tower
     383             :      tile. */
     384             : 
     385             :   fd_multi_epoch_leaders_t * mleaders;
     386             : 
     387             :   int larger_max_cost_per_block;
     388             : 
     389             :   /* When we transition to becoming leader, we can only unbecome the
     390             :      leader if we have received a block id from the FEC reassembler, and
     391             :      a message from PoH that the leader slot has ended.  After both of
     392             :      these conditions are met, then we are free to unbecome the leader.
     393             :   */
     394             :   uint        is_leader : 1;
     395             :   uint        supports_leader : 1;
     396             :   int         recv_poh;
     397             :   ulong       next_leader_slot;
     398             :   long        next_leader_tickcount;
     399             :   ulong       highwater_leader_slot;
     400             :   ulong       reset_slot;
     401             :   fd_bank_t   reset_bank[1];
     402             :   fd_hash_t   reset_block_id;
     403             :   long        reset_timestamp_nanos;
     404             :   double      slot_duration_nanos;
     405             :   double      slot_duration_ticks;
     406             :   fd_bank_t   leader_bank[1];
     407             : 
     408             :   fd_pubkey_t      identity_pubkey[1];
     409             :   ulong            identity_idx;
     410             : 
     411             :   fd_keyswitch_t * keyswitch;
     412             :   int              halt_leader;
     413             : 
     414             :   ulong  resolv_tile_cnt;
     415             : 
     416             :   int in_kind[ 128 ];
     417             :   fd_replay_in_link_t in[ 128 ];
     418             : 
     419             :   fd_replay_out_link_t exec_out[ 1 ];
     420             : 
     421             :   fd_replay_out_link_t replay_out[1];
     422             : 
     423             :   fd_replay_out_link_t epoch_out[1];
     424             : 
     425             :   /* The gui tile needs to reliably own a reference to the most recent
     426             :      completed active bank.  Replay needs to know if the gui as a
     427             :      consumer is enabled so it can increment the bank's refcnt before
     428             :      publishing the bank_idx to the gui. */
     429             :   int gui_enabled;
     430             :   int rpc_enabled;
     431             : 
     432             : # if FD_HAS_FLATCC
     433             :   /* For dumping blocks to protobuf. For backtest only. */
     434             :   fd_block_dump_ctx_t * block_dump_ctx;
     435             : # endif
     436             : 
     437             :   /* We need a few pieces of information to compute the right addresses
     438             :      for bundle crank information that we need to send to pack. */
     439             :   struct {
     440             :     int                   enabled;
     441             :     fd_pubkey_t           vote_account;
     442             :     fd_bundle_crank_gen_t gen[1];
     443             :   } bundle;
     444             : 
     445             :   struct {
     446             :     ulong      store_query_acquire;
     447             :     ulong      store_query_release;
     448             :     fd_histf_t store_query_wait[1];
     449             :     fd_histf_t store_query_work[1];
     450             :     ulong      store_query_cnt;
     451             :     ulong      store_query_missing_cnt;
     452             :     ulong      store_query_mr;
     453             :     ulong      store_query_missing_mr;
     454             : 
     455             :     ulong slots_total;
     456             :     ulong transactions_total;
     457             : 
     458             :     ulong reasm_latest_slot;
     459             :     ulong reasm_latest_fec_idx;
     460             : 
     461             :     ulong sched_full;
     462             :     ulong reasm_empty;
     463             :     ulong leader_bid_wait;
     464             :     ulong banks_full;
     465             :     ulong storage_root_behind;
     466             : 
     467             :     fd_histf_t root_slot_dur[1];
     468             :     fd_histf_t root_account_dur[1];
     469             :   } metrics;
     470             : 
     471             :   uchar __attribute__((aligned(FD_MULTI_EPOCH_LEADERS_ALIGN))) mleaders_mem[ FD_MULTI_EPOCH_LEADERS_FOOTPRINT ];
     472             : 
     473             :   ulong              runtime_stack_seed;
     474             :   fd_runtime_stack_t runtime_stack;
     475             : };
     476             : 
     477             : typedef struct fd_replay_tile fd_replay_tile_t;
     478             : 
     479             : FD_FN_CONST static inline ulong
     480           0 : scratch_align( void ) {
     481           0 :   return 128UL;
     482           0 : }
     483             : FD_FN_PURE static inline ulong
     484           0 : scratch_footprint( fd_topo_tile_t const * tile ) {
     485           0 :   ulong chain_cnt = fd_block_id_map_chain_cnt_est( tile->replay.max_live_slots );
     486             : 
     487           0 :   ulong l = FD_LAYOUT_INIT;
     488           0 :   l = FD_LAYOUT_APPEND( l, alignof(fd_replay_tile_t),    sizeof(fd_replay_tile_t) );
     489           0 :   l = FD_LAYOUT_APPEND( l, alignof(fd_block_id_ele_t),   sizeof(fd_block_id_ele_t) * tile->replay.max_live_slots );
     490           0 :   l = FD_LAYOUT_APPEND( l, fd_block_id_map_align(),      fd_block_id_map_footprint( chain_cnt ) );
     491           0 :   l = FD_LAYOUT_APPEND( l, fd_txncache_align(),          fd_txncache_footprint( tile->replay.max_live_slots ) );
     492           0 :   l = FD_LAYOUT_APPEND( l, fd_reasm_align(),             fd_reasm_footprint( tile->replay.fec_max ) );
     493           0 :   l = FD_LAYOUT_APPEND( l, fd_sched_align(),             fd_sched_footprint( tile->replay.sched_depth, tile->replay.max_live_slots ) );
     494           0 :   l = FD_LAYOUT_APPEND( l, fd_vinyl_req_pool_align(),    fd_vinyl_req_pool_footprint( 1UL, 1UL ) );
     495           0 :   l = FD_LAYOUT_APPEND( l, fd_vote_tracker_align(),      fd_vote_tracker_footprint() );
     496           0 :   l = FD_LAYOUT_APPEND( l, fd_capture_ctx_align(),       fd_capture_ctx_footprint() );
     497           0 :   l = FD_LAYOUT_APPEND( l, alignof(fd_dump_proto_ctx_t), sizeof(fd_dump_proto_ctx_t) );
     498             : 
     499           0 : # if FD_HAS_FLATCC
     500           0 :   if( FD_UNLIKELY( tile->replay.dump_block_to_pb ) ) {
     501           0 :     l = FD_LAYOUT_APPEND( l, fd_block_dump_context_align(), fd_block_dump_context_footprint() );
     502           0 :   }
     503           0 : # endif
     504             : 
     505           0 :   l = FD_LAYOUT_FINI( l, scratch_align() );
     506             : 
     507           0 :   return l;
     508           0 : }
     509             : 
     510             : static inline void
     511           0 : metrics_write( fd_replay_tile_t * ctx ) {
     512           0 :   FD_MCNT_SET  ( REPLAY, STORE_QUERY_ACQUIRE,      ctx->metrics.store_query_acquire      );
     513           0 :   FD_MCNT_SET  ( REPLAY, STORE_QUERY_RELEASE,      ctx->metrics.store_query_release      );
     514           0 :   FD_MHIST_COPY( REPLAY, STORE_QUERY_WAIT,         ctx->metrics.store_query_wait         );
     515           0 :   FD_MHIST_COPY( REPLAY, STORE_QUERY_WORK,         ctx->metrics.store_query_work         );
     516           0 :   FD_MCNT_SET  ( REPLAY, STORE_QUERY_CNT,          ctx->metrics.store_query_cnt          );
     517           0 :   FD_MCNT_SET  ( REPLAY, STORE_QUERY_MISSING_CNT,  ctx->metrics.store_query_missing_cnt  );
     518           0 :   FD_MGAUGE_SET( REPLAY, STORE_QUERY_MR,           ctx->metrics.store_query_mr           );
     519           0 :   FD_MGAUGE_SET( REPLAY, STORE_QUERY_MISSING_MR,   ctx->metrics.store_query_missing_mr   );
     520             : 
     521           0 :   FD_MGAUGE_SET( REPLAY, ROOT_SLOT, ctx->consensus_root_slot==ULONG_MAX ? 0UL : ctx->consensus_root_slot );
     522           0 :   ulong leader_slot = ctx->leader_bank->data ? fd_bank_slot_get( ctx->leader_bank ) : 0UL;
     523           0 :   FD_MGAUGE_SET( REPLAY, LEADER_SLOT, leader_slot );
     524             : 
     525           0 :   if( FD_LIKELY( ctx->leader_bank->data ) ) {
     526           0 :     FD_MGAUGE_SET( REPLAY, NEXT_LEADER_SLOT, leader_slot );
     527           0 :     FD_MGAUGE_SET( REPLAY, LEADER_SLOT, leader_slot );
     528           0 :   } else {
     529           0 :     FD_MGAUGE_SET( REPLAY, NEXT_LEADER_SLOT, ctx->next_leader_slot==ULONG_MAX ? 0UL : ctx->next_leader_slot );
     530           0 :     FD_MGAUGE_SET( REPLAY, LEADER_SLOT, 0UL );
     531           0 :   }
     532           0 :   FD_MGAUGE_SET( REPLAY, RESET_SLOT, ctx->reset_slot==ULONG_MAX ? 0UL : ctx->reset_slot );
     533             : 
     534           0 :   fd_bank_data_t * bank_pool = fd_banks_get_bank_pool( ctx->banks->data );
     535           0 :   ulong live_banks = fd_banks_pool_max( bank_pool ) - fd_banks_pool_free( bank_pool );
     536           0 :   FD_MGAUGE_SET( REPLAY, LIVE_BANKS, live_banks );
     537             : 
     538           0 :   ulong reasm_free = fd_reasm_free( ctx->reasm );
     539           0 :   FD_MGAUGE_SET( REPLAY, REASM_FREE, reasm_free );
     540             : 
     541           0 :   FD_MCNT_SET( REPLAY, SLOTS_TOTAL, ctx->metrics.slots_total );
     542           0 :   FD_MCNT_SET( REPLAY, TRANSACTIONS_TOTAL, ctx->metrics.transactions_total );
     543             : 
     544           0 :   FD_MGAUGE_SET( REPLAY, REASM_LATEST_SLOT,    ctx->metrics.reasm_latest_slot );
     545           0 :   FD_MGAUGE_SET( REPLAY, REASM_LATEST_FEC_IDX, ctx->metrics.reasm_latest_fec_idx );
     546             : 
     547           0 :   FD_MCNT_SET( REPLAY, SCHED_FULL,          ctx->metrics.sched_full );
     548           0 :   FD_MCNT_SET( REPLAY, REASM_EMPTY,         ctx->metrics.reasm_empty );
     549           0 :   FD_MCNT_SET( REPLAY, LEADER_BID_WAIT,     ctx->metrics.leader_bid_wait );
     550           0 :   FD_MCNT_SET( REPLAY, BANKS_FULL,          ctx->metrics.banks_full );
     551           0 :   FD_MCNT_SET( REPLAY, STORAGE_ROOT_BEHIND, ctx->metrics.storage_root_behind );
     552             : 
     553           0 :   FD_MCNT_SET( REPLAY, PROGCACHE_ROOTED,  ctx->progcache_admin->metrics.root_cnt );
     554           0 :   FD_MCNT_SET( REPLAY, PROGCACHE_GC_ROOT, ctx->progcache_admin->metrics.gc_root_cnt );
     555             : 
     556           0 :   FD_MCNT_SET( REPLAY, ACCDB_CREATED,      ctx->accdb->base.created_cnt       );
     557           0 :   FD_MCNT_SET( REPLAY, ACCDB_REVERTED,     ctx->accdb_admin->base.revert_cnt  );
     558           0 :   FD_MCNT_SET( REPLAY, ACCDB_ROOTED,       ctx->accdb_admin->base.root_cnt    );
     559           0 :   FD_MCNT_SET( REPLAY, ACCDB_ROOTED_BYTES, ctx->accdb_admin->base.root_tot_sz );
     560           0 :   FD_MCNT_SET( REPLAY, ACCDB_GC_ROOT,      ctx->accdb_admin->base.gc_root_cnt );
     561           0 :   FD_MCNT_SET( REPLAY, ACCDB_RECLAIMED,    ctx->accdb_admin->base.reclaim_cnt );
     562           0 :   FD_MHIST_COPY( REPLAY, ROOT_SLOT_DURATION_SECONDS,    ctx->metrics.root_slot_dur    );
     563           0 :   FD_MHIST_COPY( REPLAY, ROOT_ACCOUNT_DURATION_SECONDS, ctx->metrics.root_account_dur );
     564           0 :   FD_MCNT_SET( REPLAY, ROOT_ELAPSED_SECONDS_DB,   (ulong)ctx->accdb_admin->base.dt_vinyl );
     565           0 :   FD_MCNT_SET( REPLAY, ROOT_ELAPSED_SECONDS_COPY, (ulong)ctx->accdb_admin->base.dt_copy  );
     566           0 :   FD_MCNT_SET( REPLAY, ROOT_ELAPSED_SECONDS_GC,   (ulong)ctx->accdb_admin->base.dt_gc    );
     567           0 : }
     568             : 
     569             : static inline ulong
     570             : generate_epoch_info_msg( ulong                       epoch,
     571             :                          fd_epoch_schedule_t const * epoch_schedule,
     572             :                          fd_vote_stakes_t *          vote_stakes,
     573             :                          ushort                      vote_stakes_fork_idx,
     574             :                          fd_features_t const *       features,
     575             :                          fd_epoch_info_msg_t *       epoch_info_msg,
     576           0 :                          int                         current_epoch ) {
     577           0 :   fd_vote_stake_weight_t * stake_weights = epoch_info_msg->weights;
     578             : 
     579           0 :   epoch_info_msg->epoch             = epoch;
     580           0 :   epoch_info_msg->start_slot        = fd_epoch_slot0( epoch_schedule, epoch );
     581           0 :   epoch_info_msg->slot_cnt          = fd_epoch_slot_cnt( epoch_schedule, epoch );
     582           0 :   epoch_info_msg->excluded_stake    = 0UL;
     583           0 :   epoch_info_msg->vote_keyed_lsched = 1UL;
     584             : 
     585             :   /* FIXME: SIMD-0180 - hack to (de)activate in testnet vs mainnet.
     586             :      This code can be removed once the feature is active. */
     587           0 :   if( (1==epoch_schedule->warmup && epoch<FD_SIMD0180_ACTIVE_EPOCH_TESTNET) ||
     588           0 :       (0==epoch_schedule->warmup && epoch<FD_SIMD0180_ACTIVE_EPOCH_MAINNET) ) {
     589           0 :     epoch_info_msg->vote_keyed_lsched = 0UL;
     590           0 :   }
     591             : 
     592             :   /* epoch_stakes from manifest are already filtered (stake>0), but not sorted */
     593           0 :   ulong idx = 0UL;
     594           0 :   uchar __attribute__((aligned(FD_VOTE_STAKES_ITER_ALIGN))) iter_mem[ FD_VOTE_STAKES_ITER_FOOTPRINT ];
     595           0 :   for( fd_vote_stakes_iter_t * iter = fd_vote_stakes_fork_iter_init( vote_stakes, vote_stakes_fork_idx, iter_mem );
     596           0 :        !fd_vote_stakes_fork_iter_done( vote_stakes, vote_stakes_fork_idx, iter );
     597           0 :        fd_vote_stakes_fork_iter_next( vote_stakes, vote_stakes_fork_idx, iter ) ) {
     598             : 
     599           0 :     fd_pubkey_t pubkey;
     600           0 :     ulong       stake_t_1;
     601           0 :     ulong       stake_t_2;
     602           0 :     fd_pubkey_t node_account_t_1;
     603           0 :     fd_pubkey_t node_account_t_2;
     604           0 :     fd_vote_stakes_fork_iter_ele( vote_stakes, vote_stakes_fork_idx, iter, &pubkey, &stake_t_1, &stake_t_2, &node_account_t_1, &node_account_t_2 );
     605             : 
     606           0 :     ulong       stake        = current_epoch ? stake_t_1 : stake_t_2;
     607           0 :     fd_pubkey_t node_account = current_epoch ? node_account_t_1 : node_account_t_2;
     608           0 :     if( FD_UNLIKELY( !stake ) ) continue;
     609             : 
     610           0 :     stake_weights[ idx ].stake = stake;
     611           0 :     memcpy( stake_weights[ idx ].id_key.uc, &node_account, sizeof(fd_pubkey_t) );
     612           0 :     memcpy( stake_weights[ idx ].vote_key.uc, &pubkey, sizeof(fd_pubkey_t) );
     613           0 :     idx++;
     614           0 :   }
     615           0 :   epoch_info_msg->staked_cnt = idx;
     616           0 :   sort_vote_weights_by_stake_vote_inplace( stake_weights, idx );
     617             : 
     618           0 :   epoch_info_msg->epoch_schedule = *epoch_schedule;
     619           0 :   epoch_info_msg->features       = *features;
     620             : 
     621           0 :   return fd_epoch_info_msg_sz( epoch_info_msg->staked_cnt );
     622           0 : }
     623             : 
     624             : static void
     625             : publish_epoch_info( fd_replay_tile_t *   ctx,
     626             :                     fd_stem_context_t *  stem,
     627             :                     fd_bank_t *          bank,
     628           0 :                     int                  current_epoch ) {
     629           0 :   fd_epoch_schedule_t const * schedule = fd_bank_epoch_schedule_query( bank );
     630           0 :   ulong epoch = fd_slot_to_epoch( schedule, fd_bank_slot_get( bank ), NULL );
     631             : 
     632           0 :   fd_features_t const * features = fd_bank_features_query( bank );
     633             : 
     634           0 :   fd_epoch_info_msg_t * epoch_info_msg = fd_chunk_to_laddr( ctx->epoch_out->mem, ctx->epoch_out->chunk );
     635             : 
     636           0 :   fd_vote_stakes_t * vote_stakes = fd_bank_vote_stakes_locking_modify( bank );
     637           0 :   ulong epoch_info_sz = generate_epoch_info_msg( epoch+fd_ulong_if( current_epoch, 1UL, 0UL), schedule, vote_stakes, bank->data->vote_stakes_fork_id, features, epoch_info_msg, current_epoch );
     638           0 :   fd_bank_vote_stakes_end_locking_modify( bank );
     639             : 
     640           0 :   ulong epoch_info_sig = 4UL;
     641           0 :   fd_stem_publish( stem, ctx->epoch_out->idx, epoch_info_sig, ctx->epoch_out->chunk, epoch_info_sz, 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
     642           0 :   ctx->epoch_out->chunk = fd_dcache_compact_next( ctx->epoch_out->chunk, epoch_info_sz, ctx->epoch_out->chunk0, ctx->epoch_out->wmark );
     643             : 
     644           0 :   fd_multi_epoch_leaders_epoch_msg_init( ctx->mleaders, epoch_info_msg );
     645           0 :   fd_multi_epoch_leaders_epoch_msg_fini( ctx->mleaders );
     646             : 
     647           0 : }
     648             : 
     649             : /**********************************************************************/
     650             : /* Transaction execution state machine helpers                        */
     651             : /**********************************************************************/
     652             : 
     653             : static void
     654             : replay_block_start( fd_replay_tile_t *  ctx,
     655             :                     fd_stem_context_t * stem,
     656             :                     ulong               bank_idx,
     657             :                     ulong               parent_bank_idx,
     658           0 :                     ulong               slot ) {
     659           0 :   long before = fd_log_wallclock();
     660             : 
     661           0 :   fd_bank_t bank[1];
     662           0 :   if( FD_UNLIKELY( !fd_banks_bank_query( bank, ctx->banks, bank_idx ) ) ) {
     663           0 :     FD_LOG_CRIT(( "invariant violation: bank is NULL for bank index %lu", bank_idx ));
     664           0 :   }
     665           0 :   if( FD_UNLIKELY( bank->data->flags!=FD_BANK_FLAGS_INIT ) ) {
     666           0 :     FD_LOG_CRIT(( "invariant violation: bank is not in correct state for bank index %lu", bank_idx ));
     667           0 :   }
     668             : 
     669           0 :   bank->data->preparation_begin_nanos = before;
     670             : 
     671           0 :   fd_bank_t parent_bank[1];
     672           0 :   if( FD_UNLIKELY( !fd_banks_bank_query( parent_bank, ctx->banks, parent_bank_idx ) ) ) {
     673           0 :     FD_LOG_CRIT(( "invariant violation: parent bank is NULL for bank index %lu", parent_bank_idx ));
     674           0 :   }
     675           0 :   ulong parent_slot = fd_bank_slot_get( parent_bank );
     676             : 
     677             :   /* Clone the bank from the parent.  We must special case the first
     678             :      slot that is executed as the snapshot does not provide a parent
     679             :      block id. */
     680             : 
     681           0 :   if( FD_UNLIKELY( !fd_banks_clone_from_parent( bank, ctx->banks, bank_idx ) ) ) {
     682           0 :     FD_LOG_CRIT(( "invariant violation: bank is NULL for bank index %lu", bank_idx ));
     683           0 :   }
     684           0 :   fd_bank_slot_set( bank, slot );
     685           0 :   fd_bank_parent_slot_set( bank, parent_slot );
     686           0 :   bank->data->txncache_fork_id = fd_txncache_attach_child( ctx->txncache, parent_bank->data->txncache_fork_id );
     687             : 
     688             :   /* Create a new funk txn for the block. */
     689             : 
     690           0 :   fd_funk_txn_xid_t xid        = { .ul = { slot, bank_idx } };
     691           0 :   fd_funk_txn_xid_t parent_xid = { .ul = { parent_slot, parent_bank_idx } };
     692           0 :   fd_accdb_attach_child( ctx->accdb_admin, &parent_xid, &xid );
     693           0 :   fd_progcache_txn_attach_child( ctx->progcache_admin, &parent_xid, &xid );
     694             : 
     695             :   /* Update required runtime state and handle potential boundary. */
     696             : 
     697           0 :   fd_bank_shred_cnt_set( bank, 0UL );
     698           0 :   fd_bank_execution_fees_set( bank, 0UL );
     699           0 :   fd_bank_priority_fees_set( bank, 0UL );
     700           0 :   fd_bank_tips_set( bank, 0UL );
     701           0 :   fd_bank_identity_vote_idx_set( bank, ULONG_MAX );
     702             : 
     703           0 :   fd_bank_block_height_set( bank, fd_bank_block_height_get( bank ) + 1UL );
     704             : 
     705           0 :   int is_epoch_boundary = 0;
     706           0 :   fd_runtime_block_execute_prepare( ctx->banks, bank, ctx->accdb, &ctx->runtime_stack, ctx->capture_ctx, &is_epoch_boundary );
     707           0 :   if( FD_UNLIKELY( is_epoch_boundary ) ) publish_epoch_info( ctx, stem, bank, 1 );
     708             : 
     709           0 :   ulong max_tick_height;
     710           0 :   if( FD_UNLIKELY( FD_RUNTIME_EXECUTE_SUCCESS!=fd_runtime_compute_max_tick_height( fd_bank_ticks_per_slot_get( parent_bank ), slot, &max_tick_height ) ) ) {
     711           0 :     FD_LOG_CRIT(( "couldn't compute tick height/max tick height slot %lu ticks_per_slot %lu", slot, fd_bank_ticks_per_slot_get( parent_bank ) ));
     712           0 :   }
     713           0 :   fd_bank_max_tick_height_set( bank, max_tick_height );
     714           0 :   fd_bank_tick_height_set( bank, fd_bank_max_tick_height_get( parent_bank ) ); /* The parent's max tick height is our starting tick height. */
     715           0 :   fd_sched_set_poh_params( ctx->sched, bank->data->idx, fd_bank_tick_height_get( bank ), fd_bank_max_tick_height_get( bank ), fd_bank_hashes_per_tick_get( bank ), fd_bank_poh_query( parent_bank ) );
     716             : 
     717           0 :   FD_LOG_DEBUG(( "replay_block_start: bank_idx=%lu slot=%lu parent_bank_idx=%lu", bank_idx, slot, parent_bank_idx ));
     718           0 : }
     719             : 
     720             : static void
     721           0 : cost_tracker_snap( fd_bank_t * bank, fd_replay_slot_completed_t * slot_info ) {
     722           0 :   if( bank->data->cost_tracker_pool_idx!=fd_bank_cost_tracker_pool_idx_null( fd_bank_get_cost_tracker_pool( bank->data ) ) ) {
     723           0 :     fd_cost_tracker_t const * cost_tracker = fd_bank_cost_tracker_locking_query( bank );
     724           0 :     slot_info->cost_tracker.block_cost                   = cost_tracker->block_cost;
     725           0 :     slot_info->cost_tracker.vote_cost                    = cost_tracker->vote_cost;
     726           0 :     slot_info->cost_tracker.allocated_accounts_data_size = cost_tracker->allocated_accounts_data_size;
     727           0 :     slot_info->cost_tracker.block_cost_limit             = cost_tracker->block_cost_limit;
     728           0 :     slot_info->cost_tracker.vote_cost_limit              = cost_tracker->vote_cost_limit;
     729           0 :     slot_info->cost_tracker.account_cost_limit           = cost_tracker->account_cost_limit;
     730           0 :     fd_bank_cost_tracker_end_locking_query( bank );
     731           0 :   } else {
     732           0 :     memset( &slot_info->cost_tracker, 0, sizeof(slot_info->cost_tracker) );
     733           0 :   }
     734           0 : }
     735             : 
     736             : static ulong
     737           0 : get_identity_balance( fd_replay_tile_t * ctx, fd_funk_txn_xid_t xid ) {
     738           0 :   ulong identity_balance = ULONG_MAX;
     739           0 :   fd_accdb_ro_t identity_acc[1];
     740           0 :   if( FD_LIKELY( fd_accdb_open_ro( ctx->accdb, identity_acc, &xid, ctx->identity_pubkey ) ) ) {
     741           0 :     identity_balance = identity_acc->meta->lamports;
     742           0 :     fd_accdb_close_ro( ctx->accdb, identity_acc );
     743           0 :   }
     744           0 :   return identity_balance;
     745           0 : }
     746             : 
     747             : static void
     748             : publish_slot_completed( fd_replay_tile_t *  ctx,
     749             :                         fd_stem_context_t * stem,
     750             :                         fd_bank_t *         bank,
     751             :                         int                 is_initial,
     752           0 :                         int                 is_leader ) {
     753             : 
     754           0 :   ulong slot = fd_bank_slot_get( bank );
     755             : 
     756           0 :   fd_block_id_ele_t * block_id_ele = &ctx->block_id_arr[ bank->data->idx ];
     757             : 
     758             :   /* HACKY: hacky way of checking if we should send a null parent block
     759             :      id */
     760           0 :   fd_hash_t parent_block_id = {0};
     761           0 :   if( FD_UNLIKELY( !is_initial ) ) {
     762           0 :     parent_block_id = ctx->block_id_arr[ bank->data->parent_idx ].latest_mr;
     763           0 :   }
     764             : 
     765           0 :   fd_hash_t const * bank_hash  = fd_bank_bank_hash_query( bank );
     766           0 :   fd_hash_t const * block_hash = fd_blockhashes_peek_last_hash( fd_bank_block_hash_queue_query( bank ) );
     767           0 :   FD_TEST( bank_hash  );
     768           0 :   FD_TEST( block_hash );
     769             : 
     770           0 :   if( FD_LIKELY( !is_initial ) ) fd_txncache_finalize_fork( ctx->txncache, bank->data->txncache_fork_id, 0UL, block_hash->uc );
     771             : 
     772           0 :   fd_epoch_schedule_t const * epoch_schedule = fd_bank_epoch_schedule_query( bank );
     773           0 :   ulong slot_idx;
     774           0 :   ulong epoch = fd_slot_to_epoch( epoch_schedule, slot, &slot_idx );
     775             : 
     776           0 :   ctx->metrics.slots_total++;
     777           0 :   ctx->metrics.transactions_total = fd_bank_txn_count_get( bank );
     778             : 
     779           0 :   fd_replay_slot_completed_t * slot_info = fd_chunk_to_laddr( ctx->replay_out->mem, ctx->replay_out->chunk );
     780           0 :   slot_info->slot                  = slot;
     781           0 :   slot_info->root_slot             = ctx->consensus_root_slot;
     782           0 :   slot_info->storage_slot          = ctx->published_root_slot;
     783           0 :   slot_info->epoch                 = epoch;
     784           0 :   slot_info->slot_in_epoch         = slot_idx;
     785           0 :   slot_info->slots_per_epoch       = fd_epoch_slot_cnt( epoch_schedule, epoch );
     786           0 :   slot_info->block_height          = fd_bank_block_height_get( bank );
     787           0 :   slot_info->parent_slot           = fd_bank_parent_slot_get( bank );
     788           0 :   slot_info->block_id              = block_id_ele->latest_mr;
     789           0 :   slot_info->parent_block_id       = parent_block_id;
     790           0 :   slot_info->bank_hash             = *bank_hash;
     791           0 :   slot_info->block_hash            = *block_hash;
     792           0 :   slot_info->transaction_count     = fd_bank_txn_count_get( bank );
     793             : 
     794           0 :   fd_inflation_t inflation = fd_bank_inflation_get( bank );
     795           0 :   slot_info->inflation.foundation      = inflation.foundation;
     796           0 :   slot_info->inflation.foundation_term = inflation.foundation_term;
     797           0 :   slot_info->inflation.terminal        = inflation.terminal;
     798           0 :   slot_info->inflation.initial         = inflation.initial;
     799           0 :   slot_info->inflation.taper           = inflation.taper;
     800             : 
     801           0 :   fd_rent_t rent = fd_bank_rent_get( bank );
     802           0 :   slot_info->rent.burn_percent            = rent.burn_percent;
     803           0 :   slot_info->rent.lamports_per_uint8_year = rent.lamports_per_uint8_year;
     804           0 :   slot_info->rent.exemption_threshold     = rent.exemption_threshold;
     805             : 
     806           0 :   slot_info->first_fec_set_received_nanos      = bank->data->first_fec_set_received_nanos;
     807           0 :   slot_info->preparation_begin_nanos           = bank->data->preparation_begin_nanos;
     808           0 :   slot_info->first_transaction_scheduled_nanos = bank->data->first_transaction_scheduled_nanos;
     809           0 :   slot_info->last_transaction_finished_nanos   = bank->data->last_transaction_finished_nanos;
     810           0 :   slot_info->completion_time_nanos             = fd_log_wallclock();
     811             : 
     812             :   /* refcnt should be incremented by 1 for each consumer that uses
     813             :      `bank_idx`.  Each consumer should decrement the bank's refcnt once
     814             :      they are done using the bank. */
     815           0 :   bank->data->refcnt++; /* tower_tile */
     816           0 :   if( FD_LIKELY( ctx->rpc_enabled ) ) bank->data->refcnt++; /* rpc tile */
     817           0 :   if( FD_LIKELY( ctx->gui_enabled ) ) bank->data->refcnt++; /* gui tile */
     818           0 :   slot_info->bank_idx = bank->data->idx;
     819           0 :   FD_LOG_DEBUG(( "bank (idx=%lu, slot=%lu) refcnt incremented to %lu for tower, rpc, gui", bank->data->idx, slot, bank->data->refcnt ));
     820             : 
     821           0 :   slot_info->parent_bank_idx = ULONG_MAX;
     822           0 :   fd_bank_t parent_bank[1];
     823           0 :   if( FD_LIKELY( fd_banks_get_parent( parent_bank, ctx->banks, bank ) && ctx->gui_enabled ) ) {
     824           0 :     parent_bank->data->refcnt++;
     825           0 :     FD_LOG_DEBUG(( "bank (idx=%lu, slot=%lu) refcnt incremented to %lu for gui", parent_bank->data->idx, fd_bank_slot_get( parent_bank ), parent_bank->data->refcnt ));
     826           0 :     slot_info->parent_bank_idx = parent_bank->data->idx;
     827           0 :   }
     828             : 
     829           0 :   slot_info->is_leader = is_leader;
     830             : 
     831           0 :   FD_BASE58_ENCODE_32_BYTES( ctx->block_id_arr[ bank->data->idx ].latest_mr.uc, block_id_cstr );
     832           0 :   FD_BASE58_ENCODE_32_BYTES( fd_bank_bank_hash_query( bank )->uc, bank_hash_cstr );
     833           0 :   FD_LOG_DEBUG(( "publish_slot_completed: bank_idx=%lu slot=%lu bank_hash=%s block_id=%s", bank->data->idx, slot, bank_hash_cstr, block_id_cstr ));
     834             : 
     835           0 :   fd_stem_publish( stem, ctx->replay_out->idx, REPLAY_SIG_SLOT_COMPLETED, ctx->replay_out->chunk, sizeof(fd_replay_slot_completed_t), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
     836           0 :   ctx->replay_out->chunk = fd_dcache_compact_next( ctx->replay_out->chunk, sizeof(fd_replay_slot_completed_t), ctx->replay_out->chunk0, ctx->replay_out->wmark );
     837           0 : }
     838             : 
     839             : static void
     840             : publish_slot_dead( fd_replay_tile_t *  ctx,
     841             :                    fd_stem_context_t * stem,
     842             :                    ulong               slot,
     843           0 :                    fd_hash_t const *   block_id ) {
     844           0 :   fd_replay_slot_dead_t * slot_dead = fd_chunk_to_laddr( ctx->replay_out->mem, ctx->replay_out->chunk );
     845           0 :   slot_dead->slot                   = slot;
     846           0 :   slot_dead->block_id               = *block_id;
     847           0 :   fd_stem_publish( stem, ctx->replay_out->idx, REPLAY_SIG_SLOT_DEAD, ctx->replay_out->chunk, sizeof(fd_replay_slot_dead_t), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
     848           0 :   ctx->replay_out->chunk = fd_dcache_compact_next( ctx->replay_out->chunk, sizeof(fd_replay_slot_dead_t), ctx->replay_out->chunk0, ctx->replay_out->wmark );
     849           0 : }
     850             : 
     851             : static void
     852             : publish_txn_executed( fd_replay_tile_t *  ctx,
     853             :                       fd_stem_context_t * stem,
     854           0 :                       ulong               txn_idx ) {
     855           0 :   fd_sched_txn_info_t * txn_info = fd_sched_get_txn_info( ctx->sched, txn_idx );
     856           0 :   fd_replay_txn_executed_t * txn_executed = fd_type_pun( fd_chunk_to_laddr( ctx->replay_out->mem, ctx->replay_out->chunk ) );
     857           0 :   *txn_executed->txn = *fd_sched_get_txn( ctx->sched, txn_idx );
     858           0 :   txn_executed->txn_err = txn_info->txn_err;
     859           0 :   txn_executed->is_committable = !!(txn_info->flags&FD_SCHED_TXN_IS_COMMITTABLE);
     860           0 :   txn_executed->is_fees_only = !!(txn_info->flags&FD_SCHED_TXN_IS_FEES_ONLY);
     861           0 :   txn_executed->tick_parsed = txn_info->tick_parsed;
     862           0 :   txn_executed->tick_sigverify_disp = txn_info->tick_sigverify_disp;
     863           0 :   txn_executed->tick_sigverify_done = txn_info->tick_sigverify_done;
     864           0 :   txn_executed->tick_exec_disp = txn_info->tick_exec_disp;
     865           0 :   txn_executed->tick_exec_done = txn_info->tick_exec_done;
     866           0 :   fd_stem_publish( stem, ctx->replay_out->idx, REPLAY_SIG_TXN_EXECUTED, ctx->replay_out->chunk, sizeof(*txn_executed), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
     867           0 :   ctx->replay_out->chunk = fd_dcache_compact_next( ctx->replay_out->chunk, sizeof(*txn_executed), ctx->replay_out->chunk0, ctx->replay_out->wmark );
     868           0 : }
     869             : 
     870             : static void
     871             : replay_block_finalize( fd_replay_tile_t *  ctx,
     872             :                        fd_stem_context_t * stem,
     873           0 :                        fd_bank_t *         bank ) {
     874           0 :   bank->data->last_transaction_finished_nanos = fd_log_wallclock();
     875             : 
     876           0 :   FD_TEST( !(bank->data->flags&FD_BANK_FLAGS_FROZEN) );
     877             : 
     878             :   /* Set poh hash in bank. */
     879           0 :   fd_hash_t * poh = fd_sched_get_poh( ctx->sched, bank->data->idx );
     880           0 :   fd_bank_poh_set( bank, *poh );
     881             : 
     882             :   /* Set shred count in bank. */
     883           0 :   fd_bank_shred_cnt_set( bank, fd_sched_get_shred_cnt( ctx->sched, bank->data->idx ) );
     884             : 
     885             :   /* Do hashing and other end-of-block processing. */
     886           0 :   fd_runtime_block_execute_finalize( bank, ctx->accdb, ctx->capture_ctx );
     887             : 
     888             :   /* Copy out cost tracker fields before freezing */
     889           0 :   fd_replay_slot_completed_t * slot_info = fd_chunk_to_laddr( ctx->replay_out->mem, ctx->replay_out->chunk );
     890           0 :   cost_tracker_snap( bank, slot_info );
     891             : 
     892             :   /* fetch identity / vote balance updates infrequently */
     893           0 :   ulong slot = fd_bank_slot_get( bank );
     894           0 :   fd_funk_txn_xid_t xid = { .ul = { slot, bank->data->idx } };
     895           0 :   slot_info->identity_balance = FD_UNLIKELY( slot%4096==0UL ) ? get_identity_balance( ctx, xid ) : ULONG_MAX;
     896             : 
     897             :   /* Mark the bank as frozen. */
     898           0 :   fd_banks_mark_bank_frozen( ctx->banks, bank );
     899             : 
     900             :   /**********************************************************************/
     901             :   /* Bank hash comparison, and halt if there's a mismatch after replay  */
     902             :   /**********************************************************************/
     903             : 
     904           0 :   fd_hash_t const * bank_hash = fd_bank_bank_hash_query( bank );
     905           0 :   FD_TEST( bank_hash );
     906             : 
     907             :   /* Must be last so we can measure completion time correctly, even
     908             :      though we could technically do this before the hash cmp and vote
     909             :      tower stuff. */
     910           0 :   publish_slot_completed( ctx, stem, bank, 0, 0 /* is_leader */ );
     911             : 
     912           0 : # if FD_HAS_FLATCC
     913             :   /* If enabled, dump the block to a file and reset the dumping
     914             :      context state */
     915           0 :   if( FD_UNLIKELY( ctx->dump_proto_ctx && ctx->dump_proto_ctx->dump_block_to_pb ) ) {
     916           0 :     fd_dump_block_to_protobuf( ctx->block_dump_ctx, ctx->banks, bank, ctx->accdb, ctx->dump_proto_ctx );
     917           0 :     fd_block_dump_context_reset( ctx->block_dump_ctx );
     918           0 :   }
     919           0 : # endif
     920           0 : }
     921             : 
     922             : /**********************************************************************/
     923             : /* Leader bank management                                             */
     924             : /**********************************************************************/
     925             : 
     926             : static fd_bank_t *
     927             : prepare_leader_bank( fd_replay_tile_t *  ctx,
     928             :                      ulong               slot,
     929             :                      long                now,
     930             :                      fd_hash_t const *   parent_block_id,
     931           0 :                      fd_stem_context_t * stem ) {
     932           0 :   long before = fd_log_wallclock();
     933             : 
     934             :   /* Make sure that we are not already leader. */
     935           0 :   FD_TEST( ctx->leader_bank->data==NULL );
     936             : 
     937           0 :   fd_block_id_ele_t * parent_ele = fd_block_id_map_ele_query( ctx->block_id_map, parent_block_id, NULL, ctx->block_id_arr );
     938           0 :   if( FD_UNLIKELY( !parent_ele ) ) {
     939           0 :     FD_BASE58_ENCODE_32_BYTES( parent_block_id->key, parent_block_id_b58 );
     940           0 :     FD_LOG_CRIT(( "invariant violation: parent bank index not found for merkle root %s", parent_block_id_b58 ));
     941           0 :   }
     942           0 :   ulong parent_bank_idx = fd_block_id_ele_get_idx( ctx->block_id_arr, parent_ele );
     943             : 
     944           0 :   fd_bank_t parent_bank[1];
     945           0 :   if( FD_UNLIKELY( !fd_banks_bank_query( parent_bank, ctx->banks, parent_bank_idx ) ) ) {
     946           0 :     FD_LOG_CRIT(( "invariant violation: parent bank not found for bank index %lu", parent_bank_idx ));
     947           0 :   }
     948           0 :   ulong parent_slot = fd_bank_slot_get( parent_bank );
     949             : 
     950           0 :   if( FD_UNLIKELY( !fd_banks_new_bank( ctx->leader_bank, ctx->banks, parent_bank_idx, now ) ) ) {
     951           0 :     FD_LOG_CRIT(( "invariant violation: leader bank is NULL for slot %lu", slot ));
     952           0 :   }
     953             : 
     954           0 :   if( FD_UNLIKELY( !fd_banks_clone_from_parent( ctx->leader_bank, ctx->banks, ctx->leader_bank->data->idx ) ) ) {
     955           0 :     FD_LOG_CRIT(( "invariant violation: bank is NULL for slot %lu", slot ));
     956           0 :   }
     957             : 
     958           0 :   ctx->leader_bank->data->preparation_begin_nanos = before;
     959             : 
     960           0 :   fd_bank_slot_set( ctx->leader_bank, slot );
     961           0 :   fd_bank_parent_slot_set( ctx->leader_bank, parent_slot );
     962           0 :   ctx->leader_bank->data->txncache_fork_id = fd_txncache_attach_child( ctx->txncache, parent_bank->data->txncache_fork_id );
     963             :   /* prepare the funk transaction for the leader bank */
     964           0 :   fd_funk_txn_xid_t xid        = { .ul = { slot, ctx->leader_bank->data->idx } };
     965           0 :   fd_funk_txn_xid_t parent_xid = { .ul = { parent_slot, parent_bank_idx } };
     966           0 :   fd_accdb_attach_child( ctx->accdb_admin, &parent_xid, &xid );
     967           0 :   fd_progcache_txn_attach_child( ctx->progcache_admin, &parent_xid, &xid );
     968             : 
     969           0 :   fd_bank_execution_fees_set( ctx->leader_bank, 0UL );
     970           0 :   fd_bank_priority_fees_set( ctx->leader_bank, 0UL );
     971           0 :   fd_bank_shred_cnt_set( ctx->leader_bank, 0UL );
     972           0 :   fd_bank_tips_set( ctx->leader_bank, 0UL );
     973           0 :   fd_bank_identity_vote_idx_set( ctx->leader_bank, ULONG_MAX );
     974             : 
     975             :   /* Update block height. */
     976           0 :   fd_bank_block_height_set( ctx->leader_bank, fd_bank_block_height_get( ctx->leader_bank ) + 1UL );
     977             : 
     978           0 :   int is_epoch_boundary = 0;
     979           0 :   fd_runtime_block_execute_prepare( ctx->banks, ctx->leader_bank, ctx->accdb, &ctx->runtime_stack, ctx->capture_ctx, &is_epoch_boundary );
     980           0 :   if( FD_UNLIKELY( is_epoch_boundary ) ) publish_epoch_info( ctx, stem, ctx->leader_bank, 1 );
     981             : 
     982           0 :   ulong max_tick_height;
     983           0 :   if( FD_UNLIKELY( FD_RUNTIME_EXECUTE_SUCCESS!=fd_runtime_compute_max_tick_height( fd_bank_ticks_per_slot_get( parent_bank ), slot, &max_tick_height ) ) ) {
     984           0 :     FD_LOG_CRIT(( "couldn't compute tick height/max tick height slot %lu ticks_per_slot %lu", slot, fd_bank_ticks_per_slot_get( parent_bank ) ));
     985           0 :   }
     986           0 :   fd_bank_max_tick_height_set( ctx->leader_bank, max_tick_height );
     987           0 :   fd_bank_tick_height_set( ctx->leader_bank, fd_bank_max_tick_height_get( parent_bank ) ); /* The parent's max tick height is our starting tick height. */
     988             : 
     989             :   /* Now that a bank has been created for the leader slot, increment the
     990             :      reference count until we are done with the leader slot. */
     991           0 :   ctx->leader_bank->data->refcnt++;
     992             : 
     993           0 :   return ctx->leader_bank;
     994           0 : }
     995             : 
     996             : static inline void
     997           0 : maybe_switch_identity( fd_replay_tile_t * ctx ) {
     998             : 
     999           0 :   if( FD_LIKELY( fd_keyswitch_state_query( ctx->keyswitch )!=FD_KEYSWITCH_STATE_SWITCH_PENDING ) ) return;
    1000             : 
    1001             :   /* Switch identity */
    1002             : 
    1003           0 :   FD_LOG_DEBUG(( "keyswitch: switching identity" ));
    1004             : 
    1005           0 :   memcpy( ctx->identity_pubkey, ctx->keyswitch->bytes, 32UL );
    1006           0 :   fd_keyswitch_state( ctx->keyswitch, FD_KEYSWITCH_STATE_COMPLETED );
    1007             : 
    1008             :   /* The next leader slot will be incorrect now that the identity has
    1009             :      switched.  The next leader slot normally gets updated based on the
    1010             :      reset slot returned by tower. */
    1011           0 :   ulong min_leader_slot = fd_ulong_max( ctx->reset_slot+1UL, fd_ulong_if( ctx->highwater_leader_slot==ULONG_MAX, 0UL, ctx->highwater_leader_slot+1UL ) );
    1012           0 :   ctx->next_leader_slot = fd_multi_epoch_leaders_get_next_slot( ctx->mleaders, min_leader_slot, ctx->identity_pubkey );
    1013           0 :   if( FD_LIKELY( ctx->next_leader_slot != ULONG_MAX ) ) {
    1014           0 :     ctx->next_leader_tickcount = (long)((double)(ctx->next_leader_slot-ctx->reset_slot-1UL)*ctx->slot_duration_ticks) + fd_tickcount();
    1015           0 :   } else {
    1016           0 :     ctx->next_leader_tickcount = LONG_MAX;
    1017           0 :   }
    1018             : 
    1019           0 :   ctx->identity_vote_rooted = 0;
    1020           0 :   ctx->identity_idx++;
    1021           0 :   fd_vote_tracker_reset( ctx->vote_tracker );
    1022           0 : }
    1023             : 
    1024             : static void
    1025             : fini_leader_bank( fd_replay_tile_t *  ctx,
    1026           0 :                   fd_stem_context_t * stem ) {
    1027             : 
    1028           0 :   FD_TEST( ctx->leader_bank->data!=NULL );
    1029           0 :   FD_TEST( ctx->is_leader );
    1030           0 :   FD_TEST( ctx->block_id_arr[ ctx->leader_bank->data->idx ].block_id_seen );
    1031           0 :   FD_TEST( ctx->recv_poh );
    1032             : 
    1033           0 :   ctx->leader_bank->data->last_transaction_finished_nanos = fd_log_wallclock();
    1034             : 
    1035           0 :   ulong curr_slot = fd_bank_slot_get( ctx->leader_bank );
    1036             : 
    1037           0 :   fd_sched_block_add_done( ctx->sched, ctx->leader_bank->data->idx, ctx->leader_bank->data->parent_idx, curr_slot );
    1038             : 
    1039           0 :   fd_runtime_block_execute_finalize( ctx->leader_bank, ctx->accdb, ctx->capture_ctx );
    1040             : 
    1041           0 :   fd_replay_slot_completed_t * slot_info = fd_chunk_to_laddr( ctx->replay_out->mem, ctx->replay_out->chunk );
    1042           0 :   cost_tracker_snap( ctx->leader_bank, slot_info );
    1043           0 :   fd_funk_txn_xid_t xid = { .ul = { curr_slot, ctx->leader_bank->data->idx } };
    1044           0 :   slot_info->identity_balance = FD_UNLIKELY( curr_slot%4096==0UL ) ? get_identity_balance( ctx, xid ) : ULONG_MAX;
    1045             : 
    1046           0 :   fd_banks_mark_bank_frozen( ctx->banks, ctx->leader_bank );
    1047             : 
    1048           0 :   fd_hash_t const * bank_hash  = fd_bank_bank_hash_query( ctx->leader_bank );
    1049           0 :   FD_TEST( bank_hash );
    1050             : 
    1051           0 :   publish_slot_completed( ctx, stem, ctx->leader_bank, 0, 1 /* is_leader */ );
    1052             : 
    1053             :   /* The reference on the bank is finally no longer needed. */
    1054           0 :   ctx->leader_bank->data->refcnt--;
    1055             : 
    1056             :   /* We are no longer leader so we can clear the bank index we use for
    1057             :      being the leader. */
    1058           0 :   ctx->leader_bank->data = NULL;
    1059           0 :   ctx->recv_poh          = 0;
    1060           0 :   ctx->is_leader         = 0;
    1061             : 
    1062           0 :   maybe_switch_identity( ctx );
    1063           0 : }
    1064             : 
    1065             : static void
    1066             : publish_root_advanced( fd_replay_tile_t *  ctx,
    1067           0 :                        fd_stem_context_t * stem ) {
    1068             : 
    1069           0 :   fd_bank_t bank[1];
    1070           0 :   if( FD_UNLIKELY( !fd_banks_bank_query( bank, ctx->banks, ctx->consensus_root_bank_idx ) ) ) {
    1071           0 :     FD_LOG_CRIT(( "invariant violation: consensus root bank is NULL at bank index %lu", ctx->consensus_root_bank_idx ));
    1072           0 :   }
    1073             : 
    1074           0 :   if( ctx->rpc_enabled ) {
    1075           0 :     bank->data->refcnt++;
    1076           0 :     FD_LOG_DEBUG(( "bank (idx=%lu, slot=%lu) refcnt incremented to %lu for gui", bank->data->idx, fd_bank_slot_get( bank ), bank->data->refcnt ));
    1077           0 :   }
    1078             : 
    1079             :   /* Increment the reference count on the consensus root bank to account
    1080             :      for the number of resolv tiles that are waiting on it. */
    1081           0 :   bank->data->refcnt += ctx->resolv_tile_cnt;
    1082           0 :   FD_LOG_DEBUG(( "bank (idx=%lu, slot=%lu) refcnt incremented to %lu for resolv", bank->data->idx, fd_bank_slot_get( bank ), bank->data->refcnt ));
    1083             : 
    1084           0 :   fd_replay_root_advanced_t * msg = fd_chunk_to_laddr( ctx->replay_out->mem, ctx->replay_out->chunk );
    1085           0 :   msg->bank_idx = bank->data->idx;
    1086             : 
    1087           0 :   fd_stem_publish( stem, ctx->replay_out->idx, REPLAY_SIG_ROOT_ADVANCED, ctx->replay_out->chunk, sizeof(fd_replay_root_advanced_t), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
    1088           0 :   ctx->replay_out->chunk = fd_dcache_compact_next( ctx->replay_out->chunk, sizeof(fd_replay_root_advanced_t), ctx->replay_out->chunk0, ctx->replay_out->wmark );
    1089           0 : }
    1090             : 
    1091             : /* init_funk performs pre-flight checks for the account database and
    1092             :    program cache.  Ensures that the account database was set up
    1093             :    correctly by bootstrap components (e.g. genesis or snapshot loader).
    1094             :    Mirrors the account database's fork tree down to the program cache. */
    1095             : 
    1096             : static void
    1097             : init_funk( fd_replay_tile_t * ctx,
    1098           0 :            ulong              bank_slot ) {
    1099             :   /* Ensure that the loaded bank root corresponds to the account
    1100             :      database's root. */
    1101           0 :   fd_funk_t * funk = fd_accdb_user_v1_funk( ctx->accdb );
    1102           0 :   if( FD_UNLIKELY( !funk->shmem ) ) {
    1103           0 :     FD_LOG_CRIT(( "failed to initialize account database: replay tile is not joined to database shared memory objects" ));
    1104           0 :   }
    1105           0 :   fd_funk_txn_xid_t const * accdb_pub = fd_funk_last_publish( funk );
    1106           0 :   if( FD_UNLIKELY( accdb_pub->ul[0]!=bank_slot ) ) {
    1107           0 :     FD_LOG_CRIT(( "failed to initialize account database: accdb is at slot %lu, but chain state is at slot %lu\n"
    1108           0 :                   "This is a bug in startup components.",
    1109           0 :                   accdb_pub->ul[0], bank_slot ));
    1110           0 :   }
    1111           0 :   if( FD_UNLIKELY( fd_funk_last_publish_is_frozen( funk ) ) ) {
    1112           0 :     FD_LOG_CRIT(( "failed to initialize account database: accdb fork graph is not clean.\n"
    1113           0 :                   "The account database should only contain state for the root slot at this point,\n"
    1114           0 :                   "but there are incomplete database transactions leftover.\n"
    1115           0 :                   "This is a bug in startup components."  ));
    1116           0 :   }
    1117             : 
    1118             :   /* The program cache tracks the account database's fork graph at all
    1119             :      times.  Perform initial synchronization: pivot from funk 'root' (a
    1120             :      sentinel XID) to 'last publish' (the bootstrap root slot). */
    1121           0 :   if( FD_UNLIKELY( !ctx->progcache_admin->funk->shmem ) ) {
    1122           0 :     FD_LOG_CRIT(( "failed to initialize account database: replay tile is not joined to program cache" ));
    1123           0 :   }
    1124           0 :   fd_progcache_clear( ctx->progcache_admin );
    1125             : 
    1126           0 :   fd_funk_txn_xid_t last_publish = fd_accdb_root_get( ctx->accdb_admin );
    1127           0 :   fd_progcache_txn_attach_child( ctx->progcache_admin, fd_funk_root( ctx->progcache_admin->funk ), &last_publish );
    1128           0 :   fd_progcache_txn_advance_root( ctx->progcache_admin,                                             &last_publish );
    1129           0 : }
    1130             : 
    1131             : static void
    1132           0 : init_after_snapshot( fd_replay_tile_t * ctx ) {
    1133             :   /* Now that the snapshot has been loaded in, we have to refresh the
    1134             :      stake delegations since the manifest does not contain the full set
    1135             :      of data required for the stake delegations. See
    1136             :      fd_stake_delegations.h for why this is required. */
    1137             : 
    1138           0 :   fd_bank_t bank[1];
    1139           0 :   if( FD_UNLIKELY( !fd_banks_bank_query( bank, ctx->banks, FD_REPLAY_BOOT_BANK_IDX ) ) ) {
    1140           0 :     FD_LOG_CRIT(( "invariant violation: replay bank is NULL at bank index %lu", FD_REPLAY_BOOT_BANK_IDX ));
    1141           0 :   }
    1142             : 
    1143           0 :   fd_funk_txn_xid_t xid = { .ul = { fd_bank_slot_get( bank ), bank->data->idx } };
    1144           0 :   init_funk( ctx, fd_bank_slot_get( bank ) );
    1145             : 
    1146           0 :   fd_stake_delegations_t * root_delegations = fd_banks_stake_delegations_root_query( ctx->banks );
    1147             : 
    1148           0 :   fd_stake_delegations_refresh( root_delegations, ctx->accdb, &xid );
    1149             : 
    1150           0 :   fd_vote_stakes_t * vote_stakes = fd_bank_vote_stakes_locking_modify( bank );
    1151           0 :   ushort fork_idx = bank->data->vote_stakes_fork_id;
    1152             : 
    1153           0 :   ulong stale_accs = 0UL;
    1154           0 :   uchar __attribute__((aligned(FD_VOTE_STAKES_ITER_ALIGN))) iter_mem[ FD_VOTE_STAKES_ITER_FOOTPRINT ];
    1155           0 :   for( fd_vote_stakes_iter_t * iter = fd_vote_stakes_fork_iter_init( vote_stakes, fork_idx, iter_mem );
    1156           0 :        !fd_vote_stakes_fork_iter_done( vote_stakes, fork_idx, iter );
    1157           0 :        fd_vote_stakes_fork_iter_next( vote_stakes, fork_idx, iter ) ) {
    1158           0 :     fd_pubkey_t pubkey;
    1159           0 :     fd_vote_stakes_fork_iter_ele( vote_stakes, fork_idx, iter, &pubkey, NULL, NULL, NULL, NULL );
    1160             : 
    1161           0 :     fd_accdb_ro_t acc[1];
    1162           0 :     if( FD_UNLIKELY( !fd_accdb_open_ro( ctx->accdb, acc, &xid, &pubkey ) ) ) {
    1163           0 :       ctx->runtime_stack.vote_accounts.stale_accs[stale_accs++] = pubkey;
    1164           0 :       continue;
    1165           0 :     }
    1166           0 :     fd_accdb_close_ro( ctx->accdb, acc );
    1167           0 :   }
    1168             : 
    1169           0 :   for( ulong i=0UL; i<stale_accs; i++ ) {
    1170           0 :     fd_vote_stakes_root_purge_key( vote_stakes, &ctx->runtime_stack.vote_accounts.stale_accs[i] );
    1171           0 :   }
    1172             : 
    1173           0 :   fd_bank_vote_stakes_end_locking_modify( bank );
    1174             : 
    1175             : 
    1176             : 
    1177             :   /* After both snapshots have been loaded in, we can determine if we should
    1178             :      start distributing rewards. */
    1179             : 
    1180           0 :   fd_rewards_recalculate_partitioned_rewards( ctx->banks, bank, ctx->accdb, &xid, &ctx->runtime_stack, ctx->capture_ctx );
    1181             : 
    1182           0 :   ulong snapshot_slot = fd_bank_slot_get( bank );
    1183           0 :   if( FD_UNLIKELY( !snapshot_slot ) ) {
    1184             :     /* Genesis-specific setup. */
    1185             :     /* FIXME: This branch does not set up a new block exec ctx
    1186             :        properly. Needs to do whatever prepare_new_block_execution
    1187             :        does, but just hacking that in breaks stuff. */
    1188           0 :     fd_runtime_update_leaders( bank, &ctx->runtime_stack );
    1189             : 
    1190           0 :     ulong hashcnt_per_slot = fd_bank_hashes_per_tick_get( bank ) * fd_bank_ticks_per_slot_get( bank );
    1191           0 :     fd_hash_t * poh = fd_bank_poh_modify( bank );
    1192           0 :     while( hashcnt_per_slot-- ) {
    1193           0 :       fd_sha256_hash( poh->hash, 32UL, poh->hash );
    1194           0 :     }
    1195             : 
    1196           0 :     int is_epoch_boundary = 0;
    1197           0 :     fd_runtime_block_execute_prepare( ctx->banks, bank, ctx->accdb, &ctx->runtime_stack, ctx->capture_ctx, &is_epoch_boundary );
    1198           0 :     FD_TEST( !is_epoch_boundary );
    1199           0 :     fd_runtime_block_execute_finalize( bank, ctx->accdb, ctx->capture_ctx );
    1200             : 
    1201           0 :     snapshot_slot = 0UL;
    1202           0 :   }
    1203           0 : }
    1204             : 
    1205             : static inline int
    1206             : maybe_become_leader( fd_replay_tile_t *  ctx,
    1207           0 :                      fd_stem_context_t * stem ) {
    1208           0 :   FD_TEST( ctx->is_booted );
    1209           0 :   if( FD_LIKELY( ctx->next_leader_slot==ULONG_MAX || ctx->is_leader || (!ctx->identity_vote_rooted && ctx->wait_for_vote_to_start_leader) || ctx->replay_out->idx==ULONG_MAX || !ctx->wfs_complete ) ) return 0;
    1210           0 :   if( FD_UNLIKELY( ctx->halt_leader ) ) return 0;
    1211           0 :   if( !ctx->supports_leader ) return 0;
    1212             : 
    1213           0 :   FD_TEST( ctx->next_leader_slot>ctx->reset_slot );
    1214           0 :   long now = fd_tickcount();
    1215           0 :   if( FD_LIKELY( now<ctx->next_leader_tickcount ) ) return 0;
    1216             : 
    1217             :   /* If a prior leader is still in the process of publishing their slot,
    1218             :      delay ours to let them finish ... unless they are so delayed that
    1219             :      we risk getting skipped by the leader following us.  1.2 seconds
    1220             :      is a reasonable default here, although any value between 0 and 1.6
    1221             :      seconds could be considered reasonable.  This is arbitrary and
    1222             :      chosen due to intuition. */
    1223           0 :   if( FD_UNLIKELY( now<ctx->next_leader_tickcount+(long)(3.0*ctx->slot_duration_ticks) ) ) {
    1224           0 :     FD_TEST( ctx->reset_bank->data );
    1225             : 
    1226             :     /* TODO: Make the max_active_descendant calculation more efficient
    1227             :        by caching it in the bank structure and updating it as banks are
    1228             :        created and completed. */
    1229           0 :     ulong max_active_descendant = 0UL;
    1230           0 :     ulong child_idx = ctx->reset_bank->data->child_idx;
    1231           0 :     while( child_idx!=ULONG_MAX ) {
    1232           0 :       fd_bank_t child_bank[1];
    1233           0 :       fd_banks_bank_query( child_bank, ctx->banks, child_idx );
    1234           0 :       max_active_descendant = fd_ulong_max( max_active_descendant, fd_bank_slot_get( child_bank ) );
    1235           0 :       child_idx = child_bank->data->sibling_idx;
    1236           0 :     }
    1237             : 
    1238             :     /* If the max_active_descendant is >= next_leader_slot, we waited
    1239             :        too long and a leader after us started publishing to try and skip
    1240             :        us.  Just start our leader slot immediately, we might win ... */
    1241           0 :     if( FD_LIKELY( max_active_descendant>=ctx->reset_slot && max_active_descendant<ctx->next_leader_slot ) ) {
    1242             :       /* If one of the leaders between the reset slot and our leader
    1243             :          slot is in the process of publishing (they have a descendant
    1244             :          bank that is in progress of being replayed), then keep waiting.
    1245             :          We probably wouldn't get a leader slot out before they
    1246             :          finished.
    1247             : 
    1248             :          Unless... we are past the deadline to start our slot by more
    1249             :          than 1.2 seconds, in which case we should probably start it to
    1250             :          avoid getting skipped by the leader behind us. */
    1251           0 :       return 0;
    1252           0 :     }
    1253           0 :   }
    1254             : 
    1255           0 :   long now_nanos = fd_log_wallclock();
    1256             : 
    1257           0 :   ctx->is_leader = 1;
    1258           0 :   ctx->recv_poh  = 0;
    1259             : 
    1260           0 :   FD_TEST( ctx->highwater_leader_slot==ULONG_MAX || ctx->highwater_leader_slot<ctx->next_leader_slot );
    1261           0 :   ctx->highwater_leader_slot = ctx->next_leader_slot;
    1262             : 
    1263           0 :   FD_LOG_INFO(( "becoming leader for slot %lu, parent slot is %lu", ctx->next_leader_slot, ctx->reset_slot ));
    1264             : 
    1265             :   /* Acquires bank, sets up initial state, and refcnts it. */
    1266           0 :   fd_bank_t *       bank = prepare_leader_bank( ctx, ctx->next_leader_slot, now_nanos, &ctx->reset_block_id, stem );
    1267           0 :   fd_funk_txn_xid_t xid  = { .ul = { ctx->next_leader_slot, ctx->leader_bank->data->idx } };
    1268             : 
    1269           0 :   fd_bundle_crank_tip_payment_config_t config[1] = { 0 };
    1270           0 :   fd_pubkey_t tip_receiver_owner = {0};
    1271             : 
    1272           0 :   if( FD_UNLIKELY( ctx->bundle.enabled ) ) {
    1273           0 :     fd_acct_addr_t tip_payment_config[1];
    1274           0 :     fd_acct_addr_t tip_receiver[1];
    1275           0 :     fd_bundle_crank_get_addresses( ctx->bundle.gen, fd_bank_epoch_get( bank ), tip_payment_config, tip_receiver );
    1276             : 
    1277           0 :     fd_accdb_ro_t tip_config_acc[1];
    1278           0 :     if( FD_UNLIKELY( !fd_accdb_open_ro( ctx->accdb, tip_config_acc, &xid, tip_payment_config ) ) ) {
    1279             :       /* FIXME This should not crash the validator */
    1280           0 :       FD_BASE58_ENCODE_32_BYTES( tip_payment_config->b, tip_config_acc_b58 );
    1281           0 :       FD_LOG_CRIT(( "tip payment config account %s does not exist", tip_config_acc_b58 ));
    1282           0 :     }
    1283           0 :     ulong tip_cfg_sz = fd_accdb_ref_data_sz( tip_config_acc );
    1284           0 :     if( FD_UNLIKELY( tip_cfg_sz < sizeof(fd_bundle_crank_tip_payment_config_t) ) ) {
    1285             :       /* FIXME This should not crash the validator */
    1286           0 :       FD_LOG_HEXDUMP_CRIT(( "invalid tip payment config account data", fd_accdb_ref_data_const( tip_config_acc ), tip_cfg_sz ));
    1287           0 :     }
    1288           0 :     memcpy( config, fd_accdb_ref_data_const( tip_config_acc ), sizeof(fd_bundle_crank_tip_payment_config_t) );
    1289           0 :     fd_accdb_close_ro( ctx->accdb, tip_config_acc );
    1290             : 
    1291             :     /* It is possible that the tip receiver account does not exist yet
    1292             :        if it is the first time in an epoch. */
    1293           0 :     fd_accdb_ro_t tip_receiver_acc[1];
    1294           0 :     if( FD_LIKELY( fd_accdb_open_ro( ctx->accdb, tip_receiver_acc, &xid, tip_receiver ) ) ) {
    1295           0 :       tip_receiver_owner = FD_LOAD( fd_pubkey_t, fd_accdb_ref_owner( tip_receiver_acc ) );
    1296           0 :       fd_accdb_close_ro( ctx->accdb, tip_receiver_acc );
    1297           0 :     }
    1298           0 :   }
    1299             : 
    1300             : 
    1301           0 :   fd_became_leader_t * msg = fd_chunk_to_laddr( ctx->replay_out->mem, ctx->replay_out->chunk );
    1302           0 :   msg->slot = ctx->next_leader_slot;
    1303           0 :   msg->slot_start_ns = now_nanos;
    1304           0 :   msg->slot_end_ns   = now_nanos+(long)ctx->slot_duration_nanos;
    1305           0 :   msg->bank = NULL;
    1306           0 :   msg->bank_idx = bank->data->idx;
    1307           0 :   msg->ticks_per_slot = fd_bank_ticks_per_slot_get( bank );
    1308           0 :   msg->hashcnt_per_tick = fd_bank_hashes_per_tick_get( bank );
    1309           0 :   msg->tick_duration_ns = (ulong)(ctx->slot_duration_nanos/(double)msg->ticks_per_slot);
    1310           0 :   msg->bundle->config[0]       = config[0];
    1311           0 :   memcpy( msg->bundle->last_blockhash,     fd_bank_poh_query( bank )->hash, sizeof(fd_hash_t)   );
    1312           0 :   memcpy( msg->bundle->tip_receiver_owner, tip_receiver_owner.uc,           sizeof(fd_pubkey_t) );
    1313             : 
    1314           0 :   if( FD_UNLIKELY( msg->hashcnt_per_tick==1UL ) ) {
    1315             :     /* Low power producer, maximum of one microblock per tick in the slot */
    1316           0 :     msg->max_microblocks_in_slot = msg->ticks_per_slot;
    1317           0 :   } else {
    1318             :     /* See the long comment in after_credit for this limit */
    1319           0 :     msg->max_microblocks_in_slot = fd_ulong_min( MAX_MICROBLOCKS_PER_SLOT, msg->ticks_per_slot*(msg->hashcnt_per_tick-1UL) );
    1320           0 :   }
    1321             : 
    1322           0 :   msg->total_skipped_ticks = msg->ticks_per_slot*(ctx->next_leader_slot-ctx->reset_slot);
    1323           0 :   msg->epoch = fd_slot_to_epoch( fd_bank_epoch_schedule_query( bank ), ctx->next_leader_slot, NULL );
    1324             : 
    1325           0 :   fd_cost_tracker_t const * cost_tracker = fd_bank_cost_tracker_locking_query( bank );
    1326             : 
    1327           0 :   msg->limits.slot_max_cost = ctx->larger_max_cost_per_block ? LARGER_MAX_COST_PER_BLOCK : cost_tracker->block_cost_limit;
    1328           0 :   msg->limits.slot_max_vote_cost = cost_tracker->vote_cost_limit;
    1329           0 :   msg->limits.slot_max_write_cost_per_acct = cost_tracker->account_cost_limit;
    1330             : 
    1331           0 :   fd_bank_cost_tracker_end_locking_query( bank );
    1332             : 
    1333           0 :   if( FD_UNLIKELY( msg->ticks_per_slot+msg->total_skipped_ticks>USHORT_MAX ) ) {
    1334             :     /* There can be at most USHORT_MAX skipped ticks, because the
    1335             :        parent_offset field in the shred data is only 2 bytes wide. */
    1336           0 :     FD_LOG_ERR(( "too many skipped ticks %lu for slot %lu, chain must halt", msg->ticks_per_slot+msg->total_skipped_ticks, ctx->next_leader_slot ));
    1337           0 :   }
    1338             : 
    1339           0 :   fd_stem_publish( stem, ctx->replay_out->idx, REPLAY_SIG_BECAME_LEADER, ctx->replay_out->chunk, sizeof(fd_became_leader_t), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
    1340           0 :   ctx->replay_out->chunk = fd_dcache_compact_next( ctx->replay_out->chunk, sizeof(fd_became_leader_t), ctx->replay_out->chunk0, ctx->replay_out->wmark );
    1341             : 
    1342           0 :   ctx->next_leader_slot      = ULONG_MAX;
    1343           0 :   ctx->next_leader_tickcount = LONG_MAX;
    1344             : 
    1345           0 :   return 1;
    1346           0 : }
    1347             : 
    1348             : static void
    1349             : process_poh_message( fd_replay_tile_t *                 ctx,
    1350           0 :                      fd_poh_leader_slot_ended_t const * slot_ended ) {
    1351             : 
    1352           0 :   FD_TEST( ctx->is_booted );
    1353           0 :   FD_TEST( ctx->is_leader );
    1354           0 :   FD_TEST( ctx->leader_bank->data!=NULL );
    1355             : 
    1356           0 :   FD_TEST( ctx->highwater_leader_slot>=slot_ended->slot );
    1357           0 :   FD_TEST( ctx->next_leader_slot>ctx->highwater_leader_slot );
    1358             : 
    1359             :   /* Update the poh hash in the bank.  We will want to maintain a refcnt
    1360             :      on the bank until we have recieved the block id for the block after
    1361             :      it has been shredded. */
    1362             : 
    1363           0 :   memcpy( fd_bank_poh_modify( ctx->leader_bank ), slot_ended->blockhash, sizeof(fd_hash_t) );
    1364             : 
    1365           0 :   ctx->recv_poh = 1;
    1366           0 : }
    1367             : 
    1368             : static void
    1369             : publish_reset( fd_replay_tile_t *  ctx,
    1370             :                fd_stem_context_t * stem,
    1371           0 :                fd_bank_t *         bank ) {
    1372           0 :   if( FD_UNLIKELY( ctx->replay_out->idx==ULONG_MAX ) ) return;
    1373             : 
    1374           0 :   fd_hash_t const * block_hash = fd_blockhashes_peek_last_hash( fd_bank_block_hash_queue_query( bank ) );
    1375           0 :   FD_TEST( block_hash );
    1376             : 
    1377           0 :   fd_poh_reset_t * reset = fd_chunk_to_laddr( ctx->replay_out->mem, ctx->replay_out->chunk );
    1378             : 
    1379           0 :   reset->bank_idx         = bank->data->idx;
    1380           0 :   reset->timestamp        = fd_log_wallclock();
    1381           0 :   reset->completed_slot   = fd_bank_slot_get( bank );
    1382           0 :   reset->hashcnt_per_tick = fd_bank_hashes_per_tick_get( bank );
    1383           0 :   reset->ticks_per_slot   = fd_bank_ticks_per_slot_get( bank );
    1384           0 :   reset->tick_duration_ns = (ulong)(ctx->slot_duration_nanos/(double)reset->ticks_per_slot);
    1385           0 :   fd_memcpy( reset->completed_block_id, ctx->reset_block_id.uc, sizeof(fd_hash_t) );
    1386           0 :   fd_memcpy( reset->completed_blockhash, block_hash->uc, sizeof(fd_hash_t) );
    1387             : 
    1388           0 :   ulong ticks_per_slot = fd_bank_ticks_per_slot_get( bank );
    1389           0 :   if( FD_UNLIKELY( reset->hashcnt_per_tick==1UL ) ) {
    1390             :     /* Low power producer, maximum of one microblock per tick in the slot */
    1391           0 :     reset->max_microblocks_in_slot = ticks_per_slot;
    1392           0 :   } else {
    1393             :     /* See the long comment in after_credit for this limit */
    1394           0 :     reset->max_microblocks_in_slot = fd_ulong_min( MAX_MICROBLOCKS_PER_SLOT, ticks_per_slot*(reset->hashcnt_per_tick-1UL) );
    1395           0 :   }
    1396           0 :   reset->next_leader_slot = ctx->next_leader_slot;
    1397             : 
    1398           0 :   fd_stem_publish( stem, ctx->replay_out->idx, REPLAY_SIG_RESET, ctx->replay_out->chunk, sizeof(fd_poh_reset_t), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
    1399           0 :   ctx->replay_out->chunk = fd_dcache_compact_next( ctx->replay_out->chunk, sizeof(fd_poh_reset_t), ctx->replay_out->chunk0, ctx->replay_out->wmark );
    1400           0 : }
    1401             : 
    1402             : static void
    1403             : store_xinsert( fd_store_t      * store,
    1404           0 :                fd_hash_t const * merkle_root ) {
    1405           0 :   fd_store_pool_t pool = {
    1406           0 :       .pool    = fd_wksp_laddr_fast( fd_store_wksp( store ), store->pool_mem_gaddr ),
    1407           0 :       .ele     = fd_wksp_laddr_fast( fd_store_wksp( store ), store->pool_ele_gaddr ),
    1408           0 :       .ele_max = store->fec_max
    1409           0 :   };
    1410           0 :   int err; fd_store_fec_t * fec = fd_store_pool_acquire( &pool, NULL, 1 /* blocking */, &err );
    1411           0 :   if( FD_UNLIKELY( err!=FD_POOL_SUCCESS ) ) FD_LOG_CRIT(( "store pool: %s", fd_store_pool_strerror( err ) ));
    1412           0 :   fec->key.merkle_root = *merkle_root;
    1413           0 :   fec->key.part_idx    = 0;
    1414           0 :   fec->cmr             = (fd_hash_t){ 0 };
    1415           0 :   fec->next            = fd_store_pool_idx_null();
    1416           0 :   fec->data_sz         = 0UL;
    1417             : 
    1418           0 :   FD_STORE_XLOCK_BEGIN( store ) {
    1419           0 :     fd_store_map_ele_insert( fd_wksp_laddr_fast( fd_store_wksp( store ), store->map_gaddr ), fec, pool.ele );
    1420           0 :   } FD_STORE_XLOCK_END;
    1421           0 : }
    1422             : 
    1423             : static void
    1424             : boot_genesis( fd_replay_tile_t *        ctx,
    1425             :               fd_stem_context_t *       stem,
    1426           0 :               fd_genesis_meta_t const * meta ) {
    1427             :   /* If we are bootstrapping, we can't wait to wait for our identity
    1428             :      vote to be rooted as this creates a circular dependency. */
    1429           0 :   ctx->identity_vote_rooted = 1;
    1430             : 
    1431           0 :   uchar const * genesis_blob = (uchar const *)( meta+1 );
    1432           0 :   FD_TEST( meta->bootstrap && meta->has_lthash );
    1433           0 :   FD_TEST( fd_genesis_parse( ctx->genesis, genesis_blob, meta->blob_sz ) );
    1434             : 
    1435           0 :   fd_bank_t bank[1];
    1436           0 :   FD_TEST( fd_banks_bank_query( bank, ctx->banks, FD_REPLAY_BOOT_BANK_IDX ) );
    1437           0 :   fd_funk_txn_xid_t xid = { .ul = { 0UL, FD_REPLAY_BOOT_BANK_IDX } };
    1438             : 
    1439             :   /* Do genesis-related processing in a non-rooted transaction */
    1440           0 :   fd_funk_txn_xid_t root_xid = { .ul = { LONG_MAX, LONG_MAX } };
    1441           0 :   fd_funk_txn_xid_t target_xid = { .ul = { 0UL, 0UL } };
    1442           0 :   fd_accdb_attach_child( ctx->accdb_admin, &root_xid, &target_xid );
    1443           0 :   fd_runtime_read_genesis( ctx->banks, bank, ctx->accdb, &xid, NULL, &meta->genesis_hash, &meta->lthash, ctx->genesis, genesis_blob, &ctx->runtime_stack );
    1444           0 :   fd_accdb_advance_root( ctx->accdb_admin, &target_xid );
    1445             : 
    1446           0 :   static const fd_txncache_fork_id_t txncache_root = { .val = USHORT_MAX };
    1447           0 :   bank->data->txncache_fork_id = fd_txncache_attach_child( ctx->txncache, txncache_root );
    1448             : 
    1449           0 :   fd_hash_t const * block_hash = fd_blockhashes_peek_last_hash( fd_bank_block_hash_queue_query( bank ) );
    1450           0 :   fd_txncache_finalize_fork( ctx->txncache, bank->data->txncache_fork_id, 0UL, block_hash->uc );
    1451             : 
    1452           0 :   publish_epoch_info( ctx, stem, bank, 0 );
    1453           0 :   publish_epoch_info( ctx, stem, bank, 1 );
    1454             : 
    1455             :   /* We call this after fd_runtime_read_genesis, which sets up the
    1456             :      slot_bank needed in blockstore_init. */
    1457           0 :   init_after_snapshot( ctx );
    1458             : 
    1459           0 :   ctx->published_root_slot = 0UL;
    1460           0 :   fd_sched_block_add_done( ctx->sched, bank->data->idx, ULONG_MAX, 0UL );
    1461             : 
    1462           0 :   fd_bank_block_height_set( bank, 1UL );
    1463             : 
    1464           0 :   ctx->consensus_root          = ctx->initial_block_id;
    1465           0 :   ctx->consensus_root_slot     = 0UL;
    1466           0 :   ctx->consensus_root_bank_idx = 0UL;
    1467           0 :   ctx->published_root_slot     = 0UL;
    1468           0 :   ctx->published_root_bank_idx = 0UL;
    1469             : 
    1470           0 :   ctx->reset_slot            = 0UL;
    1471           0 :   fd_memcpy( ctx->reset_bank, bank, sizeof(fd_bank_t) );
    1472           0 :   ctx->reset_timestamp_nanos = fd_log_wallclock();
    1473           0 :   ctx->next_leader_slot      = fd_multi_epoch_leaders_get_next_slot( ctx->mleaders, 1UL, ctx->identity_pubkey );
    1474           0 :   if( FD_LIKELY( ctx->next_leader_slot != ULONG_MAX ) ) {
    1475           0 :     ctx->next_leader_tickcount = (long)((double)(ctx->next_leader_slot-ctx->reset_slot-1UL)*ctx->slot_duration_ticks) + fd_tickcount();
    1476           0 :   } else {
    1477           0 :     ctx->next_leader_tickcount = LONG_MAX;
    1478           0 :   }
    1479             : 
    1480           0 :   ctx->is_booted = 1;
    1481           0 :   maybe_become_leader( ctx, stem );
    1482             : 
    1483           0 :   fd_hash_t initial_block_id = ctx->initial_block_id;
    1484           0 :   fd_reasm_fec_t * fec       = fd_reasm_insert( ctx->reasm, &initial_block_id, NULL, 0 /* genesis slot */, 0, 0, 0, 0, 1, 0 ); /* FIXME manifest block_id */
    1485           0 :   fec->bank_idx              = bank->data->idx;
    1486           0 :   fec->bank_seq              = bank->data->bank_seq;
    1487           0 :   store_xinsert( ctx->store, &initial_block_id );
    1488             : 
    1489           0 :   fd_block_id_ele_t * block_id_ele = &ctx->block_id_arr[ 0 ];
    1490           0 :   block_id_ele->latest_mr = initial_block_id;
    1491           0 :   block_id_ele->slot      = 0UL;
    1492             : 
    1493           0 :   FD_TEST( fd_block_id_map_ele_insert( ctx->block_id_map, block_id_ele, ctx->block_id_arr ) );
    1494             : 
    1495           0 :   fd_replay_slot_completed_t * slot_info = fd_chunk_to_laddr( ctx->replay_out->mem, ctx->replay_out->chunk );
    1496           0 :   slot_info->identity_balance = get_identity_balance( ctx, xid );
    1497             : 
    1498           0 :   publish_slot_completed( ctx, stem, bank, 1, 0 /* is_leader */ );
    1499           0 :   publish_root_advanced( ctx, stem );
    1500           0 :   publish_reset( ctx, stem, bank );
    1501           0 : }
    1502             : 
    1503             : static inline void
    1504           0 : maybe_verify_cluster_type( fd_replay_tile_t * ctx ) {
    1505           0 :   if( FD_UNLIKELY( !ctx->is_booted || !ctx->has_genesis_hash ) ) {
    1506           0 :     return;
    1507           0 :   }
    1508             : 
    1509           0 :   FD_BASE58_ENCODE_32_BYTES( ctx->genesis_hash->uc, hash_cstr );
    1510           0 :   ulong cluster = fd_genesis_cluster_identify( hash_cstr );
    1511             :   /* Map pyth-related clusters to unkwown. */
    1512           0 :   switch( cluster ) {
    1513           0 :     case FD_CLUSTER_PYTHNET:
    1514           0 :     case FD_CLUSTER_PYTHTEST:
    1515           0 :       cluster = FD_CLUSTER_UNKNOWN;
    1516           0 :   }
    1517             : 
    1518           0 :   if( FD_UNLIKELY( cluster!=ctx->cluster_type ) ) {
    1519           0 :     FD_LOG_ERR(( "Your genesis.bin file at `%s` has a genesis hash of `%s` which means the cluster is %s "
    1520           0 :                  "but the snapshot you loaded is for a different cluster %s. If you are trying to join the "
    1521           0 :                  "%s cluster, you can delete the genesis.bin file and restart the node to download the correct "
    1522           0 :                  "genesis file automatically.",
    1523           0 :                  ctx->genesis_path,
    1524           0 :                  hash_cstr,
    1525           0 :                  fd_genesis_cluster_name( cluster ),
    1526           0 :                  fd_genesis_cluster_name( ctx->cluster_type ),
    1527           0 :                  fd_genesis_cluster_name( cluster ) ));
    1528           0 :   }
    1529           0 : }
    1530             : 
    1531             : static void
    1532             : on_snapshot_message( fd_replay_tile_t *  ctx,
    1533             :                      fd_stem_context_t * stem,
    1534             :                      ulong               in_idx,
    1535             :                      ulong               chunk,
    1536           0 :                      ulong               sig ) {
    1537           0 :   ulong msg = fd_ssmsg_sig_message( sig );
    1538           0 :   if( FD_LIKELY( msg==FD_SSMSG_DONE ) ) {
    1539             :     /* An end of message notification indicates the snapshot is loaded.
    1540             :        Replay is able to start executing from this point onwards. */
    1541             :     /* TODO: replay should finish booting. Could make replay a
    1542             :        state machine and set the state here accordingly. */
    1543           0 :     ctx->is_booted = 1;
    1544             : 
    1545           0 :     fd_bank_t bank[1];
    1546           0 :     if( FD_UNLIKELY( !fd_banks_bank_query( bank, ctx->banks, FD_REPLAY_BOOT_BANK_IDX ) ) ) {
    1547           0 :       FD_LOG_CRIT(( "invariant violation: bank is NULL for bank index %lu", FD_REPLAY_BOOT_BANK_IDX ));
    1548           0 :     }
    1549             : 
    1550           0 :     ulong snapshot_slot = fd_bank_slot_get( bank );
    1551             : 
    1552           0 :     fd_hash_t bank_hash = fd_bank_bank_hash_get( bank );
    1553           0 :     if( FD_UNLIKELY( ctx->wfs_enabled && memcmp( ctx->expected_bank_hash.uc, bank_hash.uc, sizeof(fd_hash_t) ) ) ) {
    1554           0 :       FD_BASE58_ENCODE_32_BYTES( ctx->expected_bank_hash.uc, expected_bank_hash_cstr );
    1555           0 :       FD_BASE58_ENCODE_32_BYTES( bank_hash.uc,                 actual_bank_hash_cstr );
    1556           0 :       FD_LOG_ERR(( "[consensus.wait_for_supermajority_with_bank_hash] expected_bank_hash=%s does not match snapshot slot"
    1557           0 :                    "=%lu bank_hash=%s. If you are loading a snapshot from the network, check that the slot matches the "
    1558           0 :                    "cluster restart slot. ", expected_bank_hash_cstr, snapshot_slot, actual_bank_hash_cstr ));
    1559           0 :     }
    1560           0 :     if( FD_UNLIKELY( ctx->wfs_enabled ) ) {
    1561           0 :       FD_LOG_NOTICE(( "waiting for supermajority at snapshot slot %lu", snapshot_slot ));
    1562           0 :     }
    1563             : 
    1564             :     /* FIXME: This is a hack because the block id of the snapshot slot
    1565             :        is not provided in the snapshot.  A possible solution is to get
    1566             :        the block id of the snapshot slot from repair. */
    1567           0 :     fd_hash_t manifest_block_id = ctx->initial_block_id;
    1568             : 
    1569           0 :     fd_funk_txn_xid_t xid = { .ul = { snapshot_slot, FD_REPLAY_BOOT_BANK_IDX } };
    1570           0 :     fd_features_restore( bank, ctx->accdb, &xid );
    1571             : 
    1572             :     /* Typically, when we cross an epoch boundary during normal
    1573             :        operation, we publish the stake weights for the new epoch.  But
    1574             :        since we are starting from a snapshot, we need to publish two
    1575             :        epochs worth of stake weights: the previous epoch (which is
    1576             :        needed for voting on the current epoch), and the current epoch
    1577             :        (which is needed for voting on the next epoch). */
    1578           0 :     publish_epoch_info( ctx, stem, bank, 0 );
    1579           0 :     publish_epoch_info( ctx, stem, bank, 1 );
    1580             : 
    1581           0 :     ctx->consensus_root          = manifest_block_id;
    1582           0 :     ctx->consensus_root_slot     = snapshot_slot;
    1583           0 :     ctx->consensus_root_bank_idx = 0UL;
    1584           0 :     ctx->published_root_slot     = ctx->consensus_root_slot;
    1585           0 :     ctx->published_root_bank_idx = 0UL;
    1586             : 
    1587           0 :     ctx->reset_slot            = snapshot_slot;
    1588           0 :     fd_memcpy( ctx->reset_bank, bank, sizeof(fd_bank_t) );
    1589           0 :     ctx->reset_timestamp_nanos = fd_log_wallclock();
    1590           0 :     ctx->next_leader_slot      = fd_multi_epoch_leaders_get_next_slot( ctx->mleaders, 1UL, ctx->identity_pubkey );
    1591           0 :     if( FD_LIKELY( ctx->next_leader_slot != ULONG_MAX ) ) {
    1592           0 :       ctx->next_leader_tickcount = (long)((double)(ctx->next_leader_slot-ctx->reset_slot-1UL)*ctx->slot_duration_ticks) + fd_tickcount();
    1593           0 :     } else {
    1594           0 :       ctx->next_leader_tickcount = LONG_MAX;
    1595           0 :     }
    1596             : 
    1597           0 :     fd_sched_block_add_done( ctx->sched, bank->data->idx, ULONG_MAX, snapshot_slot );
    1598           0 :     FD_TEST( bank->data->idx==0UL );
    1599             : 
    1600           0 :     fd_runtime_update_leaders( bank, &ctx->runtime_stack );
    1601             : 
    1602           0 :     fd_block_id_ele_t * block_id_ele = &ctx->block_id_arr[ 0 ];
    1603           0 :     block_id_ele->latest_mr      = manifest_block_id;
    1604           0 :     block_id_ele->slot           = snapshot_slot;
    1605           0 :     block_id_ele->block_id_seen  = 1;
    1606           0 :     block_id_ele->latest_fec_idx = 0U;
    1607           0 :     FD_TEST( fd_block_id_map_ele_insert( ctx->block_id_map, block_id_ele, ctx->block_id_arr ) );
    1608             : 
    1609             :     /* We call this after fd_runtime_read_genesis, which sets up the
    1610             :        slot_bank needed in blockstore_init. */
    1611           0 :     init_after_snapshot( ctx );
    1612             : 
    1613           0 :     fd_replay_slot_completed_t * slot_info = fd_chunk_to_laddr( ctx->replay_out->mem, ctx->replay_out->chunk );
    1614           0 :     slot_info->identity_balance = get_identity_balance( ctx, xid );
    1615             : 
    1616           0 :     publish_slot_completed( ctx, stem, bank, 1, 0 /* is_leader */ );
    1617           0 :     publish_root_advanced( ctx, stem );
    1618             : 
    1619           0 :     fd_reasm_fec_t * fec = fd_reasm_insert( ctx->reasm, &manifest_block_id, NULL, snapshot_slot, 0, 0, 0, 0, 1, 0 ); /* FIXME manifest block_id */
    1620           0 :     fec->bank_idx        = bank->data->idx;
    1621           0 :     fec->bank_seq        = bank->data->bank_seq;
    1622           0 :     store_xinsert( ctx->store, &manifest_block_id );
    1623             : 
    1624           0 :     ctx->cluster_type = fd_bank_cluster_type_get( bank );
    1625             : 
    1626           0 :     maybe_verify_cluster_type( ctx );
    1627             : 
    1628           0 :     return;
    1629           0 :   }
    1630             : 
    1631           0 :   switch( msg ) {
    1632           0 :     case FD_SSMSG_MANIFEST_FULL:
    1633           0 :     case FD_SSMSG_MANIFEST_INCREMENTAL: {
    1634             :       /* We may either receive a full snapshot manifest or an
    1635             :          incremental snapshot manifest.  Note that this external message
    1636             :          id is only used temporarily because replay cannot yet receive
    1637             :          the firedancer-internal snapshot manifest message. */
    1638           0 :       if( FD_UNLIKELY( chunk<ctx->in[ in_idx ].chunk0 || chunk>ctx->in[ in_idx ].wmark ) )
    1639           0 :         FD_LOG_ERR(( "chunk %lu from in %d corrupt, not in range [%lu,%lu]", chunk, ctx->in_kind[ in_idx ], ctx->in[ in_idx ].chunk0, ctx->in[ in_idx ].wmark ));
    1640             : 
    1641           0 :       fd_bank_t bank[1];
    1642           0 :       fd_ssload_recover( fd_chunk_to_laddr( ctx->in[ in_idx ].mem, chunk ),
    1643           0 :                          ctx->banks,
    1644           0 :                          fd_banks_bank_query( bank, ctx->banks, FD_REPLAY_BOOT_BANK_IDX ),
    1645           0 :                          &ctx->runtime_stack,
    1646           0 :                          msg==FD_SSMSG_MANIFEST_INCREMENTAL );
    1647             : 
    1648           0 :       fd_snapshot_manifest_t const * manifest = fd_chunk_to_laddr( ctx->in[ in_idx ].mem, chunk );
    1649           0 :       ctx->hard_forks_cnt = manifest->hard_forks_len;
    1650           0 :       for( ulong i=0UL; i<manifest->hard_forks_len; i++ ) {
    1651           0 :         ctx->hard_forks[ i ] = manifest->hard_forks[ i ];
    1652           0 :         ctx->hard_forks_cnts[ i ] = manifest->hard_forks_cnts[ i ];
    1653           0 :       }
    1654           0 :       ctx->has_expected_genesis_timestamp = 1;
    1655           0 :       ctx->expected_genesis_timestamp     = manifest->creation_time_millis;
    1656           0 :       break;
    1657           0 :     }
    1658           0 :     default: {
    1659           0 :       FD_LOG_ERR(( "Received unknown snapshot message with msg %lu", msg ));
    1660           0 :       return;
    1661           0 :     }
    1662           0 :   }
    1663             : 
    1664           0 :   return;
    1665           0 : }
    1666             : 
    1667             : static void
    1668             : dispatch_task( fd_replay_tile_t *  ctx,
    1669             :                fd_stem_context_t * stem,
    1670           0 :                fd_sched_task_t *   task ) {
    1671             : 
    1672           0 :   switch( task->task_type ) {
    1673           0 :     case FD_SCHED_TT_TXN_EXEC: {
    1674           0 :       fd_txn_p_t * txn_p = fd_sched_get_txn( ctx->sched, task->txn_exec->txn_idx );
    1675             : 
    1676           0 :       fd_bank_t bank[1];
    1677           0 :       FD_TEST( fd_banks_bank_query( bank, ctx->banks, task->txn_exec->bank_idx ) );
    1678             : 
    1679           0 : #     if FD_HAS_FLATCC
    1680             :       /* Add the transaction to the block dumper if necessary. This
    1681             :          logic doesn't need to be fork-aware since it's only meant to
    1682             :          be used in backtest. */
    1683           0 :       if( FD_UNLIKELY( ctx->dump_proto_ctx && ctx->dump_proto_ctx->dump_block_to_pb ) ) {
    1684           0 :         fd_dump_block_to_protobuf_collect_tx( ctx->block_dump_ctx, txn_p );
    1685           0 :       }
    1686           0 : #     endif
    1687             : 
    1688           0 :       bank->data->refcnt++;
    1689             : 
    1690           0 :       if( FD_UNLIKELY( !bank->data->first_transaction_scheduled_nanos ) ) bank->data->first_transaction_scheduled_nanos = fd_log_wallclock();
    1691             : 
    1692           0 :       fd_replay_out_link_t *   exec_out = ctx->exec_out;
    1693           0 :       fd_execrp_txn_exec_msg_t * exec_msg = fd_chunk_to_laddr( exec_out->mem, exec_out->chunk );
    1694           0 :       memcpy( exec_msg->txn, txn_p, sizeof(fd_txn_p_t) );
    1695           0 :       exec_msg->bank_idx = task->txn_exec->bank_idx;
    1696           0 :       exec_msg->txn_idx  = task->txn_exec->txn_idx;
    1697           0 :       if( FD_UNLIKELY( ctx->capture_ctx ) ) {
    1698           0 :         exec_msg->capture_txn_idx = ctx->capture_ctx->current_txn_idx++;
    1699           0 :       }
    1700           0 :       fd_stem_publish( stem, exec_out->idx, (FD_EXECRP_TT_TXN_EXEC<<32) | task->txn_exec->exec_idx, exec_out->chunk, sizeof(*exec_msg), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
    1701           0 :       exec_out->chunk = fd_dcache_compact_next( exec_out->chunk, sizeof(*exec_msg), exec_out->chunk0, exec_out->wmark );
    1702           0 :       break;
    1703           0 :     }
    1704           0 :     case FD_SCHED_TT_TXN_SIGVERIFY: {
    1705           0 :       fd_txn_p_t * txn_p = fd_sched_get_txn( ctx->sched, task->txn_sigverify->txn_idx );
    1706             : 
    1707           0 :       fd_bank_t bank[1];
    1708           0 :       FD_TEST( fd_banks_bank_query( bank, ctx->banks, task->txn_sigverify->bank_idx ) );
    1709           0 :       bank->data->refcnt++;
    1710             : 
    1711           0 :       fd_replay_out_link_t *        exec_out = ctx->exec_out;
    1712           0 :       fd_execrp_txn_sigverify_msg_t * exec_msg = fd_chunk_to_laddr( exec_out->mem, exec_out->chunk );
    1713           0 :       memcpy( exec_msg->txn, txn_p, sizeof(fd_txn_p_t) );
    1714           0 :       exec_msg->bank_idx = task->txn_sigverify->bank_idx;
    1715           0 :       exec_msg->txn_idx  = task->txn_sigverify->txn_idx;
    1716           0 :       fd_stem_publish( stem, exec_out->idx, (FD_EXECRP_TT_TXN_SIGVERIFY<<32) | task->txn_sigverify->exec_idx, exec_out->chunk, sizeof(*exec_msg), 0UL, 0UL, 0UL );
    1717           0 :       exec_out->chunk = fd_dcache_compact_next( exec_out->chunk, sizeof(*exec_msg), exec_out->chunk0, exec_out->wmark );
    1718           0 :       break;
    1719           0 :     };
    1720           0 :     case FD_SCHED_TT_POH_HASH: {
    1721           0 :       fd_bank_t bank[ 1 ];
    1722           0 :       FD_TEST( fd_banks_bank_query( bank, ctx->banks, task->poh_hash->bank_idx ) );
    1723           0 :       bank->data->refcnt++;
    1724             : 
    1725           0 :       fd_replay_out_link_t *   exec_out = ctx->exec_out;
    1726           0 :       fd_execrp_poh_hash_msg_t * exec_msg = fd_chunk_to_laddr( exec_out->mem, exec_out->chunk );
    1727           0 :       exec_msg->bank_idx = task->poh_hash->bank_idx;
    1728           0 :       exec_msg->mblk_idx = task->poh_hash->mblk_idx;
    1729           0 :       exec_msg->hashcnt  = task->poh_hash->hashcnt;
    1730           0 :       memcpy( exec_msg->hash, task->poh_hash->hash, sizeof(fd_hash_t) );
    1731           0 :       fd_stem_publish( stem, exec_out->idx, (FD_EXECRP_TT_POH_HASH<<32) | task->poh_hash->exec_idx, exec_out->chunk, sizeof(*exec_msg), 0UL, 0UL, 0UL );
    1732           0 :       exec_out->chunk = fd_dcache_compact_next( exec_out->chunk, sizeof(*exec_msg), exec_out->chunk0, exec_out->wmark );
    1733           0 :       break;
    1734           0 :     };
    1735           0 :     default: {
    1736           0 :       FD_LOG_CRIT(( "unexpected task type %lu", task->task_type ));
    1737           0 :     }
    1738           0 :   }
    1739           0 : }
    1740             : 
    1741             : static void
    1742             : mark_bank_dead( fd_replay_tile_t *  ctx,
    1743             :                 fd_stem_context_t * stem,
    1744           0 :                 ulong               bank_idx ) {
    1745           0 :   fd_bank_t bank[1];
    1746           0 :   FD_TEST( fd_banks_bank_query( bank, ctx->banks, bank_idx ) );
    1747           0 :   fd_banks_mark_bank_dead( ctx->banks, bank_idx );
    1748             : 
    1749           0 :   fd_block_id_ele_t * block_id_ele = &ctx->block_id_arr[ bank_idx ];
    1750           0 :   if( block_id_ele->block_id_seen ) publish_slot_dead( ctx, stem, block_id_ele->slot, &block_id_ele->latest_mr );
    1751             : 
    1752           0 :   fd_reasm_fec_t * fec = fd_reasm_query( ctx->reasm, &block_id_ele->latest_mr );
    1753           0 :   if( FD_UNLIKELY( !fec ) ) return;
    1754           0 :   fec->bank_dead = 1;
    1755             : 
    1756           0 : }
    1757             : 
    1758             : /* Returns 1 if charge_busy. */
    1759             : static int
    1760             : replay( fd_replay_tile_t *  ctx,
    1761           0 :         fd_stem_context_t * stem ) {
    1762             : 
    1763           0 :   if( FD_UNLIKELY( !ctx->is_booted ) ) return 0;
    1764             : 
    1765           0 :   int charge_busy = 0;
    1766           0 :   fd_sched_task_t task[ 1 ];
    1767           0 :   if( FD_UNLIKELY( !fd_sched_task_next_ready( ctx->sched, task ) ) ) {
    1768           0 :     return charge_busy; /* Nothing to execute or do. */
    1769           0 :   }
    1770             : 
    1771           0 :   charge_busy = 1;
    1772             : 
    1773           0 :   switch( task->task_type ) {
    1774           0 :     case FD_SCHED_TT_BLOCK_START: {
    1775           0 :       replay_block_start( ctx, stem, task->block_start->bank_idx, task->block_start->parent_bank_idx, task->block_start->slot );
    1776           0 :       fd_sched_task_done( ctx->sched, FD_SCHED_TT_BLOCK_START, ULONG_MAX, ULONG_MAX, NULL );
    1777           0 :       break;
    1778           0 :     }
    1779           0 :     case FD_SCHED_TT_BLOCK_END: {
    1780           0 :       fd_bank_t bank[1];
    1781           0 :       fd_banks_bank_query( bank, ctx->banks, task->block_end->bank_idx );
    1782           0 :       if( FD_LIKELY( !(bank->data->flags&FD_BANK_FLAGS_DEAD) ) ) replay_block_finalize( ctx, stem, bank );
    1783           0 :       fd_sched_task_done( ctx->sched, FD_SCHED_TT_BLOCK_END, ULONG_MAX, ULONG_MAX, NULL );
    1784           0 :       break;
    1785           0 :     }
    1786           0 :     case FD_SCHED_TT_TXN_EXEC:
    1787           0 :     case FD_SCHED_TT_TXN_SIGVERIFY:
    1788           0 :     case FD_SCHED_TT_POH_HASH: {
    1789             :       /* Common case: we have a transaction we need to execute. */
    1790           0 :       dispatch_task( ctx, stem, task );
    1791           0 :       break;
    1792           0 :     }
    1793           0 :     case FD_SCHED_TT_MARK_DEAD: {
    1794           0 :       fd_bank_t bank[ 1 ];
    1795           0 :       FD_TEST( fd_banks_bank_query( bank, ctx->banks, task->mark_dead->bank_idx ) );
    1796           0 :       mark_bank_dead( ctx, stem, task->mark_dead->bank_idx );
    1797           0 :       break;
    1798           0 :     }
    1799           0 :     default: {
    1800           0 :       FD_LOG_CRIT(( "unexpected task type %lu", task->task_type ));
    1801           0 :     }
    1802           0 :   }
    1803             : 
    1804           0 :   return charge_busy;
    1805           0 : }
    1806             : 
    1807             : static int
    1808             : can_process_fec( fd_replay_tile_t * ctx,
    1809           0 :                  int *              evict_banks_out ) {
    1810           0 :   fd_reasm_fec_t * fec;
    1811           0 :   if( FD_UNLIKELY( fd_sched_can_ingest_cnt( ctx->sched )==0UL ) ) {
    1812           0 :     ctx->metrics.sched_full++;
    1813           0 :     return 0;
    1814           0 :   }
    1815             : 
    1816           0 :   if( FD_UNLIKELY( (fec = fd_reasm_peek( ctx->reasm ))==NULL ) ) {
    1817           0 :     ctx->metrics.reasm_empty++;
    1818           0 :     return 0;
    1819           0 :   }
    1820             : 
    1821           0 :   ctx->metrics.reasm_latest_slot    = fec->slot;
    1822           0 :   ctx->metrics.reasm_latest_fec_idx = fec->fec_set_idx;
    1823             : 
    1824           0 :   if( FD_UNLIKELY( ctx->is_leader && fec->fec_set_idx==0U && fd_reasm_parent( ctx->reasm, fec )->bank_idx==ctx->leader_bank->data->idx ) ) {
    1825             :     /* This guards against a rare race where we receive the FEC set for
    1826             :        the slot right after our leader rotation before we freeze the
    1827             :        bank for the last slot in our leader rotation.  Leader slot
    1828             :        freezing happens only after if we've received the final PoH hash
    1829             :        from the poh tile as well as the final FEC set for the leader
    1830             :        slot.  So the race happens when FEC sets are delivered and
    1831             :        processed sooner than the PoH hash, aka when the
    1832             :        poh=>shred=>replay path for the block id beats the poh=>replay
    1833             :        path for the poh hash.  To mitigate this race, we must block on
    1834             :        ingesting the FEC set for the ensuing slot before the leader
    1835             :        bank freezes, because that would violate ordering invariants in
    1836             :        banks and sched. */
    1837           0 :     FD_TEST( ctx->block_id_arr[ ctx->leader_bank->data->idx ].block_id_seen );
    1838           0 :     FD_TEST( !ctx->recv_poh );
    1839           0 :     ctx->metrics.leader_bid_wait++;
    1840           0 :     return 0;
    1841           0 :   }
    1842             : 
    1843             :   /* If fec_set_idx is 0, we need a new bank for a new slot.  Banks must
    1844             :      not be full in this case. */
    1845           0 :   if( FD_UNLIKELY( fd_banks_is_full( ctx->banks ) && fec->fec_set_idx==0 ) ) {
    1846           0 :     ctx->metrics.banks_full++;
    1847             :     /* We only want to evict banks if sched is drained and banks is no
    1848             :        longer making progress.  Otherwise, sched might not release
    1849             :        refcnts on the frontier/leaf banks immediately, and the eviction
    1850             :        will have to wait for sched to drain anyways. */
    1851           0 :     if( FD_UNLIKELY( fd_sched_is_drained( ctx->sched ) ) ) *evict_banks_out = 1;
    1852           0 :     return 0;
    1853           0 :   }
    1854             : 
    1855             :   /* Otherwise, banks may not be full, so we can always create a new
    1856             :      bank if needed.  Or, if banks are full, the current fec set's
    1857             :      ancestor (idx 0) already created a bank for this slot.*/
    1858           0 :   return 1;
    1859           0 : }
    1860             : 
    1861             : static void
    1862             : insert_fec_set( fd_replay_tile_t *  ctx,
    1863             :                 fd_stem_context_t * stem,
    1864           0 :                 fd_reasm_fec_t *    reasm_fec ) {
    1865             : 
    1866           0 :   long now = fd_log_wallclock();
    1867             : 
    1868           0 :   reasm_fec->parent_bank_idx = fd_reasm_parent( ctx->reasm, reasm_fec )->bank_idx;
    1869             : 
    1870           0 :   fd_bank_t parent_bank[1];
    1871           0 :   FD_TEST( fd_banks_bank_query( parent_bank, ctx->banks, reasm_fec->parent_bank_idx ) );
    1872           0 :   reasm_fec->parent_bank_seq = parent_bank->data->bank_seq;
    1873             : 
    1874           0 :   if( FD_UNLIKELY( reasm_fec->fec_set_idx==0U ) ) {
    1875             :     /* If the first FEC set for a slot is observed, provision a new bank
    1876             :        if you are not the leader.  Remove any stale block id map entry
    1877             :        and update the block id entry. */
    1878           0 :     fd_bank_t   bank_[1];
    1879           0 :     fd_bank_t * bank = NULL;
    1880           0 :     if( FD_UNLIKELY( reasm_fec->is_leader ) ) {
    1881           0 :       bank = ctx->leader_bank;
    1882           0 :     } else {
    1883           0 :       bank = fd_banks_new_bank( bank_, ctx->banks, reasm_fec->parent_bank_idx, now );
    1884           0 :     }
    1885             : 
    1886           0 :     reasm_fec->bank_idx = bank->data->idx;
    1887           0 :     reasm_fec->bank_seq = bank->data->bank_seq;
    1888             : 
    1889             :     /* At this point remove any stale entry in the block id map if it
    1890             :        exists and set the block id as not having been seen yet.  This is
    1891             :        safe because we know that the old entry for this bank index has
    1892             :        already been pruned away. */
    1893           0 :     fd_block_id_ele_t * block_id_ele = &ctx->block_id_arr[ reasm_fec->bank_idx ];
    1894           0 :     if( FD_LIKELY( fd_block_id_map_ele_query( ctx->block_id_map, &block_id_ele->latest_mr, NULL, ctx->block_id_arr )==block_id_ele ) ) {
    1895           0 :       FD_TEST( fd_block_id_map_ele_remove( ctx->block_id_map, &block_id_ele->latest_mr, NULL, ctx->block_id_arr ) );
    1896           0 :     }
    1897           0 :     block_id_ele->block_id_seen  = 0;
    1898           0 :     block_id_ele->slot           = reasm_fec->slot;
    1899           0 :     block_id_ele->latest_fec_idx = 0U;
    1900           0 :     block_id_ele->latest_mr      = reasm_fec->key;
    1901           0 :   } else {
    1902             :     /* We are continuing to execute through a slot that we already have
    1903             :        a bank index for. */
    1904           0 :     reasm_fec->bank_idx = reasm_fec->parent_bank_idx;
    1905           0 :     reasm_fec->bank_seq = reasm_fec->parent_bank_seq;
    1906             : 
    1907           0 :     fd_block_id_ele_t * block_id_ele = &ctx->block_id_arr[ reasm_fec->bank_idx ];
    1908           0 :     if( FD_UNLIKELY( block_id_ele->latest_fec_idx>reasm_fec->fec_set_idx ) ) {
    1909           0 :       FD_LOG_WARNING(( "dropping FEC set (slot=%lu, fec_set_idx=%u) because it is at least as old as the latest FEC set (slot=%lu, fec_set_idx=%u)", reasm_fec->slot, reasm_fec->fec_set_idx, block_id_ele->slot, block_id_ele->latest_fec_idx ));
    1910           0 :       return;
    1911           0 :     }
    1912           0 :     block_id_ele->latest_fec_idx = reasm_fec->fec_set_idx;
    1913           0 :     block_id_ele->latest_mr      = reasm_fec->key;
    1914           0 :   }
    1915             : 
    1916           0 :   if( FD_UNLIKELY( reasm_fec->slot_complete ) ) {
    1917           0 :     fd_block_id_ele_t * block_id_ele = &ctx->block_id_arr[ reasm_fec->bank_idx ];
    1918           0 :     block_id_ele->block_id_seen  = 1;
    1919           0 :     block_id_ele->latest_mr      = reasm_fec->key;
    1920           0 :     block_id_ele->latest_fec_idx = reasm_fec->fec_set_idx;
    1921           0 :     FD_TEST( fd_block_id_map_ele_insert( ctx->block_id_map, block_id_ele, ctx->block_id_arr ) );
    1922           0 :   }
    1923             : 
    1924             :   /* If we are the leader, we don't need to process the FEC set. */
    1925           0 :   if( FD_UNLIKELY( reasm_fec->is_leader ) ) return;
    1926             : 
    1927             :   /* Forks form a partial ordering over FEC sets. The Repair tile
    1928             :       delivers FEC sets in-order per fork, but FEC set ordering across
    1929             :       forks is arbitrary */
    1930           0 :   fd_sched_fec_t sched_fec[ 1 ];
    1931             : 
    1932             : # if DEBUG_LOGGING
    1933             :   FD_BASE58_ENCODE_32_BYTES( reasm_fec->key.key, key_b58 );
    1934             :   FD_BASE58_ENCODE_32_BYTES( reasm_fec->cmr.key, cmr_b58 );
    1935             :   FD_LOG_INFO(( "replay processing FEC set for slot %lu fec_set_idx %u, mr %s cmr %s", reasm_fec->slot, reasm_fec->fec_set_idx, key_b58, cmr_b58 ));
    1936             : # endif
    1937             : 
    1938           0 :   sched_fec->shred_cnt              = reasm_fec->data_cnt;
    1939           0 :   sched_fec->is_last_in_batch       = !!reasm_fec->data_complete;
    1940           0 :   sched_fec->is_last_in_block       = !!reasm_fec->slot_complete;
    1941           0 :   sched_fec->bank_idx               = reasm_fec->bank_idx;
    1942           0 :   sched_fec->parent_bank_idx        = reasm_fec->parent_bank_idx;
    1943           0 :   sched_fec->slot                   = reasm_fec->slot;
    1944           0 :   sched_fec->parent_slot            = reasm_fec->slot - reasm_fec->parent_off;
    1945           0 :   sched_fec->is_first_in_block      = reasm_fec->fec_set_idx==0U;
    1946           0 :   fd_funk_txn_xid_t const root = fd_accdb_root_get( ctx->accdb_admin );
    1947           0 :   fd_funk_txn_xid_copy( sched_fec->alut_ctx->xid, &root );
    1948           0 :   sched_fec->alut_ctx->accdb[0]     = ctx->accdb[0];
    1949           0 :   sched_fec->alut_ctx->els          = ctx->published_root_slot;
    1950             : 
    1951           0 :   fd_bank_t bank[1];
    1952           0 :   FD_TEST( fd_banks_bank_query( bank, ctx->banks, sched_fec->bank_idx ) );
    1953           0 :   if( sched_fec->is_first_in_block ) {
    1954           0 :     bank->data->refcnt++;
    1955           0 :     FD_LOG_DEBUG(( "bank (idx=%lu, slot=%lu) refcnt incremented to %lu for sched", bank->data->idx, sched_fec->slot, bank->data->refcnt ));
    1956           0 :   }
    1957             : 
    1958             :   /* Read FEC set from the store.  This should happen before we try to
    1959             :      ingest the FEC set.  This allows us to filter out frags that were
    1960             :      in-flight when we published away minority forks that the frags land
    1961             :      on.  These frags would have no bank to execute against, because
    1962             :      their corresponding banks, or parent banks, have also been pruned
    1963             :      during publishing.  A query against store will rightfully tell us
    1964             :      that the underlying data is not found, implying that this is for a
    1965             :      minority fork that we can safeljy ignore. */
    1966             : 
    1967           0 :   ulong wait = (ulong)fd_log_wallclock();
    1968           0 :   ulong work = wait;
    1969           0 :   FD_STORE_SLOCK_BEGIN( ctx->store ) {
    1970           0 :     ctx->metrics.store_query_acquire++;
    1971           0 :     work = (ulong)fd_log_wallclock();
    1972           0 :     fd_histf_sample( ctx->metrics.store_query_wait, work - wait );
    1973             : 
    1974           0 :     fd_store_fec_t * store_fec = fd_store_query( ctx->store, &reasm_fec->key );
    1975           0 :     ctx->metrics.store_query_cnt++;
    1976           0 :     if( FD_UNLIKELY( !store_fec ) ) {
    1977             : 
    1978             :       /* The only case in which a FEC is not found in the store after
    1979             :          repair has notified is if the FEC was on a minority fork that
    1980             :          has already been published away.  In this case we abandon the
    1981             :          entire slice because it is no longer relevant.  */
    1982             : 
    1983           0 :       ctx->metrics.store_query_missing_cnt++;
    1984           0 :       ctx->metrics.store_query_missing_mr = reasm_fec->key.ul[0];
    1985           0 :       FD_BASE58_ENCODE_32_BYTES( reasm_fec->key.key, key_b58 );
    1986           0 :       FD_LOG_WARNING(( "store fec for slot: %lu is on minority fork already pruned by publish. abandoning slice. root: %lu. pruned merkle: %s", reasm_fec->slot, ctx->consensus_root_slot, key_b58 ));
    1987           0 :       return;
    1988           0 :     }
    1989           0 :     sched_fec->fec = store_fec;
    1990           0 :     if( FD_UNLIKELY( !fd_sched_fec_ingest( ctx->sched, sched_fec ) ) ) { /* FIXME this critical section is unnecessarily complex. should refactor to just be held for the memcpy and block_offs. */
    1991           0 :       mark_bank_dead( ctx, stem, sched_fec->bank_idx );
    1992           0 :     }
    1993           0 :   } FD_STORE_SLOCK_END;
    1994             : 
    1995           0 :   ctx->metrics.store_query_release++;
    1996           0 :   fd_histf_sample( ctx->metrics.store_query_work, (ulong)fd_log_wallclock() - work );
    1997           0 : }
    1998             : 
    1999             : static void
    2000             : process_fec_set( fd_replay_tile_t *  ctx,
    2001             :                  fd_stem_context_t * stem,
    2002           0 :                  fd_reasm_fec_t *    reasm_fec ) {
    2003             : 
    2004           0 :   fd_reasm_fec_t * parent = fd_reasm_parent( ctx->reasm, reasm_fec );
    2005           0 :   if( FD_UNLIKELY( !parent ) ) {
    2006           0 :     FD_LOG_WARNING(( "dropping FEC set (slot=%lu, fec_set_idx=%u) because it is unconnected in reasm", reasm_fec->slot, reasm_fec->fec_set_idx ));
    2007           0 :     return;
    2008           0 :   }
    2009             : 
    2010           0 :   if( FD_UNLIKELY( parent->bank_dead ) ) {
    2011             :     /* Inherit the dead flag from the parent.  If a dead slot is
    2012             :        completed, we publish the slot as dead.  Don't insert FECs for
    2013             :        dead slots. */
    2014           0 :     reasm_fec->bank_dead = 1;
    2015           0 :     if( FD_UNLIKELY( reasm_fec->slot_complete ) ) publish_slot_dead( ctx, stem, reasm_fec->slot, &reasm_fec->key );
    2016           0 :     FD_LOG_DEBUG(( "dropping FEC set (slot=%lu, fec_set_idx=%u) because parent bank is marked dead", reasm_fec->slot, reasm_fec->fec_set_idx ));
    2017           0 :     return;
    2018           0 :   }
    2019             : 
    2020             :   /* Standard case, the parent FEC has a valid corresponding bank. */
    2021           0 :   fd_bank_t parent_fec_bank[1];
    2022           0 :   if( FD_LIKELY( fd_banks_bank_query( parent_fec_bank, ctx->banks, parent->bank_idx ) &&
    2023           0 :                  parent_fec_bank->data->bank_seq==parent->bank_seq ) ) {
    2024           0 :     insert_fec_set( ctx, stem, reasm_fec );
    2025           0 :     return;
    2026           0 :   }
    2027             : 
    2028             :   /* In the case the FEC doesn't directly connect, iterate up the reasm
    2029             :      tree to find the closest valid slot complete that corresponds to a
    2030             :      valid bank. */
    2031             : 
    2032             :   /* First keep track of all of the slot completes up to and including
    2033             :      the fec we want to insert off of. */
    2034           0 :   fd_reasm_fec_t * path[ FD_BANKS_MAX_BANKS ];
    2035           0 :   ulong            path_cnt = 0UL;
    2036           0 :   path[ path_cnt++ ] = reasm_fec;
    2037             : 
    2038           0 :   for( fd_reasm_fec_t * curr = reasm_fec;; ) {
    2039           0 :     curr = fd_reasm_parent( ctx->reasm, curr );
    2040           0 :     if( FD_UNLIKELY( !curr ) ) return; /* If can't connect, drop the FEC. */
    2041           0 :     if( FD_LIKELY( !curr->slot_complete ) ) continue;
    2042             : 
    2043           0 :     FD_TEST( path_cnt<=FD_BANKS_MAX_BANKS );
    2044           0 :     path[ path_cnt++ ] = curr;
    2045             : 
    2046           0 :     fd_bank_t curr_bank[1];
    2047           0 :     if( FD_LIKELY( fd_banks_bank_query( curr_bank, ctx->banks, curr->bank_idx ) && curr_bank->data->bank_seq==curr->bank_seq ) ) break;
    2048           0 :   }
    2049             : 
    2050           0 :   for( ulong i=path_cnt; i>0UL; i-- ) {
    2051           0 :     fd_reasm_fec_t * slot_fecs[ FD_SHRED_BLK_MAX/32 ]; /* TODO: replace with fix-32 macro. */
    2052           0 :     fd_reasm_fec_t * leaf = path[ i-1 ];
    2053             : 
    2054             :     /* If there's not capacity in the sched or banks, return early and
    2055             :        drop the FEC.  We have inserted as much as we can for now. */
    2056           0 :     if( FD_UNLIKELY( fd_sched_can_ingest_cnt( ctx->sched )<leaf->fec_set_idx ) ) return;
    2057           0 :     if( FD_UNLIKELY( fd_banks_is_full( ctx->banks ) ) ) return;
    2058             : 
    2059             :     /* Gather all FECs for this slot; */
    2060           0 :     fd_reasm_fec_t * curr = leaf;
    2061           0 :     for(;;) {
    2062           0 :       slot_fecs[ curr->fec_set_idx ] = curr;
    2063           0 :       if( curr->fec_set_idx==0U ) break;
    2064           0 :       curr = fd_reasm_parent( ctx->reasm, curr );
    2065           0 :       FD_TEST( curr );
    2066           0 :     }
    2067             : 
    2068           0 :     for( ulong j=0UL; j<=leaf->fec_set_idx; j++ ) {
    2069           0 :       insert_fec_set( ctx, stem, slot_fecs[ j ] );
    2070           0 :     }
    2071           0 :   }
    2072           0 : }
    2073             : 
    2074             : /* accdb_advance_root moves account records from the unrooted to the
    2075             :    rooted database. */
    2076             : 
    2077             : static inline ulong
    2078           0 : accdb_root_op_total( fd_replay_tile_t const * ctx ) {
    2079           0 :   return ctx->accdb_admin->base.root_cnt +
    2080           0 :          ctx->accdb_admin->base.reclaim_cnt;
    2081           0 : }
    2082             : 
    2083             : static void
    2084             : accdb_advance_root( fd_replay_tile_t * ctx,
    2085             :                     ulong              slot,
    2086           0 :                     ulong              bank_idx ) {
    2087           0 :   fd_funk_txn_xid_t xid = { .ul[0] = slot, .ul[1] = bank_idx };
    2088           0 :   FD_LOG_DEBUG(( "advancing root to slot=%lu", slot ));
    2089             : 
    2090           0 :   long rooted_accounts   = -(long)accdb_root_op_total( ctx );
    2091           0 :   long root_accounts_dt  = -fd_tickcount();
    2092           0 :   fd_accdb_advance_root( ctx->accdb_admin, &xid );
    2093           0 :   rooted_accounts       += (long)accdb_root_op_total( ctx );
    2094           0 :   root_accounts_dt      += fd_tickcount();
    2095           0 :   fd_histf_sample( ctx->metrics.root_slot_dur,    (ulong)root_accounts_dt );
    2096           0 :   fd_histf_sample( ctx->metrics.root_account_dur, (ulong)root_accounts_dt / (ulong)fd_long_max( rooted_accounts, 1L ) );
    2097             : 
    2098           0 :   fd_progcache_txn_advance_root( ctx->progcache_admin, &xid );
    2099           0 : }
    2100             : 
    2101             : static int
    2102           0 : advance_published_root( fd_replay_tile_t * ctx ) {
    2103             : 
    2104           0 :   fd_block_id_ele_t * block_id_ele = fd_block_id_map_ele_query( ctx->block_id_map, &ctx->consensus_root, NULL, ctx->block_id_arr );
    2105           0 :   if( FD_UNLIKELY( !block_id_ele ) ) {
    2106           0 :     FD_BASE58_ENCODE_32_BYTES( ctx->consensus_root.key, consensus_root_b58 );
    2107           0 :     FD_LOG_CRIT(( "invariant violation: block id ele not found for consensus root %s", consensus_root_b58 ));
    2108           0 :   }
    2109           0 :   ulong target_bank_idx = fd_block_id_ele_get_idx( ctx->block_id_arr, block_id_ele );
    2110             : 
    2111             :   /* If the identity vote has been seen on a bank that should be rooted,
    2112             :      then we are now ready to produce blocks. */
    2113           0 :   if( FD_UNLIKELY( !ctx->identity_vote_rooted ) ) {
    2114           0 :     fd_bank_t root_bank[1];
    2115           0 :     if( FD_UNLIKELY( !fd_banks_bank_query( root_bank, ctx->banks, target_bank_idx ) ) ) FD_LOG_CRIT(( "invariant violation: root bank not found for bank index %lu", target_bank_idx ));
    2116           0 :     if( fd_bank_identity_vote_idx_get( root_bank )==ctx->identity_idx ) ctx->identity_vote_rooted = 1;
    2117           0 :   }
    2118             : 
    2119           0 :   ulong advanceable_root_idx = ULONG_MAX;
    2120           0 :   if( FD_UNLIKELY( !fd_banks_advance_root_prepare( ctx->banks, target_bank_idx, &advanceable_root_idx ) ) ) {
    2121           0 :     ctx->metrics.storage_root_behind++;
    2122           0 :     return 0;
    2123           0 :   }
    2124             : 
    2125           0 :   fd_bank_t bank[1];
    2126           0 :   FD_TEST( fd_banks_bank_query( bank, ctx->banks, advanceable_root_idx ) );
    2127             : 
    2128           0 :   if( FD_UNLIKELY( advanceable_root_idx >= ctx->block_id_len ) ) {
    2129           0 :     FD_LOG_CRIT(( "invariant violation: advanceable root ele out of bounds [0, %lu) index %lu", ctx->block_id_len, advanceable_root_idx ));
    2130           0 :   }
    2131           0 :   fd_block_id_ele_t * advanceable_root_ele = &ctx->block_id_arr[ advanceable_root_idx ];
    2132             : 
    2133           0 :   ulong advanceable_root_slot = fd_bank_slot_get( bank );
    2134           0 :   accdb_advance_root( ctx, advanceable_root_slot, bank->data->idx );
    2135             : 
    2136           0 :   fd_txncache_advance_root( ctx->txncache, bank->data->txncache_fork_id );
    2137           0 :   fd_sched_advance_root( ctx->sched, advanceable_root_idx );
    2138           0 :   fd_banks_advance_root( ctx->banks, advanceable_root_idx );
    2139             : 
    2140             :   /* Set metrics pointers. */
    2141             : 
    2142             : 
    2143             :   /* Reasm also prunes from the store during its publish. */
    2144             : 
    2145           0 :   fd_reasm_publish( ctx->reasm, &advanceable_root_ele->latest_mr, ctx->store );
    2146             : 
    2147           0 :   ctx->published_root_slot     = advanceable_root_slot;
    2148           0 :   ctx->published_root_bank_idx = advanceable_root_idx;
    2149             : 
    2150           0 :   return 1;
    2151           0 : }
    2152             : 
    2153             : static void
    2154             : after_credit( fd_replay_tile_t *  ctx,
    2155             :               fd_stem_context_t * stem,
    2156             :               int *               opt_poll_in,
    2157           0 :               int *               charge_busy ) {
    2158           0 :   if( FD_UNLIKELY( !ctx->is_booted || !ctx->wfs_complete ) ) return;
    2159             : 
    2160           0 :   if( FD_UNLIKELY( maybe_become_leader( ctx, stem ) ) ) {
    2161           0 :     *charge_busy = 1;
    2162           0 :     *opt_poll_in = 0;
    2163           0 :     return;
    2164           0 :   }
    2165             : 
    2166             :   /* If we are leader, we can only unbecome the leader iff we have
    2167             :      received the poh hash from the poh tile and block id from reasm.
    2168             :      We have to do an additional check against the slot of the leader
    2169             :      bank because we lazily remove entries from the block id arr. */
    2170           0 :   if( FD_UNLIKELY( ctx->is_leader &&
    2171           0 :                    ctx->recv_poh &&
    2172           0 :                    ctx->block_id_arr[ ctx->leader_bank->data->idx ].block_id_seen &&
    2173           0 :                    ctx->block_id_arr[ ctx->leader_bank->data->idx ].slot==fd_bank_slot_get( ctx->leader_bank ) ) ) {
    2174             : 
    2175           0 :     fini_leader_bank( ctx, stem );
    2176           0 :     *charge_busy = 1;
    2177           0 :     *opt_poll_in = 0;
    2178           0 :     return;
    2179           0 :   }
    2180             : 
    2181           0 :   ulong bank_idx;
    2182           0 :   while( (bank_idx=fd_sched_pruned_block_next( ctx->sched ))!=ULONG_MAX ) {
    2183           0 :     fd_bank_t bank[1];
    2184           0 :     FD_TEST( fd_banks_bank_query( bank, ctx->banks, bank_idx ) );
    2185           0 :     bank->data->refcnt--;
    2186           0 :     FD_LOG_DEBUG(( "bank (idx=%lu) refcnt decremented to %lu for sched", bank->data->idx, bank->data->refcnt ));
    2187           0 :   }
    2188             : 
    2189             :   /* If the published_root is not caught up to the consensus root, then
    2190             :      we should try to advance the published root. */
    2191           0 :   if( FD_UNLIKELY( ctx->consensus_root_bank_idx!=ctx->published_root_bank_idx && advance_published_root( ctx ) ) ) {
    2192           0 :     *charge_busy = 1;
    2193           0 :     *opt_poll_in = 0;
    2194           0 :     return;
    2195           0 :   }
    2196             : 
    2197           0 :   if( FD_UNLIKELY( fd_banks_prune_dead_banks( ctx->banks ) ) ) {
    2198             :     // FIXME: anything pruned from banks should also be pruned from txncache and accdb
    2199           0 :     *charge_busy = 1;
    2200           0 :     *opt_poll_in = 0;
    2201           0 :     return;
    2202           0 :   }
    2203             : 
    2204             :   /* If the reassembler has a fec that is ready, we should process it
    2205             :      and pass it to the scheduler. */
    2206           0 :   int evict_banks = 0;
    2207           0 :   if( FD_LIKELY( can_process_fec( ctx, &evict_banks ) ) ) {
    2208           0 :     fd_reasm_fec_t * fec = fd_reasm_pop( ctx->reasm );
    2209           0 :     process_fec_set( ctx, stem, fec );
    2210           0 :     *charge_busy = 1;
    2211           0 :     *opt_poll_in = 0;
    2212           0 :     return;
    2213           0 :   }
    2214             : 
    2215           0 :   if( FD_UNLIKELY( evict_banks ) ) {
    2216           0 :     FD_LOG_WARNING(( "banks are full and partially executed frontier banks are being evicted" ));
    2217           0 :     ulong frontier_cnt = 0UL;
    2218           0 :     ulong frontier_indices[ FD_BANKS_MAX_BANKS ];
    2219           0 :     fd_banks_get_frontier( ctx->banks, frontier_indices, &frontier_cnt );
    2220             : 
    2221             :     /* Mark all frontier banks as dead.  As refcnts on said banks are
    2222             :        drained, they will be pruned away. */
    2223           0 :     for( ulong i=0UL; i<frontier_cnt; i++ ) {
    2224           0 :       fd_bank_t bank[1];
    2225           0 :       FD_TEST( fd_banks_bank_query( bank, ctx->banks, frontier_indices[i] ) );
    2226           0 :       if( FD_UNLIKELY( ctx->is_leader && frontier_indices[i]==ctx->leader_bank->data->idx ) ) continue;
    2227           0 :       mark_bank_dead( ctx, stem, bank->data->idx );
    2228           0 :       fd_sched_block_abandon( ctx->sched, bank->data->idx );
    2229           0 :     }
    2230           0 :   }
    2231             : 
    2232           0 :   *charge_busy = replay( ctx, stem );
    2233           0 :   *opt_poll_in = !*charge_busy;
    2234           0 : }
    2235             : 
    2236             : static int
    2237             : before_frag( fd_replay_tile_t * ctx,
    2238             :              ulong              in_idx,
    2239             :              ulong              seq FD_PARAM_UNUSED,
    2240           0 :              ulong              sig ) {
    2241             : 
    2242           0 :   if( FD_UNLIKELY( ctx->in_kind[ in_idx ]==IN_KIND_SHRED ) ) {
    2243             :     /* If reasm is full, we can not insert any more FEC sets.  We must
    2244             :        not consume any frags from shred_out until reasm can process more
    2245             :        FEC sets. */
    2246             : 
    2247           0 :     if( FD_UNLIKELY( !fd_reasm_free( ctx->reasm ) ) ) {
    2248           0 :       return -1;
    2249           0 :     }
    2250           0 :   }
    2251             : 
    2252           0 :   if( FD_UNLIKELY( ctx->in_kind[ in_idx ]==IN_KIND_GOSSIP_OUT && sig!=FD_GOSSIP_UPDATE_TAG_WFS_DONE ) ) return 1;
    2253           0 :   return 0;
    2254           0 : }
    2255             : 
    2256             : static void
    2257             : process_exec_task_done( fd_replay_tile_t *          ctx,
    2258             :                         fd_stem_context_t *         stem,
    2259             :                         fd_execrp_task_done_msg_t * msg,
    2260           0 :                         ulong                       sig ) {
    2261             : 
    2262           0 :   ulong exec_tile_idx = sig&0xFFFFFFFFUL;
    2263             : 
    2264           0 :   fd_bank_t bank[1];
    2265           0 :   FD_TEST( fd_banks_bank_query( bank, ctx->banks, msg->bank_idx ) );
    2266           0 :   FD_TEST( bank->data );
    2267           0 :   bank->data->refcnt--;
    2268             : 
    2269           0 :   switch( sig>>32 ) {
    2270           0 :     case FD_EXECRP_TT_TXN_EXEC: {
    2271           0 :       if( FD_UNLIKELY( !ctx->identity_vote_rooted ) ) {
    2272             :         /* Query the txn signature against our recently generated vote
    2273             :            txn signatures.  If the query is successful, then we have
    2274             :            seen our own vote transaction land and this should be marked
    2275             :            in the bank.  We go through this exercise until we've seen
    2276             :            our vote rooted. */
    2277           0 :         fd_txn_p_t * txn_p = fd_sched_get_txn( ctx->sched, msg->txn_exec->txn_idx );
    2278             : 
    2279           0 :         fd_pubkey_t * identity_pubkey_out = NULL;
    2280           0 :         if( fd_vote_tracker_query_sig( ctx->vote_tracker, fd_type_pun_const( txn_p->payload+TXN( txn_p )->signature_off ), &identity_pubkey_out ) && fd_pubkey_eq( identity_pubkey_out, ctx->identity_pubkey ) ) {
    2281           0 :           fd_bank_identity_vote_idx_set( bank, ctx->identity_idx );
    2282           0 :         }
    2283           0 :       }
    2284           0 :       if( FD_UNLIKELY( !msg->txn_exec->is_committable && !(bank->data->flags&FD_BANK_FLAGS_DEAD) ) ) {
    2285             :         /* Every transaction in a valid block has to execute.
    2286             :            Otherwise, we should mark the block as dead. */
    2287           0 :         mark_bank_dead( ctx, stem, bank->data->idx );
    2288           0 :         fd_sched_block_abandon( ctx->sched, bank->data->idx );
    2289           0 :       }
    2290           0 :       if( FD_UNLIKELY( (bank->data->flags&FD_BANK_FLAGS_DEAD) && bank->data->refcnt==0UL ) ) {
    2291           0 :         fd_banks_mark_bank_frozen( ctx->banks, bank );
    2292           0 :       }
    2293           0 :       int res = fd_sched_task_done( ctx->sched, FD_SCHED_TT_TXN_EXEC, msg->txn_exec->txn_idx, exec_tile_idx, NULL );
    2294           0 :       FD_TEST( res==0 );
    2295           0 :       fd_sched_txn_info_t * txn_info = fd_sched_get_txn_info( ctx->sched, msg->txn_exec->txn_idx );
    2296           0 :       txn_info->flags |= FD_SCHED_TXN_EXEC_DONE;
    2297           0 :       if( FD_LIKELY( !(txn_info->flags&FD_SCHED_TXN_SIGVERIFY_DONE)||!txn_info->txn_err ) ) { /* Set execution status if sigverify hasn't happened yet or if sigverify was a success. */
    2298           0 :         txn_info->txn_err = msg->txn_exec->txn_err;
    2299           0 :         txn_info->flags  |= fd_ulong_if( msg->txn_exec->is_committable, FD_SCHED_TXN_IS_COMMITTABLE, 0UL );
    2300           0 :         txn_info->flags  |= fd_ulong_if( msg->txn_exec->is_fees_only,   FD_SCHED_TXN_IS_FEES_ONLY,   0UL );
    2301           0 :       }
    2302           0 :       if( FD_UNLIKELY( (txn_info->flags&FD_SCHED_TXN_REPLAY_DONE)==FD_SCHED_TXN_REPLAY_DONE ) ) { /* UNLIKELY because generally exec happens before sigverify. */
    2303           0 :         publish_txn_executed( ctx, stem, msg->txn_exec->txn_idx );
    2304           0 :       }
    2305           0 :       break;
    2306           0 :     }
    2307           0 :     case FD_EXECRP_TT_TXN_SIGVERIFY: {
    2308           0 :       fd_sched_txn_info_t * txn_info = fd_sched_get_txn_info( ctx->sched, msg->txn_sigverify->txn_idx );
    2309           0 :       txn_info->flags |= FD_SCHED_TXN_SIGVERIFY_DONE;
    2310           0 :       if( FD_UNLIKELY( msg->txn_sigverify->err ) ) {
    2311           0 :         txn_info->txn_err = FD_RUNTIME_TXN_ERR_SIGNATURE_FAILURE;
    2312           0 :         txn_info->flags  &= ~FD_SCHED_TXN_IS_COMMITTABLE;
    2313           0 :         txn_info->flags  &= ~FD_SCHED_TXN_IS_FEES_ONLY;
    2314           0 :       }
    2315           0 :       if( FD_UNLIKELY( msg->txn_sigverify->err && !(bank->data->flags&FD_BANK_FLAGS_DEAD) ) ) {
    2316             :         /* Every transaction in a valid block has to sigverify.
    2317             :            Otherwise, we should mark the block as dead.  Also freeze the
    2318             :            bank if possible. */
    2319           0 :         mark_bank_dead( ctx, stem, bank->data->idx );
    2320           0 :         fd_sched_block_abandon( ctx->sched, bank->data->idx );
    2321           0 :       }
    2322           0 :       if( FD_UNLIKELY( (bank->data->flags&FD_BANK_FLAGS_DEAD) && bank->data->refcnt==0UL ) ) {
    2323           0 :         fd_banks_mark_bank_frozen( ctx->banks, bank );
    2324           0 :       }
    2325           0 :       int res = fd_sched_task_done( ctx->sched, FD_SCHED_TT_TXN_SIGVERIFY, msg->txn_sigverify->txn_idx, exec_tile_idx, NULL );
    2326           0 :       FD_TEST( res==0 );
    2327           0 :       if( FD_LIKELY( (txn_info->flags&FD_SCHED_TXN_REPLAY_DONE)==FD_SCHED_TXN_REPLAY_DONE ) ) {
    2328           0 :         publish_txn_executed( ctx, stem, msg->txn_exec->txn_idx );
    2329           0 :       }
    2330           0 :       break;
    2331           0 :     }
    2332           0 :     case FD_EXECRP_TT_POH_HASH: {
    2333           0 :       int res = fd_sched_task_done( ctx->sched, FD_SCHED_TT_POH_HASH, ULONG_MAX, exec_tile_idx, msg->poh_hash );
    2334           0 :       if( FD_UNLIKELY( res<0 && !(bank->data->flags&FD_BANK_FLAGS_DEAD) ) ) {
    2335           0 :         mark_bank_dead( ctx, stem, bank->data->idx );
    2336           0 :       }
    2337           0 :       if( FD_UNLIKELY( (bank->data->flags&FD_BANK_FLAGS_DEAD) && bank->data->refcnt==0UL ) ) {
    2338           0 :         fd_banks_mark_bank_frozen( ctx->banks, bank );
    2339           0 :       }
    2340           0 :       break;
    2341           0 :     }
    2342           0 :     default: FD_LOG_CRIT(( "unexpected sig 0x%lx", sig ));
    2343           0 :   }
    2344             : 
    2345             :   /* Reference counter just decreased, and an exec tile just got freed
    2346             :      up.  If there's a need to be more aggressively pruning, we could
    2347             :      check here if more slots just became publishable and publish.  Not
    2348             :      publishing here shouldn't bloat the fork tree too much though.  We
    2349             :      mark minority forks dead as soon as we can, and execution dispatch
    2350             :      stops on dead blocks.  So shortly afterwards, dead blocks should be
    2351             :      eligible for pruning as in-flight transactions retire from the
    2352             :      execution pipeline. */
    2353             : 
    2354           0 : }
    2355             : 
    2356             : static void
    2357             : process_tower_slot_done( fd_replay_tile_t *           ctx,
    2358             :                          fd_stem_context_t *          stem,
    2359             :                          fd_tower_slot_done_t const * msg,
    2360           0 :                          ulong                        seq ) {
    2361           0 :   fd_bank_t replay_bank[1];
    2362           0 :   if( FD_UNLIKELY( !fd_banks_bank_query( replay_bank, ctx->banks, msg->replay_bank_idx ) ) ) FD_LOG_CRIT(( "invariant violation: bank not found for bank index %lu", msg->replay_bank_idx ));
    2363           0 :   replay_bank->data->refcnt--;
    2364           0 :   FD_LOG_DEBUG(( "bank (idx=%lu, slot=%lu) refcnt decremented to %lu for tower", replay_bank->data->idx, msg->replay_slot, replay_bank->data->refcnt ));
    2365             : 
    2366           0 :   ctx->reset_block_id = msg->reset_block_id;
    2367           0 :   ctx->reset_slot     = msg->reset_slot;
    2368           0 :   ctx->reset_timestamp_nanos = fd_log_wallclock();
    2369           0 :   ulong min_leader_slot = fd_ulong_max( msg->reset_slot+1UL, fd_ulong_if( ctx->highwater_leader_slot==ULONG_MAX, 0UL, ctx->highwater_leader_slot+1UL ) );
    2370           0 :   ctx->next_leader_slot = fd_multi_epoch_leaders_get_next_slot( ctx->mleaders, min_leader_slot, ctx->identity_pubkey );
    2371           0 :   if( FD_LIKELY( ctx->next_leader_slot != ULONG_MAX ) ) {
    2372           0 :     ctx->next_leader_tickcount = (long)((double)(ctx->next_leader_slot-ctx->reset_slot-1UL)*ctx->slot_duration_ticks) + fd_tickcount();
    2373           0 :   } else {
    2374           0 :     ctx->next_leader_tickcount = LONG_MAX;
    2375           0 :   }
    2376             : 
    2377           0 :   fd_block_id_ele_t * block_id_ele = fd_block_id_map_ele_query( ctx->block_id_map, &msg->reset_block_id, NULL, ctx->block_id_arr );
    2378           0 :   if( FD_UNLIKELY( !block_id_ele ) ) {
    2379           0 :     FD_BASE58_ENCODE_32_BYTES( msg->reset_block_id.key, reset_block_id_b58 );
    2380           0 :     FD_LOG_CRIT(( "invariant violation: block id ele doesn't exist for reset block id: %s, slot: %lu", reset_block_id_b58, msg->reset_slot ));
    2381           0 :   }
    2382           0 :   ulong reset_bank_idx = fd_block_id_ele_get_idx( ctx->block_id_arr, block_id_ele );
    2383             : 
    2384           0 :   fd_bank_t bank[1];
    2385           0 :   if( FD_UNLIKELY( !fd_banks_bank_query( bank, ctx->banks, reset_bank_idx ) ) ) {
    2386           0 :     FD_LOG_CRIT(( "invariant violation: bank not found for bank index %lu", reset_bank_idx ));
    2387           0 :   }
    2388             : 
    2389           0 :   if( FD_LIKELY( msg->root_slot!=ULONG_MAX ) ) FD_TEST( msg->root_slot<=msg->reset_slot );
    2390           0 :   fd_memcpy( ctx->reset_bank, bank, sizeof(fd_bank_t) );
    2391             : 
    2392           0 :   if( FD_LIKELY( ctx->replay_out->idx!=ULONG_MAX ) ) {
    2393           0 :     fd_poh_reset_t * reset = fd_chunk_to_laddr( ctx->replay_out->mem, ctx->replay_out->chunk );
    2394             : 
    2395           0 :     reset->bank_idx = bank->data->idx;
    2396           0 :     reset->timestamp = ctx->reset_timestamp_nanos;
    2397           0 :     reset->completed_slot = ctx->reset_slot;
    2398           0 :     reset->hashcnt_per_tick = fd_bank_hashes_per_tick_get( bank );
    2399           0 :     reset->ticks_per_slot = fd_bank_ticks_per_slot_get( bank );
    2400           0 :     reset->tick_duration_ns = (ulong)(ctx->slot_duration_nanos/(double)reset->ticks_per_slot);
    2401             : 
    2402           0 :     fd_memcpy( reset->completed_block_id, &block_id_ele->latest_mr, sizeof(fd_hash_t) );
    2403             : 
    2404           0 :     fd_blockhashes_t const * block_hash_queue = fd_bank_block_hash_queue_query( bank );
    2405           0 :     fd_hash_t const * last_hash = fd_blockhashes_peek_last_hash( block_hash_queue );
    2406           0 :     FD_TEST( last_hash );
    2407           0 :     fd_memcpy( reset->completed_blockhash, last_hash->uc, sizeof(fd_hash_t) );
    2408             : 
    2409           0 :     ulong ticks_per_slot = fd_bank_ticks_per_slot_get( bank );
    2410           0 :     if( FD_UNLIKELY( reset->hashcnt_per_tick==1UL ) ) {
    2411             :       /* Low power producer, maximum of one microblock per tick in the slot */
    2412           0 :       reset->max_microblocks_in_slot = ticks_per_slot;
    2413           0 :     } else {
    2414             :       /* See the long comment in after_credit for this limit */
    2415           0 :       reset->max_microblocks_in_slot = fd_ulong_min( MAX_MICROBLOCKS_PER_SLOT, ticks_per_slot*(reset->hashcnt_per_tick-1UL) );
    2416           0 :     }
    2417           0 :     reset->next_leader_slot = ctx->next_leader_slot;
    2418             : 
    2419           0 :     fd_stem_publish( stem, ctx->replay_out->idx, REPLAY_SIG_RESET, ctx->replay_out->chunk, sizeof(fd_poh_reset_t), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
    2420           0 :     ctx->replay_out->chunk = fd_dcache_compact_next( ctx->replay_out->chunk, sizeof(fd_poh_reset_t), ctx->replay_out->chunk0, ctx->replay_out->wmark );
    2421           0 :   }
    2422             : 
    2423           0 :   FD_LOG_INFO(( "tower_slot_done(reset_slot=%lu, next_leader_slot=%lu, vote_slot=%lu, replay_slot=%lu, root_slot=%lu, seqno=%lu)", msg->reset_slot, ctx->next_leader_slot, msg->vote_slot, msg->replay_slot, msg->root_slot, seq ));
    2424           0 :   maybe_become_leader( ctx, stem );
    2425             : 
    2426           0 :   if( FD_LIKELY( msg->root_slot!=ULONG_MAX ) ) {
    2427             : 
    2428           0 :     FD_TEST( msg->root_slot>=ctx->consensus_root_slot );
    2429           0 :     fd_block_id_ele_t * block_id_ele = fd_block_id_map_ele_query( ctx->block_id_map, &msg->root_block_id, NULL, ctx->block_id_arr );
    2430           0 :     FD_TEST( block_id_ele );
    2431           0 :     ctx->consensus_root_slot     = msg->root_slot;
    2432           0 :     ctx->consensus_root          = msg->root_block_id;
    2433           0 :     ctx->consensus_root_bank_idx = fd_block_id_ele_get_idx( ctx->block_id_arr, block_id_ele );
    2434             : 
    2435           0 :     publish_root_advanced( ctx, stem );
    2436             : 
    2437           0 :     fd_sched_root_notify( ctx->sched, ctx->consensus_root_bank_idx );
    2438           0 :   }
    2439             : 
    2440           0 :   ulong distance = 0UL;
    2441           0 :   fd_bank_t * parent = bank;
    2442           0 :   while( parent ) {
    2443           0 :     if( FD_UNLIKELY( parent->data->idx==ctx->consensus_root_bank_idx ) ) break;
    2444           0 :     parent = fd_banks_get_parent( bank, ctx->banks, parent );
    2445           0 :     distance++;
    2446           0 :   }
    2447             : 
    2448           0 :   FD_MGAUGE_SET( REPLAY, ROOT_DISTANCE, distance );
    2449           0 : }
    2450             : 
    2451             : static void
    2452             : process_fec_complete( fd_replay_tile_t * ctx,
    2453           0 :                       uchar const *      shred_buf ) {
    2454           0 :   fd_shred_t const * shred = (fd_shred_t const *)fd_type_pun_const( shred_buf );
    2455             : 
    2456           0 :   fd_hash_t const * merkle_root         = (fd_hash_t const *)fd_type_pun_const( shred_buf + FD_SHRED_DATA_HEADER_SZ );
    2457           0 :   fd_hash_t const * chained_merkle_root = (fd_hash_t const *)fd_type_pun_const( shred_buf + FD_SHRED_DATA_HEADER_SZ + sizeof(fd_hash_t) );
    2458           0 :   int               is_leader_fec       = *(int const *)     fd_type_pun_const( shred_buf + FD_SHRED_DATA_HEADER_SZ + sizeof(fd_hash_t) + sizeof(fd_hash_t) );
    2459             : 
    2460           0 :   int data_complete = !!( shred->data.flags & FD_SHRED_DATA_FLAG_DATA_COMPLETE );
    2461           0 :   int slot_complete = !!( shred->data.flags & FD_SHRED_DATA_FLAG_SLOT_COMPLETE );
    2462             : 
    2463           0 :   if( FD_UNLIKELY( shred->slot - shred->data.parent_off == fd_reasm_slot0( ctx->reasm ) && shred->fec_set_idx == 0) ) {
    2464           0 :     chained_merkle_root = &fd_reasm_root( ctx->reasm )->key;
    2465           0 :   }
    2466             : 
    2467           0 :   if( FD_UNLIKELY( !fd_reasm_free( ctx->reasm ) ) ) {
    2468           0 :     FD_LOG_CRIT(( "unimplemented" )); /* TODO reasm eviction */
    2469           0 :   }
    2470           0 :   if( FD_UNLIKELY( fd_reasm_query( ctx->reasm, merkle_root ) ) ) return;
    2471           0 :   FD_TEST( fd_reasm_insert( ctx->reasm, merkle_root, chained_merkle_root, shred->slot, shred->fec_set_idx, shred->data.parent_off, (ushort)(shred->idx - shred->fec_set_idx + 1), data_complete, slot_complete, is_leader_fec ) );
    2472           0 : }
    2473             : 
    2474             : static void
    2475           0 : process_resolv_slot_completed( fd_replay_tile_t * ctx, ulong bank_idx ) {
    2476           0 :   fd_bank_t bank[1];
    2477           0 :   FD_TEST( fd_banks_bank_query( bank, ctx->banks, bank_idx ) );
    2478           0 :   bank->data->refcnt--;
    2479           0 :   FD_LOG_DEBUG(( "bank (idx=%lu, slot=%lu) refcnt decremented to %lu for resolv", bank->data->idx, fd_bank_slot_get( bank ), bank->data->refcnt ));
    2480           0 : }
    2481             : 
    2482             : static void
    2483             : process_vote_txn_sent( fd_replay_tile_t *  ctx,
    2484           0 :                        fd_txn_m_t *        txnm ) {
    2485             :   /* The send tile has signed and sent a vote.  Add this vote to the
    2486             :      vote tracker.  We go through this exercise until the client has
    2487             :      seen a vote corresponding to the current identity rooted. */
    2488           0 :   if( FD_UNLIKELY( !ctx->identity_vote_rooted ) ) {
    2489           0 :     uchar *    payload = (uchar *)txnm + sizeof(fd_txn_m_t);
    2490           0 :     uchar      txn_mem[ FD_TXN_MAX_SZ ] __attribute__((aligned(alignof(fd_txn_t))));
    2491           0 :     fd_txn_t * txn = (fd_txn_t *)txn_mem;
    2492           0 :     if( FD_UNLIKELY( !fd_txn_parse( payload, txnm->payload_sz, txn_mem, NULL ) ) ) {
    2493           0 :       FD_LOG_CRIT(( "Could not parse txn from send tile" ));
    2494           0 :     }
    2495             :     /* The identity of the validator that the signed the vote will
    2496             :        always be the first signer in the vote transaction. */
    2497           0 :     fd_pubkey_t * vote_identity = fd_type_pun( payload+txn->acct_addr_off );
    2498           0 :     fd_vote_tracker_insert( ctx->vote_tracker, vote_identity, fd_type_pun_const( payload+txn->signature_off ) );
    2499           0 :   }
    2500           0 : }
    2501             : 
    2502             : static inline void
    2503           0 : maybe_verify_shred_version( fd_replay_tile_t * ctx ) {
    2504           0 :   if( FD_LIKELY( ctx->expected_shred_version && ctx->ipecho_shred_version ) ) {
    2505           0 :     if( FD_UNLIKELY( ctx->expected_shred_version!=ctx->ipecho_shred_version ) ) {
    2506           0 :       FD_LOG_ERR(( "shred version mismatch: expected %u but got %u from ipecho", ctx->expected_shred_version, ctx->ipecho_shred_version ) );
    2507           0 :     }
    2508           0 :   }
    2509             : 
    2510           0 :   if( FD_LIKELY( ctx->has_genesis_hash && ctx->hard_forks_cnt!=ULONG_MAX && (ctx->expected_shred_version || ctx->ipecho_shred_version) ) ) {
    2511           0 :     ushort expected_shred_version = ctx->expected_shred_version ? ctx->expected_shred_version : ctx->ipecho_shred_version;
    2512             : 
    2513           0 :     ushort actual_shred_version = compute_shred_version( ctx->genesis_hash->uc, ctx->hard_forks, ctx->hard_forks_cnts, ctx->hard_forks_cnt );
    2514             : 
    2515           0 :     if( FD_UNLIKELY( expected_shred_version!=actual_shred_version ) ) {
    2516           0 :       FD_BASE58_ENCODE_32_BYTES( ctx->genesis_hash->uc, genesis_hash_b58 );
    2517           0 :       FD_LOG_ERR(( "Your genesis.bin file at `%s` combined with the hard_forks from the loaded snapshot have produced "
    2518           0 :                    "a shred version of %hu but the entrypoint you connected to on boot reported a shred version of %hu. "
    2519           0 :                    "This likely means that the genesis.bin file you have is for a different cluster than the one you "
    2520           0 :                    "are trying to connect to, you can delete it and restart the node to download the correct genesis "
    2521           0 :                    "file automatically.", ctx->genesis_path, actual_shred_version, expected_shred_version ));
    2522           0 :     }
    2523           0 :   }
    2524           0 : }
    2525             : 
    2526             : static inline void
    2527           0 : maybe_verify_genesis_timestamp( fd_replay_tile_t * ctx ) {
    2528           0 :   if( FD_LIKELY( !ctx->has_expected_genesis_timestamp || !ctx->has_genesis_timestamp ) ) return;
    2529           0 :   if( FD_LIKELY( ctx->genesis_timestamp==ctx->expected_genesis_timestamp ) ) return;
    2530             : 
    2531           0 :   FD_LOG_ERR(( "Your genesis.bin file at `%s` has a genesis timestamp of %lu but the snapshot you loaded has a genesis "
    2532           0 :                "timestamp of %lu. This either means that the genesis.bin file you have is for a different cluster than "
    2533           0 :                "the one you are trying to connect to, or you have loaded a snapshot for the wrong cluster. In either "
    2534           0 :                "case, you can delete the problematic file and restart the node to download the correct one automatically.",
    2535           0 :                ctx->genesis_path, ctx->genesis_timestamp, ctx->expected_genesis_timestamp ));
    2536           0 : }
    2537             : 
    2538             : static void
    2539             : process_tower_optimistic_confirmed( fd_replay_tile_t *                ctx,
    2540             :                                     fd_stem_context_t *               stem,
    2541           0 :                                     fd_tower_slot_confirmed_t const * msg ) {
    2542             : 
    2543           0 :   fd_block_id_ele_t * block_id_ele = fd_block_id_map_ele_query( ctx->block_id_map, &msg->block_id, NULL, ctx->block_id_arr );
    2544           0 :   if( FD_UNLIKELY( !block_id_ele ) ) {
    2545           0 :     FD_BASE58_ENCODE_32_BYTES( msg->block_id.key, block_id_b58 );
    2546           0 :     FD_LOG_WARNING(( "missing bank for confirmed block_id: %s level %d", block_id_b58, msg->level ));
    2547           0 :     return;
    2548           0 :   }
    2549             : 
    2550           0 :   ulong bank_idx = fd_block_id_ele_get_idx( ctx->block_id_arr, block_id_ele );
    2551           0 :   fd_bank_t bank_[1]; fd_bank_t * bank = fd_banks_bank_query( bank_, ctx->banks, bank_idx );
    2552             : 
    2553             : 
    2554           0 :   if( FD_UNLIKELY( !bank ) ) {
    2555           0 :     FD_BASE58_ENCODE_32_BYTES( msg->block_id.key, block_id_cstr );
    2556           0 :     FD_LOG_WARNING(( "failed to query optimistically confirmed bank for block id %s", block_id_cstr ));
    2557           0 :     return;
    2558           0 :   }
    2559             : 
    2560           0 :   if( ctx->rpc_enabled ) {
    2561           0 :     bank->data->refcnt++;
    2562           0 :     FD_LOG_DEBUG(( "bank (idx=%lu, slot=%lu) refcnt incremented to %lu for rpc", bank->data->idx, fd_bank_slot_get( bank ), bank->data->refcnt ));
    2563           0 :   }
    2564             : 
    2565           0 :   fd_replay_oc_advanced_t * replay_msg = fd_chunk_to_laddr( ctx->replay_out->mem, ctx->replay_out->chunk );
    2566           0 :   replay_msg->bank_idx = bank_idx;
    2567           0 :   replay_msg->slot = msg->slot;
    2568             : 
    2569           0 :   fd_stem_publish( stem, ctx->replay_out->idx, REPLAY_SIG_OC_ADVANCED, ctx->replay_out->chunk, sizeof(fd_replay_oc_advanced_t), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
    2570           0 :   ctx->replay_out->chunk = fd_dcache_compact_next( ctx->replay_out->chunk, sizeof(fd_replay_oc_advanced_t), ctx->replay_out->chunk0, ctx->replay_out->wmark );
    2571           0 : }
    2572             : 
    2573             : static inline int
    2574             : returnable_frag( fd_replay_tile_t *  ctx,
    2575             :                  ulong               in_idx,
    2576             :                  ulong               seq,
    2577             :                  ulong               sig,
    2578             :                  ulong               chunk,
    2579             :                  ulong               sz,
    2580             :                  ulong               ctl,
    2581             :                  ulong               tsorig,
    2582             :                  ulong               tspub,
    2583           0 :                  fd_stem_context_t * stem ) {
    2584           0 :   (void)seq;
    2585           0 :   (void)ctl;
    2586           0 :   (void)tsorig;
    2587           0 :   (void)tspub;
    2588             : 
    2589           0 :   if( FD_UNLIKELY( sz!=0UL && (chunk<ctx->in[ in_idx ].chunk0 || chunk>ctx->in[ in_idx ].wmark || sz>ctx->in[ in_idx ].mtu ) ) )
    2590           0 :     FD_LOG_ERR(( "chunk %lu %lu from in %d corrupt, not in range [%lu,%lu]", chunk, sz, ctx->in_kind[ in_idx ], ctx->in[ in_idx ].chunk0, ctx->in[ in_idx ].wmark ));
    2591             : 
    2592           0 :   switch( ctx->in_kind[in_idx] ) {
    2593           0 :     case IN_KIND_GENESIS: {
    2594           0 :       fd_genesis_meta_t const * meta = fd_chunk_to_laddr( ctx->in[ in_idx ].mem, chunk );
    2595           0 :       ctx->has_genesis_hash = 1;
    2596           0 :       *ctx->genesis_hash = meta->genesis_hash;
    2597           0 :       if( FD_LIKELY( meta->bootstrap ) ) {
    2598           0 :         boot_genesis( ctx, stem, meta );
    2599           0 :       } else {
    2600           0 :         uchar const * genesis_blob = (uchar const *)( meta+1 );
    2601           0 :         FD_TEST( fd_genesis_parse( ctx->genesis, genesis_blob, meta->blob_sz ) );
    2602           0 :       }
    2603           0 :       ctx->has_genesis_timestamp = 1;
    2604           0 :       ctx->genesis_timestamp     = ctx->genesis->creation_time;
    2605             : 
    2606           0 :       maybe_verify_cluster_type( ctx );
    2607           0 :       maybe_verify_shred_version( ctx );
    2608           0 :       maybe_verify_genesis_timestamp( ctx );
    2609           0 :       break;
    2610           0 :     }
    2611           0 :     case IN_KIND_IPECHO: {
    2612           0 :       FD_TEST( sig && sig<=USHORT_MAX );
    2613           0 :       ctx->ipecho_shred_version = (ushort)sig;
    2614           0 :       maybe_verify_shred_version( ctx );
    2615           0 :       break;
    2616           0 :     }
    2617           0 :     case IN_KIND_SNAP: {
    2618           0 :       on_snapshot_message( ctx, stem, in_idx, chunk, sig );
    2619           0 :       maybe_verify_shred_version( ctx );
    2620           0 :       maybe_verify_genesis_timestamp( ctx );
    2621           0 :       break;
    2622           0 :     }
    2623           0 :     case IN_KIND_EXECRP: {
    2624           0 :       process_exec_task_done( ctx, stem, fd_chunk_to_laddr( ctx->in[ in_idx ].mem, chunk ), sig );
    2625           0 :       break;
    2626           0 :     }
    2627           0 :     case IN_KIND_POH: {
    2628           0 :       process_poh_message( ctx, fd_chunk_to_laddr( ctx->in[ in_idx ].mem, chunk ) );
    2629           0 :       break;
    2630           0 :     }
    2631           0 :     case IN_KIND_RESOLV: {
    2632           0 :       fd_resolv_slot_exchanged_t * exchanged_slot = fd_chunk_to_laddr( ctx->in[ in_idx ].mem, chunk );
    2633           0 :       process_resolv_slot_completed( ctx, exchanged_slot->bank_idx );
    2634           0 :       break;
    2635           0 :     }
    2636           0 :     case IN_KIND_TOWER: {
    2637           0 :       if( FD_LIKELY( sig==FD_TOWER_SIG_SLOT_DONE ) ) {
    2638           0 :         process_tower_slot_done( ctx, stem, fd_chunk_to_laddr( ctx->in[ in_idx ].mem, chunk ), seq );
    2639           0 :       } else if( FD_LIKELY( sig==FD_TOWER_SIG_SLOT_CONFIRMED ) ) {
    2640           0 :         fd_tower_slot_confirmed_t const * msg = fd_chunk_to_laddr( ctx->in[ in_idx ].mem, chunk );
    2641           0 :         if( msg->level==FD_TOWER_SLOT_CONFIRMED_OPTIMISTIC && !msg->fwd ) process_tower_optimistic_confirmed( ctx, stem, msg );
    2642           0 :         if( msg->level==FD_TOWER_SLOT_CONFIRMED_DUPLICATE )               fd_reasm_confirm( ctx->reasm, &msg->block_id );
    2643           0 :       } else if( FD_LIKELY( sig==FD_TOWER_SIG_SLOT_IGNORED ) ) {
    2644           0 :         fd_tower_slot_ignored_t const * msg = fd_chunk_to_laddr( ctx->in[ in_idx ].mem, chunk );
    2645           0 :         fd_tower_slot_done_t ignored = {
    2646           0 :           .replay_slot     = msg->slot,
    2647           0 :           .replay_bank_idx = msg->bank_idx,
    2648           0 :           .vote_slot       = ULONG_MAX,
    2649           0 :           .reset_slot      = ctx->reset_slot,     /* Use most recent reset slot */
    2650           0 :           .reset_block_id  = ctx->reset_block_id,
    2651           0 :           .root_slot       = ULONG_MAX
    2652           0 :         };
    2653           0 :         process_tower_slot_done( ctx, stem, &ignored, seq );
    2654           0 :       }
    2655           0 :       break;
    2656           0 :     }
    2657           0 :     case IN_KIND_SHRED: {
    2658             :       /* TODO: This message/sz should be defined. */
    2659           0 :       if( sz!=0 && fd_disco_shred_out_msg_type( sig )==FD_SHRED_OUT_MSG_TYPE_FEC ) {
    2660             :         /* If receive a FEC complete message. */
    2661           0 :         process_fec_complete( ctx, fd_chunk_to_laddr( ctx->in[ in_idx ].mem, chunk ) );
    2662           0 :       }
    2663           0 :       break;
    2664           0 :     }
    2665           0 :     case IN_KIND_TXSEND: {
    2666           0 :       process_vote_txn_sent( ctx, fd_chunk_to_laddr( ctx->in[ in_idx ].mem, chunk ) );
    2667           0 :       break;
    2668           0 :     }
    2669           0 :     case IN_KIND_GOSSIP_OUT: {
    2670           0 :       FD_TEST( sig==FD_GOSSIP_UPDATE_TAG_WFS_DONE );
    2671           0 :       ctx->wfs_complete = 1;
    2672           0 :       FD_LOG_NOTICE(( "Done waiting for supermajority. More than 80 percent of cluster stake has joined." ));
    2673           0 :       break;
    2674           0 :     }
    2675           0 :     case IN_KIND_RPC:
    2676           0 :     case IN_KIND_GUI: {
    2677           0 :       fd_bank_t bank[1];
    2678           0 :       FD_TEST( fd_banks_bank_query( bank, ctx->banks, sig ) );
    2679           0 :       bank->data->refcnt--;
    2680           0 :       FD_LOG_DEBUG(( "bank (idx=%lu, slot=%lu) refcnt decremented to %lu for %s", bank->data->idx, fd_bank_slot_get( bank ), bank->data->refcnt, ctx->in_kind[ in_idx ]==IN_KIND_RPC ? "rpc" : "gui" ));
    2681           0 :       break;
    2682           0 :     }
    2683           0 :     default:
    2684           0 :       FD_LOG_ERR(( "unhandled kind %d", ctx->in_kind[ in_idx ] ));
    2685           0 :   }
    2686             : 
    2687           0 :   return 0;
    2688           0 : }
    2689             : 
    2690             : static inline fd_replay_out_link_t
    2691             : out1( fd_topo_t const *      topo,
    2692             :       fd_topo_tile_t const * tile,
    2693           0 :       char const *           name ) {
    2694           0 :   ulong idx = ULONG_MAX;
    2695             : 
    2696           0 :   for( ulong i=0UL; i<tile->out_cnt; i++ ) {
    2697           0 :     fd_topo_link_t const * link = &topo->links[ tile->out_link_id[ i ] ];
    2698           0 :     if( !strcmp( link->name, name ) ) {
    2699           0 :       if( FD_UNLIKELY( idx!=ULONG_MAX ) ) FD_LOG_ERR(( "tile %s:%lu had multiple output links named %s but expected one", tile->name, tile->kind_id, name ));
    2700           0 :       idx = i;
    2701           0 :     }
    2702           0 :   }
    2703             : 
    2704           0 :   if( FD_UNLIKELY( idx==ULONG_MAX ) ) return (fd_replay_out_link_t){ .idx = ULONG_MAX, .mem = NULL, .chunk0 = 0, .wmark = 0, .chunk = 0 };
    2705             : 
    2706           0 :   void * mem = topo->workspaces[ topo->objs[ topo->links[ tile->out_link_id[ idx ] ].dcache_obj_id ].wksp_id ].wksp;
    2707           0 :   ulong chunk0 = fd_dcache_compact_chunk0( mem, topo->links[ tile->out_link_id[ idx ] ].dcache );
    2708           0 :   ulong wmark  = fd_dcache_compact_wmark ( mem, topo->links[ tile->out_link_id[ idx ] ].dcache, topo->links[ tile->out_link_id[ idx ] ].mtu );
    2709             : 
    2710           0 :   return (fd_replay_out_link_t){ .idx = idx, .mem = mem, .chunk0 = chunk0, .wmark = wmark, .chunk = chunk0 };
    2711           0 : }
    2712             : 
    2713             : static void
    2714             : privileged_init( fd_topo_t *      topo,
    2715           0 :                  fd_topo_tile_t * tile ) {
    2716           0 :   void * scratch = fd_topo_obj_laddr( topo, tile->tile_obj_id );
    2717             : 
    2718           0 :   FD_SCRATCH_ALLOC_INIT( l, scratch );
    2719           0 :   fd_replay_tile_t * ctx = FD_SCRATCH_ALLOC_APPEND( l, alignof(fd_replay_tile_t), sizeof(fd_replay_tile_t) );
    2720             : 
    2721           0 :   if( FD_UNLIKELY( !strcmp( tile->replay.identity_key_path, "" ) ) ) FD_LOG_ERR(( "identity_key_path not set" ));
    2722             : 
    2723           0 :   ctx->identity_pubkey[ 0 ] = *(fd_pubkey_t const *)fd_type_pun_const( fd_keyload_load( tile->replay.identity_key_path, /* pubkey only: */ 1 ) );
    2724           0 :   ctx->identity_idx         = 0UL;
    2725             : 
    2726           0 :   if( FD_UNLIKELY( !tile->replay.bundle.vote_account_path[0] ) ) {
    2727           0 :     tile->replay.bundle.enabled = 0;
    2728           0 :   }
    2729             : 
    2730           0 :   if( FD_UNLIKELY( tile->replay.bundle.enabled ) ) {
    2731           0 :     if( FD_UNLIKELY( !fd_base58_decode_32( tile->replay.bundle.vote_account_path, ctx->bundle.vote_account.uc ) ) ) {
    2732           0 :       const uchar * vote_key = fd_keyload_load( tile->replay.bundle.vote_account_path, /* pubkey only: */ 1 );
    2733           0 :       fd_memcpy( ctx->bundle.vote_account.uc, vote_key, 32UL );
    2734           0 :     }
    2735           0 :   }
    2736             : 
    2737           0 :   if( FD_UNLIKELY( !fd_rng_secure( &ctx->reasm_seed, sizeof(ulong) ) ) ) {
    2738           0 :     FD_LOG_CRIT(( "fd_rng_secure failed" ));
    2739           0 :   }
    2740             : 
    2741           0 :   if( FD_UNLIKELY( !fd_rng_secure( &ctx->vote_tracker_seed, sizeof(ulong) ) ) ) {
    2742           0 :     FD_LOG_CRIT(( "fd_rng_secure failed" ));
    2743           0 :   }
    2744             : 
    2745           0 :   if( FD_UNLIKELY( !fd_rng_secure( &ctx->block_id_map_seed, sizeof(ulong) ) ) ) {
    2746           0 :     FD_LOG_CRIT(( "fd_rng_secure failed" ));
    2747           0 :   }
    2748             : 
    2749           0 :   if( FD_UNLIKELY( !fd_rng_secure( &ctx->initial_block_id, sizeof(fd_hash_t) ) ) ) {
    2750           0 :     FD_LOG_CRIT(( "fd_rng_secure failed" ));
    2751           0 :   }
    2752             : 
    2753           0 :   if( FD_UNLIKELY( !fd_rng_secure( &ctx->runtime_stack_seed, sizeof(ulong) ) ) ) {
    2754           0 :     FD_LOG_CRIT(( "fd_rng_secure failed" ));
    2755           0 :   }
    2756           0 : }
    2757             : 
    2758             : static void
    2759             : unprivileged_init( fd_topo_t *      topo,
    2760           0 :                    fd_topo_tile_t * tile ) {
    2761           0 :   void * scratch = fd_topo_obj_laddr( topo, tile->tile_obj_id );
    2762             : 
    2763           0 :   ulong chain_cnt = fd_block_id_map_chain_cnt_est( tile->replay.max_live_slots );
    2764             : 
    2765           0 :   FD_SCRATCH_ALLOC_INIT( l, scratch );
    2766           0 :   fd_replay_tile_t * ctx    = FD_SCRATCH_ALLOC_APPEND( l, alignof(fd_replay_tile_t),   sizeof(fd_replay_tile_t) );
    2767           0 :   void * block_id_arr_mem   = FD_SCRATCH_ALLOC_APPEND( l, alignof(fd_block_id_ele_t),  sizeof(fd_block_id_ele_t) * tile->replay.max_live_slots );
    2768           0 :   void * block_id_map_mem   = FD_SCRATCH_ALLOC_APPEND( l, fd_block_id_map_align(),     fd_block_id_map_footprint( chain_cnt ) );
    2769           0 :   void * _txncache          = FD_SCRATCH_ALLOC_APPEND( l, fd_txncache_align(),         fd_txncache_footprint( tile->replay.max_live_slots ) );
    2770           0 :   void * reasm_mem          = FD_SCRATCH_ALLOC_APPEND( l, fd_reasm_align(),            fd_reasm_footprint( tile->replay.fec_max ) );
    2771           0 :   void * sched_mem          = FD_SCRATCH_ALLOC_APPEND( l, fd_sched_align(),            fd_sched_footprint( tile->replay.sched_depth, tile->replay.max_live_slots ) );
    2772           0 :   void * vinyl_req_pool_mem = FD_SCRATCH_ALLOC_APPEND( l, fd_vinyl_req_pool_align(),   fd_vinyl_req_pool_footprint( 1UL, 1UL ) );
    2773           0 :   void * vote_tracker_mem   = FD_SCRATCH_ALLOC_APPEND( l, fd_vote_tracker_align(),     fd_vote_tracker_footprint() );
    2774           0 :   void * _capture_ctx       = FD_SCRATCH_ALLOC_APPEND( l, fd_capture_ctx_align(),      fd_capture_ctx_footprint() );
    2775           0 :   void * dump_proto_ctx_mem = FD_SCRATCH_ALLOC_APPEND( l, alignof(fd_dump_proto_ctx_t), sizeof(fd_dump_proto_ctx_t) );
    2776           0 : # if FD_HAS_FLATCC
    2777           0 :   void * block_dump_ctx     = NULL;
    2778           0 :   if( FD_UNLIKELY( tile->replay.dump_block_to_pb ) ) {
    2779           0 :     block_dump_ctx = FD_SCRATCH_ALLOC_APPEND( l, fd_block_dump_context_align(), fd_block_dump_context_footprint() );
    2780           0 :   }
    2781           0 : # endif
    2782             : 
    2783           0 :   FD_TEST( fd_vote_rewards_map_join( fd_vote_rewards_map_new( ctx->runtime_stack.stakes.vote_map_mem, FD_RUNTIME_EXPECTED_VOTE_ACCOUNTS, ctx->runtime_stack_seed ) ) );
    2784             : 
    2785           0 :   ctx->wksp = topo->workspaces[ topo->objs[ tile->tile_obj_id ].wksp_id ].wksp;
    2786             : 
    2787           0 :   ulong store_obj_id = fd_pod_query_ulong( topo->props, "store", ULONG_MAX );
    2788           0 :   FD_TEST( store_obj_id!=ULONG_MAX );
    2789           0 :   ctx->store = fd_store_join( fd_topo_obj_laddr( topo, store_obj_id ) );
    2790           0 :   FD_TEST( ctx->store );
    2791             : 
    2792           0 :   ulong banks_obj_id = fd_pod_query_ulong( topo->props, "banks", ULONG_MAX );
    2793           0 :   FD_TEST( banks_obj_id!=ULONG_MAX );
    2794           0 :   ulong banks_locks_obj_id = fd_pod_query_ulong( topo->props, "banks_locks", ULONG_MAX );
    2795           0 :   FD_TEST( banks_locks_obj_id!=ULONG_MAX );
    2796             : 
    2797           0 :   FD_TEST( fd_banks_join( ctx->banks, fd_topo_obj_laddr( topo, banks_obj_id ), fd_topo_obj_laddr( topo, banks_locks_obj_id ) ) );
    2798             : 
    2799           0 :   fd_bank_data_t * bank_pool = fd_banks_get_bank_pool( ctx->banks->data );
    2800           0 :   FD_MGAUGE_SET( REPLAY, MAX_LIVE_BANKS, fd_banks_pool_max( bank_pool ) );
    2801             : 
    2802           0 :   fd_bank_t bank[1];
    2803           0 :   FD_TEST( fd_banks_init_bank( bank, ctx->banks ) );
    2804           0 :   fd_bank_slot_set( bank, 0UL );
    2805           0 :   FD_TEST( bank->data->idx==FD_REPLAY_BOOT_BANK_IDX );
    2806             : 
    2807           0 :   ctx->consensus_root_slot = ULONG_MAX;
    2808           0 :   ctx->consensus_root      = ctx->initial_block_id;
    2809           0 :   ctx->published_root_slot = ULONG_MAX;
    2810             : 
    2811           0 :   ctx->expected_shred_version = tile->replay.expected_shred_version;
    2812           0 :   ctx->ipecho_shred_version = 0;
    2813           0 :   fd_memcpy( ctx->genesis_path, tile->replay.genesis_path, sizeof(ctx->genesis_path) );
    2814           0 :   ctx->has_genesis_hash = 0;
    2815           0 :   ctx->has_genesis_timestamp          = 0;
    2816           0 :   ctx->has_expected_genesis_timestamp = 0;
    2817           0 :   ctx->cluster_type = FD_CLUSTER_UNKNOWN;
    2818           0 :   ctx->hard_forks_cnt = ULONG_MAX;
    2819             : 
    2820           0 :   if( FD_UNLIKELY( tile->replay.bundle.enabled ) ) {
    2821           0 :     ctx->bundle.enabled = 1;
    2822           0 :     if( FD_UNLIKELY( !fd_bundle_crank_gen_init( ctx->bundle.gen,
    2823           0 :              (fd_acct_addr_t const *)tile->replay.bundle.tip_distribution_program_addr,
    2824           0 :              (fd_acct_addr_t const *)tile->replay.bundle.tip_payment_program_addr,
    2825           0 :              (fd_acct_addr_t const *)ctx->bundle.vote_account.uc,
    2826           0 :              (fd_acct_addr_t const *)ctx->bundle.vote_account.uc, "NAN", 0UL ) ) ) {
    2827           0 :       FD_LOG_ERR(( "failed to initialize bundle crank gen" ));
    2828           0 :     }
    2829           0 :   } else {
    2830           0 :     ctx->bundle.enabled = 0;
    2831           0 :   }
    2832             : 
    2833           0 :   fd_features_t * features = fd_bank_features_modify( bank );
    2834           0 :   fd_features_enable_cleaned_up( features );
    2835             : 
    2836           0 :   char const * one_off_features[ 16UL ];
    2837           0 :   FD_TEST( tile->replay.enable_features_cnt<=sizeof(one_off_features)/sizeof(one_off_features[0]) );
    2838           0 :   for( ulong i=0UL; i<tile->replay.enable_features_cnt; i++ ) one_off_features[ i ] = tile->replay.enable_features[i];
    2839           0 :   fd_features_enable_one_offs( features, one_off_features, (uint)tile->replay.enable_features_cnt, 0UL );
    2840             : 
    2841           0 :   fd_topo_obj_t const * vinyl_data = fd_topo_find_tile_obj( topo, tile, "vinyl_data" );
    2842             : 
    2843           0 :   ulong progcache_obj_id;       FD_TEST( (progcache_obj_id       = fd_pod_query_ulong( topo->props, "progcache",       ULONG_MAX ) )!=ULONG_MAX );
    2844           0 :   ulong progcache_locks_obj_id; FD_TEST( (progcache_locks_obj_id = fd_pod_query_ulong( topo->props, "progcache_locks", ULONG_MAX ) )!=ULONG_MAX );
    2845           0 :   FD_TEST( fd_progcache_admin_join( ctx->progcache_admin,
    2846           0 :       fd_topo_obj_laddr( topo, progcache_obj_id       ),
    2847           0 :       fd_topo_obj_laddr( topo, progcache_locks_obj_id ) ) );
    2848             : 
    2849           0 :   ulong funk_obj_id;       FD_TEST( (funk_obj_id       = fd_pod_query_ulong( topo->props, "funk",       ULONG_MAX ) )!=ULONG_MAX );
    2850           0 :   ulong funk_locks_obj_id; FD_TEST( (funk_locks_obj_id = fd_pod_query_ulong( topo->props, "funk_locks", ULONG_MAX ) )!=ULONG_MAX );
    2851           0 :   ulong max_depth = tile->replay.max_live_slots + tile->replay.write_delay_slots;
    2852           0 :   if( !vinyl_data ) {
    2853           0 :     FD_TEST( fd_accdb_admin_v1_init( ctx->accdb_admin,
    2854           0 :         fd_topo_obj_laddr( topo, funk_obj_id       ),
    2855           0 :         fd_topo_obj_laddr( topo, funk_locks_obj_id ) ) );
    2856           0 :   } else {
    2857           0 :     fd_topo_obj_t const * vinyl_rq       = fd_topo_find_tile_obj( topo, tile, "vinyl_rq" );
    2858           0 :     fd_topo_obj_t const * vinyl_req_pool = fd_topo_find_tile_obj( topo, tile, "vinyl_rpool" );
    2859           0 :     FD_TEST( fd_accdb_admin_v2_init( ctx->accdb_admin,
    2860           0 :         fd_topo_obj_laddr( topo, funk_obj_id       ),
    2861           0 :         fd_topo_obj_laddr( topo, funk_locks_obj_id ),
    2862           0 :         fd_topo_obj_laddr( topo, vinyl_rq->id      ),
    2863           0 :         topo->workspaces[ vinyl_data->wksp_id ].wksp,
    2864           0 :         fd_topo_obj_laddr( topo, vinyl_req_pool->id ),
    2865           0 :         vinyl_rq->id,
    2866           0 :         max_depth ) );
    2867           0 :     fd_accdb_admin_v2_delay_set( ctx->accdb_admin, tile->replay.write_delay_slots );
    2868           0 :   }
    2869           0 :   fd_accdb_init_from_topo( ctx->accdb, topo, tile, max_depth );
    2870             : 
    2871           0 :   void * _txncache_shmem = fd_topo_obj_laddr( topo, tile->replay.txncache_obj_id );
    2872           0 :   fd_txncache_shmem_t * txncache_shmem = fd_txncache_shmem_join( _txncache_shmem );
    2873           0 :   FD_TEST( txncache_shmem );
    2874           0 :   ctx->txncache = fd_txncache_join( fd_txncache_new( _txncache, txncache_shmem ) );
    2875           0 :   FD_TEST( ctx->txncache );
    2876             : 
    2877           0 :   ctx->capture_ctx = NULL;
    2878           0 :   if( FD_UNLIKELY( strcmp( "", tile->replay.solcap_capture ) ) ) {
    2879           0 :     ctx->capture_ctx = fd_capture_ctx_join( fd_capture_ctx_new( _capture_ctx ) );
    2880           0 :     ctx->capture_ctx->solcap_start_slot = tile->replay.capture_start_slot;
    2881           0 :     ctx->capture_ctx->capture_solcap = 1;
    2882           0 :   }
    2883             : 
    2884           0 :   ctx->dump_proto_ctx = NULL;
    2885           0 :   if( FD_UNLIKELY( strcmp( "", tile->replay.dump_proto_dir ) ) ) {
    2886           0 :     ctx->dump_proto_ctx                        = dump_proto_ctx_mem;
    2887           0 :     ctx->dump_proto_ctx->dump_proto_output_dir = tile->replay.dump_proto_dir;
    2888           0 :     if( FD_LIKELY( tile->replay.dump_block_to_pb ) ) {
    2889           0 :       ctx->dump_proto_ctx->dump_block_to_pb = !!tile->replay.dump_block_to_pb;
    2890           0 :     }
    2891           0 :   }
    2892             : 
    2893           0 : # if FD_HAS_FLATCC
    2894           0 :   if( FD_UNLIKELY( tile->replay.dump_block_to_pb ) ) {
    2895           0 :     ctx->block_dump_ctx = fd_block_dump_context_join( fd_block_dump_context_new( block_dump_ctx ) );
    2896           0 :   } else {
    2897           0 :     ctx->block_dump_ctx = NULL;
    2898           0 :   }
    2899           0 : # endif
    2900             : 
    2901           0 :   ctx->is_booted = 0;
    2902             : 
    2903           0 :   ctx->larger_max_cost_per_block = tile->replay.larger_max_cost_per_block;
    2904             : 
    2905           0 :   ctx->reasm = fd_reasm_join( fd_reasm_new( reasm_mem, tile->replay.fec_max, ctx->reasm_seed ) );
    2906           0 :   FD_TEST( ctx->reasm );
    2907             : 
    2908           0 :   ctx->sched = fd_sched_join( fd_sched_new( sched_mem, tile->replay.sched_depth, tile->replay.max_live_slots, fd_topo_tile_name_cnt( topo, "execrp" ) ) );
    2909           0 :   FD_TEST( ctx->sched );
    2910             : 
    2911           0 :   FD_TEST( fd_vinyl_req_pool_new( vinyl_req_pool_mem, 1UL, 1UL ) );
    2912             : 
    2913           0 :   ctx->vote_tracker = fd_vote_tracker_join( fd_vote_tracker_new( vote_tracker_mem, ctx->vote_tracker_seed ) );
    2914           0 :   FD_TEST( ctx->vote_tracker );
    2915             : 
    2916           0 :   ctx->identity_vote_rooted = 0;
    2917             : 
    2918           0 :   ctx->wait_for_vote_to_start_leader = tile->replay.wait_for_vote_to_start_leader;
    2919             : 
    2920           0 :   ctx->wfs_enabled = memcmp( tile->replay.wait_for_supermajority_with_bank_hash.uc, ((fd_pubkey_t){ 0 }).uc, sizeof(fd_pubkey_t) );
    2921           0 :   ctx->expected_bank_hash = tile->replay.wait_for_supermajority_with_bank_hash;
    2922           0 :   ctx->wfs_complete = !ctx->wfs_enabled;
    2923             : 
    2924           0 :   ctx->mleaders = fd_multi_epoch_leaders_join( fd_multi_epoch_leaders_new( ctx->mleaders_mem ) );
    2925           0 :   FD_TEST( ctx->mleaders );
    2926             : 
    2927           0 :   ctx->is_leader             = 0;
    2928           0 :   ctx->supports_leader       = fd_topo_find_tile( topo, "pack", 0UL )!=ULONG_MAX;
    2929           0 :   ctx->reset_slot            = 0UL;
    2930           0 :   fd_memset( ctx->reset_bank, 0, sizeof(fd_bank_t) );
    2931           0 :   ctx->reset_block_id        = ctx->initial_block_id;
    2932           0 :   ctx->reset_timestamp_nanos = 0UL;
    2933           0 :   ctx->next_leader_slot      = ULONG_MAX;
    2934           0 :   ctx->next_leader_tickcount = LONG_MAX;
    2935           0 :   ctx->highwater_leader_slot = ULONG_MAX;
    2936           0 :   ctx->slot_duration_nanos   = 350L*1000L*1000L; /* TODO: Not fixed ... not always 350ms ... */
    2937           0 :   ctx->slot_duration_ticks   = (double)ctx->slot_duration_nanos*fd_tempo_tick_per_ns( NULL );
    2938           0 :   ctx->leader_bank->data     = NULL;
    2939             : 
    2940           0 :   ctx->block_id_len = tile->replay.max_live_slots;
    2941           0 :   ctx->block_id_arr = (fd_block_id_ele_t *)block_id_arr_mem;
    2942           0 :   ctx->block_id_map = fd_block_id_map_join( fd_block_id_map_new( block_id_map_mem, chain_cnt, ctx->block_id_map_seed ) );
    2943           0 :   FD_TEST( ctx->block_id_map );
    2944           0 :   for( ulong i=0UL; i<tile->replay.max_live_slots; i++ ) ctx->block_id_arr[ i ].block_id_seen = 0;
    2945             : 
    2946           0 :   ctx->resolv_tile_cnt = fd_topo_tile_name_cnt( topo, "resolv" );
    2947             : 
    2948           0 :   ctx->keyswitch = fd_keyswitch_join( fd_topo_obj_laddr( topo, tile->id_keyswitch_obj_id ) );
    2949           0 :   FD_TEST( ctx->keyswitch );
    2950           0 :   ctx->halt_leader = 0;
    2951             : 
    2952           0 :   FD_TEST( tile->in_cnt<=sizeof(ctx->in)/sizeof(ctx->in[0]) );
    2953           0 :   for( ulong i=0UL; i<tile->in_cnt; i++ ) {
    2954           0 :     fd_topo_link_t * link = &topo->links[ tile->in_link_id[ i ] ];
    2955           0 :     fd_topo_wksp_t * link_wksp = &topo->workspaces[ topo->objs[ link->dcache_obj_id ].wksp_id ];
    2956             : 
    2957           0 :     if( FD_LIKELY( link->dcache ) ) {
    2958           0 :       ctx->in[ i ].mem    = link_wksp->wksp;
    2959           0 :       ctx->in[ i ].chunk0 = fd_dcache_compact_chunk0( ctx->in[ i ].mem, link->dcache );
    2960           0 :       ctx->in[ i ].wmark  = fd_dcache_compact_wmark ( ctx->in[ i ].mem, link->dcache, link->mtu );
    2961           0 :       ctx->in[ i ].mtu    = link->mtu;
    2962           0 :     }
    2963             : 
    2964           0 :     if(      !strcmp( link->name, "genesi_out"    ) ) ctx->in_kind[ i ] = IN_KIND_GENESIS;
    2965           0 :     else if( !strcmp( link->name, "ipecho_out"    ) ) ctx->in_kind[ i ] = IN_KIND_IPECHO;
    2966           0 :     else if( !strcmp( link->name, "snapin_manif"  ) ) ctx->in_kind[ i ] = IN_KIND_SNAP;
    2967           0 :     else if( !strcmp( link->name, "execrp_replay" ) ) ctx->in_kind[ i ] = IN_KIND_EXECRP;
    2968           0 :     else if( !strcmp( link->name, "tower_out"     ) ) ctx->in_kind[ i ] = IN_KIND_TOWER;
    2969           0 :     else if( !strcmp( link->name, "poh_replay"    ) ) ctx->in_kind[ i ] = IN_KIND_POH;
    2970           0 :     else if( !strcmp( link->name, "resolv_replay" ) ) ctx->in_kind[ i ] = IN_KIND_RESOLV;
    2971           0 :     else if( !strcmp( link->name, "shred_out"     ) ) ctx->in_kind[ i ] = IN_KIND_SHRED;
    2972           0 :     else if( !strcmp( link->name, "txsend_out"    ) ) ctx->in_kind[ i ] = IN_KIND_TXSEND;
    2973           0 :     else if( !strcmp( link->name, "gui_replay"    ) ) ctx->in_kind[ i ] = IN_KIND_GUI;
    2974           0 :     else if( !strcmp( link->name, "rpc_replay"    ) ) ctx->in_kind[ i ] = IN_KIND_RPC;
    2975           0 :     else if( !strcmp( link->name, "gossip_out"    ) ) ctx->in_kind[ i ] = IN_KIND_GOSSIP_OUT;
    2976           0 :     else FD_LOG_ERR(( "unexpected input link name %s", link->name ));
    2977           0 :   }
    2978             : 
    2979           0 :   *ctx->epoch_out  = out1( topo, tile, "replay_epoch" ); FD_TEST( ctx->epoch_out->idx!=ULONG_MAX );
    2980           0 :   *ctx->replay_out = out1( topo, tile, "replay_out"   ); FD_TEST( ctx->replay_out->idx!=ULONG_MAX );
    2981           0 :   *ctx->exec_out   = out1( topo, tile, "replay_execrp"  ); FD_TEST( ctx->exec_out->idx!=ULONG_MAX );
    2982             : 
    2983           0 :   ctx->gui_enabled = fd_topo_find_tile( topo, "gui", 0UL )!=ULONG_MAX;
    2984           0 :   ctx->rpc_enabled = fd_topo_find_tile( topo, "rpc", 0UL )!=ULONG_MAX;
    2985             : 
    2986           0 :   if( FD_UNLIKELY( strcmp( "", tile->replay.solcap_capture ) ) ) {
    2987           0 :     ulong idx = fd_topo_find_tile_out_link( topo, tile, "cap_repl", 0UL );
    2988           0 :     FD_TEST( idx!=ULONG_MAX );
    2989           0 :     fd_topo_link_t * link = &topo->links[ tile->out_link_id[ idx ] ];
    2990             : 
    2991             : 
    2992           0 :     fd_capture_link_buf_t * cap_repl_out = ctx->cap_repl_out;
    2993           0 :     cap_repl_out->base.vt = &fd_capture_link_buf_vt;
    2994           0 :     cap_repl_out->idx     = idx;
    2995           0 :     cap_repl_out->mem     = topo->workspaces[ topo->objs[ link->dcache_obj_id ].wksp_id ].wksp;
    2996           0 :     cap_repl_out->chunk0  = fd_dcache_compact_chunk0( cap_repl_out->mem, link->dcache );
    2997           0 :     cap_repl_out->wmark   = fd_dcache_compact_wmark( cap_repl_out->mem, link->dcache, link->mtu );
    2998           0 :     cap_repl_out->chunk   = cap_repl_out->chunk0;
    2999           0 :     cap_repl_out->mcache  = link->mcache;
    3000           0 :     cap_repl_out->depth   = fd_mcache_depth( link->mcache );
    3001           0 :     cap_repl_out->seq     = 0UL;
    3002             : 
    3003           0 :     ctx->capture_ctx->capctx_type.buf  = cap_repl_out;
    3004           0 :     ctx->capture_ctx->capture_link    = &cap_repl_out->base;
    3005           0 :     ctx->capture_ctx->current_txn_idx = 0UL;
    3006             : 
    3007             : 
    3008           0 :     ulong consumer_tile_idx = fd_topo_find_tile( topo, "solcap", 0UL );
    3009           0 :     fd_topo_tile_t * consumer_tile = &topo->tiles[ consumer_tile_idx ];
    3010           0 :     cap_repl_out->fseq = NULL;
    3011           0 :     for( ulong j = 0UL; j < consumer_tile->in_cnt; j++ ) {
    3012           0 :       if( FD_UNLIKELY( consumer_tile->in_link_id[ j ]  == link->id ) ) {
    3013           0 :         cap_repl_out->fseq = fd_fseq_join( fd_topo_obj_laddr( topo, consumer_tile->in_link_fseq_obj_id[ j ] ) );
    3014           0 :         FD_TEST( cap_repl_out->fseq );
    3015           0 :         break;
    3016           0 :       }
    3017           0 :     }
    3018           0 :   }
    3019             : 
    3020           0 :   fd_memset( &ctx->metrics, 0, sizeof(ctx->metrics) );
    3021             : 
    3022           0 :   fd_histf_join( fd_histf_new( ctx->metrics.store_query_wait,   FD_MHIST_SECONDS_MIN( REPLAY, STORE_QUERY_WAIT ),
    3023           0 :                                                                 FD_MHIST_SECONDS_MAX( REPLAY, STORE_QUERY_WAIT ) ) );
    3024           0 :   fd_histf_join( fd_histf_new( ctx->metrics.store_query_work,   FD_MHIST_SECONDS_MIN( REPLAY, STORE_QUERY_WORK ),
    3025           0 :                                                                 FD_MHIST_SECONDS_MAX( REPLAY, STORE_QUERY_WORK ) ) );
    3026             : 
    3027           0 :   fd_histf_join( fd_histf_new( ctx->metrics.root_slot_dur,      FD_MHIST_SECONDS_MIN( REPLAY, ROOT_SLOT_DURATION_SECONDS ),
    3028           0 :                                                                 FD_MHIST_SECONDS_MAX( REPLAY, ROOT_SLOT_DURATION_SECONDS ) ) );
    3029           0 :   fd_histf_join( fd_histf_new( ctx->metrics.root_account_dur,   FD_MHIST_SECONDS_MIN( REPLAY, ROOT_ACCOUNT_DURATION_SECONDS ),
    3030           0 :                                                                 FD_MHIST_SECONDS_MAX( REPLAY, ROOT_ACCOUNT_DURATION_SECONDS ) ) );
    3031             : 
    3032             :   /* Ensure precompiles are available, crash fast otherwise */
    3033           0 :   fd_precompiles();
    3034             : 
    3035           0 :   ulong scratch_top = FD_SCRATCH_ALLOC_FINI( l, 1UL );
    3036           0 :   if( FD_UNLIKELY( scratch_top > (ulong)scratch + scratch_footprint( tile ) ) )
    3037           0 :     FD_LOG_ERR(( "scratch overflow %lu %lu %lu", scratch_top - (ulong)scratch - scratch_footprint( tile ), scratch_top, (ulong)scratch + scratch_footprint( tile ) ));
    3038           0 : }
    3039             : 
    3040             : static ulong
    3041             : populate_allowed_seccomp( fd_topo_t const *      topo FD_FN_UNUSED,
    3042             :                           fd_topo_tile_t const * tile FD_FN_UNUSED,
    3043             :                           ulong                  out_cnt,
    3044           0 :                           struct sock_filter *   out ) {
    3045             : 
    3046           0 :   populate_sock_filter_policy_fd_replay_tile( out_cnt, out, (uint)fd_log_private_logfile_fd() );
    3047           0 :   return sock_filter_policy_fd_replay_tile_instr_cnt;
    3048           0 : }
    3049             : 
    3050             : static ulong
    3051             : populate_allowed_fds( fd_topo_t const *      topo FD_FN_UNUSED,
    3052             :                       fd_topo_tile_t const * tile FD_FN_UNUSED,
    3053             :                       ulong                  out_fds_cnt,
    3054           0 :                       int *                  out_fds ) {
    3055             : 
    3056           0 :   if( FD_UNLIKELY( out_fds_cnt<2UL ) ) FD_LOG_ERR(( "out_fds_cnt %lu", out_fds_cnt ));
    3057             : 
    3058           0 :   ulong out_cnt = 0UL;
    3059           0 :   out_fds[ out_cnt++ ] = 2; /* stderr */
    3060           0 :   if( FD_LIKELY( -1!=fd_log_private_logfile_fd() ) )
    3061           0 :     out_fds[ out_cnt++ ] = fd_log_private_logfile_fd(); /* logfile */
    3062           0 :   return out_cnt;
    3063           0 : }
    3064             : 
    3065             : static inline void
    3066           0 : during_housekeeping( fd_replay_tile_t * ctx ) {
    3067           0 :   if( FD_UNLIKELY( fd_keyswitch_state_query( ctx->keyswitch )==FD_KEYSWITCH_STATE_UNHALT_PENDING ) ) {
    3068           0 :     FD_CRIT( ctx->halt_leader, "state machine corruption" );
    3069           0 :     FD_LOG_DEBUG(( "keyswitch: unhalting leader" ));
    3070           0 :     ctx->halt_leader = 0;
    3071           0 :     fd_keyswitch_state( ctx->keyswitch, FD_KEYSWITCH_STATE_COMPLETED );
    3072           0 :   }
    3073             : 
    3074           0 :   if( FD_UNLIKELY( fd_keyswitch_state_query( ctx->keyswitch )==FD_KEYSWITCH_STATE_SWITCH_PENDING ) ) {
    3075           0 :     FD_LOG_DEBUG(( "keyswitch: halting leader" ));
    3076           0 :     ctx->halt_leader = 1;
    3077           0 :     if( !ctx->is_leader ) maybe_switch_identity( ctx );
    3078           0 :   }
    3079           0 : }
    3080             : 
    3081             : #undef DEBUG_LOGGING
    3082             : 
    3083             : /* counting carefully, after_credit can generate at most 7 frags and
    3084             :    returnable_frag boot_genesis can also generate at most 7 frags, so 14
    3085             :    is a conservative bound. */
    3086           0 : #define STEM_BURST (14UL)
    3087             : 
    3088             : /* TODO: calculate this properly/fix stem to work with larger numbers of links */
    3089             : /* 1000 chosen empirically as anything larger slowed down replay times. Need to calculate
    3090             :    this properly. */
    3091           0 : #define STEM_LAZY ((long)10e3)
    3092             : 
    3093           0 : #define STEM_CALLBACK_CONTEXT_TYPE  fd_replay_tile_t
    3094           0 : #define STEM_CALLBACK_CONTEXT_ALIGN alignof(fd_replay_tile_t)
    3095             : 
    3096           0 : #define STEM_CALLBACK_METRICS_WRITE       metrics_write
    3097           0 : #define STEM_CALLBACK_AFTER_CREDIT        after_credit
    3098           0 : #define STEM_CALLBACK_BEFORE_FRAG         before_frag
    3099           0 : #define STEM_CALLBACK_RETURNABLE_FRAG     returnable_frag
    3100           0 : #define STEM_CALLBACK_DURING_HOUSEKEEPING during_housekeeping
    3101             : 
    3102             : #include "../../disco/stem/fd_stem.c"
    3103             : 
    3104             : fd_topo_run_tile_t fd_tile_replay = {
    3105             :   .name                     = "replay",
    3106             :   .populate_allowed_seccomp = populate_allowed_seccomp,
    3107             :   .populate_allowed_fds     = populate_allowed_fds,
    3108             :   .scratch_align            = scratch_align,
    3109             :   .scratch_footprint        = scratch_footprint,
    3110             :   .privileged_init          = privileged_init,
    3111             :   .unprivileged_init        = unprivileged_init,
    3112             :   .run                      = stem_run,
    3113             : };

Generated by: LCOV version 1.14