Reverse engineer anything with agents, from app behavior down to native binaries.
TypeScript agent-skillsai-agentsbinary-analysisclaude-codeclicodexcordisdecompilerdeveloper-toolsdshdsh-pluginghidrahopperllmmcpmodel-context-protocolreareverse-engineeringstatic-analysistouhou
import type { PointerResolution } from "./AppleMachoFixups.js";
import type {
SwiftDispatchReaders,
SwiftRelativeField,
SwiftRelativeValue,
} from "./AppleSwiftDispatchFacets.js";
import { expectedSwiftMetadataReadFailure } from "./AppleSwiftMetadataReadFailure.js";
const hex = (value: bigint) => `0x${value.toString(16)}`;
export const swiftImportBinding = (
requestedAddress: bigint,
binding: Extract<PointerResolution, { readonly kind: "bind" }>,
) => ({
requested_address: hex(requestedAddress),
symbol: binding.symbol,
binding_source: binding.binding_source,
library_ordinal: binding.library_ordinal,
library: binding.library,
weak: binding.weak,
addend: binding.addend.toString(),
});
export interface SwiftConformanceTypeReference {
readonly kind: number;
/** Descriptor, inline class-name, local ObjC class pointer, or raw target. */
readonly target: bigint | null;
readonly name: string | null;
readonly binding: ReturnType<typeof swiftImportBinding> | null;
readonly reason: string | null;
readonly staticWitnessIdentity: boolean;
readonly generic: boolean | null;
}
interface SwiftTypeReferenceInput {
readonly descriptor: bigint;
readonly flags: number;
readonly read: SwiftDispatchReaders;
readonly relative: (
field: bigint,
kind: SwiftRelativeField,
) => SwiftRelativeValue;
readonly unresolvedReason: (
value: Exclude<SwiftRelativeValue, { readonly kind: "target" }>,
field: SwiftRelativeField,
) => string;
}
const typeReferenceResult = (input: {
readonly kind: number;
readonly target: bigint | null;
readonly name?: string | null;
readonly binding?: ReturnType<typeof swiftImportBinding> | null;
readonly reason?: string | null;
readonly generic?: boolean | null;
}): SwiftConformanceTypeReference => ({
kind: input.kind,
target: input.target,
name: input.name ?? null,
binding: input.binding ?? null,
reason: input.reason ?? null,
staticWitnessIdentity:
input.name !== null && input.name !== undefined && input.kind <= 2,
generic: input.generic ?? null,
});
export const requiredSwiftRelativeTarget = (
relative: (field: bigint, kind: SwiftRelativeField) => SwiftRelativeValue,
field: bigint,
kind: SwiftRelativeField,
unresolvedReason: SwiftTypeReferenceInput["unresolvedReason"],
): bigint => {
const value = relative(field, kind);
if (value.kind !== "target")
throw new RangeError(unresolvedReason(value, kind));
return value.target;
};
const decodeNominalTypeReference = (
kind: 0 | 1,
input: SwiftTypeReferenceInput,
value: SwiftRelativeValue,
): SwiftConformanceTypeReference => {
const { read, relative } = input;
let target = value.kind === "target" ? value.target : null;
let binding =
value.kind === "binding"
? swiftImportBinding(value.requestedAddress, value.binding)
: null;
let reason =
value.kind === "unknown"
? value.reason
: value.kind === "null"
? "Null Swift conformance type reference"
: null;
try {
if (kind === 1 && target !== null) {
const pointer = read.resolvePointer(target);
if (pointer.kind === "bind") {
binding = swiftImportBinding(target, pointer);
target = null;
} else if (pointer.kind === "raw" && pointer.target === 0n) {
target = null;
reason = "Null indirect Swift conformance type reference";
} else if (pointer.kind === "raw" || pointer.kind === "rebase") {
target = pointer.target;
} else {
target = null;
reason = pointer.reason;
}
}
if (target === null)
return typeReferenceResult({ kind, target, binding, reason });
const descriptorFlags = read.u32(target);
if (![16, 17, 18].includes(descriptorFlags & 31))
return typeReferenceResult({
kind,
target,
binding,
reason: "Unsupported Swift type descriptor kind",
});
const name = read.string(
requiredSwiftRelativeTarget(
relative,
target + 8n,
"typeName",
input.unresolvedReason,
),
);
return typeReferenceResult({
kind,
target,
name: name.length === 0 ? null : name,
binding,
reason: name.length === 0 ? "Empty Swift conformance type name" : null,
generic: (descriptorFlags & 0x80) !== 0,
});
} catch (cause) {
const reason = expectedSwiftMetadataReadFailure(cause);
if (reason === null) throw cause;
return typeReferenceResult({
kind,
target,
binding,
reason,
});
}
};
const decodeDirectObjcClassName = (
kind: 2,
read: SwiftDispatchReaders,
value: SwiftRelativeValue,
): SwiftConformanceTypeReference => {
if (value.kind !== "target")
return typeReferenceResult({
kind,
target: null,
reason:
value.kind === "unknown"
? value.reason
: "Null Swift conformance type reference",
});
try {
const name = read.string(value.target);
return typeReferenceResult({
kind,
target: value.target,
name: name.length === 0 ? null : name,
reason: name.length === 0 ? "Empty inline Objective-C class name" : null,
});
} catch (cause) {
const reason = expectedSwiftMetadataReadFailure(cause);
if (reason === null) throw cause;
return typeReferenceResult({
kind,
target: value.target,
reason,
});
}
};
const decodeIndirectObjcClass = (
kind: 3,
read: SwiftDispatchReaders,
value: SwiftRelativeValue,
): SwiftConformanceTypeReference => {
if (value.kind !== "target")
return typeReferenceResult({
kind,
target: null,
reason:
value.kind === "unknown"
? value.reason
: "Null Swift conformance type reference",
});
let pointer: PointerResolution;
try {
pointer = read.resolvePointer(value.target);
} catch (cause) {
const reason = expectedSwiftMetadataReadFailure(cause);
if (reason === null) throw cause;
return typeReferenceResult({
kind,
target: value.target,
reason,
});
}
if (pointer.kind === "bind")
return typeReferenceResult({
kind,
target: null,
binding: swiftImportBinding(value.target, pointer),
reason: "Indirect Objective-C class metadata requires runtime lookup",
});
if (pointer.kind === "raw" || pointer.kind === "rebase")
return typeReferenceResult({
kind,
target:
pointer.kind === "raw" && pointer.target === 0n ? null : pointer.target,
reason: "Indirect Objective-C class metadata requires runtime lookup",
});
return typeReferenceResult({
kind,
target: null,
reason: pointer.reason,
});
};
/** Decode source-encoded class identity; ObjC runtime lookup remains unavailable. */
export const decodeSwiftConformanceTypeReference = (
input: SwiftTypeReferenceInput,
): SwiftConformanceTypeReference => {
const kind = (input.flags >>> 3) & 7;
try {
const value = input.relative(input.descriptor + 4n, "conformanceType");
switch (kind) {
case 0:
case 1:
return decodeNominalTypeReference(kind, input, value);
case 2:
return decodeDirectObjcClassName(kind, input.read, value);
case 3:
return decodeIndirectObjcClass(kind, input.read, value);
default:
return typeReferenceResult({
kind,
target: value.kind === "target" ? value.target : null,
reason:
value.kind === "unknown"
? value.reason
: `Unsupported Swift conformance type-reference kind ${kind}`,
});
}
} catch (cause) {
const reason = expectedSwiftMetadataReadFailure(cause);
if (reason === null) throw cause;
return typeReferenceResult({
kind,
target: null,
reason,
});
}
};