graphsense-python 2.18.0__py3-none-any.whl → 2.19.0__py3-none-any.whl

graphsense/__init__.py

@@ -12,7 +12,7 @@
 """
 
 
-__version__ = "2.18.0"
+__version__ = "2.19.0"
 
 # Define package exports
 __all__ = [
@@ -20,7 +20,6 @@ __all__ = [
     "BlocksApi",
     "BulkApi",
     "ClustersApi",
-    "EntitiesApi",
     "GeneralApi",
     "GraphApi",
     "RatesApi",
@@ -59,7 +58,6 @@ __all__ = [
     "CurrencyStats",
     "DirectChangeHeuristic",
     "Entity",
-    "EntityAddresses",
     "ExternalConversion",
     "GraphAddressNetworkSummary",
     "GraphAddressOverall",
@@ -94,7 +92,6 @@ __all__ = [
     "NeighborAddresses",
     "NeighborCluster",
     "NeighborClusters",
-    "NeighborEntities",
     "NeighborEntity",
     "NetworkCapabilities",
     "OneTimeChangeHeuristic",
@@ -111,6 +108,7 @@ __all__ = [
     "SearchResultLevel4",
     "SearchResultLevel5",
     "SearchResultLevel6",
+    "ServiceInfo",
     "Stats",
     "Tag",
     "TagCloudEntry",
@@ -142,7 +140,6 @@ from graphsense.api.addresses_api import AddressesApi as AddressesApi
 from graphsense.api.blocks_api import BlocksApi as BlocksApi
 from graphsense.api.bulk_api import BulkApi as BulkApi
 from graphsense.api.clusters_api import ClustersApi as ClustersApi
-from graphsense.api.entities_api import EntitiesApi as EntitiesApi
 from graphsense.api.general_api import GeneralApi as GeneralApi
 from graphsense.api.graph_api import GraphApi as GraphApi
 from graphsense.api.rates_api import RatesApi as RatesApi
@@ -185,7 +182,6 @@ from graphsense.models.consensus_entry import ConsensusEntry as ConsensusEntry
 from graphsense.models.currency_stats import CurrencyStats as CurrencyStats
 from graphsense.models.direct_change_heuristic import DirectChangeHeuristic as DirectChangeHeuristic
 from graphsense.models.entity import Entity as Entity
-from graphsense.models.entity_addresses import EntityAddresses as EntityAddresses
 from graphsense.models.external_conversion import ExternalConversion as ExternalConversion
 from graphsense.models.graph_address_network_summary import GraphAddressNetworkSummary as GraphAddressNetworkSummary
 from graphsense.models.graph_address_overall import GraphAddressOverall as GraphAddressOverall
@@ -220,7 +216,6 @@ from graphsense.models.neighbor_address import NeighborAddress as NeighborAddres
 from graphsense.models.neighbor_addresses import NeighborAddresses as NeighborAddresses
 from graphsense.models.neighbor_cluster import NeighborCluster as NeighborCluster
 from graphsense.models.neighbor_clusters import NeighborClusters as NeighborClusters
-from graphsense.models.neighbor_entities import NeighborEntities as NeighborEntities
 from graphsense.models.neighbor_entity import NeighborEntity as NeighborEntity
 from graphsense.models.network_capabilities import NetworkCapabilities as NetworkCapabilities
 from graphsense.models.one_time_change_heuristic import OneTimeChangeHeuristic as OneTimeChangeHeuristic
@@ -237,6 +232,7 @@ from graphsense.models.search_result_level3 import SearchResultLevel3 as SearchR
 from graphsense.models.search_result_level4 import SearchResultLevel4 as SearchResultLevel4
 from graphsense.models.search_result_level5 import SearchResultLevel5 as SearchResultLevel5
 from graphsense.models.search_result_level6 import SearchResultLevel6 as SearchResultLevel6
+from graphsense.models.service_info import ServiceInfo as ServiceInfo
 from graphsense.models.stats import Stats as Stats
 from graphsense.models.tag import Tag as Tag
 from graphsense.models.tag_cloud_entry import TagCloudEntry as TagCloudEntry
@@ -259,3 +255,5 @@ from graphsense.models.wasabi_heuristic import WasabiHeuristic as WasabiHeuristi
 from graphsense.models.whirlpool_coin_join_heuristic import WhirlpoolCoinJoinHeuristic as WhirlpoolCoinJoinHeuristic
 from graphsense.models.whirlpool_tx0_heuristic import WhirlpoolTx0Heuristic as WhirlpoolTx0Heuristic
 
+# Pointers for removed client names (hand-written)
+import graphsense.removed  # noqa: F401, E402

graphsense/address_scan/validators.py

@@ -258,6 +258,83 @@ def _keccak256(data: bytes) -> bytes:
 # btc/ltc/zec/trx copied verbatim from utils/address.py (pure already).
 
 
+def base58_check_payload(s: str) -> "bytes | None":
+    """The payload (version + body, without checksum) of a Base58Check
+    string, or None if it is not one."""
+    try:
+        decoded = base58_check_decode(s)
+    except ValueError:
+        return None
+    if len(decoded) < 5:
+        return None
+    payload, checksum = decoded[:-4], decoded[-4:]
+    if hashlib.sha256(hashlib.sha256(payload).digest()).digest()[:4] != checksum:
+        return None
+    return payload
+
+
+def base58_version_ok(s: str, versions: dict) -> bool:
+    """True if ``s`` is Base58Check with one of ``versions`` (version bytes
+    -> allowed body lengths). A valid checksum alone says nothing: private
+    keys, extended keys and other chains' addresses have one too."""
+    payload = base58_check_payload(s)
+    if payload is None:
+        return False
+    for version, lengths in versions.items():
+        if payload.startswith(version) and len(payload) - len(version) in lengths:
+            return True
+    return False
+
+
+_BECH32_CHARSET = "qpzry9x8gf2tvdw0s3jn54khce6mua7l"
+
+
+def bech32_data(s: str, expected_hrp: str) -> "tuple | None":
+    """(checksum spec, 5-bit data without checksum) of a bech32/bech32m
+    string with ``expected_hrp``, else None. Unlike ``bech32_validate`` no
+    segwit rules and no 90-character limit (Zcash addresses are longer)."""
+    if s != s.lower() and s != s.upper():
+        return None
+    s = s.lower()
+    pos = s.rfind("1")
+    if pos < 1 or pos + 7 > len(s) or s[:pos] != expected_hrp:
+        return None
+    data_part = s[pos + 1 :]
+    if any(c not in _BECH32_CHARSET for c in data_part):
+        return None
+    data = [_BECH32_CHARSET.find(c) for c in data_part]
+    spec = bech32_checksum_spec(expected_hrp, data)
+    if spec is None:
+        return None
+    return spec, data[:-6]
+
+
+# Base58Check version bytes -> length of the hash that follows.
+_BTC_BASE58_VERSIONS = {
+    b"\x00": {20},  # P2PKH
+    b"\x05": {20},  # P2SH
+    b"\x6f": {20},  # testnet P2PKH
+    b"\xc4": {20},  # testnet P2SH
+}
+_LTC_BASE58_VERSIONS = {
+    b"\x30": {20},  # L, P2PKH
+    b"\x32": {20},  # M, P2SH
+    b"\x05": {20},  # 3, P2SH (old, shared with BTC)
+    b"\x6f": {20},  # testnet P2PKH
+    b"\xc4": {20},  # testnet P2SH (old)
+    b"\x3a": {20},  # testnet P2SH
+}
+_ZEC_BASE58_VERSIONS = {
+    b"\x1c\xb8": {20},  # t1, P2PKH
+    b"\x1c\xbd": {20},  # t3, P2SH
+    b"\x1d\x25": {20},  # tm, testnet P2PKH
+    b"\x1c\xba": {20},  # t2, testnet P2SH
+    b"\x16\x9a": {64},  # zc, Sprout
+    b"\x16\xb6": {64},  # zt, testnet Sprout
+}
+_TRX_BASE58_VERSIONS = {b"\x41": {20}}
+
+
 def validate_btc_address(address: str) -> bool:
     if not address:
         return False
