Line data Source code
1 : #define FD_UNALIGNED_ACCESS_STYLE 0
2 : #include "fd_pack.h"
3 : #include "fd_pack_cost.h"
4 : #include "fd_pack_bitset.h"
5 : #include "fd_pack_unwritable.h"
6 : #include "fd_chkdup.h"
7 : #include "fd_pack_tip_prog_blacklist.h"
8 : #include <math.h> /* for sqrt */
9 : #include <stddef.h> /* for offsetof */
10 : #include "../metrics/fd_metrics.h"
11 :
12 : #define FD_PACK_USE_NON_TEMPORAL_MEMCPY 1
13 :
14 : /* Declare a bunch of helper structs used for pack-internal data
15 : structures. */
16 : typedef struct {
17 : fd_ed25519_sig_t sig;
18 : } wrapped_sig_t;
19 :
20 : /* fd_pack_ord_txn_t: An fd_txn_p_t with information required to order
21 : it by priority. */
22 : struct fd_pack_private_ord_txn {
23 : /* It's important that there be no padding here (asserted below)
24 : because the code casts back and forth from pointers to this element
25 : to pointers to the whole struct. */
26 : union {
27 : fd_txn_p_t txn[1]; /* txn is an alias for txn_e->txnp */
28 : fd_txn_e_t txn_e[1];
29 : fd_txn_e_t _txn_e; /* Non-array type needed for map_chain */
30 : struct{ uchar _sig_cnt; wrapped_sig_t sig; };
31 : };
32 :
33 : /* Since this struct can be in one of several trees, it's helpful to
34 : store which tree. This should be one of the FD_ORD_TXN_ROOT_*
35 : values. */
36 : int root;
37 :
38 : /* The sig2txn map_chain fields */
39 : ushort sigmap_next;
40 : ushort sigmap_prev;
41 :
42 : /* Each transaction is inserted with an expiration "time." This code
43 : doesn't care about the units (blocks, rdtsc tick, ns, etc.), and
44 : doesn't require transactions to be inserted in expiration date
45 : order. */
46 : ulong expires_at;
47 : /* expq_idx: When this object is part of one of the treaps, it's
48 : also in the expiration priority queue. This field (which is
49 : manipulated behind the scenes by the fd_prq code) stores where so
50 : that if we delete this transaction, we can also delete it from the
51 : expiration priority queue. */
52 : ulong expq_idx;
53 :
54 : /* The noncemap map_chain fields */
55 : ushort noncemap_next;
56 : ushort noncemap_prev;
57 :
58 : /* We want rewards*compute_est to fit in a ulong so that r1/c1 < r2/c2 can be
59 : computed as r1*c2 < r2*c1, with the product fitting in a ulong.
60 : compute_est has a small natural limit of mid-20 bits. rewards doesn't have
61 : a natural limit, so there is some argument to be made for raising the
62 : limit for rewards to 40ish bits. The struct has better packing with
63 : uint/uint though. */
64 : uint __attribute__((aligned(64))) /* We want the treap fields and the bitsets
65 : to be on the same double cache line pair */
66 : rewards; /* in Lamports */
67 : uint compute_est; /* in compute units */
68 :
69 : /* The treap fields */
70 : ushort left;
71 : ushort right;
72 : ushort parent;
73 : ushort prio;
74 : ushort prev;
75 : ushort next;
76 :
77 : /* skip: if we skip this transaction more than FD_PACK_SKIP_CNT times
78 : for reasons that won't go away until the end of the block, then we
79 : want to skip it very quickly. If skip is in [1, FD_PACK_SKIP_CNT],
80 : then that means we have to skip it `skip` more times before taking
81 : any action. If skip>FD_PACK_SKIP_CNT, then it is a compressed slot
82 : number during which it should be skipped, and we'll skip it until
83 : the compressed slot reaches a new value. skip is never 0. */
84 : ushort skip;
85 :
86 : FD_PACK_BITSET_DECLARE( rw_bitset ); /* all accts this txn references */
87 : FD_PACK_BITSET_DECLARE( w_bitset ); /* accts this txn write-locks */
88 :
89 : };
90 : typedef struct fd_pack_private_ord_txn fd_pack_ord_txn_t;
91 :
92 : /* What we want is that the payload starts at byte 0 of
93 : fd_pack_ord_txn_t so that the trick with the signature map works
94 : properly. GCC and Clang seem to disagree on the rules of offsetof.
95 : */
96 : FD_STATIC_ASSERT( offsetof( fd_pack_ord_txn_t, txn )==0UL, fd_pack_ord_txn_t );
97 : FD_STATIC_ASSERT( offsetof( fd_pack_ord_txn_t, sig )==1UL, fd_pack_ord_txn_t );
98 : #if FD_USING_CLANG
99 : FD_STATIC_ASSERT( offsetof( fd_txn_p_t, payload )==0UL, fd_pack_ord_txn_t );
100 : #else
101 : FD_STATIC_ASSERT( offsetof( fd_pack_ord_txn_t, txn->payload )==0UL, fd_pack_ord_txn_t );
102 : FD_STATIC_ASSERT( offsetof( fd_pack_ord_txn_t, txn_e->txnp )==0UL, fd_pack_ord_txn_t );
103 : #endif
104 :
105 : /* FD_ORD_TXN_ROOT is essentially a small union packed into an int. The low
106 : byte is the "tag". The higher 3 bytes depend on the low byte. */
107 4452279 : #define FD_ORD_TXN_ROOT_TAG_MASK 0xFF
108 19625991 : #define FD_ORD_TXN_ROOT_FREE 0
109 17975744 : #define FD_ORD_TXN_ROOT_PENDING 1
110 13245714 : #define FD_ORD_TXN_ROOT_PENDING_VOTE 2
111 1065 : #define FD_ORD_TXN_ROOT_PENDING_BUNDLE 3
112 328987 : #define FD_ORD_TXN_ROOT_PENALTY( idx ) (4 | (idx)<<8)
113 :
114 : /* if root & TAG_MASK == PENALTY, then PENALTY_ACCT_IDX(root) gives the index
115 : in the transaction's list of account addresses of which penalty treap the
116 : transaction is in. */
117 : #define FD_ORD_TXN_ROOT_PENALTY_ACCT_IDX( root ) (((root) & 0xFF00)>>8)
118 :
119 29113254 : #define FD_PACK_IN_USE_WRITABLE (0x8000000000000000UL)
120 15322005 : #define FD_PACK_IN_USE_BIT_CLEARED (0x4000000000000000UL)
121 :
122 : /* Each non-empty microblock we schedule also has an overhead of 48
123 : bytes that counts towards shed limits. That comes from the 32 byte
124 : hash, the hash count (8 bytes) and the transaction count (8 bytes).
125 : We don't have to pay this overhead if the microblock is empty, since
126 : those microblocks get dropped. */
127 3187704 : #define MICROBLOCK_DATA_OVERHEAD 48UL
128 :
129 : /* Keep track of accounts that are written to in each block so that we
130 : can reset the writer costs to 0. If the number of accounts that are
131 : written to is above or equal to this, we'll just clear the whole
132 : writer cost map instead of only removing the elements we increased. */
133 1368 : #define DEFAULT_WRITTEN_LIST_MAX 16384UL
134 :
135 : FD_STATIC_ASSERT( sizeof(fd_acct_addr_t)==sizeof(fd_pubkey_t), "" );
136 :
137 : /* fd_pack_expq_t: An element of an fd_prq to sort the transactions by
138 : timeout. This structure has several invariants for entries
139 : corresponding to pending transactions:
140 : expires_at == txn->expires_at
141 : txn->exp_prq_idx is the index of this structure
142 : Notice that prq is an array-based heap, which means the indexes of
143 : elements change. The PRQ_TMP_ST macro is hijacked to keep that
144 : invariant up to date.
145 :
146 : Note: this could be easier if fd_heap supported deleting from the
147 : middle, but that's not possible with the current design of fd_heap,
148 : which omits a parent pointer for improved performance. */
149 : struct fd_pack_expq {
150 : ulong expires_at;
151 : fd_pack_ord_txn_t * txn;
152 : };
153 : typedef struct fd_pack_expq fd_pack_expq_t;
154 :
155 :
156 : /* fd_pack_bitset_acct_mapping_t: An element of an fd_map_dynamic that
157 : maps an account address to the number of transactions that are
158 : referencing it and the bit that is reserved to indicate it in the
159 : bitset, if any. */
160 : struct fd_pack_bitset_acct_mapping {
161 : fd_acct_addr_t key; /* account address */
162 : ulong ref_cnt;
163 :
164 : /* first_instance and first_instance_was_write are only valid when
165 : bit==FD_PACK_BITSET_FIRST_INSTANCE, which is set when ref_cnt
166 : transitions from 0 to 1. These just exist to implement the
167 : optimization that accounts referenced a single time aren't
168 : allocated a bit, but this seems to be an important optimization. */
169 : fd_pack_ord_txn_t * first_instance;
170 : int first_instance_was_write;
171 :
172 : /* bit is in [0, FD_PACK_BITSET_MAX) U
173 : { FD_PACK_BITSET_FIRST_INSTANCE, FD_PACK_BITSET_SLOWPATH }. */
174 : ushort bit;
175 : };
176 : typedef struct fd_pack_bitset_acct_mapping fd_pack_bitset_acct_mapping_t;
177 :
178 :
179 :
180 : /* pack maintains a small state machine related to initializer bundles.
181 : See the header file for more details about it, but it's
182 : also summarized here:
183 : * NOT_INITIALIZED: The starting state for each block
184 : * PENDING: an initializer bundle has been scheduled, but pack has
185 : not observed its result yet, so we don't know if it was successful
186 : or not.
187 : * FAILED: the most recently scheduled initializer bundle failed
188 : for reasons other than already being executed. Most commonly, this
189 : could be because of a bug in the code that generated the
190 : initializer bundle, a lack of fee payer balance, or an expired
191 : blockhash.
192 : * READY: the most recently scheduled initialization bundle succeeded
193 : and normal bundles can be scheduled in this slot. */
194 2646 : #define FD_PACK_IB_STATE_NOT_INITIALIZED 0
195 0 : #define FD_PACK_IB_STATE_PENDING 1
196 0 : #define FD_PACK_IB_STATE_FAILED 2
197 3 : #define FD_PACK_IB_STATE_READY 3
198 :
199 :
200 : /* Returns 1 if x.rewards/x.compute < y.rewards/y.compute. Not robust. */
201 84352482 : #define COMPARE_WORSE(x,y) ( ((ulong)((x)->rewards)*(ulong)((y)->compute_est)) < ((ulong)((y)->rewards)*(ulong)((x)->compute_est)) )
202 :
203 : /* Declare all the data structures */
204 :
205 :
206 : /* Define the big max-"heap" that we pull transactions off to schedule.
207 : The priority is given by reward/compute. We may want to add in some
208 : additional terms at a later point. In order to cheaply remove nodes,
209 : we actually use a treap. */
210 : #define POOL_NAME trp_pool
211 1584 : #define POOL_T fd_pack_ord_txn_t
212 : #define POOL_IDX_T ushort
213 29533320 : #define POOL_NEXT parent
214 : #include "../../util/tmpl/fd_pool.c"
215 :
216 : #define TREAP_T fd_pack_ord_txn_t
217 : #define TREAP_NAME treap
218 : #define TREAP_QUERY_T void * /* We don't use query ... */
219 : #define TREAP_CMP(a,b) (__extension__({ (void)(a); (void)(b); -1; })) /* which means we don't need to give a real
220 : implementation to cmp either */
221 180218799 : #define TREAP_IDX_T ushort
222 : #define TREAP_OPTIMIZE_ITERATION 1
223 84352482 : #define TREAP_LT COMPARE_WORSE
224 : #include "../../util/tmpl/fd_treap.c"
225 :
226 :
227 : #define MAP_NAME sig2txn
228 : #define MAP_OPTIMIZE_RANDOM_ACCESS_REMOVAL 1
229 : #define MAP_MULTI 1
230 13549515 : #define MAP_ELE_T fd_pack_ord_txn_t
231 36494292 : #define MAP_PREV sigmap_prev
232 34932687 : #define MAP_NEXT sigmap_next
233 13554268 : #define MAP_IDX_T ushort
234 : #define MAP_KEY_T wrapped_sig_t
235 26590063 : #define MAP_KEY sig
236 1088 : #define MAP_KEY_EQ(k0,k1) (!memcmp( (k0),(k1), FD_TXN_SIGNATURE_SZ) )
237 26591137 : #define MAP_KEY_HASH(key,seed) fd_hash( (seed), (key), 64UL )
238 : #include "../../util/tmpl/fd_map_chain.c"
239 :
240 :
241 : /* noncemap: A map from (nonce account, nonce authority, recent
242 : blockhash) to a durable nonce transaction containing it. We only
243 : want to allow one transaction in the pool at a time with a given
244 : (nonce account, recent blockhash) tuple value. The question is: can
245 : adding this limitation cause us to throw out potentially valuable
246 : transaction? The answer is yes, but only very rarely, and the
247 : savings are worth it. Suppose we have durable nonce transactions t1
248 : and t2 that advance the same nonce account and have the same value
249 : for the recent blockhash.
250 :
251 : - If t1 lands on chain, then it will advance the nonce account, and
252 : t2 will certainly not land on chain.
253 : - If t1 fails with AlreadyExecuted, that means the nonce account was
254 : advanced when t1 landed in a previous block, so t2 will certainly not
255 : land on chain.
256 : - If t1 fails with BlockhashNotFound, then the nonce account was
257 : advanced in some previous transaction, so again, t2 will certainly
258 : not land on chain.
259 : - If t1 does not land on chain because of an issue with the fee
260 : payer, it's possible that t2 could land on chain if it used a
261 : different fee payer, but historical data shows this is unlikely.
262 : - If t1 does not land on chain because it is part of a bundle that
263 : fails for an unrelated reason, it's possible that t2 could land on
264 : chain, but again, historical data says this is rare.
265 :
266 : We need to include the nonce authority in the hash to prevent one
267 : user from being able to DoS another user. */
268 :
269 : typedef struct {
270 : uchar const * recent_blockhash;
271 : fd_acct_addr_t const * nonce_acct;
272 : fd_acct_addr_t const * nonce_auth;
273 : } noncemap_extract_t;
274 :
275 : /* k must be a valid, durable nonce transaction. No error checking is
276 : done. */
277 : static inline void
278 : noncemap_extract( fd_txn_e_t const * k,
279 3378 : noncemap_extract_t * out ) {
280 3378 : fd_txn_t const * txn = TXN(k->txnp);
281 3378 : out->recent_blockhash = fd_txn_get_recent_blockhash( txn, k->txnp->payload );
282 :
283 3378 : ulong nonce_idx = k->txnp->payload[ txn->instr[ 0 ].acct_off+0 ];
284 3378 : ulong autho_idx = k->txnp->payload[ txn->instr[ 0 ].acct_off+2 ];
285 :
286 3378 : ulong imm_cnt = fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM );
287 3378 : fd_acct_addr_t const * accts = fd_txn_get_acct_addrs( txn, k->txnp->payload );
288 3378 : fd_acct_addr_t const * alt_adj = k->alt_accts - imm_cnt;
289 3378 : out->nonce_acct = fd_ptr_if( nonce_idx<imm_cnt, accts, alt_adj )+nonce_idx;
290 : /* The nonce authority must be a signer, so it must be an immediate
291 : account. */
292 3378 : out->nonce_auth = accts+autho_idx;
293 3378 : }
294 :
295 : static inline int
296 : noncemap_key_eq_internal( fd_txn_e_t const * k0,
297 171 : fd_txn_e_t const * k1 ) {
298 171 : noncemap_extract_t e0[1], e1[1];
299 171 : noncemap_extract( k0, e0 );
300 171 : noncemap_extract( k1, e1 );
301 :
302 171 : if( FD_UNLIKELY( memcmp( e0->recent_blockhash, e1->recent_blockhash, 32UL ) ) ) return 0;
303 63 : if( FD_UNLIKELY( memcmp( e0->nonce_acct, e1->nonce_acct, 32UL ) ) ) return 0;
304 63 : if( FD_UNLIKELY( memcmp( e0->nonce_auth, e1->nonce_auth, 32UL ) ) ) return 0;
305 63 : return 1;
306 63 : }
307 :
308 : static inline ulong
309 : noncemap_key_hash_internal( ulong seed,
310 3036 : fd_txn_e_t const * k ) {
311 : /* TODO: This takes >100 cycles! */
312 3036 : noncemap_extract_t e[1];
313 3036 : noncemap_extract( k, e );
314 3036 : return fd_hash( seed, e->recent_blockhash, 32UL ) ^
315 3036 : fd_hash( seed+ 864394383UL, e->nonce_acct, 32UL ) ^
316 3036 : fd_hash( seed+3818662446UL, e->nonce_auth, 32UL );
317 3036 : }
318 :
319 : #define MAP_NAME noncemap
320 : #define MAP_OPTIMIZE_RANDOM_ACCESS_REMOVAL 1
321 : #define MAP_MULTI 0
322 375 : #define MAP_ELE_T fd_pack_ord_txn_t
323 558 : #define MAP_PREV noncemap_prev
324 1073 : #define MAP_NEXT noncemap_next
325 4191 : #define MAP_IDX_T ushort
326 : #define MAP_KEY_T fd_txn_e_t
327 756 : #define MAP_KEY _txn_e
328 171 : #define MAP_KEY_EQ(k0,k1) noncemap_key_eq_internal( (k0), (k1) )
329 3036 : #define MAP_KEY_HASH(key,seed) noncemap_key_hash_internal( (seed), (key) )
330 : #include "../../util/tmpl/fd_map_chain.c"
331 :
332 :
333 : static const fd_acct_addr_t null_addr = { 0 };
334 :
335 : #define MAP_NAME acct_uses
336 94130897 : #define MAP_T fd_pack_addr_use_t
337 111079988 : #define MAP_KEY_T fd_acct_addr_t
338 312517985 : #define MAP_KEY_NULL null_addr
339 : #if FD_HAS_AVX
340 111079988 : # define MAP_KEY_INVAL(k) _mm256_testz_si256( wb_ldu( (k).b ), wb_ldu( (k).b ) )
341 : #else
342 : # define MAP_KEY_INVAL(k) MAP_KEY_EQUAL(k, null_addr)
343 : #endif
344 77151255 : #define MAP_KEY_EQUAL(k0,k1) (!memcmp((k0).b,(k1).b, FD_TXN_ACCT_ADDR_SZ))
345 : #define MAP_KEY_EQUAL_IS_SLOW 1
346 : #define MAP_MEMOIZE 0
347 94124860 : #define MAP_KEY_HASH(key,s) ((uint)fd_ulong_hash( fd_ulong_load_8( (key).b ) ))
348 : #include "../../util/tmpl/fd_map_dynamic.c"
349 :
350 :
351 : #define MAP_NAME bitset_map
352 52256261 : #define MAP_T fd_pack_bitset_acct_mapping_t
353 65530416 : #define MAP_KEY_T fd_acct_addr_t
354 873919460 : #define MAP_KEY_NULL null_addr
355 : #if FD_HAS_AVX
356 1654811184 : # define MAP_KEY_INVAL(k) _mm256_testz_si256( wb_ldu( (k).b ), wb_ldu( (k).b ) )
357 : #else
358 : # define MAP_KEY_INVAL(k) MAP_KEY_EQUAL(k, null_addr)
359 : #endif
360 39015093 : #define MAP_KEY_EQUAL(k0,k1) (!memcmp((k0).b,(k1).b, FD_TXN_ACCT_ADDR_SZ))
361 : #define MAP_KEY_EQUAL_IS_SLOW 1
362 : #define MAP_MEMOIZE 0
363 52282969 : #define MAP_KEY_HASH(key,s) ((uint)fd_ulong_hash( fd_ulong_load_8( (key).b ) ))
364 : #include "../../util/tmpl/fd_map_dynamic.c"
365 :
366 :
367 : /* Since transactions can also expire, we also maintain a parallel
368 : priority queue. This means elements are simultaneously part of the
369 : treap (ordered by priority) and the expiration queue (ordered by
370 : expiration). It's tempting to use the priority field of the treap
371 : for this purpose, but that can result in degenerate treaps in some
372 : cases. */
373 : #define PRQ_NAME expq
374 32764636 : #define PRQ_T fd_pack_expq_t
375 27086424 : #define PRQ_TIMEOUT_T ulong
376 27086424 : #define PRQ_TIMEOUT expires_at
377 15859142 : #define PRQ_TMP_ST(p,t) do { \
378 15859142 : (p)[0] = (t); \
379 15859142 : t.txn->expq_idx = (ulong)((p)-heap); \
380 15859142 : } while( 0 )
381 : #include "../../util/tmpl/fd_prq.c"
382 :
383 : /* With realistic traffic patterns, we often see many, many transactions
384 : competing for the same writable account. Since only one of these can
385 : execute at a time, we sometimes waste lots of scheduling time going
386 : through them one at a time. To combat that, when a transaction
387 : writes to an account with more than PENALTY_TREAP_THRESHOLD
388 : references (readers or writers), instead of inserting it into the
389 : main treap, we insert it into a penalty treap for that specific hot
390 : account address. These transactions are not immediately available
391 : for scheduling. Then, when a transaction that writes to the hot
392 : address completes, we move the most lucrative transaction from the
393 : penalty treap to the main treap, making it available for scheduling.
394 : This policy may slightly violate the price-time priority scheduling
395 : approach pack normally uses: if the most lucrative transaction
396 : competing for hot state arrives after PENALTY_TREAP_THRESHOLD has
397 : been hit, it may be scheduled second instead of first. However, if
398 : the account is in use at the time the new transaction arrives, it
399 : will be scheduled next, as desired. This minor difference seems
400 : reasonable to reduce complexity.
401 :
402 : fd_pack_penalty_treap is one account-specific penalty treap. All the
403 : transactions in the penalty_treap treap write to key.
404 :
405 : penalty_map is the fd_map_dynamic that maps accounts to their
406 : respective penalty treaps. */
407 : struct fd_pack_penalty_treap {
408 : fd_acct_addr_t key;
409 : treap_t penalty_treap[1];
410 : };
411 : typedef struct fd_pack_penalty_treap fd_pack_penalty_treap_t;
412 :
413 : #define MAP_NAME penalty_map
414 4269007 : #define MAP_T fd_pack_penalty_treap_t
415 4270851 : #define MAP_KEY_T fd_acct_addr_t
416 13450965 : #define MAP_KEY_NULL null_addr
417 : #if FD_HAS_AVX
418 29103363 : # define MAP_KEY_INVAL(k) _mm256_testz_si256( wb_ldu( (k).b ), wb_ldu( (k).b ) )
419 : #else
420 : # define MAP_KEY_INVAL(k) MAP_KEY_EQUAL(k, null_addr)
421 : #endif
422 4265049 : #define MAP_KEY_EQUAL(k0,k1) (!memcmp((k0).b,(k1).b, FD_TXN_ACCT_ADDR_SZ))
423 : #define MAP_KEY_EQUAL_IS_SLOW 1
424 : #define MAP_MEMOIZE 0
425 4267948 : #define MAP_KEY_HASH(key,s) ((uint)fd_ulong_hash( fd_ulong_load_8( (key).b ) ))
426 : #include "../../util/tmpl/fd_map_dynamic.c"
427 :
428 : /* PENALTY_TREAP_THRESHOLD: How many references to an account do we
429 : allow before subsequent transactions that write to the account go to
430 : the penalty treap. */
431 29405700 : #define PENALTY_TREAP_THRESHOLD 64UL
432 :
433 :
434 : /* FD_PACK_SKIP_CNT: How many times we'll skip a transaction (for
435 : reasons other than account conflicts) before we won't consider it
436 : until the next slot. For performance reasons, this doesn't reset at
437 : the end of a slot, so e.g. we might skip twice in slot 1, then three
438 : times in slot 2, which would be enough to prevent considering it
439 : until slot 3. The main reason this is not 1 is that some skips that
440 : seem permanent until the end of the slot can actually go away based
441 : on rebates. */
442 13555434 : #define FD_PACK_SKIP_CNT 50UL
443 :
444 : /* Finally, we can now declare the main pack data structure */
445 : struct fd_pack_private {
446 : ulong pack_depth;
447 : ulong bundle_meta_sz; /* if 0, bundles are disabled */
448 : ulong bank_tile_cnt;
449 :
450 : fd_pack_limits_t lim[1];
451 :
452 : ulong pending_txn_cnt; /* Summed across all treaps */
453 : ulong microblock_cnt; /* How many microblocks have we
454 : generated in this block? */
455 : ulong data_bytes_consumed; /* How much data is in this block so
456 : far ? */
457 :
458 : /* counters / gauge for schedule outcome enums */
459 : ulong sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_CNT ];
460 :
461 : fd_rng_t * rng;
462 :
463 : ulong cumulative_block_cost;
464 : ulong cumulative_vote_cost;
465 :
466 : /* expire_before: Any transactions with expires_at strictly less than
467 : the current expire_before are removed from the available pending
468 : transaction. Here, "expire" is used as a verb: cause all
469 : transactions before this time to expire. */
470 : ulong expire_before;
471 :
472 : /* outstanding_microblock_mask: a bitmask indicating which banking
473 : tiles have outstanding microblocks, i.e. fd_pack has generated a
474 : microblock for that banking tile and the banking tile has not yet
475 : notified fd_pack that it has completed it. */
476 : ulong outstanding_microblock_mask;
477 :
478 : /* The actual footprint for the pool and maps is allocated
479 : in the same order in which they are declared immediately following
480 : the struct. I.e. these pointers point to memory not far after the
481 : struct. The trees are just pointers into the pool so don't take up
482 : more space. */
483 :
484 : fd_pack_ord_txn_t * pool;
485 :
486 : /* Treaps (sorted by priority) of pending transactions. We store the
487 : pending simple votes and transactions that come from bundles
488 : separately. */
489 : treap_t pending[1];
490 : treap_t pending_votes[1];
491 : treap_t pending_bundles[1];
492 :
493 : /* penalty_treaps: an fd_map_dynamic mapping hotly contended account
494 : addresses to treaps of transactions that write to them. We try not
495 : to allow more than roughly PENALTY_TREAP_THRESHOLD transactions in
496 : the main treap that write to each account, though this is not
497 : exact. */
498 : fd_pack_penalty_treap_t * penalty_treaps;
499 :
500 : /* initializer_bundle_state: The current state of the initialization
501 : bundle state machine. One of the FD_PACK_IB_STATE_* values. See
502 : the long comment in the header and the comments attached to the
503 : respective values for a discussion of what each state means and the
504 : transitions between them. */
505 : int initializer_bundle_state;
506 :
507 : /* relative_bundle_idx: the number of bundles that have been inserted
508 : since the last time pending_bundles was empty. See the long
509 : comment about encoding this index in the rewards field of each
510 : transaction in the bundle, and why it is important that this reset
511 : to 0 as frequently as possible. */
512 : ulong relative_bundle_idx;
513 :
514 : /* pending{_votes}_smallest: keep a conservative estimate of the
515 : smallest transaction (by cost units and by bytes) in each heap.
516 : Both CUs and bytes should be set to ULONG_MAX is the treap is
517 : empty. */
518 : fd_pack_smallest_t pending_smallest[1];
519 : fd_pack_smallest_t pending_votes_smallest[1];
520 :
521 : /* expiration_q: At the same time that a transaction is in exactly one
522 : of the above treaps, it is also in the expiration queue, sorted by
523 : its expiration time. This enables deleting all transactions that
524 : have expired, regardless of which treap they are in. */
525 : fd_pack_expq_t * expiration_q;
526 :
527 : /* acct_in_use: Map from account address to bitmask indicating which
528 : bank tiles are using the account and whether that use is read or
529 : write (msb). */
530 : fd_pack_addr_use_t * acct_in_use;
531 :
532 : /* bitset_{w, rw}_in_use stores a subset of the information in
533 : acct_in_use using the compressed set format explained at the top of
534 : this file. rw_in_use stores accounts in use for read or write
535 : while w_in_use stores only those in use for write. */
536 : FD_PACK_BITSET_DECLARE( bitset_rw_in_use );
537 : FD_PACK_BITSET_DECLARE( bitset_w_in_use );
538 :
539 : /* writer_costs: Map from account addresses to the sum of costs of
540 : transactions that write to the account. Used for enforcing limits
541 : on the max write cost per account per block. */
542 : fd_pack_addr_use_t * writer_costs;
543 :
544 : /* top_writers: A simple max heap of the top 5 writers in the slot,
545 : used by downstream consumers for monitoring purposes. */
546 : fd_pack_addr_use_t top_writers[ FD_PACK_TOP_WRITERS_CNT ];
547 :
548 : /* At the end of every slot, we have to clear out writer_costs. The
549 : map is large, but typically very sparsely populated. As an
550 : optimization, we keep track of the elements of the map that we've
551 : actually used, up to a maximum. If we use more than the maximum,
552 : we revert to the old way of just clearing the whole map.
553 :
554 : written_list indexed [0, written_list_cnt).
555 : written_list_cnt in [0, written_list_max).
556 :
557 : written_list_cnt==written_list_max-1 means that the list may be
558 : incomplete and should be ignored. */
559 : fd_pack_addr_use_t * * written_list;
560 : ulong written_list_cnt;
561 : ulong written_list_max;
562 :
563 : /* Noncemap is a map_chain that maps from tuples (nonce account,
564 : recent blockhash value, nonce authority) to a transaction. This
565 : map stores exactly the transactions in pool that have the nonce
566 : flag set. */
567 : noncemap_t * noncemap;
568 :
569 : sig2txn_t * signature_map; /* Stores pointers into pool for deleting by signature */
570 :
571 : /* bundle_temp_map: A fd_map_dynamic (although it could be an fd_map)
572 : used during fd_pack_try_schedule_bundle to store information about
573 : what accounts are used by transactions in the bundle. It's empty
574 : (in a map sense) outside of calls to try_schedule_bundle, and each
575 : call to try_schedule_bundle clears it after use. If bundles are
576 : disabled, this is a valid fd_map_dynamic, but it's as small as
577 : convenient and remains empty. */
578 : fd_pack_addr_use_t * bundle_temp_map;
579 :
580 :
581 : /* use_by_bank: An array of size (max_txn_per_microblock *
582 : FD_TXN_ACCT_ADDR_MAX) for each banking tile. Only the MSB of
583 : in_use_by is relevant. Addressed use_by_bank[i][j] where i is in
584 : [0, bank_tile_cnt) and j is in [0, use_by_bank_cnt[i]). Used
585 : mostly for clearing the proper bits of acct_in_use when a
586 : microblock finishes.
587 :
588 : use_by_bank_txn: indexed [i][j], where i is in [0, bank_tile_cnt)
589 : and j is in [0, max_txn_per_microblock). Transaction j in the
590 : microblock currently scheduled to bank i uses account addresses in
591 : use_by_bank[i][k] where k is in [0, use_by_bank[i][j]). For
592 : example, if use_by_bank[i][0] = 2 and use_by_bank[i][1] = 3, then
593 : all the accounts that the first transaction in the outstanding
594 : microblock for bank 0 uses are contained in the set
595 : { use_by_bank[i][0], use_by_bank[i][1] },
596 : and all the accounts in the second transaction in the microblock
597 : are in the set
598 : { use_by_bank[i][0], use_by_bank[i][1], use_by_bank[i][2] }.
599 : Each transaction writes to at least one account (the fee payer)
600 : that no other transaction scheduled to the bank uses, which means
601 : that use_by_bank_txn[i][j] - use_by_bank_txn[i][j-1] >= 1 (with 0
602 : for use_by_bank_txn[i][-1]). This means we can stop iterating when
603 : use_by_bank_txn[i][j] == use_by_bank_cnt[i]. */
604 : fd_pack_addr_use_t * use_by_bank [ FD_PACK_MAX_EXECLE_TILES ];
605 : ulong use_by_bank_cnt[ FD_PACK_MAX_EXECLE_TILES ];
606 : ulong * use_by_bank_txn[ FD_PACK_MAX_EXECLE_TILES ];
607 :
608 : fd_histf_t txn_per_microblock [ 1 ];
609 : fd_histf_t vote_per_microblock[ 1 ];
610 :
611 : fd_histf_t scheduled_cus_per_block[ 1 ];
612 : fd_histf_t rebated_cus_per_block [ 1 ];
613 : fd_histf_t net_cus_per_block [ 1 ];
614 : fd_histf_t pct_cus_per_block [ 1 ];
615 : ulong cumulative_rebated_cus;
616 :
617 :
618 : /* compressed_slot_number: a number in (FD_PACK_SKIP_CNT, USHORT_MAX]
619 : that advances each time we start packing for a new slot. */
620 : ushort compressed_slot_number;
621 :
622 : /* bitset_avail: a stack of which bits are not currently reserved and
623 : can be used to represent an account address.
624 : Indexed [0, bitset_avail_cnt]. Element 0 is fixed at
625 : FD_PACK_BITSET_SLOWPATH. */
626 : ushort bitset_avail[ 1UL+FD_PACK_BITSET_MAX ];
627 : ulong bitset_avail_cnt;
628 :
629 : /* acct_to_bitset: an fd_map_dynamic that maps acct addresses to the
630 : reference count, which bit, etc. */
631 : fd_pack_bitset_acct_mapping_t * acct_to_bitset;
632 :
633 : /* chdkup: scratch memory chkdup needs for its internal processing */
634 : fd_chkdup_t chkdup[ 1 ];
635 :
636 : /* bundle_meta: an array, parallel to the pool, with each element
637 : having size bundle_meta_sz. I.e. if pool[i] has an associated
638 : bundle meta, it's located at bundle_meta[j] for j in
639 : [i*bundle_meta_sz, (i+1)*bundle_meta_sz). */
640 : void * bundle_meta;
641 : };
642 :
643 : typedef struct fd_pack_private fd_pack_t;
644 :
645 : FD_STATIC_ASSERT( offsetof(fd_pack_t, pending_txn_cnt)==FD_PACK_PENDING_TXN_CNT_OFF, txn_cnt_off );
646 :
647 : /* Forward-declare some helper functions */
648 : static ulong delete_transaction( fd_pack_t * pack, fd_pack_ord_txn_t * txn, int delete_full_bundle, int move_from_penalty_treap );
649 : static inline void insert_bundle_impl( fd_pack_t * pack, ulong bundle_idx, ulong txn_cnt, fd_pack_ord_txn_t * * bundle, ulong expires_at );
650 :
651 : FD_FN_PURE ulong
652 : fd_pack_footprint( ulong pack_depth,
653 : ulong bundle_meta_sz,
654 : ulong bank_tile_cnt,
655 312 : fd_pack_limits_t const * limits ) {
656 312 : if( FD_UNLIKELY( (bank_tile_cnt==0) | (bank_tile_cnt>FD_PACK_MAX_EXECLE_TILES) ) ) return 0UL;
657 312 : if( FD_UNLIKELY( pack_depth<4UL ) ) return 0UL;
658 :
659 312 : int enable_bundles = !!bundle_meta_sz;
660 312 : ulong l;
661 312 : ulong extra_depth = fd_ulong_if( enable_bundles, 1UL+2UL*FD_PACK_MAX_TXN_PER_BUNDLE, 1UL ); /* space for use between init and fini */
662 312 : ulong max_acct_in_treap = pack_depth * FD_TXN_ACCT_ADDR_MAX;
663 312 : ulong max_txn_per_mblk = fd_ulong_max( limits->max_txn_per_microblock,
664 312 : fd_ulong_if( enable_bundles, FD_PACK_MAX_TXN_PER_BUNDLE, 0UL ) );
665 312 : ulong max_acct_in_flight = bank_tile_cnt * (FD_TXN_ACCT_ADDR_MAX * max_txn_per_mblk + 1UL);
666 312 : ulong max_txn_in_flight = bank_tile_cnt * max_txn_per_mblk;
667 :
668 312 : ulong max_w_per_block = fd_ulong_min( limits->max_cost_per_block / FD_PACK_COST_PER_WRITABLE_ACCT,
669 312 : max_txn_per_mblk * limits->max_microblocks_per_block * FD_TXN_ACCT_ADDR_MAX );
670 312 : ulong written_list_max = fd_ulong_min( max_w_per_block>>1, DEFAULT_WRITTEN_LIST_MAX );
671 312 : ulong bundle_temp_accts = fd_ulong_if( enable_bundles, FD_PACK_MAX_TXN_PER_BUNDLE*FD_TXN_ACCT_ADDR_MAX, 1UL );
672 312 : ulong sig_chain_cnt = sig2txn_chain_cnt_est( pack_depth );
673 312 : ulong nonce_chain_cnt = noncemap_chain_cnt_est( pack_depth );
674 :
675 : /* log base 2, but with a 2* so that the hash table stays sparse */
676 312 : int lg_uses_tbl_sz = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_acct_in_flight ) );
677 312 : int lg_max_writers = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_w_per_block ) );
678 312 : int lg_acct_in_trp = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_acct_in_treap ) );
679 312 : int lg_penalty_trp = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_acct_in_treap/PENALTY_TREAP_THRESHOLD ) );
680 312 : int lg_bundle_temp = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*bundle_temp_accts ) );
681 :
682 312 : l = FD_LAYOUT_INIT;
683 312 : l = FD_LAYOUT_APPEND( l, FD_PACK_ALIGN, sizeof(fd_pack_t) );
684 312 : l = FD_LAYOUT_APPEND( l, trp_pool_align (), trp_pool_footprint ( pack_depth+extra_depth ) ); /* pool */
685 312 : l = FD_LAYOUT_APPEND( l, penalty_map_align(), penalty_map_footprint( lg_penalty_trp ) ); /* penalty_treaps */
686 312 : l = FD_LAYOUT_APPEND( l, expq_align (), expq_footprint ( pack_depth ) ); /* expiration prq */
687 312 : l = FD_LAYOUT_APPEND( l, acct_uses_align(), acct_uses_footprint( lg_uses_tbl_sz ) ); /* acct_in_use */
688 312 : l = FD_LAYOUT_APPEND( l, acct_uses_align(), acct_uses_footprint( lg_max_writers ) ); /* writer_costs */
689 312 : l = FD_LAYOUT_APPEND( l, 32UL, sizeof(fd_pack_addr_use_t*)*written_list_max ); /* written_list */
690 312 : l = FD_LAYOUT_APPEND( l, noncemap_align (), noncemap_footprint ( nonce_chain_cnt ) ); /* noncemap */
691 312 : l = FD_LAYOUT_APPEND( l, sig2txn_align (), sig2txn_footprint ( sig_chain_cnt ) ); /* signature_map */
692 312 : l = FD_LAYOUT_APPEND( l, acct_uses_align(), acct_uses_footprint( lg_bundle_temp ) ); /* bundle_temp_map*/
693 312 : l = FD_LAYOUT_APPEND( l, 32UL, sizeof(fd_pack_addr_use_t)*max_acct_in_flight ); /* use_by_bank */
694 312 : l = FD_LAYOUT_APPEND( l, 32UL, sizeof(ulong)*max_txn_in_flight ); /* use_by_bank_txn*/
695 312 : l = FD_LAYOUT_APPEND( l, bitset_map_align(), bitset_map_footprint( lg_acct_in_trp ) ); /* acct_to_bitset */
696 312 : l = FD_LAYOUT_APPEND( l, 64UL, (pack_depth+extra_depth)*bundle_meta_sz ); /* bundle_meta */
697 312 : return FD_LAYOUT_FINI( l, FD_PACK_ALIGN );
698 312 : }
699 :
700 : void *
701 : fd_pack_new( void * mem,
702 : ulong pack_depth,
703 : ulong bundle_meta_sz,
704 : ulong bank_tile_cnt,
705 : fd_pack_limits_t const * limits,
706 528 : fd_rng_t * rng ) {
707 :
708 528 : int enable_bundles = !!bundle_meta_sz;
709 528 : ulong extra_depth = fd_ulong_if( enable_bundles, 1UL+2UL*FD_PACK_MAX_TXN_PER_BUNDLE, 1UL );
710 528 : ulong max_acct_in_treap = pack_depth * FD_TXN_ACCT_ADDR_MAX;
711 528 : ulong max_txn_per_mblk = fd_ulong_max( limits->max_txn_per_microblock,
712 528 : fd_ulong_if( enable_bundles, FD_PACK_MAX_TXN_PER_BUNDLE, 0UL ) );
713 528 : ulong max_acct_in_flight = bank_tile_cnt * (FD_TXN_ACCT_ADDR_MAX * max_txn_per_mblk + 1UL);
714 528 : ulong max_txn_in_flight = bank_tile_cnt * max_txn_per_mblk;
715 :
716 528 : ulong max_w_per_block = fd_ulong_min( limits->max_cost_per_block / FD_PACK_COST_PER_WRITABLE_ACCT,
717 528 : max_txn_per_mblk * limits->max_microblocks_per_block * FD_TXN_ACCT_ADDR_MAX );
718 528 : ulong written_list_max = fd_ulong_min( max_w_per_block>>1, DEFAULT_WRITTEN_LIST_MAX );
719 528 : ulong bundle_temp_accts = fd_ulong_if( enable_bundles, FD_PACK_MAX_TXN_PER_BUNDLE*FD_TXN_ACCT_ADDR_MAX, 1UL );
720 528 : ulong sig_chain_cnt = sig2txn_chain_cnt_est( pack_depth );
721 528 : ulong nonce_chain_cnt = noncemap_chain_cnt_est( pack_depth );
722 :
723 : /* log base 2, but with a 2* so that the hash table stays sparse */
724 528 : int lg_uses_tbl_sz = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_acct_in_flight ) );
725 528 : int lg_max_writers = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_w_per_block ) );
726 528 : int lg_acct_in_trp = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_acct_in_treap ) );
727 528 : int lg_penalty_trp = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_acct_in_treap/PENALTY_TREAP_THRESHOLD ) );
728 528 : int lg_bundle_temp = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*bundle_temp_accts ) );
729 :
730 528 : FD_SCRATCH_ALLOC_INIT( l, mem );
731 528 : fd_pack_t * pack = FD_SCRATCH_ALLOC_APPEND( l, FD_PACK_ALIGN, sizeof(fd_pack_t) );
732 : /* The pool has one extra element that is used between insert_init and
733 : cancel/fini. */
734 528 : void * _pool = FD_SCRATCH_ALLOC_APPEND( l, trp_pool_align(), trp_pool_footprint ( pack_depth+extra_depth ) );
735 528 : void * _penalty_map = FD_SCRATCH_ALLOC_APPEND( l, penalty_map_align(), penalty_map_footprint( lg_penalty_trp ) );
736 528 : void * _expq = FD_SCRATCH_ALLOC_APPEND( l, expq_align(), expq_footprint ( pack_depth ) );
737 528 : void * _uses = FD_SCRATCH_ALLOC_APPEND( l, acct_uses_align(), acct_uses_footprint( lg_uses_tbl_sz ) );
738 528 : void * _writer_cost = FD_SCRATCH_ALLOC_APPEND( l, acct_uses_align(), acct_uses_footprint( lg_max_writers ) );
739 528 : void * _written_lst = FD_SCRATCH_ALLOC_APPEND( l, 32UL, sizeof(fd_pack_addr_use_t*)*written_list_max );
740 528 : void * _noncemap = FD_SCRATCH_ALLOC_APPEND( l, noncemap_align(), noncemap_footprint ( nonce_chain_cnt ) );
741 528 : void * _sig_map = FD_SCRATCH_ALLOC_APPEND( l, sig2txn_align(), sig2txn_footprint ( sig_chain_cnt ) );
742 528 : void * _bundle_temp = FD_SCRATCH_ALLOC_APPEND( l, acct_uses_align(), acct_uses_footprint( lg_bundle_temp ) );
743 528 : void * _use_by_bank = FD_SCRATCH_ALLOC_APPEND( l, 32UL, sizeof(fd_pack_addr_use_t)*max_acct_in_flight );
744 528 : void * _use_by_txn = FD_SCRATCH_ALLOC_APPEND( l, 32UL, sizeof(ulong)*max_txn_in_flight );
745 528 : void * _acct_bitset = FD_SCRATCH_ALLOC_APPEND( l, bitset_map_align(), bitset_map_footprint( lg_acct_in_trp ) );
746 528 : void * bundle_meta = FD_SCRATCH_ALLOC_APPEND( l, 64UL, (pack_depth+extra_depth)*bundle_meta_sz );
747 :
748 0 : pack->pack_depth = pack_depth;
749 528 : pack->bundle_meta_sz = bundle_meta_sz;
750 528 : pack->bank_tile_cnt = bank_tile_cnt;
751 528 : pack->lim[0] = *limits;
752 528 : pack->pending_txn_cnt = 0UL;
753 528 : pack->microblock_cnt = 0UL;
754 528 : pack->data_bytes_consumed = 0UL;
755 528 : memset( pack->sched_results, 0, sizeof(pack->sched_results) );
756 528 : pack->rng = rng;
757 528 : pack->cumulative_block_cost = 0UL;
758 528 : pack->cumulative_vote_cost = 0UL;
759 528 : pack->expire_before = 0UL;
760 528 : pack->outstanding_microblock_mask = 0UL;
761 528 : pack->cumulative_rebated_cus = 0UL;
762 :
763 :
764 528 : trp_pool_new( _pool, pack_depth+extra_depth );
765 :
766 528 : fd_pack_ord_txn_t * pool = trp_pool_join( _pool );
767 528 : treap_seed( pool, pack_depth+extra_depth, fd_rng_ulong( rng ) );
768 2186148 : for( ulong i=0UL; i<pack_depth+extra_depth; i++ ) pool[i].root = FD_ORD_TXN_ROOT_FREE;
769 :
770 528 : (void)trp_pool_leave( pool );
771 :
772 528 : penalty_map_new( _penalty_map, lg_penalty_trp, 0UL );
773 :
774 : /* These treaps can have at most pack_depth elements at any moment,
775 : but they come from a pool of size pack_depth+extra_depth. */
776 528 : treap_new( (void*)pack->pending, pack_depth+extra_depth );
777 528 : treap_new( (void*)pack->pending_votes, pack_depth+extra_depth );
778 528 : treap_new( (void*)pack->pending_bundles, pack_depth+extra_depth );
779 :
780 528 : pack->pending_smallest->cus = ULONG_MAX;
781 528 : pack->pending_smallest->bytes = ULONG_MAX;
782 528 : pack->pending_votes_smallest->cus = ULONG_MAX;
783 528 : pack->pending_votes_smallest->bytes = ULONG_MAX;
784 :
785 528 : expq_new( _expq, pack_depth );
786 :
787 528 : FD_PACK_BITSET_CLEAR( pack->bitset_rw_in_use );
788 528 : FD_PACK_BITSET_CLEAR( pack->bitset_w_in_use );
789 :
790 528 : acct_uses_new( _uses, lg_uses_tbl_sz, 0UL );
791 528 : acct_uses_new( _writer_cost, lg_max_writers, 0UL );
792 528 : acct_uses_new( _bundle_temp, lg_bundle_temp, 0UL );
793 :
794 528 : pack->written_list = _written_lst;
795 528 : pack->written_list_cnt = 0UL;
796 528 : pack->written_list_max = written_list_max;
797 :
798 528 : noncemap_new( _noncemap, nonce_chain_cnt, fd_rng_ulong( rng ) );
799 :
800 528 : sig2txn_new( _sig_map, sig_chain_cnt, fd_rng_ulong( rng ) );
801 :
802 528 : fd_pack_addr_use_t * use_by_bank = (fd_pack_addr_use_t *)_use_by_bank;
803 528 : ulong * use_by_bank_txn = (ulong *)_use_by_txn;
804 6783 : for( ulong i=0UL; i<bank_tile_cnt; i++ ) {
805 6255 : pack->use_by_bank [i] = use_by_bank + i*(FD_TXN_ACCT_ADDR_MAX*max_txn_per_mblk+1UL);
806 6255 : pack->use_by_bank_cnt[i] = 0UL;
807 6255 : pack->use_by_bank_txn[i] = use_by_bank_txn + i*max_txn_per_mblk;
808 6255 : pack->use_by_bank_txn[i][0] = 0UL;
809 6255 : }
810 27009 : for( ulong i=bank_tile_cnt; i<FD_PACK_MAX_EXECLE_TILES; i++ ) {
811 26481 : pack->use_by_bank [i] = NULL;
812 26481 : pack->use_by_bank_cnt[i] = 0UL;
813 26481 : pack->use_by_bank_txn[i] = NULL;
814 26481 : }
815 :
816 528 : fd_histf_new( pack->txn_per_microblock, FD_MHIST_MIN( PACK, TOTAL_TRANSACTIONS_PER_MICROBLOCK_COUNT ),
817 528 : FD_MHIST_MAX( PACK, TOTAL_TRANSACTIONS_PER_MICROBLOCK_COUNT ) );
818 528 : fd_histf_new( pack->vote_per_microblock, FD_MHIST_MIN( PACK, VOTES_PER_MICROBLOCK_COUNT ),
819 528 : FD_MHIST_MAX( PACK, VOTES_PER_MICROBLOCK_COUNT ) );
820 :
821 528 : fd_histf_new( pack->scheduled_cus_per_block, FD_MHIST_MIN( PACK, CUS_SCHEDULED ),
822 528 : FD_MHIST_MAX( PACK, CUS_SCHEDULED ) );
823 528 : fd_histf_new( pack->rebated_cus_per_block, FD_MHIST_MIN( PACK, CUS_REBATED ),
824 528 : FD_MHIST_MAX( PACK, CUS_REBATED ) );
825 528 : fd_histf_new( pack->net_cus_per_block, FD_MHIST_MIN( PACK, CUS_NET ),
826 528 : FD_MHIST_MAX( PACK, CUS_NET ) );
827 528 : fd_histf_new( pack->pct_cus_per_block, FD_MHIST_MIN( PACK, CUS_PCT ),
828 528 : FD_MHIST_MAX( PACK, CUS_PCT ) );
829 :
830 528 : pack->compressed_slot_number = (ushort)(FD_PACK_SKIP_CNT+1);
831 :
832 528 : pack->bitset_avail[ 0 ] = FD_PACK_BITSET_SLOWPATH;
833 180752 : for( ulong i=0UL; i<FD_PACK_BITSET_MAX; i++ ) pack->bitset_avail[ i+1UL ] = (ushort)i;
834 528 : pack->bitset_avail_cnt = FD_PACK_BITSET_MAX;
835 :
836 528 : bitset_map_new( _acct_bitset, lg_acct_in_trp, 0UL );
837 :
838 528 : fd_chkdup_new( pack->chkdup, rng );
839 :
840 528 : pack->bundle_meta = bundle_meta;
841 :
842 528 : return mem;
843 528 : }
844 :
845 : fd_pack_t *
846 528 : fd_pack_join( void * mem ) {
847 528 : FD_SCRATCH_ALLOC_INIT( l, mem );
848 528 : fd_pack_t * pack = FD_SCRATCH_ALLOC_APPEND( l, FD_PACK_ALIGN, sizeof(fd_pack_t) );
849 :
850 0 : int enable_bundles = !!pack->bundle_meta_sz;
851 528 : ulong pack_depth = pack->pack_depth;
852 528 : ulong extra_depth = fd_ulong_if( enable_bundles, 1UL+2UL*FD_PACK_MAX_TXN_PER_BUNDLE, 1UL );
853 528 : ulong bank_tile_cnt = pack->bank_tile_cnt;
854 528 : ulong max_txn_per_microblock = fd_ulong_max( pack->lim->max_txn_per_microblock,
855 528 : fd_ulong_if( enable_bundles, FD_PACK_MAX_TXN_PER_BUNDLE, 0UL ) );
856 :
857 528 : ulong max_acct_in_treap = pack_depth * FD_TXN_ACCT_ADDR_MAX;
858 528 : ulong max_acct_in_flight = bank_tile_cnt * (FD_TXN_ACCT_ADDR_MAX * max_txn_per_microblock + 1UL);
859 528 : ulong max_txn_in_flight = bank_tile_cnt * max_txn_per_microblock;
860 528 : ulong max_w_per_block = fd_ulong_min( pack->lim->max_cost_per_block / FD_PACK_COST_PER_WRITABLE_ACCT,
861 528 : max_txn_per_microblock * pack->lim->max_microblocks_per_block * FD_TXN_ACCT_ADDR_MAX );
862 528 : ulong written_list_max = fd_ulong_min( max_w_per_block>>1, DEFAULT_WRITTEN_LIST_MAX );
863 528 : ulong bundle_temp_accts = fd_ulong_if( enable_bundles, FD_PACK_MAX_TXN_PER_BUNDLE*FD_TXN_ACCT_ADDR_MAX, 1UL );
864 528 : ulong sig_chain_cnt = sig2txn_chain_cnt_est( pack_depth );
865 528 : ulong nonce_chain_cnt = noncemap_chain_cnt_est( pack_depth );
866 :
867 528 : int lg_uses_tbl_sz = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_acct_in_flight ) );
868 528 : int lg_max_writers = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_w_per_block ) );
869 528 : int lg_acct_in_trp = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_acct_in_treap ) );
870 528 : int lg_penalty_trp = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_acct_in_treap/PENALTY_TREAP_THRESHOLD ) );
871 528 : int lg_bundle_temp = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*bundle_temp_accts ) );
872 :
873 :
874 528 : pack->pool = trp_pool_join( FD_SCRATCH_ALLOC_APPEND( l, trp_pool_align(), trp_pool_footprint ( pack_depth+extra_depth ) ) );
875 528 : pack->penalty_treaps= penalty_map_join(FD_SCRATCH_ALLOC_APPEND( l, penalty_map_align(),penalty_map_footprint( lg_penalty_trp ) ) );
876 528 : pack->expiration_q = expq_join ( FD_SCRATCH_ALLOC_APPEND( l, expq_align(), expq_footprint ( pack_depth ) ) );
877 528 : pack->acct_in_use = acct_uses_join( FD_SCRATCH_ALLOC_APPEND( l, acct_uses_align(), acct_uses_footprint ( lg_uses_tbl_sz ) ) );
878 528 : pack->writer_costs = acct_uses_join( FD_SCRATCH_ALLOC_APPEND( l, acct_uses_align(), acct_uses_footprint ( lg_max_writers ) ) );
879 528 : /* */ FD_SCRATCH_ALLOC_APPEND( l, 32UL, sizeof(fd_pack_addr_use_t*)*written_list_max );
880 528 : pack->noncemap = noncemap_join( FD_SCRATCH_ALLOC_APPEND( l, noncemap_align(), noncemap_footprint ( nonce_chain_cnt ) ) );
881 528 : pack->signature_map = sig2txn_join( FD_SCRATCH_ALLOC_APPEND( l, sig2txn_align(), sig2txn_footprint ( sig_chain_cnt ) ) );
882 528 : pack->bundle_temp_map=acct_uses_join( FD_SCRATCH_ALLOC_APPEND( l, acct_uses_align(), acct_uses_footprint ( lg_bundle_temp ) ) );
883 528 : /* */ FD_SCRATCH_ALLOC_APPEND( l, 32UL, sizeof(fd_pack_addr_use_t)*max_acct_in_flight );
884 528 : /* */ FD_SCRATCH_ALLOC_APPEND( l, 32UL, sizeof(ulong)*max_txn_in_flight );
885 528 : pack->acct_to_bitset= bitset_map_join( FD_SCRATCH_ALLOC_APPEND( l, bitset_map_align(), bitset_map_footprint( lg_acct_in_trp ) ) );
886 528 : /* */ FD_SCRATCH_ALLOC_APPEND( l, 64UL, (pack_depth+extra_depth)*pack->bundle_meta_sz );
887 :
888 528 : FD_MGAUGE_SET( PACK, PENDING_TRANSACTIONS_HEAP_SIZE, pack->pack_depth );
889 528 : memset( pack->top_writers, 0, sizeof(pack->top_writers) );
890 :
891 528 : return pack;
892 528 : }
893 :
894 :
895 : /* Returns 0 on failure, 1 on success for a vote, 2 on success for a
896 : non-vote. */
897 : static int
898 : fd_pack_estimate_rewards_and_compute( fd_txn_e_t * txne,
899 13552377 : fd_pack_ord_txn_t * out ) {
900 13552377 : fd_txn_t * txn = TXN(txne->txnp);
901 13552377 : ulong sig_rewards = FD_PACK_FEE_PER_SIGNATURE * txn->signature_cnt; /* Easily in [5000, 635000] */
902 :
903 13552377 : ulong requested_execution_cus;
904 13552377 : ulong priority_rewards;
905 13552377 : ulong precompile_sigs;
906 13552377 : ulong requested_loaded_accounts_data_cost;
907 13552377 : ulong cost_estimate = fd_pack_compute_cost( txn, txne->txnp->payload, &txne->txnp->flags, &requested_execution_cus, &priority_rewards, &precompile_sigs, &requested_loaded_accounts_data_cost );
908 :
909 13552377 : if( FD_UNLIKELY( !cost_estimate ) ) return 0;
910 :
911 : /* precompile_sigs <= 16320, so after the addition,
912 : sig_rewards < 83,000,000 */
913 13552374 : sig_rewards += FD_PACK_FEE_PER_SIGNATURE * precompile_sigs;
914 13552374 : sig_rewards = sig_rewards * FD_PACK_TXN_FEE_BURN_PCT / 100UL;
915 :
916 : /* No fancy CU estimation in this version of pack
917 : for( ulong i=0UL; i<(ulong)txn->instr_cnt; i++ ) {
918 : uchar prog_id_idx = txn->instr[ i ].program_id;
919 : fd_acct_addr_t const * acct_addr = fd_txn_get_acct_addrs( txn, txnp->payload ) + (ulong)prog_id_idx;
920 : }
921 : */
922 13552374 : out->rewards = (priority_rewards < (UINT_MAX - sig_rewards)) ? (uint)(sig_rewards + priority_rewards) : UINT_MAX;
923 13552374 : out->compute_est = (uint)cost_estimate;
924 13552374 : out->txn->pack_cu.requested_exec_plus_acct_data_cus = (uint)(requested_execution_cus + requested_loaded_accounts_data_cost);
925 13552374 : out->txn->pack_cu.non_execution_cus = (uint)(cost_estimate - requested_execution_cus - requested_loaded_accounts_data_cost);
926 :
927 13552374 : return fd_int_if( txne->txnp->flags & FD_TXN_P_FLAGS_IS_SIMPLE_VOTE, 1, 2 );
928 13552377 : }
929 :
930 : /* Returns 0 on failure, 1 if not a durable nonce transaction, and 2 if
931 : it is. FIXME: These return codes are set to harmonize with
932 : estimate_rewards_and_compute but -1/0/1 makes a lot more sense to me.
933 : */
934 : static int
935 13552374 : fd_pack_validate_durable_nonce( fd_txn_e_t * txne ) {
936 13552374 : fd_txn_t const * txn = TXN(txne->txnp);
937 :
938 : /* First instruction invokes system program with 4 bytes of
939 : instruction data with the little-endian value 4. It also has 3
940 : accounts: the nonce account, recent blockhashes sysvar, and the
941 : nonce authority. It seems like technically the nonce authority may
942 : not need to be passed in, but we disallow that. We also allow
943 : trailing data and trailing accounts. We want to organize the
944 : checks somewhat to minimize cache misses. */
945 13552374 : if( FD_UNLIKELY( txn->instr_cnt==0 ) ) return 1;
946 1387254 : if( FD_UNLIKELY( txn->instr[ 0 ].data_sz<4UL ) ) return 1;
947 1387254 : if( FD_UNLIKELY( txn->instr[ 0 ].acct_cnt<3UL ) ) return 1; /* It seems like technically 2 is allowed, but never used */
948 8580 : if( FD_LIKELY ( fd_uint_load_4( txne->txnp->payload + txn->instr[ 0 ].data_off )!=4U ) ) return 1;
949 : /* The program has to be a static account */
950 1155 : fd_acct_addr_t const * accts = fd_txn_get_acct_addrs( txn, txne->txnp->payload );
951 1155 : if( FD_UNLIKELY( !fd_memeq( accts[ txn->instr[ 0 ].program_id ].b, null_addr.b, 32UL ) ) ) return 1;
952 1155 : if( FD_UNLIKELY( !fd_txn_is_signer( txn, txne->txnp->payload[ txn->instr[ 0 ].acct_off+2 ] ) ) ) return 0;
953 : /* We could check recent blockhash, but it's not necessary */
954 1152 : return 2;
955 1155 : }
956 :
957 : /* Can the fee payer afford to pay a transaction with the specified
958 : price? Returns 1 if so, 0 otherwise. This is just a stub that
959 : always returns 1 for now, and the real check is deferred to the bank
960 : tile. In general, this function can't be totally accurate, because
961 : the transactions immediately prior to this one can affect the balance
962 : of this fee payer, but a simple check here may be helpful for
963 : reducing spam. */
964 : static int
965 : fd_pack_can_fee_payer_afford( fd_acct_addr_t const * acct_addr,
966 13552368 : ulong price /* in lamports */) {
967 13552368 : (void)acct_addr;
968 13552368 : (void)price;
969 13552368 : return 1;
970 13552368 : }
971 :
972 :
973 :
974 :
975 :
976 13673196 : fd_txn_e_t * fd_pack_insert_txn_init( fd_pack_t * pack ) { return trp_pool_ele_acquire( pack->pool )->txn_e; }
977 122400 : void fd_pack_insert_txn_cancel( fd_pack_t * pack, fd_txn_e_t * txn ) { trp_pool_ele_release( pack->pool, (fd_pack_ord_txn_t*)txn ); }
978 :
979 24 : #define REJECT( reason ) do { \
980 24 : trp_pool_ele_release( pack->pool, ord ); \
981 24 : return FD_PACK_INSERT_REJECT_ ## reason; \
982 24 : } while( 0 )
983 :
984 : /* These require txn, accts, and alt_adj to be defined as per usual */
985 328987 : #define ACCT_IDX_TO_PTR( idx ) (__extension__( { \
986 328987 : ulong __idx = (idx); \
987 328987 : fd_ptr_if( __idx<fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM ), accts, alt_adj )+__idx; \
988 328987 : }))
989 70961049 : #define ACCT_ITER_TO_PTR( iter ) (__extension__( { \
990 70961049 : ulong __idx = fd_txn_acct_iter_idx( iter ); \
991 70961049 : fd_ptr_if( __idx<fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM ), accts, alt_adj )+__idx; \
992 70961049 : }))
993 :
994 :
995 : /* Tries to find the worst transaction in any treap in pack. If that
996 : transaction's score is worse than or equal to threshold_score, it
997 : initiates a delete and returns the number of deleted transactions
998 : (potentially more than 1 for a bundle). If it's higher than
999 : threshold_score, it returns 0. To force this function to delete the
1000 : worst transaction if there are any eligible ones, pass FLT_MAX as
1001 : threshold_score. */
1002 : static inline ulong
1003 : delete_worst( fd_pack_t * pack,
1004 : float threshold_score,
1005 494601 : int is_vote ) {
1006 : /* If the tree is full, we want to see if this is better than the
1007 : worst element in the pool before inserting. If the new transaction
1008 : is better than that one, we'll delete it and insert the new
1009 : transaction. Otherwise, we'll throw away this transaction.
1010 :
1011 : We want to bias the definition of "worst" here to provide better
1012 : quality of service. For example, if the pool is filled with
1013 : transactions that all write to the same account or are all votes,
1014 : we want to bias towards treating one of those transactions as the
1015 : worst, even if they pay slightly higher fees per computer unit,
1016 : since we know we won't actually be able to schedule them all.
1017 :
1018 : This is a tricky task, however. All our notions of priority and
1019 : better/worse are based on static information about the transaction,
1020 : and there's not an easy way to take into account global
1021 : information, for example, how many other transactions contend with
1022 : this one. One idea is to build a heap (not a treap, since we only
1023 : need pop-min, insert, and delete) with one element for each element
1024 : in the pool, with a "delete me" score that's related but not
1025 : identical to the normal score. This would allow building in some
1026 : global information. The downside is that the global information
1027 : that gets integrated is static. E.g. if you bias a transaction's
1028 : "delete me" score to make it more likely to be deleted because
1029 : there are many conflicting transactions in the pool, the score
1030 : stays biased, even if the global conditions change (unless you come
1031 : up with some complicated re-scoring scheme). This can work, since
1032 : when the pool is full, the global bias factors are unlikely to
1033 : change significantly at the relevant timescales.
1034 :
1035 : However, rather than this, we implement a simpler probabilistic
1036 : scheme. We'll sample M transactions, find the worst transaction in
1037 : each of the M treaps, compute a "delete me" score for those <= M
1038 : transactions, and delete the worst. If one penalty treap is
1039 : starting to get big, then it becomes very likely that the random
1040 : sample will find it and choose to delete a transaction from it.
1041 :
1042 : The exact formula for the "delete me" score should be the matter of
1043 : some more intense quantitative research. For now, we'll just use
1044 : this:
1045 :
1046 : Treap with N transactions Scale Factor
1047 : Pending 1.0 unless inserting a vote and votes < 25%
1048 : Pending votes 1.0 until 75% of depth, then 0
1049 : Penalty treap 1.0 at <= 100 transactions, then sqrt(100/N)
1050 : Pending bundles inf (since the rewards value is fudged)
1051 :
1052 : We'll also use M=8. */
1053 :
1054 494601 : float worst_score = FLT_MAX;
1055 494601 : fd_pack_ord_txn_t * worst = NULL;
1056 4451409 : for( ulong i=0UL; i<8UL; i++ ) {
1057 3956808 : uint pool_max = (uint)trp_pool_max( pack->pool );
1058 3956808 : ulong sample_i = fd_rng_uint_roll( pack->rng, pool_max );
1059 :
1060 3956808 : fd_pack_ord_txn_t * sample = &pack->pool[ sample_i ];
1061 : /* Presumably if we're calling this, the pool is almost entirely
1062 : full, so the probability of choosing a free one is small. If
1063 : it does happen, find the first one that isn't free. */
1064 3959093 : while( FD_UNLIKELY( sample->root==FD_ORD_TXN_ROOT_FREE ) ) sample = &pack->pool[ (++sample_i)%pool_max ];
1065 :
1066 3956808 : int root_idx = sample->root;
1067 3956808 : float multiplier = 0.0f; /* The smaller this is, the more biased we'll be to deleting it */
1068 3956808 : treap_t * treap;
1069 3956808 : switch( root_idx & FD_ORD_TXN_ROOT_TAG_MASK ) {
1070 0 : default:
1071 0 : case FD_ORD_TXN_ROOT_FREE: {
1072 0 : FD_LOG_CRIT(( "Double free detected" ));
1073 0 : return ULONG_MAX; /* Can't be hit */
1074 0 : }
1075 3935441 : case FD_ORD_TXN_ROOT_PENDING: {
1076 3935441 : treap = pack->pending;
1077 3935441 : ulong vote_cnt = treap_ele_cnt( pack->pending_votes );
1078 3935441 : if( FD_LIKELY( !is_vote || (vote_cnt>=pack->pack_depth/4UL ) ) ) multiplier = 1.0f;
1079 3935441 : break;
1080 0 : }
1081 0 : case FD_ORD_TXN_ROOT_PENDING_VOTE: {
1082 0 : treap = pack->pending_votes;
1083 0 : ulong vote_cnt = treap_ele_cnt( pack->pending_votes );
1084 0 : if( FD_LIKELY( is_vote || (vote_cnt<=3UL*pack->pack_depth/4UL ) ) ) multiplier = 1.0f;
1085 0 : break;
1086 0 : }
1087 0 : case FD_ORD_TXN_ROOT_PENDING_BUNDLE: {
1088 : /* We don't have a way to tell how much these actually pay in
1089 : rewards, so we just assume they are very high. */
1090 0 : treap = pack->pending_bundles;
1091 : /* We cap rewards at UINT_MAX lamports for estimation, and min
1092 : CUs is about 1000, which means rewards/compute < 5e6.
1093 : FLT_MAX is around 3e38. That means, 1e20*rewards/compute is
1094 : much less than FLT_MAX, so we won't have any issues with
1095 : overflow. On the other hand, if rewards==1 lamport and
1096 : compute is 2 million CUs, 1e20*1/2e6 is still higher than any
1097 : normal transaction. */
1098 0 : multiplier = 1e20f;
1099 0 : break;
1100 0 : }
1101 21367 : case FD_ORD_TXN_ROOT_PENALTY( 0 ): {
1102 21367 : fd_txn_t * txn = TXN( sample->txn );
1103 21367 : fd_acct_addr_t const * accts = fd_txn_get_acct_addrs( txn, sample->txn->payload );
1104 21367 : fd_acct_addr_t const * alt_adj = sample->txn_e->alt_accts - fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM );
1105 21367 : fd_acct_addr_t penalty_acct = *ACCT_IDX_TO_PTR( FD_ORD_TXN_ROOT_PENALTY_ACCT_IDX( root_idx ) );
1106 21367 : fd_pack_penalty_treap_t * q = penalty_map_query( pack->penalty_treaps, penalty_acct, NULL );
1107 21367 : FD_TEST( q );
1108 21367 : ulong cnt = treap_ele_cnt( q->penalty_treap );
1109 21367 : treap = q->penalty_treap;
1110 :
1111 21367 : multiplier = sqrtf( 100.0f / (float)fd_ulong_max( 100UL, cnt ) );
1112 21367 : break;
1113 21367 : }
1114 3956808 : }
1115 : /* Get the worst from the sampled treap */
1116 3956808 : treap_fwd_iter_t _cur=treap_fwd_iter_init( treap, pack->pool );
1117 3956808 : FD_TEST( !treap_fwd_iter_done( _cur ) ); /* It can't be empty because we just sampled an element from it. */
1118 3956808 : sample = treap_fwd_iter_ele( _cur, pack->pool );
1119 :
1120 3956808 : float score = multiplier * (float)sample->rewards / (float)sample->compute_est;
1121 3956808 : worst = fd_ptr_if( score<worst_score, sample, worst );
1122 3956808 : worst_score = fd_float_if( worst_score<score, worst_score, score );
1123 3956808 : }
1124 :
1125 494601 : if( FD_UNLIKELY( !worst ) ) return 0;
1126 494601 : if( FD_UNLIKELY( threshold_score<worst_score ) ) return 0;
1127 :
1128 494601 : return delete_transaction( pack, worst, 1, 1 );
1129 494601 : }
1130 :
1131 : static inline int
1132 : validate_transaction( fd_pack_t * pack,
1133 : fd_pack_ord_txn_t const * ord,
1134 : fd_txn_t const * txn,
1135 : fd_acct_addr_t const * accts,
1136 : fd_acct_addr_t const * alt_adj,
1137 13552368 : int check_bundle_blacklist ) {
1138 13552368 : int writes_to_sysvar = 0;
1139 13552368 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_WRITABLE );
1140 28259184 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
1141 14706816 : writes_to_sysvar |= fd_pack_unwritable_contains( ACCT_ITER_TO_PTR( iter ) );
1142 14706816 : }
1143 :
1144 13552368 : int bundle_blacklist = 0;
1145 13552368 : if( FD_UNLIKELY( check_bundle_blacklist ) ) {
1146 37038 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_ALL );
1147 263103 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
1148 226065 : bundle_blacklist |= (3==fd_pack_tip_prog_check_blacklist( ACCT_ITER_TO_PTR( iter ) ));
1149 226065 : }
1150 37038 : }
1151 :
1152 13552368 : fd_acct_addr_t const * alt = ord->txn_e->alt_accts;
1153 13552368 : fd_chkdup_t * chkdup = pack->chkdup;
1154 13552368 : ulong imm_cnt = fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM );
1155 13552368 : ulong alt_cnt = fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_ALT );
1156 :
1157 : /* Throw out transactions ... */
1158 : /* ... that are unfunded */
1159 13552368 : if( FD_UNLIKELY( !fd_pack_can_fee_payer_afford( accts, ord->rewards ) ) ) return FD_PACK_INSERT_REJECT_UNAFFORDABLE;
1160 : /* ... that are so big they'll never run */
1161 13552368 : if( FD_UNLIKELY( ord->compute_est >= pack->lim->max_cost_per_block ) ) return FD_PACK_INSERT_REJECT_TOO_LARGE;
1162 : /* ... that load too many accounts (ignoring 9LZdXeKGeBV6hRLdxS1rHbHoEUsKqesCC2ZAPTPKJAbK) */
1163 13552368 : if( FD_UNLIKELY( fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_ALL )>64UL ) ) return FD_PACK_INSERT_REJECT_ACCOUNT_CNT;
1164 : /* ... that duplicate an account address */
1165 13552365 : if( FD_UNLIKELY( fd_chkdup_check( chkdup, accts, imm_cnt, alt, alt_cnt ) ) ) return FD_PACK_INSERT_REJECT_DUPLICATE_ACCT;
1166 : /* ... that try to write to a sysvar */
1167 13552362 : if( FD_UNLIKELY( writes_to_sysvar ) ) return FD_PACK_INSERT_REJECT_WRITES_SYSVAR;
1168 : /* ... that use an account that violates bundle rules */
1169 13552269 : if( FD_UNLIKELY( bundle_blacklist & 1 ) ) return FD_PACK_INSERT_REJECT_BUNDLE_BLACKLIST;
1170 :
1171 13552269 : return 0;
1172 13552269 : }
1173 :
1174 :
1175 :
1176 : /* returns cumulative penalty "points", i.e. the sum of the populated
1177 : section of penalties (which also tells the caller how much of the
1178 : array is populated. */
1179 : static inline ulong
1180 : populate_bitsets( fd_pack_t * pack,
1181 : fd_pack_ord_txn_t * ord,
1182 : ushort penalties [ static FD_TXN_ACCT_ADDR_MAX ],
1183 13551219 : uchar penalty_idx[ static FD_TXN_ACCT_ADDR_MAX ] ) {
1184 13551219 : FD_PACK_BITSET_CLEAR( ord->rw_bitset );
1185 13551219 : FD_PACK_BITSET_CLEAR( ord->w_bitset );
1186 :
1187 13551219 : fd_txn_t * txn = TXN(ord->txn);
1188 13551219 : uchar * payload = ord->txn->payload;
1189 :
1190 13551219 : fd_acct_addr_t const * accts = fd_txn_get_acct_addrs( txn, payload );
1191 : /* alt_adj is the pointer to the ALT expansion, adjusted so that if
1192 : account address n is the first that comes from the ALT, it can be
1193 : accessed with adj_lut[n]. */
1194 13551219 : fd_acct_addr_t const * alt_adj = ord->txn_e->alt_accts - fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM );
1195 :
1196 13551219 : ulong cumulative_penalty = 0UL;
1197 13551219 : ulong penalty_i = 0UL;
1198 :
1199 13551219 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_WRITABLE );
1200 28253385 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
1201 14702166 : fd_acct_addr_t acct = *ACCT_ITER_TO_PTR( iter );
1202 14702166 : fd_pack_bitset_acct_mapping_t * q = bitset_map_query( pack->acct_to_bitset, acct, NULL );
1203 14702166 : if( FD_UNLIKELY( q==NULL ) ) {
1204 13215473 : q = bitset_map_insert( pack->acct_to_bitset, acct );
1205 13215473 : q->ref_cnt = 0UL;
1206 13215473 : q->first_instance = ord;
1207 13215473 : q->first_instance_was_write = 1;
1208 13215473 : q->bit = FD_PACK_BITSET_FIRST_INSTANCE;
1209 13215473 : } else if( FD_UNLIKELY( q->bit == FD_PACK_BITSET_FIRST_INSTANCE ) ) {
1210 7321 : q->bit = pack->bitset_avail[ pack->bitset_avail_cnt ];
1211 7321 : pack->bitset_avail_cnt = fd_ulong_if( !!pack->bitset_avail_cnt, pack->bitset_avail_cnt-1UL, 0UL );
1212 :
1213 7321 : FD_PACK_BITSET_SETN( q->first_instance->rw_bitset, q->bit );
1214 7321 : if( q->first_instance_was_write ) FD_PACK_BITSET_SETN( q->first_instance->w_bitset, q->bit );
1215 7321 : }
1216 14702166 : ulong penalty = fd_ulong_max( q->ref_cnt, PENALTY_TREAP_THRESHOLD )-PENALTY_TREAP_THRESHOLD;
1217 14702166 : if( FD_UNLIKELY( penalty ) ) {
1218 1212867 : penalties [ penalty_i ] = (ushort)penalty;
1219 1212867 : penalty_idx[ penalty_i ] = (uchar )fd_txn_acct_iter_idx( iter );
1220 1212867 : penalty_i++;
1221 1212867 : cumulative_penalty += penalty;
1222 1212867 : }
1223 :
1224 14702166 : q->ref_cnt++;
1225 14702166 : FD_PACK_BITSET_SETN( ord->rw_bitset, q->bit );
1226 14702166 : FD_PACK_BITSET_SETN( ord->w_bitset , q->bit );
1227 14702166 : }
1228 :
1229 13551219 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_READONLY );
1230 18034371 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
1231 :
1232 4483152 : fd_acct_addr_t acct = *ACCT_ITER_TO_PTR( iter );
1233 4483152 : if( FD_UNLIKELY( fd_pack_unwritable_contains( &acct ) ) ) continue;
1234 :
1235 3081981 : fd_pack_bitset_acct_mapping_t * q = bitset_map_query( pack->acct_to_bitset, acct, NULL );
1236 3081981 : if( FD_UNLIKELY( q==NULL ) ) {
1237 29739 : q = bitset_map_insert( pack->acct_to_bitset, acct );
1238 29739 : q->ref_cnt = 0UL;
1239 29739 : q->first_instance = ord;
1240 29739 : q->first_instance_was_write = 0;
1241 29739 : q->bit = FD_PACK_BITSET_FIRST_INSTANCE;
1242 3052242 : } else if( FD_UNLIKELY( q->bit == FD_PACK_BITSET_FIRST_INSTANCE ) ) {
1243 11031 : q->bit = pack->bitset_avail[ pack->bitset_avail_cnt ];
1244 11031 : pack->bitset_avail_cnt = fd_ulong_if( !!pack->bitset_avail_cnt, pack->bitset_avail_cnt-1UL, 0UL );
1245 :
1246 11031 : FD_PACK_BITSET_SETN( q->first_instance->rw_bitset, q->bit );
1247 11031 : if( q->first_instance_was_write ) FD_PACK_BITSET_SETN( q->first_instance->w_bitset, q->bit );
1248 11031 : }
1249 :
1250 3081981 : q->ref_cnt++;
1251 3081981 : FD_PACK_BITSET_SETN( ord->rw_bitset, q->bit );
1252 3081981 : }
1253 13551219 : return cumulative_penalty;
1254 13551219 : }
1255 :
1256 : int
1257 : fd_pack_insert_txn_fini( fd_pack_t * pack,
1258 : fd_txn_e_t * txne,
1259 : ulong expires_at,
1260 13550796 : ulong * delete_cnt ) {
1261 13550796 : *delete_cnt = 0UL;
1262 :
1263 13550796 : fd_pack_ord_txn_t * ord = (fd_pack_ord_txn_t *)txne;
1264 :
1265 13550796 : fd_txn_t * txn = TXN(txne->txnp);
1266 13550796 : uchar * payload = txne->txnp->payload;
1267 :
1268 13550796 : fd_acct_addr_t const * accts = fd_txn_get_acct_addrs( txn, payload );
1269 : /* alt_adj is the pointer to the ALT expansion, adjusted so that if
1270 : account address n is the first that comes from the ALT, it can be
1271 : accessed with adj_lut[n]. */
1272 13550796 : fd_acct_addr_t const * alt_adj = ord->txn_e->alt_accts - fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM );
1273 :
1274 13550796 : ord->expires_at = expires_at;
1275 :
1276 13550796 : int est_result = fd_pack_estimate_rewards_and_compute( txne, ord );
1277 13550796 : if( FD_UNLIKELY( !est_result ) ) REJECT( ESTIMATION_FAIL );
1278 13550793 : int is_vote = est_result==1;
1279 :
1280 13550793 : int nonce_result = fd_pack_validate_durable_nonce( txne );
1281 13550793 : if( FD_UNLIKELY( !nonce_result ) ) REJECT( INVALID_NONCE );
1282 13550790 : int is_durable_nonce = nonce_result==2;
1283 13550790 : ord->txn->flags &= ~FD_TXN_P_FLAGS_DURABLE_NONCE;
1284 13550790 : ord->txn->flags |= fd_uint_if( is_durable_nonce, FD_TXN_P_FLAGS_DURABLE_NONCE, 0U );
1285 :
1286 13550790 : int validation_result = validate_transaction( pack, ord, txn, accts, alt_adj, !!pack->bundle_meta_sz );
1287 13550790 : if( FD_UNLIKELY( validation_result ) ) {
1288 99 : trp_pool_ele_release( pack->pool, ord );
1289 99 : return validation_result;
1290 99 : }
1291 :
1292 : /* Reject any transactions that have already expired */
1293 13550691 : if( FD_UNLIKELY( expires_at<pack->expire_before ) ) REJECT( EXPIRED );
1294 :
1295 13550679 : int replaces = 0;
1296 : /* If it's a durable nonce and we already have one, delete one or the
1297 : other. */
1298 13550679 : if( FD_UNLIKELY( is_durable_nonce ) ) {
1299 120 : fd_pack_ord_txn_t * same_nonce = noncemap_ele_query( pack->noncemap, txne, NULL, pack->pool );
1300 120 : if( FD_LIKELY( same_nonce ) ) { /* Seems like most nonce transactions are effectively duplicates */
1301 9 : if( FD_LIKELY( same_nonce->root == FD_ORD_TXN_ROOT_PENDING_BUNDLE || COMPARE_WORSE( ord, same_nonce ) ) ) REJECT( NONCE_PRIORITY );
1302 3 : ulong _delete_cnt = delete_transaction( pack, same_nonce, 0, 0 ); /* Not a bundle, so delete_full_bundle is 0 */
1303 3 : *delete_cnt += _delete_cnt;
1304 3 : replaces = 1;
1305 3 : }
1306 120 : }
1307 :
1308 13550673 : if( FD_UNLIKELY( pack->pending_txn_cnt == pack->pack_depth ) ) {
1309 494592 : float threshold_score = (float)ord->rewards/(float)ord->compute_est;
1310 494592 : ulong _delete_cnt = delete_worst( pack, threshold_score, is_vote );
1311 494592 : *delete_cnt += _delete_cnt;
1312 494592 : if( FD_UNLIKELY( !_delete_cnt ) ) REJECT( PRIORITY );
1313 494592 : replaces = 1;
1314 494592 : }
1315 :
1316 13550673 : ord->txn->flags &= ~(FD_TXN_P_FLAGS_BUNDLE | FD_TXN_P_FLAGS_INITIALIZER_BUNDLE);
1317 13550673 : ord->skip = FD_PACK_SKIP_CNT;
1318 :
1319 : /* At this point, we know we have space to insert the transaction and
1320 : we've committed to insert it. */
1321 :
1322 : /* Since the pool uses ushorts, the size of the pool is < USHORT_MAX.
1323 : Each transaction can reference an account at most once, which means
1324 : that the total number of references for an account is < USHORT_MAX.
1325 : If these were ulongs, the array would be 512B, which is kind of a
1326 : lot to zero out.*/
1327 13550673 : ushort penalties[ FD_TXN_ACCT_ADDR_MAX ] = {0};
1328 13550673 : uchar penalty_idx[ FD_TXN_ACCT_ADDR_MAX ];
1329 13550673 : ulong cumulative_penalty = populate_bitsets( pack, ord, penalties, penalty_idx );
1330 :
1331 13550673 : treap_t * insert_into = pack->pending;
1332 :
1333 13550673 : if( FD_UNLIKELY( cumulative_penalty && !is_vote ) ) { /* Optimize for high parallelism case */
1334 : /* Compute a weighted random choice */
1335 304959 : ulong roll = (ulong)fd_rng_uint_roll( pack->rng, (uint)cumulative_penalty ); /* cumulative_penalty < USHORT_MAX*64 < UINT_MAX */
1336 304959 : ulong i = 0UL;
1337 : /* Find the right one. This can be done in O(log N), but I imagine
1338 : N is normally so small that doesn't matter. */
1339 758568 : while( roll>=penalties[i] ) roll -= (ulong)penalties[i++];
1340 :
1341 304959 : fd_acct_addr_t penalty_acct = *ACCT_IDX_TO_PTR( penalty_idx[i] );
1342 304959 : fd_pack_penalty_treap_t * q = penalty_map_query( pack->penalty_treaps, penalty_acct, NULL );
1343 304959 : if( FD_UNLIKELY( q==NULL ) ) {
1344 2901 : q = penalty_map_insert( pack->penalty_treaps, penalty_acct );
1345 2901 : treap_new( q->penalty_treap, pack->pack_depth );
1346 2901 : }
1347 304959 : insert_into = q->penalty_treap;
1348 304959 : ord->root = FD_ORD_TXN_ROOT_PENALTY( penalty_idx[i] );
1349 13245714 : } else {
1350 13245714 : ord->root = fd_int_if( is_vote, FD_ORD_TXN_ROOT_PENDING_VOTE, FD_ORD_TXN_ROOT_PENDING );
1351 :
1352 13245714 : fd_pack_smallest_t * smallest = fd_ptr_if( is_vote, &pack->pending_votes_smallest[0], pack->pending_smallest );
1353 13245714 : smallest->cus = fd_ulong_min( smallest->cus, ord->compute_est );
1354 13245714 : smallest->bytes = fd_ulong_min( smallest->bytes, txne->txnp->payload_sz );
1355 13245714 : }
1356 :
1357 13550673 : pack->pending_txn_cnt++;
1358 :
1359 13550673 : sig2txn_ele_insert( pack->signature_map, ord, pack->pool );
1360 :
1361 13550673 : if( FD_UNLIKELY( is_durable_nonce ) ) noncemap_ele_insert( pack->noncemap, ord, pack->pool );
1362 :
1363 13550673 : fd_pack_expq_t temp[ 1 ] = {{ .expires_at = expires_at, .txn = ord }};
1364 13550673 : expq_insert( pack->expiration_q, temp );
1365 :
1366 13550673 : if( FD_LIKELY( is_vote ) ) insert_into = pack->pending_votes;
1367 :
1368 13550673 : treap_ele_insert( insert_into, ord, pack->pool );
1369 13550673 : return (is_vote) | (replaces<<1) | (is_durable_nonce<<2);
1370 13550673 : }
1371 : #undef REJECT
1372 :
1373 : fd_txn_e_t * const *
1374 : fd_pack_insert_bundle_init( fd_pack_t * pack,
1375 : fd_txn_e_t * * bundle,
1376 378 : ulong txn_cnt ) {
1377 378 : FD_TEST( txn_cnt<=FD_PACK_MAX_TXN_PER_BUNDLE );
1378 378 : FD_TEST( trp_pool_free( pack->pool )>=txn_cnt );
1379 1962 : for( ulong i=0UL; i<txn_cnt; i++ ) bundle[ i ] = trp_pool_ele_acquire( pack->pool )->txn_e;
1380 378 : return bundle;
1381 378 : }
1382 :
1383 : void
1384 : fd_pack_insert_bundle_cancel( fd_pack_t * pack,
1385 : fd_txn_e_t * const * bundle,
1386 246 : ulong txn_cnt ) {
1387 : /* There's no real reason these have to be released in reverse, but it
1388 : seems fitting to release them in the opposite order they were
1389 : acquired. */
1390 1284 : for( ulong i=0UL; i<txn_cnt; i++ ) trp_pool_ele_release( pack->pool, (fd_pack_ord_txn_t*)bundle[ txn_cnt-1UL-i ] );
1391 246 : }
1392 :
1393 : /* Explained below */
1394 : #define BUNDLE_L_PRIME 37896771UL
1395 : #define BUNDLE_N 312671UL
1396 147 : #define RC_TO_REL_BUNDLE_IDX( r, c ) (BUNDLE_N - ((ulong)(r) * 1UL<<32)/((ulong)(c) * BUNDLE_L_PRIME))
1397 :
1398 : int
1399 : fd_pack_insert_bundle_fini( fd_pack_t * pack,
1400 : fd_txn_e_t * const * bundle,
1401 : ulong txn_cnt,
1402 : ulong expires_at,
1403 : int initializer_bundle,
1404 : void const * bundle_meta,
1405 378 : ulong * delete_cnt ) {
1406 :
1407 378 : int err = 0;
1408 378 : *delete_cnt = 0UL;
1409 :
1410 378 : ulong pending_b_txn_cnt = treap_ele_cnt( pack->pending_bundles );
1411 : /* We want to prevent bundles from consuming the whole treap, but in
1412 : general, we assume bundles are lucrative. We'll set the policy
1413 : on capping bundles at half of the pack depth. We assume that the
1414 : bundles are coming in a pre-prioritized order, so it doesn't make
1415 : sense to drop an earlier bundle for this one. That means that
1416 : really, the best thing to do is drop this one. */
1417 378 : if( FD_UNLIKELY( (!initializer_bundle)&(pending_b_txn_cnt+txn_cnt>pack->pack_depth/2UL) ) ) err = FD_PACK_INSERT_REJECT_PRIORITY;
1418 :
1419 378 : if( FD_UNLIKELY( expires_at<pack->expire_before ) ) err = FD_PACK_INSERT_REJECT_EXPIRED;
1420 :
1421 :
1422 378 : int replaces = 0;
1423 378 : ulong nonce_txn_cnt = 0UL;
1424 :
1425 : /* Collect nonce hashes to detect duplicate nonces.
1426 : Use a constant-time duplicate-detection algorithm -- Vacant entries
1427 : have the MSB set, occupied entries are the noncemap hash, with the
1428 : MSB set to 0. */
1429 378 : ulong nonce_hash63[ FD_PACK_MAX_TXN_PER_BUNDLE ];
1430 2268 : for( ulong i=0UL; i<FD_PACK_MAX_TXN_PER_BUNDLE; i++ ) {
1431 1890 : nonce_hash63[ i ] = ULONG_MAX-i;
1432 1890 : }
1433 :
1434 1956 : for( ulong i=0UL; (i<txn_cnt) && !err; i++ ) {
1435 1581 : fd_pack_ord_txn_t * ord = (fd_pack_ord_txn_t *)bundle[ i ];
1436 :
1437 1581 : fd_txn_t const * txn = TXN(bundle[ i ]->txnp);
1438 1581 : uchar const * payload = bundle[ i ]->txnp->payload;
1439 :
1440 1581 : fd_acct_addr_t const * accts = fd_txn_get_acct_addrs( txn, payload );
1441 1581 : fd_acct_addr_t const * alt_adj = ord->txn_e->alt_accts - fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM );
1442 :
1443 1581 : int est_result = fd_pack_estimate_rewards_and_compute( bundle[ i ], ord );
1444 1581 : if( FD_UNLIKELY( !est_result ) ) { err = FD_PACK_INSERT_REJECT_ESTIMATION_FAIL; break; }
1445 1581 : int nonce_result = fd_pack_validate_durable_nonce( ord->txn_e );
1446 1581 : if( FD_UNLIKELY( !nonce_result ) ) { err = FD_PACK_INSERT_REJECT_INVALID_NONCE; break; }
1447 1581 : int is_durable_nonce = nonce_result==2;
1448 1581 : nonce_txn_cnt += !!is_durable_nonce;
1449 :
1450 1581 : bundle[ i ]->txnp->flags |= FD_TXN_P_FLAGS_BUNDLE;
1451 1581 : bundle[ i ]->txnp->flags &= ~(FD_TXN_P_FLAGS_INITIALIZER_BUNDLE | FD_TXN_P_FLAGS_DURABLE_NONCE);
1452 1581 : bundle[ i ]->txnp->flags |= fd_uint_if( initializer_bundle, FD_TXN_P_FLAGS_INITIALIZER_BUNDLE, 0U );
1453 1581 : bundle[ i ]->txnp->flags |= fd_uint_if( is_durable_nonce, FD_TXN_P_FLAGS_DURABLE_NONCE, 0U );
1454 1581 : ord->skip = FD_PACK_SKIP_CNT;
1455 1581 : ord->expires_at = expires_at;
1456 :
1457 1581 : if( FD_UNLIKELY( is_durable_nonce ) ) {
1458 1032 : nonce_hash63[ i ] = noncemap_key_hash( ord->txn_e, pack->noncemap->seed ) & 0x7FFFFFFFFFFFFFFFUL;
1459 1032 : fd_pack_ord_txn_t * same_nonce = noncemap_ele_query( pack->noncemap, ord->txn_e, NULL, pack->pool );
1460 1032 : if( FD_LIKELY( same_nonce ) ) {
1461 : /* bundles take priority over non-bundles, and earlier bundles
1462 : take priority over later bundles. */
1463 6 : if( FD_UNLIKELY( same_nonce->txn->flags & FD_TXN_P_FLAGS_BUNDLE ) ) {
1464 3 : err = FD_PACK_INSERT_REJECT_NONCE_PRIORITY;
1465 3 : break;
1466 3 : } else {
1467 3 : ulong _delete_cnt = delete_transaction( pack, same_nonce, 0, 0 );
1468 3 : *delete_cnt += _delete_cnt;
1469 3 : replaces = 1;
1470 3 : }
1471 6 : }
1472 1032 : }
1473 :
1474 1578 : int validation_result = validate_transaction( pack, ord, txn, accts, alt_adj, !initializer_bundle );
1475 1578 : if( FD_UNLIKELY( validation_result ) ) { err = validation_result; break; }
1476 1578 : }
1477 :
1478 378 : if( FD_UNLIKELY( err ) ) {
1479 3 : fd_pack_insert_bundle_cancel( pack, bundle, txn_cnt );
1480 3 : return err;
1481 3 : }
1482 :
1483 375 : if( FD_UNLIKELY( initializer_bundle && pending_b_txn_cnt>0UL ) ) {
1484 0 : treap_rev_iter_t _cur=treap_rev_iter_init( pack->pending_bundles, pack->pool );
1485 0 : FD_TEST( !treap_rev_iter_done( _cur ) );
1486 0 : fd_pack_ord_txn_t * cur = treap_rev_iter_ele( _cur, pack->pool );
1487 0 : int is_ib = !!(cur->txn->flags & FD_TXN_P_FLAGS_INITIALIZER_BUNDLE);
1488 :
1489 : /* Delete the previous IB if there is one */
1490 0 : if( FD_UNLIKELY( is_ib && 0UL==RC_TO_REL_BUNDLE_IDX( cur->rewards, cur->compute_est ) ) ) {
1491 0 : ulong _delete_cnt = delete_transaction( pack, cur, 1, 0 );
1492 0 : *delete_cnt += _delete_cnt;
1493 0 : }
1494 0 : }
1495 :
1496 384 : while( FD_UNLIKELY( pack->pending_txn_cnt+txn_cnt > pack->pack_depth ) ) {
1497 9 : ulong _delete_cnt = delete_worst( pack, FLT_MAX, 0 );
1498 9 : *delete_cnt += _delete_cnt;
1499 9 : if( FD_UNLIKELY( !_delete_cnt ) ) {
1500 0 : fd_pack_insert_bundle_cancel( pack, bundle, txn_cnt );
1501 0 : return FD_PACK_INSERT_REJECT_PRIORITY;
1502 0 : }
1503 9 : replaces = 1;
1504 9 : }
1505 :
1506 375 : if( FD_UNLIKELY( !pending_b_txn_cnt ) ) {
1507 375 : pack->relative_bundle_idx = 1UL;
1508 375 : }
1509 :
1510 375 : if( FD_LIKELY( bundle_meta ) ) {
1511 0 : memcpy( (uchar *)pack->bundle_meta + (ulong)((fd_pack_ord_txn_t *)bundle[0]-pack->pool)*pack->bundle_meta_sz, bundle_meta, pack->bundle_meta_sz );
1512 0 : }
1513 :
1514 375 : if( FD_UNLIKELY( nonce_txn_cnt>1UL ) ) {
1515 : /* Do a ILP-friendly duplicate detect, naive O(n^2) algo. With max
1516 : 5 txns per bundle, this requires 10 comparisons. ~ 25 cycle. */
1517 375 : uint conflict_detected = 0u;
1518 1875 : for( ulong i=0UL; i<FD_PACK_MAX_TXN_PER_BUNDLE-1; i++ ) {
1519 5250 : for( ulong j=i+1; j<FD_PACK_MAX_TXN_PER_BUNDLE; j++ ) {
1520 3750 : ulong const ele_i = nonce_hash63[ i ];
1521 3750 : ulong const ele_j = nonce_hash63[ j ];
1522 3750 : conflict_detected |= (ele_i==ele_j);
1523 3750 : }
1524 1500 : }
1525 375 : if( FD_UNLIKELY( conflict_detected ) ) {
1526 243 : fd_pack_insert_bundle_cancel( pack, bundle, txn_cnt );
1527 243 : return FD_PACK_INSERT_REJECT_NONCE_CONFLICT;
1528 243 : }
1529 375 : }
1530 :
1531 : /* We put bundles in a treap just like all the other transactions, but
1532 : we actually want to sort them in a very specific order; the order
1533 : within the bundle is determined at bundle creation time, and the
1534 : order among the bundles is FIFO. However, it's going to be a pain
1535 : to use a different sorting function for this treap, since it's
1536 : fixed as part of the treap creation for performance. Don't fear
1537 : though; we can pull a cool math trick out of the bag to shoehorn
1538 : the order we'd like into the sort function we need, and to get even
1539 : more.
1540 :
1541 : Recall that the sort function is r_i/c_i, smallest to largest,
1542 : where r_i is the rewards and c_i is the cost units. r_i and c_i
1543 : are both uints, and the comparison is done by cross-multiplication
1544 : as ulongs. We actually use the c_i value for testing if
1545 : transactions fit, etc. so let's assume that's fixed, and we know
1546 : it's in the range [1020, 1,556,782].
1547 :
1548 : This means, if c_0, c_1, ... c_4 are the CU costs of the
1549 : transactions in the first bundle, we require r_0/c_0 > r_1/c_1 >
1550 : ... > r_4/c_4. Then, if c_5, ... c_9 are the CU costs of the
1551 : transactions in the second bundle, we also require that r_4/c_4 >
1552 : r_5/c_5. For convenience, we'll impose a slightly stronger
1553 : constraint: we want the kth bundle to obey L*(N-k) <= r_i/c_i <
1554 : L*(N+1-k), for fixed constants L and N, real and integer,
1555 : respectively, that we'll determine. For example, this means r_4/c_4
1556 : >= L*N > r_5/c_5. This enables us to group the transactions in the
1557 : same bundle more easily.
1558 :
1559 : For convenience in the math below, we'll set j=N-k and relabel the
1560 : transactions from the jth bundle c_0, ... c_4.
1561 : From above, we know that Lj <= r_4/c_4. We'd like to make it as
1562 : close as possible given that r_4 is an integers. Thus, put
1563 : r_4 = ceil( c_4 * Lj ). r_4 is clearly an integer, and it satisfies
1564 : the required inequality because:
1565 : r_4/c_4 = ceil( c_4 * Lj)/c_4 >= c_4*Lj / c_4 >= Lj.
1566 :
1567 : Following in the same spirit, put r_3 = ceil( c_3 * (r_4+1)/c_4 ).
1568 : Again, r_3 is clearly an integer, and
1569 : r_3/c_3 = ceil(c_3*(r_4+1)/c_4)/c_3
1570 : >= (c_3*(r_4+1))/(c_3 * c_4)
1571 : >= r_4/c_4 + 1/c_4
1572 : > r_4/c_4.
1573 : Following the pattern, we put
1574 : r_2 = ceil( c_2 * (r_3+1)/c_3 )
1575 : r_1 = ceil( c_1 * (r_2+1)/c_2 )
1576 : r_0 = ceil( c_0 * (r_1+1)/c_1 )
1577 : which work for the same reason that as r_3.
1578 :
1579 : We now need for r_0 to satisfy the final inequality with L, and
1580 : we'll use this to guide our choice of L. Theoretically, r_0 can be
1581 : expressed in terms of L, j, and c_0, ... c_4, but that's a truly
1582 : inscrutible expression. Instead, we need some bounds so we can get
1583 : rid of all the ceil using the property that x <= ceil(x) < x+1.
1584 : c_4 * Lj <= r_4 < c_4 * Lj + 1
1585 : The lower bound on r_3 is easy:
1586 : r_3 >= c_3 * (c_4 * Lj + 1)/c_4 = c_3 * Lj + c_3/c_4
1587 : For the upper bound,
1588 : r_3 < 1 + c_3*(r_4+1)/c_4 < 1 + c_3*(c_4*Lj+1 + 1)/c_4
1589 : = 1 + c_3 * Lj + 2*c_3/c_4
1590 : Continuing similarly gives
1591 : c_2*Lj + c_2/c_3 + c_2/c_4 <= r_2
1592 : c_1*Lj + c_1/c_2 + c_1/c_c + c_1/c_4 <= r_1
1593 : c_0*Lj + c_0/c_1 + c_0/c_2 + c_0/c_3 + c_0/c_4 <= r_0
1594 : and
1595 : r_2 < 1 + c_2*Lj + 2c_2/c_3 + 2c_2/c_4
1596 : r_1 < 1 + c_1*Lj + 2c_1/c_2 + 2c_1/c_3 + 2c_1/c_4
1597 : r_0 < 1 + c_0*Lj + 2c_0/c_1 + 2c_0/c_2 + 2c_0/c_3 + 2c_0/c_4.
1598 :
1599 : Setting L(j+1)>=(1 + c_0*Lj+2c_0/c_1+2c_0/c_2+2c_0/c_3+2c_0/c_4)/c_0
1600 : is then sufficient to ensure the whole sequence of 5 fits between Lj
1601 : and L(j+1). Simplifying gives
1602 : L<= 1/c_0 + 2/c_1 + 2/c_2 + 2/c_3 + 2/c_4
1603 : but L must be a constant and not depend on individual values of c_i,
1604 : so, given that c_i >= 1020, we set L = 9/1020.
1605 :
1606 : Now all that remains is to determine N. It's a bit unfortunate
1607 : that we require N, since it limits our capacity, but it's necessary
1608 : in any system that tries to compute priorities to enforce a FIFO
1609 : order. If we've inserted more than N bundles without ever having
1610 : the bundle treap go empty, we'll briefly break the FIFO ordering as
1611 : we underflow.
1612 :
1613 : Thus, we'd like to make N as big as possible, avoiding overflow.
1614 : r_0, ..., r_4 are all uints, and taking the bounds from above,
1615 : given that for any i, i' c_i/c_{i'} < 1527, we have
1616 : r_i < 1 + 1556782 * Lj + 8*1527.
1617 : To avoid overflow, we assert the right-hand side is < 2^32, which
1618 : implies N <= 312671.
1619 :
1620 : We want to use a fixed point representation for L so that the
1621 : entire computation can be done with integer arithmetic. We can do
1622 : the arithmetic as ulongs, which means defining L' >= L * 2^s, and
1623 : we compute ceil( c_4*Lj ) as floor( (c_4 * L' * j + 2^s - 1)/2^s ),
1624 : so c_4 * L' * j + 2^s should fit in a ulong. With j<=N, this gives
1625 : s<=32, so we set s=32, which means L' = 37896771 >= 9/1020 * 2^32.
1626 : Note that 1 + 1556782 * L' * N + 8*1527 + 2^32 is approximately
1627 : 2^63.999993.
1628 :
1629 : Note that this is all checked by a proof of the code translated
1630 : into Z3. Unfortunately CBMC was too slow to prove this code
1631 : directly. */
1632 279 : #define BUNDLE_L_PRIME 37896771UL
1633 279 : #define BUNDLE_N 312671UL
1634 :
1635 132 : if( FD_UNLIKELY( pack->relative_bundle_idx>BUNDLE_N ) ) {
1636 0 : FD_LOG_WARNING(( "Too many bundles inserted without allowing pending bundles to go empty. "
1637 0 : "Ordering of bundles may be incorrect." ));
1638 0 : pack->relative_bundle_idx = 1UL;
1639 0 : }
1640 132 : ulong bundle_idx = fd_ulong_if( initializer_bundle, 0UL, pack->relative_bundle_idx );
1641 132 : insert_bundle_impl( pack, bundle_idx, txn_cnt, (fd_pack_ord_txn_t * *)bundle, expires_at );
1642 : /* if IB this is max( 1, x ), which is x. Otherwise, this is max(x,
1643 : x+1) which is x++ */
1644 132 : pack->relative_bundle_idx = fd_ulong_max( bundle_idx+1UL, pack->relative_bundle_idx );
1645 :
1646 132 : return (0) | (replaces<<1) | ((!!nonce_txn_cnt)<<2);
1647 375 : }
1648 : static inline void
1649 : insert_bundle_impl( fd_pack_t * pack,
1650 : ulong bundle_idx,
1651 : ulong txn_cnt,
1652 : fd_pack_ord_txn_t * * bundle,
1653 132 : ulong expires_at ) {
1654 132 : ulong prev_reward = ((BUNDLE_L_PRIME * (BUNDLE_N - bundle_idx))) - 1UL;
1655 132 : ulong prev_cost = 1UL<<32;
1656 :
1657 : /* Assign last to first */
1658 678 : for( ulong i=0UL; i<txn_cnt; i++ ) {
1659 546 : fd_pack_ord_txn_t * ord = bundle[ txn_cnt-1UL - i ];
1660 546 : ord->rewards = (uint)(((ulong)ord->compute_est * (prev_reward + 1UL) + prev_cost-1UL)/prev_cost);
1661 546 : ord->root = FD_ORD_TXN_ROOT_PENDING_BUNDLE;
1662 546 : prev_reward = ord->rewards;
1663 546 : prev_cost = ord->compute_est;
1664 :
1665 : /* The penalty information isn't used for bundles. */
1666 546 : ushort penalties [ FD_TXN_ACCT_ADDR_MAX ];
1667 546 : uchar penalty_idx[ FD_TXN_ACCT_ADDR_MAX ];
1668 546 : populate_bitsets( pack, ord, penalties, penalty_idx );
1669 :
1670 546 : treap_ele_insert( pack->pending_bundles, ord, pack->pool );
1671 546 : pack->pending_txn_cnt++;
1672 :
1673 546 : if( FD_UNLIKELY( ord->txn->flags & FD_TXN_P_FLAGS_DURABLE_NONCE ) ) noncemap_ele_insert( pack->noncemap, ord, pack->pool );
1674 546 : sig2txn_ele_insert( pack->signature_map, ord, pack->pool );
1675 :
1676 546 : fd_pack_expq_t temp[ 1 ] = {{ .expires_at = expires_at, .txn = ord }};
1677 546 : expq_insert( pack->expiration_q, temp );
1678 546 : }
1679 :
1680 132 : }
1681 :
1682 : void const *
1683 0 : fd_pack_peek_bundle_meta( fd_pack_t const * pack ) {
1684 0 : int ib_state = pack->initializer_bundle_state;
1685 0 : if( FD_UNLIKELY( (ib_state==FD_PACK_IB_STATE_PENDING) | (ib_state==FD_PACK_IB_STATE_FAILED) ) ) return NULL;
1686 :
1687 0 : treap_rev_iter_t _cur=treap_rev_iter_init( pack->pending_bundles, pack->pool );
1688 0 : if( FD_UNLIKELY( treap_rev_iter_done( _cur ) ) ) return NULL; /* empty */
1689 :
1690 0 : fd_pack_ord_txn_t * cur = treap_rev_iter_ele( _cur, pack->pool );
1691 0 : int is_ib = !!(cur->txn->flags & FD_TXN_P_FLAGS_INITIALIZER_BUNDLE);
1692 0 : if( FD_UNLIKELY( is_ib ) ) return NULL;
1693 :
1694 0 : return (void const *)((uchar const *)pack->bundle_meta + (ulong)_cur * pack->bundle_meta_sz);
1695 0 : }
1696 :
1697 : void
1698 3 : fd_pack_set_initializer_bundles_ready( fd_pack_t * pack ) {
1699 3 : pack->initializer_bundle_state = FD_PACK_IB_STATE_READY;
1700 3 : }
1701 :
1702 : void
1703 1593831 : fd_pack_metrics_write( fd_pack_t const * pack ) {
1704 1593831 : ulong pending_regular = treap_ele_cnt( pack->pending );
1705 1593831 : ulong pending_votes = treap_ele_cnt( pack->pending_votes );
1706 1593831 : ulong pending_bundle = treap_ele_cnt( pack->pending_bundles );
1707 1593831 : ulong conflicting = pack->pending_txn_cnt - pending_votes - pending_bundle - treap_ele_cnt( pack->pending );
1708 1593831 : FD_MGAUGE_SET( PACK, AVAILABLE_TRANSACTIONS_ALL, pack->pending_txn_cnt );
1709 1593831 : FD_MGAUGE_SET( PACK, AVAILABLE_TRANSACTIONS_REGULAR, pending_regular );
1710 1593831 : FD_MGAUGE_SET( PACK, AVAILABLE_TRANSACTIONS_VOTES, pending_votes );
1711 1593831 : FD_MGAUGE_SET( PACK, AVAILABLE_TRANSACTIONS_CONFLICTING, conflicting );
1712 1593831 : FD_MGAUGE_SET( PACK, AVAILABLE_TRANSACTIONS_BUNDLES, pending_bundle );
1713 1593831 : FD_MGAUGE_SET( PACK, SMALLEST_PENDING_TRANSACTION, pack->pending_smallest->cus );
1714 :
1715 1593831 : FD_MCNT_ENUM_COPY( PACK, TRANSACTION_SCHEDULE, pack->sched_results );
1716 1593831 : }
1717 :
1718 : void
1719 0 : fd_pack_get_sched_metrics( fd_pack_t const * pack, ulong * metrics ) {
1720 0 : fd_memcpy( metrics, pack->sched_results, sizeof(pack->sched_results) );
1721 0 : }
1722 :
1723 : typedef struct {
1724 : ushort clear_rw_bit;
1725 : ushort clear_w_bit;
1726 : } release_result_t;
1727 :
1728 : static inline release_result_t
1729 : release_bit_reference( fd_pack_t * pack,
1730 17780283 : fd_acct_addr_t const * acct ) {
1731 :
1732 17780283 : fd_pack_bitset_acct_mapping_t * q = bitset_map_query( pack->acct_to_bitset, *acct, NULL );
1733 17780283 : FD_TEST( q ); /* q==NULL not be possible */
1734 :
1735 17780283 : q->ref_cnt--;
1736 :
1737 17780283 : if( FD_UNLIKELY( q->ref_cnt==0UL ) ) {
1738 13241468 : ushort bit = q->bit;
1739 13241468 : bitset_map_remove( pack->acct_to_bitset, q );
1740 13241468 : if( FD_LIKELY( bit<FD_PACK_BITSET_MAX ) ) pack->bitset_avail[ ++(pack->bitset_avail_cnt) ] = bit;
1741 :
1742 13241468 : fd_pack_addr_use_t * use = acct_uses_query( pack->acct_in_use, *acct, NULL );
1743 13241468 : if( FD_LIKELY( use ) ) {
1744 12745404 : use->in_use_by |= FD_PACK_IN_USE_BIT_CLEARED;
1745 12745404 : release_result_t ret = { .clear_rw_bit = bit,
1746 12745404 : .clear_w_bit = fd_ushort_if( !!(use->in_use_by & FD_PACK_IN_USE_WRITABLE), bit, FD_PACK_BITSET_MAX ) };
1747 12745404 : return ret;
1748 12745404 : }
1749 13241468 : }
1750 5034879 : release_result_t ret = { .clear_rw_bit = FD_PACK_BITSET_MAX, .clear_w_bit = FD_PACK_BITSET_MAX };
1751 5034879 : return ret;
1752 17780283 : }
1753 :
1754 : typedef struct {
1755 : ulong cus_scheduled;
1756 : ulong txns_scheduled;
1757 : ulong bytes_scheduled;
1758 : } sched_return_t;
1759 :
1760 : static inline sched_return_t
1761 : fd_pack_schedule_impl( fd_pack_t * pack,
1762 : treap_t * sched_from,
1763 : ulong cu_limit,
1764 : ulong txn_limit,
1765 : ulong byte_limit,
1766 : ulong bank_tile,
1767 : fd_pack_smallest_t * smallest_in_treap,
1768 : ulong * use_by_bank_txn,
1769 3187569 : fd_txn_e_t * out ) {
1770 :
1771 3187569 : fd_pack_ord_txn_t * pool = pack->pool;
1772 3187569 : fd_pack_addr_use_t * acct_in_use = pack->acct_in_use;
1773 3187569 : fd_pack_addr_use_t * writer_costs = pack->writer_costs;
1774 :
1775 3187569 : fd_pack_addr_use_t ** written_list = pack->written_list;
1776 3187569 : ulong written_list_cnt = pack->written_list_cnt;
1777 3187569 : ulong written_list_max = pack->written_list_max;
1778 :
1779 3187569 : FD_PACK_BITSET_DECLARE( bitset_rw_in_use );
1780 3187569 : FD_PACK_BITSET_DECLARE( bitset_w_in_use );
1781 3187569 : FD_PACK_BITSET_COPY( bitset_rw_in_use, pack->bitset_rw_in_use );
1782 3187569 : FD_PACK_BITSET_COPY( bitset_w_in_use, pack->bitset_w_in_use );
1783 :
1784 3187569 : fd_pack_addr_use_t * use_by_bank = pack->use_by_bank [bank_tile];
1785 3187569 : ulong use_by_bank_cnt = pack->use_by_bank_cnt[bank_tile];
1786 :
1787 3187569 : ulong max_write_cost_per_acct = pack->lim->max_write_cost_per_acct;
1788 :
1789 3187569 : ushort compressed_slot_number = pack->compressed_slot_number;
1790 :
1791 3187569 : ulong txns_scheduled = 0UL;
1792 3187569 : ulong cus_scheduled = 0UL;
1793 3187569 : ulong bytes_scheduled = 0UL;
1794 :
1795 3187569 : ulong bank_tile_mask = 1UL << bank_tile;
1796 :
1797 3187569 : ulong fast_path = 0UL;
1798 3187569 : ulong slow_path = 0UL;
1799 3187569 : ulong cu_limit_c = 0UL;
1800 3187569 : ulong byte_limit_c = 0UL;
1801 3187569 : ulong write_limit_c = 0UL;
1802 3187569 : ulong skip_c = 0UL;
1803 :
1804 3187569 : ulong min_cus = ULONG_MAX;
1805 3187569 : ulong min_bytes = ULONG_MAX;
1806 :
1807 3187569 : if( FD_UNLIKELY( (cu_limit<smallest_in_treap->cus) | (txn_limit==0UL) | (byte_limit<smallest_in_treap->bytes) ) ) {
1808 1655100 : sched_return_t to_return = { .cus_scheduled = 0UL, .txns_scheduled = 0UL, .bytes_scheduled = 0UL };
1809 1655100 : return to_return;
1810 1655100 : }
1811 :
1812 1532469 : treap_rev_iter_t prev = treap_idx_null();
1813 23892033 : for( treap_rev_iter_t _cur=treap_rev_iter_init( sched_from, pool ); !treap_rev_iter_done( _cur ); _cur=prev ) {
1814 : /* Capture next so that we can delete while we iterate. */
1815 23806698 : prev = treap_rev_iter_next( _cur, pool );
1816 :
1817 23806698 : # if FD_HAS_X86
1818 23806698 : _mm_prefetch( &(pool[ prev ].prev), _MM_HINT_T0 );
1819 23806698 : # endif
1820 :
1821 23806698 : fd_pack_ord_txn_t * cur = treap_rev_iter_ele( _cur, pool );
1822 :
1823 23806698 : min_cus = fd_ulong_min( min_cus, cur->compute_est );
1824 23806698 : min_bytes = fd_ulong_min( min_bytes, cur->txn->payload_sz );
1825 :
1826 23806698 : ulong conflicts = 0UL;
1827 :
1828 23806698 : if( FD_UNLIKELY( cur->compute_est>cu_limit ) ) {
1829 : /* Too big to be scheduled at the moment, but might be okay for
1830 : the next microblock, so we don't want to delay it. */
1831 0 : cu_limit_c++;
1832 0 : continue;
1833 0 : }
1834 :
1835 : /* Likely? Unlikely? */
1836 23806698 : if( FD_LIKELY( !FD_PACK_BITSET_INTERSECT4_EMPTY( bitset_rw_in_use, bitset_w_in_use, cur->w_bitset, cur->rw_bitset ) ) ) {
1837 10752822 : fast_path++;
1838 10752822 : continue;
1839 10752822 : }
1840 :
1841 13053876 : if( FD_UNLIKELY( cur->skip==compressed_slot_number ) ) {
1842 0 : skip_c++;
1843 0 : continue;
1844 0 : }
1845 :
1846 : /* If skip>FD_PACK_MAX_SKIP but not compressed_slot_number, it means
1847 : it's the compressed slot number of a previous slot. We don't
1848 : care unless we're going to update the value though, so we don't
1849 : need to eagerly reset it to FD_PACK_MAX_SKIP.
1850 : compressed_slot_number is a ushort, so it's possible for it to
1851 : roll over, but the transaction lifetime is much shorter than
1852 : that, so it won't be a problem. */
1853 :
1854 13053876 : if( FD_UNLIKELY( cur->txn->payload_sz>byte_limit ) ) {
1855 6 : byte_limit_c++;
1856 6 : continue;
1857 6 : }
1858 :
1859 :
1860 13053870 : fd_txn_t const * txn = TXN(cur->txn);
1861 13053870 : fd_acct_addr_t const * accts = fd_txn_get_acct_addrs( txn, cur->txn->payload );
1862 13053870 : fd_acct_addr_t const * alt_adj = cur->txn_e->alt_accts - fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM );
1863 : /* Check conflicts between this transaction's writable accounts and
1864 : current readers */
1865 13053870 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_WRITABLE );
1866 27245811 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
1867 :
1868 14191944 : fd_acct_addr_t acct = *ACCT_ITER_TO_PTR( iter );
1869 :
1870 14191944 : fd_pack_addr_use_t * in_wcost_table = acct_uses_query( writer_costs, acct, NULL );
1871 14191944 : if( FD_UNLIKELY( in_wcost_table && in_wcost_table->total_cost+cur->compute_est > max_write_cost_per_acct ) ) {
1872 : /* Can't be scheduled until the next block */
1873 3 : conflicts = ULONG_MAX;
1874 3 : break;
1875 3 : }
1876 :
1877 14191941 : fd_pack_addr_use_t * use = acct_uses_query( acct_in_use, acct, NULL );
1878 14191941 : if( FD_UNLIKELY( use ) ) conflicts |= use->in_use_by; /* break? */
1879 14191941 : }
1880 :
1881 13053870 : if( FD_UNLIKELY( conflicts==ULONG_MAX ) ) {
1882 : /* The logic for how to adjust skip is a bit complicated, and we
1883 : want to do it branchlessly. Let psc=FD_PACK_SKIP_CNT,
1884 : Before After
1885 : 1 compressed_slot_number
1886 : x in [2, psc] x-1
1887 : x where x>psc psc-1
1888 :
1889 : Set A=min(x, 5), B=min(A-2, compressed_slot_number-1), and
1890 : note that compressed_slot_number is in [psc+1, USHORT_MAX].
1891 : Then:
1892 : x A A-2 B B+1
1893 : 1 1 USHORT_MAX csn-1 csn
1894 : x in [2, psc] x x-2 x-2 x-1
1895 : x where x>psc psc psc-2 psc-2 psc-1
1896 : So B+1 is the desired value. */
1897 3 : cur->skip = (ushort)(1+fd_ushort_min( (ushort)(compressed_slot_number-1),
1898 3 : (ushort)(fd_ushort_min( cur->skip, FD_PACK_SKIP_CNT )-2) ) );
1899 3 : write_limit_c++;
1900 3 : continue;
1901 3 : }
1902 :
1903 13053867 : if( FD_UNLIKELY( conflicts ) ) {
1904 6 : slow_path++;
1905 6 : continue;
1906 6 : }
1907 :
1908 : /* Check conflicts between this transaction's readonly accounts and
1909 : current writers */
1910 13053861 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_READONLY );
1911 16528947 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
1912 :
1913 3475086 : fd_acct_addr_t const * acct = ACCT_ITER_TO_PTR( iter );
1914 3475086 : if( fd_pack_unwritable_contains( acct ) ) continue; /* No need to track sysvars because they can't be writable */
1915 :
1916 2576115 : fd_pack_addr_use_t * use = acct_uses_query( acct_in_use, *acct, NULL );
1917 2576115 : if( use ) conflicts |= (use->in_use_by & FD_PACK_IN_USE_WRITABLE) ? use->in_use_by : 0UL;
1918 2576115 : }
1919 :
1920 13053861 : if( FD_UNLIKELY( conflicts ) ) {
1921 0 : slow_path++;
1922 0 : continue;
1923 0 : }
1924 :
1925 : /* Include this transaction in the microblock! */
1926 13053861 : FD_PACK_BITSET_OR( bitset_rw_in_use, cur->rw_bitset );
1927 13053861 : FD_PACK_BITSET_OR( bitset_w_in_use, cur->w_bitset );
1928 :
1929 13053861 : fd_txn_p_t * out_txnp = out->txnp;
1930 13053861 : if(
1931 4351287 : #if FD_HAS_AVX512 && FD_PACK_USE_NON_TEMPORAL_MEMCPY
1932 4351287 : FD_LIKELY( cur->txn->payload_sz>=1024UL )
1933 : #else
1934 8702574 : 0
1935 8702574 : #endif
1936 13053861 : ) {
1937 4224 : #if FD_HAS_AVX512 && FD_PACK_USE_NON_TEMPORAL_MEMCPY
1938 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 0UL), _mm512_load_epi64( cur->txn->payload+ 0UL ) );
1939 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 64UL), _mm512_load_epi64( cur->txn->payload+ 64UL ) );
1940 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 128UL), _mm512_load_epi64( cur->txn->payload+ 128UL ) );
1941 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 192UL), _mm512_load_epi64( cur->txn->payload+ 192UL ) );
1942 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 256UL), _mm512_load_epi64( cur->txn->payload+ 256UL ) );
1943 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 320UL), _mm512_load_epi64( cur->txn->payload+ 320UL ) );
1944 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 384UL), _mm512_load_epi64( cur->txn->payload+ 384UL ) );
1945 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 448UL), _mm512_load_epi64( cur->txn->payload+ 448UL ) );
1946 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 512UL), _mm512_load_epi64( cur->txn->payload+ 512UL ) );
1947 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 576UL), _mm512_load_epi64( cur->txn->payload+ 576UL ) );
1948 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 640UL), _mm512_load_epi64( cur->txn->payload+ 640UL ) );
1949 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 704UL), _mm512_load_epi64( cur->txn->payload+ 704UL ) );
1950 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 768UL), _mm512_load_epi64( cur->txn->payload+ 768UL ) );
1951 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 832UL), _mm512_load_epi64( cur->txn->payload+ 832UL ) );
1952 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 896UL), _mm512_load_epi64( cur->txn->payload+ 896UL ) );
1953 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+ 960UL), _mm512_load_epi64( cur->txn->payload+ 960UL ) );
1954 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+1024UL), _mm512_load_epi64( cur->txn->payload+1024UL ) );
1955 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+1088UL), _mm512_load_epi64( cur->txn->payload+1088UL ) );
1956 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+1152UL), _mm512_load_epi64( cur->txn->payload+1152UL ) );
1957 4224 : _mm512_stream_si512( (void*)(out_txnp->payload+1216UL), _mm512_load_epi64( cur->txn->payload+1216UL ) );
1958 : /* Copied out to 1280 bytes, which copies some other fields we needed to
1959 : copy anyway. */
1960 4224 : FD_STATIC_ASSERT( offsetof(fd_txn_p_t, payload_sz )+sizeof(((fd_txn_p_t*)NULL)->payload_sz )<=1280UL, nt_memcpy );
1961 4224 : FD_STATIC_ASSERT( offsetof(fd_txn_p_t, blockhash_slot )+sizeof(((fd_txn_p_t*)NULL)->blockhash_slot)<=1280UL, nt_memcpy );
1962 4224 : FD_STATIC_ASSERT( offsetof(fd_txn_p_t, scheduler_arrival_time_nanos )+sizeof(((fd_txn_p_t*)NULL)->scheduler_arrival_time_nanos )<=1280UL, nt_memcpy );
1963 4224 : FD_STATIC_ASSERT( offsetof(fd_txn_p_t, source_tpu )+sizeof(((fd_txn_p_t*)NULL)->source_tpu )<=1280UL, nt_memcpy );
1964 4224 : FD_STATIC_ASSERT( offsetof(fd_txn_p_t, source_ipv4 )+sizeof(((fd_txn_p_t*)NULL)->source_ipv4 )<=1280UL, nt_memcpy );
1965 4224 : FD_STATIC_ASSERT( offsetof(fd_txn_p_t, flags )+sizeof(((fd_txn_p_t*)NULL)->flags )<=1280UL, nt_memcpy );
1966 4224 : FD_STATIC_ASSERT( offsetof(fd_txn_p_t, _ ) <=1280UL, nt_memcpy );
1967 4224 : const ulong offset_into_txn = 1280UL - offsetof(fd_txn_p_t, _ );
1968 4224 : fd_memcpy( offset_into_txn+(uchar *)TXN(out_txnp), offset_into_txn+(uchar const *)txn,
1969 4224 : fd_ulong_max( offset_into_txn, fd_txn_footprint( txn->instr_cnt, txn->addr_table_lookup_cnt ) )-offset_into_txn );
1970 4224 : #endif
1971 13049637 : } else {
1972 13049637 : fd_memcpy( out_txnp->payload, cur->txn->payload, cur->txn->payload_sz );
1973 13049637 : fd_memcpy( TXN(out_txnp), txn, fd_txn_footprint( txn->instr_cnt, txn->addr_table_lookup_cnt ) );
1974 13049637 : out_txnp->payload_sz = cur->txn->payload_sz;
1975 13049637 : out_txnp->pack_cu.requested_exec_plus_acct_data_cus = cur->txn->pack_cu.requested_exec_plus_acct_data_cus;
1976 13049637 : out_txnp->pack_cu.non_execution_cus = cur->txn->pack_cu.non_execution_cus;
1977 13049637 : out_txnp->scheduler_arrival_time_nanos = cur->txn->scheduler_arrival_time_nanos;
1978 13049637 : out_txnp->source_tpu = cur->txn->source_tpu;
1979 13049637 : out_txnp->source_ipv4 = cur->txn->source_ipv4;
1980 13049637 : out_txnp->flags = cur->txn->flags;
1981 13049637 : }
1982 : /* Copy the ALT accounts from the source fd_txn_e_t */
1983 13053861 : ulong alt_acct_cnt = (ulong)txn->addr_table_adtl_cnt;
1984 4351287 : #if FD_HAS_AVX512 && FD_PACK_USE_NON_TEMPORAL_MEMCPY
1985 : /* In order to use non-temporal copies, we have to copy a full cache
1986 : line (which fits two pubkeys) at a time. If alt_acct_cnt is odd,
1987 : this copies one extra address, but it touches the same number of
1988 : cache lines, since both the source and destination are aligned
1989 : to 64 bytes. The max is even, so this can never read out of bounds. */
1990 4351287 : fd_acct_addr_t * dst = out->alt_accts;
1991 4351287 : fd_acct_addr_t const * src = cur->txn_e->alt_accts;
1992 4351287 : for( ulong i=0UL; i<alt_acct_cnt; i+=2UL ) {
1993 0 : _mm512_stream_si512( (void*)(dst+i), _mm512_load_epi64( src+i ) );
1994 0 : }
1995 : #else
1996 8702574 : fd_memcpy( out->alt_accts, cur->txn_e->alt_accts, alt_acct_cnt * sizeof(fd_acct_addr_t) );
1997 8702574 : #endif
1998 13053861 : out++;
1999 :
2000 13053861 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_WRITABLE );
2001 27245787 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
2002 14191926 : fd_acct_addr_t acct_addr = *ACCT_ITER_TO_PTR( iter );
2003 :
2004 14191926 : fd_pack_addr_use_t * in_wcost_table = acct_uses_query( writer_costs, acct_addr, NULL );
2005 14191926 : if( !in_wcost_table ) {
2006 786618 : in_wcost_table = acct_uses_insert( writer_costs, acct_addr );
2007 786618 : in_wcost_table->total_cost = 0UL;
2008 786618 : written_list[ written_list_cnt ] = in_wcost_table;
2009 786618 : written_list_cnt = fd_ulong_min( written_list_cnt+1UL, written_list_max-1UL );
2010 786618 : }
2011 14191926 : in_wcost_table->total_cost += cur->compute_est;
2012 :
2013 14191926 : fd_pack_addr_use_t * use = acct_uses_insert( acct_in_use, acct_addr );
2014 14191926 : use->in_use_by = bank_tile_mask | FD_PACK_IN_USE_WRITABLE;
2015 :
2016 14191926 : use_by_bank[use_by_bank_cnt++] = *use;
2017 :
2018 : /* If there aren't any more references to this account in the
2019 : heap, it can't cause any conflicts. That means we actually
2020 : don't need to record that we are using it, which is good
2021 : because we want to release the bit. */
2022 14191926 : release_result_t ret = release_bit_reference( pack, &acct_addr );
2023 14191926 : FD_PACK_BITSET_CLEARN( bitset_rw_in_use, ret.clear_rw_bit );
2024 14191926 : FD_PACK_BITSET_CLEARN( bitset_w_in_use, ret.clear_w_bit );
2025 14191926 : }
2026 13053861 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_READONLY );
2027 16528947 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
2028 :
2029 3475086 : fd_acct_addr_t acct_addr = *ACCT_ITER_TO_PTR( iter );
2030 :
2031 3475086 : if( fd_pack_unwritable_contains( &acct_addr ) ) continue; /* No need to track sysvars because they can't be writable */
2032 :
2033 2576115 : fd_pack_addr_use_t * use = acct_uses_query( acct_in_use, acct_addr, NULL );
2034 2576115 : if( !use ) { use = acct_uses_insert( acct_in_use, acct_addr ); use->in_use_by = 0UL; }
2035 :
2036 2576115 : if( !(use->in_use_by & bank_tile_mask) ) use_by_bank[use_by_bank_cnt++] = *use;
2037 2576115 : use->in_use_by |= bank_tile_mask;
2038 2576115 : use->in_use_by &= ~FD_PACK_IN_USE_BIT_CLEARED;
2039 :
2040 :
2041 2576115 : release_result_t ret = release_bit_reference( pack, &acct_addr );
2042 2576115 : FD_PACK_BITSET_CLEARN( bitset_rw_in_use, ret.clear_rw_bit );
2043 2576115 : FD_PACK_BITSET_CLEARN( bitset_w_in_use, ret.clear_w_bit );
2044 2576115 : }
2045 :
2046 13053861 : txns_scheduled += 1UL; txn_limit -= 1UL;
2047 13053861 : cus_scheduled += cur->compute_est; cu_limit -= cur->compute_est;
2048 13053861 : bytes_scheduled += cur->txn->payload_sz; byte_limit -= cur->txn->payload_sz;
2049 :
2050 13053861 : *(use_by_bank_txn++) = use_by_bank_cnt;
2051 :
2052 13053861 : if( FD_UNLIKELY( cur->txn->flags & FD_TXN_P_FLAGS_DURABLE_NONCE ) ) noncemap_ele_remove_fast( pack->noncemap, cur, pack->pool );
2053 13053861 : sig2txn_ele_remove_fast( pack->signature_map, cur, pool );
2054 :
2055 13053861 : cur->root = FD_ORD_TXN_ROOT_FREE;
2056 13053861 : expq_remove( pack->expiration_q, cur->expq_idx );
2057 13053861 : treap_idx_remove( sched_from, _cur, pool );
2058 13053861 : trp_pool_idx_release( pool, _cur );
2059 13053861 : pack->pending_txn_cnt--;
2060 :
2061 13053861 : if( FD_UNLIKELY( (cu_limit<smallest_in_treap->cus) | (txn_limit==0UL) | (byte_limit<smallest_in_treap->bytes) ) ) break;
2062 13053861 : }
2063 :
2064 1532469 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_TAKEN_IDX ] += txns_scheduled;
2065 1532469 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_CU_LIMIT_IDX ] += cu_limit_c;
2066 1532469 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_FAST_PATH_IDX ] += fast_path;
2067 1532469 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_BYTE_LIMIT_IDX ] += byte_limit_c;
2068 1532469 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_WRITE_COST_IDX ] += write_limit_c;
2069 1532469 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_SLOW_PATH_IDX ] += slow_path;
2070 1532469 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_DEFER_SKIP_IDX ] += skip_c;
2071 :
2072 : /* If we scanned the whole treap and didn't break early, we now have a
2073 : better estimate of the smallest. */
2074 1532469 : if( FD_UNLIKELY( treap_rev_iter_done( prev ) ) ) {
2075 88356 : smallest_in_treap->cus = min_cus;
2076 88356 : smallest_in_treap->bytes = min_bytes;
2077 88356 : }
2078 :
2079 1532469 : pack->use_by_bank_cnt[bank_tile] = use_by_bank_cnt;
2080 1532469 : FD_PACK_BITSET_COPY( pack->bitset_rw_in_use, bitset_rw_in_use );
2081 1532469 : FD_PACK_BITSET_COPY( pack->bitset_w_in_use, bitset_w_in_use );
2082 :
2083 1532469 : pack->written_list_cnt = written_list_cnt;
2084 :
2085 1532469 : sched_return_t to_return = { .cus_scheduled=cus_scheduled, .txns_scheduled=txns_scheduled, .bytes_scheduled=bytes_scheduled };
2086 1532469 : return to_return;
2087 3187569 : }
2088 :
2089 : int
2090 : fd_pack_microblock_complete( fd_pack_t * pack,
2091 1593837 : ulong bank_tile ) {
2092 : /* If the account is in use writably, and it's in use by this banking
2093 : tile, then this banking tile must be the sole writer to it, so it's
2094 : always okay to clear the writable bit. */
2095 1593837 : ulong clear_mask = ~((1UL<<bank_tile) | FD_PACK_IN_USE_WRITABLE);
2096 :
2097 : /* If nothing outstanding, bail quickly */
2098 1593837 : if( FD_UNLIKELY( !(pack->outstanding_microblock_mask & (1UL<<bank_tile)) ) ) return 0;
2099 :
2100 1526499 : FD_PACK_BITSET_DECLARE( bitset_rw_in_use );
2101 1526499 : FD_PACK_BITSET_DECLARE( bitset_w_in_use );
2102 1526499 : FD_PACK_BITSET_COPY( bitset_rw_in_use, pack->bitset_rw_in_use );
2103 1526499 : FD_PACK_BITSET_COPY( bitset_w_in_use, pack->bitset_w_in_use );
2104 :
2105 1526499 : fd_pack_addr_use_t * base = pack->use_by_bank[bank_tile];
2106 :
2107 1526499 : fd_pack_ord_txn_t * best = NULL;
2108 1526499 : fd_pack_penalty_treap_t * best_penalty = NULL;
2109 1526499 : ulong txn_cnt = 0UL;
2110 :
2111 17705844 : for( ulong i=0UL; i<pack->use_by_bank_cnt[bank_tile]; i++ ) {
2112 16179345 : fd_pack_addr_use_t * use = acct_uses_query( pack->acct_in_use, base[i].key, NULL );
2113 16179345 : FD_TEST( use );
2114 16179345 : use->in_use_by &= clear_mask;
2115 :
2116 : /* In order to properly bound the size of bitset_map, we need to
2117 : release the "reference" to the account when we schedule it.
2118 : However, that poses a bit of a problem here, because by the time
2119 : we complete the microblock, that account could have been assigned
2120 : a different bit in the bitset. The scheduling step tells us if
2121 : that is the case, and if so, we know that the bits in
2122 : bitset_w_in_use and bitset_rw_in_use were already cleared as
2123 : necessary.
2124 :
2125 : Note that it's possible for BIT_CLEARED to be set and then unset
2126 : by later uses, but then the account would be in use on other
2127 : banks, so we wouldn't try to observe the old value. For example:
2128 : Suppose bit 0->account A, bit 1->account B, and we have two
2129 : transactions that read A, B. We schedule a microblock to bank 0,
2130 : taking both transactions, which sets the counts for A, B to 0,
2131 : and releases the bits, clearing bits 0 and 1, and setting
2132 : BIT_CLEARED. Then we get two more transactions that read
2133 : accounts C, D, A, B, and they get assigned 0->C, 1->D, 2->A,
2134 : 3->B. We try to schedule a microblock to bank 1 that takes one
2135 : of those transactions. This unsets BIT_CLEARED for A, B.
2136 : Finally, the first microblock completes. Even though the bitset
2137 : map has the new bits for A and B which are "wrong" compared to
2138 : when the transaction was initially scheduled, those bits have
2139 : already been cleared and reset properly in the bitset as needed.
2140 : A and B will still be in use by bank 1, so we won't clear any
2141 : bits. If, on the other hand, the microblock scheduled to bank 1
2142 : completes first, bits 0 and 1 will be cleared for accounts C and
2143 : D, while bits 2 and 3 will remain set, which is correct. Then
2144 : when bank 0 completes, bits 2 and 3 will be cleared. */
2145 16179345 : if( FD_LIKELY( !use->in_use_by ) ) { /* if in_use_by==0, doesn't include BIT_CLEARED */
2146 3441951 : fd_pack_bitset_acct_mapping_t * q = bitset_map_query( pack->acct_to_bitset, base[i].key, NULL );
2147 3441951 : FD_TEST( q );
2148 3441951 : FD_PACK_BITSET_CLEARN( bitset_w_in_use, q->bit );
2149 3441951 : FD_PACK_BITSET_CLEARN( bitset_rw_in_use, q->bit );
2150 :
2151 : /* Because this account is no longer in use, it might be possible
2152 : to schedule a transaction that writes to it. Check its
2153 : penalty treap if it has one, and potentially move it to the
2154 : main treap. */
2155 3441951 : fd_pack_penalty_treap_t * p_trp = penalty_map_query( pack->penalty_treaps, base[i].key, NULL );
2156 3441951 : if( FD_UNLIKELY( p_trp ) ) {
2157 752813 : fd_pack_ord_txn_t * best_in_trp = treap_rev_iter_ele( treap_rev_iter_init( p_trp->penalty_treap, pack->pool ), pack->pool );
2158 752813 : if( FD_UNLIKELY( !best || COMPARE_WORSE( best, best_in_trp ) ) ) {
2159 301626 : best = best_in_trp;
2160 301626 : best_penalty = p_trp;
2161 301626 : }
2162 752813 : }
2163 3441951 : }
2164 :
2165 16179345 : if( FD_LIKELY( !(use->in_use_by & ~FD_PACK_IN_USE_BIT_CLEARED) ) ) acct_uses_remove( pack->acct_in_use, use );
2166 :
2167 16179345 : if( FD_UNLIKELY( i+1UL==pack->use_by_bank_txn[ bank_tile ][ txn_cnt ] ) ) {
2168 13050087 : txn_cnt++;
2169 13050087 : if( FD_LIKELY( best ) ) {
2170 : /* move best to the main treap */
2171 301626 : treap_ele_remove( best_penalty->penalty_treap, best, pack->pool );
2172 301626 : best->root = FD_ORD_TXN_ROOT_PENDING;
2173 301626 : treap_ele_insert( pack->pending, best, pack->pool );
2174 :
2175 301626 : pack->pending_smallest->cus = fd_ulong_min( pack->pending_smallest->cus, best->compute_est );
2176 301626 : pack->pending_smallest->bytes = fd_ulong_min( pack->pending_smallest->bytes, best->txn_e->txnp->payload_sz );
2177 :
2178 301626 : if( FD_UNLIKELY( !treap_ele_cnt( best_penalty->penalty_treap ) ) ) {
2179 2892 : treap_delete( treap_leave( best_penalty->penalty_treap ) );
2180 : /* Removal invalidates any pointers we got from
2181 : penalty_map_query, but we immediately set these to NULL, so
2182 : we're not keeping any pointers around. */
2183 2892 : penalty_map_remove( pack->penalty_treaps, best_penalty );
2184 2892 : }
2185 301626 : best = NULL;
2186 301626 : best_penalty = NULL;
2187 301626 : }
2188 13050087 : }
2189 16179345 : }
2190 :
2191 1526499 : pack->use_by_bank_cnt[bank_tile] = 0UL;
2192 :
2193 1526499 : FD_PACK_BITSET_COPY( pack->bitset_rw_in_use, bitset_rw_in_use );
2194 1526499 : FD_PACK_BITSET_COPY( pack->bitset_w_in_use, bitset_w_in_use );
2195 :
2196 : /* outstanding_microblock_mask never has the writable bit set, so we
2197 : don't care about clearing it here either. */
2198 1526499 : pack->outstanding_microblock_mask &= clear_mask;
2199 1526499 : return 1;
2200 1526499 : }
2201 :
2202 1593678 : #define TRY_BUNDLE_NO_READY_BUNDLES 0
2203 6 : #define TRY_BUNDLE_HAS_CONFLICTS (-1)
2204 6 : #define TRY_BUNDLE_DOES_NOT_FIT (-2)
2205 6 : #define TRY_BUNDLE_SUCCESS(n) ( n) /* schedule bundle with n transactions */
2206 : static inline int
2207 : fd_pack_try_schedule_bundle( fd_pack_t * pack,
2208 : ulong bank_tile,
2209 1593684 : fd_txn_e_t * out ) {
2210 1593684 : int state = pack->initializer_bundle_state;
2211 1593684 : if( FD_UNLIKELY( (state==FD_PACK_IB_STATE_PENDING) | (state==FD_PACK_IB_STATE_FAILED ) ) ) return TRY_BUNDLE_NO_READY_BUNDLES;
2212 :
2213 1593684 : fd_pack_ord_txn_t * pool = pack->pool;
2214 1593684 : treap_t * bundles = pack->pending_bundles;
2215 :
2216 1593684 : int require_ib;
2217 1593684 : if( FD_UNLIKELY( state==FD_PACK_IB_STATE_NOT_INITIALIZED ) ) { require_ib = 1; }
2218 1593684 : if( FD_LIKELY ( state==FD_PACK_IB_STATE_READY ) ) { require_ib = 0; }
2219 :
2220 1593684 : treap_rev_iter_t _cur = treap_rev_iter_init( bundles, pool );
2221 1593684 : ulong bundle_idx = ULONG_MAX;
2222 :
2223 : /* Skip any that we've marked as won't fit in this block */
2224 1593684 : while( FD_UNLIKELY( !treap_rev_iter_done( _cur ) && treap_rev_iter_ele( _cur, pool )->skip==pack->compressed_slot_number ) ) {
2225 0 : _cur = treap_rev_iter_next( _cur, pool );
2226 0 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_DEFER_SKIP_IDX ]++;
2227 0 : }
2228 :
2229 1593684 : if( FD_UNLIKELY( treap_rev_iter_done( _cur ) ) ) return TRY_BUNDLE_NO_READY_BUNDLES;
2230 :
2231 6 : treap_rev_iter_t _txn0 = _cur;
2232 6 : fd_pack_ord_txn_t * txn0 = treap_rev_iter_ele( _txn0, pool );
2233 6 : int is_ib = !!(txn0->txn->flags & FD_TXN_P_FLAGS_INITIALIZER_BUNDLE);
2234 6 : bundle_idx = RC_TO_REL_BUNDLE_IDX( txn0->rewards, txn0->compute_est );
2235 :
2236 6 : if( FD_UNLIKELY( require_ib & !is_ib ) ) return TRY_BUNDLE_NO_READY_BUNDLES;
2237 :
2238 : /* At this point, we have our candidate bundle, so we'll schedule it
2239 : if we can. If we can't, we won't schedule anything. */
2240 :
2241 :
2242 6 : fd_pack_addr_use_t * bundle_temp_inserted[ FD_PACK_MAX_TXN_PER_BUNDLE * FD_TXN_ACCT_ADDR_MAX ];
2243 6 : ulong bundle_temp_inserted_cnt = 0UL;
2244 :
2245 6 : ulong bank_tile_mask = 1UL << bank_tile;
2246 :
2247 6 : int doesnt_fit = 0;
2248 6 : int has_conflict = 0;
2249 6 : ulong txn_cnt = 0UL;
2250 :
2251 6 : ulong cu_limit = pack->lim->max_cost_per_block - pack->cumulative_block_cost;
2252 6 : ulong byte_limit = pack->lim->max_data_bytes_per_block - pack->data_bytes_consumed;
2253 6 : ulong microblock_limit = pack->lim->max_microblocks_per_block - pack->microblock_cnt;
2254 :
2255 6 : FD_PACK_BITSET_DECLARE( bitset_rw_in_use );
2256 6 : FD_PACK_BITSET_DECLARE( bitset_w_in_use );
2257 6 : FD_PACK_BITSET_COPY( bitset_rw_in_use, pack->bitset_rw_in_use );
2258 6 : FD_PACK_BITSET_COPY( bitset_w_in_use, pack->bitset_w_in_use );
2259 :
2260 : /* last_use_in_txn_cnt[i+1] Keeps track of the number of accounts that
2261 : have their last reference in transaction i of the bundle. This
2262 : esoteric value is important for computing use_by_bank_txn.
2263 : last_use_in_txn_cnt[0] is garbage. */
2264 6 : ulong last_use_in_txn_cnt[ 1UL+FD_PACK_MAX_TXN_PER_BUNDLE ] = { 0UL };
2265 :
2266 6 : fd_pack_addr_use_t null_use[1] = {{{{ 0 }}, { 0 }}};
2267 :
2268 24 : while( !(doesnt_fit | has_conflict) & !treap_rev_iter_done( _cur ) ) {
2269 18 : fd_pack_ord_txn_t * cur = treap_rev_iter_ele( _cur, pool );
2270 18 : ulong this_bundle_idx = RC_TO_REL_BUNDLE_IDX( cur->rewards, cur->compute_est );
2271 18 : if( FD_UNLIKELY( this_bundle_idx!=bundle_idx ) ) break;
2272 :
2273 18 : if( FD_UNLIKELY( cur->compute_est>cu_limit ) ) {
2274 0 : doesnt_fit = 1;
2275 0 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_CU_LIMIT_IDX ]++;
2276 0 : break;
2277 0 : }
2278 18 : cu_limit -= cur->compute_est;
2279 :
2280 : /* Each transaction in a bundle turns into a microblock */
2281 18 : if( FD_UNLIKELY( microblock_limit==0UL ) ) {
2282 0 : doesnt_fit = 1;
2283 0 : FD_MCNT_INC( PACK, MICROBLOCK_PER_BLOCK_LIMIT, 1UL );
2284 0 : break;
2285 0 : }
2286 18 : microblock_limit--;
2287 :
2288 18 : if( FD_UNLIKELY( cur->txn->payload_sz+MICROBLOCK_DATA_OVERHEAD>byte_limit ) ) {
2289 0 : doesnt_fit = 1;
2290 0 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_BYTE_LIMIT_IDX ]++;
2291 0 : break;
2292 0 : }
2293 18 : byte_limit -= cur->txn->payload_sz + MICROBLOCK_DATA_OVERHEAD;
2294 :
2295 18 : if( FD_UNLIKELY( !FD_PACK_BITSET_INTERSECT4_EMPTY( pack->bitset_rw_in_use, pack->bitset_w_in_use, cur->w_bitset, cur->rw_bitset ) ) ) {
2296 0 : has_conflict = 1;
2297 0 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_FAST_PATH_IDX ]++;
2298 0 : break;
2299 0 : }
2300 :
2301 : /* Don't update the actual in-use bitset, because the transactions
2302 : in the bundle are allowed to conflict with each other. */
2303 18 : FD_PACK_BITSET_OR( bitset_rw_in_use, cur->rw_bitset );
2304 18 : FD_PACK_BITSET_OR( bitset_w_in_use, cur->w_bitset );
2305 :
2306 :
2307 18 : fd_txn_t const * txn = TXN(cur->txn);
2308 18 : fd_acct_addr_t const * accts = fd_txn_get_acct_addrs( txn, cur->txn->payload );
2309 18 : fd_acct_addr_t const * alt_adj = cur->txn_e->alt_accts - fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM );
2310 :
2311 : /* Check conflicts between this transaction's writable accounts and
2312 : current readers */
2313 18 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_WRITABLE );
2314 108 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
2315 :
2316 90 : fd_acct_addr_t acct = *ACCT_ITER_TO_PTR( iter );
2317 :
2318 90 : fd_pack_addr_use_t * in_bundle_temp = acct_uses_query( pack->bundle_temp_map, acct, null_use );
2319 90 : ulong current_cost = acct_uses_query( pack->writer_costs, acct, null_use )->total_cost;
2320 90 : ulong carried_cost = (ulong)in_bundle_temp->carried_cost;
2321 90 : if( FD_UNLIKELY( current_cost + carried_cost + cur->compute_est > pack->lim->max_write_cost_per_acct ) ) {
2322 0 : doesnt_fit = 1;
2323 0 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_WRITE_COST_IDX ]++;
2324 0 : break;
2325 0 : }
2326 :
2327 90 : if( FD_LIKELY( in_bundle_temp==null_use ) ) { /* Not in temp bundle table yet */
2328 30 : in_bundle_temp = acct_uses_insert( pack->bundle_temp_map, acct );
2329 30 : in_bundle_temp->_ = 0UL;
2330 30 : bundle_temp_inserted[ bundle_temp_inserted_cnt++ ] = in_bundle_temp;
2331 30 : }
2332 90 : in_bundle_temp->carried_cost += (uint)cur->compute_est; /* < 2^21, but >0 */
2333 90 : in_bundle_temp->ref_cnt++;
2334 90 : last_use_in_txn_cnt[ in_bundle_temp->last_use_in ]--;
2335 90 : in_bundle_temp->last_use_in = (ushort)(txn_cnt+1UL);
2336 90 : last_use_in_txn_cnt[ in_bundle_temp->last_use_in ]++;
2337 :
2338 90 : if( FD_UNLIKELY( acct_uses_query( pack->acct_in_use, acct, null_use )->in_use_by ) ) {
2339 0 : has_conflict = 1;
2340 0 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_SLOW_PATH_IDX ]++;
2341 0 : break;
2342 0 : }
2343 90 : }
2344 18 : if( has_conflict | doesnt_fit ) break;
2345 :
2346 : /* Check conflicts between this transaction's readonly accounts and
2347 : current writers */
2348 18 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_READONLY );
2349 126 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
2350 :
2351 108 : fd_acct_addr_t const * acct = ACCT_ITER_TO_PTR( iter );
2352 108 : if( fd_pack_unwritable_contains( acct ) ) continue; /* No need to track sysvars because they can't be writable */
2353 :
2354 54 : fd_pack_addr_use_t * in_bundle_temp = acct_uses_query( pack->bundle_temp_map, *acct, null_use );
2355 54 : if( FD_LIKELY( in_bundle_temp==null_use ) ) { /* Not in temp bundle table yet */
2356 18 : in_bundle_temp = acct_uses_insert( pack->bundle_temp_map, *acct );
2357 18 : in_bundle_temp->_ = 0UL;
2358 18 : bundle_temp_inserted[ bundle_temp_inserted_cnt++ ] = in_bundle_temp;
2359 18 : }
2360 54 : in_bundle_temp->ref_cnt++;
2361 54 : last_use_in_txn_cnt[ in_bundle_temp->last_use_in ]--;
2362 54 : in_bundle_temp->last_use_in = (ushort)(txn_cnt+1UL);
2363 54 : last_use_in_txn_cnt[ in_bundle_temp->last_use_in ]++;
2364 :
2365 54 : if( FD_UNLIKELY( acct_uses_query( pack->acct_in_use, *acct, null_use )->in_use_by & FD_PACK_IN_USE_WRITABLE ) ) {
2366 0 : has_conflict = 1;
2367 0 : pack->sched_results[ FD_METRICS_ENUM_PACK_TXN_SCHEDULE_V_SLOW_PATH_IDX ]++;
2368 0 : break;
2369 0 : }
2370 54 : }
2371 :
2372 18 : if( has_conflict | doesnt_fit ) break;
2373 :
2374 18 : txn_cnt++;
2375 18 : _cur = treap_rev_iter_next( _cur, pool );
2376 18 : }
2377 6 : int retval = fd_int_if( doesnt_fit, TRY_BUNDLE_DOES_NOT_FIT,
2378 6 : fd_int_if( has_conflict, TRY_BUNDLE_HAS_CONFLICTS, TRY_BUNDLE_SUCCESS( (int)txn_cnt ) ) );
2379 :
2380 6 : if( FD_UNLIKELY( retval<=0 ) ) {
2381 0 : for( ulong i=0UL; i<bundle_temp_inserted_cnt; i++ ) {
2382 0 : acct_uses_remove( pack->bundle_temp_map, bundle_temp_inserted[ bundle_temp_inserted_cnt-i-1UL ] );
2383 0 : }
2384 0 : FD_TEST( acct_uses_key_cnt( pack->bundle_temp_map )==0UL );
2385 :
2386 0 : if( FD_UNLIKELY( retval==TRY_BUNDLE_DOES_NOT_FIT ) ) {
2387 : /* Decrement the skip count for the bundle we just tried. */
2388 :
2389 0 : for( _cur=_txn0; !treap_rev_iter_done( _cur ); _cur=treap_rev_iter_next( _cur, pool ) ) {
2390 0 : fd_pack_ord_txn_t * cur = treap_rev_iter_ele( _cur, pool );
2391 0 : ulong this_bundle_idx = RC_TO_REL_BUNDLE_IDX( cur->rewards, cur->compute_est );
2392 0 : if( FD_UNLIKELY( this_bundle_idx!=bundle_idx ) ) break;
2393 :
2394 : /* See fd_pack_schedule_impl for this line */
2395 0 : cur->skip = (ushort)(1+fd_ushort_min( (ushort)(pack->compressed_slot_number-1),
2396 0 : (ushort)(fd_ushort_min( cur->skip, FD_PACK_SKIP_CNT )-2) ) );
2397 0 : }
2398 0 : }
2399 0 : return retval;
2400 0 : }
2401 :
2402 : /* This bundle passed validation, so now we'll take it! */
2403 6 : pack->outstanding_microblock_mask |= bank_tile_mask;
2404 :
2405 6 : treap_rev_iter_t _end = _cur;
2406 6 : treap_rev_iter_t _next;
2407 :
2408 : /* We'll carefully incrementally construct use_by_bank and
2409 : use_by_bank_txn based on the contents of bundle_temp and
2410 : last_use_in_txn_cnt. */
2411 6 : fd_pack_addr_use_t * use_by_bank = pack->use_by_bank [bank_tile];
2412 6 : ulong * use_by_bank_txn = pack->use_by_bank_txn[bank_tile];
2413 6 : ulong cum_sum = 0UL;
2414 24 : for( ulong k=0UL; k<txn_cnt; k++ ) { use_by_bank_txn[k] = cum_sum; cum_sum += last_use_in_txn_cnt[ k+1UL ]; }
2415 6 : pack->use_by_bank_cnt[bank_tile] = cum_sum;
2416 :
2417 :
2418 24 : for( _cur=_txn0; _cur!=_end; _cur=_next ) {
2419 18 : _next = treap_rev_iter_next( _cur, pool );
2420 :
2421 18 : fd_pack_ord_txn_t * cur = treap_rev_iter_ele( _cur, pool );
2422 18 : fd_txn_t const * txn = TXN(cur->txn);
2423 18 : fd_txn_p_t * out_txnp = out->txnp;
2424 18 : fd_memcpy( out_txnp->payload, cur->txn->payload, cur->txn->payload_sz );
2425 18 : fd_memcpy( TXN(out_txnp), txn, fd_txn_footprint( txn->instr_cnt, txn->addr_table_lookup_cnt ) );
2426 18 : out_txnp->payload_sz = cur->txn->payload_sz;
2427 18 : out_txnp->pack_cu.requested_exec_plus_acct_data_cus = cur->txn->pack_cu.requested_exec_plus_acct_data_cus;
2428 18 : out_txnp->pack_cu.non_execution_cus = cur->txn->pack_cu.non_execution_cus;
2429 18 : out_txnp->scheduler_arrival_time_nanos = cur->txn->scheduler_arrival_time_nanos;
2430 18 : out_txnp->source_tpu = cur->txn->source_tpu;
2431 18 : out_txnp->source_ipv4 = cur->txn->source_ipv4;
2432 18 : out_txnp->flags = cur->txn->flags;
2433 : /* Copy the ALT accounts from the source fd_txn_e_t */
2434 18 : ulong alt_acct_cnt = (ulong)txn->addr_table_adtl_cnt;
2435 18 : fd_memcpy( out->alt_accts, cur->txn_e->alt_accts, alt_acct_cnt * sizeof(fd_acct_addr_t) );
2436 18 : out++;
2437 :
2438 18 : pack->cumulative_block_cost += cur->compute_est;
2439 18 : pack->data_bytes_consumed += cur->txn->payload_sz + MICROBLOCK_DATA_OVERHEAD;
2440 18 : pack->microblock_cnt += 1UL;
2441 :
2442 18 : if( FD_UNLIKELY( cur->txn->flags & FD_TXN_P_FLAGS_DURABLE_NONCE ) ) noncemap_ele_remove_fast( pack->noncemap, cur, pack->pool );
2443 18 : sig2txn_ele_remove_fast( pack->signature_map, cur, pack->pool );
2444 :
2445 18 : cur->root = FD_ORD_TXN_ROOT_FREE;
2446 18 : expq_remove( pack->expiration_q, cur->expq_idx );
2447 18 : treap_idx_remove( pack->pending_bundles, _cur, pack->pool );
2448 18 : trp_pool_idx_release( pack->pool, _cur );
2449 18 : pack->pending_txn_cnt--;
2450 18 : }
2451 :
2452 :
2453 54 : for( ulong i=0UL; i<bundle_temp_inserted_cnt; i++ ) {
2454 : /* In order to clear bundle_temp_map with the typical trick, we need
2455 : to iterate through bundle_temp_inserted backwards. */
2456 48 : fd_pack_addr_use_t * addr_use = bundle_temp_inserted[ bundle_temp_inserted_cnt-i-1UL ];
2457 :
2458 48 : int any_writers = addr_use->carried_cost>0U; /* Did any transaction in this bundle write lock this account address? */
2459 :
2460 48 : if( FD_LIKELY( any_writers ) ) { /* UNLIKELY? */
2461 30 : fd_pack_addr_use_t * in_wcost_table = acct_uses_query( pack->writer_costs, addr_use->key, NULL );
2462 30 : if( !in_wcost_table ) {
2463 15 : in_wcost_table = acct_uses_insert( pack->writer_costs, addr_use->key );
2464 15 : in_wcost_table->total_cost = 0UL;
2465 15 : pack->written_list[ pack->written_list_cnt ] = in_wcost_table;
2466 15 : pack->written_list_cnt = fd_ulong_min( pack->written_list_cnt+1UL, pack->written_list_max-1UL );
2467 15 : }
2468 30 : in_wcost_table->total_cost += (ulong)addr_use->carried_cost;
2469 30 : }
2470 :
2471 : /* in_use_by must be set before releasing the bit reference */
2472 48 : fd_pack_addr_use_t * use = acct_uses_query( pack->acct_in_use, addr_use->key, NULL );
2473 48 : if( !use ) { use = acct_uses_insert( pack->acct_in_use, addr_use->key ); use->in_use_by = 0UL; }
2474 48 : use->in_use_by |= bank_tile_mask | fd_ulong_if( any_writers, FD_PACK_IN_USE_WRITABLE, 0UL );
2475 48 : use->in_use_by &= ~FD_PACK_IN_USE_BIT_CLEARED;
2476 :
2477 48 : use_by_bank[ use_by_bank_txn[ addr_use->last_use_in-1UL ]++ ] = *use;
2478 :
2479 192 : for( ulong k=0UL; k<(ulong)addr_use->ref_cnt; k++ ) {
2480 144 : release_result_t ret = release_bit_reference( pack, &(addr_use->key) );
2481 144 : FD_PACK_BITSET_CLEARN( bitset_rw_in_use, ret.clear_rw_bit );
2482 144 : FD_PACK_BITSET_CLEARN( bitset_w_in_use, ret.clear_w_bit );
2483 144 : }
2484 :
2485 48 : acct_uses_remove( pack->bundle_temp_map, addr_use );
2486 48 : }
2487 :
2488 6 : FD_PACK_BITSET_COPY( pack->bitset_rw_in_use, bitset_rw_in_use );
2489 6 : FD_PACK_BITSET_COPY( pack->bitset_w_in_use, bitset_w_in_use );
2490 :
2491 6 : if( FD_UNLIKELY( is_ib ) ) {
2492 0 : pack->initializer_bundle_state = FD_PACK_IB_STATE_PENDING;
2493 0 : }
2494 6 : return retval;
2495 6 : }
2496 :
2497 :
2498 : ulong
2499 : fd_pack_schedule_next_microblock( fd_pack_t * pack,
2500 : ulong total_cus,
2501 : float vote_fraction,
2502 : ulong bank_tile,
2503 : int schedule_flags,
2504 1593837 : fd_txn_e_t * out ) {
2505 :
2506 : /* TODO: Decide if these are exactly how we want to handle limits */
2507 1593837 : total_cus = fd_ulong_min( total_cus, pack->lim->max_cost_per_block - pack->cumulative_block_cost );
2508 1593837 : ulong vote_cus = fd_ulong_min( (ulong)((float)total_cus * vote_fraction),
2509 1593837 : pack->lim->max_vote_cost_per_block - pack->cumulative_vote_cost );
2510 1593837 : ulong vote_reserved_txns = fd_ulong_min( vote_cus/FD_PACK_SIMPLE_VOTE_COST,
2511 1593837 : (ulong)((float)pack->lim->max_txn_per_microblock * vote_fraction) );
2512 :
2513 :
2514 1593837 : if( FD_UNLIKELY( (pack->microblock_cnt>=pack->lim->max_microblocks_per_block) ) ) {
2515 0 : FD_MCNT_INC( PACK, MICROBLOCK_PER_BLOCK_LIMIT, 1UL );
2516 0 : return 0UL;
2517 0 : }
2518 1593837 : if( FD_UNLIKELY( pack->data_bytes_consumed+MICROBLOCK_DATA_OVERHEAD+FD_TXN_MIN_SERIALIZED_SZ>pack->lim->max_data_bytes_per_block) ) {
2519 0 : FD_MCNT_INC( PACK, DATA_PER_BLOCK_LIMIT, 1UL );
2520 0 : return 0UL;
2521 0 : }
2522 :
2523 1593837 : ulong * use_by_bank_txn = pack->use_by_bank_txn[ bank_tile ];
2524 :
2525 1593837 : ulong cu_limit = total_cus - vote_cus;
2526 1593837 : ulong txn_limit = pack->lim->max_txn_per_microblock - vote_reserved_txns;
2527 1593837 : ulong scheduled = 0UL;
2528 1593837 : ulong byte_limit = pack->lim->max_data_bytes_per_block - pack->data_bytes_consumed - MICROBLOCK_DATA_OVERHEAD;
2529 :
2530 1593837 : sched_return_t status = {0}, status1 = {0};
2531 :
2532 1593837 : if( FD_LIKELY( schedule_flags & FD_PACK_SCHEDULE_VOTE ) ) {
2533 : /* Schedule vote transactions */
2534 1593738 : status1= fd_pack_schedule_impl( pack, pack->pending_votes, vote_cus, vote_reserved_txns, byte_limit, bank_tile, pack->pending_votes_smallest, use_by_bank_txn, out+scheduled );
2535 :
2536 1593738 : scheduled += status1.txns_scheduled;
2537 1593738 : pack->cumulative_vote_cost += status1.cus_scheduled;
2538 1593738 : pack->cumulative_block_cost += status1.cus_scheduled;
2539 1593738 : pack->data_bytes_consumed += status1.bytes_scheduled;
2540 1593738 : byte_limit -= status1.bytes_scheduled;
2541 1593738 : use_by_bank_txn += status1.txns_scheduled;
2542 : /* Add any remaining CUs/txns to the non-vote limits */
2543 1593738 : txn_limit += vote_reserved_txns - status1.txns_scheduled;
2544 1593738 : cu_limit += vote_cus - status1.cus_scheduled;
2545 1593738 : }
2546 :
2547 : /* Bundle can't mix with votes, so only try to schedule a bundle if we
2548 : didn't get any votes. */
2549 1593837 : if( FD_UNLIKELY( !!(schedule_flags & FD_PACK_SCHEDULE_BUNDLE) & (status1.txns_scheduled==0UL) ) ) {
2550 1593684 : int bundle_result = fd_pack_try_schedule_bundle( pack, bank_tile, out );
2551 1593684 : if( FD_UNLIKELY( bundle_result>0 ) ) return (ulong)bundle_result;
2552 1593678 : if( FD_UNLIKELY( bundle_result==TRY_BUNDLE_HAS_CONFLICTS ) ) return 0UL;
2553 : /* in the NO_READY_BUNDLES or DOES_NOT_FIT case, we schedule like
2554 : normal. */
2555 : /* We have the early returns here because try_schedule_bundle does
2556 : the bookeeping internally, since the calculations are a bit
2557 : different in that case. */
2558 1593678 : }
2559 :
2560 :
2561 : /* Fill any remaining space with non-vote transactions */
2562 1593831 : if( FD_LIKELY( schedule_flags & FD_PACK_SCHEDULE_TXN ) ) {
2563 1593831 : status = fd_pack_schedule_impl( pack, pack->pending, cu_limit, txn_limit, byte_limit, bank_tile, pack->pending_smallest, use_by_bank_txn, out+scheduled );
2564 :
2565 1593831 : scheduled += status.txns_scheduled;
2566 1593831 : pack->cumulative_block_cost += status.cus_scheduled;
2567 1593831 : pack->data_bytes_consumed += status.bytes_scheduled;
2568 1593831 : }
2569 :
2570 1593831 : ulong nonempty = (ulong)(scheduled>0UL);
2571 1593831 : pack->microblock_cnt += nonempty;
2572 1593831 : pack->outstanding_microblock_mask |= nonempty << bank_tile;
2573 1593831 : pack->data_bytes_consumed += nonempty * MICROBLOCK_DATA_OVERHEAD;
2574 :
2575 : /* Update metrics counters */
2576 1593831 : fd_pack_metrics_write( pack );
2577 1593831 : FD_MGAUGE_SET( PACK, CUS_CONSUMED_IN_BLOCK, pack->cumulative_block_cost );
2578 :
2579 1593831 : fd_histf_sample( pack->txn_per_microblock, scheduled );
2580 1593831 : fd_histf_sample( pack->vote_per_microblock, status1.txns_scheduled );
2581 :
2582 531277 : #if FD_HAS_AVX512 && FD_PACK_USE_NON_TEMPORAL_MEMCPY
2583 531277 : _mm_sfence();
2584 531277 : #endif
2585 :
2586 1593831 : return scheduled;
2587 1593837 : }
2588 :
2589 274398 : ulong fd_pack_bank_tile_cnt ( fd_pack_t const * pack ) { return pack->bank_tile_cnt; }
2590 0 : ulong fd_pack_current_block_cost( fd_pack_t const * pack ) { return pack->cumulative_block_cost; }
2591 :
2592 :
2593 : void
2594 0 : fd_pack_set_block_limits( fd_pack_t * pack, fd_pack_limits_t const * limits ) {
2595 0 : FD_TEST( limits->max_cost_per_block >= FD_PACK_MAX_COST_PER_BLOCK_LOWER_BOUND );
2596 0 : FD_TEST( limits->max_vote_cost_per_block >= FD_PACK_MAX_VOTE_COST_PER_BLOCK_LOWER_BOUND );
2597 0 : FD_TEST( limits->max_write_cost_per_acct >= FD_PACK_MAX_WRITE_COST_PER_ACCT_LOWER_BOUND );
2598 :
2599 0 : pack->lim->max_microblocks_per_block = limits->max_microblocks_per_block;
2600 0 : pack->lim->max_data_bytes_per_block = limits->max_data_bytes_per_block;
2601 0 : pack->lim->max_cost_per_block = limits->max_cost_per_block;
2602 0 : pack->lim->max_vote_cost_per_block = limits->max_vote_cost_per_block;
2603 0 : pack->lim->max_write_cost_per_acct = limits->max_write_cost_per_acct;
2604 0 : }
2605 :
2606 : void
2607 0 : fd_pack_get_block_limits( fd_pack_t * pack, fd_pack_limits_usage_t * opt_limits_usage, fd_pack_limits_t * opt_limits ) {
2608 0 : if( FD_LIKELY( opt_limits_usage ) ) {
2609 0 : opt_limits_usage->block_cost = pack->cumulative_block_cost;
2610 0 : opt_limits_usage->vote_cost = pack->cumulative_vote_cost;
2611 0 : opt_limits_usage->block_data_bytes = pack->data_bytes_consumed;
2612 0 : opt_limits_usage->microblocks = pack->microblock_cnt;
2613 0 : }
2614 0 : if( FD_LIKELY( opt_limits ) ) fd_memcpy( opt_limits, pack->lim, sizeof(fd_pack_limits_t) );
2615 0 : }
2616 :
2617 : void
2618 0 : fd_pack_get_top_writers( fd_pack_t const * pack, fd_pack_addr_use_t top_writers[static FD_PACK_TOP_WRITERS_CNT] ) {
2619 0 : fd_memcpy( top_writers, pack->top_writers, sizeof(pack->top_writers) );
2620 0 : }
2621 :
2622 : void
2623 0 : fd_pack_get_pending_smallest( fd_pack_t * pack, fd_pack_smallest_t * opt_pending_smallest, fd_pack_smallest_t * opt_votes_smallest ) {
2624 0 : if( FD_LIKELY( opt_pending_smallest ) ) fd_memcpy( opt_pending_smallest, pack->pending_smallest, sizeof(fd_pack_smallest_t) );
2625 0 : if( FD_LIKELY( opt_votes_smallest ) ) fd_memcpy( opt_votes_smallest, pack->pending_votes_smallest, sizeof(fd_pack_smallest_t) );
2626 0 : }
2627 :
2628 : void
2629 : fd_pack_rebate_cus( fd_pack_t * pack,
2630 6 : fd_pack_rebate_t const * rebate ) {
2631 6 : if( FD_UNLIKELY( (rebate->ib_result!=0) & (pack->initializer_bundle_state==FD_PACK_IB_STATE_PENDING ) ) ) {
2632 0 : pack->initializer_bundle_state = fd_int_if( rebate->ib_result==1, FD_PACK_IB_STATE_READY, FD_PACK_IB_STATE_FAILED );
2633 0 : }
2634 :
2635 6 : pack->cumulative_block_cost -= rebate->total_cost_rebate;
2636 6 : pack->cumulative_vote_cost -= rebate->vote_cost_rebate;
2637 6 : pack->data_bytes_consumed -= rebate->data_bytes_rebate;
2638 6 : pack->cumulative_rebated_cus += rebate->total_cost_rebate;
2639 : /* For now, we want to ignore the microblock count rebate. There are
2640 : 3 places the microblock count is kept (here, in the pack tile, and
2641 : in the PoH tile), and they all need to count microblocks that end
2642 : up being empty in the same way. It would be better from a
2643 : DoS-resistance perspective for them all not to count empty
2644 : microblocks towards the total, but there's a race condition:
2645 : suppose pack schedules a microblock containing one transaction that
2646 : doesn't land on chain, the slot ends, and then pack informs PoH of
2647 : the number of microblocks before the final rebate comes through.
2648 : This isn't unsolvable, but it's pretty gross, so it's probably
2649 : better to just not apply the rebate for now. */
2650 6 : (void)rebate->microblock_cnt_rebate;
2651 :
2652 6 : fd_pack_addr_use_t * writer_costs = pack->writer_costs;
2653 18 : for( ulong i=0UL; i<rebate->writer_cnt; i++ ) {
2654 12 : fd_pack_addr_use_t * in_wcost_table = acct_uses_query( writer_costs, rebate->writer_rebates[i].key, NULL );
2655 12 : if( FD_UNLIKELY( !in_wcost_table ) ) FD_LOG_ERR(( "Rebate to unknown written account" ));
2656 12 : in_wcost_table->total_cost -= rebate->writer_rebates[i].rebate_cus;
2657 : /* Important: Even if this is 0, don't delete it from the table so
2658 : that the insert order doesn't get messed up. */
2659 12 : }
2660 6 : }
2661 :
2662 :
2663 : ulong
2664 : fd_pack_expire_before( fd_pack_t * pack,
2665 15 : ulong expire_before ) {
2666 15 : expire_before = fd_ulong_max( expire_before, pack->expire_before );
2667 15 : ulong deleted_cnt = 0UL;
2668 15 : fd_pack_expq_t * prq = pack->expiration_q;
2669 327 : while( (expq_cnt( prq )>0UL) & (prq->expires_at<expire_before) ) {
2670 312 : fd_pack_ord_txn_t * expired = prq->txn;
2671 :
2672 : /* fd_pack_delete_transaction also removes it from the heap */
2673 : /* All the transactions in the same bundle have the same expiration
2674 : time, so this loop will end up deleting them all, even with
2675 : delete_full_bundle set to 0. */
2676 312 : ulong _delete_cnt = delete_transaction( pack, expired, 0, 1 );
2677 312 : deleted_cnt += _delete_cnt;
2678 312 : FD_TEST( _delete_cnt );
2679 312 : }
2680 :
2681 15 : pack->expire_before = expire_before;
2682 15 : return deleted_cnt;
2683 15 : }
2684 :
2685 : void
2686 2646 : fd_pack_end_block( fd_pack_t * pack ) {
2687 : /* rounded division */
2688 2646 : ulong pct_cus_per_block = (pack->cumulative_block_cost*100UL + (pack->lim->max_cost_per_block>>1))/pack->lim->max_cost_per_block;
2689 2646 : fd_histf_sample( pack->pct_cus_per_block, pct_cus_per_block );
2690 2646 : fd_histf_sample( pack->net_cus_per_block, pack->cumulative_block_cost );
2691 2646 : fd_histf_sample( pack->rebated_cus_per_block, pack->cumulative_rebated_cus );
2692 2646 : fd_histf_sample( pack->scheduled_cus_per_block, pack->cumulative_rebated_cus + pack->cumulative_block_cost );
2693 :
2694 2646 : pack->microblock_cnt = 0UL;
2695 2646 : pack->data_bytes_consumed = 0UL;
2696 2646 : pack->cumulative_block_cost = 0UL;
2697 2646 : pack->cumulative_vote_cost = 0UL;
2698 2646 : pack->cumulative_rebated_cus = 0UL;
2699 2646 : pack->outstanding_microblock_mask = 0UL;
2700 :
2701 2646 : pack->initializer_bundle_state = FD_PACK_IB_STATE_NOT_INITIALIZED;
2702 :
2703 2646 : acct_uses_clear( pack->acct_in_use );
2704 2646 : memset( pack->top_writers, 0, sizeof(pack->top_writers) );
2705 :
2706 2646 : if( FD_LIKELY( pack->written_list_cnt<pack->written_list_max-1UL ) ) {
2707 : /* The less dangerous way of doing this is to instead record the
2708 : keys we inserted and do a query followed by a delete for each
2709 : key. The downside of that is that keys are 32 bytes and a
2710 : pointer is only 8 bytes, plus the computational cost for the
2711 : query.
2712 :
2713 : However, if we're careful, we can pull this off. We require two
2714 : things. First, we started from an empty map and did nothing but
2715 : insert and update. In particular, no deletions. Second, we have
2716 : to be careful to delete in the opposite order that we inserted.
2717 : This is essentially like unwinding the inserts we did. The
2718 : common case is that the element after the one we delete will be
2719 : empty, so we'll hit that case. It's possible that there's
2720 : another independent probe sequence that will be entirely intact
2721 : starting in the element after, but we'll never hit the MAP_MOVE
2722 : case. */
2723 776451 : for( ulong i=0UL; i<pack->written_list_cnt; i++ ) {
2724 773805 : fd_pack_addr_use_t * writer = pack->written_list[ pack->written_list_cnt - 1UL - i ];
2725 : /* build a small max heap with the top writer costs */
2726 773805 : if( FD_UNLIKELY( !fd_pack_unwritable_contains( &writer->key ) && !FD_PACK_TOP_WRITERS_SORT_BEFORE( pack->top_writers[ FD_PACK_TOP_WRITERS_CNT-1UL ], (*writer) ) ) ) {
2727 773775 : pack->top_writers[ FD_PACK_TOP_WRITERS_CNT-1UL ] = *writer;
2728 773775 : fd_pack_writer_cost_sort_insert( pack->top_writers, FD_PACK_TOP_WRITERS_CNT );
2729 773775 : }
2730 :
2731 : /* Clearing the cost field here is unnecessary (since it gets
2732 : cleared on insert), but makes debugging a bit easier. */
2733 773805 : writer->total_cost = 0UL;
2734 773805 : acct_uses_remove( pack->writer_costs, writer );
2735 773805 : }
2736 2646 : } else {
2737 0 : acct_uses_clear( pack->writer_costs );
2738 0 : }
2739 2646 : pack->written_list_cnt = 0UL;
2740 :
2741 : /* compressed_slot_number is > FD_PACK_SKIP_CNT, which means +1 is the
2742 : max unless it overflows. */
2743 2646 : pack->compressed_slot_number = fd_ushort_max( (ushort)(pack->compressed_slot_number+1), (ushort)(FD_PACK_SKIP_CNT+1) );
2744 :
2745 2646 : FD_PACK_BITSET_CLEAR( pack->bitset_rw_in_use );
2746 2646 : FD_PACK_BITSET_CLEAR( pack->bitset_w_in_use );
2747 :
2748 9234 : for( ulong i=0UL; i<pack->bank_tile_cnt; i++ ) pack->use_by_bank_cnt[i] = 0UL;
2749 :
2750 : /* If our stake is low and we don't become leader often, end_block
2751 : might get called on the order of O(1/hr), which feels too
2752 : infrequent to do anything related to metrics. However, we only
2753 : update the histograms when we are leader, so this is actually a
2754 : good place to copy them. */
2755 2646 : FD_MHIST_COPY( PACK, TOTAL_TRANSACTIONS_PER_MICROBLOCK_COUNT, pack->txn_per_microblock );
2756 2646 : FD_MHIST_COPY( PACK, VOTES_PER_MICROBLOCK_COUNT, pack->vote_per_microblock );
2757 :
2758 2646 : FD_MGAUGE_SET( PACK, CUS_CONSUMED_IN_BLOCK, 0UL );
2759 2646 : FD_MHIST_COPY( PACK, CUS_SCHEDULED, pack->scheduled_cus_per_block );
2760 2646 : FD_MHIST_COPY( PACK, CUS_REBATED, pack->rebated_cus_per_block );
2761 2646 : FD_MHIST_COPY( PACK, CUS_NET, pack->net_cus_per_block );
2762 2646 : FD_MHIST_COPY( PACK, CUS_PCT, pack->pct_cus_per_block );
2763 2646 : }
2764 :
2765 : static void
2766 : release_tree( treap_t * treap,
2767 : sig2txn_t * signature_map,
2768 : noncemap_t * noncemap,
2769 9 : fd_pack_ord_txn_t * pool ) {
2770 9 : treap_fwd_iter_t next;
2771 18 : for( treap_fwd_iter_t it=treap_fwd_iter_init( treap, pool ); !treap_fwd_iter_done( it ); it=next ) {
2772 9 : next = treap_fwd_iter_next( it, pool );
2773 9 : ulong idx = treap_fwd_iter_idx( it );
2774 9 : pool[ idx ].root = FD_ORD_TXN_ROOT_FREE;
2775 9 : treap_idx_remove ( treap, idx, pool );
2776 9 : sig2txn_idx_remove_fast( signature_map, idx, pool );
2777 9 : trp_pool_idx_release ( pool, idx );
2778 9 : if( pool[ idx ].txn->flags & FD_TXN_P_FLAGS_DURABLE_NONCE ) {
2779 9 : noncemap_idx_remove_fast( noncemap, idx, pool );
2780 9 : }
2781 9 : }
2782 9 : }
2783 :
2784 : void
2785 3 : fd_pack_clear_all( fd_pack_t * pack ) {
2786 3 : pack->pending_txn_cnt = 0UL;
2787 3 : pack->microblock_cnt = 0UL;
2788 3 : pack->cumulative_block_cost = 0UL;
2789 3 : pack->cumulative_vote_cost = 0UL;
2790 3 : pack->cumulative_rebated_cus = 0UL;
2791 :
2792 3 : pack->pending_smallest->cus = ULONG_MAX;
2793 3 : pack->pending_smallest->bytes = ULONG_MAX;
2794 3 : pack->pending_votes_smallest->cus = ULONG_MAX;
2795 3 : pack->pending_votes_smallest->bytes = ULONG_MAX;
2796 :
2797 3 : release_tree( pack->pending, pack->signature_map, pack->noncemap, pack->pool );
2798 3 : release_tree( pack->pending_votes, pack->signature_map, pack->noncemap, pack->pool );
2799 3 : release_tree( pack->pending_bundles, pack->signature_map, pack->noncemap, pack->pool );
2800 :
2801 3 : ulong const pool_max = trp_pool_max( pack->pool );
2802 132 : for( ulong i=0UL; i<pool_max; i++ ) {
2803 129 : if( FD_UNLIKELY( pack->pool[ i ].root!=FD_ORD_TXN_ROOT_FREE ) ) {
2804 0 : fd_pack_ord_txn_t * const del = pack->pool + i;
2805 0 : fd_txn_t * txn = TXN( del->txn );
2806 0 : fd_acct_addr_t const * accts = fd_txn_get_acct_addrs( txn, del->txn->payload );
2807 0 : fd_acct_addr_t const * alt_adj = del->txn_e->alt_accts - fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM );
2808 0 : fd_acct_addr_t penalty_acct = *ACCT_IDX_TO_PTR( FD_ORD_TXN_ROOT_PENALTY_ACCT_IDX( del->root ) );
2809 0 : fd_pack_penalty_treap_t * penalty_treap = penalty_map_query( pack->penalty_treaps, penalty_acct, NULL );
2810 0 : FD_TEST( penalty_treap );
2811 0 : release_tree( penalty_treap->penalty_treap, pack->signature_map, pack->noncemap, pack->pool );
2812 0 : }
2813 129 : }
2814 :
2815 3 : pack->compressed_slot_number = (ushort)(FD_PACK_SKIP_CNT+1);
2816 :
2817 3 : expq_remove_all( pack->expiration_q );
2818 :
2819 3 : acct_uses_clear( pack->acct_in_use );
2820 3 : acct_uses_clear( pack->writer_costs );
2821 :
2822 3 : penalty_map_clear( pack->penalty_treaps );
2823 :
2824 3 : FD_PACK_BITSET_CLEAR( pack->bitset_rw_in_use );
2825 3 : FD_PACK_BITSET_CLEAR( pack->bitset_w_in_use );
2826 3 : bitset_map_clear( pack->acct_to_bitset );
2827 3 : pack->bitset_avail[ 0 ] = FD_PACK_BITSET_SLOWPATH;
2828 1027 : for( ulong i=0UL; i<FD_PACK_BITSET_MAX; i++ ) pack->bitset_avail[ i+1UL ] = (ushort)i;
2829 3 : pack->bitset_avail_cnt = FD_PACK_BITSET_MAX;
2830 :
2831 6 : for( ulong i=0UL; i<pack->bank_tile_cnt; i++ ) pack->use_by_bank_cnt[i] = 0UL;
2832 3 : }
2833 :
2834 :
2835 : /* If delete_full_bundle is non-zero and the transaction to delete is
2836 : part of a bundle, the rest of the bundle it is part of will be
2837 : deleted as well.
2838 : If move_from_penalty_treap is non-zero and the transaction to delete
2839 : is in the pending treap, move the best transaction in any of the
2840 : conflicting penalty treaps to the pending treap (if there is one). */
2841 : static ulong
2842 : delete_transaction( fd_pack_t * pack,
2843 : fd_pack_ord_txn_t * containing,
2844 : int delete_full_bundle,
2845 495471 : int move_from_penalty_treap ) {
2846 :
2847 495471 : fd_txn_t * txn = TXN( containing->txn );
2848 495471 : fd_acct_addr_t const * accts = fd_txn_get_acct_addrs( txn, containing->txn->payload );
2849 495471 : fd_acct_addr_t const * alt_adj = containing->txn_e->alt_accts - fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM );
2850 :
2851 495471 : treap_t * root = NULL;
2852 495471 : int root_idx = containing->root;
2853 495471 : fd_pack_penalty_treap_t * penalty_treap = NULL;
2854 495471 : switch( root_idx & FD_ORD_TXN_ROOT_TAG_MASK ) {
2855 0 : case FD_ORD_TXN_ROOT_FREE: FD_LOG_CRIT(( "Double free detected" ));
2856 492291 : case FD_ORD_TXN_ROOT_PENDING: root = pack->pending; break;
2857 0 : case FD_ORD_TXN_ROOT_PENDING_VOTE: root = pack->pending_votes; break;
2858 519 : case FD_ORD_TXN_ROOT_PENDING_BUNDLE: root = pack->pending_bundles; break;
2859 2661 : case FD_ORD_TXN_ROOT_PENALTY( 0 ): {
2860 2661 : fd_acct_addr_t penalty_acct = *ACCT_IDX_TO_PTR( FD_ORD_TXN_ROOT_PENALTY_ACCT_IDX( root_idx ) );
2861 2661 : penalty_treap = penalty_map_query( pack->penalty_treaps, penalty_acct, NULL );
2862 2661 : FD_TEST( penalty_treap );
2863 2661 : root = penalty_treap->penalty_treap;
2864 2661 : break;
2865 2661 : }
2866 495471 : }
2867 :
2868 495471 : ulong delete_cnt = 0UL;
2869 495471 : if( FD_UNLIKELY( delete_full_bundle & (root==pack->pending_bundles) ) ) {
2870 : /* When we delete, the structure of the treap may move around, but
2871 : pointers to inside the pool will remain valid */
2872 123 : fd_pack_ord_txn_t * bundle_ptrs[ FD_PACK_MAX_TXN_PER_BUNDLE-1UL ];
2873 123 : fd_pack_ord_txn_t * pool = pack->pool;
2874 123 : ulong cnt = 0UL;
2875 123 : ulong bundle_idx = RC_TO_REL_BUNDLE_IDX( containing->rewards, containing->compute_est );
2876 :
2877 : /* Iterate in both directions from the current transaction */
2878 123 : for( treap_fwd_iter_t _cur=treap_fwd_iter_next( (treap_fwd_iter_t)treap_idx_fast( containing, pool ), pool );
2879 426 : !treap_fwd_iter_done( _cur ); _cur=treap_fwd_iter_next( _cur, pool ) ) {
2880 303 : fd_pack_ord_txn_t * cur = treap_fwd_iter_ele( _cur, pool );
2881 303 : if( FD_LIKELY( bundle_idx==RC_TO_REL_BUNDLE_IDX( cur->rewards, cur->compute_est ) ) ) {
2882 303 : bundle_ptrs[ cnt++ ] = cur;
2883 303 : } else {
2884 0 : break;
2885 0 : }
2886 303 : FD_TEST( cnt<FD_PACK_MAX_TXN_PER_BUNDLE );
2887 303 : }
2888 :
2889 123 : for( treap_rev_iter_t _cur=treap_rev_iter_next( (treap_rev_iter_t)treap_idx_fast( containing, pool ), pool );
2890 216 : !treap_rev_iter_done( _cur ); _cur=treap_rev_iter_next( _cur, pool ) ) {
2891 93 : fd_pack_ord_txn_t * cur = treap_rev_iter_ele( _cur, pool );
2892 93 : if( FD_LIKELY( bundle_idx==RC_TO_REL_BUNDLE_IDX( cur->rewards, cur->compute_est ) ) ) {
2893 93 : bundle_ptrs[ cnt++ ] = cur;
2894 93 : } else {
2895 0 : break;
2896 0 : }
2897 93 : FD_TEST( cnt<FD_PACK_MAX_TXN_PER_BUNDLE );
2898 93 : }
2899 :
2900 : /* Delete them each, setting delete_full_bundle to 0 to avoid
2901 : infinite recursion. */
2902 519 : for( ulong k=0UL; k<cnt; k++ ) delete_cnt += delete_transaction( pack, bundle_ptrs[ k ], 0, 0 );
2903 123 : }
2904 :
2905 :
2906 495471 : if( FD_UNLIKELY( move_from_penalty_treap & (root==pack->pending) ) ) {
2907 :
2908 492285 : fd_pack_ord_txn_t * best = NULL;
2909 492285 : fd_pack_penalty_treap_t * best_penalty = NULL;
2910 :
2911 492285 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_WRITABLE );
2912 986394 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
2913 494109 : fd_pack_penalty_treap_t * p_trp = penalty_map_query( pack->penalty_treaps, *ACCT_ITER_TO_PTR( iter ), NULL );
2914 494109 : if( FD_UNLIKELY( p_trp ) ) {
2915 1289 : fd_pack_ord_txn_t * best_in_trp = treap_rev_iter_ele( treap_rev_iter_init( p_trp->penalty_treap, pack->pool ), pack->pool );
2916 1289 : if( FD_UNLIKELY( !best || COMPARE_WORSE( best, best_in_trp ) ) ) {
2917 672 : best = best_in_trp;
2918 672 : best_penalty = p_trp;
2919 672 : }
2920 1289 : }
2921 494109 : }
2922 :
2923 492285 : if( FD_LIKELY( best ) ) {
2924 : /* move best to the main treap */
2925 672 : treap_ele_remove( best_penalty->penalty_treap, best, pack->pool );
2926 672 : best->root = FD_ORD_TXN_ROOT_PENDING;
2927 672 : treap_ele_insert( pack->pending, best, pack->pool );
2928 :
2929 672 : pack->pending_smallest->cus = fd_ulong_min( pack->pending_smallest->cus, best->compute_est );
2930 672 : pack->pending_smallest->bytes = fd_ulong_min( pack->pending_smallest->bytes, best->txn_e->txnp->payload_sz );
2931 :
2932 672 : if( FD_UNLIKELY( !treap_ele_cnt( best_penalty->penalty_treap ) ) ) {
2933 9 : treap_delete( treap_leave( best_penalty->penalty_treap ) );
2934 9 : penalty_map_remove( pack->penalty_treaps, best_penalty );
2935 9 : }
2936 672 : }
2937 492285 : }
2938 :
2939 495471 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_ALL );
2940 2004108 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
2941 1508637 : if( FD_UNLIKELY( fd_pack_unwritable_contains( ACCT_ITER_TO_PTR( iter ) ) ) ) continue;
2942 :
2943 1012098 : release_result_t ret = release_bit_reference( pack, ACCT_ITER_TO_PTR( iter ) );
2944 1012098 : FD_PACK_BITSET_CLEARN( pack->bitset_rw_in_use, ret.clear_rw_bit );
2945 1012098 : FD_PACK_BITSET_CLEARN( pack->bitset_w_in_use, ret.clear_w_bit );
2946 1012098 : }
2947 :
2948 495471 : if( FD_UNLIKELY( containing->txn->flags & FD_TXN_P_FLAGS_DURABLE_NONCE ) ) {
2949 261 : noncemap_ele_remove_fast( pack->noncemap, containing, pack->pool );
2950 261 : }
2951 495471 : expq_remove( pack->expiration_q, containing->expq_idx );
2952 495471 : containing->root = FD_ORD_TXN_ROOT_FREE;
2953 495471 : treap_ele_remove( root, containing, pack->pool );
2954 495471 : sig2txn_ele_remove_fast( pack->signature_map, containing, pack->pool );
2955 495471 : trp_pool_ele_release( pack->pool, containing );
2956 :
2957 495471 : delete_cnt += 1UL;
2958 495471 : pack->pending_txn_cnt--;
2959 :
2960 495471 : if( FD_UNLIKELY( penalty_treap && treap_ele_cnt( root )==0UL ) ) {
2961 0 : penalty_map_remove( pack->penalty_treaps, penalty_treap );
2962 0 : }
2963 :
2964 495471 : return delete_cnt;
2965 495471 : }
2966 :
2967 : ulong
2968 : fd_pack_delete_transaction( fd_pack_t * pack,
2969 180 : fd_ed25519_sig_t const * sig0 ) {
2970 180 : ulong cnt = 0;
2971 180 : ulong next = ULONG_MAX;
2972 180 : for( ulong idx = sig2txn_idx_query_const( pack->signature_map, (wrapped_sig_t const *)sig0, ULONG_MAX, pack->pool );
2973 336 : idx!=ULONG_MAX; idx=next ) {
2974 : /* Iterating while deleting, not just this element, but perhaps the
2975 : whole bundle, feels a bit dangerous, but is actually fine because
2976 : a bundle can't contain two transactions with the same signature.
2977 : That means we know next is not part of the same bundle as idx,
2978 : which means that deleting idx will not delete next. */
2979 156 : next = sig2txn_idx_next_const( idx, ULONG_MAX, pack->pool );
2980 156 : cnt += delete_transaction( pack, pack->pool+idx, 1, 1 );
2981 156 : }
2982 :
2983 180 : return cnt;
2984 180 : }
2985 :
2986 :
2987 : int
2988 : fd_pack_verify( fd_pack_t * pack,
2989 438 : void * scratch ) {
2990 : /* Invariants:
2991 : sig2txn_query has exact same contents as all treaps combined
2992 : root matches treap
2993 : Keys of acct_to_bitset is exactly union of all accounts in all
2994 : transactions in treaps, with ref counted appropriately
2995 : bits in bitset_avail is complement of bits allocated in
2996 : acct_to_bitset
2997 : expires_at consistent between treap, prq
2998 : use_by_bank does not contain duplicates
2999 : use_by_bank consistent with acct_in_use
3000 : elements in pool but not in a treap have root set to free
3001 : all penalty treaps have at least one transaction
3002 : all elements in penalty treaps are in the one that the root indicates
3003 : */
3004 :
3005 : /* TODO:
3006 : bitset_{r}w_in_use = bitset_map_query( everything in acct_in_use that doesn't have FD_PACK_IN_USE_BIT_CLEARED )
3007 : bitset_w_in_use & bitset_rw_in_use == bitset_w_in_use
3008 : */
3009 316762 : #define VERIFY_TEST( cond, ... ) do { \
3010 316762 : if( FD_UNLIKELY( !(cond) ) ) { \
3011 0 : FD_LOG_WARNING(( __VA_ARGS__ )); \
3012 0 : return -(__LINE__); \
3013 0 : } \
3014 316762 : } while( 0 )
3015 :
3016 438 : ulong max_acct_in_treap = pack->pack_depth * FD_TXN_ACCT_ADDR_MAX;
3017 438 : int lg_acct_in_trp = fd_ulong_find_msb( fd_ulong_pow2_up( 2UL*max_acct_in_treap ) );
3018 438 : void * _bitset_map_copy = scratch;
3019 438 : void * _bitset_map_orig = bitset_map_leave( pack->acct_to_bitset );
3020 438 : fd_memcpy( _bitset_map_copy, _bitset_map_orig, bitset_map_footprint( lg_acct_in_trp ) );
3021 :
3022 438 : fd_pack_bitset_acct_mapping_t * bitset_copy = bitset_map_join( _bitset_map_copy );
3023 :
3024 : /* Check that each bit is in exactly one place */
3025 438 : FD_PACK_BITSET_DECLARE( processed ); FD_PACK_BITSET_CLEAR( processed );
3026 438 : FD_PACK_BITSET_DECLARE( bit ); FD_PACK_BITSET_CLEAR( bit );
3027 438 : FD_PACK_BITSET_DECLARE( full ); FD_PACK_BITSET_CLEAR( full );
3028 :
3029 438 : if( FD_UNLIKELY( pack->bitset_avail[0]!=FD_PACK_BITSET_SLOWPATH ) ) return -1;
3030 149264 : for( ulong i=1UL; i<=pack->bitset_avail_cnt; i++ ) {
3031 148826 : FD_PACK_BITSET_CLEAR( bit );
3032 148826 : FD_PACK_BITSET_SETN( bit, pack->bitset_avail[ i ] );
3033 148826 : VERIFY_TEST( FD_PACK_BITSET_INTERSECT4_EMPTY( bit, bit, processed, processed ),
3034 148826 : "bit %hu in avail set twice", pack->bitset_avail[ i ] );
3035 148826 : FD_PACK_BITSET_OR( processed, bit );
3036 148826 : }
3037 :
3038 438 : ulong total_references = 0UL;
3039 1589281206 : for( ulong i=0UL; i<bitset_map_slot_cnt( bitset_copy ); i++ ) {
3040 1589280768 : if( !bitset_map_key_inval( bitset_copy[ i ].key ) ) {
3041 1080 : VERIFY_TEST( bitset_copy[ i ].ref_cnt>0UL, "account address in table with 0 ref count" );
3042 :
3043 1080 : total_references += bitset_copy[ i ].ref_cnt;
3044 :
3045 1080 : FD_PACK_BITSET_CLEAR( bit );
3046 1080 : FD_PACK_BITSET_SETN( bit, bitset_copy[ i ].bit );
3047 1080 : VERIFY_TEST( FD_PACK_BITSET_INTERSECT4_EMPTY( bit, bit, processed, processed ), "bit %hu used twice", bitset_copy[ i ].bit );
3048 1080 : FD_PACK_BITSET_OR( processed, bit );
3049 1080 : }
3050 1589280768 : }
3051 149942 : for( ulong i=0UL; i<FD_PACK_BITSET_MAX; i++ ) {
3052 149504 : FD_PACK_BITSET_CLEAR( bit );
3053 149504 : FD_PACK_BITSET_SETN( bit, i );
3054 149504 : VERIFY_TEST( !FD_PACK_BITSET_INTERSECT4_EMPTY( bit, bit, processed, processed ), "bit %lu missing", i );
3055 149504 : FD_PACK_BITSET_SETN( full, i );
3056 149504 : }
3057 :
3058 :
3059 438 : fd_pack_ord_txn_t * pool = pack->pool;
3060 438 : treap_t * treaps[ 3 ] = { pack->pending, pack->pending_votes, pack->pending_bundles };
3061 438 : ulong txn_cnt = 0UL;
3062 :
3063 24834264 : for( ulong k=0UL; k<3UL+penalty_map_slot_cnt( pack->penalty_treaps ); k++ ) {
3064 24833826 : treap_t * treap = NULL;
3065 :
3066 24833826 : if( k<3UL ) treap = treaps[ k ];
3067 24832512 : else if( FD_LIKELY( penalty_map_key_inval( pack->penalty_treaps[ k-3UL ].key ) ) ) continue;
3068 0 : else {
3069 0 : treap = pack->penalty_treaps[ k-3UL ].penalty_treap;
3070 0 : VERIFY_TEST( treap_ele_cnt( treap )>0UL, "empty penalty treap in map" );
3071 0 : }
3072 :
3073 1737 : for( treap_rev_iter_t _cur=treap_rev_iter_init( treap, pool ); !treap_rev_iter_done( _cur );
3074 1314 : _cur=treap_rev_iter_next( _cur, pool ) ) {
3075 423 : txn_cnt++;
3076 423 : fd_pack_ord_txn_t const * cur = treap_rev_iter_ele_const( _cur, pool );
3077 423 : fd_txn_t const * txn = TXN(cur->txn);
3078 423 : fd_acct_addr_t const * accts = fd_txn_get_acct_addrs( txn, cur->txn->payload );
3079 423 : fd_acct_addr_t const * alt_adj = cur->txn_e->alt_accts - fd_txn_account_cnt( txn, FD_TXN_ACCT_CAT_IMM );
3080 :
3081 423 : fd_ed25519_sig_t const * sig0 = fd_txn_get_signatures( txn, cur->txn->payload );
3082 :
3083 423 : fd_pack_ord_txn_t const * in_tbl = sig2txn_ele_query_const( pack->signature_map, (wrapped_sig_t const *)sig0, NULL, pool );
3084 423 : VERIFY_TEST( in_tbl, "signature missing from sig2txn" );
3085 :
3086 423 : VERIFY_TEST( (ulong)(cur->root & FD_ORD_TXN_ROOT_TAG_MASK)==fd_ulong_min( k, 3UL )+1UL, "treap element had bad root" );
3087 423 : if( FD_LIKELY( (cur->root & FD_ORD_TXN_ROOT_TAG_MASK)==FD_ORD_TXN_ROOT_PENALTY(0) ) ) {
3088 0 : fd_acct_addr_t const * penalty_acct = ACCT_IDX_TO_PTR( FD_ORD_TXN_ROOT_PENALTY_ACCT_IDX( cur->root ) );
3089 0 : VERIFY_TEST( !memcmp( penalty_acct, pack->penalty_treaps[ k-3UL ].key.b, 32UL ), "transaction in wrong penalty treap" );
3090 0 : }
3091 423 : VERIFY_TEST( cur->expires_at>=pack->expire_before, "treap element expired" );
3092 :
3093 423 : fd_pack_expq_t const * eq = pack->expiration_q + cur->expq_idx;
3094 423 : VERIFY_TEST( eq->txn==cur, "expq inconsistent" );
3095 423 : VERIFY_TEST( eq->expires_at==cur->expires_at, "expq expires_at inconsistent" );
3096 :
3097 423 : FD_PACK_BITSET_DECLARE( complement );
3098 423 : FD_PACK_BITSET_COPY( complement, full );
3099 423 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_WRITABLE );
3100 1413 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
3101 990 : fd_acct_addr_t acct = *ACCT_ITER_TO_PTR( iter );
3102 :
3103 990 : fd_pack_bitset_acct_mapping_t * q = bitset_map_query( bitset_copy, acct, NULL );
3104 990 : VERIFY_TEST( q, "account in transaction missing from bitset mapping" );
3105 990 : VERIFY_TEST( q->ref_cnt>0UL, "account in transaction ref_cnt already 0" );
3106 990 : q->ref_cnt--;
3107 990 : total_references--;
3108 :
3109 990 : FD_PACK_BITSET_CLEAR( bit );
3110 990 : FD_PACK_BITSET_SETN( bit, q->bit );
3111 990 : if( q->bit<FD_PACK_BITSET_MAX ) {
3112 597 : VERIFY_TEST( !FD_PACK_BITSET_INTERSECT4_EMPTY( bit, bit, cur->rw_bitset, cur->rw_bitset ), "missing from rw bitset" );
3113 597 : VERIFY_TEST( !FD_PACK_BITSET_INTERSECT4_EMPTY( bit, bit, cur->w_bitset, cur->w_bitset ), "missing from w bitset" );
3114 597 : }
3115 990 : FD_PACK_BITSET_CLEARN( complement, q->bit );
3116 990 : }
3117 423 : VERIFY_TEST( FD_PACK_BITSET_INTERSECT4_EMPTY( complement, complement, cur->w_bitset, cur->w_bitset ), "extra in w bitset" );
3118 :
3119 423 : for( fd_txn_acct_iter_t iter=fd_txn_acct_iter_init( txn, FD_TXN_ACCT_CAT_READONLY );
3120 1836 : iter!=fd_txn_acct_iter_end(); iter=fd_txn_acct_iter_next( iter ) ) {
3121 :
3122 1413 : fd_acct_addr_t acct = *ACCT_ITER_TO_PTR( iter );
3123 1413 : if( FD_UNLIKELY( fd_pack_unwritable_contains( &acct ) ) ) continue;
3124 888 : fd_pack_bitset_acct_mapping_t * q = bitset_map_query( bitset_copy, acct, NULL );
3125 888 : VERIFY_TEST( q, "account in transaction missing from bitset mapping" );
3126 888 : VERIFY_TEST( q->ref_cnt>0UL, "account in transaction ref_cnt already 0" );
3127 888 : q->ref_cnt--;
3128 888 : total_references--;
3129 :
3130 888 : FD_PACK_BITSET_CLEAR( bit );
3131 888 : FD_PACK_BITSET_SETN( bit, q->bit );
3132 888 : if( q->bit<FD_PACK_BITSET_MAX ) {
3133 879 : VERIFY_TEST( !FD_PACK_BITSET_INTERSECT4_EMPTY( bit, bit, cur->rw_bitset, cur->rw_bitset ), "missing from rw bitset" );
3134 879 : }
3135 888 : FD_PACK_BITSET_CLEARN( complement, q->bit );
3136 888 : }
3137 423 : VERIFY_TEST( FD_PACK_BITSET_INTERSECT4_EMPTY( complement, complement, cur->rw_bitset, cur->rw_bitset ), "extra in rw bitset" );
3138 423 : }
3139 1314 : }
3140 :
3141 438 : bitset_map_leave( bitset_copy );
3142 438 : VERIFY_TEST( txn_cnt==pack->pending_txn_cnt, "txn_cnt" );
3143 :
3144 438 : VERIFY_TEST( total_references==0UL, "extra references in bitset mapping" );
3145 438 : ulong sig2txn_key_cnt = 0UL;
3146 438 : for( sig2txn_iter_t iter = sig2txn_iter_init( pack->signature_map, pool );
3147 861 : !sig2txn_iter_done( iter, pack->signature_map, pool );
3148 438 : iter = sig2txn_iter_next( iter, pack->signature_map, pool ) ) {
3149 423 : sig2txn_key_cnt++;
3150 423 : }
3151 438 : VERIFY_TEST( txn_cnt==sig2txn_key_cnt, "extra signatures in sig2txn" );
3152 438 : VERIFY_TEST( !sig2txn_verify( pack->signature_map, trp_pool_max( pool ), pool ), "sig2txn corrupt" );
3153 :
3154 : /* Count noncemap keys */
3155 438 : ulong noncemap_key_cnt = 0UL;
3156 438 : for( noncemap_iter_t iter = noncemap_iter_init( pack->noncemap, pool );
3157 486 : !noncemap_iter_done( iter, pack->noncemap, pool );
3158 438 : iter = noncemap_iter_next( iter, pack->noncemap, pool ) ) {
3159 48 : noncemap_key_cnt++;
3160 : /* Ensure element is in pool */
3161 48 : fd_pack_ord_txn_t const * ord = noncemap_iter_ele_const( iter, pack->noncemap, pool );
3162 48 : VERIFY_TEST( ord->txn->flags & FD_TXN_P_FLAGS_DURABLE_NONCE, "invalid entry in noncemap" );
3163 :
3164 : /* Although pack allows multiple transactions with the same
3165 : signature in sig2txn (MAP_MULTI==1), the noncemap checks prevent
3166 : multiple nonce transactions with the same signature. */
3167 48 : wrapped_sig_t sig = FD_LOAD( wrapped_sig_t, fd_txn_get_signatures( TXN( ord->txn ), ord->txn->payload ) );
3168 48 : VERIFY_TEST( ord==sig2txn_ele_query_const( pack->signature_map, &sig, NULL, pool ), "noncemap and sig2txn desynced" );
3169 48 : }
3170 438 : VERIFY_TEST( txn_cnt>=noncemap_key_cnt, "phantom txns in noncemap" );
3171 438 : VERIFY_TEST( !noncemap_verify( pack->noncemap, trp_pool_max( pool ), pool ), "noncemap corrupt" );
3172 :
3173 438 : ulong slots_found = 0UL;
3174 438 : ulong const pool_max = trp_pool_max( pool );
3175 3890922 : for( ulong i=0UL; i<pool_max; i++ ) {
3176 3890484 : fd_pack_ord_txn_t * ord = pack->pool + i;
3177 3890484 : if( ord->root!=FD_ORD_TXN_ROOT_FREE ) slots_found++;
3178 3890484 : }
3179 438 : VERIFY_TEST( slots_found==txn_cnt, "phantom slots in pool" );
3180 :
3181 438 : bitset_map_join( _bitset_map_orig );
3182 :
3183 438 : int lg_uses_tbl_sz = acct_uses_lg_slot_cnt( pack->acct_in_use );
3184 :
3185 438 : void * _acct_in_use_copy = scratch;
3186 438 : void * _acct_in_use_orig = acct_uses_leave( pack->acct_in_use );
3187 438 : fd_memcpy( _acct_in_use_copy, _acct_in_use_orig, acct_uses_footprint( lg_uses_tbl_sz ) );
3188 :
3189 438 : fd_pack_addr_use_t * acct_in_use_copy = acct_uses_join( _acct_in_use_copy );
3190 :
3191 438 : FD_PACK_BITSET_DECLARE( w_complement );
3192 438 : FD_PACK_BITSET_DECLARE( rw_complement );
3193 438 : FD_PACK_BITSET_COPY( w_complement, full );
3194 438 : FD_PACK_BITSET_COPY( rw_complement, full );
3195 :
3196 438 : FD_PACK_BITSET_DECLARE( rw_bitset ); FD_PACK_BITSET_COPY( rw_bitset, pack->bitset_rw_in_use );
3197 438 : FD_PACK_BITSET_DECLARE( w_bitset ); FD_PACK_BITSET_COPY( w_bitset, pack->bitset_w_in_use );
3198 :
3199 :
3200 438 : ulong const EMPTY_MASK = ~(FD_PACK_IN_USE_WRITABLE | FD_PACK_IN_USE_BIT_CLEARED);
3201 :
3202 12255 : for( ulong bank=0UL; bank<pack->bank_tile_cnt; bank++ ) {
3203 :
3204 11817 : fd_pack_addr_use_t const * base = pack->use_by_bank[ bank ];
3205 11817 : ulong bank_mask = 1UL << bank;
3206 :
3207 12672 : for( ulong i=0UL; i<pack->use_by_bank_cnt[ bank ]; i++ ) {
3208 855 : fd_pack_addr_use_t * use = acct_uses_query( acct_in_use_copy, base[i].key, NULL );
3209 855 : VERIFY_TEST( use, "acct in use by bank not in acct_in_use, or in uses_by_bank twice" );
3210 :
3211 855 : VERIFY_TEST( use->in_use_by & bank_mask, "acct in uses_by_bank doesn't have corresponding bit set in acct_in_use, or it was in the list twice" );
3212 :
3213 855 : fd_pack_bitset_acct_mapping_t * q = bitset_map_query( pack->acct_to_bitset, base[i].key, NULL );
3214 : /* The normal case is that the acct->bit mapping is preserved
3215 : while in use by other transactions in the pending list. This
3216 : might not always happen though. It's okay for the mapping to
3217 : get deleted while the acct is in use, which is noted with
3218 : BIT_CLEARED. If that is set, the mapping may not exist, or it
3219 : may have been re-created, perhaps with a different bit. */
3220 855 : if( q==NULL ) VERIFY_TEST( use->in_use_by & FD_PACK_IN_USE_BIT_CLEARED, "acct in use not in acct_to_bitset, but not marked as cleared" );
3221 0 : else if( !(use->in_use_by & FD_PACK_IN_USE_BIT_CLEARED) ) {
3222 0 : FD_PACK_BITSET_CLEAR( bit );
3223 0 : FD_PACK_BITSET_SETN( bit, q->bit );
3224 0 : if( q->bit<FD_PACK_BITSET_MAX ) {
3225 0 : VERIFY_TEST( !FD_PACK_BITSET_INTERSECT4_EMPTY( bit, bit, rw_bitset, rw_bitset ), "missing from rw bitset" );
3226 0 : if( use->in_use_by & FD_PACK_IN_USE_WRITABLE ) {
3227 0 : VERIFY_TEST( !FD_PACK_BITSET_INTERSECT4_EMPTY( bit, bit, w_bitset, w_bitset ), "missing from w bitset" );
3228 0 : FD_PACK_BITSET_CLEARN( w_complement, q->bit );
3229 0 : }
3230 0 : }
3231 0 : FD_PACK_BITSET_CLEARN( rw_complement, q->bit );
3232 0 : }
3233 855 : if( use->in_use_by & FD_PACK_IN_USE_WRITABLE ) VERIFY_TEST( (use->in_use_by & EMPTY_MASK)==bank_mask, "writable, but in use by multiple" );
3234 :
3235 855 : use->in_use_by &= ~bank_mask;
3236 855 : if( !(use->in_use_by & EMPTY_MASK) ) acct_uses_remove( acct_in_use_copy, use );
3237 855 : }
3238 11817 : }
3239 438 : VERIFY_TEST( acct_uses_key_cnt( acct_in_use_copy )==0UL, "stray uses in acct_in_use" );
3240 438 : VERIFY_TEST( FD_PACK_BITSET_INTERSECT4_EMPTY( rw_complement, rw_complement, rw_bitset, rw_bitset ), "extra in rw bitset" );
3241 438 : VERIFY_TEST( FD_PACK_BITSET_INTERSECT4_EMPTY( w_complement, w_complement, w_bitset, w_bitset ), "extra in w bitset" );
3242 :
3243 438 : acct_uses_leave( acct_in_use_copy );
3244 :
3245 438 : acct_uses_join( _acct_in_use_orig );
3246 438 : return 0;
3247 438 : }
3248 :
3249 3 : void * fd_pack_leave ( fd_pack_t * pack ) { FD_COMPILER_MFENCE(); return (void *)pack; }
3250 3 : void * fd_pack_delete( void * mem ) { FD_COMPILER_MFENCE(); return mem; }
|