stellar_sdk.exceptions 源代码

from json import JSONDecodeError
from typing import Optional

from .client.response import Response

BuildInValueError = ValueError
BuildInTypeError = TypeError
BuildInAttributeError = AttributeError

__all__ = [
    "SdkError",
    "ValueError",
    "TypeError",
    "AttributeError",
    "BadSignatureError",
    "Ed25519PublicKeyInvalidError",
    "Ed25519SecretSeedInvalidError",
    "MissingEd25519SecretSeedError",
    "MemoInvalidException",
    "AssetCodeInvalidError",
    "AssetIssuerInvalidError",
    "NoApproximationError",
    "SignatureExistError",
    "BaseRequestError",
    "BaseHorizonError",
    "ConnectionError",
    "NotFoundError",
    "BadRequestError",
    "BadResponseError",
    "UnknownRequestError",
    "NotPageableError",
    "StreamClientError",
]


[文档]class SdkError(Exception): """Base exception for all stellar sdk related errors """
[文档]class ValueError(BuildInValueError, SdkError): """exception for all values related errors """
[文档]class TypeError(BuildInTypeError, SdkError): """exception for all type related errors """
class AttributeError(BuildInAttributeError, SdkError): """ Attribute not found. """
[文档]class BadSignatureError(ValueError): """Raised when the signature was forged or otherwise corrupt. """
[文档]class Ed25519PublicKeyInvalidError(ValueError): """Ed25519 public key is incorrect. """
[文档]class Ed25519SecretSeedInvalidError(ValueError): """Ed25519 secret seed is incorrect. """
[文档]class MissingEd25519SecretSeedError(ValueError): """Missing Ed25519 secret seed in the keypair """
[文档]class MemoInvalidException(ValueError): """Memo is incorrect. """
[文档]class AssetCodeInvalidError(ValueError): """Asset Code is incorrect. """
[文档]class AssetIssuerInvalidError(ValueError): """Asset issuer is incorrect. """
[文档]class NoApproximationError(SdkError): """Approximation cannot be found """
[文档]class SignatureExistError(ValueError): """A keypair can only sign a transaction once. """
[文档]class BaseRequestError(SdkError): """Base class for requests errors. """
[文档]class ConnectionError(BaseRequestError): """Base class for client connection errors. """
[文档]class BaseHorizonError(BaseRequestError): """Base class for horizon request errors. :param response: client response """ def __init__(self, response: Response) -> None: super().__init__(response) self.message: str = response.text self.status: int = response.status_code message = {} try: message = response.json() except JSONDecodeError: pass # pragma: no cover self.type: Optional[str] = message.get("type") self.title: Optional[str] = message.get("title") self.detail: Optional[str] = message.get("detail") self.extras: Optional[dict] = message.get("extras") self.result_xdr: Optional[str] = message.get("extras", {}).get("result_xdr") def __str__(self): return self.message
[文档]class NotFoundError(BaseHorizonError): """This exception is thrown when the requested resource does not exist. status_code == 400 """ def __init__(self, response): super().__init__(response)
[文档]class BadRequestError(BaseHorizonError): """The request from the client has an error. 400 <= status_code < 500 and status_code != 404 """ def __init__(self, response): super().__init__(response)
[文档]class BadResponseError(BaseHorizonError): """The response from the server has an error. 500 <= status_code < 600 """ def __init__(self, response): super().__init__(response)
class UnknownRequestError(BaseHorizonError): """Unknown request exception, please create an issue feedback for this issue. """ class NotPageableError(BaseRequestError): """There is no previous or next page """ class StreamClientError(BaseRequestError): """Failed to fetch stream resource. :param current_cursor: The cursor of the last message obtained can be used for reconnect. :param message: error message """ def __init__(self, current_cursor: str, message: str) -> None: super().__init__(message) self.current_cursor = current_cursor def raise_request_exception(response: Response) -> None: status_code = response.status_code if status_code == 200: pass # pragma: no cover elif status_code == 404: raise NotFoundError(response) elif 400 <= status_code < 500: raise BadRequestError(response) elif 500 <= status_code < 600: raise BadResponseError(response) else: raise UnknownRequestError(response)