koi_net.exceptions

KOI-net library exceptions.

Exception hierarchy (conceptually):

KoiNetError
  BuildError
  RequestError
    ClientError
      SelfRequestError
      PartialNodeQueryError
      NodeNotFoundError
    TransportError
    ServerError
      RemoteProtocolError
        RemoteUnknownNodeError
        RemoteInvalidKeyError
        RemoteInvalidSignatureError
        RemoteInvalidTargetError
  ProtocolError
    UnknownNodeError
    InvalidKeyError
    InvalidSignatureError
    InvalidTargetError
  MissingEnvVarsError

Exceptions

BuildError

Raised when errors occur in build process.

ClientError

Raised when this node makes an invalid request.

InvalidKeyError

Raised when peer node's public key doesn't match their RID.

InvalidSignatureError

Raised when peer node's envelope signature is invalid.

InvalidTargetError

Raised when peer node's target is not this node.

KoiNetError

Base exception.

MissingEnvVarsError(message, vars)

Raised when required environment variables are missing.

NodeNotFoundError

Raised when this node cannot find a node's URL.

PartialNodeQueryError

Raised when this node attempts to query a partial node.

ProtocolError

Base for protocol errors raised by this node.

RemoteInvalidKeyError

Raised by peer node when this node's public key doesn't match their RID.

RemoteInvalidSignatureError

Raised by peer node when this node's envelope signature is invalid.

RemoteInvalidTargetError

Raised by peer node when this node's envelope target is not it's RID.

RemoteProtocolError

Base for protocol errors raised by peer node.

RemoteUnknownNodeError

Raised by peer node when this node is unknown.

RequestError

Base for network request errors.

SelfRequestError

Raised when this node tries to request itself.

ServerError

Raised when an server error occurs during a request.

TransportError

Raised when a transport error occurs during a request.

UnknownNodeError

Raised when peer node is unknown.

exception koi_net.exceptions.BuildError[source]

Bases: KoiNetError

Raised when errors occur in build process.

exception koi_net.exceptions.ClientError[source]

Bases: RequestError

Raised when this node makes an invalid request.

exception koi_net.exceptions.InvalidKeyError[source]

Bases: ProtocolError

Raised when peer node’s public key doesn’t match their RID.

exception koi_net.exceptions.InvalidSignatureError[source]

Bases: ProtocolError

Raised when peer node’s envelope signature is invalid.

exception koi_net.exceptions.InvalidTargetError[source]

Bases: ProtocolError

Raised when peer node’s target is not this node.

exception koi_net.exceptions.KoiNetError[source]

Bases: Exception

Base exception.

exception koi_net.exceptions.MissingEnvVarsError(message, vars)[source]

Bases: KoiNetError

Raised when required environment variables are missing.

Parameters:
  • message (str)

  • vars (list[str])

exception koi_net.exceptions.NodeNotFoundError[source]

Bases: ClientError

Raised when this node cannot find a node’s URL.

exception koi_net.exceptions.PartialNodeQueryError[source]

Bases: ClientError

Raised when this node attempts to query a partial node.

exception koi_net.exceptions.ProtocolError[source]

Bases: KoiNetError

Base for protocol errors raised by this node.

exception koi_net.exceptions.RemoteInvalidKeyError[source]

Bases: RemoteProtocolError

Raised by peer node when this node’s public key doesn’t match their RID.

exception koi_net.exceptions.RemoteInvalidSignatureError[source]

Bases: RemoteProtocolError

Raised by peer node when this node’s envelope signature is invalid.

exception koi_net.exceptions.RemoteInvalidTargetError[source]

Bases: RemoteProtocolError

Raised by peer node when this node’s envelope target is not it’s RID.

exception koi_net.exceptions.RemoteProtocolError[source]

Bases: ServerError

Base for protocol errors raised by peer node.

exception koi_net.exceptions.RemoteUnknownNodeError[source]

Bases: RemoteProtocolError

Raised by peer node when this node is unknown.

exception koi_net.exceptions.RequestError[source]

Bases: KoiNetError

Base for network request errors.

exception koi_net.exceptions.SelfRequestError[source]

Bases: ClientError

Raised when this node tries to request itself.

exception koi_net.exceptions.ServerError[source]

Bases: RequestError

Raised when an server error occurs during a request.

exception koi_net.exceptions.TransportError[source]

Bases: RequestError

Raised when a transport error occurs during a request.

exception koi_net.exceptions.UnknownNodeError[source]

Bases: ProtocolError

Raised when peer node is unknown.