test(hopper): add semantic runtime conformance
This commit is contained in:
@@ -80,6 +80,151 @@ export const requireFunctionDossier = (
|
||||
return value;
|
||||
};
|
||||
|
||||
/** Positive semantic facts required from one source-owned Hopper fixture. */
|
||||
export interface FunctionDossierOracle {
|
||||
readonly procedure_address: string;
|
||||
readonly callee_address?: string;
|
||||
readonly caller_address?: string;
|
||||
readonly referenced_string?: string;
|
||||
readonly referenced_name?: string;
|
||||
readonly comment?: string;
|
||||
readonly require_cfg_successor?: boolean;
|
||||
readonly require_assembly?: boolean;
|
||||
}
|
||||
|
||||
/** Reject a structurally valid dossier that omits fixture-proven semantics. */
|
||||
export const requireFunctionDossierOracle = (
|
||||
input: unknown,
|
||||
oracle: FunctionDossierOracle,
|
||||
): Record<string, unknown> => {
|
||||
const value = requireFunctionDossier(input, oracle.procedure_address);
|
||||
if (oracle.callee_address !== undefined) {
|
||||
const callees = z
|
||||
.array(identitySchema)
|
||||
.parse(collectionSchema.parse(value.callees).items);
|
||||
if (!callees.some(({ address }) => address === oracle.callee_address))
|
||||
throw new TypeError(
|
||||
"analyze_function omitted the expected fixture callee",
|
||||
);
|
||||
|
||||
const references = z
|
||||
.array(
|
||||
z.object({
|
||||
source_address: addressSchema,
|
||||
target_address: addressSchema,
|
||||
}),
|
||||
)
|
||||
.parse(collectionSchema.parse(value.outgoing_references).items);
|
||||
if (
|
||||
!references.some(
|
||||
({ target_address }) => target_address === oracle.callee_address,
|
||||
)
|
||||
)
|
||||
throw new TypeError(
|
||||
"analyze_function omitted the expected fixture reference",
|
||||
);
|
||||
}
|
||||
|
||||
if (oracle.caller_address !== undefined) {
|
||||
const callers = z
|
||||
.array(identitySchema)
|
||||
.parse(collectionSchema.parse(value.callers).items);
|
||||
if (!callers.some(({ address }) => address === oracle.caller_address))
|
||||
throw new TypeError(
|
||||
"analyze_function omitted the expected fixture caller",
|
||||
);
|
||||
}
|
||||
|
||||
if (oracle.referenced_string !== undefined)
|
||||
requireReferencedValue(
|
||||
value,
|
||||
"referenced_strings",
|
||||
oracle.referenced_string,
|
||||
(candidate) => candidate,
|
||||
);
|
||||
|
||||
if (oracle.referenced_name !== undefined)
|
||||
requireReferencedValue(
|
||||
value,
|
||||
"referenced_names",
|
||||
oracle.referenced_name,
|
||||
(candidate) => candidate.replace(/^_+/u, ""),
|
||||
);
|
||||
|
||||
if (oracle.comment !== undefined) {
|
||||
const comments = z
|
||||
.array(
|
||||
z.object({
|
||||
address: addressSchema,
|
||||
kind: z.enum(["comment", "inline"]),
|
||||
text: z.string(),
|
||||
}),
|
||||
)
|
||||
.parse(collectionSchema.parse(value.comments).items);
|
||||
if (
|
||||
!comments.some(
|
||||
({ address, kind, text }) =>
|
||||
address === oracle.procedure_address &&
|
||||
kind === "comment" &&
|
||||
text === oracle.comment,
|
||||
)
|
||||
)
|
||||
throw new TypeError("analyze_function omitted the verifier comment");
|
||||
}
|
||||
|
||||
if (
|
||||
oracle.require_assembly === true &&
|
||||
collectionSchema.parse(value.assembly).items.length === 0
|
||||
)
|
||||
throw new TypeError("analyze_function omitted fixture assembly");
|
||||
|
||||
if (oracle.require_cfg_successor) {
|
||||
const blocks = z
|
||||
.array(z.object({ successors: z.array(addressSchema) }))
|
||||
.parse(collectionSchema.parse(value.basic_blocks).items);
|
||||
if (!blocks.some(({ successors }) => successors.length > 0))
|
||||
throw new TypeError("analyze_function omitted a real CFG successor");
|
||||
}
|
||||
return value;
|
||||
};
|
||||
|
||||
const referencedValueSchema = z.object({
|
||||
address: addressSchema,
|
||||
value: z.string(),
|
||||
source_address: addressSchema,
|
||||
});
|
||||
|
||||
const referenceEdgeSchema = z.object({
|
||||
source_address: addressSchema,
|
||||
target_address: addressSchema,
|
||||
});
|
||||
|
||||
const requireReferencedValue = (
|
||||
dossier: Record<string, unknown>,
|
||||
field: "referenced_strings" | "referenced_names",
|
||||
expected: string,
|
||||
normalize: (value: string) => string,
|
||||
): void => {
|
||||
const values = z
|
||||
.array(referencedValueSchema)
|
||||
.parse(collectionSchema.parse(dossier[field]).items);
|
||||
const references = z
|
||||
.array(referenceEdgeSchema)
|
||||
.parse(collectionSchema.parse(dossier.outgoing_references).items);
|
||||
const found = values.some(
|
||||
({ address, value, source_address: sourceAddress }) =>
|
||||
normalize(value) === expected &&
|
||||
references.some(
|
||||
({ source_address, target_address }) =>
|
||||
source_address === sourceAddress && target_address === address,
|
||||
),
|
||||
);
|
||||
if (!found)
|
||||
throw new TypeError(
|
||||
`analyze_function omitted the expected fixture ${field === "referenced_strings" ? "string" : "name"}`,
|
||||
);
|
||||
};
|
||||
|
||||
/** Require every relationship to be an actual hexadecimal address. */
|
||||
export const requireAddressArray = (
|
||||
input: unknown,
|
||||
@@ -92,6 +237,7 @@ export const requireAddressArray = (
|
||||
};
|
||||
|
||||
const COLLECTION_FIELDS = [
|
||||
"assembly",
|
||||
"comments",
|
||||
"callers",
|
||||
"callees",
|
||||
|
||||
Reference in New Issue
Block a user