Safe Haskell | Safe-Inferred |
---|---|
Language | Haskell2010 |
Ouroboros.Network.Protocol.Handshake.Type
Contents
Synopsis
- data Handshake vNumber vParams where
- data family Message ps (st :: ps) (st' :: ps)
- data family ClientHasAgency (st :: ps)
- data family ServerHasAgency (st :: ps)
- data family NobodyHasAgency (st :: ps)
- data RefuseReason vNumber
- = VersionMismatch [vNumber] [Int]
- | HandshakeDecodeError vNumber Text
- | Refused vNumber Text
- data HandshakeClientProtocolError vNumber
- = HandshakeError (RefuseReason vNumber)
- | NotRecognisedVersion vNumber
- | InvalidServerSelection vNumber Text
Handshake Protocol
data Handshake vNumber vParams where Source #
The handshake mini-protocol is used initially to agree the version and associated parameters of the protocol to use for all subsequent communication.
Constructors
StPropose :: Handshake vNumber vParams | |
StConfirm :: Handshake vNumber vParams | |
StDone :: Handshake vNumber vParams |
Instances
data family Message ps (st :: ps) (st' :: ps) Source #
The messages for this protocol. It is expected to be a GADT that is
indexed by the from
and to
protocol states. That is the protocol state
the message transitions from, and the protocol state it transitions into.
These are the edges of the protocol state transition system.
Instances
(Show vNumber, Show vParams) => Show (Message (Handshake vNumber vParams) from to) Source # | |
data Message (Handshake vNumber vParams) (from :: Handshake vNumber vParams) (to :: Handshake vNumber vParams) Source # | |
Defined in Ouroboros.Network.Protocol.Handshake.Type data Message (Handshake vNumber vParams) (from :: Handshake vNumber vParams) (to :: Handshake vNumber vParams) where
|
data family ClientHasAgency (st :: ps) Source #
Tokens for those protocol states in which the client has agency.
Instances
Show (ClientHasAgency st) Source # | |
Defined in Ouroboros.Network.Protocol.Handshake.Type Methods showsPrec :: Int -> ClientHasAgency st -> ShowS # show :: ClientHasAgency st -> String # showList :: [ClientHasAgency st] -> ShowS # | |
data ClientHasAgency (st :: Handshake vNumber vParams) Source # | |
Defined in Ouroboros.Network.Protocol.Handshake.Type data ClientHasAgency (st :: Handshake vNumber vParams) where
|
data family ServerHasAgency (st :: ps) Source #
Tokens for those protocol states in which the server has agency.
Instances
Show (ServerHasAgency st) Source # | |
Defined in Ouroboros.Network.Protocol.Handshake.Type Methods showsPrec :: Int -> ServerHasAgency st -> ShowS # show :: ServerHasAgency st -> String # showList :: [ServerHasAgency st] -> ShowS # | |
data ServerHasAgency (st :: Handshake vNumber vParams) Source # | |
Defined in Ouroboros.Network.Protocol.Handshake.Type data ServerHasAgency (st :: Handshake vNumber vParams) where
|
data family NobodyHasAgency (st :: ps) Source #
Tokens for terminal protocol states in which neither the client nor server has agency.
Instances
data NobodyHasAgency (st :: Handshake vNumber vParams) Source # | |
Defined in Ouroboros.Network.Protocol.Handshake.Type data NobodyHasAgency (st :: Handshake vNumber vParams) where
|
data RefuseReason vNumber Source #
Reasons by which a server can refuse proposed version.
Constructors
VersionMismatch [vNumber] [Int] | All of the prosed versions where not known to the server.
Since the server sends all versions that it can knows about, some of them
we might not be able to decode, so we include raw tags |
HandshakeDecodeError vNumber Text | The server failed to decode version parameters. |
Refused vNumber Text | The server refused to run the proposed version parameters |
Instances
Eq vNumber => Eq (RefuseReason vNumber) Source # | |
Defined in Ouroboros.Network.Protocol.Handshake.Type Methods (==) :: RefuseReason vNumber -> RefuseReason vNumber -> Bool # (/=) :: RefuseReason vNumber -> RefuseReason vNumber -> Bool # | |
Show vNumber => Show (RefuseReason vNumber) Source # | |
Defined in Ouroboros.Network.Protocol.Handshake.Type Methods showsPrec :: Int -> RefuseReason vNumber -> ShowS # show :: RefuseReason vNumber -> String # showList :: [RefuseReason vNumber] -> ShowS # | |
(Typeable vNumber, Show vNumber) => Exception (RefuseReason vNumber) Source # | |
Defined in Ouroboros.Network.Protocol.Handshake.Type Methods toException :: RefuseReason vNumber -> SomeException # fromException :: SomeException -> Maybe (RefuseReason vNumber) # displayException :: RefuseReason vNumber -> String # |
data HandshakeClientProtocolError vNumber Source #
Client errors, which extends handshake error
type,
by client specific errors.RefuseReason
Constructors
HandshakeError (RefuseReason vNumber) | |
NotRecognisedVersion vNumber | |
InvalidServerSelection vNumber Text |