Skip to content
This repository has been archived by the owner on Oct 3, 2020. It is now read-only.

STS: Add bootstrapping section #65

Closed
wants to merge 1 commit into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
12 changes: 12 additions & 0 deletions STS.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@ As Tox grows and more clients are created, we feel it is time to create a Tox s
6. User Discovery
* [Tox URI Scheme](#tox-uri-scheme)
* [DNS Discovery](#dns-discovery)
7. [Bootstrapping](#bootstrapping)



Expand Down Expand Up @@ -236,5 +237,16 @@ To validate this data a client would take the looked up user before the _tox and
With Domain signing, the public key is also stored in a TXT record, using the format ```v=tox;pub={public key}```. It is important to note that due to potential issues wherein the public key may be the result of a poisoning attack, clients are encouraged to maintain a list of popular domains and keys. One such list is [here](http://wiki.tox.im/Domain_keys).


## Bootstrapping

To connect with Tox network, one needs to bootstrap.

Clients should bootstrap aggresively to at least 4 random nodes from a list every ~5 seconds until toxcore reports that connection with network has been established.

When loading from a save, there is no need to bootstrap, unless ~10 seconds after running the first ``tox_iterate()`` toxcore still doesn't report that it is connected. If that happens, refer to the above strategy.

A list of nodes is located at: https://wiki.tox.chat/doku.php?id=users:nodes


## Translation of STS Terminology
Client developers must choose translations that resemble the English variations as closely as possible, except in the case where the Tox trademark is being used. For example, "Tox ID" is to remain, untouched, in English. In the future, translations will be provided for non-English Tox clients.