1
0
Fork
You've already forked smartcard
0
Smart Card Communication
  • Zig 50.2%
  • C 48.8%
  • HTML 0.8%
  • Nix 0.2%
Quint Daenen 0ea0073485 refactor: replace webview dependency with zuil for GUI example 
Remove the internal webview C++ wrapper (src/webview.zig) and switch
the desktop GUI example to use zuil, a Zig-native UI library. The
example is now macOS-only and uses a simpler message-based API
instead of the webview bind/return pattern.
2026年04月07日 09:08:37 +02:00
.github/workflows feat: add cross-platform support for Linux and Windows ( #1 ) 2026年03月12日 10:42:21 +01:00
example refactor: replace webview dependency with zuil for GUI example 2026年04月07日 09:08:37 +02:00
spec feat: initial project setup 2026年03月12日 08:57:39 +01:00
src refactor: replace webview dependency with zuil for GUI example 2026年04月07日 09:08:37 +02:00
.gitignore feat: add certificate chain and data signature verification for belpic 2026年03月30日 14:20:23 +02:00
build.zig refactor: replace webview dependency with zuil for GUI example 2026年04月07日 09:08:37 +02:00
build.zig.zon refactor: replace webview dependency with zuil for GUI example 2026年04月07日 09:08:37 +02:00
flake.lock feat: initial project setup 2026年03月12日 08:57:39 +01:00
flake.nix feat: add cross-platform support for Linux and Windows ( #1 ) 2026年03月12日 10:42:21 +01:00
LICENSE feat: initial project setup 2026年03月12日 08:57:39 +01:00
README.md feat: add Belgian eID (belpic) card support 2026年03月30日 13:20:30 +02:00

smartcard

Experimental Zig library for smart card communication. This is a personal project for playing around with card readers and is provided as-is with no guarantees.

  • pcsc -- direct card access via the platform PC/SC provider (no dependencies)
  • pkcs11 -- bindings for PKCS#11 v3.1 middleware
  • iso7816 -- ISO 7816-4 APDU command building and response parsing
  • tlv -- BER-TLV (ISO 7816-4 Annex D) encoding and decoding
  • belpic -- Belgian eID card support (identity, address, photo, certificates, PIN, signing)

Platform

OS PC/SC provider Status
macOS PCSC.framework (built-in) Tested
Linux pcsclite (libpcsclite-dev) Tested
Windows winscard (built-in) Tested

Usage

PC/SC (direct card access)

constpcsc=@import("smartcard").pcsc;constctx=trypcsc.Context.establish(pcsc.SCARD_SCOPE_SYSTEM);deferctx.release();constreaders=tryctx.listReaders(allocator);constcard=tryctx.connect(readers[0],pcsc.SCARD_SHARE_SHARED,pcsc.SCARD_PROTOCOL_ANY);defercard.disconnect(pcsc.SCARD_LEAVE_CARD);// Send an APDUvarrecv_buf:[256]u8=undefined;constresponse=trycard.transmit(&apdu,&recv_buf);

PKCS#11 (middleware)

constpkcs11=@import("smartcard").pkcs11;varlib=trypkcs11.Library.load("/path/to/pkcs11-middleware.so");deferlib.close();trylib.initialize(null);deferlib.finalize()catch{};constinfo=trylib.getInfo();

Examples

Read a Belgian eID card (requires a connected card reader). Tested with an ACS ACR122U (AC6020) USB reader.

zig build belpic

Testing

zig build test

PKCS#11 tests run against SoftHSM2 if available. If softhsm2-util is not on PATH, those tests are skipped. PC/SC tests require a running smartcard daemon and skip gracefully if unavailable.

On Linux, install the pcsclite development headers:

sudo apt install libpcsclite-dev # Debian/Ubuntu

References