consolidate

Consolidates matches from several options and members into one.

Applications can use this when constructing user interfaces for conveying various options to the end user.

For example, for a relying party which requests an identity document (say, mDL, PID or PhotoID) and a transportation ticket (say, airline boarding pass or train ticket) the resulting CredentialPresentmentData after executing the request would be:

CredentialSet
  Option
    Member
      Match: mDL
  Option
    Member
      Match: PID
  Option
    Member
      Match: PhotoID
      Match: PhotoID #2
CredentialSet
  Option
    Member
      Match: Boarding Pass BOS -> ERW
  Option
    Member
      Match: Train Ticket Providence -> New York Penn Station

This function consolidates options, members, and matches like so

CredentialSet
  Option
    Member
      Match: mDL
      Match: PID
      Match: PhotoID
      Match: PhotoID #2
CredentialSet
  Option
    Member
      Match: Boarding Pass BOS -> SFO
      Match: Train Ticket Providence -> New York Penn Station

which - depending on how the application constructs its user interface - may give the user a simpler user interface for deciding which credentials to return.