Skip to main content

Wallet Use Instructions

Developers testing with the National EUDI Wallet in the Sandbox should be aware of the following details, peculiarities and known bugs.

Wallet Set-Up and Operation​

Distribution and Installation​

The Closed Beta wallet is distributed via TestFlight, and later via the Google Beta Store as well.

Testflight Configuration

TestFlight should be configured to automatically install updates.

During the Closed Beta phase, updates will be frequent, and not announced in advance.

  • Always verify the wallet version when testing or reporting issues.
  • Re-test issues after installing the latest update.

Wallet Functionality and Quirks​

This section documents current wallet behavior that may be surprising, non-obvious, or different from production expectations, but is considered expected behavior for the closed beta. These items are not bugs, but known characteristics or limitations of the wallet at this stage.

Simulated eID Card PID Issuance​

For the benefit of testing, the wallet offers PID issuance with a simulated eID, that doesn't require a physical testing card. Note that with a simulated eID PID issuance, any PIN you enter will be accepted.

To issue your simulated eID:

  1. Open the wallet app.
  2. Toggle the Use simulated eID card option.
  3. Click Get Started.
  4. When prompted, select Yes, ID card is available.
  5. When prompted, select Yes, card PIN is set and known.
  6. The wallet will display the ID card data that will be shared. To continue, select Agree by entering your card PIN.
  7. When prompted, enter any 6 digit PIN.
    • Android Only: When prompted to scan an ID, tap the screen to proceed. On iOS you proceed automatically.
  8. Finally, set your Wallet PIN when prompted. This PIN will be required for any presentation request when testing.

Credential Usage Limits​

In the National EUDI Wallet, PIDs are single-use credentials to combat linkability. The current batch limit is 10 presentations per issuance event. Once the limit is reached, further presentations will fail. The credential must be reissued before it can be used again. This behavior is expected and should be accounted for in test scenarios.

Log Exports​

To export the Wallet Logs for debugging purposes, enter the hamburger menu in the Wallet App. Press "Download Logs" to download a text file.

SD-JWT vc_values​

The vct_values for a PID Presentation Request in SD-JWT format uses the following value for the German PID Provider: urn:eudi:pid:de:1.

In the long run, relying parties across Europe can query for a PID from any member state using the vct_value urn:eudi:pid:1.

Known Bugs and Temporary Workarounds​

Known bugs are tracked in the respective issue tracker for each platform. Be aware that these lists could be mildly out of date and some issues may have already been resolved.