@veraanchor/verifier 0.0.0-stage → 0.1.0

package/dist/resolvers/hcs1MirrorV1.js

@@ -0,0 +1,220 @@
+import { MAX_HCS1_V1_CHUNKS, parseHcs1ReferenceV1, verifyHcs1ContentV1, } from "../standards/hcs/hcs1V1.js";
+const BASE = Object.freeze({
+    mainnet: "https://mainnet-public.mirrornode.hedera.com/api/v1",
+    testnet: "https://testnet.mirrornode.hedera.com/api/v1",
+});
+const MAX_RESPONSE_BYTES = 4 * 1024 * 1024;
+const MAX_PAGES = Math.ceil(MAX_HCS1_V1_CHUNKS / 100) + 1;
+const B64 = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+const MEMO = /^[0-9a-f]{64}:zstd:base64$/;
+class MirrorFailure extends Error {
+    code;
+    invalid;
+    constructor(code, invalid = false) {
+        super(code);
+        this.code = code;
+        this.invalid = invalid;
+    }
+}
+function record(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new MirrorFailure("HCS1_MIRROR_RESPONSE_INVALID", true);
+    }
+    return value;
+}
+function baseUrl(config, network) {
+    const raw = config.base_urls?.[network] ?? BASE[network];
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new TypeError("Invalid HCS-1 Mirror base URL");
+    }
+    const loopback = ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
+    if ((url.protocol !== "https:" && !(loopback && url.protocol === "http:")) ||
+        url.username || url.password || url.search || url.hash ||
+        !url.pathname.endsWith("/api/v1")) {
+        throw new TypeError("HCS-1 Mirror requires a fixed HTTPS /api/v1 endpoint (or HTTP loopback)");
+    }
+    return url;
+}
+function bounds(config) {
+    const timeout = config.timeout_ms ?? 8000;
+    const max = config.max_response_bytes ?? 2 * 1024 * 1024;
+    const total = config.total_timeout_ms ?? 30000;
+    if (!Number.isSafeInteger(timeout) || timeout < 250 || timeout > 15000 ||
+        !Number.isSafeInteger(max) || max < 1024 || max > MAX_RESPONSE_BYTES ||
+        !Number.isSafeInteger(total) || total < 250 || total > 60000) {
+        throw new TypeError("Invalid HCS-1 Mirror read limits");
+    }
+    return { timeout, max, deadline: Date.now() + total };
+}
+async function readJson(config, url, expectedBase, topicPath, limit) {
+    const prefix = `${expectedBase.pathname}/topics/${topicPath}`;
+    if (url.origin !== expectedBase.origin ||
+        (url.pathname !== prefix && url.pathname !== `${prefix}/messages`)) {
+        throw new MirrorFailure("HCS1_MIRROR_ENDPOINT_INVALID", true);
+    }
+    const remaining = limit.deadline - Date.now();
+    if (remaining <= 0)
+        throw new MirrorFailure("HCS1_MIRROR_TIMEOUT");
+    let response;
+    try {
+        response = await (config.fetch_impl ?? fetch)(url.toString(), {
+            method: "GET", headers: { Accept: "application/json" },
+            redirect: "error", credentials: "omit", cache: "no-store",
+            signal: AbortSignal.timeout(Math.min(remaining, limit.timeout)),
+        });
+    }
+    catch {
+        throw new MirrorFailure("HCS1_MIRROR_UNAVAILABLE");
+    }
+    if (response.status === 404)
+        return null;
+    if (response.status === 429)
+        throw new MirrorFailure("HCS1_MIRROR_RATE_LIMITED");
+    if (!response.ok)
+        throw new MirrorFailure("HCS1_MIRROR_UNAVAILABLE");
+    const advertised = response.headers.get("content-length");
+    if (advertised && Number(advertised) > limit.max)
+        throw new MirrorFailure("HCS1_MIRROR_RESPONSE_TOO_LARGE");
+    if (!response.body)
+        throw new MirrorFailure("HCS1_MIRROR_RESPONSE_INVALID", true);
+    const reader = response.body.getReader();
+    const buffers = [];
+    let total = 0;
+    try {
+        while (true) {
+            const part = await reader.read();
+            if (part.done)
+                break;
+            total += part.value.byteLength;
+            if (total > limit.max) {
+                await reader.cancel().catch(() => undefined);
+                throw new MirrorFailure("HCS1_MIRROR_RESPONSE_TOO_LARGE");
+            }
+            buffers.push(part.value);
+        }
+    }
+    catch (error) {
+        if (error instanceof MirrorFailure)
+            throw error;
+        throw new MirrorFailure("HCS1_MIRROR_UNAVAILABLE");
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const data = new Uint8Array(total);
+    let offset = 0;
+    for (const part of buffers) {
+        data.set(part, offset);
+        offset += part.byteLength;
+    }
+    try {
+        return record(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(data)));
+    }
+    catch (error) {
+        if (error instanceof MirrorFailure)
+            throw error;
+        throw new MirrorFailure("HCS1_MIRROR_RESPONSE_INVALID", true);
+    }
+}
+function normalizeMemo(value) {
+    if (typeof value !== "string" || value.length > 256)
+        throw new MirrorFailure("HCS1_TOPIC_MEMO_INVALID", true);
+    if (MEMO.test(value))
+        return value;
+    if (!B64.test(value))
+        throw new MirrorFailure("HCS1_TOPIC_MEMO_INVALID", true);
+    const decoded = Buffer.from(value, "base64");
+    const memo = decoded.toString("utf8");
+    if (decoded.toString("base64") !== value || !MEMO.test(memo)) {
+        throw new MirrorFailure("HCS1_TOPIC_MEMO_INVALID", true);
+    }
+    return memo;
+}
+function messageBytes(value, topic, previousSequence) {
+    const row = record(value);
+    if (row.topic_id !== topic || !Number.isSafeInteger(row.sequence_number) ||
+        row.sequence_number <= previousSequence || typeof row.message !== "string" ||
+        !B64.test(row.message)) {
+        throw new MirrorFailure("HCS1_MIRROR_MESSAGE_INVALID", true);
+    }
+    const bytes = Buffer.from(row.message, "base64");
+    if (!bytes.length || bytes.length > 1024 || bytes.toString("base64") !== row.message) {
+        throw new MirrorFailure("HCS1_MIRROR_MESSAGE_INVALID", true);
+    }
+    return { bytes, sequence: row.sequence_number };
+}
+function result(request, status, reason, verification) {
+    return Object.freeze({ status, reason_code: reason, reference: request.reference,
+        hedera_network: request.network, resolver_id: "hedera.mirror-rest.hcs1.v1", verification });
+}
+/**
+ * Mirror response is independently observed relative to VA services, but is
+ * not Hedera consensus-signature authentication. No arbitrary evidence URLs.
+ */
+export async function resolveHcs1FileV1(config, request, decodeOptions = {}) {
+    const ref = parseHcs1ReferenceV1(request?.reference);
+    if (request.network !== "mainnet" && request.network !== "testnet") {
+        throw new TypeError("HCS1_NETWORK_INVALID");
+    }
+    const base = baseUrl(config, request.network);
+    const limit = bounds(config);
+    const basePath = base.toString().replace(/\/$/, "");
+    const topic = ref.topic_id;
+    try {
+        const topicRow = await readJson(config, new URL(`${basePath}/topics/${topic}`), base, topic, limit);
+        if (!topicRow)
+            return result(request, "unavailable", "HCS1_TOPIC_NOT_FOUND", null);
+        if (topicRow.topic_id !== topic || !topicRow.submit_key || topicRow.admin_key) {
+            throw new MirrorFailure("HCS1_TOPIC_METADATA_INVALID", true);
+        }
+        const memo = normalizeMemo(topicRow.memo);
+        let url = new URL(`${basePath}/topics/${topic}/messages?limit=100&order=asc`);
+        const messages = [];
+        let previousSequence = 0;
+        let pages = 0;
+        const visited = new Set();
+        while (url) {
+            if (++pages > MAX_PAGES || visited.has(url.toString())) {
+                throw new MirrorFailure("HCS1_MIRROR_PAGINATION_INVALID", true);
+            }
+            visited.add(url.toString());
+            const page = await readJson(config, url, base, topic, limit);
+            if (!page || !Array.isArray(page.messages) || page.messages.length > 100) {
+                throw new MirrorFailure("HCS1_MIRROR_RESPONSE_INVALID", true);
+            }
+            for (const message of page.messages) {
+                const parsed = messageBytes(message, topic, previousSequence);
+                previousSequence = parsed.sequence;
+                messages.push(parsed.bytes);
+                if (messages.length > MAX_HCS1_V1_CHUNKS) {
+                    throw new MirrorFailure("HCS1_TOO_MANY_CHUNKS", true);
+                }
+            }
+            const link = page.links == null ? null : record(page.links).next;
+            if (link != null && (typeof link !== "string" || !link.length)) {
+                throw new MirrorFailure("HCS1_MIRROR_PAGINATION_INVALID", true);
+            }
+            url = link ? new URL(link, `${basePath}/`) : null;
+            if (url && (url.origin !== base.origin ||
+                url.pathname !== `${base.pathname}/topics/${topic}/messages`)) {
+                throw new MirrorFailure("HCS1_MIRROR_PAGINATION_INVALID", true);
+            }
+        }
+        const verification = await verifyHcs1ContentV1({ memo, messages,
+            expected_sha256: request.expected_sha256 ?? null }, decodeOptions);
+        const status = verification.status === "pass" ? "resolved" :
+            verification.status === "unsupported" ? "unsupported" : "invalid";
+        return result(request, status, verification.reason_code, verification);
+    }
+    catch (error) {
+        if (error instanceof MirrorFailure) {
+            return result(request, error.invalid ? "invalid" : "unavailable", error.code, null);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=hcs1MirrorV1.js.map

package/dist/resolvers/hcs1MirrorV1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcs1MirrorV1.js","sourceRoot":"","sources":["../../src/resolvers/hcs1MirrorV1.ts"],"names":[],"mappings":"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"}

package/dist/resolvers/hcs26MirrorV1.d.ts

@@ -0,0 +1,67 @@
+/** Exact historical HCS-26 discovery/version registers -> HCS-1 SKILL.json -> declared HCS-1 files.
+ * Does not reconstruct current registry state, authenticate a publisher, or
+ * authenticate Hedera consensus. Manifest files are resolved only through
+ * their pinned HCS-1 references on the explicitly selected Hedera network.
+ */
+import type { HederaNetwork } from "../contracts/verification.js";
+import { type Hcs1MirrorV1Config } from "./hcs1MirrorV1.js";
+import { type Hcs1V1ContentOptions } from "../standards/hcs/hcs1V1.js";
+import { type Hcs26VersionRegisterV1, type Hcs26SkillManifestV1 } from "../standards/hcs/hcs26V1.js";
+export type Hcs26ManifestFileResolutionV1 = Readonly<{
+    path: string;
+    reference: string;
+    expected_sha256: string;
+    observed_sha256: string | null;
+    byte_length: number | null;
+    status: "resolved" | "conflict" | "invalid" | "unavailable" | "unsupported";
+    reason_code: string | null;
+}>;
+export type Hcs26ManifestFilesResolutionV1 = Readonly<{
+    status: "resolved" | "conflict" | "invalid" | "unavailable" | "unsupported";
+    reason_code: string | null;
+    declared_file_count: number;
+    resolved_file_count: number;
+    total_bytes: number;
+    /** Deterministic manifest-order observations; on failure, contains only the attempted prefix. */
+    files: readonly Hcs26ManifestFileResolutionV1[];
+}>;
+export type Hcs26MirrorV1Request = Readonly<{
+    hedera_network: HederaNetwork;
+    discovery_topic_id: string;
+    /** Historical discovery entry, which assigns the skill UID. */
+    discovery_sequence_number: number;
+    /** Exact historical entry in the registered per-skill version topic. */
+    version_sequence_number: number;
+    expected_skill_uid?: number | null;
+    expected_account_id?: string | null;
+    expected_version_topic_id?: string | null;
+    expected_version?: string | null;
+    expected_manifest_reference?: string | null;
+    expected_manifest_sha256?: string | null;
+}>;
+export type Hcs26MirrorV1Result = Readonly<{
+    status: "resolved" | "conflict" | "invalid" | "unavailable" | "unsupported";
+    reason_code: string | null;
+    hedera_network: HederaNetwork;
+    resolver_id: "hedera.mirror-rest.hcs26.v1";
+    discovery_topic_id: string;
+    discovery_sequence_number: number;
+    discovery_consensus_timestamp_exact: string | null;
+    publisher_account_id: string | null;
+    version_topic_id: string | null;
+    registry_memo_temporal_scope: "current_observation";
+    version_sequence_number: number;
+    version_consensus_timestamp_exact: string | null;
+    /** This is the historical registration status, NOT its current status. */
+    historical_version_status: Hcs26VersionRegisterV1["status"] | null;
+    skill_uid: number | null;
+    version: string | null;
+    manifest_reference: string | null;
+    content_sha256: string | null;
+    manifest_sha256: string | null;
+    manifest: Hcs26SkillManifestV1["manifest"] | null;
+    manifest_files: Hcs26ManifestFilesResolutionV1 | null;
+    assurance: "mirror_corroborated";
+}>;
+export declare function resolveHcs26SkillVersionV1(config: Hcs1MirrorV1Config, request: Hcs26MirrorV1Request, decodeOptions?: Hcs1V1ContentOptions): Promise<Hcs26MirrorV1Result>;
+//# sourceMappingURL=hcs26MirrorV1.d.ts.map

package/dist/resolvers/hcs26MirrorV1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcs26MirrorV1.d.ts","sourceRoot":"","sources":["../../src/resolvers/hcs26MirrorV1.ts"],"names":[],"mappings":"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"}

package/dist/resolvers/hcs26MirrorV1.js

@@ -0,0 +1,218 @@
+import { resolveHcs1FileV1 } from "./hcs1MirrorV1.js";
+import { readHcs26RegistryMessageV1 } from "./hcs26RegistryMirrorV1.js";
+import { MAX_HCS1_V1_FILE_BYTES, parseHcs1ReferenceV1 } from "../standards/hcs/hcs1V1.js";
+import { Hcs26V1Error, parseHcs26DiscoveryRegisterV1, parseHcs26VersionRegisterV1, parseHcs26SkillManifestV1, verifyHcs26SkillVersionV1 } from "../standards/hcs/hcs26V1.js";
+const TOPIC = /^0\.0\.[0-9]+$/;
+const SHA256 = /^[0-9a-f]{64}$/;
+const MAX_MANIFEST_FILES = 256;
+const MAX_MANIFEST_FILES_TOTAL_BYTES = 32 * 1024 * 1024;
+const MANIFEST_FILES_TOTAL_TIMEOUT_MS = 60_000;
+function manifestFilesOf(manifest) {
+    const entries = manifest.files;
+    if (!Array.isArray(entries) || entries.length < 1 || entries.length > MAX_MANIFEST_FILES) {
+        throw new Hcs26V1Error("HCS26_FILES_INVALID");
+    }
+    return Object.freeze(entries.map((entry) => {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+            throw new Hcs26V1Error("HCS26_FILES_INVALID");
+        }
+        const row = entry;
+        if (typeof row.path !== "string" || !row.path || row.path.length > 512 ||
+            typeof row.hrl !== "string" || typeof row.sha256 !== "string" || !SHA256.test(row.sha256)) {
+            throw new Hcs26V1Error("HCS26_FILES_INVALID");
+        }
+        const reference = parseHcs1ReferenceV1(row.hrl).reference;
+        return Object.freeze({ path: row.path, hrl: reference, sha256: row.sha256 });
+    }));
+}
+function fileResolution(file, status, reason_code, observed_sha256 = null, byte_length = null) {
+    return Object.freeze({ path: file.path, reference: file.hrl, expected_sha256: file.sha256,
+        observed_sha256, byte_length, status, reason_code });
+}
+async function resolveManifestFilesV1(config, network, manifest, decodeOptions) {
+    const declarations = manifestFilesOf(manifest);
+    const files = [];
+    const deadline = Date.now() + MANIFEST_FILES_TOTAL_TIMEOUT_MS;
+    const configuredFileLimit = decodeOptions.max_file_bytes ?? MAX_HCS1_V1_FILE_BYTES;
+    let totalBytes = 0;
+    const output = (status, reason_code) => Object.freeze({ status, reason_code, declared_file_count: declarations.length,
+        resolved_file_count: files.filter((file) => file.status === "resolved").length,
+        total_bytes: totalBytes, files: Object.freeze([...files]) });
+    // Sequential by design: exact manifest order, one outstanding HCS-1 read, and
+    // a strict aggregate byte budget keep resource use bounded and result ordering deterministic.
+    for (const file of declarations) {
+        const remainingMs = deadline - Date.now();
+        if (remainingMs < 250)
+            return output("unavailable", "HCS26_MANIFEST_FILES_TIMEOUT");
+        const remainingBytes = MAX_MANIFEST_FILES_TOTAL_BYTES - totalBytes;
+        if (remainingBytes < 1)
+            return output("unsupported", "HCS26_MANIFEST_FILES_TOTAL_BYTES_EXCEEDED");
+        const effectiveFileLimit = Math.min(configuredFileLimit, remainingBytes);
+        const configuredReadTimeout = config.total_timeout_ms ?? 30_000;
+        const readConfig = {
+            ...config,
+            total_timeout_ms: Math.min(configuredReadTimeout, remainingMs),
+        };
+        const fileDecodeOptions = {
+            ...decodeOptions,
+            max_file_bytes: effectiveFileLimit,
+        };
+        const observed = await resolveHcs1FileV1(readConfig, {
+            network, reference: file.hrl,
+        }, fileDecodeOptions);
+        if (observed.status !== "resolved" || !observed.verification?.bytes || !observed.verification.sha256) {
+            const aggregateLimited = effectiveFileLimit < configuredFileLimit &&
+                observed.reason_code === "HCS1_FILE_TOO_LARGE";
+            const timedOut = Date.now() >= deadline && observed.status === "unavailable";
+            const status = aggregateLimited ? "unsupported" :
+                observed.status === "resolved" ? "invalid" : observed.status;
+            const reason = aggregateLimited ? "HCS26_MANIFEST_FILES_TOTAL_BYTES_EXCEEDED" :
+                timedOut ? "HCS26_MANIFEST_FILES_TIMEOUT" :
+                    observed.status === "resolved" ? "HCS26_MANIFEST_FILE_OBSERVATION_INVALID" :
+                        observed.reason_code ?? "HCS26_MANIFEST_FILE_UNAVAILABLE";
+            files.push(fileResolution(file, status, reason));
+            return output(status, reason);
+        }
+        const observedHash = observed.verification.sha256;
+        const byteLength = observed.verification.bytes.byteLength;
+        if (observedHash !== file.sha256) {
+            const reason = "HCS26_MANIFEST_FILE_CHECKSUM_MISMATCH";
+            files.push(fileResolution(file, "conflict", reason, observedHash, byteLength));
+            return output("conflict", reason);
+        }
+        totalBytes += byteLength;
+        files.push(fileResolution(file, "resolved", null, observedHash, byteLength));
+    }
+    return output("resolved", null);
+}
+export async function resolveHcs26SkillVersionV1(config, request, decodeOptions = {}) {
+    if (!request || (request.hedera_network !== "mainnet" && request.hedera_network !== "testnet") ||
+        !TOPIC.test(request.discovery_topic_id) ||
+        !Number.isSafeInteger(request.discovery_sequence_number) || request.discovery_sequence_number < 1 ||
+        !Number.isSafeInteger(request.version_sequence_number) || request.version_sequence_number < 1 ||
+        (request.expected_skill_uid != null && (!Number.isSafeInteger(request.expected_skill_uid) || request.expected_skill_uid < 1)) ||
+        (request.expected_account_id != null && !TOPIC.test(request.expected_account_id)) ||
+        (request.expected_version_topic_id != null && !TOPIC.test(request.expected_version_topic_id)) ||
+        (request.expected_manifest_sha256 != null && !SHA256.test(request.expected_manifest_sha256))) {
+        throw new TypeError("HCS26_VERIFICATION_LOCATOR_INVALID");
+    }
+    if (request.expected_manifest_reference != null)
+        parseHcs1ReferenceV1(request.expected_manifest_reference);
+    if (request.expected_version != null && (typeof request.expected_version !== "string" ||
+        !request.expected_version.length || request.expected_version.length > 64)) {
+        throw new TypeError("HCS26_EXPECTED_VERSION_INVALID");
+    }
+    let discoveryTime = null;
+    let publisherAccount = null;
+    let versionTopic = null;
+    let versionTime = null;
+    let register = null;
+    let manifestRef = null;
+    let contentHash = null;
+    let manifestHash = null;
+    let manifest = null;
+    let manifestFiles = null;
+    const output = (status, reason_code) => Object.freeze({ status, reason_code, hedera_network: request.hedera_network,
+        resolver_id: "hedera.mirror-rest.hcs26.v1",
+        discovery_topic_id: request.discovery_topic_id, discovery_sequence_number: request.discovery_sequence_number,
+        discovery_consensus_timestamp_exact: discoveryTime, publisher_account_id: publisherAccount,
+        version_topic_id: versionTopic, registry_memo_temporal_scope: "current_observation",
+        version_sequence_number: request.version_sequence_number,
+        version_consensus_timestamp_exact: versionTime, historical_version_status: register?.status ?? null,
+        skill_uid: register?.skill_uid ?? null, version: register?.version ?? null,
+        manifest_reference: manifestRef, content_sha256: contentHash, manifest_sha256: manifestHash,
+        manifest, manifest_files: manifestFiles, assurance: "mirror_corroborated" });
+    if (request.expected_skill_uid != null && request.expected_skill_uid !== request.discovery_sequence_number) {
+        return output("conflict", "HCS26_SKILL_UID_MISMATCH");
+    }
+    const discovery = await readHcs26RegistryMessageV1(config, {
+        hedera_network: request.hedera_network, topic_id: request.discovery_topic_id,
+        sequence_number: request.discovery_sequence_number, registry_type: "discovery",
+    });
+    if (discovery.status !== "resolved" || !discovery.evidence) {
+        return output(discovery.status, discovery.reason_code ?? "HCS26_DISCOVERY_UNAVAILABLE");
+    }
+    discoveryTime = discovery.evidence.consensus_timestamp;
+    let decodedDiscovery;
+    try {
+        decodedDiscovery = parseHcs26DiscoveryRegisterV1(discovery.evidence.message);
+    }
+    catch (error) {
+        if (error instanceof Hcs26V1Error)
+            return output("invalid", error.code);
+        throw error;
+    }
+    versionTopic = decodedDiscovery.t_id;
+    publisherAccount = decodedDiscovery.account_id;
+    if (request.expected_version_topic_id != null && versionTopic !== request.expected_version_topic_id) {
+        return output("conflict", "HCS26_VERSION_TOPIC_MISMATCH");
+    }
+    if (request.expected_account_id != null && publisherAccount !== request.expected_account_id) {
+        return output("conflict", "HCS26_PUBLISHER_ACCOUNT_MISMATCH");
+    }
+    const version = await readHcs26RegistryMessageV1(config, {
+        hedera_network: request.hedera_network, topic_id: versionTopic,
+        sequence_number: request.version_sequence_number, registry_type: "version",
+    });
+    if (version.status !== "resolved" || !version.evidence) {
+        return output(version.status, version.reason_code ?? "HCS26_VERSION_UNAVAILABLE");
+    }
+    versionTime = version.evidence.consensus_timestamp;
+    try {
+        register = parseHcs26VersionRegisterV1(version.evidence.message);
+    }
+    catch (error) {
+        if (error instanceof Hcs26V1Error)
+            return output("invalid", error.code);
+        throw error;
+    }
+    if (register.skill_uid !== request.discovery_sequence_number) {
+        return output("conflict", "HCS26_SKILL_UID_MISMATCH");
+    }
+    if (request.expected_version != null && register.version !== request.expected_version) {
+        return output("conflict", "HCS26_VERSION_MISMATCH");
+    }
+    manifestRef = `hcs://1/${register.t_id}`;
+    if (request.expected_manifest_reference != null && manifestRef !== request.expected_manifest_reference) {
+        return output("conflict", "HCS26_MANIFEST_REFERENCE_MISMATCH");
+    }
+    const content = await resolveHcs1FileV1(config, {
+        network: request.hedera_network, reference: manifestRef,
+        expected_sha256: request.expected_manifest_sha256 ?? null,
+    }, decodeOptions);
+    if (content.status !== "resolved" || !content.verification?.bytes || !content.verification.sha256) {
+        return output(content.reason_code === "HCS1_EXPECTED_CHECKSUM_MISMATCH" ? "conflict" : content.status, content.reason_code ?? "HCS26_MANIFEST_UNAVAILABLE");
+    }
+    contentHash = content.verification.sha256;
+    const verified = verifyHcs26SkillVersionV1({
+        version_register: version.evidence.message, manifest: content.verification.bytes,
+        expected_skill_uid: request.discovery_sequence_number,
+        ...(request.expected_version == null ? {} : { expected_version: request.expected_version }),
+        ...(request.expected_manifest_sha256 == null ? {} : { expected_sha256: request.expected_manifest_sha256 }),
+    });
+    manifestHash = verified.sha256;
+    if (verified.status !== "pass") {
+        return output(["HCS26_CHECKSUM_MISMATCH", "HCS26_VERSION_MISMATCH", "HCS26_EXPECTED_CHECKSUM_MISMATCH"].includes(verified.reason_code ?? "") ? "conflict" : "invalid", verified.reason_code);
+    }
+    try {
+        const parsed = parseHcs26SkillManifestV1(content.verification.bytes);
+        manifestHash = parsed.sha256;
+        if (parsed.canonical_payload !== Buffer.from(content.verification.bytes).toString("utf8")) {
+            return output("unsupported", "HCS26_MANIFEST_CONTENT_NOT_CANONICAL");
+        }
+        if (manifestHash !== contentHash)
+            return output("conflict", "HCS26_CANONICAL_CONTENT_MISMATCH");
+        manifest = parsed.manifest;
+        manifestFiles = await resolveManifestFilesV1(config, request.hedera_network, manifest, decodeOptions);
+        if (manifestFiles.status !== "resolved") {
+            return output(manifestFiles.status, manifestFiles.reason_code);
+        }
+        return output("resolved", null);
+    }
+    catch (error) {
+        if (error instanceof Hcs26V1Error)
+            return output("invalid", error.code);
+        throw error;
+    }
+}
+//# sourceMappingURL=hcs26MirrorV1.js.map

package/dist/resolvers/hcs26MirrorV1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcs26MirrorV1.js","sourceRoot":"","sources":["../../src/resolvers/hcs26MirrorV1.ts"],"names":[],"mappings":"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"}

package/dist/resolvers/hcs26RegistryMirrorV1.d.ts

@@ -0,0 +1,26 @@
+/** Bounded, read-only observation of one exact historical HCS-26 registry message.
+ * This is Mirror REST corroboration, not authenticated Hedera consensus. Internal
+ * adapter: consumers must apply the pinned HCS-26 operation parser themselves.
+ */
+import type { HederaNetwork } from "../contracts/verification.js";
+import type { HederaMirrorV1Config } from "./hederaMirrorV1.js";
+import { type Hcs26MemoV1 } from "../standards/hcs/hcs26V1.js";
+export type Hcs26RegistryMessageV1 = Readonly<{
+    topic_id: string;
+    sequence_number: number;
+    consensus_timestamp: string;
+    memo: Hcs26MemoV1;
+    message: Uint8Array;
+}>;
+export type Hcs26RegistryReadV1 = Readonly<{
+    status: "resolved" | "unavailable" | "invalid";
+    reason_code: string | null;
+    evidence: Hcs26RegistryMessageV1 | null;
+}>;
+export declare function readHcs26RegistryMessageV1(config: HederaMirrorV1Config, request: Readonly<{
+    hedera_network: HederaNetwork;
+    topic_id: string;
+    sequence_number: number;
+    registry_type: "discovery" | "version";
+}>): Promise<Hcs26RegistryReadV1>;
+//# sourceMappingURL=hcs26RegistryMirrorV1.d.ts.map

package/dist/resolvers/hcs26RegistryMirrorV1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcs26RegistryMirrorV1.d.ts","sourceRoot":"","sources":["../../src/resolvers/hcs26RegistryMirrorV1.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAoB,KAAK,WAAW,EAAgB,MAAM,6BAA6B,CAAC;AAY/F,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;CACrB,CAAC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;IAC/C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACzC,CAAC,CAAC;AAgHH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,QAAQ,CAAC;IAAE,cAAc,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAClE,eAAe,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,CAAC,GACnE,OAAO,CAAC,mBAAmB,CAAC,CAmC9B"}