Bucket Structure
================
   .. index:: Bucket Structure

+------------------------+---------------------+--------------+-----------------------------------------------------------+
| Prefix                 | Permissions         | Formats      | Description                                               |
+========================+=====================+==============+===========================================================+
| uploads/ledgers/       | read, write         | parquet      | ledger uploads, uploaded files must not be modified       |
+------------------------+---------------------+--------------+-----------------------------------------------------------+
| uploads/fx_tables/     | read, write         | csv          | exchange rate tables, updates can be reflected in results |
+------------------------+---------------------+--------------+-----------------------------------------------------------+
| user_data/             | read, write, delete | any formats  | any user files                                            |
+------------------------+---------------------+--------------+-----------------------------------------------------------+
| exports/ledgers/       | read                | parquet      | ledger export results                                     |
+------------------------+---------------------+--------------+-----------------------------------------------------------+
| exports/sql_queries/   | read                | parquet, csv | sql query results                                         |
+------------------------+---------------------+--------------+-----------------------------------------------------------+
| exports/curve_results/ | read                | parquet      | metrics curve results                                     |
+------------------------+---------------------+--------------+-----------------------------------------------------------+

.. note:: Uploaded ledgers must not be modified. The system does not enforce or validate this assumption. Modifying ledgers might lead to unpredictable behaviour.

.. note:: Exchange rate tables can be modified, but it is not recommended. Due to S3's eventual consistency for updates to files, it may not be possible to make a new request immediately after modifying an exchange rate table and obtain results consistent with the new table.