@@ -265,13 +342,7 @@ def validate_btc_address(address: str) -> bool:
         return bech32_validate(address, "bc")
     elif address.lower().startswith("tb1"):
         return bech32_validate(address, "tb")
-    elif address[0] in "13":
-        return base58_check_validate(address)
-    elif address[0] in "2mn":
-        return base58_check_validate(address)
-    elif address[0] in "59LKc":
-        return base58_check_validate(address)
-    return False
+    return base58_version_ok(address, _BTC_BASE58_VERSIONS)
 
 
 def validate_ltc_address(address: str) -> bool:
@@ -279,27 +350,25 @@ def validate_ltc_address(address: str) -> bool:
         return False
     if address.lower().startswith("ltc1"):
         return bech32_validate(address, "ltc")
-    elif address[0] in "L3M":
-        return base58_check_validate(address)
-    elif address[0] in "2mn":
-        return base58_check_validate(address)
-    return False
+    return base58_version_ok(address, _LTC_BASE58_VERSIONS)
 
 
 def validate_zec_address(address: str) -> bool:
     if not address:
         return False
-    if address.startswith("t1") or address.startswith("t3"):
-        return base58_check_validate(address)
-    elif address.startswith("tm"):
-        return base58_check_validate(address)
-    elif address.startswith("zc") and len(address) == 95:
-        return base58_check_validate(address)
-    elif (address.startswith("zs") or address.startswith("ztestsapling")) and len(
-        address
-    ) in [78, 88]:
-        return base58_check_validate(address)
-    return False
+    lowered = address.lower()
+    for hrp in ("zs", "ztestsapling"):
+        if lowered.startswith(hrp + "1"):
+            decoded = bech32_data(address, hrp)
+            if decoded is None or decoded[0] != "bech32":
+                return False
+            body = bech32_convertbits(decoded[1], 5, 8, False)
+            return body is not None and len(body) == 43
+    for hrp in ("u", "utest"):
+        if lowered.startswith(hrp + "1"):
+            decoded = bech32_data(address, hrp)
+            return decoded is not None and decoded[0] == "bech32m"
+    return base58_version_ok(address, _ZEC_BASE58_VERSIONS)
 
 
 def validate_trx_address(address: str) -> bool:
