Decibel.HandoffError exception (decibel v1.2.1)

Copy Markdown View Source

Raised when a handshake handoff cannot be created or accepted.

The :reason field is stable:

  • :invalid_target: the destination is not a live local process.
  • :invalid_ticket: the value is not a valid handoff ticket.
  • :not_target: a valid ticket was accepted outside its designated process.
  • :unavailable: the ticket was already claimed, expired, or discarded when its target exited.
  • :timeout: the ticket process did not respond before the acceptance deadline.

Errors contain no handshake state or key material.

Summary

Types

reason()

@type reason() ::
  :invalid_target | :invalid_ticket | :not_target | :unavailable | :timeout

t()

@type t() :: %Decibel.HandoffError{
  __exception__: true,
  message: String.t(),
  reason: reason()
}