This package implements a simple Roughtime client based on the IETF draft
For more information about Roughtime and tips for writing your own client or server, visit the developer documentation.
Roughtime is now experimental and will undergo backwards incompatible changes as it goes through the IETF process. This library will likewise undergo backwards incompatible changes. There are already substantial changes from Google Roughtime that have forced interface changes.
If you want to use this code and the protocol please join the NTP WG mailing list so that you are aware of the evolution of the protocol and issues that others discover.
** DO NOT USE IN PRODUCTION SOFTWARE **
We welcome pull requests for adding your Roughtime service to our list. Your PR should do the following:
-
Add your server's configuration to
ecosystem.json
. The list of servers will be alphabetized by the"name"
field. -
Add some information about your service to
ecosystem.md
. (This is also kept in alphabetical order.) This should include details about how your service is provisioned:- how you synchronize your server's clock;
- if your code is open source, a link to the code;
- where in the world your server is located; and
- whether you will guarantee up time, and if so, how you will do so.
- what version you run
-
Generate the
ecosystem.json.go
from theecosystem.json
. Use thego generate
command for this.
A couple things to keep in mind:
-
To be healthy, the Roughtime ecosystem needs a diverse set of time sources. The list already contains servers that are synced with Google's NTP servers; as such, servers that expose new sources will be preferred. (An atomic clock would be cool!)
-
We reserve the right to prune this list at any time. (For example, if a server is unreliable, or its root secret key has been compromised.)
-
As new versions come out we may prune servers that do not update.
Finally, a disclaimer: the ecosystem is growing, and ours might not be the definitive list of who is serving Roughtime at any given time.
We welcome your bug fixes, issues, and improvements to either the protocol or this code. Note that substantive changes to the protocol need to be discussed on the NTP WG mailing list.