@@ -307,7 +376,7 @@ def validate_trx_address(address: str) -> bool:
         return False
     if not address.startswith("T") or len(address) != 34:
         return False
-    return base58_check_validate(address)
+    return base58_version_ok(address, _TRX_BASE58_VERSIONS)
 
 
 def validate_eth_address(address: str) -> bool:

graphsense/api/__init__.py

@@ -5,7 +5,6 @@ from graphsense.api.addresses_api import AddressesApi
 from graphsense.api.blocks_api import BlocksApi
 from graphsense.api.bulk_api import BulkApi
 from graphsense.api.clusters_api import ClustersApi
-from graphsense.api.entities_api import EntitiesApi
 from graphsense.api.general_api import GeneralApi
 from graphsense.api.graph_api import GraphApi
 from graphsense.api.rates_api import RatesApi

graphsense/api/addresses_api.py

@@ -21,7 +21,6 @@ from graphsense.models.address import Address
 from graphsense.models.address_tags import AddressTags
 from graphsense.models.address_txs import AddressTxs
 from graphsense.models.cluster import Cluster
-from graphsense.models.entity import Entity
 from graphsense.models.links import Links
 from graphsense.models.neighbor_addresses import NeighborAddresses
 from graphsense.models.related_addresses import RelatedAddresses
@@ -733,308 +732,6 @@ class AddressesApi:
 
 
 
