This repository provides samples for the Eclipse Dataspace Components (EDC) project, that aim to support the onboarding process for new community members. The samples are sorted by scope for easy navigation and serve as a step-by-step guide for getting familiar with the project. The code and a detailed documentation for each sample reside in the respective module.

The samples assume a working knowledge of the EDC nomenclature. If you do not know about the EDC nomenclature we strongly advise reading the documentation and/or watching the introductory videos.

Also, a working knowledge of Git, Gradle, Java and HTTP is presumed.

We'll assume that you've just checked out the samples code base and have Java 11+ installed on your development machine. If not, please download and install JDK 11+ for your OS.

Command examples in this document will use the bash syntax and use Unix-style paths, but any other shell should be fine as well. If you're using Windows you either need to adapt the paths or use WSL2.

The samples are separated by scope, where each scope has a different focus. Depending on what you want to learn more about, you can choose the scope to look at. More scopes may be added in the future, so be sure to check back regularly.

If you are new to the project, it is advisable to start with the basic scope. The samples in this scope teach the very basics about using the EDC framework, which are presupposed in all other scopes!

The samples in this scope teach you how to get started with the EDC framework. You will e.g. learn how to set up and run a connector and how to create your own extensions. What you learn here will be used in all other samples. Click the link above to learn about the basic samples in more detail.

All basic samples are located in the basic directory.

This scope revolves around the topic of data transfer. In these samples you will learn how a data transfer works in the EDC and run different transfer scenarios. Click the link above to learn about the transfer samples in more detail.

All transfer samples are located in the transfer directory.

See how to contribute.

This project is licensed under the Apache License 2.0 - see here for details.