Infer conservative read-only source effects for method contracts

This commit is contained in:
2026-10-22 15:40:44 +08:00
parent 0513b96dfb
commit cd25f819f2
14 changed files with 236 additions and 13 deletions
+1 -1
View File
@@ -5,7 +5,7 @@
| 文件 | 职责 |
| --- | --- |
| [lib.rs](lib.rs) | VM 类型导出、objects 类型兼容重导出(含 ReadAccess/CallSignature/CallType/CallEffect)、宿主调用与字节码 rustdoc 示例 |
| [vm.rs](vm.rs) | Vm 拥有 ObjectStore 与错误位置记录;对象操作和宿主 new_class 和显式/类型化Trait注册/关系查询显式委托给 objects;函数/字段检查统一开关、统一参数区间查询与函数类型配置 |
| [vm.rs](vm.rs) | Vm 拥有 ObjectStore 与错误位置记录;对象操作和宿主 new_class 和显式/类型化Trait注册/关系查询显式委托给 objects;函数/字段检查统一开关、统一参数区间/已知调用效果查询与函数类型配置 |
| [frame.rs](frame.rs) | EndorFrame、栈条目、源码与原生委托返回契约执行根、执行位置元数据、ExecutionLimits |
| [eval.rs](eval.rs) | execute/call、只读调用与依赖结果、参数绑定、原生实现前数量/类型/效果检查和原生/类型化Trait委托返回检查、可选注解/动态覆写兼容检查、源码类字段环境绑定、帧切换、取指分派、MakeFunction、结果根转移与失败清理 |
+5
View File
@@ -25,6 +25,11 @@ impl Vm {
self.source_type_checks = enabled;
Ok(())
}
/// Known whole-call effect; unproved source/delegated calls return None.
pub fn call_effect(&self, function: ObjectRef) -> Result<Option<objects::CallEffect>, VmError> {
self.objects.call_effect(function)
}
pub fn call_arity(&self, function: ObjectRef) -> Result<Option<objects::CallArity>, VmError> {
self.objects.call_arity(function)
}
+1 -1
View File
@@ -9,7 +9,7 @@
| [execution.rs](execution.rs) | wordcode 与校验、控制流、参数/默认值、嵌套帧、字节码函数创建/默认值/环境捕获、闭包、返回值存活、失败清理、限额 |
| [types.rs](types.rs) | 名义身份、继承与实例关系、类型边保活/循环回收、只读类型元数据与外来句柄、显式Trait身份/继承/参数约束及后代更新原子性;统一函数分类、原生数量元数据/副作用前拒绝/能力更新/默认参数与返回类型错误根清理;仅远端执行 |
| [typed_traits.rs](typed_traits.rs) | 类型化Trait登记、原子拒绝、源码检查关闭时的显式约束、宽参数调用、类型强边GC、体后实际能力结果检查与临时验证集合恢复;仅远端执行 |
| [method_contracts.rs](method_contracts.rs) | 源码/原生方法覆写参数逆变/返回协变、联合参数、效果、祖先替换原子性、动态名称重绑定/前向名称与体前拒绝/恢复及清理;仅远端执行 |
| [method_contracts.rs](method_contracts.rs) | 源码/原生方法覆写参数逆变/返回协变、联合参数、已证明源码只读/原生效果及共享赋值保守分类、祖先替换原子性、动态名称重绑定/前向名称与体前拒绝/恢复及清理;仅远端执行 |
| [native_context.rs](native_context.rs) | 原生作用域根、分配失败清理、原生签名/联合与可空类型/固定与Delegated效果和委托返回根、绑定方法元数据、委托、只读结果分配/写入拒绝/依赖/校验与普通读取区分及失败恢复、弱引用过期及有界变更;仅远端执行 |
核心对象现由 objects 定义,本目录保留既有 endor_core 导入与 Vm 方法的兼容性检查。独立对象存储检查见 [objects/tests](../../objects/tests/README.md)。堆内部伪造句柄与计数溢出检查在 objects 的 src/heap.rs,公开示例由 src/lib.rs rustdoc 提供。文件职责见 [src](../src/README.md),检查方式和结果边界见 [验证](../../../docs/operations/validation.md)。本地不执行测试;存在测试文件不代表某次提交已通过。返回 [core](../README.md)。
+146 -1
View File
@@ -24,6 +24,7 @@ fn source(
vec![Value::Number(42.into()), result],
CodeLayout {
parameters: (0..parameters.len()).map(|i| format!("p{i}")).collect(),
locals: (0..parameters.len()).map(|i| format!("p{i}")).collect(),
names: vec!["ran".into()],
..CodeLayout::default()
},
@@ -339,7 +340,7 @@ fn native_overrides_preserve_union_inputs_and_do_not_expand_effects() {
assert!(matches!(
vm.define_method(child, "check", effect_fn),
Err(VmError::OverrideViolation {
reason: "override expands native effects",
reason: "override expands known effects",
..
})
));
@@ -443,3 +444,147 @@ fn unknown_forward_names_defer_until_call_without_entering_the_body() {
vm.collect_cycles();
assert_eq!(vm.object_count(), 0);
}
#[test]
fn verified_source_read_only_effects_constrain_native_overrides() {
let mut vm = Vm::new().unwrap();
let roots = vm.bootstrap_types().unwrap();
vm.set_source_type_checks(true).unwrap();
let globals = vm.new_dict().unwrap();
let code = EndorCode::from_instructions(
&[
Instruction::new(Opcode::LoadFast, 1),
Instruction::simple(Opcode::ReturnValue),
],
vec![],
CodeLayout {
parameters: vec!["self".into(), "value".into()],
locals: vec!["self".into(), "value".into()],
..CodeLayout::default()
},
)
.unwrap()
.with_source_signature(SourceSignature {
parameters: vec!["PureBase".into(), "Number".into()],
return_type: "Number".into(),
method_owner: Some("PureBase".into()),
})
.unwrap();
assert!(code.is_statically_read_only());
let code = vm.new_code(code).unwrap();
let source = vm
.new_function("check", code, globals, vec![], vec![])
.unwrap();
let base = class(&mut vm, "PureBase", roots.object, source).unwrap();
let child = vm.new_type("Child", base, TypeConstructor::Record).unwrap();
assert_eq!(vm.call_effect(source).unwrap(), Some(CallEffect::ReadOnly));
let receiver = vm.new_object().unwrap();
vm.attach_type(receiver, child).unwrap();
let Value::Object(bound) = vm.bind_attr(receiver, "check").unwrap() else {
panic!("bound method")
};
assert_eq!(vm.call_effect(bound).unwrap(), Some(CallEffect::ReadOnly));
let mut functions = vec![];
for effect in [
CallEffect::Mutating,
CallEffect::External,
CallEffect::ReadOnly,
CallEffect::Delegated,
] {
let function = vm
.allocate(ContextNativeFunction::new(
"check",
Native(CallSignature::exact(
vec![T::Any, T::Number],
T::Number,
effect,
)),
vec![],
))
.unwrap();
let version = vm.change_version(child).unwrap();
let update = vm.define_method(child, "check", function);
if matches!(effect, CallEffect::Mutating | CallEffect::External) {
assert!(matches!(
update,
Err(VmError::OverrideViolation {
reason: "override expands known effects",
..
})
));
assert_eq!(vm.change_version(child).unwrap(), version);
} else {
update.unwrap();
}
assert_eq!(
vm.call_effect(function).unwrap(),
(effect != CallEffect::Delegated).then_some(effect)
);
functions.push(function);
}
for object in functions.into_iter().chain([
bound,
receiver,
child,
base,
source,
code,
globals,
roots.object,
roots.type_type,
]) {
vm.release(object).unwrap();
}
vm.collect_cycles();
assert_eq!(vm.object_count(), 0);
}
#[test]
fn shared_local_assignment_and_dynamic_calls_are_not_inferred_pure() {
let assignment = EndorCode::from_instructions(
&[
Instruction::new(Opcode::LoadFast, 1),
Instruction::new(Opcode::StoreFast, 0),
Instruction::new(Opcode::LoadFast, 0),
Instruction::simple(Opcode::ReturnValue),
],
vec![],
CodeLayout {
parameters: vec!["target".into(), "value".into()],
locals: vec!["target".into(), "value".into()],
..CodeLayout::default()
},
)
.unwrap();
assert!(!assignment.is_statically_read_only());
let captured = EndorCode::from_instructions(
&[
Instruction::new(Opcode::LoadConst, 0),
Instruction::new(Opcode::StoreDeref, 0),
Instruction::new(Opcode::LoadConst, 0),
Instruction::simple(Opcode::ReturnValue),
],
vec![Value::Nil],
CodeLayout {
free_variables: vec!["captured".into()],
..CodeLayout::default()
},
)
.unwrap();
assert!(!captured.is_statically_read_only());
let call = EndorCode::from_instructions(
&[
Instruction::new(Opcode::LoadGlobal, 0),
Instruction::simple(Opcode::PushNull),
Instruction::new(Opcode::Call, 0),
Instruction::simple(Opcode::ReturnValue),
],
vec![],
CodeLayout {
names: vec!["dynamic".into()],
..CodeLayout::default()
},
)
.unwrap();
assert!(!call.is_statically_read_only());
}
+1
View File
@@ -39,6 +39,7 @@ fn source(
vec![Value::Number(42.into()), value],
CodeLayout {
parameters: (0..types.len()).map(|i| format!("p{i}")).collect(),
locals: (0..types.len()).map(|i| format!("p{i}")).collect(),
names: vec!["ran".into()],
..CodeLayout::default()
},
+2 -2
View File
@@ -6,7 +6,7 @@
| --- | --- |
| [lib.rs](lib.rs) | 包边界、对象类型/ObjectStore 公开导出(含Trait/MethodRequirement/TypedMethodRequirement/SourceSignature/AnnotationType/CallArity/CallSignature/CallType/CallEffect/ReadAccess)与独立存储 rustdoc 示例 |
| [object.rs](object.rs) | Value、CompareOp、ObjectPayload(含显式函数标记)、ObjectHeader、EndorObject、Record、可发布数量元数据的 NativeFunction |
| [types.rs](types.rs) | 托管名义类型、显式 Object/Type 引导、继承查询、受管方法表/接收者绑定、类字段、显式/类型化Trait定义、强类型签名边与声明约束、实例方法遮蔽检查和宿主缓存依赖名、原生构造委托、统一源码/原生/绑定方法参数区间查询与能力验证、声明环境托管边、字段构造/写入检查与标记为校验读取的注解解析/匹配 |
| [types.rs](types.rs) | 托管名义类型、显式 Object/Type 引导、继承查询、受管方法表/接收者绑定、类字段、显式/类型化Trait定义、强类型签名边与声明约束、实例方法遮蔽检查和宿主缓存依赖名、原生构造委托、统一源码/原生/绑定方法参数区间和已知效果查询与能力验证、声明环境托管边、字段构造/写入检查与标记为校验读取的注解解析/匹配 |
| [contracts.rs](contracts.rs) | 方法参数逆变/返回协变、名义/能力/联合包含关系、祖先方法更新的后代检查、动态注解调用前复查、类型化能力替换/返回约束与临时递归验证集合 |
| [native.rs](native.rs) | NativeContext、CallArity/CallSignature 类型、Delegated/固定效果元数据、调用前检查、签名类型强边、上下文原生函数、作用域语言函数工厂、显式能力声明入口、函数标记、根与非递归委托调用 |
| [changes.rs](changes.rs) | 合并变更批次、变更键与有界通知额度 |
@@ -16,7 +16,7 @@
| [store.rs](store.rs) | ObjectStore、空堆创建、字段检查配置/属性写入屏障、详细读取区域结果、逐线程临时能力检查集合、对象操作、retain/release 和回收入口、弱 Function 类型配置与分配分类 |
| [store_builtins.rs](store_builtins.rs) | 载荷校验、代码/函数工厂、Dict/Cell 操作及键语义 |
| [instruction.rs](instruction.rs) | Opcode、Instruction、wordcode 编解码、MakeFunction/比较参数与跳转读取接口 |
| [code.rs](code.rs) | CodeLayout、EndorCode/EndorCodeObject、可选源码签名、共享不可变代码和操作数/控制流/栈验证 |
| [code.rs](code.rs) | CodeLayout、EndorCode/EndorCodeObject、可选源码签名、保守只读字节码证明、共享不可变代码和操作数/控制流/栈验证 |
| [error.rs](error.rs) | 对象、代码与执行共用的 VmError(含TraitViolation、OverrideViolation、UnknownAnnotation、TypeMismatch),避免反向依赖 core |
对象操作变更同步 [对象模型](../../../docs/runtime/objects.md),内置载荷同步 [基本对象](../../../docs/runtime/builtins.md)。新增操作码需要同时修改本包 instruction.rs/code.rs 和 core 的 eval.rs 分派,见 [字节码 VM](../../../docs/runtime/bytecode.md)。
+34
View File
@@ -106,6 +106,40 @@ impl EndorCode {
self.signature.as_ref()
}
/// Conservative proof over validated instructions. Local assignment is not
/// automatically pure: shared-reference assignment may update its old value.
/// Unknown calls and writes remain unknown, even when they could be safe for
/// a particular invocation. New opcodes require an explicit audit here.
pub fn is_statically_read_only(&self) -> bool {
self.instructions.iter().all(|decoded| {
matches!(
decoded.instruction.opcode,
Opcode::Nop
| Opcode::LoadConst
| Opcode::LoadFast
| Opcode::DeleteFast
| Opcode::LoadGlobal
| Opcode::PopTop
| Opcode::Copy
| Opcode::Swap
| Opcode::PushNull
| Opcode::ReturnValue
| Opcode::JumpForward
| Opcode::JumpBackward
| Opcode::PopJumpIfFalse
| Opcode::PopJumpIfTrue
| Opcode::ToBool
| Opcode::UnaryNot
| Opcode::CompareOp
| Opcode::LoadDeref
| Opcode::LoadClosure
| Opcode::LoadAttr
| Opcode::BuildMap
| Opcode::MakeFunction
)
})
}
pub fn with_location(
mut self,
name: impl Into<String>,
+2 -2
View File
@@ -170,7 +170,7 @@ impl ObjectStore {
parameters,
variadic: None,
returns: resolve(&signature.return_type)?.into(),
effect: None,
effect: self.call_effect(function)?,
}))
}
fn own_method(
@@ -303,7 +303,7 @@ impl ObjectStore {
CallEffect::External | CallEffect::Delegated => true,
};
if !compatible {
return Err(invalid("override expands native effects"));
return Err(invalid("override expands known effects"));
}
}
Ok(())
+27
View File
@@ -485,6 +485,33 @@ impl ObjectStore {
Ok(signature)
}
/// Known whole-call effect, after unwrapping bound receivers. Delegated
/// native wrappers and source code with unproved operations remain unknown.
/// This query does not execute code or freeze dynamic globals/call targets.
pub fn call_effect(&self, function: ObjectRef) -> Result<Option<crate::CallEffect>, VmError> {
let mut current = function;
loop {
let payload = self.object(current)?.payload();
if let Some(bound) = payload.as_any().downcast_ref::<BoundMethod>() {
current = bound.function;
continue;
}
if let Some(source) = payload
.as_any()
.downcast_ref::<crate::EndorFunctionObject>()
{
return Ok(self
.payload::<crate::EndorCodeObject>(source.code(), "code")?
.code()
.is_statically_read_only()
.then_some(crate::CallEffect::ReadOnly));
}
return Ok(self.native_signature(current)?.and_then(|signature| {
(signature.effect != crate::CallEffect::Delegated).then_some(signature.effect)
}));
}
}
/// Unified source/native positional interval, after any bound receivers.
/// None means no published native metadata (including generic Type construction).
pub fn call_arity(&self, function: ObjectRef) -> Result<Option<crate::CallArity>, VmError> {