vereemo-bridge

Connect a USB NFC reader (ACR122U) to the Vereemo POS Simulator in one command.

Quick Start

npx vereemo-bridge <SESSION_ID>

The SESSION_ID is displayed in the POS Simulator when you select "Tap to Verify".

Requirements

• Node.js 18+
• ACR122U USB NFC reader (or compatible PC/SC reader)
• PC/SC driver installed:
  • macOS: built-in
  • Windows: installed with the ACR122U driver
  • Linux: sudo apt install pcscd libpcsclite-dev

How It Works

1. Open the POS Simulator → select Tap to Verify → note the session ID
2. Plug in your ACR122U reader
3. Run npx vereemo-bridge ABC123 (replace with your session ID)
4. Tap an Android phone with the Vereemo app → identity verified in the browser ✅

What Happens Under the Hood

1. The CLI connects to a Supabase Realtime channel keyed by the session ID
2. When a phone is tapped, it sends a SELECT APDU with the Vereemo AID
3. The phone's HCE service responds with the wallet token
4. The CLI broadcasts the token to the browser via the Realtime channel
5. The POS Simulator receives the token and verifies it against the API