:heavy_exclamation_mark: Important! Before you proceed, please read the EUDI Wallet Reference Implementation project description
The EUDI Wallet Reference Implementation is built based on the Architecture Reference Framework and aims to showcase a robust and interoperable platform for digital identification, authentication, and electronic signatures based on common standards across the European Union. The EUDI Wallet Reference Implementation is based on a modular architecture composed of business-agnostic, reusable components that will evolve in incremental steps and can be re-used across multiple projects.
The EUDI Wallet Reference Implementation is the application that allows users to:
The EUDIW project provides through this repository an Android app. Please refer to the repositories listed in the following sections for more detailed information on how to get started, contribute, and engage with the EUDI Wallet Reference Implementation.
The app consumes the SDK called EUDIW Wallet core Wallet core and a list of available libraries to facilitate remote presentation, proximity, and issuing test/demo functionality following specification of the ARF including:
OpenID4VP - draft 19 (remote presentation), presentation exchange v2.0,
ISO18013-5 (proximity presentation),
OpenID4VCI draft 13 (issuing)
Issuer functionality, to support development and testing, one can access an OID4VCI test/demo service for issuing at:
Relying Party functionality:
To support development and testing, one can access a test/demo service for remote presentation at:
To support proximity an Android Proximity Verifier is available as an app that can request PID and mDL with reader authentication available here
The issuer, verifier service, and verifier app authentication are based on the EUDIW development IACA
The main purpose of the reference implementation is to showcase the ecosystem and act as a technical example of how to integrate and use all of the available components.
If you're planning to use this application in production, we recommend reviewing the following steps:
We welcome contributions to this project. To ensure that the process is smooth for everyone involved, follow the guidelines found in CONTRIBUTING.md.
Issuance
Presentation
Proximity
You can download the application here
You will also need to download the Android Verifier app. More information can be found here
While on the "Dashboard" screen you can tap "Add doc" and issue a new document, e.g. "Driving License".
If you want to re-issue a document you must delete it first by tapping on the document in the "Dashboard" screen and tapping the delete icon in the "Document details" view.
EUDI Wallet User can view the requested data set from the relying party.
This document describes how you can build the application and deploy the issuing and verification services locally.
You can find instructions on how to configure the application here
The released software is an initial development release version:
assembly-logic: App dependencies.
build-logic: Application gradle plugins.
resources-logic: All app resources reside here (images, etc.)
analytics-logic: Access to analytics providers. Capabilities for test monitoring analytics (i.e. crashes) can be added here (no functionality right now)
business-logic: App business logic.
core-logic: Wallet core logic.
authentication-logic: Pin/Biometry Storage and System Biometrics Logic.
ui-logic: Common UI components.
common-feature: Code that is common to all features.
login-feature: Login feature.
dashboard-feature: The application main screen.
startup-feature: The initial screen of the app.
presentation-feature: Online authentication feature.
issuance-feature: Document issuance feature.
proximity-feature: Proximity scenarios feature.
graph TD;
startup-feature --> assembly-logic
login-feature --> assembly-logic
dashboard-feature --> assembly-logic
presentation-feature --> assembly-logic
proximity-feature --> assembly-logic
issuance-feature --> assembly-logic
common-feature --> startup-feature
common-feature --> login-feature
common-feature --> dashboard-feature
common-feature --> presentation-feature
common-feature --> proximity-feature
common-feature --> issuance-feature
business-logic -->common-feature
ui-logic -->common-feature
network-logic -->common-feature
resources-logic -->common-feature
analytics-logic -->common-feature
authentication-logic -->common-feature
core-logic -->common-feature
business-logic -->core-logic
resources-logic -->core-logic
authentication-logic -->core-logic
business-logic -->ui-logic
resources-logic -->ui-logic
analytics-logic -->ui-logic
business-logic -->network-logic
resources-logic -->business-logic
resources-logic --> authentication-logic
business-logic --> authentication-logic
Copyright (c) 2023 European Commission
Licensed under the EUPL, Version 1.2 or - as soon they will be approved by the European Commission - subsequent versions of the EUPL (the "Licence"); You may not use this work except in compliance with the Licence.
You may obtain a copy of the Licence at: https://joinup.ec.europa.eu/software/page/eupl
Unless required by applicable law or agreed to in writing, software distributed under the Licence is distributed on an "AS IS" basis, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the Licence for the specific language governing permissions and limitations under the Licence.