Skip to content

Magellan

Magellan logo

Welcome to the documentation of our EUDI Verifier Playground. Our application is a tool designed for developers, testers, and integrators within the European Digital Identity Wallet (EUDIW) ecosystem. It allows you to simulate, test, and validate Verifiable Presentation interactions seamlessly.

The application is available at the following link : https://api.playground.france-identite.gouv.fr/magellan/verifier/

1. Overview & Supported Standards

Our Playground is fully compliant with the latest specifications of the European Architecture Reference Framework (EUDI ARF) and supports the following industry standards:

Category Supported Standards & Protocols Description & Use Case
Presentation Protocols OpenID4VP v1.0 Standardized exchange format for secure negotiation and transmission of verifiable credentials.
Query Languages DCQL (Digital Credentials Query Language) Query language with full support for defining complex queries and eligibility criteria (credential sets).
Credential Formats mso_mdoc (ISO/IEC 18013-5)
dc+sd-jwt (IETF)		 High-performance binary format optimized for driving licences (mDL) and selectively disclosable JSON Web Tokens.
Native Web APIs W3C Digital Credentials API (DC API) Experimental native operating system prompt mediated via the browser's navigator.credentials.get() call.
Security & Cryptography JWT-Secured Authorization Request (JAR)
JSON Web Encryption (JWE)
Device Binding Validation		 Guarantees request integrity, response confidentiality (encrypted payloads), and hardware-backed credential binding (cloning protection).

2. User Interface Guide

Our interface is designed to be intuitive, broken down into a fluid three-step journey.

Step 1: Selecting Documents & Attributes

On the homepage, you will find the list of use cases (Credentials) available on the verifier:

  1. Document Selection: Check the documents you wish to request from the wallet (e.g., PID, Age Verification).
  2. Attribute Selection (Claims): For each document, precisely check the requested attributes. By default, mandatory attributes are pre-selected. You can also click "Select All" to request everything.
  3. Sorting and Organization: Use the sorting buttons at the top of the list to organize your documents alphabetically (A-Z) or by technology (Format). You can click a second time on the active button to reverse the sort order (indicated by the ↑ / ↓ arrows).

Special Features:

  • Multiple Option (Multi-presentation): On each selected document card, a "Multiple" switch is available. If enabled, the verifier will allow the wallet to present several instances of this same document.
  • Dynamic Age Claims (eu.europa.ec.av.1): For the Age Verification credential, an input field appears below the list of attributes. Simply enter a two-digit number (e.g., 15) and click "Add claim" to dynamically generate the age_over_15 claim.

Step 2: Advanced Configuration — Credential Sets

When you select multiple documents, a "Credential Sets" button appears in the right footer. This tool allows you to configure the presentation logic:

  1. JSON Editing Modal: Clicking it opens a modal window with a pre-filled JSON editor.
  2. Interactive Legend: The top of the modal displays the exact mapping between technical identifiers and physical documents (e.g., cred-1 → PID [mso_mdoc]).
  3. Logic Presets:
    • AND Logic: Generates a JSON requiring all documents to be provided simultaneously in a single set.
    • OR Logic: Generates a JSON allowing the wallet to present any one of the selected documents (one document of choice).
    • You can edit the JSON yourself for more complex scenarios

Step 3: Starting the Verification

Once your selection is ready, you have two ways to start the verification depending on your device:

Option A: QR Code Verification (Cross-Device)

This is the default mode. Click on "Start Verification":

  1. QR Code: A QR code is displayed. Scan it with your European Digital Identity Wallet app on your smartphone.
  2. Deep Link (Same-Device): If you are testing directly from your smartphone, click on the QR code card to flip it over. On the back, the raw request URI is displayed as a clickable link.

Option B: Native Verification via DC API (Same-Device)

If you are testing from a compatible smartphone and the browser supports the W3C Digital Credentials API, the "Use Digital Credentials API" switch appears right above the start button:

  1. Toggle the switch on.
  2. Click on "Start Verification".
  3. A large, central "Verify with Local Wallet" button appears. Click it to trigger the DC API verification process.

3. Results Analysis & Diagnostic Tools

As soon as the wallet transmits the data, the Playground updates its screen in real-time to display the transaction result:

  • SUCCESS State: Verified presentations render custom document cards with decrypted claims. If a biometric photo is available, our integrated JPEG 2000 decoder extracts and renders the portrait. You can use the Replay button (or Ctrl+Click to edit the raw DCQL query in an interactive editor beforehand) to instantly re-run the session.
  • FAILED & EXPIRED States: Rejections or 30-second timeout sessions display explicit error screens. A collapsible JWT Diagnostic Panel at the bottom of the page allows developers to copy the raw request token or dynamically decode its payload JSON for instant debugging.
  • Local Session History: All transactions are automatically saved in the browser's localStorage. The floating history drawer (bottom left corner) lets you review past sessions, inspect raw request objects, or re-run historical flows at any time.

4. Contact and Support

If you have any questions, encounter issues, or need technical assistance testing our EUDI Verifier Playground, please feel free to reach out to our team:

  • Support Email: dl-id-hub-core@worldline.com
  • Feedback: We actively welcome suggestions for new credential schemas and custom validation criteria.