# DOME Digital Wallet User Guide

Guide to use the DOME Digital Wallet.

# Introduction to the DOME Digital Wallet

The DOME Digital Wallet is an essential tool for managing your digital identity within the DOME Marketplace. It enables secure interactions by allowing users to store, manage, and utilize digital credentials effectively. This wallet supports various functionalities including signing in, credential management, and QR code scanning for credential verification or issuance. Access the wallet by visiting [DOME Digital Wallet](https://wallet.dome-marketplace.eu).

For a detailed walkthrough on setting up your account and the initial steps to access the DOME Marketplace, please refer to the official [Onboarding Guide](https://github.com/DOME-Marketplace/onboarding/tree/official-csp-participants-onboarding). This guide will help you understand the prerequisites and steps to get started with DOME.

# Registering on the DOME Digital Wallet

In the SBX environment, the Wallet user registration is disabled. Use the [PRD Wallet](https://wallet.dome-marketplace.eu). See the [PRD Guide](https://knowledgebase.dome-marketplace.eu/books/dome-digital-wallet-user-guide/page/registering-on-the-dome-digital-wallet).

If for some specific reason you need to use the [SBX Wallet](https://wallet.dome-marketplace-sbx.org/), you can open a ticket in the [ticketing support system](https://ticketing-int.dome-marketplace.eu/).

# Forgot Password Process

- **Access the Forgot Password Link**:
    
    
    - On the login page, click the 'Forgot password' link if you cannot remember your password.
        
        [![Forgot Password Link](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/wallet-1.png "Clicking 'Forgot password'")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/wallet-1.png)
- **Submit Your Email Address**:
    
    
    - Enter your registered email address where prompted to receive a password reset link.
        
        [![Enter Email](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/forgot-password-1.png "Entering Email Address")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/forgot-password-1.png)
- **Confirmation Message**:
    
    
    - After submitting your email, you will see a message confirming that an email has been sent to you with the reset link.
        
        [![Email Confirmation](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/forgot-password-2.png "Confirmation of Email Sent")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/forgot-password-2.png)
- **Check Your Email**:
    
    
    - Open your email to find the password reset message. Click the link provided within the email to proceed with resetting your password.
        
        [![Reset Email](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/forgot-password-3.png "Email with Reset Link")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/forgot-password-3.png)
- **Reset Your Password**:
    
    
    - Follow the link from your email to a secure page where you can enter a new password.
        
        [![Enter New Password](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/forgot-password-4.png "Entering New Password")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/forgot-password-4.png)
- **Confirmation of Password Reset**:
    
    
    - Once you have successfully reset your password, you will receive a confirmation on the screen indicating that your password has been changed.
        
        [![Password Changed Confirmation](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/forgot-password-5.png "Password Change Confirmation")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/forgot-password-5.png)

# Main Functionalities of the Wallet

### QR Scan Functionality

- **General Use**:
    
    
    - The QR Scan function is used to scan QR codes provided by a third party, which can trigger processes for **obtaining** or **presenting** credentials. To initiate a scan, press the 'Scan QR' button to deploy the camera.
        
        [![QR Scan Functionality](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/wallet-5.png "Using the QR Scan Function")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/wallet-5.png)
- **Scanning Process**:
    
    
    - After pressing the 'Scan QR' button, align the QR code within the camera to scan it. This will trigger the specific process linked to the QR code.

### Credential Issuance Process

- **PIN Verification**: 
    - If the credential issuance process includes PIN verification (used for additional security), you will be prompted to enter a PIN **after scanning the QR code**, that you have received through a communication channel specified by the issuer.
        
        [![Enter PIN](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/wallet-6.png "Entering PIN during Credential Issuance")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/wallet-6.png)

### Credential Presentation Process

- **Automatic Credential Display for Specific Types**: 
    - When required to present a credential, the wallet automatically displays all available credentials of the type required for the transaction or verification. Select the appropriate credential you wish to present and confirm the action. If the presentation is successful, a confirmation pop-up will appear, indicating a successful transaction or verification.
        
        [![Present Credential](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/wallet-vc-login-1.png "Automatically Presenting Specific Credential Types")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/wallet-vc-login-1.png)

### Credential Deletion

- **Deleting a Credential**: 
    - If you choose to delete a credential, simply press the trash icon on the credential. Be aware that once a credential is deleted, it cannot be recovered, so you must obtain a new one through the issuance process if needed.
        
        [![Delete Credential](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/trash-icon.png "Deleting a Credential")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/trash-icon.png)

### Language Settings

- **Changing Language**: 
    - You can change the language of the wallet interface by going to the settings and selecting your preferred language. Currently, the wallet supports English, Spanish, and Catalan.
        
        [![Language Settings](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/language-selector.png "Changing Language")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/language-selector.png)

# Troubleshooting Common Issues

### Camera Not Activating for QR Scan

If the camera does not activate when you attempt to use the **Scan QR** function, follow these troubleshooting steps to resolve the issue:

#### Navigate to Settings

- Within the DOME Wallet app, navigate to the **Settings** section. [![Navigate to Settings](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/DOME_Wallet_Settings_Page.png "Navigating to Settings")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/DOME_Wallet_Settings_Page.png)

#### Access Camera Settings

- Find and select the **Camera** option to configure your camera settings. [![Camera Settings](https://github.com/DOME-Marketplace/wallet-guide/raw/initial-wallet-guide/assets/Dome_Wallet_Camera_Selector.png "Camera Settings")](https://github.com/DOME-Marketplace/wallet-guide/blob/initial-wallet-guide/assets/Dome_Wallet_Camera_Selector.png)

#### Select Your Camera

- Choose your preferred camera for QR scanning. If you have more than one camera, you may need to select which one to use.

#### Ensure Camera Permissions are Enabled

- Make sure the DOME Wallet app has the necessary permissions to access the camera in your device's settings. 
    - On Android: Go to Settings &gt; Apps &gt; Your Browser Permissions and ensure the Camera permission is enabled.
    - On iOS: Go to Settings &gt; Privacy &gt; Camera, find Your Browser and ensure the toggle is enabled.

#### Retry QR Scan

- Return to the home screen and try to scan the QR code again.

#### Reset Camera Permissions (Optional)[](https://github.com/DOME-Marketplace/wallet-guide/tree/initial-wallet-guide#reset-camera-permissions-optional)

- If the issue persists, you can try resetting your camera permissions: 
    - Go to your device's App Permissions settings.
    - Find the DOME Wallet app and remove the camera permissions.
    - Reopen the app and grant camera permissions again when prompted.

#### Restart Your Device[](https://github.com/DOME-Marketplace/wallet-guide/tree/initial-wallet-guide#restart-your-device)

- If the problem continues, try restarting your device. This can refresh system processes that may be preventing the camera from functioning correctly.

#### Update Your Browser[](https://github.com/DOME-Marketplace/wallet-guide/tree/initial-wallet-guide#update-your-browser)

- Ensure that you are using the latest version of your browser. Check your app store for any available updates, as newer versions may include fixes for known issues.

#### Check for System Updates[](https://github.com/DOME-Marketplace/wallet-guide/tree/initial-wallet-guide#check-for-system-updates)

- If your device's operating system is outdated, it may cause compatibility issues. Check for any available system updates in your phone's settings and install them if necessary.

#### Contact Support[](https://github.com/DOME-Marketplace/wallet-guide/tree/initial-wallet-guide#contact-support)

- If none of these steps resolve the issue, you may need to open a ticket for further assistance ([https://ticketing.dome-marketplace-prd.org](https://ticketing.dome-marketplace-prd.org)).

By following these steps, you should be able to resolve any issues with the camera not activating for QR code scanning.