2 unstable releases

0.2.0 Nov 7, 2022
0.1.2 Sep 13, 2022
0.1.1 Aug 31, 2022
0.1.0 Aug 29, 2022
0.0.1 Aug 26, 2022

#2 in #dap


Used in daphne_worker

BSD-3-Clause

290KB
6.5K SLoC

Daphne

Daphne is a Rust implementation of the Distributed Aggregation Protocol (DAP) standard. DAP is under active development in the PPM working group of the IETF.

Daphne currently implements draft-ietf-ppm-dap-02.

This software is intended to support experimental DAP deployments and is not yet suitable for use in production. Daphne will evolve along with the DAP draft: Backwards compatibility with previous drafts won't be guaranteed until the draft itself begins to stabilize. API-breaking changes between releases should also be expected.

The repository contains three crates:

  • daphne (aka "Daphne") -- Implementation of the core DAP protocol logic for Clients, Aggregators, and Collectors. This crate does not provide the complete, end-to-end functionality of any party. Instead, it defines traits for the functionalities that a concrete instantantiation of the protocol is required to implement. We call these functionalities "roles".

  • daphne_worker (aka "Daphne-Worker") -- Implements a backend for the Aggregator roles based on Cloudflare Workers. This crate also implements the various HTTP endpoints defined in the DAP spec.

  • daphne_worker_test -- Defines a deployment of Daphne-Worker for testing changes locally. It also implements integration tests for Daphne and Daphne-Worker and interop tests with Janus.

Testing

The daphne crate relies on unit tests. The daphne_worker crate relies mostly on integration tests implemented in daphne_worker_test. See the README in that directory for instructions on running Daphne-Worker locally.

Integration tests can be run via docker-compose.

docker-compose up --build --abort-on-container-exit --exit-code-from test

Acknowledgements

Thanks to Yoshimichi Nakatsuka who contributed significantly to Daphne during his internship at Cloudflare Research. Thanks to Brandon Pitman and David Cook for testing, reporting bugs, and sending patches.

The name "Daphne" is credited to Cloudflare Research interns Tim Alberdingk Thijm and James Larisch, who came up with the name independently.

Dependencies

~20MB
~435K SLoC