Your Diplomatic Layer for EUDI Wallet Integration
EUDIPLO is an open-source middleware that bridges your backend and EUDI Wallets
using a unified API and standardized protocols.
EUDIPLO is an LF Decentralized Trust
project. It was previously hosted by the OpenWallet Foundation.
🧭 Overview
Organizations joining the EUDI Wallet ecosystem face a tough choice: patch
together protocol libraries that may not exist for their stack, or rely on
proprietary solutions that risk vendor lock-in.
EUDIPLO solves this by providing a lightweight, open-source protocol
abstraction layer. It communicates over HTTP and integrates easily with your
existing backend stack—so you can focus on your business logic, not
cryptographic plumbing.
It supports all core flows of electronic attribute attestations—issuing,
requesting, and even requesting during issuance—and is already
compatible with multiple
wallets.
EUDIPLO is built for production: secure key management, scalable database
support, and clean API boundaries.
Documentation policy: the docs on main represent the current development state and preview builds. Stable public documentation is preserved as major-version snapshots for released versions.
🧩 Features
- ✅ Supports OID4VCI, OID4VP, SD-JWT VC, mDOC (ISO 18013-5), and OAuth Token Status
List
- ✅ OIDF conformance tested for OID4VCI and OID4VP protocols
- ✅ JSON-based credential configuration
- ✅ Client credentials authentication for easy service integration
- ✅ Runs via Docker with
.env config
- ✅ HTTP-based integration with any backend
- ✅ Secure key management & pluggable storage
- ✅ Privacy-friendly: no external calls, no long-term storage
📺 Watch the Webinar
Curious about EUDIPLO? Check out our recorded webinar (September 17, 2025) for a deep dive into features, architecture, and live Q&A:
Watch on YouTube
🤝 Community Call
Join our bi-weekly community call every Thursday:
Participate via Zoom
🚀 Quick Start
Requirements:
- Docker with Docker Compose
- Linux, macOS, or Windows
Linux and macOS: standalone CLI
curl -fsSL https://eudiplo.dev/install.sh | bash
eudiplo demo
No local Node.js installation is required.
Already using Node.js 22.12+?
npx @eudiplo/cli demo
Windows
Use npx @eudiplo/cli demo with Node.js 22.12+, or download the Windows x64
standalone executable from GitHub Releases.
Both commands run the same EUDIPLO CLI:
- Standalone CLI: native executable, no Node.js required.
- npm package:
@eudiplo/cli, requires Node.js 22.12+.
eudiplo demo creates a demo deployment for local evaluation:
- Creates editable demo configuration (
.eudiplo.demo.env and config/demo/).
- Uses the minimal topology: SQLite, local file storage, and database-backed keys.
- Starts the backend and web client using Docker Compose.
- Exposes the API at
http://localhost:3000.
- Exposes the web client at
http://localhost:4200.
- Uses demo credentials that must not be used in production.
For a configurable local deployment, run eudiplo init ./eudiplo-local. In an
interactive terminal it asks for a preset or individual database, storage,
key-management, public URL, and authentication choices. The same choices are
available as flags, for example
eudiplo init ./eudiplo-local --preset standard --start.
Local tenant configuration can be scaffolded and managed with:
eudiplo config tenant list
eudiplo config tenant create acme --name "Acme GmbH"
eudiplo config tenant remove acme --force
See the detailed guides:
Other deployment options
Get Started with the API
# Get a token and start using the API
# Replace with your configured AUTH_CLIENT_ID and AUTH_CLIENT_SECRET
curl -X POST http://localhost:3000/api/oauth2/token \
-H "Content-Type: application/json" \
-d '{
"client_id": "your-client-id",
"client_secret": "your-client-secret"
}'
For production authentication setup, see Authentication.
📚 Documentation
Use the current documentation:
The current documentation reflects the active release. For older releases,
use the legacy documentation archive.
Key sections:
🤝 Contributing
We welcome PRs from wallet developers, institutions, and contributors interested
in advancing the EUDI Wallet ecosystem.
See CONTRIBUTING.md for guidelines.
💬 Have questions? Join our
Discord community to ask questions, get help,
and connect with other developers.
📝 License
Licensed under the Apache 2.0 License
Governance
EUDIPLO is a project of LF Decentralized Trust
and follows the
LF Decentralized Trust Code of Conduct.
EUDIPLO is governed by its technical charter. See GOVERNANCE.md for how decisions are made.
