|
|
The transport properties client is a [BSP client](BSP) that synchronises transport properties between pairs of devices. Transport properties describe how to connect to a device over various transports.
|
|
|
|
|
|
### Group identifiers
|
|
|
|
|
|
The client's identifier is `org.briarproject.bramble.transport`.
|
|
|
|
|
|
The client uses a separate group for each pair of contacts. The [group descriptor](BSP#group-identifiers) is a [BDF list](BDF) containing the unique IDs of the contacts' identities, sorted in ascending order as byte strings.
|
|
|
|
|
|
The client also uses a group with an empty descriptor for storing local transport properties. This group is not shared with any contacts.
|
|
|
|
|
|
### Message types
|
|
|
|
|
|
**UPDATE** - The message body is a BDF list with three elements: `transportId` (string), `version` (int), and `properties` (dictionary). `transportId` and `properties` are supplied by the transport plugin. `version` is incremented whenever the properties change.
|
|
|
|
|
|
### Validity policy
|
|
|
|
|
|
* An update is valid if it is well-formed.
|
|
|
|
|
|
### Storage policy
|
|
|
|
|
|
* In the groups shared with contacts:
|
|
|
* For each transport, the local message with the highest version is stored.
|
|
|
* For each transport, the remote message with the highest version is stored.
|
|
|
* In the unshared group, the local message with the highest version is stored.
|
|
|
|
|
|
### Sharing policy
|
|
|
|
|
|
* In the groups shared with contacts, all local messages are shared.
|
|
|
* In the unshared group, no messages are shared. |