-    @validate_call_compat
-    def get_address_entity(
-        self,
-        currency: Annotated[StrictStr, Field(description="The cryptocurrency code (e.g., btc)")],
-        address: Annotated[StrictStr, Field(description="The cryptocurrency address")],
-        include_actors: Annotated[Optional[StrictBool], Field(description="Whether to include actor information")] = None,
-        _request_timeout: Union[
-            None,
-            Annotated[StrictFloat, Field(gt=0)],
-            Tuple[
-                Annotated[StrictFloat, Field(gt=0)],
-                Annotated[StrictFloat, Field(gt=0)]
-            ]
-        ] = None,
-        _request_auth: Optional[Dict[StrictStr, Any]] = None,
-        _content_type: Optional[StrictStr] = None,
-        _headers: Optional[Dict[StrictStr, Any]] = None,
-        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> Entity:
-        """(Deprecated) Get the entity for an address
-
-        Deprecated alias for `GET /{currency}/addresses/{address}/cluster`. Returns the address cluster that contains the given address.
-
-        :param currency: The cryptocurrency code (e.g., btc) (required)
-        :type currency: str
-        :param address: The cryptocurrency address (required)
-        :type address: str
-        :param include_actors: Whether to include actor information
-        :type include_actors: bool
-        :param _request_timeout: timeout setting for this request. If one
-                                 number provided, it will be total request
-                                 timeout. It can also be a pair (tuple) of
-                                 (connection, read) timeouts.
-        :type _request_timeout: int, tuple(int, int), optional
-        :param _request_auth: set to override the auth_settings for an a single
-                              request; this effectively ignores the
-                              authentication in the spec for a single request.
-        :type _request_auth: dict, optional
-        :param _content_type: force content-type for the request.
-        :type _content_type: str, Optional
-        :param _headers: set to override the headers for a single
-                         request; this effectively ignores the headers
-                         in the spec for a single request.
-        :type _headers: dict, optional
-        :param _host_index: set to override the host_index for a single
-                            request; this effectively ignores the host_index
-                            in the spec for a single request.
-        :type _host_index: int, optional
-        :return: Returns the result object.
-        """ # noqa: E501
-        warnings.warn("GET /{currency}/addresses/{address}/entity is deprecated.", DeprecationWarning)
-
-        _param = self._get_address_entity_serialize(
-            currency=currency,
-            address=address,
-            include_actors=include_actors,
-            _request_auth=_request_auth,
-            _content_type=_content_type,
-            _headers=_headers,
-            _host_index=_host_index
-        )
-
-        _response_types_map: Dict[str, Optional[str]] = {
-            '200': "Entity",
-            '404': None,
-            '422': "HTTPValidationError",
-        }
-        response_data = self.api_client.call_api(
-            *_param,
-            _request_timeout=_request_timeout
-        )
-        response_data.read()
-        return self.api_client.response_deserialize(
-            response_data=response_data,
-            response_types_map=_response_types_map,
-        ).data
-
-
-    @validate_call_compat
-    def get_address_entity_with_http_info(
-        self,
-        currency: Annotated[StrictStr, Field(description="The cryptocurrency code (e.g., btc)")],
-        address: Annotated[StrictStr, Field(description="The cryptocurrency address")],
-        include_actors: Annotated[Optional[StrictBool], Field(description="Whether to include actor information")] = None,
-        _request_timeout: Union[
-            None,
-            Annotated[StrictFloat, Field(gt=0)],
-            Tuple[
-                Annotated[StrictFloat, Field(gt=0)],
-                Annotated[StrictFloat, Field(gt=0)]
-            ]
-        ] = None,
-        _request_auth: Optional[Dict[StrictStr, Any]] = None,
-        _content_type: Optional[StrictStr] = None,
-        _headers: Optional[Dict[StrictStr, Any]] = None,
-        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[Entity]:
-        """(Deprecated) Get the entity for an address
-
-        Deprecated alias for `GET /{currency}/addresses/{address}/cluster`. Returns the address cluster that contains the given address.
-
-        :param currency: The cryptocurrency code (e.g., btc) (required)
-        :type currency: str
-        :param address: The cryptocurrency address (required)
-        :type address: str
-        :param include_actors: Whether to include actor information
-        :type include_actors: bool
-        :param _request_timeout: timeout setting for this request. If one
-                                 number provided, it will be total request
-                                 timeout. It can also be a pair (tuple) of
-                                 (connection, read) timeouts.
-        :type _request_timeout: int, tuple(int, int), optional
-        :param _request_auth: set to override the auth_settings for an a single
-                              request; this effectively ignores the
-                              authentication in the spec for a single request.
-        :type _request_auth: dict, optional
-        :param _content_type: force content-type for the request.
-        :type _content_type: str, Optional
-        :param _headers: set to override the headers for a single
-                         request; this effectively ignores the headers
-                         in the spec for a single request.
-        :type _headers: dict, optional
-        :param _host_index: set to override the host_index for a single
-                            request; this effectively ignores the host_index
-                            in the spec for a single request.
-        :type _host_index: int, optional
-        :return: Returns the result object.
-        """ # noqa: E501
-        warnings.warn("GET /{currency}/addresses/{address}/entity is deprecated.", DeprecationWarning)
-
-        _param = self._get_address_entity_serialize(
-            currency=currency,
-            address=address,
-            include_actors=include_actors,
-            _request_auth=_request_auth,
-            _content_type=_content_type,
-            _headers=_headers,
-            _host_index=_host_index
-        )
-
-        _response_types_map: Dict[str, Optional[str]] = {
-            '200': "Entity",
-            '404': None,
-            '422': "HTTPValidationError",
-        }
-        response_data = self.api_client.call_api(
-            *_param,
-            _request_timeout=_request_timeout
-        )
-        response_data.read()
-        return self.api_client.response_deserialize(
-            response_data=response_data,
-            response_types_map=_response_types_map,
-        )
-
-
-    @validate_call_compat
-    def get_address_entity_without_preload_content(
-        self,
-        currency: Annotated[StrictStr, Field(description="The cryptocurrency code (e.g., btc)")],
-        address: Annotated[StrictStr, Field(description="The cryptocurrency address")],
-        include_actors: Annotated[Optional[StrictBool], Field(description="Whether to include actor information")] = None,
-        _request_timeout: Union[
-            None,
-            Annotated[StrictFloat, Field(gt=0)],
-            Tuple[
-                Annotated[StrictFloat, Field(gt=0)],
-                Annotated[StrictFloat, Field(gt=0)]
-            ]
-        ] = None,
-        _request_auth: Optional[Dict[StrictStr, Any]] = None,
-        _content_type: Optional[StrictStr] = None,
-        _headers: Optional[Dict[StrictStr, Any]] = None,
-        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> RESTResponseType:
-        """(Deprecated) Get the entity for an address
-
-        Deprecated alias for `GET /{currency}/addresses/{address}/cluster`. Returns the address cluster that contains the given address.
-
-        :param currency: The cryptocurrency code (e.g., btc) (required)
-        :type currency: str
-        :param address: The cryptocurrency address (required)
-        :type address: str
-        :param include_actors: Whether to include actor information
-        :type include_actors: bool
-        :param _request_timeout: timeout setting for this request. If one
-                                 number provided, it will be total request
-                                 timeout. It can also be a pair (tuple) of
-                                 (connection, read) timeouts.
-        :type _request_timeout: int, tuple(int, int), optional
-        :param _request_auth: set to override the auth_settings for an a single
-                              request; this effectively ignores the
-                              authentication in the spec for a single request.
-        :type _request_auth: dict, optional
-        :param _content_type: force content-type for the request.
-        :type _content_type: str, Optional
-        :param _headers: set to override the headers for a single
-                         request; this effectively ignores the headers
-                         in the spec for a single request.
-        :type _headers: dict, optional
-        :param _host_index: set to override the host_index for a single
-                            request; this effectively ignores the host_index
-                            in the spec for a single request.
-        :type _host_index: int, optional
-        :return: Returns the result object.
-        """ # noqa: E501
-        warnings.warn("GET /{currency}/addresses/{address}/entity is deprecated.", DeprecationWarning)
-
-        _param = self._get_address_entity_serialize(
-            currency=currency,
-            address=address,
-            include_actors=include_actors,
-            _request_auth=_request_auth,
-            _content_type=_content_type,
-            _headers=_headers,
-            _host_index=_host_index
-        )
-
-        _response_types_map: Dict[str, Optional[str]] = {
-            '200': "Entity",
-            '404': None,
-            '422': "HTTPValidationError",
-        }
-        response_data = self.api_client.call_api(
-            *_param,
-            _request_timeout=_request_timeout
-        )
-        return response_data.response
-
-
-    def _get_address_entity_serialize(
-        self,
-        currency,
-        address,
-        include_actors,
-        _request_auth,
-        _content_type,
-        _headers,
-        _host_index,
-    ) -> RequestSerialized:
-
-        _host = None
-
-        _collection_formats: Dict[str, str] = {
-        }
-
-        _path_params: Dict[str, str] = {}
-        _query_params: List[Tuple[str, str]] = []
-        _header_params: Dict[str, Optional[str]] = _headers or {}
-        _form_params: List[Tuple[str, str]] = []
-        _files: Dict[
-            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
-        ] = {}
-        _body_params: Optional[bytes] = None
-
-        # process the path parameters
-        if currency is not None:
-            _path_params['currency'] = currency
-        if address is not None:
-            _path_params['address'] = address
-        # process the query parameters
-        if include_actors is not None:
-            
-            _query_params.append(('include_actors', include_actors))
-            
-        # process the header parameters
-        # process the form parameters
-        # process the body parameter
-
-
-        # set the HTTP header `Accept`
-        if 'Accept' not in _header_params:
-            _header_params['Accept'] = self.api_client.select_header_accept(
-                [
-                    'application/json'
-                ]
-            )
-
-
-        # authentication setting
-        _auth_settings: List[str] = [
-            'api_key'
-        ]
-
-        return self.api_client.param_serialize(
-            method='GET',
-            resource_path='/{currency}/addresses/{address}/entity',
-            path_params=_path_params,
-            query_params=_query_params,
-            header_params=_header_params,
-            body=_body_params,
-            post_params=_form_params,
-            files=_files,
-            auth_settings=_auth_settings,
-            collection_formats=_collection_formats,
-            _host=_host,
-            _request_auth=_request_auth
-        )
-
-
-
-
     @validate_call_compat
     def get_tag_summary_by_address(
         self,

graphsense/api/general_api.py

@@ -146,7 +146,7 @@ class GeneralApi:
     ) -> Capabilities:
         """Get per-network feature availability
 
-        Returns which optional feature families are disabled per served network. A network absent from the list is fully enabled, as is every network of a deployment that does not serve this endpoint (404).
+        Returns which optional feature families are disabled per served network. A network absent from the list is fully enabled, as is every network of a deployment that does not serve this endpoint (404). Also lists the optional services of the deployment (e.g. address notifications) with their versions.
 
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -209,7 +209,7 @@ class GeneralApi:
     ) -> ApiResponse[Capabilities]:
         """Get per-network feature availability
 
-        Returns which optional feature families are disabled per served network. A network absent from the list is fully enabled, as is every network of a deployment that does not serve this endpoint (404).
+        Returns which optional feature families are disabled per served network. A network absent from the list is fully enabled, as is every network of a deployment that does not serve this endpoint (404). Also lists the optional services of the deployment (e.g. address notifications) with their versions.
 
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -272,7 +272,7 @@ class GeneralApi:
     ) -> RESTResponseType:
         """Get per-network feature availability
 
-        Returns which optional feature families are disabled per served network. A network absent from the list is fully enabled, as is every network of a deployment that does not serve this endpoint (404).
+        Returns which optional feature families are disabled per served network. A network absent from the list is fully enabled, as is every network of a deployment that does not serve this endpoint (404). Also lists the optional services of the deployment (e.g. address notifications) with their versions.
 
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request

graphsense/api_client.py

@@ -95,7 +95,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'graphsense-python/2.18.0'
+        self.user_agent = 'graphsense-python/2.19.0'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

graphsense/cli/raw.py

@@ -18,10 +18,11 @@ import rich_click as click
 import graphsense
 from graphsense.cli.context import CliContext
 from graphsense.ext import output as out_mod
+from graphsense.removed import REMOVED_NAMES
 
 pass_ctx = click.make_pass_decorator(CliContext)
 
-_DEPRECATED_APIS = {"EntitiesApi"}
+_DEPRECATED_APIS: set[str] = set()
 _INTERNAL_SUFFIXES = ("_with_http_info", "_without_preload_content")
 _PRIVATE_PREFIXES = ("_",)
 
@@ -49,9 +50,28 @@ def build_raw_group() -> click.Group:
         subgroup = _make_api_subgroup(cls_name, cls)
         raw_group.add_command(subgroup)
 
+    for cls_name, message in REMOVED_NAMES.items():
+        if cls_name.endswith("Api"):
+            raw_group.add_command(_make_removed_group(cls_name, message))
+
     return raw_group
 
 
+def _make_removed_group(cls_name: str, message: str) -> click.Command:
+    """Hidden stand-in for a removed API group: fails with what replaces it."""
+
+    @click.command(
+        name=cls_name[: -len("Api")].lower(),
+        hidden=True,
+        context_settings={"ignore_unknown_options": True, "allow_extra_args": True},
+        add_help_option=False,
+    )
+    def removed() -> None:
+        raise click.UsageError(message)
+
+    return removed
+
+
 def _iter_api_class_names() -> t.Iterator[str]:
     for name in dir(graphsense):
         if name.endswith("Api") and inspect.isclass(getattr(graphsense, name)):

graphsense/configuration.py

@@ -533,8 +533,8 @@ conf = graphsense.Configuration(
         return "Python SDK Debug Report:\n"\
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
-               "Version of the API: 2.18.0\n"\
-               "SDK Package Version: 2.18.0".\
+               "Version of the API: 2.19.0\n"\
+               "SDK Package Version: 2.19.0".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]: