-
Notifications
You must be signed in to change notification settings - Fork 5
Genesis setup parameters
neodix42 edited this page Nov 9, 2025
·
11 revisions
Use these ENV variables to setup genesis container.
| ENV variables | Default value | Description |
|---|---|---|
| container parameters | ||
| EXTERNAL_IP | empty | Used to generate external.global.config.json that allows remote users to connect to lite-server via public IP. |
| HIDE_PRIVATE_KEYS | false | Set to true if you don't want to have predefined private keys for validators and faucets, and don't want to expose them via http-server; |
| VERBOSITY | 1 | Set verbosity level for validator-engine. Default 1, allowed values: 0, 1, 2, 3, 4; |
| CUSTOM_PARAMETERS | empty | Used to specify validator's command line parameters. |
| blockchain setup parameters | ||
| GLOBAL_ID | -217 | Negative value means a test instance of the blockchain. |
| CUSTOM_CONFIG_SMC_URL | empty | URL to a plain-text new config-code.fif smart-contract. Used to override the default TON blockchain configuration smart-contract during genesis creation. |
| BLOCKCHAIN_INITIAL_BALANCE | 5000000000 | Total initial/minted balance of the whole blockchain stored in master wallet (main-wallet.pk). |
| MAX_VALIDATORS | 1000 | Maximum number of validators per this blockchain. |
| MAX_MAIN_VALIDATORS | 100 | Maximum number of main validators per this blockchain. |
| MIN_VALIDATORS | 1 | Minimum number of validators per this blockchain. |
| MIN_STAKE | 1000000 | Minimum validator stake in TON coins. |
| MAX_STAKE | 1000000000 | Maximum validator stake in TON coins. |
| MAX_FACTOR | 10 | Ratio to max and min stake. if a person put 100k, E.g. if max_factor is 2.7, and the minimum participant in the list has 10k, then the effective stake will be min (100k, 2.7 * 10k) = 27k |
| MIN_TOTAL_STAKE | 10000 | Minimum total stake for all validators. |
| MASTERCHAIN_ONLY | false | If true, no workchains will be generated and only -1 workchain will exist. |
| VALIDATION_PERIOD | 1200 | Validation period. |
| ELECTION_START_BEFORE | 900 | Election starts X minutes before validation round ends. |
| ELECTION_END_BEFORE | 300 | Election ends X minutes before validation round ends. |
| ELECTION_STAKE_FROZEN | 180 | Period of time validator's take will be frozen after selection. |
| ORIGINAL_VALIDATOR_SET_VALID_FOR | 120 | Period of time original validators' set is valid. |
| ACTUAL_MIN_SPLIT | 0 | Config 12. Actual number of shardchains basechain can be split to. |
| MIN_SPLIT | 0 | Config 12. Initial and minimum number of shardchains basechain can be split to. |
| MAX_SPLIT | 4 | Config 12. Maximum number of shardchains basechain can be split to. |
| CELL_PRICE | 100000 | Cell price in non masterchain in nano coins. |
| CELL_PRICE_MC | 1000000 | Cell price in masterchain in nano coins. |
| GAS_PRICE | 1000 | Gas price in non masterchain in nano coins. |
| GAS_PRICE_MC | 10000 | Gas price in masterchain in nano coins. |
| NEXT_BLOCK_GENERATION_DELAY | 2 | Delay between blocks' generation. |
| SIMPLE_FAUCET_INITIAL_BALANCE | 1000000 | User's common faucet based on Wallet V3R2 faucet.pk. |
| HIGHLOAD_FAUCET_INITIAL_BALANCE | 1000000 | User's common highload faucet based on Highload Wallet V2 (faucet-highload.pk). |
| DATA_FAUCET_INITIAL_BALANCE | 1000000 | User's common highload faucet based on Highload Wallet V2 (data-highload.pk) used by the data container. |
| VALIDATOR_0_INITIAL_BALANCE | 500000000 | Initial genesis validator's wallet balance in TON coins (validator.pk). |
| VALIDATOR_1_INITIAL_BALANCE | 500000000 | Initial second optional validator's wallet balance in TON coins (validator-1.pk). |
| VALIDATOR_2_INITIAL_BALANCE | 500000000 | Initial third optional validator's wallet balance in TON coins (validator-2.pk). |
| VALIDATOR_3_INITIAL_BALANCE | 500000000 | Initial fourth optional validator's wallet balance in TON coins (validator-3.pk). |
| VALIDATOR_4_INITIAL_BALANCE | 500000000 | Initial fifth optional validator's wallet balance in TON coins (validator-4.pk). |
| VALIDATOR_5_INITIAL_BALANCE | 500000000 | Initial sixth optional validator's wallet balance in TON coins (validator-5.pk). |
| VERSION_CAPABILITIES | 11 | Blockchain version. |
| BIT_PRICE_PER_SECOND | 1 | Bit's price per second in nano coins. |
| CELL_PRICE_PER_SECOND | 500 | Cell's price per second in nano coins. |
| BIT_PRICE_PER_SECOND_MC | 1000 | Bit's price per second in nano coins in masterchain. |
| CELL_PRICE_PER_SECOND_MC | 500000 | Cell's price per second in nano coins in masterchain. |
| VALIDATORS_MASTERCHAIN_NUM | 1 | Maximum number of validators per masterchain. |
| VALIDATORS_PER_SHARD | 1 | Maximum number of validators that can validate a single shard. |
| BLOCK_LIMIT_MULTIPLIER | 1 | Each of six below parameters will be multiplied by this parameter. |
| BLOCK_SIZE_UNDERLOAD_KB | 256 | Block size underload limit. |
| BLOCK_SIZE_SOFT_KB | 1024 | Block size soft limit. |
| BLOCK_SIZE_HARD_KB | 2048 | Block size hard limit. |
| BLOCK_GAS_LIMIT_UNDERLOAD | 2000000 | Block gas underload limit. |
| BLOCK_GAS_LIMIT_SOFT | 10000000 | Block gas soft limit. |
| BLOCK_GAS_LIMIT_HARD | 20000000 | Block gas hard limit. |
| SPAM_RUN | 0 | Enable network spam. Generates around 250 TPS load. |
| SPAM_CHAINS | 10 | Number of parallel chains in retranslator.fc |
| SPAM_HOPS | 65535 | Number of hops to perform in retranslator.fc |
| SPAM_SPLIT_HOPS | 7 | Number of splits in retranslator.fc |
| SPAM_DURATION_MINUTES | 300 | The duration of spam process after start. |