Skip to content

Commit

Permalink
Merge pull request #16 from devin-fisher/patch-2
Browse files Browse the repository at this point in the history
Expand the explaination of these terms
  • Loading branch information
dhh1128 authored May 15, 2019
2 parents db60b46 + b4634ae commit 1693dc2
Showing 1 changed file with 27 additions and 8 deletions.
35 changes: 27 additions & 8 deletions text/protocols/parties-roles-participants.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,41 @@
# Parties, Roles, and Participants

The __parties__ in a protocol are the identity owners involved. In a protocol
where Alice introduces Bob to Carol, the parties are Alice, Bob, and Carol.

## Parties

The __parties__ in a protocol are the identity owners involved. The set of parties of a protocol is simple expression involvement in the protocol. Parties *must* be an identifiable self-sovereign domain. Although normally, the set of parties are known at the start of a protocol, that is not a requirement. Some protocols can commence without all parties known and a party could be included later in the course of the protocol.

For many protocols, there are only two parties. And these protocols fit nicely into a pairwise relationship. But some protocol will only have one party (ex. wallet backup) and others will involve multiple parties (ex. introduction).

Normally, the parties that are involved in a protocol also participate in the interaction but this is not always the case. Consider a gossip protocol, two parties may be talking about a third party. In this case, the third party would not even know that the protocol was happening and would definitely not participate.

As an example, in an introduction protocol where Alice introduces Bob to Carol, the parties are Alice, Bob, and Carol.

## Roles

The __roles__ in a protocol are the perspectives that parties take on an
interaction. In an auction protocol, there are only two roles--*auctioneer*
and *bidder*--even though there may be many parties.
interaction.

This perspective is manifested in three general ways:
* by the expectations that a party takes on in a protocol (ex. a role may be expected to do something to start a protocol).
* by the messages that a party can and does use in the course of the protocol (some messages may be reserved for a single role, while other may used by some if not all roles).
* by the state and the transition rules

Like parties, roles are normally known at the start of the protocol but this is not a requirement.

As an example, in an auction protocol, there are only two roles--*auctioneer*
and *bidder*--even though there may be many parties involved.

# Participants

The __participants__ in a protocol are the agents that actually move the steps of
the protocol thorough the interaction. Alice, Bob, and Carol may each have a cloud
the protocol through the interaction. Alice, Bob, and Carol may each have a cloud
agent, a laptop, and a phone; if they engage in an introduction protocol using
phones, then the agents on their phones are the participants. If the phones
talk directly over bluetooth, this is particularly clear--but even if the phones
talk directly over Bluetooth, this is particularly clear--but even if the phones
leverage push notifications and HTTP such that cloud agents help with routing,
only the phone agents are participants, because only they maintain state for
the interaction underway. (The cloud agents would be __facilitators__, and
the laptops would be __bystanders__). When a
protocol is complete, the participant agents know about the outcome; they may
need to synchronize or replicate their state before other agents of the
parties are aware.

0 comments on commit 1693dc2

Please sign in to comment.