Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion SINGLEHOST-SHA256SUMS
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ d72675ebcd951cfc0621ca2f5ce4e45423d2e46cc7287f877e02225506b5383c DELIVERY-SCOPE
3ce34721d9ab45f4025d2a382c927fc729aa132c41381c21863780972e59c1a8 Makefile
38ae10897b8fc7065de31181e30c73bd33a85312e6b6dcff7da5c729b50485f4 REUSE.toml
3c31cdc131fc3e73a61231e185a5d7245f71565444c276cce62b7e8efad0361d WORKFLOW-SHA256SUMS
956eea079e0111d70c1ee32f3be69c70b3d9075e1f80a93ee564463c051e6b9c docs/07-roadmap/fm-s3-audit-dependencies.json
0322a918cab37c76d31a38b219bb6300553ab1c2ec620908ec1aa2410513e506 docs/07-roadmap/fm-s3-audit-dependencies.json
193fd2886ead940668e6e1e0314e5d08cf926923f28984d456a10c11e2cde265 docs/testing/AUDIT-FIXES-20261105.summary.json
e1b4472bdcf13d122272c6d95412e5841f06866eaf0deea72ea94d1f0ad40f7d docs/testing/CI-GIT-SOURCE-FIX-20261105.summary.json
9438d3bdd18cc22fa6d4ad484cd15a144ab950c49617766548bb20dd6db1114a docs/testing/ENVIRONMENT.json
Expand Down
12 changes: 6 additions & 6 deletions docs/00-overview/architecture-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,7 +171,7 @@ flowchart LR
ACLt/
├── README.md 项目总入口
├── CONTRIBUTING.md 贡献流程、同步要求和审查标准
├── LICENSE 仓库全部工件的许可证文本(Apache-2.0)
├── LICENSE 项目工件的许可证文本(Apache-2.0;第三方材料保留原许可)
├── docs/
│ ├── README.md 文档索引、权威范围、冲突处理
│ ├── 00-overview/ 为什么做、术语、系统边界
Expand Down Expand Up @@ -214,13 +214,13 @@ ACLt/
|---|---|---|
| 协议文档与架构 | 已有 v0.5 文档骨架、职责边界和 16 条不变量 | 完整状态机或所有规范都已可执行。 |
| 有限总体验证模型 | 有递推、闭式、全枚举、DP 对拍和精确有理数向量 | 真实无许可网络已满足部署前提。 |
| P0-1A | 状态文档记录 `PASS / CLOSED` | 整个 P0-1 或 G0 已关闭。 |
| P0-1B | `STARTED / NOT CLOSED`;有初始 Schema、种子、validator 和测试 | 所有规则、编码与摘要已实现。 |
| P0-1A | 状态见[当前状态](../07-roadmap/current-status.md) | 整个 P0-1 或 G0 已关闭。 |
| P0-1B | 状态与计数见[当前状态](../07-roadmap/current-status.md) | 所有规则、编码与摘要已实现。 |
| 注册表种子 | 有 claim 模板、排除项和 disabled assurance 数据 | 已存在正式 ACTIVE 主网注册表。 |
| G0 | 进行中 | 已具备合格的 G2 参考实现。 |
| G1—G6 | 状态快照记录为未开始 | 仿真、网络、容灾或对抗验证已经验收。 |
| G0 | 状态见[当前状态](../07-roadmap/current-status.md) | 已具备合格的 G2 参考实现。 |
| G1—G6 | 状态见[当前状态](../07-roadmap/current-status.md) | 仿真、网络、容灾或对抗验证已经验收。 |

