multiversx-sdk-cli 11.2.2__tar.gz → 11.3.0__tar.gz

{multiversx_sdk_cli-11.2.2 → multiversx_sdk_cli-11.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multiversx-sdk-cli
-Version: 11.2.2
+Version: 11.3.0
 Summary: MultiversX Smart Contracts Tools
 Project-URL: Homepage, https://github.com/multiversx/mx-sdk-py-cli
 Author: MultiversX
@@ -13,7 +13,7 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
 Requires-Dist: argcomplete==3.2.2
 Requires-Dist: ledgercomm[hid]
-Requires-Dist: multiversx-sdk[ledger]==2.3.1
+Requires-Dist: multiversx-sdk[ledger]==2.3.2
 Requires-Dist: requests<3.0.0,>=2.32.0
 Requires-Dist: rich==13.3.4
 Requires-Dist: toml>=0.10.2

{multiversx_sdk_cli-11.2.2 → multiversx_sdk_cli-11.3.0}/multiversx_sdk_cli/localnet/config_default.py

@@ -15,6 +15,9 @@ general = General(
     genesis_delay_seconds=10,
     rounds_per_epoch=100,
     round_duration_milliseconds=6000,
+    # For the purpose of the localnet, we'll have 3x for Supernova (by default).
+    rounds_per_epoch_in_supernova=300,
+    round_duration_milliseconds_in_supernova=2000,
 )
 
 software = Software(

{multiversx_sdk_cli-11.2.2 → multiversx_sdk_cli-11.3.0}/multiversx_sdk_cli/localnet/config_general.py

@@ -10,11 +10,15 @@ class General(ConfigPart):
         genesis_delay_seconds: int,
         rounds_per_epoch: int,
         round_duration_milliseconds: int,
+        rounds_per_epoch_in_supernova: int,
+        round_duration_milliseconds_in_supernova: int
     ):
-        self.log_level: str = log_level
-        self.genesis_delay_seconds: int = genesis_delay_seconds
-        self.rounds_per_epoch: int = rounds_per_epoch
-        self.round_duration_milliseconds: int = round_duration_milliseconds
+        self.log_level = log_level
+        self.genesis_delay_seconds = genesis_delay_seconds
+        self.rounds_per_epoch = rounds_per_epoch
+        self.round_duration_milliseconds = round_duration_milliseconds
+        self.rounds_per_epoch_in_supernova = rounds_per_epoch_in_supernova
+        self.round_duration_milliseconds_in_supernova = round_duration_milliseconds_in_supernova
 
     def get_name(self) -> str:
         return "general"
@@ -24,3 +28,5 @@ class General(ConfigPart):
         self.genesis_delay_seconds = other.get("genesis_delay_seconds", self.genesis_delay_seconds)
         self.rounds_per_epoch = other.get("rounds_per_epoch", self.rounds_per_epoch)
         self.round_duration_milliseconds = other.get("round_duration_milliseconds", self.round_duration_milliseconds)
+        self.rounds_per_epoch_in_supernova = other.get("rounds_per_epoch_in_supernova", self.rounds_per_epoch_in_supernova)
+        self.round_duration_milliseconds_in_supernova = other.get("round_duration_milliseconds_in_supernova", self.round_duration_milliseconds_in_supernova)

multiversx_sdk_cli-11.3.0/multiversx_sdk_cli/localnet/constants.py

@@ -0,0 +1,13 @@
+import stat
+
+METACHAIN_ID = 4294967295
+NETWORK_MONITORING_INTERVAL_IN_SECONDS = 1
+# Read, write and execute by owner, read and execute by group and others
+FILE_MODE_EXECUTABLE = (
+    stat.S_IRUSR | stat.S_IWUSR | stat.S_IXUSR | stat.S_IRGRP | stat.S_IXGRP | stat.S_IROTH | stat.S_IXOTH
+)
+
+# See https://github.com/multiversx/mx-chain-go/blob/master/cmd/node/config/config.toml.
+ROUNDS_PER_EPOCH_TO_MIN_ROUNDS_BETWEEN_EPOCHS_RATIO = 4
+# See https://github.com/multiversx/mx-chain-go/blob/master/cmd/node/config/enableRounds.toml.
+NUM_ROUNDS_BETWEEN_SUPERNOVA_ACTIVATION_EPOCH_AND_ACTIVATION_ROUND = 20

multiversx_sdk_cli-11.3.0/multiversx_sdk_cli/localnet/node_config_toml.py

@@ -0,0 +1,129 @@
+from typing import Any, Dict
+
+from multiversx_sdk_cli.localnet.config_root import ConfigRoot
+from multiversx_sdk_cli.localnet.constants import (
+    NUM_ROUNDS_BETWEEN_SUPERNOVA_ACTIVATION_EPOCH_AND_ACTIVATION_ROUND,
+    ROUNDS_PER_EPOCH_TO_MIN_ROUNDS_BETWEEN_EPOCHS_RATIO,
+)
+from multiversx_sdk_cli.localnet.nodes_setup_json import CHAIN_ID
+
+ConfigDict = Dict[str, Any]
+
+
+def patch_config(data: ConfigDict, config: ConfigRoot, enable_epochs_config: ConfigDict):
+    supernova_activation_epoch = enable_epochs_config["EnableEpochs"].get("SupernovaEnableEpoch", None)
+
+    data["GeneralSettings"]["ChainID"] = CHAIN_ID
+
+    # "--operation-mode=historical-balances" is not available for nodes,
+    # since << validator cannot be a full archive node >>,
+    # but we attempt to set the "deep-history" mode as follows:
+    data["DbLookupExtensions"]["Enabled"] = True
+    data["GeneralSettings"]["StartInEpochEnabled"] = False
+    data["StateTriesConfig"]["AccountsStatePruningEnabled"] = False
+    data["StoragePruning"]["ObserverCleanOldEpochsData"] = False
+    data["StoragePruning"]["AccountsTrieCleanOldEpochsData"] = False
+
+    # Some time after the release of Supernova, we should drop this custom (and somewhat cumbersome) logic.
+    if supernova_activation_epoch is None:
+        # Before Supernova (as software version, not as "era after activation"),
+        # we alter epoch duration by adjusting "RoundsPerEpoch" and "MinRoundsBetweenEpochs" in section "EpochStartConfig".
+        # In a Supernova-aware node configuration, these entries do not exist anymore (see "ChainParametersByEpoch").
+        epoch_start_config: ConfigDict = dict()
+        epoch_start_config["RoundsPerEpoch"] = config.general.rounds_per_epoch
+        epoch_start_config["MinRoundsBetweenEpochs"] = int(
+            config.general.rounds_per_epoch / ROUNDS_PER_EPOCH_TO_MIN_ROUNDS_BETWEEN_EPOCHS_RATIO
+        )
+
+        data["EpochStartConfig"].update(epoch_start_config)
+
+    data["WebServerAntiflood"]["VmQueryDelayAfterStartInSec"] = 30
+
+    # Always use the latest VM
+    data["VirtualMachine"]["Execution"]["WasmVMVersions"] = [{"StartEpoch": 0, "Version": "*"}]
+    data["VirtualMachine"]["Querying"]["WasmVMVersions"] = [{"StartEpoch": 0, "Version": "*"}]
+
+    # Adjust "ChainParametersByEpoch"
+    chain_parameters_by_epoch = data["GeneralSettings"].get("ChainParametersByEpoch", [])
+
+    for item in chain_parameters_by_epoch:
+        enable_epoch = item["EnableEpoch"]
+
+        is_supernova_enabled = supernova_activation_epoch is not None and enable_epoch >= supernova_activation_epoch
+        if is_supernova_enabled:
+            item["RoundDuration"] = config.general.round_duration_milliseconds_in_supernova
+            item["RoundsPerEpoch"] = config.general.rounds_per_epoch_in_supernova
+            item["MinRoundsBetweenEpochs"] = int(
+                config.general.rounds_per_epoch_in_supernova / ROUNDS_PER_EPOCH_TO_MIN_ROUNDS_BETWEEN_EPOCHS_RATIO
+            )
+        else:
+            item["RoundDuration"] = config.general.round_duration_milliseconds
+            item["RoundsPerEpoch"] = config.general.rounds_per_epoch
+            item["MinRoundsBetweenEpochs"] = int(
+                config.general.rounds_per_epoch / ROUNDS_PER_EPOCH_TO_MIN_ROUNDS_BETWEEN_EPOCHS_RATIO
+            )
+
+        item["ShardConsensusGroupSize"] = config.shards.consensus_size
+        item["ShardMinNumNodes"] = config.shards.num_validators_per_shard
+        item["MetachainConsensusGroupSize"] = config.metashard.consensus_size
+        item["MetachainMinNumNodes"] = config.metashard.num_validators
+
+    # Adjust "Versions" (of blocks)
+    versions_by_epoch = data["Versions"].get("VersionsByEpochs", [])
+
+    for item in versions_by_epoch:
+        enable_epoch = item["StartEpoch"]
+
+        if enable_epoch == supernova_activation_epoch:
+            item["StartRound"] = _compute_supernova_activation_round(config, supernova_activation_epoch)
+
+
+def patch_api(data: ConfigDict, config: ConfigRoot):
+    routes = data["APIPackages"]["transaction"]["Routes"]
+    for route in routes:
+        route["Open"] = True
+
+
+def patch_enable_epochs(data: ConfigDict, config: ConfigRoot):
+    enable_epochs = data["EnableEpochs"]
+    enable_epochs["AheadOfTimeGasUsageEnableEpoch"] = 0
+    enable_epochs["GasPriceModifierEnableEpoch"] = 0
+    enable_epochs["RepairCallbackEnableEpoch"] = 0
+    enable_epochs["ReturnDataToLastTransferEnableEpoch"] = 0
+    enable_epochs["SenderInOutTransferEnableEpoch"] = 0
+    enable_epochs["ESDTEnableEpoch"] = 0
+    enable_epochs["IncrementSCRNonceInMultiTransferEnableEpoch"] = 0
+    enable_epochs["ESDTMultiTransferEnableEpoch"] = 0
+    enable_epochs["GlobalMintBurnDisableEpoch"] = 0
+    enable_epochs["ESDTTransferRoleEnableEpoch"] = 0
+    enable_epochs["MultiESDTTransferFixOnCallBackOnEnableEpoch"] = 0
+    enable_epochs["ESDTNFTCreateOnMultiShard"] = 0
+    enable_epochs["MetaESDTSetEnableEpoch"] = 0
+    enable_epochs["DelegationManagerEnableEpoch"] = 0
+
+    # Adjust "MaxNumNodes":
+    max_nodes_change_enable_epoch = enable_epochs["MaxNodesChangeEnableEpoch"]
+    last_entry = max_nodes_change_enable_epoch[-1]
+    penultimate_entry = max_nodes_change_enable_epoch[-2]
+    last_entry["MaxNumNodes"] = (
+        penultimate_entry["MaxNumNodes"] - (config.shards.num_shards + 1) * penultimate_entry["NodesToShufflePerShard"]
+    )
+
+
+def patch_enable_rounds(data: ConfigDict, config: ConfigRoot, enable_epochs_config: ConfigDict):
+    supernova_activation_epoch = enable_epochs_config["EnableEpochs"].get("SupernovaEnableEpoch", None)
+
+    activations = data["RoundActivations"]
+    supernova_entry = activations.get("SupernovaEnableRound")
+
+    if supernova_entry and supernova_activation_epoch is not None:
+        supernova_computed_activation_round = _compute_supernova_activation_round(config, supernova_activation_epoch)
+        supernova_entry["Round"] = str(supernova_computed_activation_round)
+
+
+def _compute_supernova_activation_round(config: ConfigRoot, supernova_activation_epoch: int) -> int:
+    # Epochs are zero-indexed.
+    return (
+        config.general.rounds_per_epoch * supernova_activation_epoch
+        + NUM_ROUNDS_BETWEEN_SUPERNOVA_ACTIVATION_EPOCH_AND_ACTIVATION_ROUND
+    )

{multiversx_sdk_cli-11.2.2 → multiversx_sdk_cli-11.3.0}/multiversx_sdk_cli/localnet/nodes_setup_json.py

@@ -26,14 +26,5 @@ def build(config: ConfigRoot) -> Any:
 
     return {
         "startTime": config.genesis_time(),
-        "roundDuration": config.general.round_duration_milliseconds,
-        "consensusGroupSize": config.shards.consensus_size,
-        "minNodesPerShard": config.shards.consensus_size,
-        "metaChainConsensusGroupSize": config.metashard.consensus_size,
-        "metaChainMinNodes": config.metashard.num_validators,
-        "hysteresis": 0,
-        "adaptivity": False,
-        "chainID": CHAIN_ID,
-        "minTransactionVersion": 1,
         "initialNodes": initial_nodes,
     }

{multiversx_sdk_cli-11.2.2 → multiversx_sdk_cli-11.3.0}/multiversx_sdk_cli/localnet/step_config.py

@@ -101,24 +101,28 @@ def copy_validator_keys(config: ConfigRoot):
 def patch_node_config(config: ConfigRoot):
     for node_config in config.all_nodes_config_folders():
         node_config_file = node_config / "config.toml"
-        data = utils.read_toml_file(node_config_file)
-        node_config_toml.patch_config(data, config)
-        utils.write_toml_file(node_config_file, data)
-
         api_config_file = node_config / "api.toml"
-        data = utils.read_toml_file(api_config_file)
-        node_config_toml.patch_api(data, config)
-        utils.write_toml_file(api_config_file, data)
-
         enable_epochs_config_file = node_config / "enableEpochs.toml"
-        data = utils.read_toml_file(enable_epochs_config_file)
-        node_config_toml.patch_enable_epochs(data, config)
-        utils.write_toml_file(enable_epochs_config_file, data)
-
+        enable_rounds_config_file = node_config / "enableRounds.toml"
         genesis_smart_contracts_file = node_config / "genesisSmartContracts.json"
-        data = utils.read_json_file(genesis_smart_contracts_file)
-        genesis_smart_contracts_json.patch(data, config)
-        utils.write_json_file(genesis_smart_contracts_file, data)
+
+        node_config_data = utils.read_toml_file(node_config_file)
+        api_config_data = utils.read_toml_file(api_config_file)
+        enable_epochs_config_data = utils.read_toml_file(enable_epochs_config_file)
+        enable_rounds_config_data = utils.read_toml_file(enable_rounds_config_file)
+        genesis_smart_contracts_data = utils.read_json_file(genesis_smart_contracts_file)
+
+        node_config_toml.patch_config(node_config_data, config, enable_epochs_config_data)
+        node_config_toml.patch_api(api_config_data, config)
+        node_config_toml.patch_enable_epochs(enable_epochs_config_data, config)
+        node_config_toml.patch_enable_rounds(enable_rounds_config_data, config, enable_epochs_config_data)
+        genesis_smart_contracts_json.patch(genesis_smart_contracts_data, config)
+
+        utils.write_toml_file(node_config_file, node_config_data)
+        utils.write_toml_file(api_config_file, api_config_data)
+        utils.write_toml_file(enable_epochs_config_file, enable_epochs_config_data)
+        utils.write_toml_file(enable_rounds_config_file, enable_rounds_config_data)
+        utils.write_json_file(genesis_smart_contracts_file, genesis_smart_contracts_data)
 
 
 def copy_config_to_seednode(config: ConfigRoot):

{multiversx_sdk_cli-11.2.2 → multiversx_sdk_cli-11.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "multiversx-sdk-cli"
-version = "11.2.2"
+version = "11.3.0"
 authors = [
   { name="MultiversX" },
 ]
@@ -25,7 +25,7 @@ dependencies = [
   "ledgercomm[hid]",
   "rich==13.3.4",
   "argcomplete==3.2.2",
-  "multiversx-sdk[ledger]==2.3.1"
+  "multiversx-sdk[ledger]==2.3.2"
 ]
 
 [project.scripts]

multiversx_sdk_cli-11.2.2/multiversx_sdk_cli/localnet/constants.py

@@ -1,8 +0,0 @@
-import stat
-
-METACHAIN_ID = 4294967295
-NETWORK_MONITORING_INTERVAL_IN_SECONDS = 1
-# Read, write and execute by owner, read and execute by group and others
-FILE_MODE_EXECUTABLE = (
-    stat.S_IRUSR | stat.S_IWUSR | stat.S_IXUSR | stat.S_IRGRP | stat.S_IXGRP | stat.S_IROTH | stat.S_IXOTH
-)

multiversx_sdk_cli-11.2.2/multiversx_sdk_cli/localnet/node_config_toml.py

@@ -1,83 +0,0 @@
-from typing import Any, Dict
-
-from multiversx_sdk_cli.localnet.config_root import ConfigRoot
-from multiversx_sdk_cli.localnet.nodes_setup_json import CHAIN_ID
-
-ConfigDict = Dict[str, Any]
-
-
-def patch_config(data: ConfigDict, config: ConfigRoot):
-    data["GeneralSettings"]["ChainID"] = CHAIN_ID
-
-    # "--operation-mode=historical-balances" is not available for nodes,
-    # since << validator cannot be a full archive node >>,
-    # but we attempt to set the "deep-history" mode as follows:
-    data["DbLookupExtensions"]["Enabled"] = True
-    data["GeneralSettings"]["StartInEpochEnabled"] = False
-    data["StateTriesConfig"]["AccountsStatePruningEnabled"] = False
-    data["StoragePruning"]["ObserverCleanOldEpochsData"] = False
-    data["StoragePruning"]["AccountsTrieCleanOldEpochsData"] = False
-
-    # Make epochs shorter
-    epoch_start_config: ConfigDict = dict()
-    epoch_start_config["RoundsPerEpoch"] = config.general.rounds_per_epoch
-    epoch_start_config["MinRoundsBetweenEpochs"] = int(config.general.rounds_per_epoch / 4)
-
-    data["EpochStartConfig"].update(epoch_start_config)
-    data["WebServerAntiflood"]["VmQueryDelayAfterStartInSec"] = 30
-
-    # Always use the latest VM
-    data["VirtualMachine"]["Execution"]["WasmVMVersions"] = [{"StartEpoch": 0, "Version": "*"}]
-    data["VirtualMachine"]["Querying"]["WasmVMVersions"] = [{"StartEpoch": 0, "Version": "*"}]
-
-    # Adjust "ChainParametersByEpoch" (for Andromeda)
-    chain_parameters_by_epoch = data["GeneralSettings"].get("ChainParametersByEpoch", [])
-
-    if chain_parameters_by_epoch:
-        # For convenience, keep a single entry ...
-        chain_parameters_by_epoch.clear()
-        chain_parameters_by_epoch.append({})
-
-        # ... and set the activation epoch to 0
-        chain_parameters_by_epoch[0]["EnableEpoch"] = 0
-        chain_parameters_by_epoch[0]["RoundDuration"] = config.general.round_duration_milliseconds
-        chain_parameters_by_epoch[0]["ShardConsensusGroupSize"] = config.shards.consensus_size
-        chain_parameters_by_epoch[0]["ShardMinNumNodes"] = config.shards.num_validators_per_shard
-        chain_parameters_by_epoch[0]["MetachainConsensusGroupSize"] = config.metashard.consensus_size
-        chain_parameters_by_epoch[0]["MetachainMinNumNodes"] = config.metashard.num_validators
-
-
-def patch_api(data: ConfigDict, config: ConfigRoot):
-    routes = data["APIPackages"]["transaction"]["Routes"]
-    for route in routes:
-        route["Open"] = True
-
-
-def patch_enable_epochs(data: ConfigDict, config: ConfigRoot):
-    enable_epochs = data["EnableEpochs"]
-    enable_epochs["SCDeployEnableEpoch"] = 0
-    enable_epochs["BuiltInFunctionsEnableEpoch"] = 0
-    enable_epochs["RelayedTransactionsEnableEpoch"] = 0
-    enable_epochs["PenalizedTooMuchGasEnableEpoch"] = 0
-    enable_epochs["AheadOfTimeGasUsageEnableEpoch"] = 0
-    enable_epochs["GasPriceModifierEnableEpoch"] = 0
-    enable_epochs["RepairCallbackEnableEpoch"] = 0
-    enable_epochs["ReturnDataToLastTransferEnableEpoch"] = 0
-    enable_epochs["SenderInOutTransferEnableEpoch"] = 0
-    enable_epochs["ESDTEnableEpoch"] = 0
-    enable_epochs["IncrementSCRNonceInMultiTransferEnableEpoch"] = 0
-    enable_epochs["ESDTMultiTransferEnableEpoch"] = 0
-    enable_epochs["GlobalMintBurnDisableEpoch"] = 0
-    enable_epochs["ESDTTransferRoleEnableEpoch"] = 0
-    enable_epochs["BuiltInFunctionOnMetaEnableEpoch"] = 0
-    enable_epochs["MultiESDTTransferFixOnCallBackOnEnableEpoch"] = 0
-    enable_epochs["ESDTNFTCreateOnMultiShard"] = 0
-    enable_epochs["MetaESDTSetEnableEpoch"] = 0
-    enable_epochs["DelegationManagerEnableEpoch"] = 0
-
-    max_nodes_change_enable_epoch = enable_epochs["MaxNodesChangeEnableEpoch"]
-    last_entry = max_nodes_change_enable_epoch[-1]
-    penultimate_entry = max_nodes_change_enable_epoch[-2]
-    last_entry["MaxNumNodes"] = (
-        penultimate_entry["MaxNumNodes"] - (config.shards.num_shards + 1) * penultimate_entry["NodesToShufflePerShard"]
-    )