Carte Bleue

Physical-card wallet recovery demo

Local-Only By Design

Carte Bleue is intentionally not deployed as a public live demo. The project needs a local Python server, direct access to a PC/SC smart card reader, and a real compatible bank card in order to read EMV data and request signatures from the card.

This is expected behavior, not a missing feature. Browsers cannot directly access smart card readers on a hosted website, so the demo must run on the same machine as the reader.

If you want to try the project yourself, the repository README explains the full setup: installing dependencies, running the FastAPI server locally, connecting MetaMask on Base, and using either the direct recovery demo or the ENS/Basename-backed recovery demo.

Open GitHub README Open Repository

What You Need

  1. A compatible PC/SC smart card reader and a supported card.
  2. Python and Foundry installed locally.
  3. MetaMask connected to Base with a small amount of ETH for gas.
  4. The setup steps from the README to run python main.py on your own machine.

Once the local server is running, the main demos are available at /demo and /ens-demo on your machine.