P0-1B 当前覆盖清单明确列出:L1b 的 SV-10、SV-11、SV-57、SV-76 已实现;部分 L1a 规则和 SV-54a 只部分覆盖;L2 尚未实现。canonical CBOR、18 个摘要、完整五相位对象、全量 Type A 规则以及第二语言对拍仍有缺口。参考 validator 的 `--production` 会主动拒绝,避免把局部检查当作完整生产校验。
P0-1B 的覆盖计数、缺口与已实现规则以[当前状态](../07-roadmap/current-status.md)和[覆盖清单](../../schemas/verification-profile/coverage.json)为准。参考 validator 的 `--production` 会主动拒绝,避免把局部检查当作完整生产校验。

阅读状态时分清三个问题:`DECIDED` 表示设计已接受;V1 `CORE` 表示必须实现;测试通过表示某个检查有证据。三者不能互相替代。

Expand Down
4 changes: 2 additions & 2 deletions docs/00-overview/project-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ ACLt 的目标不是消灭这些不确定性,而是将它们转化为显式且
- V1 对跨 Provider 共享可变地址空间、分布式原子操作或隐藏 Host OS 状态的支持;
- 以 Rust 源码、某个编译器输出或本机二进制本身作为协议规范语义。

这些能力属于未来研究或适配方向;当前安全主张不包含它们。
其中仍处于 `OPEN`、`CANDIDATE` 或 `DEFERRED` 的内容可以作为未来研究或适配方向;已被否决或取代的做法保持其否决或取代记录(见[术语表](terminology.md#10-废弃或禁止的旧术语语义)与相关 ADR)。上述内容均不得写入当前安全主张。

## 6. 最小系统本体

Expand Down Expand Up @@ -192,7 +192,7 @@ ACLt 仍处于 **G0:协议规格化阶段**。目前已经形成完整候选
- 结算、退款、故障归因和资金耗尽语义;
- 发布、密钥、撤销、升级和漏洞响应流程;
- CauseSet/reducer conformance 与 MainnetAssuranceProfile 发布、撤销和网络隔离流程;
- 当前项目名称的商标、域名和包名清查。
- 当前项目名称的域名和包名清查;商标部分已按 2026-11-16 决定关闭(见术语表 §11)。

## 11. 可支持的当前结论

Expand Down
4 changes: 3 additions & 1 deletion docs/00-overview/system-context.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,7 +100,7 @@ ACLt 不为下列职能建立固定特权角色。任何 Principal 都可以尝
|---|---|---|---|
| 1. 选择版本与政策 | Requester 选择兼容的 ProtocolVersion、验证、资金、结算政策和适用的主网保障 Profile | 可解析的任务创建输入 | `REJECTED_AT_CREATE` |
| 2. 登记任务 | Requester 规范化并签署包含 RIRVersion/Profile/Digest 的 ComputeReceipt | 不可变 ReceiptID | `REJECTED_AT_CREATE` / `UNSUPPORTED` |
| 3. Compile 与规划 | Lowering、Decomposition、Packing/Plan 形成并验证候选工件 | 规范 RIR、合法 WorkPlan / Assignment | `FAILED_PLANNING` / `UNSUPPORTED` |
| 3. Compile 与规划 | Lowering、Decomposition、Packing/Plan 形成并验证候选工件 | 规范 RIR、合法 WorkPlan / Assignment | `FAILED_PLANNING` |
| 4. 准入与 Dispatch | Admit/Schedule 处理证据、能力、不确定度和限额 | ExposureDecision、Lease proposal | 排队、拒绝或 `EXPIRED` |
| 5. 接受与执行 | Provider 显式接受 Lease;系统派生 ExecutionCapability;Dispatch 与 RPR 分别校验后执行 | active Lease、ExecutionCapability、Result、Checkpoint 或失败证据 | proposal 失效、能力校验失败、重租约、`FAILED`、`EXPIRED` |
| 6. 冻结验证总体 | Sample 前建立 EligibilitySnapshot | 可审计总体、分层与随机承诺 | `UNRESOLVED` |
Expand All @@ -109,6 +109,8 @@ ACLt 不为下列职能建立固定特权角色。任何 Principal 都可以尝
| 9. 结算 | Settle 应用 FundingPolicy 和 SettlementPolicy | 最多一次 Settlement | `FUNDING_EXHAUSTED` 或可重试实现失败 |
| 10. 追加证据 | UpdateEvidence 记录可归责事件 | 新 PerformanceEvidence | 证据不足时暂缓能力更新 |

`REJECTED_AT_CREATE` 与 `UNSUPPORTED` 属于 `CreateReceiptResult`(阶段 1–2),不是终态;Receipt 登记后不得进入 `UNSUPPORTED`(ADR-0005 D-02(a))。

## 7. 外部依赖与适配器

| 外部能力 | ACLt 对其要求 | 失效时的协议响应 |
Expand Down
8 changes: 5 additions & 3 deletions docs/00-overview/terminology.md
Original file line number Diff line number Diff line change
Expand Up @@ -300,7 +300,9 @@ $$

`Nmax` 不具有默认的 51% 含义,也不单独证明验证安全。

## 8. 终态
## 8. 终态与创建结果

本节区分 Receipt 终态与创建结果。`REJECTED_AT_CREATE` 与 `UNSUPPORTED` 属于 `CreateReceiptResult`,不是 Receipt 终态,也不得在 Receipt 登记后进入(ADR-0005 D-02(a))。

### `TRUSTED`

Expand Down Expand Up @@ -328,11 +330,11 @@ $$

### `REJECTED_AT_CREATE`

任务在创建阶段不满足协议、兼容性、安全或资金前置条件,因此不进入执行生命周期。
任务在创建阶段不满足协议、兼容性、安全或资金前置条件,因此不进入执行生命周期。它是 `CreateReceiptResult`,不产生 ReceiptID,也不是 Receipt 终态。

### `UNSUPPORTED`

当前 ProtocolVersion 没有为该任务语义提供符合要求的执行或验证类型。实现不得把它降级为普通多数投票。
当前 ProtocolVersion 没有为该任务语义提供符合要求的执行或验证类型。它是 `CreateReceiptResult`,只在 Receipt 登记前产生;登记后不得进入,也不是 Receipt 终态。实现不得把它降级为普通多数投票。

## 9. 实现与维护术语

Expand Down
2 changes: 1 addition & 1 deletion docs/01-requirements/invariants.md
Original file line number Diff line number Diff line change
Expand Up @@ -267,7 +267,7 @@ Committed + Settled + RefundReserved

### 未决事项

终态—权利矩阵、故障归因、退款和外部通道失败语义仍为 `OPEN/P0`。
终态—权利矩阵、退款和外部通道失败语义仍为 `OPEN/P0`。结算层的 `AttributionClass` 已由 [VerificationProfile Schema](../03-protocol/verification-profile-schema.md) §10.1 冻结;履约证据层的归因仍为 `OPEN`(OQ-10)。

## 12. INV-08:旧 epoch 隔离

Expand Down
49 changes: 27 additions & 22 deletions docs/01-requirements/threat-model.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ ACLt Protocol 不默认信任:

| ID | 威胁 | 可能影响 | 必要控制 | 不变量 | 当前状态 |
|---|---|---|---|---|---|
| TH-05 | 伪造、重放、刷取或错误归因 PerformanceEvidence | 错误能力估计、放大未来暴露 | 证据绑定任务族、环境、结果、来源、时间和因果引用;追加式更正 | INV-13、INV-14 | 证据 Schema 与归因仍为 `OPEN/P0` |
| TH-05 | 伪造、重放、刷取或错误归因 PerformanceEvidence | 错误能力估计、放大未来暴露 | 证据绑定任务族、环境、结果、来源、时间和因果引用;追加式更正 | INV-13、INV-14 | 证据 Schema 与履约证据层归因仍为 `OPEN/P0`;结算层 `AttributionClass` 已由 Profile Schema §10.1 冻结 |
| TH-06 | 将平台、任务规范或验证器故障归罪于 Provider | 不公正限制、诱发策略性退出 | 显式故障来源;证据不足时不猜测;拒绝未接受任务不产生负面证据 | INV-13、INV-14 | 归因矩阵为 `OPEN/P0` |
| TH-07 | Sybil 身份批量进入或多个标识由同一控制者协同 | 绕过新节点限制、提高验证影响、集中风险 | 不假定独立;相关集群上限;证据折减;每集群/Receipt/窗口硬暴露上限 | INV-10、INV-14 | 相关性算法为 `CANDIDATE/P0` |
| TH-08 | 并发准入竞态、跨服务配额不同步或过期能力估计 | 实际暴露超过声明上限 | 原子额度预留;决策绑定证据版本、有效期和当前并发;失败回滚 | INV-10、INV-16 | 原子配额实现为 `OPEN/P0` |
Expand Down Expand Up @@ -178,7 +178,7 @@ ACLt Protocol 不默认信任:
|---|---|---|---|---|---|
| TH-22 | 隐性借用、临时增发、跨资金桶挪用或虚假预算 | 掩盖真实成本、资不抵债、越权支付 | FundingPolicy 预声明来源与上限;资金桶分离;资金守恒 | INV-06 | 具体账务模型为 `OPEN/P0` |
| TH-23 | 重放、并发或超时恢复造成重复结算 | 超额支付和权利分叉 | 唯一权利键、幂等 Settle、最多一次 Commit | INV-05、INV-07 | 事务与唯一键为 `OPEN/P0` |
| TH-24 | 没有有效终态仍结算,或终态与退款/费用映射被追溯修改 | 未授权支付、争议和激励扭曲 | SettlementPolicy 随 Receipt 冻结;结算验证终态和故障归因 | INV-01、INV-07、INV-12 | 退款与归因为 `OPEN/P0` |
| TH-24 | 没有有效终态仍结算,或终态与退款/费用映射被追溯修改 | 未授权支付、争议和激励扭曲 | SettlementPolicy 随 Receipt 冻结;结算验证终态和故障归因 | INV-01、INV-07、INV-12 | 退款与完整结算归因矩阵为 `OPEN/P0`;结算层 `AttributionClass` 已由 Profile Schema §10.1 冻结 |
| TH-25 | 攻击收益来自外部头寸、竞争破坏、补贴或纯破坏动机 | “攻击不划算”假设失效 | 先限制最大损失;经济模型纳入外部收益并进行敏感性分析 | INV-06、INV-09、INV-10 | 经济参数为 `HYPOTHESIS/P1` |
| TH-26 | 低成本身份反复进入、领取探索额度后退出 | 持续消耗探索预算和执行资源 | 每集群/窗口探索与损失上限;能力不确定度;异常证据分析 | INV-09、INV-10、INV-14 | 攻击仿真为 `OPEN/P1` |

Expand Down Expand Up @@ -270,24 +270,29 @@ Sybil 与相关性控制可能需要观察所有权、资金、网络、设备

## 11. 安全主张的边界

在对应证明义务完成前,以下结论不属于安全主张:

- ACLt Protocol 的整体鲁棒性尚未得到证明;
- 任意计算的低成本可靠验证尚未建立;
- 多个 Provider 不表示多个独立控制实体;
- ACLt Protocol 没有默认的 51% 安全阈值;
- Rank、信誉或历史履约不表示真理;
- `TRUSTED` 不表示绝对正确;
- 零抵押不消除 Sybil 或弃单风险;
- 攻击成本大于协议内收益不足以排除攻击;
- 临时发行不会使验证资金变为“免费”;
- 区块链或去中心化存储不会自动满足 ACLt Protocol 不变量;
- 官方主网 assurance、Foundation 报告或一次工程审计不构成绝对正确性证明;
- 官方主网的条件性保证不自动适用于 fork、私有部署、替换组件或主网外业务;
- 中心化参考实现尚不具备分布式容错;
- 未经证明的序贯方法,其 anytime-valid 误差控制尚未得到证明,不作为当前主张;
- Rust 的语言安全、RIR 的存在或单一参考 compiler 不自动保证结果正确、确定性、资源一致或分布式安全;
- V1 Profile 将 unsafe Rust、完整宿主 effects、原生执行、GPU/专用加速器或非确定性任务列为 `DEFERRED` 排除项;扩展由后续目标与对应准入条件决定。
本节把安全主张的边界分成两组。第一组是尚待证明的命题:下列命题只有在对应证明义务完成之后才属于安全主张。

- ACLt Protocol 的整体鲁棒性已经得到证明;
- 任意计算能以低成本可靠验证;
- 攻击成本大于协议内收益即可排除攻击;
- 中心化参考实现具备分布式容错;
- 序贯方法保持 anytime-valid 误差控制。

第二组是已被否决、取代或明确排除的主张。这些边界无条件成立,不依赖任何证明义务的完成:

- 多个 Provider 代表多个独立控制实体;
- 51% 是 ACLt Protocol 的默认安全阈值;
- Rank、信誉或历史履约代表真理;
- `TRUSTED` 表示绝对正确;
- 零抵押消除 Sybil 或弃单风险;
- 验证资金通过临时发行变为“免费”;
- 区块链或去中心化存储自动满足 ACLt Protocol 不变量;
- 官方主网 assurance、Foundation 报告或一次工程审计等于绝对正确性证明;
- 官方主网的条件性保证自动适用于 fork、私有部署、替换组件或主网外业务;
- Rust 的语言安全、RIR 的存在或单一参考 compiler 自动保证结果正确、确定性、资源一致或分布式安全;
- V1 支持 unsafe Rust、完整宿主 effects、原生执行、GPU/专用加速器或非确定性任务。

V1 Profile 将 unsafe Rust、完整宿主 effects、原生执行、GPU/专用加速器或非确定性任务列为 `DEFERRED` 排除项;扩展由后续目标与对应准入条件决定。

## 12. G0 未决安全问题

Expand All @@ -305,12 +310,12 @@ Sybil 与相关性控制可能需要观察所有权、资金、网络、设备
| P0 | VerificationProfile、有限总体、能力上界 \(B\)、活性下界 \(Q\)、随机性、分层、e-process 和停止规则 | 条件定理、部署假设证据、精确 DP、对拍测试、反例与实现规范;Bayesian 仅作效率评估 |
| P0 | 控制相关性、未知依赖处理和集群暴露 | 相关性模型、隐私边界、敏感性与攻击仿真 |
| P0 | 最大尝试、任务价值、验证支出和可接受损失 | 按 Provider/集群/Receipt/窗口的硬参数与性质测试 |
| P0 | FundingPolicy、退款、故障归因、资不抵债和资金守恒 | 账务状态机、唯一键、故障与并发测试 |
| P0 | FundingPolicy、退款、完整故障归因矩阵(结算层 `AttributionClass` 已冻结)、资不抵债和资金守恒 | 账务状态机、唯一键、故障与并发测试 |
| P0 | 分区、时钟、事务、幂等、备份恢复和适配器一致性 | 明确故障模型、RPO/RTO 演练、conformance suite |
| P0 | 发布、撤销、升级、密钥和漏洞响应 | 维护权限模型、签名与撤销演练 |
| P0 | 主网 assurance 与工程日志 | `MainnetAssuranceProfile` Schema、网络/组件限域、日志 contract、finality/inclusion/consistency、旁路和恢复测试 |
| P0 | 多原因假设失效 | `CauseSet`、冻结 reducer、`EffectiveVerdict`、多原因组合向量和迁移规则 |
| P0 | ACLt 公共品牌清查 | 商标、域名和包名的独立结论;不影响协议安全语义 |
| P0 | ACLt 公共品牌清查 | 域名和包名的独立结论;商标部分已按 2026-11-16 决定关闭(OQ-01);不影响协议安全语义 |

## 13. 威胁模型更新规则

Expand Down
8 changes: 5 additions & 3 deletions docs/02-architecture/task-lifecycle.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ SourcePackage、Lowering 和候选 RIR 的准备发生在 `Proposed` 之前;
| 4. 能力与暴露 | 估计任务族能力并原子预留额度 | 证据版本、资源和限额有效 | ExposureDecision | 排队/拒绝/EXPIRED |
| 5. Provider Dispatch | Schedule 产生 Lease proposal,Provider 显式接受;Dispatch/RPR 校验 Lease 派生 capability | epoch、期限、scope 与暴露有效 | 生效 active Lease 与 ExecutionCapability | proposal 失效、释放额度 |
| 6. 执行与恢复 | RPR Execute、heartbeat、checkpoint | 当前 active Lease | Result/Checkpoint/Failure | retry/FAILED/EXPIRED |
| 7. 验证快照 | 冻结总体、分层、相关性和随机性 | 有效候选结果与策略 | EligibilitySnapshot | UNSUPPORTED/UNRESOLVED |
| 7. 验证快照 | 冻结总体、分层、相关性和随机性 | 有效候选结果与策略 | EligibilitySnapshot | UNRESOLVED |
| 8. 序贯验证 | Sample、Verify、Aggregate | Snapshot 未破坏 | ConfidenceState | 扩样/UNRESOLVED |
| 9. 终态 | 原子提交唯一状态 | 停止或边界条件 | TerminalState | 事务重试 |
| 10. 结算 | 计算权利并最多一次提交 | 终态、政策、资金有效 | Settlement | FUNDING_EXHAUSTED/暂停 |
Expand All @@ -70,6 +70,8 @@ Receipt 登记前必须明确:
- FundingPolicy、SettlementPolicy 和预算;
- ProtocolVersion 与 canonical encoding。

完整字段清单以 [`protocol-spec.md` §5](../03-protocol/protocol-spec.md) 为准;其中 Exposure、Availability 与 Deployment assurance 三组同样必须在登记前明确。

登记后任何实质变化必须生成新 ReceiptID。修正文书不能改变原任务义务。

Lowering 必须发生在 Receipt 冻结前,Receipt 绑定其 RIRVersion、RIR digest、FrontendProfileVersion 和 lowering provenance。Decomposition/Packing 可以在登记后由任意 Principal 提议,但只能产生受同一 Receipt 约束的合法 WorkPlan 和 Assignment。
Expand Down Expand Up @@ -147,12 +149,12 @@ N_{max}=\min(N_{population},N_{budget},N_{policy})
| `FAILED` | 执行或系统条件失败且不能继续 | 按故障归因 | 不适用 |
| `EXPIRED` | 最终期限到达 | 按责任矩阵 | 不适用 |
| `FUNDING_EXHAUSTED` | 授权资金阻止继续或结算 | 仅按剩余额度和政策 | 不适用 |
| `REJECTED_AT_CREATE` | 创建条件不合法 | 不进入执行服务 | 不适用 |
| `FAILED_PLANNING` | 没有合法 WorkPlan | 仅按创建/规划政策 | 不适用 |
| `UNSUPPORTED` | 当前版本无合规验证或执行语义 | 不进入相关阶段 | 不适用 |

每个 Receipt 最多提交一个互斥协议终态。

`REJECTED_AT_CREATE` 与 `UNSUPPORTED` 属于 `CreateReceiptResult`,不是 Receipt 终态,也不得在 Receipt 登记后进入(ADR-0005 D-02(a))。

## 10. 结算阶段

Settlement 必须引用:唯一终态、冻结 SettlementPolicy、合法故障归因、足够资金和未提交 EntitlementKey。
Expand Down
Loading
Loading