LCOV - code coverage report
Current view: top level - disco/pack - fd_pack_tile.c (source / functions) Hit Total Coverage
Test: cov.lcov Lines: 0 784 0.0 %
Date: 2026-08-03 05:36:37 Functions: 0 17 0.0 %

          Line data    Source code
       1             : #include "../tiles.h"
       2             : 
       3             : #include "generated/fd_pack_tile_seccomp.h"
       4             : 
       5             : #include "../../util/pod/fd_pod_format.h"
       6             : #include "../../discof/replay/fd_replay_tile.h" // layering violation
       7             : #include "../fd_txn_m.h"
       8             : #include "../keyguard/fd_keyload.h"
       9             : #include "../keyguard/fd_keyswitch.h"
      10             : #include "../keyguard/fd_keyguard.h"
      11             : #include "../keyguard/fd_keyguard_client.h"
      12             : #include "../metrics/fd_metrics.h"
      13             : #include "../pack/fd_pack.h"
      14             : #include "../pack/fd_pack_cost.h"
      15             : #include "../pack/fd_pack_pacing.h"
      16             : 
      17             : #include <string.h>
      18             : 
      19             : /* fd_pack is responsible for taking verified transactions, and
      20             :    arranging them into "microblocks" (groups) of transactions to
      21             :    be executed serially.  It can try to do clever things so that
      22             :    multiple microblocks can execute in parallel, if they don't
      23             :    write to the same accounts. */
      24             : 
      25           0 : #define IN_KIND_RESOLV       (0UL)
      26           0 : #define IN_KIND_POH          (1UL)
      27           0 : #define IN_KIND_EXECLE       (2UL)
      28           0 : #define IN_KIND_SIGN         (3UL)
      29           0 : #define IN_KIND_REPLAY       (4UL)
      30           0 : #define IN_KIND_EXECUTED_TXN (5UL)
      31             : 
      32             : /* Pace microblocks, but only slightly.  This helps keep performance
      33             :    more stable.  This limit is 2,000 microblocks/second/execle.  At
      34             :    MAX_TXN_PER_MICROBLOCK transactions/microblock, that's
      35             :    2000*MAX_TXN_PER_MICROBLOCK txn/sec/execle. */
      36           0 : #define MICROBLOCK_DURATION_NS  (0L)
      37             : 
      38             : /* There are 151 accepted blockhashes, but those don't include skips.
      39             :    This check is neither precise nor accurate, but just good enough.
      40             :    The execle tile does the final check.  We give a little margin for a
      41             :    few percent skip rate. */
      42           0 : #define TRANSACTION_LIFETIME_SLOTS 160UL
      43             : 
      44             : /* Time is normally a long, but pack expects a ulong.  Add -LONG_MIN to
      45             :    the time values so that LONG_MIN maps to 0, LONG_MAX maps to
      46             :    ULONG_MAX, and everything in between maps linearly with a slope of 1.
      47             :    Just subtracting LONG_MIN results in signed integer overflow, which
      48             :    is U.B. */
      49             : #define TIME_OFFSET 0x8000000000000000UL
      50             : FD_STATIC_ASSERT( (ulong)LONG_MIN+TIME_OFFSET==0UL,       time_offset );
      51             : FD_STATIC_ASSERT( (ulong)LONG_MAX+TIME_OFFSET==ULONG_MAX, time_offset );
      52             : 
      53             : /* 1.6 M cost units, enough for 1 max size transaction */
      54             : const ulong CUS_PER_MICROBLOCK = 1600000UL;
      55             : 
      56             : #define SMALL_MICROBLOCKS 1
      57             : 
      58             : #if SMALL_MICROBLOCKS
      59             : const float VOTE_FRACTION = 1.0f; /* schedule all available votes first */
      60           0 : #define EFFECTIVE_TXN_PER_MICROBLOCK 1UL
      61             : #else
      62             : const float VOTE_FRACTION = 0.75f; /* TODO: Is this the right value? */
      63             : #define EFFECTIVE_TXN_PER_MICROBLOCK MAX_TXN_PER_MICROBLOCK
      64             : #endif
      65             : 
      66             : #if !SMALL_MICROBLOCKS
      67             : /* There's overhead associated with each microblock the execle tile
      68             :    tries to execute it, so the optimal strategy is not to produce a
      69             :    microblock with a single transaction as soon as we receive it.
      70             :    Basically, if we have less than MAX_TXN_PER_MICROBLOCK transactions,
      71             :    we want to wait a little to see if we receive additional transactions
      72             :    before we schedule a microblock.  We can model the optimum amount of
      73             :    time to wait, but the equation is complicated enough that we want to
      74             :    compute it before compile time. wait_duration[i] for i in
      75             :    [0, MAX_TXN_PER_MICROBLOCK] gives the time in nanoseconds pack should
      76             :    wait after receiving its most recent transaction before scheduling if
      77             :    it has i transactions available.  Unsurprisingly,
      78             :    wait_duration[MAX_TXN_PER_MICROBLOCK] is 0.  wait_duration[0] is
      79             :    ULONG_MAX, so we'll always wait if we have 0 transactions. */
      80             : FD_IMPORT( wait_duration, "src/disco/pack/pack_delay.bin", ulong, 6, "" );
      81             : #endif
      82             : 
      83             : 
      84             : 
      85             : #if FD_PACK_USE_EXTRA_STORAGE
      86             : /* When we are done being leader for a slot and we are leader in the
      87             :    very next slot, it can still take some time to transition.  This is
      88             :    because the bank has to be finalized, a hash calculated, and various
      89             :    other things done in the replay stage to create the new child bank.
      90             : 
      91             :    During that time, pack cannot send transactions to execles so it
      92             :    needs to be able to buffer.  Typically, these so called "leader
      93             :    transitions" are short (<15 millis), so a low value here would
      94             :    suffice.  However, in some cases when there is memory pressure on the
      95             :    NUMA node or when the operating system context switches relevant
      96             :    threads out, it can take significantly longer.
      97             : 
      98             :    To prevent drops in these cases and because we assume execles are
      99             :    fast enough to drain this buffer once we do become leader, we set
     100             :    this buffer size to be quite large. */
     101             : 
     102             : #define DEQUE_NAME extra_txn_deq
     103             : #define DEQUE_T    fd_txn_e_t
     104             : #define DEQUE_MAX  (128UL*1024UL)
     105             : #include "../../../../util/tmpl/fd_deque.c"
     106             : 
     107             : #endif
     108             : 
     109             : /* Sync with src/app/shared/fd_config.c */
     110           0 : #define FD_PACK_STRATEGY_PERF     0
     111           0 : #define FD_PACK_STRATEGY_BALANCED 1
     112             : 
     113             : static char const * const schedule_strategy_strings[2] = { "PRF", "BAL" };
     114             : 
     115             : 
     116             : typedef struct {
     117             :   fd_acct_addr_t commission_pubkey[1];
     118             :   ulong          commission;
     119             : } block_builder_info_t;
     120             : 
     121             : typedef struct {
     122             :   long time;
     123             :   ulong sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_CNT ];
     124             : } fd_pack_sched_results_snap_t;
     125             : 
     126             : typedef struct {
     127             :   fd_wksp_t * mem;
     128             :   ulong       chunk0;
     129             :   ulong       wmark;
     130             : } fd_pack_in_ctx_t;
     131             : 
     132             : typedef struct {
     133             :   fd_pack_t *  pack;
     134             :   fd_txn_e_t * cur_spot;
     135             :   int          is_bundle; /* is the current transaction a bundle */
     136             : 
     137             :   uchar executed_txn_sig[ 64UL ];
     138             :   uchar txn_committed;
     139             : 
     140             :   /* One of the FD_PACK_STRATEGY_* values defined above */
     141             :   int      strategy;
     142             : 
     143             :   /* The value passed to fd_pack_new, etc. */
     144             :   ulong    max_pending_transactions;
     145             : 
     146             :   /* The leader slot we are currently packing for, or ULONG_MAX if we
     147             :      are not the leader. */
     148             :   ulong  leader_slot;
     149             :   void const * leader_bank;
     150             :   ulong        leader_bank_idx;
     151             :   ulong        leader_bank_seq;
     152             : 
     153             :   fd_became_leader_t _became_leader[1];
     154             : 
     155             :   /* The number of microblocks we have packed for the current leader
     156             :      slot.  Will always be <= slot_max_microblocks.  We must track
     157             :      this so that when we are done we can tell the PoH tile how many
     158             :      microblocks to expect in the slot. */
     159             :   ulong slot_microblock_cnt;
     160             : 
     161             :   /* Counter which increments when we've finished packing for a slot */
     162             :   uint pack_idx;
     163             : 
     164             :   ulong pack_txn_cnt; /* total num transactions packed since startup */
     165             : 
     166             :   /* The maximum number of microblocks that can be packed in this slot.
     167             :      Provided by the PoH tile when we become leader.*/
     168             :   ulong slot_max_microblocks;
     169             : 
     170             :   /* Cap (in bytes) of the amount of transaction data we produce in each
     171             :      block to avoid hitting the shred limits.  See where this is set for
     172             :      more explanation. */
     173             :   ulong slot_max_data;
     174             :   int   larger_shred_limits_per_block;
     175             : 
     176             :   /* Consensus critical slot cost limits. */
     177             :   struct {
     178             :     ulong slot_max_cost;
     179             :     ulong slot_max_vote_cost;
     180             :     ulong slot_max_write_cost_per_acct;
     181             :     ulong slot_max_allocated_data_per_block;
     182             :     ulong slot_max_data_shreds;
     183             :   } limits;
     184             : 
     185             :   /* If drain_execle is non-zero, then the pack tile must wait until all
     186             :      execle are idle before scheduling any more microblocks.  This is
     187             :      primarily helpful in irregular leader transitions, e.g. while being
     188             :      leader for slot N, we switch forks to a slot M (!=N+1) in which we
     189             :      are also leader.  We don't want to execute microblocks for
     190             :      different slots concurrently. */
     191             :   int drain_execle;
     192             : 
     193             :   /* Updated during housekeeping and used only for checking if the
     194             :      leader slot has ended.  Might be off by one housekeeping duration,
     195             :      but that should be small relative to a slot duration. */
     196             :   long  approx_wallclock_ns;
     197             : 
     198             :   /* approx_tickcount is updated in during_housekeeping() with
     199             :      fd_tickcount() and will match approx_wallclock_ns.  This is done
     200             :      because we need to include an accurate nanosecond timestamp in
     201             :      every fd_txn_p_t but don't want to have to call the expensive
     202             :      fd_log_wallclock() in in the critical path. We can use
     203             :      fd_tempo_tick_per_ns() to convert from ticks to nanoseconds over
     204             :      small periods of time. */
     205             :   long  approx_tickcount;
     206             : 
     207             :   fd_rng_t * rng;
     208             : 
     209             :   /* The end wallclock time of the leader slot we are currently packing
     210             :      for, if we are currently packing for a slot.*/
     211             :   long slot_end_ns;
     212             : 
     213             :   /* The current dynamic upper bound on total microblocks for this slot.
     214             :      Monotonically decreasing over the slot lifetime. */
     215             :   ulong slot_dynamic_max_microblocks;
     216             : 
     217             :   /* Set by during_housekeeping when the dynamic bound drops below
     218             :      slot_max_microblocks.  Consumed by after_credit which publishes
     219             :      the updated bound to POH over the pack_poh link. */
     220             :   int pending_reduce_mb_bound;
     221             : 
     222             :   /* pacer and ticks_per_ns are used for pacing CUs through the slot,
     223             :      i.e. deciding when to schedule a microblock given the number of CUs
     224             :      that have been consumed so far.  pacer is an opaque pacing object,
     225             :      which is initialized when the pack tile is packing a slot.
     226             :      ticks_per_ns is the cached value from tempo. */
     227             :   fd_pack_pacing_t pacer[1];
     228             :   double           ticks_per_ns;
     229             : 
     230             :   /* last_successful_insert stores the tickcount of the last
     231             :      successful transaction insert. */
     232             :   long last_successful_insert;
     233             : 
     234             :   /* highest_observed_slot stores the highest slot number we've seen
     235             :      from any transaction coming from the resolv tile.  When this
     236             :      increases, we expire old transactions. */
     237             :   ulong highest_observed_slot;
     238             : 
     239             :   /* microblock_duration_ns, and wait_duration
     240             :      respectively scaled to be in ticks instead of nanoseconds */
     241             :   ulong microblock_duration_ticks;
     242             : #if !SMALL_MICROBLOCKS
     243             :   ulong wait_duration_ticks[ MAX_TXN_PER_MICROBLOCK+1UL ];
     244             : #endif
     245             : 
     246             : #if FD_PACK_USE_EXTRA_STORAGE
     247             :   /* In addition to the available transactions that pack knows about, we
     248             :      also store a larger ring buffer for handling cases when pack is
     249             :      full.  This is an fd_deque. */
     250             :   fd_txn_e_t * extra_txn_deq;
     251             :   int          insert_to_extra; /* whether the last insert was into pack or the extra deq */
     252             : #endif
     253             : 
     254             :   fd_pack_in_ctx_t in[ 32 ];
     255             :   int              in_kind[ 32 ];
     256             : 
     257             :   ulong    execle_cnt;
     258             :   ulong    execle_idle_bitset; /* bit i is 1 if we've observed *execle_current[i]==execle_expect[i] */
     259             :   int      poll_cursor; /* in [0, execle_cnt), the next execle to poll */
     260             :   int      use_consumed_cus;
     261             :   long     skip_cnt;
     262             :   ulong *  execle_current[ FD_PACK_MAX_EXECLE_TILES ];
     263             :   ulong    execle_expect[ FD_PACK_MAX_EXECLE_TILES  ];
     264             :   /* execle_ready_at[x] means don't check execle x until tickcount is at
     265             :      least execle_ready_at[x]. */
     266             :   long     execle_ready_at[ FD_PACK_MAX_EXECLE_TILES  ];
     267             : 
     268             :   fd_wksp_t * execle_out_mem;
     269             :   ulong       execle_out_chunk0;
     270             :   ulong       execle_out_wmark;
     271             :   ulong       execle_out_chunk;
     272             : 
     273             :   fd_wksp_t * poh_out_mem;
     274             :   ulong       poh_out_chunk0;
     275             :   ulong       poh_out_wmark;
     276             :   ulong       poh_out_chunk;
     277             : 
     278             :   ulong      insert_result[ FD_PACK_INSERT_RETVAL_CNT ];
     279             :   fd_histf_t schedule_duration[ 1 ];
     280             :   fd_histf_t no_sched_duration[ 1 ];
     281             :   fd_histf_t insert_duration  [ 1 ];
     282             :   fd_histf_t complete_duration[ 1 ];
     283             : 
     284             :   struct {
     285             :     uint metric_state;
     286             :     long metric_state_begin;
     287             :     long metric_timing[ 16 ];
     288             :   };
     289             : 
     290             :   /* last_sched_metrics is a snapshot of the schedule outcome counters
     291             :      during the last schedule which included at least one successful
     292             :      outcome. */
     293             :   fd_pack_sched_results_snap_t last_sched_metrics[ 1 ];
     294             : 
     295             :     /* last_sched_metrics is a snapshot of the schedule outcome counters
     296             :        at the last start-of-leader-block event. */
     297             :   fd_pack_sched_results_snap_t start_block_sched_metrics[ 1 ];
     298             : 
     299             :   struct {
     300             :     ulong id;
     301             :     ulong txn_cnt;
     302             :     ulong txn_received;
     303             :     ulong min_blockhash_slot;
     304             :     fd_txn_e_t * _txn[ FD_PACK_MAX_TXN_PER_BUNDLE ];
     305             :     fd_txn_e_t * const * bundle; /* points to _txn when non-NULL */
     306             :   } current_bundle[1];
     307             : 
     308             :   block_builder_info_t blk_engine_cfg[1];
     309             : 
     310             :   struct {
     311             :     int                   enabled;
     312             :     int                   ib_inserted; /* in this slot */
     313             :     fd_acct_addr_t        vote_pubkey[1];
     314             :     fd_acct_addr_t        identity_pubkey[1];
     315             :     fd_bundle_crank_gen_t gen[1];
     316             :     fd_acct_addr_t        tip_receiver_owner[1];
     317             :     ulong                 epoch;
     318             :     fd_bundle_crank_tip_payment_config_t prev_config[1]; /* as of start of slot, then updated */
     319             :     uchar                 recent_blockhash[32];
     320             :     fd_ed25519_sig_t      last_sig[1];
     321             : 
     322             :     fd_keyswitch_t *      keyswitch;
     323             :     fd_keyguard_client_t  keyguard_client[1];
     324             : 
     325             :     ulong                 metrics[4];
     326             :   } crank[1];
     327             : 
     328             : 
     329             :   /* Used between during_frag and after_frag */
     330             :   ulong pending_rebate_sz;
     331             :   union{ fd_pack_rebate_t rebate[1]; uchar footprint[USHORT_MAX]; } rebate[1];
     332             : } fd_pack_ctx_t;
     333             : 
     334           0 : #define BUNDLE_META_SZ 40UL
     335             : FD_STATIC_ASSERT( sizeof(block_builder_info_t)==BUNDLE_META_SZ, blk_engine_cfg );
     336             : 
     337           0 : #define FD_PACK_METRIC_STATE_TRANSACTIONS 0
     338           0 : #define FD_PACK_METRIC_STATE_EXECLES      1
     339           0 : #define FD_PACK_METRIC_STATE_LEADER       2
     340           0 : #define FD_PACK_METRIC_STATE_MICROBLOCKS  3
     341             : 
     342             : /* Updates one component of the metric state.  If the state has changed,
     343             :    records the change. */
     344             : static inline void
     345             : update_metric_state( fd_pack_ctx_t * ctx,
     346             :                      long            effective_as_of,
     347             :                      int             type,
     348           0 :                      int             status ) {
     349           0 :   uint current_state = fd_uint_insert_bit( ctx->metric_state, type, status );
     350           0 :   if( FD_UNLIKELY( current_state!=ctx->metric_state ) ) {
     351           0 :     ctx->metric_timing[ ctx->metric_state ] += effective_as_of - ctx->metric_state_begin;
     352           0 :     ctx->metric_state_begin = effective_as_of;
     353           0 :     ctx->metric_state = current_state;
     354           0 :   }
     355           0 : }
     356             : 
     357             : static inline void
     358           0 : remove_ib( fd_pack_ctx_t * ctx ) {
     359             :   /* It's likely the initializer bundle is long scheduled, but we want to
     360             :      try deleting it just in case. */
     361           0 :   if( FD_UNLIKELY( ctx->crank->enabled & ctx->crank->ib_inserted ) ) {
     362           0 :     ulong deleted = fd_pack_delete_transaction( ctx->pack, (fd_ed25519_sig_t const *)ctx->crank->last_sig );
     363           0 :     FD_MCNT_INC( PACK, TXN_DELETED, deleted );
     364           0 :   }
     365           0 :   ctx->crank->ib_inserted = 0;
     366           0 : }
     367             : 
     368             : 
     369             : FD_FN_CONST static inline ulong
     370           0 : scratch_align( void ) {
     371           0 :   return 4096UL;
     372           0 : }
     373             : 
     374             : FD_FN_PURE static inline ulong
     375           0 : scratch_footprint( fd_topo_tile_t const * tile ) {
     376           0 :   fd_pack_limits_t limits[1] = {{
     377           0 :     .max_cost_per_block           = tile->pack.larger_max_cost_per_block ? LARGER_MAX_COST_PER_BLOCK : FD_PACK_MAX_COST_PER_BLOCK_UPPER_BOUND,
     378           0 :     .max_vote_cost_per_block      = FD_PACK_MAX_VOTE_COST_PER_BLOCK_UPPER_BOUND,
     379           0 :     .max_write_cost_per_acct      = FD_PACK_MAX_WRITE_COST_PER_ACCT_UPPER_BOUND,
     380           0 :     .max_data_bytes_per_block     = tile->pack.larger_shred_limits_per_block ? LARGER_MAX_DATA_PER_BLOCK : FD_PACK_MAX_DATA_PER_BLOCK,
     381           0 :     .max_txn_per_microblock       = EFFECTIVE_TXN_PER_MICROBLOCK,
     382           0 :     .max_microblocks_per_block    = (ulong)UINT_MAX, /* Limit not known yet */
     383           0 :     .max_allocated_data_per_block = FD_PACK_MAX_ALLOCATED_DATA_PER_BLOCK,
     384           0 :   }};
     385             : 
     386           0 :   ulong l = FD_LAYOUT_INIT;
     387           0 :   l = FD_LAYOUT_APPEND( l, alignof( fd_pack_ctx_t ), sizeof( fd_pack_ctx_t )                                   );
     388           0 :   l = FD_LAYOUT_APPEND( l, fd_rng_align(),           fd_rng_footprint()                                        );
     389           0 :   l = FD_LAYOUT_APPEND( l, fd_pack_align(),          fd_pack_footprint( tile->pack.max_pending_transactions,
     390           0 :                                                                         BUNDLE_META_SZ,
     391           0 :                                                                         tile->pack.execle_tile_count,
     392           0 :                                                                         limits                               ) );
     393             : #if FD_PACK_USE_EXTRA_STORAGE
     394             :   l = FD_LAYOUT_APPEND( l, extra_txn_deq_align(),    extra_txn_deq_footprint()                                 );
     395             : #endif
     396           0 :   return FD_LAYOUT_FINI( l, scratch_align() );
     397           0 : }
     398             : 
     399             : static inline void
     400             : log_end_block_metrics( fd_pack_ctx_t * ctx,
     401             :                        long            now,
     402             :                        char const    * reason,
     403           0 :                        ulong           cus_consumed_in_block ) {
     404           0 : #define DELTA( m ) (fd_metrics_tl[ MIDX(COUNTER, PACK, TXN_SCHEDULED_##m) ] - ctx->last_sched_metrics->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_##m##_IDX ])
     405           0 : #define AVAIL( m ) (fd_metrics_tl[ MIDX(GAUGE, PACK, TXN_AVAILABLE_##m) ])
     406           0 :     FD_LOG_INFO(( "pack_end_block(slot=%lu,%s,%lx,ticks_since_last_schedule=%ld,reasons=%lu,%lu,%lu,%lu,%lu,%lu,%lu,%lu;remaining=%lu+%lu+%lu+%lu;smallest=%lu;cus=%lu->%lu)",
     407           0 :           ctx->leader_slot, reason, ctx->execle_idle_bitset, now-ctx->last_sched_metrics->time,
     408           0 :           DELTA( TAKEN ), DELTA( CU_LIMIT ), DELTA( FAST_PATH ), DELTA( BYTE_LIMIT ), DELTA( ALLOC_LIMIT ), DELTA( WRITE_COST ), DELTA( SLOW_PATH ), DELTA( DEFER_SKIP ),
     409           0 :           AVAIL(REGULAR), AVAIL(VOTES), AVAIL(BUNDLES), AVAIL(CONFLICTING),
     410           0 :           (fd_metrics_tl[ MIDX(GAUGE, PACK, TXN_PENDING_SMALLEST_CU) ]),
     411           0 :           (cus_consumed_in_block),
     412           0 :           (fd_metrics_tl[ MIDX(GAUGE, PACK, BLOCK_CU_CONSUMED) ])
     413           0 :     ));
     414           0 : #undef AVAIL
     415           0 : #undef DELTA
     416           0 : }
     417             : 
     418             : static inline void
     419           0 : get_done_packing( fd_pack_ctx_t * ctx, fd_done_packing_t * done_packing, int reason ) {
     420           0 :     done_packing->microblocks_in_slot = ctx->slot_microblock_cnt;
     421           0 :     done_packing->end_slot_reason = reason;
     422           0 :     fd_pack_get_block_limits( ctx->pack, done_packing->limits_usage, done_packing->limits );
     423             : 
     424           0 : #define DELTA( mem, m ) (fd_metrics_tl[ MIDX(COUNTER, PACK, TXN_SCHEDULED_##m) ] - ctx->mem->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_##m##_IDX ])
     425           0 :     done_packing->block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_TAKEN_IDX       ] = DELTA( start_block_sched_metrics, TAKEN       );
     426           0 :     done_packing->block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_CU_LIMIT_IDX    ] = DELTA( start_block_sched_metrics, CU_LIMIT    );
     427           0 :     done_packing->block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_FAST_PATH_IDX   ] = DELTA( start_block_sched_metrics, FAST_PATH   );
     428           0 :     done_packing->block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_BYTE_LIMIT_IDX  ] = DELTA( start_block_sched_metrics, BYTE_LIMIT  );
     429           0 :     done_packing->block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_ALLOC_LIMIT_IDX ] = DELTA( start_block_sched_metrics, ALLOC_LIMIT );
     430           0 :     done_packing->block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_WRITE_COST_IDX  ] = DELTA( start_block_sched_metrics, WRITE_COST  );
     431           0 :     done_packing->block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_SLOW_PATH_IDX   ] = DELTA( start_block_sched_metrics, SLOW_PATH   );
     432           0 :     done_packing->block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_DEFER_SKIP_IDX  ] = DELTA( start_block_sched_metrics, DEFER_SKIP  );
     433             : 
     434           0 :     done_packing->end_block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_TAKEN_IDX       ] = DELTA( last_sched_metrics, TAKEN       );
     435           0 :     done_packing->end_block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_CU_LIMIT_IDX    ] = DELTA( last_sched_metrics, CU_LIMIT    );
     436           0 :     done_packing->end_block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_FAST_PATH_IDX   ] = DELTA( last_sched_metrics, FAST_PATH   );
     437           0 :     done_packing->end_block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_BYTE_LIMIT_IDX  ] = DELTA( last_sched_metrics, BYTE_LIMIT  );
     438           0 :     done_packing->end_block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_ALLOC_LIMIT_IDX ] = DELTA( last_sched_metrics, ALLOC_LIMIT );
     439           0 :     done_packing->end_block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_WRITE_COST_IDX  ] = DELTA( last_sched_metrics, WRITE_COST  );
     440           0 :     done_packing->end_block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_SLOW_PATH_IDX   ] = DELTA( last_sched_metrics, SLOW_PATH   );
     441           0 :     done_packing->end_block_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_DEFER_SKIP_IDX  ] = DELTA( last_sched_metrics, DEFER_SKIP  );
     442           0 : #undef DELTA
     443             : 
     444           0 :   fd_pack_get_pending_smallest( ctx->pack, done_packing->pending_smallest, done_packing->pending_votes_smallest );
     445           0 : }
     446             : 
     447             : static inline void
     448           0 : metrics_write( fd_pack_ctx_t * ctx ) {
     449           0 :   FD_MCNT_ENUM_COPY( PACK, TXN_INSERTED,          ctx->insert_result  );
     450           0 :   FD_MCNT_ENUM_COPY( PACK, STATE_DURATION_NANOS,        ((ulong*)ctx->metric_timing) );
     451           0 :   FD_MCNT_ENUM_COPY( PACK, BUNDLE_CRANK_RESULT,           ctx->crank->metrics );
     452           0 :   FD_MHIST_COPY( PACK, SCHEDULE_MICROBLOCK_DURATION_SECONDS, ctx->schedule_duration );
     453           0 :   FD_MHIST_COPY( PACK, NO_SCHEDULE_MICROBLOCK_DURATION_SECONDS, ctx->no_sched_duration );
     454           0 :   FD_MHIST_COPY( PACK, INSERT_TRANSACTION_DURATION_SECONDS,  ctx->insert_duration   );
     455           0 :   FD_MHIST_COPY( PACK, COMPLETE_MICROBLOCK_DURATION_SECONDS, ctx->complete_duration );
     456             : 
     457           0 :   fd_pack_metrics_write( ctx->pack );
     458           0 : }
     459             : 
     460             : /* compute_dynamic_max_microblocks: Computes the upper bound on total
     461             :    microblocks based on remaining time and bank count.
     462             : 
     463             :    The basic idea here is that if there is 1ms left in the slot, we
     464             :    don't expect to schedule 130k microblocks.  We can reduce our
     465             :    remaining budget which allows POH to advance hashing a bit further
     466             :    and avoid having to do a lot of hashing after the slot ends.
     467             : 
     468             :    The fastest we can execute a transaction is about 1us.  With n
     469             :    execle tiles, that means we can execute at most n txn/us.  If we have
     470             :    k ms left in the block, only reserve up to k*n*1000 microblocks. */
     471             : 
     472             : static inline ulong
     473           0 : compute_dynamic_max_microblocks( fd_pack_ctx_t * ctx ) {
     474           0 :   long  now = ctx->approx_wallclock_ns + (long)((double)(fd_tickcount() - ctx->approx_tickcount) / ctx->ticks_per_ns);
     475           0 :   long  end = ctx->slot_end_ns;
     476             : 
     477             :   /* If the slot has ended, don't reserve any more microblocks. */
     478           0 :   if( FD_UNLIKELY( now>=end ) ) return ctx->slot_microblock_cnt;
     479             : 
     480             :   /* remaining_ns * n / 1000 = (remaining_ns/1e6 ms) * n * 1000.
     481             : 
     482             :      Overflow: remaining_ns is at most ~4e8, n at most 64, so
     483             :      remaining_ns * n is at most ~2.6e10 << 1.8e19. */
     484             : 
     485           0 :   ulong remaining_ns = (ulong)(end - now);
     486           0 :   ulong n            = ctx->execle_cnt;
     487           0 :   ulong cnt          = ctx->slot_microblock_cnt;
     488           0 :   ulong R            = ctx->slot_max_microblocks - cnt;
     489           0 :   ulong can_execute  = remaining_ns * n / 1000UL;
     490             : 
     491           0 :   return cnt + fd_ulong_min( R, can_execute );
     492           0 : }
     493             : 
     494             : static inline void
     495           0 : during_housekeeping( fd_pack_ctx_t * ctx ) {
     496           0 :   ctx->approx_wallclock_ns = fd_log_wallclock();
     497           0 :   ctx->approx_tickcount = fd_tickcount();
     498             : 
     499           0 :   if( FD_UNLIKELY( ctx->crank->enabled && fd_keyswitch_state_query( ctx->crank->keyswitch )==FD_KEYSWITCH_STATE_SWITCH_PENDING ) ) {
     500           0 :     fd_memcpy( ctx->crank->identity_pubkey, ctx->crank->keyswitch->bytes, 32UL );
     501           0 :     fd_keyswitch_state( ctx->crank->keyswitch, FD_KEYSWITCH_STATE_COMPLETED );
     502           0 :   }
     503             : 
     504           0 :   if( FD_LIKELY( ctx->leader_slot!=ULONG_MAX ) ) {
     505           0 :     ulong raw = compute_dynamic_max_microblocks( ctx );
     506           0 :     ulong prev = ctx->slot_dynamic_max_microblocks;
     507             : 
     508             :     /* Enforce monotonically decreasing. This ensures pack's bound is
     509             :        always smaller than POH's.  */
     510           0 :     ctx->slot_dynamic_max_microblocks = fd_ulong_min( raw, prev );
     511             : 
     512             :     /* If the bound decreased, we must update pack's internal scheduling
     513             :        limit.  Otherwise, pack could schedule a microblock that exceeds
     514             :        the remaining capacity from the tile's and poh's perspectives
     515             :        (e.g. pack might produce a 5-transaction microblock when only 4
     516             :        microblocks worth of space remain). */
     517           0 :     if( FD_UNLIKELY( ctx->slot_dynamic_max_microblocks < prev ) ) {
     518           0 :       fd_pack_limits_t limits[1];
     519           0 :       limits->max_cost_per_block           = ctx->limits.slot_max_cost;
     520           0 :       limits->max_data_bytes_per_block     = ctx->slot_max_data;
     521           0 :       limits->max_microblocks_per_block    = ctx->slot_dynamic_max_microblocks;
     522           0 :       limits->max_vote_cost_per_block      = ctx->limits.slot_max_vote_cost;
     523           0 :       limits->max_write_cost_per_acct      = ctx->limits.slot_max_write_cost_per_acct;
     524           0 :       limits->max_txn_per_microblock       = ULONG_MAX; /* unused */
     525           0 :       limits->max_allocated_data_per_block = ctx->limits.slot_max_allocated_data_per_block;
     526           0 :       fd_pack_set_block_limits( ctx->pack, limits );
     527             : 
     528           0 :       ctx->pending_reduce_mb_bound = 1; /* publish bound decrease */
     529           0 :     }
     530           0 :   }
     531           0 : }
     532             : 
     533             : static inline void
     534             : before_credit( fd_pack_ctx_t *     ctx,
     535             :                fd_stem_context_t * stem,
     536           0 :                int *               charge_busy ) {
     537           0 :   (void)stem;
     538             : 
     539           0 :   if( FD_UNLIKELY( (ctx->cur_spot!=NULL) & !ctx->is_bundle ) ) {
     540           0 :     *charge_busy = 1;
     541             : 
     542             :     /* If we were overrun while processing a frag from an in, then
     543             :        cur_spot is left dangling and not cleaned up, so clean it up here
     544             :        (by returning the slot to the pool of free slots).  If the last
     545             :        transaction was a bundle, then we don't want to return it.  When
     546             :        we try to process the first transaction in the next bundle, we'll
     547             :        see we never got the full bundle and cancel the whole last
     548             :        bundle, returning all the storage to the pool. */
     549             : #if FD_PACK_USE_EXTRA_STORAGE
     550             :     if( FD_LIKELY( !ctx->insert_to_extra ) ) fd_pack_insert_txn_cancel( ctx->pack, ctx->cur_spot );
     551             :     else                                     extra_txn_deq_remove_tail( ctx->extra_txn_deq       );
     552             : #else
     553           0 :     fd_pack_insert_txn_cancel( ctx->pack, ctx->cur_spot );
     554           0 : #endif
     555           0 :     ctx->cur_spot = NULL;
     556           0 :   }
     557           0 : }
     558             : 
     559             : #if FD_PACK_USE_EXTRA_STORAGE
     560             : /* insert_from_extra: helper method to pop the transaction at the head
     561             :    off the extra txn deque and insert it into pack.  Requires that
     562             :    ctx->extra_txn_deq is non-empty, but it's okay to call it if pack is
     563             :    full.  Returns the result of fd_pack_insert_txn_fini. */
     564             : static inline int
     565             : insert_from_extra( fd_pack_ctx_t * ctx ) {
     566             :   fd_txn_e_t       * spot       = fd_pack_insert_txn_init( ctx->pack );
     567             :   fd_txn_e_t const * insert     = extra_txn_deq_peek_head( ctx->extra_txn_deq );
     568             :   fd_txn_t   const * insert_txn = TXN(insert->txnp);
     569             :   fd_memcpy( spot->txnp->payload, insert->txnp->payload, insert->txnp->payload_sz                                                     );
     570             :   fd_memcpy( TXN(spot->txnp),     insert_txn,            fd_txn_footprint( insert_txn->instr_cnt, insert_txn->addr_table_lookup_cnt ) );
     571             :   fd_memcpy( spot->alt_accts,     insert->alt_accts,     insert_txn->addr_table_adtl_cnt*sizeof(fd_acct_addr_t)                       );
     572             :   spot->txnp->payload_sz = insert->txnp->payload_sz;
     573             :   spot->txnp->source_tpu  = insert->txnp->source_tpu;
     574             :   spot->txnp->source_ipv4 = insert->txnp->source_ipv4;
     575             :   spot->txnp->scheduler_arrival_time_nanos = insert->txnp->scheduler_arrival_time_nanos;
     576             :   extra_txn_deq_remove_head( ctx->extra_txn_deq );
     577             : 
     578             :   ulong blockhash_slot = insert->txnp->blockhash_slot;
     579             : 
     580             :   ulong deleted;
     581             :   long insert_duration = -fd_tickcount();
     582             :   int result = fd_pack_insert_txn_fini( ctx->pack, spot, blockhash_slot, &deleted );
     583             :   insert_duration      += fd_tickcount();
     584             : 
     585             :   FD_MCNT_INC( PACK, TXN_DELETED, deleted );
     586             :   ctx->insert_result[ result + FD_PACK_INSERT_RETVAL_OFF ]++;
     587             :   fd_histf_sample( ctx->insert_duration, (ulong)insert_duration );
     588             :   FD_MCNT_INC( PACK, TXN_EXTRA_RETRIEVED, 1UL );
     589             :   return result;
     590             : }
     591             : #endif
     592             : 
     593             : static inline void
     594             : after_credit( fd_pack_ctx_t *     ctx,
     595             :               fd_stem_context_t * stem,
     596             :               int *               opt_poll_in FD_PARAM_UNUSED,
     597           0 :               int *               charge_busy ) {
     598           0 :   if( FD_UNLIKELY( (ctx->skip_cnt--)>0L ) ) return; /* It would take ages for this to hit LONG_MIN */
     599             : 
     600           0 :   long now = fd_tickcount();
     601             : 
     602           0 :   int pacing_execle_cnt = (int)fd_pack_pacing_enabled_bank_cnt( ctx->pacer, now );
     603             : 
     604           0 :   ulong execle_cnt = ctx->execle_cnt;
     605             : 
     606             : 
     607             :   /* If any execle are busy, check one of the busy ones see if it is
     608             :      still busy. */
     609           0 :   if( FD_LIKELY( ctx->execle_idle_bitset!=fd_ulong_mask_lsb( (int)execle_cnt ) ) ) {
     610           0 :     int   poll_cursor = ctx->poll_cursor;
     611           0 :     ulong busy_bitset = (~ctx->execle_idle_bitset) & fd_ulong_mask_lsb( (int)execle_cnt );
     612             : 
     613             :     /* Suppose execle_cnt is 4 and idle_bitset looks something like this
     614             :        (pretending it's a uchar):
     615             :                 0000 1001
     616             :                        ^ busy cursor is 1
     617             :        Then busy_bitset is
     618             :                 0000 0110
     619             :        Rotate it right by 2 bits
     620             :                 1000 0001
     621             :        Find lsb returns 0, so busy cursor remains 2, and we poll
     622             :        execle 2.
     623             : 
     624             :        If instead idle_bitset were
     625             :                 0000 1110
     626             :                        ^
     627             :        The rotated version would be
     628             :                 0100 0000
     629             :        Find lsb will return 6, so busy cursor would be set to 0, and
     630             :        we'd poll execle 0, which is the right one. */
     631           0 :     poll_cursor++;
     632           0 :     poll_cursor = (poll_cursor + fd_ulong_find_lsb( fd_ulong_rotate_right( busy_bitset, (poll_cursor&63) ) )) & 63;
     633             : 
     634           0 :     if( FD_UNLIKELY(
     635             :         /* if microblock duration is 0, bypass the execle_ready_at check
     636             :            to avoid a potential cache miss.  Can't use an ifdef here
     637             :            because FD_UNLIKELY is a macro, but the compiler should
     638             :            eliminate the check easily. */
     639           0 :         ( (MICROBLOCK_DURATION_NS==0L) || (ctx->execle_ready_at[poll_cursor]<now) ) &&
     640           0 :         (fd_fseq_query( ctx->execle_current[poll_cursor] )==ctx->execle_expect[poll_cursor]) ) ) {
     641           0 :       *charge_busy = 1;
     642           0 :       ctx->execle_idle_bitset |= 1UL<<poll_cursor;
     643             : 
     644           0 :       long complete_duration = -fd_tickcount();
     645           0 :       int completed = fd_pack_microblock_complete( ctx->pack, (ulong)poll_cursor );
     646           0 :       complete_duration      += fd_tickcount();
     647           0 :       if( FD_LIKELY( completed ) ) fd_histf_sample( ctx->complete_duration, (ulong)complete_duration );
     648           0 :     }
     649             : 
     650           0 :     ctx->poll_cursor = poll_cursor;
     651           0 :   }
     652             : 
     653             : 
     654             :   /* If we time out on our slot, then stop being leader.  This can only
     655             :      happen in the first after_credit after a housekeeping. */
     656           0 :   if( FD_UNLIKELY( ctx->approx_wallclock_ns>=ctx->slot_end_ns && ctx->leader_slot!=ULONG_MAX ) ) {
     657           0 :     *charge_busy = 1;
     658             : 
     659           0 :     fd_done_packing_t * done_packing = fd_chunk_to_laddr( ctx->poh_out_mem, ctx->poh_out_chunk );
     660           0 :     get_done_packing( ctx, done_packing, FD_PACK_END_SLOT_REASON_TIME ); /* needs to be called before fd_pack_end_block */
     661           0 :     fd_pack_end_block( ctx->pack );
     662           0 :     fd_pack_get_top_writers( ctx->pack, done_packing->limits_usage->top_writers ); /* needs to be called after fd_pack_end_block */
     663             : 
     664           0 :     fd_stem_publish( stem, 1UL, fd_disco_execle_sig( ctx->leader_slot, ctx->pack_idx ), ctx->poh_out_chunk, sizeof(fd_done_packing_t), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
     665           0 :     ctx->poh_out_chunk = fd_dcache_compact_next( ctx->poh_out_chunk, sizeof(fd_done_packing_t), ctx->poh_out_chunk0, ctx->poh_out_wmark );
     666           0 :     ctx->pack_idx++;
     667             : 
     668           0 :     log_end_block_metrics( ctx, now, "time", done_packing->limits_usage->block_cost );
     669           0 :     ctx->drain_execle        = 1;
     670           0 :     ctx->leader_slot         = ULONG_MAX;
     671           0 :     ctx->slot_microblock_cnt = 0UL;
     672           0 :     remove_ib( ctx );
     673             : 
     674           0 :     update_metric_state( ctx, now, FD_PACK_METRIC_STATE_LEADER,       0 );
     675           0 :     update_metric_state( ctx, now, FD_PACK_METRIC_STATE_EXECLES,      0 );
     676           0 :     update_metric_state( ctx, now, FD_PACK_METRIC_STATE_MICROBLOCKS,  0 );
     677           0 :     return;
     678           0 :   }
     679             : 
     680             :   /* Am I leader? If not, see about inserting at most one transaction
     681             :      from extra storage.  It's important not to insert too many
     682             :      transactions here, or we won't end up servicing dedup_pack enough.
     683             :      If extra storage is empty or pack is full, do nothing. */
     684           0 :   if( FD_UNLIKELY( ctx->leader_slot==ULONG_MAX ) ) {
     685             : #if FD_PACK_USE_EXTRA_STORAGE
     686             :     if( FD_UNLIKELY( !extra_txn_deq_empty( ctx->extra_txn_deq ) &&
     687             :          fd_pack_avail_txn_cnt( ctx->pack )<ctx->max_pending_transactions ) ) {
     688             :       *charge_busy = 1;
     689             : 
     690             :       int result = insert_from_extra( ctx );
     691             :       if( FD_LIKELY( result>=0 ) ) ctx->last_successful_insert = now;
     692             :     }
     693             : #endif
     694           0 :     return;
     695           0 :   }
     696             : 
     697             :   /* Am I in drain mode?  If so, check if I can exit it */
     698           0 :   if( FD_UNLIKELY( ctx->drain_execle ) ) {
     699           0 :     if( FD_LIKELY( ctx->execle_idle_bitset==fd_ulong_mask_lsb( (int)execle_cnt ) ) ) {
     700           0 :       ctx->drain_execle = 0;
     701             : 
     702             :       /* Pack notifies poh when execle are drained so that poh can
     703             :          relinquish pack's ownership over the slot execle (by decrementing
     704             :          its Arc). We do this by sending a FD_PACK_MSG_DONE_DRAINING
     705             :          sig over the pack_poh mcache.
     706             : 
     707             :          TODO: This is only needed for Frankendancer, not Firedancer,
     708             :          which manages bank lifetime different. */
     709           0 :       fd_stem_publish( stem, 1UL, FD_PACK_MSG_DONE_DRAINING, 0UL, 0UL, 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
     710           0 :       *charge_busy = 1;
     711           0 :       return;
     712           0 :     } else {
     713           0 :       return;
     714           0 :     }
     715           0 :   }
     716             : 
     717           0 :   if( FD_UNLIKELY( ctx->pending_reduce_mb_bound ) ) {
     718           0 :     ctx->pending_reduce_mb_bound = 0;
     719           0 :     ulong * dst = fd_chunk_to_laddr( ctx->poh_out_mem, ctx->poh_out_chunk );
     720           0 :     *dst = ctx->slot_dynamic_max_microblocks;
     721           0 :     fd_stem_publish( stem, 1UL, FD_PACK_MSG_REDUCE_MB_BOUND, ctx->poh_out_chunk, sizeof(ulong), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
     722           0 :     ctx->poh_out_chunk = fd_dcache_compact_next( ctx->poh_out_chunk, sizeof(ulong), ctx->poh_out_chunk0, ctx->poh_out_wmark );
     723           0 :     *charge_busy = 1;
     724           0 :     return;
     725           0 :   }
     726             : 
     727             :   /* Have I sent the max allowed microblocks? Nothing to do. */
     728           0 :   if( FD_UNLIKELY( ctx->slot_microblock_cnt>=ctx->slot_dynamic_max_microblocks ) ) return;
     729             : 
     730             :   /* Do I have enough transactions and/or have I waited enough time? */
     731             : #if !SMALL_MICROBLOCKS
     732             :   if( FD_UNLIKELY( (ulong)(now-ctx->last_successful_insert) <
     733             :         ctx->wait_duration_ticks[ fd_ulong_min( fd_pack_avail_txn_cnt( ctx->pack ), MAX_TXN_PER_MICROBLOCK ) ] ) ) {
     734             :     update_metric_state( ctx, now, FD_PACK_METRIC_STATE_TRANSACTIONS, 0 );
     735             :     return;
     736             :   }
     737             : #endif
     738             : 
     739           0 :   int any_ready     = 0;
     740           0 :   int any_scheduled = 0;
     741             : 
     742           0 :   *charge_busy = 1;
     743             : 
     744           0 :   if( FD_LIKELY( ctx->crank->enabled ) ) {
     745           0 :     block_builder_info_t const * top_meta = fd_pack_peek_bundle_meta( ctx->pack );
     746           0 :     if( FD_UNLIKELY( top_meta ) ) {
     747             :       /* Have bundles, in a reasonable state to crank. */
     748             : 
     749           0 :       fd_txn_e_t * _bundle[ 1UL ];
     750           0 :       fd_txn_e_t * const * bundle = fd_pack_insert_bundle_init( ctx->pack, _bundle, 1UL );
     751             : 
     752           0 :       ulong txn_sz = fd_bundle_crank_generate( ctx->crank->gen, ctx->crank->prev_config, top_meta->commission_pubkey,
     753           0 :           ctx->crank->identity_pubkey, ctx->crank->tip_receiver_owner, ctx->crank->epoch, top_meta->commission,
     754           0 :           bundle[0]->txnp->payload, TXN( bundle[0]->txnp ) );
     755             : 
     756           0 :       if( FD_LIKELY( txn_sz==0UL ) ) { /* Everything in good shape! */
     757           0 :         fd_pack_insert_bundle_cancel( ctx->pack, bundle, 1UL );
     758           0 :         fd_pack_set_initializer_bundles_ready( ctx->pack );
     759           0 :         ctx->crank->metrics[ 0 ]++; /* BUNDLE_CRANK_RESULT_NOT_NEEDED */
     760           0 :       }
     761           0 :       else if( FD_LIKELY( txn_sz<ULONG_MAX ) ) {
     762           0 :         bundle[0]->txnp->payload_sz  = (ushort)txn_sz;
     763           0 :         bundle[0]->txnp->source_tpu  = FD_TXN_M_TPU_SOURCE_BUNDLE;
     764           0 :         bundle[0]->txnp->source_ipv4 = 0; /* not applicable */
     765           0 :         bundle[0]->txnp->scheduler_arrival_time_nanos = ctx->approx_wallclock_ns + (long)((double)(fd_tickcount() - ctx->approx_tickcount) / ctx->ticks_per_ns);
     766           0 :         memcpy( bundle[0]->txnp->payload+TXN(bundle[0]->txnp)->recent_blockhash_off, ctx->crank->recent_blockhash, 32UL );
     767             : 
     768           0 :         fd_keyguard_client_sign( ctx->crank->keyguard_client, bundle[0]->txnp->payload+1UL,
     769           0 :             bundle[0]->txnp->payload+65UL, txn_sz-65UL, FD_KEYGUARD_SIGN_TYPE_ED25519 );
     770             : 
     771           0 :         memcpy( ctx->crank->last_sig, bundle[0]->txnp->payload+1UL, 64UL );
     772             : 
     773           0 :         ctx->crank->ib_inserted = 1;
     774           0 :         ulong deleted;
     775           0 :         int retval = fd_pack_insert_bundle_fini( ctx->pack, bundle, 1UL, ctx->leader_slot-1UL, 1, NULL, &deleted );
     776           0 :         FD_MCNT_INC( PACK, TXN_DELETED, deleted );
     777           0 :         ctx->insert_result[ retval + FD_PACK_INSERT_RETVAL_OFF ]++;
     778           0 :         if( FD_UNLIKELY( retval<0 ) ) {
     779           0 :           ctx->crank->metrics[ 3 ]++; /* BUNDLE_CRANK_RESULT_INSERTION_FAILED */
     780           0 :           FD_LOG_WARNING(( "inserting initializer bundle returned %i", retval ));
     781           0 :         } else {
     782             :           /* Update the cached copy of the on-chain state.  This seems a
     783             :              little dangerous, since we're updating it as if the bundle
     784             :              succeeded without knowing if that's true, but here's why
     785             :              it's safe:
     786             : 
     787             :              From now until we get the rebate call for this initializer
     788             :              bundle (which lets us know if it succeeded or failed), pack
     789             :              will be in [Pending] state, which means peek_bundle_meta
     790             :              will return NULL, so we won't read this state.
     791             : 
     792             :              Then, if the initializer bundle failed, we'll go into
     793             :              [Failed] IB state until the end of the block, which will
     794             :              cause top_meta to remain NULL so we don't read these values
     795             :              again.
     796             : 
     797             :              Otherwise, the initializer bundle succeeded, which means
     798             :              that these are the right values to use. */
     799           0 :           fd_bundle_crank_apply( ctx->crank->gen, ctx->crank->prev_config, top_meta->commission_pubkey,
     800           0 :                                  ctx->crank->tip_receiver_owner, ctx->crank->epoch, top_meta->commission );
     801           0 :           ctx->crank->metrics[ 1 ]++; /* BUNDLE_CRANK_RESULT_INSERTED */
     802           0 :         }
     803           0 :       } else {
     804             :         /* Already logged a warning in this case */
     805           0 :         fd_pack_insert_bundle_cancel( ctx->pack, bundle, 1UL );
     806           0 :         ctx->crank->metrics[ 2 ]++; /* BUNDLE_CRANK_RESULT_CREATION_FAILED' */
     807           0 :       }
     808           0 :     }
     809           0 :   }
     810             : 
     811             :   /* Try to schedule the next microblock. */
     812           0 :   if( FD_LIKELY( ctx->execle_idle_bitset ) ) { /* Optimize for schedule */
     813           0 :     any_ready = 1;
     814             : 
     815           0 :     int i = fd_ulong_find_lsb( ctx->execle_idle_bitset );
     816             : 
     817           0 :     int flags;
     818             : 
     819           0 :     switch( ctx->strategy ) {
     820           0 :       default:
     821           0 :       case FD_PACK_STRATEGY_PERF:
     822           0 :         flags = FD_PACK_SCHEDULE_VOTE | FD_PACK_SCHEDULE_BUNDLE | FD_PACK_SCHEDULE_TXN;
     823           0 :         break;
     824           0 :       case FD_PACK_STRATEGY_BALANCED:
     825             :         /* We want to exempt votes from pacing, so we always allow
     826             :            scheduling votes.  It doesn't really make much sense to pace
     827             :            bundles, because they get scheduled in FIFO order.  However,
     828             :            we keep pacing for normal transactions.  For example, if
     829             :            pacing_execle_cnt is 0, then pack won't schedule normal
     830             :            transactions to any execle tile. */
     831           0 :         flags = FD_PACK_SCHEDULE_VOTE | fd_int_if( i==0,                FD_PACK_SCHEDULE_BUNDLE, 0 )
     832           0 :                                       | fd_int_if( i<pacing_execle_cnt, FD_PACK_SCHEDULE_TXN,    0 );
     833           0 :         break;
     834           0 :     }
     835             : 
     836           0 :     fd_txn_e_t * microblock_dst = fd_chunk_to_laddr( ctx->execle_out_mem, ctx->execle_out_chunk );
     837           0 :     long schedule_duration = -fd_tickcount();
     838           0 :     ulong schedule_cnt = fd_pack_schedule_next_microblock( ctx->pack, CUS_PER_MICROBLOCK, VOTE_FRACTION, (ulong)i, flags, microblock_dst );
     839           0 :     schedule_duration      += fd_tickcount();
     840           0 :     fd_histf_sample( (schedule_cnt>0UL) ? ctx->schedule_duration : ctx->no_sched_duration, (ulong)schedule_duration );
     841             : 
     842           0 :     if( FD_LIKELY( schedule_cnt ) ) {
     843           0 :       any_scheduled = 1;
     844           0 :       long  now2   = fd_tickcount();
     845           0 :       ulong tsorig = (ulong)fd_frag_meta_ts_comp( now  ); /* A bound on when we observed execle was idle */
     846           0 :       ulong tspub  = (ulong)fd_frag_meta_ts_comp( now2 );
     847           0 :       ulong chunk  = ctx->execle_out_chunk;
     848           0 :       ulong msg_sz = schedule_cnt*sizeof(fd_txn_e_t);
     849           0 :       fd_microblock_execle_trailer_t * trailer = (fd_microblock_execle_trailer_t*)(microblock_dst+schedule_cnt);
     850           0 :       trailer->bank = ctx->leader_bank;
     851           0 :       trailer->bank_idx = ctx->leader_bank_idx;
     852           0 :       trailer->bank_seq = ctx->leader_bank_seq;
     853           0 :       trailer->microblock_idx = ctx->slot_microblock_cnt;
     854           0 :       trailer->pack_idx = ctx->pack_idx;
     855           0 :       trailer->pack_txn_idx = ctx->pack_txn_cnt;
     856           0 :       trailer->is_bundle = !!(microblock_dst->txnp->flags & FD_TXN_P_FLAGS_BUNDLE);
     857             : 
     858             :       /* When sending MAX_TXN_PER_MICROBLOCK transactions as fd_txn_e_t
     859             :          to execle, there must be room for the trailer at the end. */
     860           0 :       FD_STATIC_ASSERT( MAX_TXN_PER_MICROBLOCK*sizeof(fd_txn_e_t)+sizeof(fd_microblock_execle_trailer_t)<=MAX_MICROBLOCK_SZ, pack_execle_mtu );
     861             : 
     862           0 :       ulong sig = fd_disco_poh_sig( ctx->leader_slot, POH_PKT_TYPE_MICROBLOCK, (ulong)i );
     863           0 :       fd_stem_publish( stem, 0UL, sig, chunk, msg_sz+sizeof(fd_microblock_execle_trailer_t), 0UL, tsorig, tspub );
     864           0 :       ctx->execle_expect[ i ] = stem->seqs[0]-1UL;
     865           0 :       ctx->execle_ready_at[i] = now2 + (long)ctx->microblock_duration_ticks;
     866           0 :       ctx->execle_out_chunk = fd_dcache_compact_next( ctx->execle_out_chunk, msg_sz+sizeof(fd_microblock_execle_trailer_t), ctx->execle_out_chunk0, ctx->execle_out_wmark );
     867           0 :       ctx->slot_microblock_cnt += fd_ulong_if( trailer->is_bundle, schedule_cnt, 1UL );
     868           0 :       ctx->pack_idx += fd_uint_if( trailer->is_bundle, (uint)schedule_cnt, 1U );
     869           0 :       ctx->pack_txn_cnt += schedule_cnt;
     870             : 
     871           0 :       ctx->execle_idle_bitset = fd_ulong_pop_lsb( ctx->execle_idle_bitset );
     872           0 :       ctx->skip_cnt           = (long)schedule_cnt * fd_long_if( ctx->use_consumed_cus, (long)execle_cnt/2L, 1L );
     873           0 :       fd_pack_pacing_update_consumed_cus( ctx->pacer, fd_pack_current_block_cost( ctx->pack ), now2 );
     874             : 
     875           0 :       ctx->last_sched_metrics->time = now2;
     876           0 :       fd_pack_get_sched_metrics( ctx->pack, ctx->last_sched_metrics->sched_results );
     877             : 
     878             :       /* If we're using CU rebates, then we have one in for each execle
     879             :          in addition to the two normal ones.  We want to skip schedule
     880             :          attempts for (execle_cnt + 1) link polls after a successful
     881             :          schedule attempt. */
     882           0 :       fd_long_store_if( ctx->use_consumed_cus, &(ctx->skip_cnt), (long)(ctx->execle_cnt + 1) );
     883           0 :     }
     884           0 :   }
     885             : 
     886           0 :   update_metric_state( ctx, now, FD_PACK_METRIC_STATE_EXECLES,     any_ready     );
     887           0 :   update_metric_state( ctx, now, FD_PACK_METRIC_STATE_MICROBLOCKS, any_scheduled );
     888           0 :   now = fd_tickcount();
     889           0 :   update_metric_state( ctx, now, FD_PACK_METRIC_STATE_TRANSACTIONS, fd_pack_avail_txn_cnt( ctx->pack )>0 );
     890             : 
     891             : #if FD_PACK_USE_EXTRA_STORAGE
     892             :   if( FD_UNLIKELY( !extra_txn_deq_empty( ctx->extra_txn_deq ) ) ) {
     893             :     /* Don't start pulling from the extra storage until the available
     894             :        transaction count drops below half. */
     895             :     ulong avail_space   = (ulong)fd_long_max( 0L, (long)(ctx->max_pending_transactions>>1)-(long)fd_pack_avail_txn_cnt( ctx->pack ) );
     896             :     ulong qty_to_insert = fd_ulong_min( 10UL, fd_ulong_min( extra_txn_deq_cnt( ctx->extra_txn_deq ), avail_space ) );
     897             :     int any_successes = 0;
     898             :     for( ulong i=0UL; i<qty_to_insert; i++ ) any_successes |= (0<=insert_from_extra( ctx ));
     899             :     if( FD_LIKELY( any_successes ) ) ctx->last_successful_insert = now;
     900             :   }
     901             : #endif
     902             : 
     903             :   /* Did we send the maximum allowed microblocks? Then end the slot. */
     904           0 :   if( FD_UNLIKELY( ctx->slot_microblock_cnt==ctx->slot_dynamic_max_microblocks )) {
     905           0 :     *charge_busy = 1;
     906             : 
     907           0 :     update_metric_state( ctx, now, FD_PACK_METRIC_STATE_LEADER,       0 );
     908           0 :     update_metric_state( ctx, now, FD_PACK_METRIC_STATE_EXECLES,      0 );
     909           0 :     update_metric_state( ctx, now, FD_PACK_METRIC_STATE_MICROBLOCKS,  0 );
     910             :     /* The pack object also does this accounting and increases this
     911             :        metric, but we end the slot early so won't see it unless we also
     912             :        increment it here. */
     913           0 :     FD_MCNT_INC( PACK, MICROBLOCK_PER_BLOCK_LIMIT_REACHED, 1UL );
     914             : 
     915           0 :     fd_done_packing_t * done_packing = fd_chunk_to_laddr( ctx->poh_out_mem, ctx->poh_out_chunk );
     916           0 :     get_done_packing( ctx, done_packing, FD_PACK_END_SLOT_REASON_MICROBLOCK );
     917           0 :     fd_pack_end_block( ctx->pack );
     918           0 :     fd_pack_get_top_writers( ctx->pack, done_packing->limits_usage->top_writers );
     919             : 
     920           0 :     fd_stem_publish( stem, 1UL, fd_disco_execle_sig( ctx->leader_slot, ctx->pack_idx ), ctx->poh_out_chunk, sizeof(fd_done_packing_t), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
     921           0 :     ctx->poh_out_chunk = fd_dcache_compact_next( ctx->poh_out_chunk, sizeof(fd_done_packing_t), ctx->poh_out_chunk0, ctx->poh_out_wmark );
     922           0 :     ctx->pack_idx++;
     923             : 
     924           0 :     log_end_block_metrics( ctx, now, "microblock", done_packing->limits_usage->block_cost );
     925           0 :     ctx->drain_execle        = 1;
     926           0 :     ctx->leader_slot         = ULONG_MAX;
     927           0 :     ctx->slot_microblock_cnt = 0UL;
     928           0 :     remove_ib( ctx );
     929             : 
     930           0 :     return;
     931           0 :   }
     932           0 : }
     933             : 
     934             : 
     935             : /* At this point, we have started receiving frag seq with details in
     936             :     mline at time now.  Speculatively process it here. */
     937             : 
     938             : static inline void
     939             : during_frag( fd_pack_ctx_t * ctx,
     940             :              ulong           in_idx,
     941             :              ulong           seq FD_PARAM_UNUSED,
     942             :              ulong           sig,
     943             :              ulong           chunk,
     944             :              ulong           sz,
     945           0 :              ulong           ctl FD_PARAM_UNUSED ) {
     946             : 
     947           0 :   uchar const * dcache_entry = fd_chunk_to_laddr_const( ctx->in[ in_idx ].mem, chunk );
     948             : 
     949           0 :   switch( ctx->in_kind[ in_idx ] ) {
     950           0 :   case IN_KIND_REPLAY: {
     951           0 :     if( FD_LIKELY( sig==REPLAY_SIG_TXN_EXECUTED ) ) {
     952           0 :       fd_replay_txn_executed_t const * txn_executed = fd_type_pun_const( dcache_entry );
     953           0 :       ctx->txn_committed = !!txn_executed->is_committable;
     954           0 :       if( FD_UNLIKELY( !txn_executed->is_committable ) ) return;
     955           0 :       memcpy( ctx->executed_txn_sig, fd_txn_get_signatures( TXN(txn_executed->txn), txn_executed->txn->payload ), FD_TXN_SIGNATURE_SZ );
     956           0 :       return;
     957           0 :     }
     958           0 :     if( FD_LIKELY( sig!=REPLAY_SIG_BECAME_LEADER ) ) return;
     959             : 
     960             :     /* There was a leader transition.  Handle it. */
     961           0 :     if( FD_UNLIKELY( chunk<ctx->in[ in_idx ].chunk0 || chunk>ctx->in[ in_idx ].wmark || sz!=sizeof(fd_became_leader_t) ) )
     962           0 :       FD_LOG_ERR(( "chunk %lu %lu corrupt, not in range [%lu,%lu]", chunk, sz, ctx->in[ in_idx ].chunk0, ctx->in[ in_idx ].wmark ));
     963             : 
     964           0 :     fd_memcpy( ctx->_became_leader, dcache_entry, sizeof(fd_became_leader_t) );
     965           0 :     return;
     966           0 :   }
     967           0 :   case IN_KIND_POH: {
     968             :       /* Not interested in stamped microblocks, only leader updates. */
     969           0 :     if( fd_disco_poh_sig_pkt_type( sig )!=POH_PKT_TYPE_BECAME_LEADER ) return;
     970             : 
     971             :     /* There was a leader transition.  Handle it. */
     972           0 :     if( FD_UNLIKELY( chunk<ctx->in[ in_idx ].chunk0 || chunk>ctx->in[ in_idx ].wmark || sz!=sizeof(fd_became_leader_t) ) )
     973           0 :       FD_LOG_ERR(( "chunk %lu %lu corrupt, not in range [%lu,%lu]", chunk, sz, ctx->in[ in_idx ].chunk0, ctx->in[ in_idx ].wmark ));
     974             : 
     975           0 :     fd_memcpy( ctx->_became_leader, dcache_entry, sizeof(fd_became_leader_t) );
     976           0 :     return;
     977           0 :   }
     978           0 :   case IN_KIND_EXECLE: {
     979           0 :     FD_TEST( ctx->use_consumed_cus );
     980             :       /* For a previous slot */
     981           0 :     if( FD_UNLIKELY( sig!=ctx->leader_slot ) ) return;
     982             : 
     983           0 :     if( FD_UNLIKELY( chunk<ctx->in[ in_idx ].chunk0 || chunk>ctx->in[ in_idx ].wmark || sz<FD_PACK_REBATE_MIN_SZ
     984           0 :           || sz>FD_PACK_REBATE_MAX_SZ ) )
     985           0 :       FD_LOG_ERR(( "chunk %lu %lu corrupt, not in range [%lu,%lu]", chunk, sz, ctx->in[ in_idx ].chunk0, ctx->in[ in_idx ].wmark ));
     986             : 
     987           0 :     ctx->pending_rebate_sz = sz;
     988           0 :     fd_memcpy( ctx->rebate, dcache_entry, sz );
     989           0 :     return;
     990           0 :   }
     991           0 :   case IN_KIND_RESOLV: {
     992           0 :     if( FD_UNLIKELY( chunk<ctx->in[ in_idx ].chunk0 || chunk>ctx->in[ in_idx ].wmark || sz>FD_TPU_RESOLVED_MTU ) )
     993           0 :       FD_LOG_ERR(( "chunk %lu %lu corrupt, not in range [%lu,%lu]", chunk, sz, ctx->in[ in_idx ].chunk0, ctx->in[ in_idx ].wmark ));
     994             : 
     995           0 :     fd_txn_m_t * txnm = (fd_txn_m_t *)dcache_entry;
     996           0 :     ulong payload_sz  = txnm->payload_sz;
     997           0 :     ulong txn_t_sz    = txnm->txn_t_sz;
     998           0 :     uint  source_ipv4 = txnm->source_ipv4;
     999           0 :     uchar source_tpu  = txnm->source_tpu;
    1000           0 :     FD_TEST( payload_sz<=FD_TPU_MTU    );
    1001           0 :     FD_TEST( txn_t_sz  <=FD_TXN_MAX_SZ );
    1002           0 :     fd_txn_t * txn  = fd_txn_m_txn_t( txnm );
    1003             : 
    1004           0 :     ulong addr_table_sz = 32UL*txn->addr_table_adtl_cnt;
    1005           0 :     FD_TEST( addr_table_sz<=32UL*FD_TXN_ACCT_ADDR_MAX );
    1006             : 
    1007           0 :     if( FD_UNLIKELY( (ctx->leader_slot==ULONG_MAX) & (sig>ctx->highest_observed_slot) ) ) {
    1008             :       /* Using the resolv tile's knowledge of the current slot is a bit
    1009             :          of a hack, since we don't get any info if there are no
    1010             :          transactions and we're not leader.  We're actually in exactly
    1011             :          the case where that's okay though.  The point of calling
    1012             :          expire_before long before we become leader is so that we don't
    1013             :          drop new but low-fee-paying transactions when pack is clogged
    1014             :          with expired but high-fee-paying transactions.  That can only
    1015             :          happen if we are getting transactions. */
    1016           0 :       ctx->highest_observed_slot = sig;
    1017           0 :       ulong exp_cnt = fd_pack_expire_before( ctx->pack, fd_ulong_max( ctx->highest_observed_slot, TRANSACTION_LIFETIME_SLOTS )-TRANSACTION_LIFETIME_SLOTS );
    1018           0 :       FD_MCNT_INC( PACK, TXN_EXPIRED, exp_cnt );
    1019           0 :     }
    1020             : 
    1021             : 
    1022           0 :     ulong bundle_id = txnm->block_engine.bundle_id;
    1023           0 :     if( FD_UNLIKELY( bundle_id ) ) {
    1024           0 :       ctx->is_bundle = 1;
    1025           0 :       if( FD_LIKELY( bundle_id!=ctx->current_bundle->id ) ) {
    1026           0 :         if( FD_UNLIKELY( ctx->current_bundle->bundle ) ) {
    1027           0 :           FD_MCNT_INC( PACK, TXN_PARTIAL_BUNDLE, ctx->current_bundle->txn_received );
    1028           0 :           fd_pack_insert_bundle_cancel( ctx->pack, ctx->current_bundle->bundle, ctx->current_bundle->txn_cnt );
    1029           0 :         }
    1030           0 :         ctx->current_bundle->id                 = bundle_id;
    1031           0 :         ctx->current_bundle->txn_cnt            = txnm->block_engine.bundle_txn_cnt;
    1032           0 :         ctx->current_bundle->min_blockhash_slot = ULONG_MAX;
    1033           0 :         ctx->current_bundle->txn_received       = 0UL;
    1034             : 
    1035           0 :         if( FD_UNLIKELY( ctx->current_bundle->txn_cnt==0UL ) ) {
    1036           0 :           FD_MCNT_INC( PACK, TXN_PARTIAL_BUNDLE, 1UL );
    1037           0 :           ctx->current_bundle->id = 0UL;
    1038           0 :           return;
    1039           0 :         }
    1040           0 :         ctx->blk_engine_cfg->commission = txnm->block_engine.commission;
    1041           0 :         memcpy( ctx->blk_engine_cfg->commission_pubkey->b, txnm->block_engine.commission_pubkey, 32UL );
    1042             : 
    1043           0 :         ctx->current_bundle->bundle = fd_pack_insert_bundle_init( ctx->pack, ctx->current_bundle->_txn, ctx->current_bundle->txn_cnt );
    1044           0 :       }
    1045           0 :       ctx->cur_spot                           = ctx->current_bundle->bundle[ ctx->current_bundle->txn_received ];
    1046           0 :       ctx->current_bundle->min_blockhash_slot = fd_ulong_min( ctx->current_bundle->min_blockhash_slot, sig );
    1047           0 :     } else {
    1048           0 :       ctx->is_bundle = 0;
    1049             : #if FD_PACK_USE_EXTRA_STORAGE
    1050             :       if( FD_LIKELY( ctx->leader_slot!=ULONG_MAX || fd_pack_avail_txn_cnt( ctx->pack )<ctx->max_pending_transactions ) ) {
    1051             :         ctx->cur_spot = fd_pack_insert_txn_init( ctx->pack );
    1052             :         ctx->insert_to_extra = 0;
    1053             :       } else {
    1054             :         if( FD_UNLIKELY( extra_txn_deq_full( ctx->extra_txn_deq ) ) ) {
    1055             :           extra_txn_deq_remove_head( ctx->extra_txn_deq );
    1056             :           FD_MCNT_INC( PACK, TXN_EXTRA_DROPPED, 1UL );
    1057             :         }
    1058             :         ctx->cur_spot = extra_txn_deq_peek_tail( extra_txn_deq_insert_tail( ctx->extra_txn_deq ) );
    1059             :         /* We want to store the current time in cur_spot so that we can
    1060             :            track its expiration better.  We just stash it in the CU
    1061             :            fields, since those aren't important right now. */
    1062             :         ctx->cur_spot->txnp->blockhash_slot = sig;
    1063             :         ctx->insert_to_extra                = 1;
    1064             :         FD_MCNT_INC( PACK, TXN_EXTRA_INSERTED, 1UL );
    1065             :       }
    1066             : #else
    1067           0 :       ctx->cur_spot = fd_pack_insert_txn_init( ctx->pack );
    1068           0 : #endif
    1069           0 :     }
    1070             : 
    1071             :     /* We get transactions from the resolv tile.
    1072             :        The transactions should have been parsed and verified. */
    1073           0 :     FD_MCNT_INC( PACK, TXN_NORMAL_RX, 1UL );
    1074             : 
    1075           0 :     fd_memcpy( ctx->cur_spot->txnp->payload, fd_txn_m_payload( txnm ), payload_sz    );
    1076           0 :     fd_memcpy( TXN(ctx->cur_spot->txnp),     txn,                      txn_t_sz      );
    1077           0 :     fd_memcpy( ctx->cur_spot->alt_accts,     fd_txn_m_alut( txnm ),    addr_table_sz );
    1078           0 :     ctx->cur_spot->txnp->scheduler_arrival_time_nanos = ctx->approx_wallclock_ns + (long)((double)(fd_tickcount() - ctx->approx_tickcount) / ctx->ticks_per_ns);
    1079           0 :     ctx->cur_spot->txnp->payload_sz  = payload_sz;
    1080           0 :     ctx->cur_spot->txnp->source_ipv4 = source_ipv4;
    1081           0 :     ctx->cur_spot->txnp->source_tpu  = source_tpu;
    1082             : 
    1083           0 :     break;
    1084           0 :   }
    1085           0 :   case IN_KIND_EXECUTED_TXN: {
    1086           0 :     FD_TEST( sz==64UL );
    1087           0 :     fd_memcpy( ctx->executed_txn_sig, dcache_entry, sz );
    1088           0 :     break;
    1089           0 :   }
    1090           0 :   }
    1091           0 : }
    1092             : 
    1093             : 
    1094             : /* After the transaction has been fully received, and we know we were
    1095             :    not overrun while reading it, insert it into pack. */
    1096             : 
    1097             : static inline void
    1098             : after_frag( fd_pack_ctx_t *     ctx,
    1099             :             ulong               in_idx,
    1100             :             ulong               seq,
    1101             :             ulong               sig,
    1102             :             ulong               sz,
    1103             :             ulong               tsorig,
    1104             :             ulong               tspub,
    1105           0 :             fd_stem_context_t * stem ) {
    1106           0 :   (void)seq;
    1107           0 :   (void)sz;
    1108           0 :   (void)tsorig;
    1109           0 :   (void)tspub;
    1110           0 :   (void)stem;
    1111             : 
    1112           0 :   long now = fd_tickcount();
    1113             : 
    1114           0 :   ulong leader_slot = ULONG_MAX;
    1115           0 :   switch( ctx->in_kind[ in_idx ] ) {
    1116           0 :     case IN_KIND_REPLAY:
    1117           0 :       if( FD_LIKELY( sig==REPLAY_SIG_TXN_EXECUTED && ctx->txn_committed ) ) {
    1118           0 :         ulong deleted = fd_pack_delete_transaction( ctx->pack, fd_type_pun( ctx->executed_txn_sig ) );
    1119           0 :         FD_MCNT_INC( PACK, TXN_ALREADY_EXECUTED, deleted );
    1120           0 :       }
    1121           0 :       if( FD_UNLIKELY( sig!=REPLAY_SIG_BECAME_LEADER ) ) return;
    1122           0 :       leader_slot = ctx->_became_leader->slot;
    1123             : 
    1124           0 :       ctx->start_block_sched_metrics->time = now;
    1125           0 :       fd_pack_get_sched_metrics( ctx->pack, ctx->start_block_sched_metrics->sched_results );
    1126           0 :       break;
    1127           0 :     case IN_KIND_POH:
    1128           0 :       if( fd_disco_poh_sig_pkt_type( sig )!=POH_PKT_TYPE_BECAME_LEADER ) return;
    1129           0 :       leader_slot = fd_disco_poh_sig_slot( sig );
    1130           0 :       break;
    1131           0 :     default:
    1132           0 :       break;
    1133           0 :   }
    1134             : 
    1135           0 :   switch( ctx->in_kind[ in_idx ] ) {
    1136           0 :   case IN_KIND_REPLAY:
    1137           0 :   case IN_KIND_POH: {
    1138           0 :     long now_ticks = fd_tickcount();
    1139           0 :     long now_ns    = fd_log_wallclock();
    1140             : 
    1141           0 :     if( FD_UNLIKELY( ctx->leader_slot!=ULONG_MAX ) ) {
    1142           0 :       fd_done_packing_t * done_packing = fd_chunk_to_laddr( ctx->poh_out_mem, ctx->poh_out_chunk );
    1143           0 :       get_done_packing( ctx, done_packing, FD_PACK_END_SLOT_REASON_LEADER_SWITCH );
    1144           0 :       fd_pack_end_block( ctx->pack );
    1145           0 :       fd_pack_get_top_writers( ctx->pack, done_packing->limits_usage->top_writers );
    1146             : 
    1147           0 :       fd_stem_publish( stem, 1UL, fd_disco_execle_sig( ctx->leader_slot, ctx->pack_idx ), ctx->poh_out_chunk, sizeof(fd_done_packing_t), 0UL, 0UL, fd_frag_meta_ts_comp( fd_tickcount() ) );
    1148           0 :       ctx->poh_out_chunk = fd_dcache_compact_next( ctx->poh_out_chunk, sizeof(fd_done_packing_t), ctx->poh_out_chunk0, ctx->poh_out_wmark );
    1149           0 :       ctx->pack_idx++;
    1150             : 
    1151           0 :       FD_LOG_WARNING(( "switching to slot %lu while packing for slot %lu. Draining execle tiles.", leader_slot, ctx->leader_slot ));
    1152           0 :       log_end_block_metrics( ctx, now_ticks, "switch", done_packing->limits_usage->block_cost );
    1153           0 :       ctx->drain_execle        = 1;
    1154           0 :       ctx->leader_slot         = ULONG_MAX;
    1155           0 :       ctx->slot_microblock_cnt = 0UL;
    1156           0 :       remove_ib( ctx );
    1157           0 :     }
    1158           0 :     ctx->leader_slot = leader_slot;
    1159             : 
    1160           0 :     ulong exp_cnt = fd_pack_expire_before( ctx->pack, fd_ulong_max( ctx->leader_slot, TRANSACTION_LIFETIME_SLOTS )-TRANSACTION_LIFETIME_SLOTS );
    1161           0 :     FD_MCNT_INC( PACK, TXN_EXPIRED, exp_cnt );
    1162             : 
    1163           0 :     ctx->leader_bank          = ctx->_became_leader->bank;
    1164           0 :     ctx->leader_bank_idx      = ctx->_became_leader->bank_idx;
    1165           0 :     ctx->leader_bank_seq      = ctx->_became_leader->bank_seq;
    1166           0 :     ctx->slot_max_microblocks = ctx->_became_leader->max_microblocks_in_slot;
    1167             : 
    1168           0 :     ulong base_max_data = ctx->larger_shred_limits_per_block ? LARGER_MAX_DATA_PER_BLOCK : FD_PACK_MAX_DATA_PER_BLOCK;
    1169           0 :     if( FD_LIKELY( !ctx->larger_shred_limits_per_block ) ) {
    1170             :       /* Compute base_max_data to ensure that we don't overflow
    1171             :          slot_max_data_shreds. See FD_SHRED_BATCH_BLOCK_DATA_SZ_MAX in
    1172             :          fd_shred_batch.h. Some of the terms are
    1173             :          based on the worst-case number of FEC sets in a block, which
    1174             :          scales with the slot time reductions:
    1175             :          - pad_ohead = per-batch padding (OHEAD_PAD in fd_shred_batch.h)
    1176             :          - hdr_ohead = per-batch header (OHEAD_HDR in fd_shred_batch.h)
    1177             :          - reg_ohead = only used for the last batch
    1178             :                        (OHEAD_REG in fd_shred_batch.h) */
    1179           0 :       ulong fec_set_cnt     = ctx->_became_leader->limits.slot_max_data_shreds/32UL;
    1180           0 :       ulong pad_ohead       = ( fec_set_cnt/2UL )*FD_SHREDDER_CHAINED_FEC_SET_PAYLOAD_SZ;
    1181           0 :       ulong hdr_ohead       = fec_set_cnt*8UL;
    1182           0 :       ulong reg_ohead       = 8192UL;
    1183           0 :       FD_TEST( fec_set_cnt >= 2UL ); /* guard against underflow */
    1184           0 :       ulong fec_data        = ( fec_set_cnt - 2UL )*FD_SHREDDER_CHAINED_FEC_SET_PAYLOAD_SZ;
    1185           0 :       FD_TEST( fec_data    >= pad_ohead+hdr_ohead+reg_ohead );
    1186           0 :       base_max_data         = fec_data - pad_ohead - hdr_ohead - reg_ohead;
    1187           0 :     }
    1188             :     /* Reserve some space in the block for ticks */
    1189           0 :     ctx->slot_max_data        = base_max_data
    1190           0 :                                       - 48UL*(ctx->_became_leader->ticks_per_slot+ctx->_became_leader->total_skipped_ticks);
    1191             : 
    1192           0 :     ctx->limits.slot_max_cost                     = ctx->_became_leader->limits.slot_max_cost;
    1193           0 :     ctx->limits.slot_max_vote_cost                = ctx->_became_leader->limits.slot_max_vote_cost;
    1194           0 :     ctx->limits.slot_max_write_cost_per_acct      = ctx->_became_leader->limits.slot_max_write_cost_per_acct;
    1195           0 :     ctx->limits.slot_max_allocated_data_per_block = ctx->_became_leader->limits.slot_max_allocated_data_per_block;
    1196           0 :     ctx->limits.slot_max_data_shreds              = ctx->_became_leader->limits.slot_max_data_shreds;
    1197             : 
    1198             :     /* ticks_per_ns is probably relatively stable over 400ms, but not
    1199             :        over several hours, so we need to compute the slot duration in
    1200             :        milliseconds first and then convert to ticks.  This doesn't need
    1201             :        to be super accurate, but we don't want it to vary wildly. */
    1202           0 :     long end_ticks = now_ticks + (long)((double)fd_long_max( ctx->_became_leader->slot_end_ns - now_ns, 1L )*ctx->ticks_per_ns);
    1203             :     /* We may still get overrun, but then we'll never use this and just
    1204             :        reinitialize it the next time when we actually become leader. */
    1205           0 :     fd_pack_pacing_init( ctx->pacer, now_ticks, end_ticks, (float)ctx->ticks_per_ns, ctx->limits.slot_max_cost );
    1206             : 
    1207           0 :     if( FD_UNLIKELY( ctx->crank->enabled ) ) {
    1208             :       /* If we get overrun, we'll just never use these values, but the
    1209             :          old values aren't really useful either. */
    1210           0 :       ctx->crank->epoch = ctx->_became_leader->epoch;
    1211           0 :       *(ctx->crank->prev_config) = *(ctx->_became_leader->bundle->config);
    1212           0 :       memcpy( ctx->crank->recent_blockhash,   ctx->_became_leader->bundle->last_blockhash,     32UL );
    1213           0 :       memcpy( ctx->crank->tip_receiver_owner, ctx->_became_leader->bundle->tip_receiver_owner, 32UL );
    1214           0 :     }
    1215             : 
    1216           0 :     FD_LOG_INFO(( "pack_became_leader(slot=%lu,ends_at=%ld)", ctx->leader_slot, ctx->_became_leader->slot_end_ns ));
    1217             : 
    1218           0 :     update_metric_state( ctx, fd_tickcount(), FD_PACK_METRIC_STATE_LEADER, 1 );
    1219             : 
    1220           0 :     ctx->slot_end_ns = ctx->_became_leader->slot_end_ns;
    1221           0 :     ctx->slot_dynamic_max_microblocks  = ctx->slot_max_microblocks;
    1222           0 :     ctx->pending_reduce_mb_bound       = 0;
    1223           0 :     fd_pack_limits_t limits[ 1 ];
    1224           0 :     limits->max_cost_per_block = ctx->limits.slot_max_cost;
    1225           0 :     limits->max_data_bytes_per_block = ctx->slot_max_data;
    1226           0 :     limits->max_microblocks_per_block = ctx->slot_max_microblocks;
    1227           0 :     limits->max_vote_cost_per_block = ctx->limits.slot_max_vote_cost;
    1228           0 :     limits->max_write_cost_per_acct = ctx->limits.slot_max_write_cost_per_acct;
    1229           0 :     limits->max_txn_per_microblock = ULONG_MAX; /* unused */
    1230           0 :     limits->max_allocated_data_per_block = ctx->limits.slot_max_allocated_data_per_block;
    1231           0 :     fd_pack_set_block_limits( ctx->pack, limits );
    1232           0 :     fd_pack_pacing_update_consumed_cus( ctx->pacer, fd_pack_current_block_cost( ctx->pack ), now );
    1233             : 
    1234           0 :     break;
    1235           0 :   }
    1236           0 :   case IN_KIND_EXECLE: {
    1237             :     /* For a previous slot */
    1238           0 :     if( FD_UNLIKELY( sig!=ctx->leader_slot ) ) return;
    1239             : 
    1240           0 :     fd_pack_rebate_cus( ctx->pack, ctx->rebate->rebate );
    1241           0 :     ctx->pending_rebate_sz = 0UL;
    1242           0 :     fd_pack_pacing_update_consumed_cus( ctx->pacer, fd_pack_current_block_cost( ctx->pack ), now );
    1243           0 :     break;
    1244           0 :   }
    1245           0 :   case IN_KIND_RESOLV: {
    1246             :     /* Normal transaction case */
    1247             : #if FD_PACK_USE_EXTRA_STORAGE
    1248             :     if( FD_LIKELY( !ctx->insert_to_extra ) ) {
    1249             : #else
    1250           0 :     if( 1 ) {
    1251           0 : #endif
    1252           0 :     if( FD_UNLIKELY( ctx->is_bundle ) ) {
    1253           0 :       if( FD_UNLIKELY( ctx->current_bundle->txn_cnt==0UL ) ) return;
    1254           0 :       if( FD_UNLIKELY( ++(ctx->current_bundle->txn_received)==ctx->current_bundle->txn_cnt ) ) {
    1255           0 :         ulong deleted;
    1256           0 :         long insert_duration = -fd_tickcount();
    1257           0 :         int result = fd_pack_insert_bundle_fini( ctx->pack, ctx->current_bundle->bundle, ctx->current_bundle->txn_cnt, ctx->current_bundle->min_blockhash_slot, 0, ctx->blk_engine_cfg, &deleted );
    1258           0 :         insert_duration      += fd_tickcount();
    1259           0 :         FD_MCNT_INC( PACK, TXN_DELETED, deleted );
    1260           0 :         ctx->insert_result[ result + FD_PACK_INSERT_RETVAL_OFF ] += ctx->current_bundle->txn_received;
    1261           0 :         fd_histf_sample( ctx->insert_duration, (ulong)insert_duration );
    1262           0 :         ctx->current_bundle->bundle = NULL;
    1263           0 :       }
    1264           0 :     } else {
    1265           0 :       ulong blockhash_slot = sig;
    1266           0 :       ulong deleted;
    1267           0 :       long insert_duration = -fd_tickcount();
    1268           0 :       int result = fd_pack_insert_txn_fini( ctx->pack, ctx->cur_spot, blockhash_slot, &deleted );
    1269           0 :       insert_duration      += fd_tickcount();
    1270           0 :       FD_MCNT_INC( PACK, TXN_DELETED, deleted );
    1271           0 :       ctx->insert_result[ result + FD_PACK_INSERT_RETVAL_OFF ]++;
    1272           0 :       fd_histf_sample( ctx->insert_duration, (ulong)insert_duration );
    1273           0 :       if( FD_LIKELY( result>=0 ) ) ctx->last_successful_insert = now;
    1274           0 :     }
    1275           0 :     }
    1276             : 
    1277           0 :     ctx->cur_spot = NULL;
    1278           0 :     break;
    1279           0 :   }
    1280           0 :   case IN_KIND_EXECUTED_TXN: {
    1281           0 :     ulong deleted = fd_pack_delete_transaction( ctx->pack, fd_type_pun( ctx->executed_txn_sig ) );
    1282           0 :     FD_MCNT_INC( PACK, TXN_ALREADY_EXECUTED, deleted );
    1283           0 :     break;
    1284           0 :   }
    1285           0 :   }
    1286             : 
    1287           0 :   update_metric_state( ctx, now, FD_PACK_METRIC_STATE_TRANSACTIONS, fd_pack_avail_txn_cnt( ctx->pack )>0 );
    1288           0 : }
    1289             : 
    1290             : static void
    1291             : privileged_init( fd_topo_t const *      topo,
    1292           0 :                  fd_topo_tile_t const * tile ) {
    1293           0 :   if( FD_LIKELY( !tile->pack.bundle.enabled ) ) return;
    1294           0 :   if( FD_UNLIKELY( !tile->pack.bundle.vote_account_path[0] ) ) {
    1295           0 :     FD_LOG_WARNING(( "Disabling bundle crank because no vote account was specified" ));
    1296           0 :     return;
    1297           0 :   }
    1298             : 
    1299           0 :   void * scratch = fd_topo_obj_laddr( topo, tile->tile_obj_id );
    1300             : 
    1301           0 :   FD_SCRATCH_ALLOC_INIT( l, scratch );
    1302           0 :   fd_pack_ctx_t * ctx = FD_SCRATCH_ALLOC_APPEND( l, alignof( fd_pack_ctx_t ), sizeof( fd_pack_ctx_t ) );
    1303             : 
    1304           0 :   if( FD_UNLIKELY( !strcmp( tile->pack.bundle.identity_key_path, "" ) ) )
    1305           0 :     FD_LOG_ERR(( "identity_key_path not set" ));
    1306             : 
    1307           0 :   const uchar * identity_key = fd_keyload_load( tile->pack.bundle.identity_key_path, /* pubkey only: */ 1 );
    1308           0 :   fd_memcpy( ctx->crank->identity_pubkey->b, identity_key, 32UL );
    1309             : 
    1310           0 :   if( FD_UNLIKELY( !fd_base58_decode_32( tile->pack.bundle.vote_account_path, ctx->crank->vote_pubkey->b ) ) ) {
    1311           0 :     const uchar * vote_key = fd_keyload_load( tile->pack.bundle.vote_account_path, /* pubkey only: */ 1 );
    1312           0 :     fd_memcpy( ctx->crank->vote_pubkey->b, vote_key, 32UL );
    1313           0 :   }
    1314           0 : }
    1315             : 
    1316             : static void
    1317             : unprivileged_init( fd_topo_t const *      topo,
    1318           0 :                    fd_topo_tile_t const * tile ) {
    1319           0 :   void * scratch = fd_topo_obj_laddr( topo, tile->tile_obj_id );
    1320             : 
    1321           0 :   if( FD_UNLIKELY( tile->pack.max_pending_transactions >= USHORT_MAX-10UL ) ) FD_LOG_ERR(( "pack tile supports up to %lu pending transactions", USHORT_MAX-11UL ));
    1322             : 
    1323           0 :   fd_pack_limits_t limits_upper[1] = {{
    1324           0 :     .max_cost_per_block           = tile->pack.larger_max_cost_per_block ? LARGER_MAX_COST_PER_BLOCK : FD_PACK_MAX_COST_PER_BLOCK_UPPER_BOUND,
    1325           0 :     .max_vote_cost_per_block      = FD_PACK_MAX_VOTE_COST_PER_BLOCK_UPPER_BOUND,
    1326           0 :     .max_write_cost_per_acct      = FD_PACK_MAX_WRITE_COST_PER_ACCT_UPPER_BOUND,
    1327           0 :     .max_data_bytes_per_block     = tile->pack.larger_shred_limits_per_block ? LARGER_MAX_DATA_PER_BLOCK : FD_PACK_MAX_DATA_PER_BLOCK,
    1328           0 :     .max_txn_per_microblock       = EFFECTIVE_TXN_PER_MICROBLOCK,
    1329           0 :     .max_microblocks_per_block    = (ulong)UINT_MAX, /* Limit not known yet */
    1330           0 :     .max_allocated_data_per_block = FD_PACK_MAX_ALLOCATED_DATA_PER_BLOCK,
    1331           0 :   }};
    1332             : 
    1333           0 :   ulong pack_footprint = fd_pack_footprint( tile->pack.max_pending_transactions, BUNDLE_META_SZ, tile->pack.execle_tile_count, limits_upper );
    1334             : 
    1335           0 :   FD_SCRATCH_ALLOC_INIT( l, scratch );
    1336           0 :   fd_pack_ctx_t * ctx = FD_SCRATCH_ALLOC_APPEND( l, alignof( fd_pack_ctx_t ), sizeof( fd_pack_ctx_t ) );
    1337           0 :   fd_rng_t *      rng = fd_rng_join( fd_rng_new( FD_SCRATCH_ALLOC_APPEND( l, fd_rng_align(), fd_rng_footprint() ), 0U, 0UL ) );
    1338           0 :   if( FD_UNLIKELY( !rng ) ) FD_LOG_ERR(( "fd_rng_new failed" ));
    1339             : 
    1340           0 :   fd_pack_limits_t limits_lower[1] = {{
    1341           0 :     .max_cost_per_block           = tile->pack.larger_max_cost_per_block ? LARGER_MAX_COST_PER_BLOCK : FD_PACK_MAX_COST_PER_BLOCK_LOWER_BOUND,
    1342           0 :     .max_vote_cost_per_block      = FD_PACK_MAX_VOTE_COST_PER_BLOCK_LOWER_BOUND,
    1343           0 :     .max_write_cost_per_acct      = FD_PACK_MAX_WRITE_COST_PER_ACCT_LOWER_BOUND,
    1344           0 :     .max_data_bytes_per_block     = tile->pack.larger_shred_limits_per_block ? LARGER_MAX_DATA_PER_BLOCK : FD_PACK_MAX_DATA_PER_BLOCK,
    1345           0 :     .max_txn_per_microblock       = EFFECTIVE_TXN_PER_MICROBLOCK,
    1346           0 :     .max_microblocks_per_block    = (ulong)UINT_MAX, /* Limit not known yet */
    1347           0 :     .max_allocated_data_per_block = FD_PACK_MAX_ALLOCATED_DATA_PER_BLOCK,
    1348           0 :   }};
    1349             : 
    1350           0 :   ctx->pack = fd_pack_join( fd_pack_new( FD_SCRATCH_ALLOC_APPEND( l, fd_pack_align(), pack_footprint ),
    1351           0 :                                          tile->pack.max_pending_transactions, BUNDLE_META_SZ, tile->pack.execle_tile_count,
    1352           0 :                                          limits_lower,
    1353           0 :                                          fd_type_pun_const( tile->pack.acct_blocklist ), tile->pack.acct_blocklist_cnt,
    1354           0 :                                          rng ) );
    1355           0 :   if( FD_UNLIKELY( !ctx->pack ) ) FD_LOG_ERR(( "fd_pack_new failed" ));
    1356             : 
    1357           0 :   if( FD_UNLIKELY( tile->in_cnt>32UL ) ) FD_LOG_ERR(( "Too many input links (%lu>32) to pack tile", tile->in_cnt ));
    1358             : 
    1359           0 :   FD_TEST( tile->in_cnt<sizeof( ctx->in_kind )/sizeof( ctx->in_kind[0] ) );
    1360           0 :   for( ulong i=0UL; i<tile->in_cnt; i++ ) {
    1361           0 :     fd_topo_link_t const * link = &topo->links[ tile->in_link_id[ i ] ];
    1362             : 
    1363           0 :     if( FD_LIKELY(      !strcmp( link->name, "resolv_pack"  ) ) ) ctx->in_kind[ i ] = IN_KIND_RESOLV;
    1364           0 :     else if( FD_LIKELY( !strcmp( link->name, "resolh_pack"  ) ) ) ctx->in_kind[ i ] = IN_KIND_RESOLV;
    1365           0 :     else if( FD_LIKELY( !strcmp( link->name, "poh_pack"     ) ) ) ctx->in_kind[ i ] = IN_KIND_POH;
    1366           0 :     else if( FD_LIKELY( !strcmp( link->name, "pohh_pack"    ) ) ) ctx->in_kind[ i ] = IN_KIND_POH;
    1367           0 :     else if( FD_LIKELY( !strcmp( link->name, "bank_pack"    ) ) ) ctx->in_kind[ i ] = IN_KIND_EXECLE;
    1368           0 :     else if( FD_LIKELY( !strcmp( link->name, "execle_pack"  ) ) ) ctx->in_kind[ i ] = IN_KIND_EXECLE;
    1369           0 :     else if( FD_LIKELY( !strcmp( link->name, "sign_pack"    ) ) ) ctx->in_kind[ i ] = IN_KIND_SIGN;
    1370           0 :     else if( FD_LIKELY( !strcmp( link->name, "replay_out"   ) ) ) ctx->in_kind[ i ] = IN_KIND_REPLAY;
    1371           0 :     else if( FD_LIKELY( !strcmp( link->name, "executed_txn" ) ) ) ctx->in_kind[ i ] = IN_KIND_EXECUTED_TXN;
    1372           0 :     else FD_LOG_ERR(( "pack tile has unexpected input link %lu %s", i, link->name ));
    1373           0 :   }
    1374             : 
    1375           0 :   ulong execle_cnt = 0UL;
    1376           0 :   for( ulong i=0UL; i<topo->tile_cnt; i++ ) {
    1377           0 :     fd_topo_tile_t const * consumer_tile = &topo->tiles[ i ];
    1378           0 :     if( FD_UNLIKELY( strcmp( consumer_tile->name, "execle" ) && strcmp( consumer_tile->name, "replay" ) ) ) continue;
    1379           0 :     for( ulong j=0UL; j<consumer_tile->in_cnt; j++ ) {
    1380           0 :       if( FD_UNLIKELY( consumer_tile->in_link_id[ j ]==tile->out_link_id[ 0 ] ) ) execle_cnt++;
    1381           0 :     }
    1382           0 :   }
    1383             : 
    1384             :   // if( FD_UNLIKELY( !execle_cnt                            ) ) FD_LOG_ERR(( "pack tile connects to no execle tiles" ));
    1385           0 :   if( FD_UNLIKELY( execle_cnt>FD_PACK_MAX_EXECLE_TILES       ) ) FD_LOG_ERR(( "pack tile connects to too many execle tiles" ));
    1386             :   // if( FD_UNLIKELY( execle_cnt!=tile->pack.execle_tile_count ) ) FD_LOG_ERR(( "pack tile connects to %lu execle tiles, but tile->pack.execle_tile_count is %lu", execle_cnt, tile->pack.execle_tile_count ));
    1387             : 
    1388           0 :   FD_TEST( (tile->pack.schedule_strategy>=0) & (tile->pack.schedule_strategy<=FD_PACK_STRATEGY_BALANCED) );
    1389             : 
    1390           0 :   ctx->crank->enabled = tile->pack.bundle.enabled;
    1391           0 :   if( FD_UNLIKELY( tile->pack.bundle.enabled ) ) {
    1392           0 :     if( FD_UNLIKELY( !fd_bundle_crank_gen_init( ctx->crank->gen, (fd_acct_addr_t const *)tile->pack.bundle.tip_distribution_program_addr,
    1393           0 :             (fd_acct_addr_t const *)tile->pack.bundle.tip_payment_program_addr,
    1394           0 :             (fd_acct_addr_t const *)ctx->crank->vote_pubkey->b,
    1395           0 :             (fd_acct_addr_t const *)tile->pack.bundle.tip_distribution_authority,
    1396           0 :             schedule_strategy_strings[ tile->pack.schedule_strategy ],
    1397           0 :             tile->pack.bundle.commission_bps ) ) ) {
    1398           0 :       FD_LOG_ERR(( "constructing bundle generator failed" ));
    1399           0 :     }
    1400             : 
    1401           0 :     ulong sign_in_idx  = fd_topo_find_tile_in_link ( topo, tile, "sign_pack", tile->kind_id );
    1402           0 :     ulong sign_out_idx = fd_topo_find_tile_out_link( topo, tile, "pack_sign", tile->kind_id );
    1403           0 :     FD_TEST( sign_in_idx!=ULONG_MAX );
    1404           0 :     fd_topo_link_t const * sign_in = &topo->links[ tile->in_link_id[ sign_in_idx ] ];
    1405           0 :     fd_topo_link_t const * sign_out = &topo->links[ tile->out_link_id[ sign_out_idx ] ];
    1406           0 :     if( FD_UNLIKELY( !fd_keyguard_client_join( fd_keyguard_client_new( ctx->crank->keyguard_client,
    1407           0 :             sign_out->mcache,
    1408           0 :             sign_out->dcache,
    1409           0 :             sign_in->mcache,
    1410           0 :             sign_in->dcache,
    1411           0 :             sign_out->mtu ) ) ) ) {
    1412           0 :       FD_LOG_ERR(( "failed to construct keyguard" ));
    1413           0 :     }
    1414             :     /* Initialize enough of the prev config that it produces a
    1415             :        transaction */
    1416           0 :     ctx->crank->prev_config->discriminator       = 0x82ccfa1ee0aa0c9bUL;
    1417           0 :     ctx->crank->prev_config->tip_receiver->b[1]  = 1;
    1418           0 :     ctx->crank->prev_config->block_builder->b[2] = 1;
    1419             : 
    1420           0 :     memset( ctx->crank->tip_receiver_owner, '\0', 32UL );
    1421           0 :     memset( ctx->crank->recent_blockhash,   '\0', 32UL );
    1422           0 :     memset( ctx->crank->last_sig,           '\0', 64UL );
    1423           0 :     ctx->crank->ib_inserted    = 0;
    1424           0 :     ctx->crank->epoch          = 0UL;
    1425           0 :     ctx->crank->keyswitch = fd_keyswitch_join( fd_topo_obj_laddr( topo, tile->id_keyswitch_obj_id ) );
    1426           0 :     FD_TEST( ctx->crank->keyswitch );
    1427           0 :   } else {
    1428           0 :     memset( ctx->crank, '\0', sizeof(ctx->crank) );
    1429           0 :   }
    1430             : 
    1431             : 
    1432             : #if FD_PACK_USE_EXTRA_STORAGE
    1433             :   ctx->extra_txn_deq = extra_txn_deq_join( extra_txn_deq_new( FD_SCRATCH_ALLOC_APPEND( l, extra_txn_deq_align(),
    1434             :                                                                                           extra_txn_deq_footprint() ) ) );
    1435             : #endif
    1436             : 
    1437           0 :   ctx->cur_spot                      = NULL;
    1438           0 :   ctx->is_bundle                     = 0;
    1439           0 :   ctx->strategy                      = tile->pack.schedule_strategy;
    1440           0 :   ctx->max_pending_transactions      = tile->pack.max_pending_transactions;
    1441           0 :   ctx->leader_slot                   = ULONG_MAX;
    1442           0 :   ctx->leader_bank                   = NULL;
    1443           0 :   ctx->leader_bank_idx               = ULONG_MAX;
    1444           0 :   ctx->leader_bank_seq               = ULONG_MAX;
    1445           0 :   ctx->pack_idx                      = 0UL;
    1446           0 :   ctx->slot_microblock_cnt           = 0UL;
    1447           0 :   ctx->pack_txn_cnt                  = 0UL;
    1448           0 :   ctx->slot_max_microblocks          = 0UL;
    1449           0 :   ctx->slot_dynamic_max_microblocks  = 0UL;
    1450           0 :   ctx->pending_reduce_mb_bound       = 0;
    1451           0 :   ctx->slot_max_data                 = 0UL;
    1452           0 :   ctx->larger_shred_limits_per_block = tile->pack.larger_shred_limits_per_block;
    1453           0 :   ctx->drain_execle                  = 0;
    1454           0 :   ctx->approx_wallclock_ns           = fd_log_wallclock();
    1455           0 :   ctx->approx_tickcount              = fd_tickcount();
    1456           0 :   ctx->rng                           = rng;
    1457           0 :   ctx->ticks_per_ns                  = fd_tempo_tick_per_ns( NULL );
    1458           0 :   ctx->last_successful_insert        = 0L;
    1459           0 :   ctx->highest_observed_slot         = 0UL;
    1460           0 :   ctx->microblock_duration_ticks     = (ulong)(fd_tempo_tick_per_ns( NULL )*(double)MICROBLOCK_DURATION_NS  + 0.5);
    1461             : #if FD_PACK_USE_EXTRA_STORAGE
    1462             :   ctx->insert_to_extra               = 0;
    1463             : #endif
    1464           0 :   ctx->use_consumed_cus              = tile->pack.use_consumed_cus;
    1465           0 :   ctx->crank->enabled                = tile->pack.bundle.enabled;
    1466             : 
    1467             : #if !SMALL_MICROBLOCKS
    1468             :   ctx->wait_duration_ticks[ 0 ] = ULONG_MAX;
    1469             :   for( ulong i=1UL; i<MAX_TXN_PER_MICROBLOCK+1UL; i++ ) {
    1470             :     ctx->wait_duration_ticks[ i ]=(ulong)(fd_tempo_tick_per_ns( NULL )*(double)wait_duration[ i ] + 0.5);
    1471             :   }
    1472             : #endif
    1473             : 
    1474           0 :   ctx->limits.slot_max_cost                = limits_lower->max_cost_per_block;
    1475           0 :   ctx->limits.slot_max_vote_cost           = limits_lower->max_vote_cost_per_block;
    1476           0 :   ctx->limits.slot_max_write_cost_per_acct = limits_lower->max_write_cost_per_acct;
    1477             : 
    1478           0 :   ctx->execle_cnt       = tile->pack.execle_tile_count;
    1479           0 :   ctx->poll_cursor      = 0;
    1480           0 :   ctx->skip_cnt         = 0L;
    1481           0 :   ctx->execle_idle_bitset = fd_ulong_mask_lsb( (int)tile->pack.execle_tile_count );
    1482           0 :   for( ulong i=0UL; i<tile->pack.execle_tile_count; i++ ) {
    1483           0 :     ulong busy_obj_id = fd_pod_queryf_ulong( topo->props, ULONG_MAX, "execle_busy.%lu", i );
    1484           0 :     FD_TEST( busy_obj_id!=ULONG_MAX );
    1485           0 :     ctx->execle_current[ i ] = fd_fseq_join( fd_topo_obj_laddr( topo, busy_obj_id ) );
    1486           0 :     ctx->execle_expect[ i ] = ULONG_MAX;
    1487           0 :     if( FD_UNLIKELY( !ctx->execle_current[ i ] ) ) FD_LOG_ERR(( "execle tile %lu has no busy flag", i ));
    1488           0 :     ctx->execle_ready_at[ i ] = 0L;
    1489           0 :     FD_TEST( ULONG_MAX==fd_fseq_query( ctx->execle_current[ i ] ) );
    1490           0 :   }
    1491             : 
    1492           0 :   for( ulong i=0UL; i<tile->in_cnt; i++ ) {
    1493           0 :     fd_topo_link_t const * link = &topo->links[ tile->in_link_id[ i ] ];
    1494           0 :     fd_topo_wksp_t const * link_wksp = &topo->workspaces[ topo->objs[ link->dcache_obj_id ].wksp_id ];
    1495             : 
    1496           0 :     ctx->in[ i ].mem    = link_wksp->wksp;
    1497           0 :     ctx->in[ i ].chunk0 = fd_dcache_compact_chunk0( ctx->in[ i ].mem, link->dcache );
    1498           0 :     ctx->in[ i ].wmark  = fd_dcache_compact_wmark ( ctx->in[ i ].mem, link->dcache, link->mtu );
    1499           0 :   }
    1500             : 
    1501           0 :   ctx->execle_out_mem    = topo->workspaces[ topo->objs[ topo->links[ tile->out_link_id[ 0 ] ].dcache_obj_id ].wksp_id ].wksp;
    1502           0 :   ctx->execle_out_chunk0 = fd_dcache_compact_chunk0( ctx->execle_out_mem, topo->links[ tile->out_link_id[ 0 ] ].dcache );
    1503           0 :   ctx->execle_out_wmark  = fd_dcache_compact_wmark ( ctx->execle_out_mem, topo->links[ tile->out_link_id[ 0 ] ].dcache, topo->links[ tile->out_link_id[ 0 ] ].mtu );
    1504           0 :   ctx->execle_out_chunk  = ctx->execle_out_chunk0;
    1505             : 
    1506           0 :   ctx->poh_out_mem    = topo->workspaces[ topo->objs[ topo->links[ tile->out_link_id[ 1 ] ].dcache_obj_id ].wksp_id ].wksp;
    1507           0 :   ctx->poh_out_chunk0 = fd_dcache_compact_chunk0( ctx->poh_out_mem, topo->links[ tile->out_link_id[ 1 ] ].dcache );
    1508           0 :   ctx->poh_out_wmark  = fd_dcache_compact_wmark ( ctx->poh_out_mem, topo->links[ tile->out_link_id[ 1 ] ].dcache, topo->links[ tile->out_link_id[ 1 ] ].mtu );
    1509           0 :   ctx->poh_out_chunk  = ctx->poh_out_chunk0;
    1510             : 
    1511             :   /* Initialize metrics storage */
    1512           0 :   memset( ctx->insert_result, '\0', FD_PACK_INSERT_RETVAL_CNT * sizeof(ulong) );
    1513           0 :   fd_histf_join( fd_histf_new( ctx->schedule_duration, FD_MHIST_SECONDS_MIN( PACK, SCHEDULE_MICROBLOCK_DURATION_SECONDS ),
    1514           0 :                                                        FD_MHIST_SECONDS_MAX( PACK, SCHEDULE_MICROBLOCK_DURATION_SECONDS ) ) );
    1515           0 :   fd_histf_join( fd_histf_new( ctx->no_sched_duration, FD_MHIST_SECONDS_MIN( PACK, NO_SCHEDULE_MICROBLOCK_DURATION_SECONDS ),
    1516           0 :                                                        FD_MHIST_SECONDS_MAX( PACK, NO_SCHEDULE_MICROBLOCK_DURATION_SECONDS ) ) );
    1517           0 :   fd_histf_join( fd_histf_new( ctx->insert_duration,   FD_MHIST_SECONDS_MIN( PACK, INSERT_TRANSACTION_DURATION_SECONDS  ),
    1518           0 :                                                        FD_MHIST_SECONDS_MAX( PACK, INSERT_TRANSACTION_DURATION_SECONDS  ) ) );
    1519           0 :   fd_histf_join( fd_histf_new( ctx->complete_duration, FD_MHIST_SECONDS_MIN( PACK, COMPLETE_MICROBLOCK_DURATION_SECONDS ),
    1520           0 :                                                        FD_MHIST_SECONDS_MAX( PACK, COMPLETE_MICROBLOCK_DURATION_SECONDS ) ) );
    1521           0 :   ctx->metric_state = 0;
    1522           0 :   ctx->metric_state_begin = fd_tickcount();
    1523           0 :   memset( ctx->metric_timing,             '\0', 16*sizeof(long)                        );
    1524           0 :   memset( ctx->current_bundle,            '\0', sizeof(ctx->current_bundle)            );
    1525           0 :   memset( ctx->blk_engine_cfg,            '\0', sizeof(ctx->blk_engine_cfg)            );
    1526           0 :   memset( ctx->last_sched_metrics,        '\0', sizeof(ctx->last_sched_metrics)        );
    1527           0 :   memset( ctx->start_block_sched_metrics, '\0', sizeof(ctx->start_block_sched_metrics) );
    1528           0 :   memset( ctx->crank->metrics,            '\0', sizeof(ctx->crank->metrics)            );
    1529             : 
    1530           0 :   FD_LOG_INFO(( "packing microblocks of at most %lu transactions to %lu execle tiles using strategy %i", EFFECTIVE_TXN_PER_MICROBLOCK, tile->pack.execle_tile_count, ctx->strategy ));
    1531             : 
    1532           0 :   ulong scratch_top = FD_SCRATCH_ALLOC_FINI( l, scratch_align() );
    1533           0 :   if( FD_UNLIKELY( scratch_top > (ulong)scratch + scratch_footprint( tile ) ) )
    1534           0 :     FD_LOG_ERR(( "scratch overflow %lu %lu %lu", scratch_top - (ulong)scratch - scratch_footprint( tile ), scratch_top, (ulong)scratch + scratch_footprint( tile ) ));
    1535           0 : }
    1536             : 
    1537             : static ulong
    1538             : populate_allowed_seccomp( fd_topo_t const *      topo,
    1539             :                           fd_topo_tile_t const * tile,
    1540             :                           ulong                  out_cnt,
    1541           0 :                           struct sock_filter *   out ) {
    1542           0 :   (void)topo;
    1543           0 :   (void)tile;
    1544             : 
    1545           0 :   populate_sock_filter_policy_fd_pack_tile( out_cnt, out, (uint)fd_log_private_logfile_fd() );
    1546           0 :   return sock_filter_policy_fd_pack_tile_instr_cnt;
    1547           0 : }
    1548             : 
    1549             : static ulong
    1550             : populate_allowed_fds( fd_topo_t const *      topo,
    1551             :                       fd_topo_tile_t const * tile,
    1552             :                       ulong                  out_fds_cnt,
    1553           0 :                       int *                  out_fds ) {
    1554           0 :   (void)topo;
    1555           0 :   (void)tile;
    1556             : 
    1557           0 :   if( FD_UNLIKELY( out_fds_cnt<2UL ) ) FD_LOG_ERR(( "out_fds_cnt %lu", out_fds_cnt ));
    1558             : 
    1559           0 :   ulong out_cnt = 0UL;
    1560           0 :   out_fds[ out_cnt++ ] = 2; /* stderr */
    1561           0 :   if( FD_LIKELY( -1!=fd_log_private_logfile_fd() ) )
    1562           0 :     out_fds[ out_cnt++ ] = fd_log_private_logfile_fd(); /* logfile */
    1563           0 :   return out_cnt;
    1564           0 : }
    1565             : 
    1566             : /* Pack can publish a frag in the following scenarios:
    1567             : 
    1568             :    after_credit:
    1569             :      A. TIMED_OUT. Sets ctx->leader_slot=ULONG_MAX. return.
    1570             :      B. DONE_DRAINING. *after* DONE_PACKING. return.
    1571             :      C. REDUCE_MB_BOUND. return.
    1572             :      D. SCHEDULE_MB. *doesn't* return.
    1573             :      E. EXHAUST_MICROBLOCKS. Sets ctx->leader_slot=ULONG_MAX. return.
    1574             :    after_frag:
    1575             :          F. LEADER_SWITCH. Requires ctx->leader_slot!=ULONG_MAX
    1576             : 
    1577             :      It isn't possible to get a burst of 3, but a burst of 2 is possible
    1578             :      in these situations.
    1579             : 
    1580             :      C -> F
    1581             :      D -> F
    1582             :      D -> E
    1583             :  */
    1584           0 : #define STEM_BURST (2UL)
    1585             : 
    1586             : /* We want lazy (measured in ns) to be small enough that the producer
    1587             :     and the consumer never have to wait for credits.  For most tango
    1588             :     links, we use a default worst case speed coming from 100 Gbps
    1589             :     Ethernet.  That's not very suitable for microblocks that go from
    1590             :     pack to bank.  Instead we manually estimate the very aggressive
    1591             :     1000ns per microblock, and then reduce it further (in line with the
    1592             :     default lazy value computation) to ensure the random value chosen
    1593             :     based on this won't lead to credit return stalls. */
    1594           0 : #define STEM_LAZY  (128L*3000L)
    1595             : 
    1596           0 : #define STEM_CALLBACK_CONTEXT_TYPE  fd_pack_ctx_t
    1597           0 : #define STEM_CALLBACK_CONTEXT_ALIGN alignof(fd_pack_ctx_t)
    1598             : 
    1599           0 : #define STEM_CALLBACK_DURING_HOUSEKEEPING during_housekeeping
    1600           0 : #define STEM_CALLBACK_BEFORE_CREDIT       before_credit
    1601           0 : #define STEM_CALLBACK_AFTER_CREDIT        after_credit
    1602           0 : #define STEM_CALLBACK_DURING_FRAG         during_frag
    1603           0 : #define STEM_CALLBACK_AFTER_FRAG          after_frag
    1604           0 : #define STEM_CALLBACK_METRICS_WRITE       metrics_write
    1605             : 
    1606             : #include "../stem/fd_stem.c"
    1607             : 
    1608             : fd_topo_run_tile_t fd_tile_pack = {
    1609             :   .name                     = "pack",
    1610             :   .populate_allowed_seccomp = populate_allowed_seccomp,
    1611             :   .populate_allowed_fds     = populate_allowed_fds,
    1612             :   .scratch_align            = scratch_align,
    1613             :   .scratch_footprint        = scratch_footprint,
    1614             :   .privileged_init          = privileged_init,
    1615             :   .unprivileged_init        = unprivileged_init,
    1616             :   .run                      = stem_run,
    1617             : };

Generated by: LCOV version 1.14