# Debian/Ubuntu
sudo apt-get install libpcsclite-dev pcscd

# Fedora/RHEL
sudo dnf install pcsc-lite-devel pcsc-lite

# 启动 PC/SC 守护进程
sudo systemctl start pcscd
sudo systemctl enable pcscd

# 构建并运行单元测试
make

# 或直接使用 zig
zig build test

# 运行模拟器集成测试
zig build test -Dintegration_sim=true

# 构建示例（需要安装 PC/SC 库）
zig build examples -Dlink_pcsc=true

# 默认构建 — std.crypto 后端，无 OpenSSL 链接
zig build test

# FIPS 构建 — OpenSSL FIPS 提供程序（先运行 `make deps` from fips）
OPENSSL_CONF=/usr/local/ssl/ssl/openssl.cnf \
  zig build test -Dfips=true -Dopenssl_path=/usr/local/ssl

# 两种模式一次完成
make test-dual

# 生产构建（安全，环境变量被忽略）
zig build

# 开发构建（允许 HSM_PCSC_LIB_PATH）
zig build -Dallow_pcsc_env_override=true

const std = @import("std");
const hsm = @import("hsm");

pub fn main() !void {
    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
    defer _ = gpa.deinit();
    const allocator = gpa.allocator();

    // 列出可用令牌
    const tokens = try hsm.listTokens(allocator, false);
    defer {
        for (tokens) |*t| t.deinit();
        allocator.free(tokens);
    }

    if (tokens.len == 0) {
        std.debug.print("未找到令牌\n", .{});
        return;
    }

    // 打开第一个令牌
    var token = try hsm.openToken(allocator, tokens[0].id, .{});
    defer token.close();

    // 验证 PIN
    try token.verifyPin("123456");

    // 读取证书
    const cert = try token.getCertificate(.authentication);
    defer allocator.free(cert);
    std.debug.print("证书：{} 字节\n", .{cert.len});

    // 签名摘要
    var digest: [32]u8 = undefined;
    std.crypto.hash.sha2.Sha256.hash("Hello, PIV!", &digest, .{});

    const signature = try token.sign(.authentication, .ecdsa_p256, &digest);
    defer allocator.free(signature);
    std.debug.print("签名：{} 字节\n", .{signature.len});
}

# 运行所有单元测试
zig build test

# 运行模拟器测试
zig build test -Dintegration_sim=true

# 只读测试（证书读取）
HSM_HIL=1 zig build test -Dhsm_hil=true

# 需要 PIN 的测试
HSM_HIL=1 HSM_PIN=123456 zig build test -Dhsm_hil=true

# 危险测试（写操作） - 请谨慎使用
HSM_HIL=1 HSM_PIN=123456 HSM_DANGEROUS=1 zig build test -Dhsm_hil=true

# 持续模糊测试（手动停止）
zig build test --fuzz -- --test-filter fuzz

# 构建示例（需要安装 PC/SC 库）
zig build examples -Dlink_pcsc=true

# 列出令牌
./zig-out/bin/list_tokens
./zig-out/bin/list_tokens --sim  # 使用模拟器

# 使用 PIV 签名（PIN 通过交互式 TTY 提示输入）
./zig-out/bin/piv_sign
./zig-out/bin/piv_sign --sim

# 或通过环境变量提供 PIN（安全性较低）
HSM_PIN=123456 ./zig-out/bin/piv_sign --sim

zig build test                  # 默认：-Dwith_otel=false（空操作）
zig build test -Dwith_otel=true # 可选加入：发送跨度

const hsm = @import("hsm");

pub fn main() !void {
    // 将 Otel 值存放在稳定地址上——可以是 main() 栈帧中的 `var`
    // 以供进程生命周期使用，也可以是堆分配。该初始化辅助函数仅在
    // `-Dwith_otel=true` 时存在；在禁用的构建下，
    // hsm.observability_init 解析为空结构体，此块编译为空操作。
    if (comptime hsm.observability.enabled) {
        var otel = try hsm.observability_init.Otel.init(allocator, "my-service");
        defer otel.deinit();
        otel.installGlobals();
    }
    // ... main 的其余部分，包括任何 hsm.Token.sign 调用——每个调用
    // 现在都会发出一个附加到您服务的 `hsm.sign` 跨度。
}

zig build test                                 # 默认标志 = false
zig build test -Dwith_otel=true                # 标志开启
scripts/verify-consumer-noop.sh                # 符号泄漏检查

src/
├── hsm.zig              # 主 API 和类型
├── root.zig             # 模块入口点
├── apdu.zig             # APDU 编码/解码
├── tlv.zig              # BER-TLV 解析
├── parallel.zig         # 并行操作（thread_pool）
├── pcsc/
│   └── pcsc.zig         # PC/SC 传输层（Linux/macOS/Windows）
├── piv/
│   └── piv.zig          # PIV 实现
├── cac/
│   └── cac.zig          # CAC 实现
├── yubikey/
│   └── yubikey.zig      # YubiKey 检测
└── sim/
    ├── sim.zig          # 模拟器入口点
    ├── transport.zig    # 模拟传输层
    ├── piv_card.zig     # 模拟 PIV 卡
    └── key_material.zig # 嵌入式测试密钥

tests/
├── integration.zig      # 基本集成测试
├── sim_integration.zig  # 模拟器集成测试
└── hil_tests.zig        # 硬件在环测试

examples/
├── list_tokens.zig      # 令牌发现示例
└── piv_sign.zig         # 签名示例