diff --git a/CLAUDE.md b/CLAUDE.md index 2706837..1e27acf 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -10,8 +10,12 @@ Rust 实现,单二进制、低依赖、可编进 TEE。 > **改名约定(前身 `nax-rs` → `ssw-mpc`)**:crate `mpc-*`、二进制 `mpc`、环境变量 `MPC_*`。 > 旧名指「N 方算术执行引擎(Rust 重写 Python 参考实现)」,新名指「多方数据协作下的安全计算」, > 定位不同;叙述以新名语义为准,Python 参考实现只作行为基线。 -> 协议域分隔常量(`nax/...`、`nax-psi-v1` 等)与 `refs/nax/` 路径是**兼容契约,禁止改名** —— -> 前者决定密钥/分片派生,后者是独立仓库的真实目录与 Python 包名(golden 脚本按此加载)。详见 README「命名沿革与兼容约定」。 +> 协议域分隔常量已统一到 `mpc-core::domain`(唯一真相源,`mpc/...` 前缀),2026-11-05 由 `nax/...` 全量切换。 +> **新增用途只在 `domain` 加常量,业务代码不要写裸字符串;改任一标签都是协议 breaking change**: +> 它参与会话密钥 / TEE 封存 / PSI 盲化 / 分片流派生,必须全参与方同步升级,并同步更新 README 迁移清单 +> (旧 blob、缓存、离线物料作废)。golden 向量是纯数学,不依赖这些标签。 +> 仍禁止改名的是 `refs/nax/` 路径与 Python 包名 `import nax` —— 独立只读仓库的真实目录 +> (golden 脚本按此加载)。详见 README「命名沿革与兼容约定」。 ## 三条铁律(优先级高于一切) diff --git a/README.md b/README.md index 5f756fb..a424ed8 100644 --- a/README.md +++ b/README.md @@ -14,12 +14,27 @@ 数据不出域、以密态参与运算,Python 参考实现退为行为基线,不再是复刻目标。 改名前基线 tag `nax-rs-final`,改名提交 tag `ssw-mpc-rename`,CI 全绿首版 tag `ssw-mpc-v0.1.0`。 -代码与文档里仍有少量 `nax` 字面量,是**刻意保留的兼容契约,不要顺手清理**: +### 协议域分隔常量:已全量切换(不兼容变更) + +2026-11-05 把 `nax/...`、`nax-psi-v1`、`nax-v1/derive` 等全部换成 `mpc` 前缀, +并**集中到 `mpc-core::domain`**(唯一真相源,业务代码不再写裸字符串;改动纪律见该模块文档)。 +这些标签参与会话密钥、TEE 封存密钥、PSI 盲化点、缓存指纹与分片随机流的派生, +**改一个字节就等于换钥**,因此: + +- 新旧版本**混跑会静默出错**(交集变空 / AEAD 解不开 / 分片和不回去),不会干净报错 —— + 所有参与方必须同时升级,不能灰度。 +- 已 provision 的 TEE 板子:`K_root` 对象名与派生密钥都变了,需重新 provision,旧 blob 作废。 +- PSI 缓存指纹变了,旧表按设计自动作废;跨版本复用的离线物料 / 分片需全量重生成。 +- 不提供旧 `nax` 标签的兼容读取 —— 双读只会让「这次到底走哪套」变成新的混乱源。 +- golden 向量(ring / paillier / zkp)是纯数学,**不依赖**这些标签,无需重生成; + `check_psi.py` 只比交集语义,也不受影响。 + +### 仍保留的 `nax`(不要顺手清理) | 类别 | 例子 | 原因 | |---|---|---| -| 协议域分隔常量 | `nax/tee/dev/v1`、`nax-psi-v1`、`nax-v1/derive` | KDF/HMAC 标签参与密钥与分片派生,改了会与已部署节点、Python golden 向量逐位不一致 | | 参考实现路径与包名 | `refs/nax/nax/...`、`import nax` | 独立只读仓库的真实目录与 Python 包名(`.gitignore` 已排除);`gen_golden.py` / `check_psi.py` / `bench_numpy.py` 按此路径加载,改了 golden 向量就生成不出来 | +| 沿革说明里的历史名 | `nax-rs`、`nax-rs-final`、`NAX_*` | 记录迁移来源,不是现行标识 | 部署迁移:`NAX_*` → `MPC_*`、`libnax_ray.so` → `libmpc_ray.so`、远端 `ssw/nax-rs.git` → `ssw/ssw-mpc.git`。 diff --git a/crates/mpc-core/src/domain.rs b/crates/mpc-core/src/domain.rs new file mode 100644 index 0000000..c280819 --- /dev/null +++ b/crates/mpc-core/src/domain.rs @@ -0,0 +1,95 @@ +//! 协议域分隔常量 —— 全框架唯一真相源。 +//! +//! KDF / HMAC / hash-to-curve / 承诺消息里用到的标签全部集中在这里, +//! 业务代码不允许再写裸字符串。理由不是「整齐」,是安全: +//! +//! 1. **域分隔的作用,是让同一把主密钥在不同语义下派生出不同字节**。 +//! 散在各处的手写字符串既看不出全集,也无法确认有没有撞车; +//! 而撞车等于两种不同用途复用了同一把子密钥。 +//! 2. **改一个字节 = 换钥**。这些标签参与会话密钥、TEE 封存 blob、 +//! PSI 盲化点、缓存指纹与分片随机流的派生,任何变更都会让旧数据与 +//! 新代码**静默对不上**(PSI 交集变空、AEAD 解不开、分片和不回去), +//! 而不是干净地报一个错。因此必须在同一处改、同一处审。 +//! +//! # 变更纪律 +//! +//! - 新增用途:在这里加常量,不要在业务代码里写 `b"..."`。 +//! - 改标签或版本:**协议 breaking change**,所有参与方必须同步升级; +//! 同步更新 README「命名沿革与兼容约定」的迁移清单,并写清旧缓存 / +//! blob / 离线物料如何作废。 +//! - 前缀统一 `mpc`,与 crate `mpc-*`、环境变量 `MPC_*` 一致。 +//! 2026-11-05 由前身 `nax/...` 全量切换,属一次性不兼容变更, +//! **旧 `nax` 标签不提供兼容读取** —— 留双读只会让「这次到底走哪套」 +//! 变成新的混乱源,与集中管理的目的相悖。 +//! - 标签有 `mpc/...` 与 `mpc-xxx-v1` 两种写法,是前身留下的结构差异; +//! 本次**只换品牌前缀、不改结构与版本号**,让消息长度与格式保持不变。 +//! 今后新增常量统一用 `mpc/用途/v1` 一种写法,不再制造第三种风格。 +//! - `nax` → `mpc` 是等长替换,所以 `mpc-tee` 的定长消息编码不受影响 +//! (长度已改为由 label 自动计算)。 +//! +//! # 长度敏感 +//! +//! [`TEE_COMMIT`] / [`TEE_EGRESS`] 参与定长消息编码。`mpc-tee` 的消息长度 +//! 常量直接由 `.len()` 计算,不要在别处另写一个数字。 + +/// 带标签派生(`hmac::derive_labeled`)的固定域前缀。 +pub const KDF_DERIVE: &[u8] = b"mpc-v1/derive"; + +/// ChaCha20 nonce 的派生标签:key 与 nonce 不复用同一段种子字节。 +pub const PRG_NONCE: &[u8] = b"mpc/chacha20/nonce"; + +/// 成对掩码种子派生标签,避免两方 ID 拼接歧义。 +pub const PRG_PAIR: &[u8] = b"mpc/pair"; + +/// 握手后 client → server 方向会话密钥的派生标签。 +pub const SESSION_C2S: &[u8] = b"mpc/session/c2s"; + +/// 握手后 server → client 方向会话密钥的派生标签。 +pub const SESSION_S2C: &[u8] = b"mpc/session/s2c"; + +/// ECDH-PSI 的默认 hash-to-point domain。按「关系」固定,不随会话变化, +/// 否则跨会话盲化缓存无法复用(见 `mpc-psi::cache`)。 +pub const PSI_DOMAIN: &[u8] = b"mpc-psi-v1"; + +/// PSI 盲化缓存的格式指纹;语义变了就递增,旧表自动作废。 +pub const PSI_CACHE_VERSION: &[u8] = b"mpc-psi-cache-v1"; + +/// 抗恶意硬化 PSI 的协议版本串,进 domain 与集合承诺。 +pub const PSI_STRICT_VERSION: &[u8] = b"mpc-psi-strict-v1"; + +/// 每作业会话种子的派生标签:作业名不同 → 种子不同,避免 Beaver 三元组跨作业重用。 +pub const JOB_SEED: &[u8] = b"mpc-job"; + +/// 设备侧分片随机流的派生标签。 +pub const SHARE_DEVICE: &[u8] = b"mpc/device/share"; + +/// 协议编排层分片随机流的派生标签(带轮次号一起进 label)。 +pub const SHARE_VAULT: &[u8] = b"mpc/share"; + +/// TEE 设备绑定标签:混入 Device DNA,同一 K_root 换芯片派生出不同密钥。 +pub const TEE_DEV: &[u8] = b"mpc/tee/dev/v1"; + +/// TEE 密封密钥(AEAD)派生标签。 +pub const TEE_ENC: &[u8] = b"mpc/tee/v1/enc"; + +/// TEE 签名密钥派生标签。 +pub const TEE_SIG: &[u8] = b"mpc/tee/v1/sig"; + +/// 输入承诺消息前缀:TEE 对这段字节签名,证明「这个时刻承诺了这份数据」。 +pub const TEE_COMMIT: &[u8] = b"mpc/commit/v1"; + +/// 出域策略判定消息前缀:TEE 对判定结果签名,审计链可验证。 +pub const TEE_EGRESS: &[u8] = b"mpc/egress/v1"; + +/// OP-TEE secure storage 里 K_root 的对象名(含 C 字符串结尾的 NUL)。 +/// 改名后读不到旧对象,已 provision 的板子必须重新 provision。 +pub const TEE_OBJ_ROOT: &[u8] = b"mpc.tee.root.v1\0"; + +/// 纯软件 TEE 替身的 seal 密钥派生标签,与真实 TA 同语义。 +pub const TEE_MOCK_SEAL: &[u8] = b"mpc/seal/v2"; + +/// 纯软件 TEE 替身的 attestation 报告密钥派生标签。 +pub const TEE_MOCK_ATTEST: &[u8] = b"mpc/attest"; + +/// 纯软件 TEE 替身的签名密钥派生标签。 +pub const TEE_MOCK_SIGN: &[u8] = b"mpc/sign"; diff --git a/crates/mpc-core/src/hmac.rs b/crates/mpc-core/src/hmac.rs index c9f9d61..527e44b 100644 --- a/crates/mpc-core/src/hmac.rs +++ b/crates/mpc-core/src/hmac.rs @@ -71,11 +71,11 @@ pub fn ct_eq(a: &[u8], b: &[u8]) -> bool { /// 从主密钥按标签 + 两段上下文派生一个 32 字节子密钥。 /// -/// 用固定的 `"nax-v1"` 前缀把派生域和其它用途(比如直接拿主密钥当 HMAC key) +/// 用固定的 `domain::KDF_DERIVE` 前缀把派生域和其它用途(比如直接拿主密钥当 HMAC key) /// 隔开,避免同一把密钥在不同语义下复用。 pub fn derive_labeled(master: &[u8; 32], label: &[u8], a: &[u8], b: &[u8]) -> [u8; 32] { let mut ctx = Sha256::new(); - ctx.update(b"nax-v1/derive"); + ctx.update(crate::domain::KDF_DERIVE); ctx.update(&[0u8]); ctx.update(label); ctx.update(&[0u8]); diff --git a/crates/mpc-core/src/lib.rs b/crates/mpc-core/src/lib.rs index 97c0c75..4e68449 100644 --- a/crates/mpc-core/src/lib.rs +++ b/crates/mpc-core/src/lib.rs @@ -18,6 +18,7 @@ //! # 分层 //! //! ```text +//! domain 协议域分隔常量(全框架唯一真相源;改一个字节 = 换钥) //! ring Z_2^64 定点算术 + 矩阵乘(唯一碰裸 u64 的模块) //! hash SHA-256(commitment / 种子派生 / attestation 摘要) //! hmac HMAC-SHA256 + 定长比较 + 带标签派生(握手认证用) @@ -41,6 +42,7 @@ extern crate alloc; pub mod aead; pub mod compare; +pub mod domain; pub mod hash; pub mod hmac; /// OS 熵源。**只在 `std` 下存在** —— TA 里没有 `/dev/urandom`,由宿主注入。 diff --git a/crates/mpc-core/src/prg.rs b/crates/mpc-core/src/prg.rs index c10dd4d..5e2a3ef 100644 --- a/crates/mpc-core/src/prg.rs +++ b/crates/mpc-core/src/prg.rs @@ -58,7 +58,7 @@ impl Stream { } // 后 12 字节(key 用满 32 字节,nonce 单独从 seed 再派生一次, // 避免 key 与 nonce 复用同一段字节导致的结构相关性) - let n = derive(seed, b"nax/chacha20/nonce"); + let n = derive(seed, crate::domain::PRG_NONCE); let nonce = [ u32::from_le_bytes([n[0], n[1], n[2], n[3]]), u32::from_le_bytes([n[4], n[5], n[6], n[7]]), @@ -168,7 +168,7 @@ fn pair_seed(master: &[u8; 32], a: &[u8], b: &[u8]) -> [u8; 32] { let (lo, hi) = if a <= b { (a, b) } else { (b, a) }; let mut h = Sha256::new(); h.update(master); - h.update(b"nax/pair"); + h.update(crate::domain::PRG_PAIR); h.update(&(lo.len() as u32).to_be_bytes()); h.update(lo); h.update(&(hi.len() as u32).to_be_bytes()); diff --git a/crates/mpc-node/src/auth.rs b/crates/mpc-node/src/auth.rs index 25a03de..0d88fa0 100644 --- a/crates/mpc-node/src/auth.rs +++ b/crates/mpc-node/src/auth.rs @@ -18,8 +18,8 @@ //! //! ```text //! ctx = idx_c ‖ idx_s ‖ na ‖ nb (定长 34 字节,无歧义拼接) -//! tag_s = KDF(psk, "server", ctx) 服务端对 ctx 的签名 -//! tag_c = KDF(psk, "client", ctx) 客户端对 ctx 的签名 +//! tag_s = KDF(psk, domain::SESSION_S2C, ctx) 服务端对 ctx 的签名 +//! tag_c = KDF(psk, domain::SESSION_C2S, ctx) 客户端对 ctx 的签名 //! ``` //! //! 两侧用**不同的 label**,所以不能把对方的 tag 原样打回来冒充自己。 @@ -128,8 +128,8 @@ pub(crate) fn session_keys( ) -> SessionKeys { let ctx = ctx_bytes(client_idx, server_idx, na, nb); SessionKeys { - c2s: derive_labeled(psk, b"nax/session/c2s", &ctx, &[]), - s2c: derive_labeled(psk, b"nax/session/s2c", &ctx, &[]), + c2s: derive_labeled(psk, mpc_core::domain::SESSION_C2S, &ctx, &[]), + s2c: derive_labeled(psk, mpc_core::domain::SESSION_S2C, &ctx, &[]), } } diff --git a/crates/mpc-orch/src/lib.rs b/crates/mpc-orch/src/lib.rs index b609c55..e29da85 100644 --- a/crates/mpc-orch/src/lib.rs +++ b/crates/mpc-orch/src/lib.rs @@ -744,7 +744,7 @@ fn judge(job: &JobSpec, reports: &[Report]) -> Result { /// 输入就露了。派生用域分离标签,所以作业名不同 → 种子不同, /// 且从种子反推不出别的作业的种子。 fn job_seed(master: [u8; 32], job: &str) -> [u8; 32] { - mpc_core::hash::derive2(&master, b"mpc-job", job.as_bytes()) + mpc_core::hash::derive2(&master, mpc_core::domain::JOB_SEED, job.as_bytes()) } /// 记一条事件:进内存列表(供汇总)+ 落盘(供重启后查)。 diff --git a/crates/mpc-psi/src/cache.rs b/crates/mpc-psi/src/cache.rs index b0fe636..a2224d8 100644 --- a/crates/mpc-psi/src/cache.rs +++ b/crates/mpc-psi/src/cache.rs @@ -47,7 +47,7 @@ use mpc_core::hash::Sha256; use crate::{hash_to_point, scalar_mult}; /// 缓存格式版本:条目语义变了就递增,旧表自动作废(绑定时比指纹)。 -const CACHE_VERSION: &[u8] = b"nax-psi-cache-v1"; +const CACHE_VERSION: &[u8] = mpc_core::domain::PSI_CACHE_VERSION; /// 默认条目上限(每张表)。超过就整表清空。 /// diff --git a/crates/mpc-psi/src/lib.rs b/crates/mpc-psi/src/lib.rs index d77a8f7..8dada4b 100644 --- a/crates/mpc-psi/src/lib.rs +++ b/crates/mpc-psi/src/lib.rs @@ -51,8 +51,11 @@ use curve25519_dalek::montgomery::MontgomeryPoint; pub mod cache; pub mod strict; -/// 默认 domain 分隔串,与参考实现一致。 -pub const DOMAIN: &[u8] = b"nax-psi-v1"; +/// 默认 domain 分隔串,统一定义在 `mpc_core::domain::PSI_DOMAIN`。 +/// +/// 参考实现的 `hash_to_point` 用 SHA-512、这里用 SHA-256,两边曲线点本就不同; +/// 这个 domain 只约束**本框架各参与方**必须用同一个映射。 +pub const DOMAIN: &[u8] = mpc_core::domain::PSI_DOMAIN; /// 把一个 ID(任意字节)映射到曲线上的 u 坐标。 /// diff --git a/crates/mpc-psi/src/strict.rs b/crates/mpc-psi/src/strict.rs index 801c36c..4b5bbda 100644 --- a/crates/mpc-psi/src/strict.rs +++ b/crates/mpc-psi/src/strict.rs @@ -36,7 +36,7 @@ use mpc_core::hash::Sha256; /// 协议版本串,进 domain 与承诺,换格式时递增。 -pub const STRICT_VERSION: &[u8] = b"nax-psi-strict-v1"; +pub const STRICT_VERSION: &[u8] = mpc_core::domain::PSI_STRICT_VERSION; /// 已知的低阶(8-torsion)点,以 Montgomery `u` 坐标表示。 /// @@ -287,7 +287,7 @@ mod tests { } } - const DOMAIN: &[u8] = b"nax-psi-v1"; + const DOMAIN: &[u8] = crate::DOMAIN; #[test] fn rejects_duplicates_and_reports_both_positions() { diff --git a/crates/mpc-runtime/src/device.rs b/crates/mpc-runtime/src/device.rs index 8797f70..94563e6 100644 --- a/crates/mpc-runtime/src/device.rs +++ b/crates/mpc-runtime/src/device.rs @@ -322,7 +322,7 @@ impl Value { /// 拆成本方那一份分片。`Stream` 按列推进,保持与发牌一致的随机序列。 fn split_for(&self, dev: &Secret) -> Result { // 带标签派生:同一主种子在同一域里复用不会与其他用途的随机流撞车 - let mut stream = Stream::derive(dev.seed(), b"nax/device/share"); + let mut stream = Stream::derive(dev.seed(), mpc_core::domain::SHARE_DEVICE); let mut out = Vec::with_capacity(self.cols.len()); for (name, vals) in &self.cols { let mut buf = vec![0u64; dev.parties() * vals.len()]; diff --git a/crates/mpc-tee/src/mock.rs b/crates/mpc-tee/src/mock.rs index b0acbda..2fd1cdb 100644 --- a/crates/mpc-tee/src/mock.rs +++ b/crates/mpc-tee/src/mock.rs @@ -73,7 +73,7 @@ impl MockTee { /// seal 用的 AEAD 密钥(与签名、报告密钥域分离)。 fn seal_key(&self) -> [u8; 32] { - derive(&self.device_key, b"nax/seal/v2") + derive(&self.device_key, mpc_core::domain::TEE_MOCK_SEAL) } } @@ -163,7 +163,7 @@ impl Tee for MockTee { fn attest(&self, user_data: &[u8; 64]) -> Result { // 真平台的报告由硬件密钥签;这里用设备密钥派生一个报告密钥来模拟 - let report_key = derive(&self.device_key, b"nax/attest"); + let report_key = derive(&self.device_key, mpc_core::domain::TEE_MOCK_ATTEST); let dev = self.device_id(); let mut body = Vec::with_capacity(64 + 64 + 8); @@ -187,7 +187,7 @@ impl Tee for MockTee { } fn sign(&self, msg: &[u8]) -> Result { - let key = derive(&self.device_key, b"nax/sign"); + let key = derive(&self.device_key, mpc_core::domain::TEE_MOCK_SIGN); Ok(Signature { alg: "hmac-sha256-mock", bytes: mac(&key, &[msg]).to_vec(), @@ -224,7 +224,7 @@ impl MockTee { return Err(TeeError::AttestFailed("TCB 版本不符".into())); } let digest = sha256(&att.report[..100]); - let report_key = derive(&self.device_key, b"nax/attest"); + let report_key = derive(&self.device_key, mpc_core::domain::TEE_MOCK_ATTEST); let want = mac(&report_key, &[&digest, &att.user_data]); if !ct_eq(&att.report[100..], &want) { return Err(TeeError::AttestFailed("签名不符".into())); @@ -360,7 +360,7 @@ mod tests { let t = tee(); let s = t.sign(b"policy: allow reveal to alice").unwrap(); assert_eq!(s.bytes.len(), 32); - let key = derive(&t.device_key, b"nax/sign"); + let key = derive(&t.device_key, mpc_core::domain::TEE_MOCK_SIGN); assert!(ct_eq(&s.bytes, &mac(&key, &[b"policy: allow reveal to alice"]))); } } diff --git a/crates/mpc-tee/src/optee/core.rs b/crates/mpc-tee/src/optee/core.rs index 5afa047..5cdcc0d 100644 --- a/crates/mpc-tee/src/optee/core.rs +++ b/crates/mpc-tee/src/optee/core.rs @@ -8,11 +8,14 @@ //! //! # 密钥层次 //! +//! 下列标签全部来自 `mpc_core::domain`(唯一真相源),这里只写常量名, +//! 不复制字面值 —— 改标签时不会出现「代码改了、文档还是旧值」。 +//! //! ```text //! K_root 32B,TA 首次 provision 时生成,存 secure storage,永不导出 -//! dev_tag 8B = SHA256("nax/tee/dev/v1" ‖ device_dna)[0..8] -//! K_seal 32B = derive(K_root, "nax/tee/v1/enc") -//! K_sig 32B = derive(K_root, "nax/tee/v1/sig") +//! dev_tag 8B = SHA256(domain::TEE_DEV ‖ device_dna)[0..8] +//! K_seal 32B = derive(K_root, domain::TEE_ENC) +//! K_sig 32B = derive(K_root, domain::TEE_SIG) //! ``` //! //! `dev_tag` 混入派生的目的是**设备绑定**:同一份 K_root 落到不同芯片 @@ -37,7 +40,7 @@ //! # 输入承诺消息(`commitment_bytes`) //! //! ```text -//! "nax/commit/v1" ‖ session_id(32) ‖ party_id(1) ‖ data_hash(32) ‖ timestamp(8) +//! domain::TEE_COMMIT ‖ session_id(32) ‖ party_id(1) ‖ data_hash(32) ‖ timestamp(8) //! ``` //! //! TEE 对这段字节签名 → 对端验证"这个 TEE 在这个时刻承诺了这份数据"。 @@ -45,7 +48,7 @@ //! # 出域策略判定消息(`egress_bytes`) //! //! ```text -//! "nax/egress/v1" ‖ session_id(32) ‖ operation(1) ‖ target(1) ‖ allowed(1) ‖ counter(8) +//! domain::TEE_EGRESS ‖ session_id(32) ‖ operation(1) ‖ target(1) ‖ allowed(1) ‖ counter(8) //! ``` //! //! TEE 对判定结果签名 → 审计链可验证"enclave 批准了这次出域"。 @@ -60,6 +63,7 @@ use mpc_core::aead; use mpc_core::hash::{derive, Sha256}; // 供 TA / CA / 宿主测试复用的原语:全部来自 mpc-core,不在这里另写一份 +pub use mpc_core::domain::TEE_OBJ_ROOT; pub use mpc_core::hash::sha256; pub use mpc_core::hmac::ct_eq; @@ -81,16 +85,16 @@ pub const DEVICE_TAG_LEN: usize = 8; pub const ROOT_KEY_LEN: usize = 32; /// 输入承诺消息前缀。 -pub const COMMIT_LABEL: &[u8] = b"nax/commit/v1"; +pub const COMMIT_LABEL: &[u8] = mpc_core::domain::TEE_COMMIT; /// 出域策略判定消息前缀。 -pub const EGRESS_LABEL: &[u8] = b"nax/egress/v1"; +pub const EGRESS_LABEL: &[u8] = mpc_core::domain::TEE_EGRESS; -/// 承诺消息总长:14(label) + 32(session) + 1(party) + 32(hash) + 8(ts) = 87。 -pub const COMMIT_MSG_LEN: usize = 14 + 32 + 1 + 32 + 8; +/// 承诺消息总长:label + 32(session) + 1(party) + 32(hash) + 8(ts) = 87。 +pub const COMMIT_MSG_LEN: usize = COMMIT_LABEL.len() + 32 + 1 + 32 + 8; -/// 出域消息总长:13(label) + 32(session) + 1(op) + 1(target) + 1(allowed) + 8(counter) = 56。 -pub const EGRESS_MSG_LEN: usize = 13 + 32 + 1 + 1 + 1 + 8; +/// 出域消息总长:label + 32(session) + 1(op) + 1(target) + 1(allowed) + 8(counter) = 56。 +pub const EGRESS_MSG_LEN: usize = EGRESS_LABEL.len() + 32 + 1 + 1 + 1 + 8; // ---------------------------------------------------------------- 密钥派生 @@ -114,23 +118,23 @@ pub struct DerivedKeys { /// 加密与认证共用 `K_seal`,那把密钥已无用处,随格式一并删掉 —— /// 留着一把没人用的密钥只会让人以为它还在保护什么。 pub fn derive_keys(root: &[u8; ROOT_KEY_LEN], device_dna: &[u8; DEVICE_DNA_LEN]) -> DerivedKeys { - // 先派生设备绑定中间密钥:k_dev = derive(K_root, "nax/tee/dev/v1" ‖ dna) - let mut dev_label = Vec::with_capacity(20); - dev_label.extend_from_slice(b"nax/tee/dev/v1"); + // 先派生设备绑定中间密钥:k_dev = derive(K_root, domain::TEE_DEV ‖ dna) + let mut dev_label = Vec::with_capacity(mpc_core::domain::TEE_DEV.len() + DEVICE_DNA_LEN); + dev_label.extend_from_slice(mpc_core::domain::TEE_DEV); dev_label.extend_from_slice(device_dna); let k_dev = derive(root, &dev_label); // 再从 k_dev 派生子密钥(标签里也带 dna,双重绑定) let mut enc_label = Vec::with_capacity(24); - enc_label.extend_from_slice(b"nax/tee/v1/enc"); + enc_label.extend_from_slice(mpc_core::domain::TEE_ENC); enc_label.extend_from_slice(device_dna); let mut sig_label = Vec::with_capacity(24); - sig_label.extend_from_slice(b"nax/tee/v1/sig"); + sig_label.extend_from_slice(mpc_core::domain::TEE_SIG); sig_label.extend_from_slice(device_dna); DerivedKeys { - // 标签字符串沿用 "v1/enc":它是密钥派生域,与 blob 格式版本无关, - // 改了会让已 provision 的板子全部换钥(blob 全废)。 + // 标签里的 "v1/..." 是密钥派生域版本,与 blob 格式版本(SEAL_VERSION)无关; + // 改这些标签会让已 provision 的板子全部换钥、旧 blob 解不开(见 domain.rs 变更纪律)。 k_seal: derive(&k_dev, &enc_label), k_sig: derive(&k_dev, &sig_label), } @@ -139,7 +143,7 @@ pub fn derive_keys(root: &[u8; ROOT_KEY_LEN], device_dna: &[u8; DEVICE_DNA_LEN]) /// 设备指纹(快速判断"这不是我的 blob")。 pub fn device_tag(device_dna: &[u8; DEVICE_DNA_LEN]) -> [u8; DEVICE_TAG_LEN] { let mut h = Sha256::new(); - h.update(b"nax/tee/dev/v1"); + h.update(mpc_core::domain::TEE_DEV); h.update(device_dna); let digest = h.finalize(); let mut out = [0u8; DEVICE_TAG_LEN]; diff --git a/crates/mpc-tee/ta/src/main.rs b/crates/mpc-tee/ta/src/main.rs index 2614173..5cf0e6c 100644 --- a/crates/mpc-tee/ta/src/main.rs +++ b/crates/mpc-tee/ta/src/main.rs @@ -30,7 +30,7 @@ use optee_utee::{ //(E0432 + E0433,2026-10-29 QEMU 实测踩过)。只导具体符号。 use mpc_tee::optee::core::{ derive_keys, device_tag, hmac, seal, sha256, unseal, DerivedKeys, DEVICE_DNA_LEN, ROOT_KEY_LEN, - SEAL_OVERHEAD, + SEAL_OVERHEAD, TEE_OBJ_ROOT as OBJ_ROOT, }; use mpc_tee::optee::proto; @@ -42,8 +42,7 @@ pub const UUID: &str = "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"; // optee-utee-build 生成到 $OUT_DIR/user_ta_header.rs,文件末尾 include!。 // 不要在这里手写 #[no_mangle] 弱符号——会与生成的定义冲突(重复定义)。 -/// secure storage 里的 K_root 对象名。 -const OBJ_ROOT: &[u8] = b"nax.tee.root.v1\0"; +// K_root 对象名来自 mpc_core::domain(经 optee::core re-export),不在 TA 里另写一份。 // ---------------------------------------------------------------- storage diff --git a/crates/mpc-vault/src/lib.rs b/crates/mpc-vault/src/lib.rs index b81bbe5..2b886f3 100644 --- a/crates/mpc-vault/src/lib.rs +++ b/crates/mpc-vault/src/lib.rs @@ -230,7 +230,7 @@ impl Vault { let len = values.len(); self.share_round = self.share_round.wrapping_add(1); let mut label = Vec::with_capacity(16); - label.extend_from_slice(b"nax/share"); + label.extend_from_slice(mpc_core::domain::SHARE_VAULT); label.extend_from_slice(&self.share_round.to_le_bytes()); let mut s = Stream::derive(&self.master_seed, &label); diff --git a/docs/OPT_PLAN.md b/docs/OPT_PLAN.md index 27680d3..29c6685 100644 --- a/docs/OPT_PLAN.md +++ b/docs/OPT_PLAN.md @@ -49,11 +49,12 @@ Python 算法层、BFIA 互操作(有对接需求才做)。 ``` 主动方 A → B : REQ{idx=A, nonce_a} - B → A : ACK{idx=B, nonce_b, tag_b = HMAC(psk, "nax/v1/server" ‖ A ‖ B ‖ na ‖ nb)} - A → B : OK {tag_a = HMAC(psk, "nax/v1/client" ‖ A ‖ B ‖ na ‖ nb)} + B → A : ACK{idx=B, nonce_b, tag_b = HMAC(psk, domain::SESSION_S2C ‖ A ‖ B ‖ na ‖ nb)} + A → B : OK {tag_a = HMAC(psk, domain::SESSION_C2S ‖ A ‖ B ‖ na ‖ nb)} ``` - > label 沿用前身的域分隔常量 `nax/v1/*`,是兼容契约,不随改名调整(见 README「命名沿革与兼容约定」)。 + > label 见 `mpc_core::domain` 的 `SESSION_S2C` / `SESSION_C2S`,与 `mpc-node::auth` 的握手实现一致; + > 改任一标签都是协议 breaking change(见 README「命名沿革与兼容约定」)。 两个 tag 用不同 label,防「把对方 tag 原样打回来」。 `connect_mesh(...)` 保持原签名,内部转调 `psk = None`(存量测试不受影响);