# CVIN · 算力资产登记与解析协议

> CVIN 给每一颗 GPU 一个跨运营方、全球唯一、机器可验证的身份（Compute Asset Verification & Identification Number），
> 并让它被合同、保单与 Agent 引用。相当于 GPU 世界的 VIN 码 + 解析层。
> 本规范作为 rentgpu 行情数据交换规范 v0.1 的「机况维度」扩展发布。

当前登记表：667 条观测记录 / 297 个已登记 ID。

## 合成数据披露（必读）
- 其中 442 条为 synthetic 标记的种子数据，占比 66.27%；真实观测 225 条。
- 设备级与型号级**分开计算**：设备级 459 条（真实 17 条），型号级 208 条（真实 208 条）。
- 型号级记录是「平台对某型号的报价」（身份级 M），**不指向任何一台设备**，不可用于抵押、核保、入池，也无法升级为设备级身份。
- 阶段 0 目标：合成占比降到 10% 以下，当前还差 3753 条真实观测。
- 机器可读：GET https://cvin.org/v1/provenance

## 给 Agent 的关键事实
- CVIN 格式：cvin:<mfr>.<model>.<form>.<mem>:<serial-hash-16>，例：cvin:nv.h100.sxm.80g:7f3k9d2m8x1q4p6a
- serial-hash-16 是序列号的 SHA-256 截断（不可逆），因此 CVIN 不泄露机主资产清单
- 登记表 append-only + 哈希链：改一个字节就断链，任何人可独立重放验证
- 身份分级：M 型号级供方挂牌（不是设备，无法升级）/ L0 挂牌指纹（不能断言是同一台物理设备）/ L1 序列号可观测（同一物理设备跨运营方同一 ID）/ L2 硬件信任根（设备用 ed25519 密钥自证）
- L0 与 M 都不参与抵押登记、保险核保、资产池入池等任何以「这台设备」为主体的法律行为
- resolve 永久免费、无限次；完整历史与连续性证明按次 $0.05 或订阅
- 事件流、合同条款模板、抵押物清单生成永久免费（地基层，壁垒在连续性与可重放，不在收费）

## 端点
- GET https://cvin.org/v1/resolve/{cvin} — 存在性 + 摘要 + 身份分级（永久免费）
- GET https://cvin.org/v1/history/{cvin} — 完整观测历史 + 哈希链（订阅 / $0.05 按次，x402）
- GET https://cvin.org/v1/verify/{cvin} — 连续性证明：哈希链重放 + ed25519 签名（订阅 / $0.05 按次）
- POST https://cvin.org/v1/declare — 运营方自助声明（写入永远免费）
- POST https://cvin.org/v1/promote — L0 → L1 升级：提交序列号证据（写入永远免费）
- POST https://cvin.org/v1/attest — 设备签名遥测证明，L1 → L2（写入永远免费）
- GET https://cvin.org/v1/levels — 身份分级定义与升级路径（免费）
- GET https://cvin.org/v1/identity/{cvin} — 单个设备的身份级别与升级建议（免费）
- GET https://cvin.org/v1/events — 结构化事件流，支持 since 增量与 ndjson（永久免费）
- GET https://cvin.org/v1/clauses — 合同条款模板 JSON（永久免费）
- GET https://cvin.org/v1/clauses.txt — 合同条款模板纯文本（永久免费）
- GET https://cvin.org/v1/risk/signals — 风险信号计数；事件数过 200 阈值后才发布比率（免费）
- GET https://cvin.org/v1/permits?cvin=…&use=抵押登记 — 某级别能否用于某用途（免费）
- GET https://cvin.org/v1/provenance — 数据出处与合成数据占比（红线自检接口，免费）
- GET https://cvin.org/v1/governance — 委员会席位、表决门槛、交权清单（免费）
- GET https://cvin.org/v1/governance/redlines — 六条红线的可复算判定（免费）
- GET https://cvin.org/v1/rfcs — 提案与公示期（事实源为仓库 rfcs/*.md，免费）
- POST https://cvin.org/v1/schedule — 抵押物清单生成：逐台给出能否设押的结论（免费）
- POST https://cvin.org/v1/watch — webhook：指定 CVIN 出现新观测即推送（订阅）
- GET https://cvin.org/v1/stats — 登记表统计（免费）
- POST https://cvin.org/mcp — MCP JSON-RPC：cvin_resolve / cvin_history / cvin_verify / cvin_encode

## 页面
- https://cvin.org/ 首页与在线解析
- https://cvin.org/spec 规范 v0.1（编码 + schema + 哈希链 + 隐私）
- https://cvin.org/levels 身份分级 L0 / L1 / L2
- https://cvin.org/events 事件流（违约率指数的地基）
- https://cvin.org/clauses 合同条款模板（PO / 租赁 / 抵押 / 保险 / RWA 入池，中英双语）
- https://cvin.org/schedule 抵押物清单生成器（逐台给出能否设押的结论）
- https://cvin.org/provenance 数据出处与合成数据占比
- https://cvin.org/council 规范委员会：席位、表决门槛、交权清单、红线自检
- https://cvin.org/rfcs RFC 提案与公示期
- https://cvin.org/dictionary 数据字典（受控词表）
- https://cvin.org/declare 运营方自助登记
- https://cvin.org/pricing 收费设计
- https://cvin.org/governance 治理章程与决策日志

## 边界（不做）
不做残值指数、不做期货结算基准、不做质量评级、不做人工机况评分、不出信用评分、不做责任认定、不做投资建议、不做设备价值评估。
事件流只提供分子侧的事件计数；违约率指数的定义与发布不由本服务负责。

## 第三方数据署名
型号级行情观测来自 rentgpu.link（GPU 算力雷达），遵循 GPUPLN v0.1，CC BY 4.0 授权，强制署名。
数据来源：rentgpu.link（GPU 算力雷达），CC BY 4.0 授权。https://rentgpu.link
Source: rentgpu.link (GPU rental price radar). Licensed CC BY 4.0. https://rentgpu.link