EUDIPLO is an open-source middleware that bridges your backend and EUDI Wallets using a unified API and standardized protocols.
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, source-available, 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.
While still in early development, EUDIPLO is built for production: secure key management, scalable database support, and clean API boundaries.
- ✅ 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
.envconfig - ✅ HTTP-based integration with any backend
- ✅ Secure key management & pluggable storage
- ✅ Privacy-friendly: no external calls, no long-term storage
Curious about EUDIPLO? Check out our recorded webinar (September 17, 2025) for a deep dive into features, architecture, and live Q&A:
For quick testing and demos:
# Clone the repository
git clone https://github.com/openwallet-foundation-labs/eudiplo.git
cd eudiplo
# Create .env with demo credentials
cp .env.example .env
echo "MASTER_SECRET=$(openssl rand -base64 32)" >> .env
echo "AUTH_CLIENT_ID=demo" >> .env
echo "AUTH_CLIENT_SECRET=demo-secret" >> .env
# Start services
docker compose up -d
# Access the services
# Backend API: http://localhost:3000
# Client UI: http://localhost:4200# Clone and configure
git clone https://github.com/openwallet-foundation-labs/eudiplo.git
cd eudiplo
cp .env.example .env
# Configure secure authentication (all three are REQUIRED)
echo "MASTER_SECRET=$(openssl rand -base64 32)" >> .env
echo "AUTH_CLIENT_ID=my-client" >> .env
echo "AUTH_CLIENT_SECRET=$(openssl rand -base64 24)" >> .env
# Start both backend and client with Docker Compose
docker compose up -d
# Access the services
# Backend API: http://localhost:3000
# Client UI: http://localhost:4200# Run just the backend
docker run -p 3000:3000 \
-e PUBLIC_URL=https://example.com \
-e MASTER_SECRET=your-32-character-secret \
-e AUTH_CLIENT_ID=your-client-id \
-e AUTH_CLIENT_SECRET=your-client-secret \
-v $(pwd)/assets:/app/config \
ghcr.io/openwallet-foundation-labs/eudiplo:latest
# Run the client (optional - web interface)
docker run -p 4200:80 \
-e API_BASE_URL=http://localhost:3000 \
ghcr.io/openwallet-foundation-labs/eudiplo-client:latest# Install dependencies
pnpm install
# Start backend
pnpm --filter @eudiplo/backend run start:dev
# Start client (in another terminal)
pnpm --filter @eudiplo/client run dev# 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/oauth2/token \
-H "Content-Type: application/json" \
-d '{
"client_id": "your-client-id",
"client_secret": "your-client-secret"
}'📚 API:
https://openwallet-foundation-labs.github.io/eudiplo/latest/api/
📦
Full setup:
Quickstart Guide
Choose your documentation version:
- 🚀 Latest Stable (recommended): https://openwallet-foundation-labs.github.io/eudiplo/latest/ - Documentation for the most recent major release
- 🔬 Development: https://openwallet-foundation-labs.github.io/eudiplo/main/ - Latest features from the main branch
- 📚 Specific Major Versions: v1, v2, etc.
Key sections:
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.
Licensed under the Apache 2.0 License