2 unstable releases
0.2.0 | Nov 7, 2022 |
---|---|
0.1.2 | Sep 13, 2022 |
0.1.1 |
|
0.1.0 |
|
#5 in #dap
430KB
9K
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
~27–41MB
~728K SLoC