LCOV - code coverage report
Current view: top level - app/fddev/configure - genesis.c (source / functions) Hit Total Coverage
Test: cov.lcov Lines: 0 180 0.0 %
Date: 2025-01-08 12:08:44 Functions: 0 6 0.0 %

          Line data    Source code
       1             : #define _GNU_SOURCE
       2             : #define FD_SCRATCH_USE_HANDHOLDING 1
       3             : #include "../../fdctl/configure/configure.h"
       4             : 
       5             : #include <stdio.h>
       6             : #include <unistd.h>
       7             : #include <dirent.h>
       8             : #include <sys/stat.h>
       9             : #include <sys/wait.h>
      10             : 
      11             : #include "../../../ballet/poh/fd_poh.h"
      12             : #include "../../../disco/keyguard/fd_keyload.h"
      13             : #include "../../../flamenco/features/fd_features.h"
      14             : #include "../../../flamenco/genesis/fd_genesis_create.h"
      15             : #include "../../../flamenco/types/fd_types_custom.h"
      16             : #include "../../../flamenco/runtime/sysvar/fd_sysvar_clock.h"
      17             : #include "../genesis_hash.h"
      18             : 
      19             : #define NAME "genesis"
      20             : 
      21             : /* default_enable_features is a table of features enabled by default */
      22             : 
      23             : static void
      24           0 : default_enable_features( fd_features_t * features ) {
      25           0 :   features->index_erasure_conflict_duplicate_proofs = 0UL;
      26           0 :   features->curve25519_restrict_msm_length = 0UL;
      27           0 :   features->commission_updates_only_allowed_in_first_half_of_epoch = 0UL;
      28           0 :   features->validate_fee_collector_account = 0UL;
      29           0 :   features->incremental_snapshot_only_incremental_hash_calculation = 0UL;
      30           0 :   features->timely_vote_credits = 0UL;
      31           0 :   features->apply_cost_tracker_during_replay = 0UL;
      32           0 :   features->reject_callx_r10 = 1UL;
      33           0 :   features->update_hashes_per_tick = 0UL;
      34           0 :   features->enable_partitioned_epoch_reward = 0UL;
      35           0 :   features->pico_inflation = 0UL;
      36           0 :   features->remaining_compute_units_syscall_enabled = 0UL;
      37           0 :   features->simplify_writable_program_account_check = 0UL;
      38           0 :   features->enable_bpf_loader_set_authority_checked_ix = 0UL;
      39           0 :   features->consume_blockstore_duplicate_proofs = 0UL;
      40           0 :   features->disable_deploy_of_alloc_free_syscall = 0UL;
      41           0 :   features->disable_bpf_loader_instructions = 0UL;
      42           0 :   features->full_inflation_enable = 0UL;
      43           0 :   features->vote_state_add_vote_latency = 0UL;
      44           0 :   features->curve25519_syscall_enabled = 0UL;
      45           0 :   features->error_on_syscall_bpf_function_hash_collisions = 0UL;
      46           0 :   features->update_hashes_per_tick3 = 0UL;
      47           0 :   features->update_hashes_per_tick4 = 0UL;
      48           0 :   features->enable_bpf_loader_extend_program_ix = 0UL;
      49           0 :   features->enable_program_runtime_v2_and_loader_v4 = 0UL;
      50           0 :   features->increase_tx_account_lock_limit = 0UL;
      51           0 :   features->stake_raise_minimum_delegation_to_1_sol = 0UL;
      52           0 :   features->enable_alt_bn128_syscall = 0UL;
      53           0 :   features->revise_turbine_epoch_stakes = 0UL;
      54           0 :   features->clean_up_delegation_errors = 0UL;
      55           0 :   features->update_hashes_per_tick5 = 0UL;
      56           0 :   features->full_inflation_vote = 0UL;
      57           0 :   features->skip_rent_rewrites = 0UL;
      58           0 :   features->switch_to_new_elf_parser = 0UL;
      59           0 :   features->require_rent_exempt_split_destination = 0UL;
      60           0 :   features->enable_turbine_fanout_experiments = 0UL;
      61           0 :   features->devnet_and_testnet = 0UL;
      62           0 :   features->enable_big_mod_exp_syscall = 0UL;
      63           0 :   features->enable_alt_bn128_compression_syscall = 0UL;
      64           0 :   features->update_hashes_per_tick2 = 0UL;
      65           0 :   features->bpf_account_data_direct_mapping = 0UL;
      66           0 :   features->relax_authority_signer_check_for_lookup_table_creation = 0UL;
      67           0 :   features->update_hashes_per_tick6 = 0UL;
      68           0 :   features->enable_poseidon_syscall = 0UL;
      69           0 :   features->better_error_codes_for_tx_lamport_check = 0UL;
      70           0 :   features->stake_minimum_delegation_for_rewards = 0UL;
      71           0 :   features->loosen_cpi_size_restriction = 0UL;
      72           0 :   features->drop_legacy_shreds = 0UL;
      73           0 :   features->deprecate_rewards_sysvar = 0UL;
      74           0 :   features->warp_timestamp_again = 0UL;
      75           0 :   features->reduce_stake_warmup_cooldown = 0UL;
      76           0 :   features->disable_turbine_fanout_experiments = 0UL;
      77           0 :   features->blake3_syscall_enabled = 0UL;
      78           0 :   features->last_restart_slot_sysvar = 0UL;
      79           0 :   features->disable_fees_sysvar = 0UL;
      80           0 : }
      81             : 
      82             : /* estimate_hashes_per_tick approximates the PoH hashrate of the current
      83             :    tile.  Spins PoH hashing for estimate_dur_ns nanoseconds.  Returns
      84             :    the hashes per tick achieved, where tick_mhz is the target tick rate
      85             :    in ticks per microsecond (MHz).  Assumes that the estimate duration
      86             :    is larger than the tick duration. */
      87             : 
      88             : static ulong
      89             : estimate_hashes_per_tick( ulong tick_mhz,
      90           0 :                           ulong estimate_dur_ns ) {
      91           0 :   ulong const batch    = 1UL<<20;
      92           0 :   long const  deadline = fd_log_wallclock() + (long)estimate_dur_ns;
      93             : 
      94           0 :   uchar poh_hash[ 32 ] = {0};
      95           0 :   ulong          hash_cnt = 0UL;
      96           0 :   do {
      97           0 :     fd_poh_append( poh_hash, batch );
      98           0 :     hash_cnt += batch;
      99           0 :   } while( fd_log_wallclock() < deadline );
     100             : 
     101           0 :   double hash_cnt_dbl = (double)hash_cnt;
     102           0 :   double tick_cnt_dbl = (double)estimate_dur_ns / ( (double)tick_mhz * 1000.0 );
     103           0 :   if( tick_cnt_dbl < 1.0 ) return 0UL;
     104             : 
     105             :   /* Apply 50% factor to the maximum machine hash rate. */
     106           0 :   double hashes_per_tick = hash_cnt_dbl / tick_cnt_dbl / 2.0;
     107           0 :   return (ulong)hashes_per_tick;
     108           0 : }
     109             : 
     110             : 
     111             : /* Create a new genesis.bin file contents into the provided blob buffer
     112             :    and return the size of the buffer.  Will abort on error if the
     113             :    provided buffer is not large enough. */
     114             : 
     115             : static ulong
     116             : create_genesis( config_t * const config,
     117             :                 uchar *          blob,
     118           0 :                 ulong            blob_sz ) {
     119             : 
     120           0 :   fd_genesis_options_t options[1];
     121             : 
     122             :   /* Read in keys */
     123             : 
     124           0 :   uchar const * identity_pubkey_ = fd_keyload_load( config->consensus.identity_path, 1 );
     125           0 :   if( FD_UNLIKELY( !identity_pubkey_ ) ) FD_LOG_ERR(( "Failed to load identity key" ));
     126           0 :   memcpy( options->identity_pubkey.key, identity_pubkey_, 32 );
     127             : 
     128           0 :   char file_path[ PATH_MAX ];
     129           0 :   FD_TEST( fd_cstr_printf_check( file_path, PATH_MAX, NULL, "%s/faucet.json", config->scratch_directory ) );
     130           0 :   uchar const * faucet_pubkey_ = fd_keyload_load( file_path, 1 );
     131           0 :   if( FD_UNLIKELY( !faucet_pubkey_ ) ) FD_LOG_ERR(( "Failed to load faucet key" ));
     132           0 :   memcpy( options->faucet_pubkey.key, faucet_pubkey_, 32 );
     133             : 
     134           0 :   FD_TEST( fd_cstr_printf_check( file_path, PATH_MAX, NULL, "%s/stake-account.json", config->scratch_directory ) );
     135           0 :   uchar const * stake_pubkey_ = fd_keyload_load( file_path, 1 );
     136           0 :   if( FD_UNLIKELY( !stake_pubkey_ ) ) FD_LOG_ERR(( "Failed to load stake account key" ));
     137           0 :   memcpy( options->stake_pubkey.key, stake_pubkey_, 32 );
     138             : 
     139           0 :   FD_TEST( fd_cstr_printf_check( file_path, PATH_MAX, NULL, "%s/vote-account.json", config->scratch_directory ) );
     140           0 :   uchar const * vote_pubkey_ = fd_keyload_load( file_path, 1 );
     141           0 :   if( FD_UNLIKELY( !vote_pubkey_ ) ) FD_LOG_ERR(( "Failed to load vote account key" ));
     142           0 :   memcpy( options->vote_pubkey.key, vote_pubkey_, 32 );
     143             : 
     144             : 
     145           0 :   options->creation_time      = (ulong)fd_log_wallclock() / (ulong)1e9;
     146           0 :   options->faucet_balance     = 500000000000000000UL;
     147           0 :   options->vote_account_stake = config->development.genesis.vote_account_stake_lamports;
     148             : 
     149             :   /* Set up PoH config */
     150             : 
     151           0 :   if( 0UL==config->development.genesis.hashes_per_tick ) {
     152             : 
     153             :     /* set hashes_per_tick to whatever machine is capable of */
     154           0 :     ulong hashes_per_tick =
     155           0 :       estimate_hashes_per_tick( config->development.genesis.target_tick_duration_micros,
     156           0 :                                 (ulong)3e9 /* 3 seconds */ );
     157             : 
     158           0 :     if( hashes_per_tick == 0UL ) {
     159           0 :       FD_LOG_WARNING(( "PoH rate estimation failed.  Defaulting to %lu",
     160           0 :                         FD_SYSVAR_CLOCK_DEFAULT_HASHES_PER_TICK ));
     161           0 :       hashes_per_tick = FD_SYSVAR_CLOCK_DEFAULT_HASHES_PER_TICK;
     162           0 :     }
     163             : 
     164           0 :     options->hashes_per_tick = hashes_per_tick;
     165             : 
     166           0 :   } else if( 1UL==config->development.genesis.hashes_per_tick ) {
     167             : 
     168             :     /* set hashes_per_tick field to 0, which means sleep mode */
     169           0 :     options->hashes_per_tick = 0UL;
     170             : 
     171           0 :   } else {
     172             : 
     173             :     /* set hashes_per_tick to the specified value */
     174           0 :     options->hashes_per_tick = config->development.genesis.hashes_per_tick;
     175             : 
     176           0 :   }
     177             : 
     178           0 :   options->ticks_per_slot               = config->development.genesis.ticks_per_slot;
     179           0 :   options->target_tick_duration_micros  = config->development.genesis.target_tick_duration_micros;
     180             : 
     181           0 :   options->fund_initial_accounts        = config->development.genesis.fund_initial_accounts;
     182           0 :   options->fund_initial_amount_lamports = config->development.genesis.fund_initial_amount_lamports;
     183             : 
     184           0 :   options->warmup_epochs                = config->development.genesis.warmup_epochs;
     185             : 
     186           0 :   fd_features_t features[1];
     187           0 :   fd_features_disable_all( features );
     188           0 :   uint version[] = {FD_DEFAULT_AGAVE_CLUSTER_VERSION_MAJOR, FD_DEFAULT_AGAVE_CLUSTER_VERSION_MINOR, FD_DEFAULT_AGAVE_CLUSTER_VERSION_PATCH};
     189           0 :   fd_features_enable_cleaned_up(features, version);
     190           0 :   default_enable_features( features );
     191             : 
     192           0 :   options->features = features;
     193             : 
     194             :   /* Serialize blob */
     195             : 
     196           0 :   static uchar scratch_smem[ 16<<20UL ];  /* fits at least 32k accounts */
     197           0 :          ulong scratch_fmem[ 4 ];
     198           0 :   fd_scratch_attach( scratch_smem, scratch_fmem,
     199           0 :                      sizeof(scratch_smem), sizeof(scratch_fmem)/sizeof(ulong) );
     200             : 
     201           0 :   ulong blob_len = fd_genesis_create( blob, blob_sz, options );
     202           0 :   if( FD_UNLIKELY( !blob_sz ) ) FD_LOG_ERR(( "Failed to create genesis blob" ));
     203             : 
     204           0 :   fd_scratch_detach( NULL );
     205             : 
     206           0 :   fd_keyload_unload( identity_pubkey_, 1 );
     207           0 :   fd_keyload_unload( faucet_pubkey_, 1 );
     208           0 :   fd_keyload_unload( stake_pubkey_, 1 );
     209           0 :   fd_keyload_unload( vote_pubkey_, 1 );
     210             : 
     211           0 :   return blob_len;
     212           0 : }
     213             : 
     214             : static void
     215           0 : init( config_t * const config ) {
     216           0 :   mkdir_all( config->ledger.path, config->uid, config->gid );
     217             : 
     218           0 :   static uchar blob[ 16<<20UL ];
     219           0 :   ulong blob_sz = create_genesis( config, blob, sizeof(blob) );
     220             : 
     221             :   /* Switch to target user in the configuration when creating the
     222             :      genesis.bin file so it is permissioned correctly. */
     223             : 
     224           0 :   gid_t gid = getgid();
     225           0 :   uid_t uid = getuid();
     226           0 :   if( FD_LIKELY( gid == 0 && setegid( config->gid ) ) )
     227           0 :     FD_LOG_ERR(( "setegid() failed (%i-%s)", errno, fd_io_strerror( errno ) ));
     228           0 :   if( FD_LIKELY( uid == 0 && seteuid( config->uid ) ) )
     229           0 :     FD_LOG_ERR(( "seteuid() failed (%i-%s)", errno, fd_io_strerror( errno ) ));
     230             : 
     231           0 :   mode_t previous = umask( S_IRWXO | S_IRWXG );
     232             : 
     233           0 :   char genesis_path[ PATH_MAX ];
     234           0 :   FD_TEST( fd_cstr_printf_check( genesis_path, PATH_MAX, NULL, "%s/genesis.bin", config->ledger.path ) );
     235           0 :   do {
     236           0 :     FILE * genesis_file = fopen( genesis_path, "w" );
     237           0 :     FD_TEST( genesis_file );
     238           0 :     FD_TEST( 1L == fwrite( blob, blob_sz, 1L, genesis_file ) );
     239           0 :     FD_TEST( !fclose( genesis_file ) );
     240           0 :   } while(0);
     241             : 
     242           0 :   umask( previous );
     243             : 
     244           0 :   if( FD_UNLIKELY( seteuid( uid ) ) ) FD_LOG_ERR(( "seteuid() failed (%i-%s)", errno, fd_io_strerror( errno ) ));
     245           0 :   if( FD_UNLIKELY( setegid( gid ) ) ) FD_LOG_ERR(( "setegid() failed (%i-%s)", errno, fd_io_strerror( errno ) ));
     246             : 
     247           0 :   uchar genesis_hash[ 32 ];
     248           0 :   char  genesis_hash_cstr[ FD_BASE58_ENCODED_32_SZ ];
     249           0 :   ushort shred_version = compute_shred_version( genesis_path, genesis_hash );
     250             : 
     251           0 :   FD_LOG_INFO(( "Created %s:  genesis_hash=%s sz=%lu",
     252           0 :                 genesis_path,
     253           0 :                 fd_base58_encode_32( genesis_hash, NULL, genesis_hash_cstr ),
     254           0 :                 blob_sz ));
     255           0 :   FD_LOG_INFO(( "Shred version: %hu", shred_version ));
     256           0 : }
     257             : 
     258             : static void
     259             : fini( config_t * const config,
     260           0 :       int              pre_init ) {
     261           0 :   (void)pre_init;
     262             : 
     263           0 :   char genesis_path[ PATH_MAX ];
     264           0 :   FD_TEST( fd_cstr_printf_check( genesis_path, PATH_MAX, NULL, "%s/genesis.bin", config->ledger.path ) );
     265           0 :   if( FD_UNLIKELY( unlink( genesis_path ) && errno!=ENOENT ) )
     266           0 :     FD_LOG_ERR(( "could not remove genesis.bin file `%s` (%i-%s)", genesis_path, errno, fd_io_strerror( errno ) ));
     267           0 : }
     268             : 
     269             : static configure_result_t
     270           0 : check( config_t * const config ) {
     271           0 :   char genesis_path[ PATH_MAX ];
     272           0 :   fd_cstr_printf_check( genesis_path, PATH_MAX, NULL, "%s/genesis.bin", config->ledger.path );
     273             : 
     274           0 :   struct stat st;
     275           0 :   if( FD_UNLIKELY( stat( genesis_path, &st ) && errno==ENOENT ) )
     276           0 :     NOT_CONFIGURED( "`%s` does not exist", genesis_path );
     277             : 
     278           0 :   CHECK( check_dir( config->ledger.path, config->uid, config->gid, S_IFDIR | S_IRUSR | S_IWUSR | S_IXUSR ) );
     279           0 :   CHECK( check_file( genesis_path, config->uid, config->gid, S_IFREG | S_IRUSR | S_IWUSR ) );
     280             : 
     281           0 :   PARTIALLY_CONFIGURED( "`%s` already exists", genesis_path );
     282           0 : }
     283             : 
     284             : configure_stage_t fd_cfg_stage_genesis = {
     285             :   .name            = NAME,
     286             :   .init            = init,
     287             :   .fini            = fini,
     288             :   .check           = check,
     289             :   /* It might be nice to not regenerate the genesis.bin if the
     290             :      parameters didn't change here, but it has a timestamp in it and
     291             :      also a variable number of hashes per tick in some configurations,
     292             :      which we would need to pull out and skip in the comparison, so we
     293             :      just always recreate it for now. */
     294             :   .always_recreate = 1,
     295             : };
     296             : 
     297             : #undef NAME

Generated by: LCOV version 1.14