LCOV - code coverage report
Current view: top level - discof/replay - fd_replay_tile.c (source / functions) Hit Total Coverage
Test: cov.lcov Lines: 0 1537 0.0 %
Date: 2026-01-16 05:17:52 Functions: 0 43 0.0 %

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

Generated by: LCOV version 1.14