"""
The Bittensor Compatibility Module is designed to ensure seamless integration and functionality with legacy versions of
the Bittensor framework, specifically up to and including version 7.3.0. This module addresses changes and deprecated
features in recent versions, allowing users to maintain compatibility with older systems and projects.
"""
import importlib
import sys
from bittensor_wallet import Keypair # noqa: F401
from bittensor_wallet.errors import KeyFileError # noqa: F401
from bittensor_wallet.keyfile import ( # noqa: F401
serialized_keypair_to_keyfile_data,
deserialize_keypair_from_keyfile_data,
validate_password,
ask_password_to_encrypt,
keyfile_data_is_encrypted_nacl,
keyfile_data_is_encrypted_ansible,
keyfile_data_is_encrypted_legacy,
keyfile_data_is_encrypted,
keyfile_data_encryption_method,
legacy_encrypt_keyfile_data,
encrypt_keyfile_data,
get_coldkey_password_from_environment,
decrypt_keyfile_data,
Keyfile,
)
from bittensor_wallet.wallet import display_mnemonic_msg, Wallet # noqa: F401
from bittensor.core import settings
from bittensor.core.async_subtensor import AsyncSubtensor
from bittensor.core.axon import Axon
from bittensor.core.chain_data import ( # noqa: F401
AxonInfo,
ChainIdentity,
DelegateInfo,
DelegateInfoLite,
DynamicInfo,
IPInfo,
MetagraphInfo,
MetagraphInfoEmissions,
MetagraphInfoParams,
MetagraphInfoPool,
NeuronInfo,
NeuronInfoLite,
PrometheusInfo,
ProposalCallData,
ProposalVoteData,
ScheduledColdkeySwapInfo,
StakeInfo,
SubnetHyperparameters,
SubnetIdentity,
SubnetInfo,
SubnetState,
WeightCommitInfo,
)
from bittensor.core.config import ( # noqa: F401
InvalidConfigFile,
DefaultConfig,
Config,
T,
)
from bittensor.core.dendrite import Dendrite # noqa: F401
from bittensor.core.errors import ( # noqa: F401
BlacklistedException,
ChainConnectionError,
ChainError,
ChainQueryError,
ChainTransactionError,
IdentityError,
InternalServerError,
InvalidRequestNameError,
MetadataError,
NominationError,
NotDelegateError,
NotRegisteredError,
NotVerifiedException,
PostProcessException,
PriorityException,
RegistrationError,
RunException,
StakeError,
SynapseDendriteNoneException,
SynapseParsingError,
TransferError,
UnknownSynapseError,
UnstakeError,
)
from bittensor.core.metagraph import Metagraph
from bittensor.core.settings import BLOCKTIME
from bittensor.core.stream import StreamingSynapse # noqa: F401
from bittensor.core.subtensor import Subtensor
from bittensor.core.synapse import TerminalInfo, Synapse # noqa: F401
from bittensor.core.tensor import Tensor # noqa: F401
from bittensor.core.threadpool import ( # noqa: F401
PriorityThreadPoolExecutor as PriorityThreadPoolExecutor,
)
from bittensor.utils import ( # noqa: F401
ss58_to_vec_u8,
version_checking,
strtobool,
get_explorer_url_for_network,
ss58_address_to_bytes,
u16_normalized_float,
u64_normalized_float,
get_hash,
)
from bittensor.utils.balance import Balance as Balance # noqa: F401
from bittensor.utils.balance import tao, rao
from bittensor.utils.btlogging import logging
from bittensor.utils.mock.subtensor_mock import MockSubtensor as MockSubtensor # noqa: F401
from bittensor.utils.subnets import SubnetsAPI # noqa: F401
tao = tao
rao = rao
# Backwards compatibility with previous bittensor versions.
async_subtensor = AsyncSubtensor
axon = Axon
config = Config
dendrite = Dendrite
keyfile = Keyfile
metagraph = Metagraph
wallet = Wallet
subtensor = Subtensor
synapse = Synapse
__blocktime__ = BLOCKTIME
__network_explorer_map__ = settings.NETWORK_EXPLORER_MAP
__pipaddress__ = settings.PIPADDRESS
__ss58_format__ = settings.SS58_FORMAT
__type_registry__ = settings.TYPE_REGISTRY
__ss58_address_length__ = settings.SS58_ADDRESS_LENGTH
__networks__ = settings.NETWORKS
__finney_entrypoint__ = settings.FINNEY_ENTRYPOINT
__finney_test_entrypoint__ = settings.FINNEY_TEST_ENTRYPOINT
__archive_entrypoint__ = settings.ARCHIVE_ENTRYPOINT
__local_entrypoint__ = settings.LOCAL_ENTRYPOINT
__tao_symbol__ = settings.TAO_SYMBOL
__rao_symbol__ = settings.RAO_SYMBOL
# Makes the `bittensor.utils.mock` subpackage available as `bittensor.mock` for backwards compatibility.
mock_subpackage = importlib.import_module("bittensor.utils.mock")
sys.modules["bittensor.mock"] = mock_subpackage
# Makes the `bittensor.core.extrinsics` subpackage available as `bittensor.extrinsics` for backwards compatibility.
extrinsics_subpackage = importlib.import_module("bittensor.core.extrinsics")
sys.modules["bittensor.extrinsics"] = extrinsics_subpackage
# Logging helpers.
[docs]
def trace(on: bool = True):
"""
Enables or disables trace logging.
Args:
on (bool): If True, enables trace logging. If False, disables trace logging.
"""
logging.set_trace(on)
[docs]
def debug(on: bool = True):
"""
Enables or disables debug logging.
Args:
on (bool): If True, enables debug logging. If False, disables debug logging.
"""
logging.set_debug(on)
[docs]
def warning(on: bool = True):
"""
Enables or disables warning logging.
Args:
on (bool): If True, enables warning logging. If False, disables warning logging and sets default (WARNING) level.
"""
logging.set_warning(on)
[docs]
def info(on: bool = True):
"""
Enables or disables info logging.
Args:
on (bool): If True, enables info logging. If False, disables info logging and sets default (WARNING) level.
"""
logging.set_info(on)
