@type position() :: :head | :superseded | :contested

@type t() :: %CharterAgreementProtocol.DescriptorFacts{
  descriptor: CharterAgreementProtocol.PartyDescriptor.t(),
  descriptor_digest: binary(),
  descriptor_number: pos_integer(),
  descriptor_position: position(),
  lineage: [binary()],
  not_verified: [atom()],
  optional_extensions_retained: [binary()],
  party_id: binary(),
  prev_descriptor_digest: nil | binary(),
  signing_key_id: binary()
}