Demo Architecture

The demo system showcases a complete credential verification flow:

1. Demo Webapp — a Relying Party SPA that requests credentials
2. Credential Verifier — the backend that cryptographically verifies presentations
3. Wallet — a mobile wallet app (EUDI Wallet, France Identité, or Age Verification App)

System Architecture

flowchart LR
    subgraph Browser["Browser"]
        Webapp["Demo Webapp<br/>TypeScript SPA"]
    end

    subgraph Server["Server"]
        Verifier["Credential Verifier<br/>Rust / actix-web"]
    end

    subgraph Mobile["Mobile Device"]
        Wallet["EUDI Wallet"]
    end

    Webapp -->|Init transaction| Verifier
    Webapp -->|Display QR code| Wallet
    Wallet -->|Scan QR, present credential| Verifier
    Webapp -->|Poll status| Verifier
    Verifier -->|Signed attestation| Webapp

The credential verifier serves both the verifier API and (when the admin UI is enabled) the embedded SPA at the root URL.

Setting Up

1. Start the Credential Verifier

cargo run -p ewqwe_credential_verifier_server -- \
  crates/ewqwe-credential-verifier-server/credential-server.toml

The development config uses HTTP on port 9888 with authentication disabled.

2. Start the Demo Webapp

cd typescript
pnpm install
pnpm --filter @ewqwe/digital-identity build
pnpm --filter @ewqwe/demo-webapp dev

The webapp runs at https://localhost:5174 and proxies API calls to the verifier.

3. Run a Wallet

For full end-to-end testing, you need a wallet on a mobile device (physical or emulator):

• EUDI Wallet — see EUDI Wallet on Android Studio
• Age Verification App — see Age Verification App on Android Studio
• France Identité — see France Identité Wallet

For local network setup connecting the emulator to the verifier, see Local Network Setup.

Port Assignments

Next Steps

• User Journey — detailed protocol flows
• Protocols & Formats Summary — standards reference
• Credential Verifier Server — server configuration