file formats
============

simple stream files contain JSON formatted data. There are 2 available formats:

* JSON file (`.json`): does contain plain JSON formatted data. The file can be
  accompanied by a `.json.gpg` file which contains a GPG signature for the `.json`
  file

  .. note::

     Due to race conditions caused by the fact that `.json` and `.json.gpg`
     may not be able to be obtained from a storage location at the same
     time, the preferred delivery of signed data is via `.sjson` format.

* Signed JSON file (`.sjson`): does contain a cleartext signed message.
  The payload of the message is the same content as the `.json` file.