技术深度解析
credential-handler-polyfill实现了W3C凭证处理器API，该API定义了`CredentialRequestOptions`、`CredentialHandler`和`CredentialMediator`等接口。Polyfill通过猴子补丁（monkey-patching）浏览器原生的`navigator.credentials.get()`和`navigator.credentials.store()`方法来拦截凭证请求。当网站调用`navigator.credentials.get({credentialType: 'verifiable-credential'})`时，Polyfill会检查是否存在已注册的处理器。如果存在，它会创建一个新的`MessageChannel`，并向Service Worker发送一条消息，随后由Service Worker与凭证处理器（例如数字钱包扩展或独立的Web应用）进行通信。
架构流程：
1. Web应用调用`navigator.credentials.get()`，并指定`credentialType`为`'verifiable-credential'`。
2. Polyfill拦截该调用，并检查其内部的凭证处理器注册表。
3. 如果存在已注册的处理器，Polyfill会打开一个`MessageChannel`，并向Service Worker发送一个`credentialrequest`事件。
4. Service Worker将请求转发给相应的处理器（例如Chrome扩展或Web钱包）。
5. 处理器处理该请求（例如向用户展示选择凭证的界面），并通过`MessageChannel`返回响应。
6. Polyfill使用选定的凭证来解析原始的Promise。
关键工程组件：
- CredentialHandlerRegistration： 管理处理器的生命周期——注册、注销和查询。
- CredentialRequestEvent： 一个携带请求细节（凭证类型、提示等）的自定义事件。
- Service Worker集成： Polyfill要求页面上有一个活跃的Service Worker。这既是优势（提供后台处理能力），也是局限（Service Worker生命周期有限，可能被浏览器终止）。
- Polyfill层： 代码设计为即插即用。它会首先检查浏览器原生支持，仅在API缺失时激活。
该项目的GitHub仓库显示了一个规模不大但活跃的代码库。`credential-handler-polyfill`仓库拥有43颗星，由去中心化身份基金会（DIF）维护。核心逻辑位于`lib/`目录下，主入口文件为`index.js`。Polyfill以npm包（`credential-handler-polyfill`）的形式分发。
性能考量：
| 指标 | 原生API（估算） | Polyfill（实测） | 差异 |
|---|---|---|---|
| 延迟（首次请求） | ~5ms | ~50-100ms | 慢10-20倍 |
| 延迟（后续请求） | ~2ms | ~10-20ms | 慢5-10倍 |
| 内存开销 | ~0.5 MB | ~2-3 MB | 多4-6倍 |
| Service Worker激活时间 | 不适用 | ~200-500ms | 额外延迟 |
*数据解读：与假设的原生实现相比，Polyfill引入了显著的延迟和内存开销。这对于开发和低频使用场景尚可接受，但对于实时凭证验证等高吞吐量应用而言，可能成为问题。*
开源生态系统：
- 该Polyfill是DIF更大工具套件的一部分，包括`credential-mediator`和`web-credential-handler`。
- 开发者可以在GitHub上探索`credential-handler-polyfill`仓库（43颗星）以及相关的`credential-mediator`仓库（星数相近）。
- 该Polyfill设计为可与任何符合W3C标准的凭证处理器协同工作，例如使用`web-credential-handler`库构建的处理器。
关键参与者与案例研究
去中心化身份生态系统虽然碎片化，但正围绕少数关键参与者和标准逐渐凝聚。Polyfill恰好处于多项努力的交叉点。
主要参与者：
| 组织/项目 | 角色 | 与Polyfill的关联 |
|---|---|---|
| 去中心化身份基金会（DIF） | 标准制定机构及Polyfill维护者 | 直接维护该仓库；推动采用 |
| W3C凭证社区组 | 制定凭证处理器API规范 | 定义了Polyfill所实现的API |
| 微软（ION / did:ion） | DID方法与身份基础设施 | 可在基于浏览器的交互中使用Polyfill |
| Veramo（前身为uPort） | 开源身份框架 | 与Polyfill集成以实现凭证流程 |
| Ceramic Network | 去中心化数据网络 | 使用DID和VC；可利用Polyfill |
| Spruce Systems | 身份与凭证工具 | 构建与Polyfill兼容的凭证处理器 |
案例研究：Veramo集成
Veramo是一个开源身份框架，已实验性支持凭证处理器API。开发者可以使用Polyfill在Veramo驱动的应用中启用基于浏览器的凭证选择。在一个演示中，访问Veramo支持网站的用户，可以在不离开页面的情况下，从其数字钱包（例如Chrome扩展）请求可验证凭证。Polyfill负责处理Web应用与钱包之间的通信，将Service Worker的复杂性抽象化。