SCP Registry Control Plane Specification v0.1

SCP Canonical Attribute Registry 控制平面完整规范（详细版本）

版本：v0.1
状态：Production Protocol Specification（Detailed Version）
适用范围：SCP Vault Network / Canonical Attribute Registry / FQP / CRSP
日期：2026-02

---

一、协议目的（Purpose）

SCP Registry Control Plane 定义 Canonical Attribute Registry 的全局管理、同步、发现和治理机制。

Registry Control Plane 解决以下核心问题：

1. 如何统一管理 Canonical Attribute
2. 如何发现新 attribute
3. 如何同步 attribute metadata
4. 如何支持 Extensible Schema
5. 如何支持 Schema Evolution
6. 如何支持 FQP Query Planning

Registry Control Plane 不处理用户数据，仅处理 attribute metadata。

---

二、Control Plane 与 Data Plane 区别

SCP 架构分为：

Data Plane：

Vault Nodes
Federated Query Protocol
Canonicalization Pipeline

Control Plane：

Canonical Attribute Registry
Registry Synchronization Protocol
Registry Nodes
Registry Authority

Control Plane 负责管理 schema 和 metadata。

Data Plane 负责处理数据和查询。

---

三、Control Plane 架构组件

Control Plane 包含以下组件：

1. Registry Authority
2. Registry Nodes
3. Registry Index
4. Registry Synchronization Protocol（CRSP）
5. Global Registry
6. Local Registry
7. Network Registry

架构图：

Registry Authority
      │
      ▼
Global Registry
      │
      ▼
Registry Nodes
      │
      ▼
Network Registry Index
      ▲
      │
Vault Nodes (Local Registry)

---

四、Registry Authority（注册中心）

Registry Authority 负责：

维护 Global Registry

发布 registry updates

执行 schema evolution

Global Registry 示例：

canonical_registry_global.json

Authority 可以：

添加 attribute

升级 ext attribute 为 canonical attribute

---

五、Registry Nodes（Registry 节点）

Registry Nodes 是 metadata aggregation nodes。

职责：

接收 attribute announcements

维护 Network Registry Index

响应 registry query

Registry Nodes 不存储用户数据。

仅存储 metadata。

---

六、Registry Index（核心数据结构）

Registry Node 必须维护 registry_index 表：

CREATE TABLE registry_index (
    attribute TEXT PRIMARY KEY,
    domain TEXT,
    type TEXT,
    vault_count INTEGER,
    first_seen INTEGER,
    last_seen INTEGER
);

字段解释：

attribute：attribute 名称

domain：attribute domain

type：attribute 类型

vault_count：支持 attribute 的 Vault 数量

first_seen：首次发现时间

last_seen：最近 heartbeat 时间

---

七、Global Registry

Global Registry 是 protocol 定义的 attribute 集。

示例：

diagnosis_code
transaction_amount
receipt_total_amount

Global Registry 由 Registry Authority 发布。

---

八、Local Registry

Local Registry 是 Vault 本地扩展 attribute。

示例：

ext_commerce_charging_kwh

Local Registry 存储：

canonical_registry_local.json

Vault 自动维护。

---

九、Network Registry（网络级 Registry）

Network Registry 是所有 attribute metadata 的聚合索引。

由 Registry Nodes 维护。

Network Registry 包含：

attribute name

domain

type

vault_count

---

十、Registry Synchronization Protocol（CRSP）

CRSP 负责同步 registry metadata。

流程：

Vault discovers attribute

Vault sends AttributeAnnouncement

Registry Node updates registry_index

Coordinator queries registry_index

---

十一、Registry Discovery API

Coordinator 可以查询 Registry：

GET /registry/attributes

Response:

{
  "attributes": [
    {
      "attribute": "diagnosis_code",
      "domain": "health",
      "vault_count": 482342
    }
  ]
}

---

十二、Query Planning Integration

Coordinator 执行 FQP query 前：

Step 1

Query Registry

Step 2

Verify attribute existence

Step 3

Optimize query routing

---

十三、Schema Evolution（Schema 演进）

Schema Evolution 允许 ext attribute 升级为 canonical attribute。

流程：

Step 1

ext attribute 被广泛使用

Step 2

Registry Authority 发布更新

Step 3

attribute 升级为 canonical attribute

---

十四、Registry Governance

Registry Authority 可以：

添加 attribute

删除 attribute

升级 attribute

Governance 可以是：

DAO

Protocol governance

---

十五、安全模型（Security Model）

Registry metadata 必须签名

Registry Node 必须验证签名

防止恶意 attribute injection

---

十六、隐私模型（Privacy Model）

Registry Control Plane 不存储：

user identity

user data

attribute value

仅存储 metadata。

---

十七、Failure Handling

Registry Node failure：

其他 Registry Nodes 可继续服务

Vault offline：

vault_count 更新

---

十八、性能目标（Performance Targets）

支持：

10M Vault Nodes

100M attributes

---

十九、与 SCP 协议集成

Control Plane 支持：

Canonical Attribute Registry

CRSP

FQP

Canonicalization Pipeline

---

二十、完整 Control Plane 生命周期

Step 1

Vault canonicalizes data

Step 2

Vault updates local registry

Step 3

Vault publishes attribute announcement

Step 4

Registry Nodes update network registry

Step 5

Coordinator queries registry

Step 6

Coordinator executes FQP query

---

二十一、总结（Summary）

SCP Registry Control Plane 提供：

Registry management

Attribute discovery

Schema synchronization

Schema evolution

FQP query planning support

Registry Control Plane 是 SCP schema 管理核心。