@veraanchor/verifier 0.0.0-stage → 0.1.0

package/dist/resolvers/hcs11MirrorV1.js

@@ -0,0 +1,293 @@
+import { resolveHcs1FileV1 } from "./hcs1MirrorV1.js";
+import { resolveHcs2RegisterV1 } from "./hcs2MirrorV1.js";
+import { parseHcs11AccountMemoV1, verifyHcs11AiAgentProfileV1 } from "../standards/hcs/hcs11V1.js";
+import { parseHcs1ReferenceV1 } from "../standards/hcs/hcs1V1.js";
+import { parseHcs14DidUaidV1 } from "../standards/hcs/hcs14V1.js";
+const BASE = Object.freeze({
+    mainnet: "https://mainnet-public.mirrornode.hedera.com/api/v1",
+    testnet: "https://testnet.mirrornode.hedera.com/api/v1",
+});
+const ACCOUNT = /^0\.0\.[0-9]+$/;
+const SHA256 = /^[0-9a-f]{64}$/;
+const B64 = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+const MAX_RESPONSE_BYTES = 256 * 1024;
+class AccountReadError 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 AccountReadError("HCS11_ACCOUNT_RESPONSE_INVALID", true);
+    }
+    return value;
+}
+function validatedBase(config, network) {
+    let url;
+    try {
+        url = new URL(config.base_urls?.[network] ?? BASE[network]);
+    }
+    catch {
+        throw new TypeError("HCS11_MIRROR_BASE_URL_INVALID");
+    }
+    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("HCS11_MIRROR_BASE_URL_INVALID");
+    }
+    return url;
+}
+function validatedLimits(config) {
+    const timeout = config.timeout_ms ?? 8000;
+    const max = config.max_response_bytes ?? MAX_RESPONSE_BYTES;
+    if (!Number.isSafeInteger(timeout) || timeout < 250 || timeout > 15000 ||
+        !Number.isSafeInteger(max) || max < 1024 || max > MAX_RESPONSE_BYTES) {
+        throw new TypeError("HCS11_MIRROR_BOUNDS_INVALID");
+    }
+    return { timeout, max };
+}
+async function readAccount(config, url, bounds) {
+    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(bounds.timeout),
+        });
+    }
+    catch {
+        throw new AccountReadError("HCS11_ACCOUNT_UNAVAILABLE");
+    }
+    if (response.status === 404)
+        return null;
+    if (response.status === 429)
+        throw new AccountReadError("HCS11_ACCOUNT_RATE_LIMITED");
+    if (!response.ok)
+        throw new AccountReadError("HCS11_ACCOUNT_UNAVAILABLE");
+    const length = response.headers.get("content-length");
+    if (length && (!Number.isFinite(Number(length)) || Number(length) > bounds.max)) {
+        throw new AccountReadError("HCS11_ACCOUNT_RESPONSE_TOO_LARGE");
+    }
+    if (!response.body)
+        throw new AccountReadError("HCS11_ACCOUNT_RESPONSE_INVALID", true);
+    const reader = response.body.getReader();
+    const parts = [];
+    let count = 0;
+    try {
+        while (true) {
+            const part = await reader.read();
+            if (part.done)
+                break;
+            count += part.value.byteLength;
+            if (count > bounds.max) {
+                await reader.cancel().catch(() => undefined);
+                throw new AccountReadError("HCS11_ACCOUNT_RESPONSE_TOO_LARGE");
+            }
+            parts.push(part.value);
+        }
+    }
+    catch (error) {
+        if (error instanceof AccountReadError)
+            throw error;
+        throw new AccountReadError("HCS11_ACCOUNT_UNAVAILABLE");
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const combined = new Uint8Array(count);
+    let at = 0;
+    for (const part of parts) {
+        combined.set(part, at);
+        at += part.length;
+    }
+    try {
+        return record(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(combined)));
+    }
+    catch (error) {
+        if (error instanceof AccountReadError)
+            throw error;
+        throw new AccountReadError("HCS11_ACCOUNT_RESPONSE_INVALID", true);
+    }
+}
+function decodeMemo(value) {
+    if (typeof value !== "string" || value.length > 1024) {
+        throw new AccountReadError("HCS11_ACCOUNT_MEMO_INVALID", true);
+    }
+    if (!B64.test(value))
+        throw new AccountReadError("HCS11_ACCOUNT_MEMO_INVALID", true);
+    const bytes = Buffer.from(value, "base64");
+    let decoded;
+    try {
+        decoded = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    }
+    catch {
+        throw new AccountReadError("HCS11_ACCOUNT_MEMO_INVALID", true);
+    }
+    if (bytes.toString("base64") !== value || Buffer.byteLength(decoded, "utf8") > 100) {
+        throw new AccountReadError("HCS11_ACCOUNT_MEMO_INVALID", true);
+    }
+    return decoded;
+}
+function observedAccountMemo(row) {
+    const encoded = row.memo_base64;
+    let memo = null;
+    if (encoded != null)
+        memo = decodeMemo(encoded);
+    if (row.memo != null) {
+        if (typeof row.memo !== "string")
+            throw new AccountReadError("HCS11_ACCOUNT_MEMO_INVALID", true);
+        const plain = row.memo.startsWith("hcs-11:") ? row.memo : decodeMemo(row.memo);
+        if (memo !== null && memo !== plain)
+            throw new AccountReadError("HCS11_ACCOUNT_MEMO_CONFLICT", true);
+        memo = plain;
+    }
+    if (!memo)
+        throw new AccountReadError("HCS11_ACCOUNT_MEMO_UNAVAILABLE");
+    try {
+        return parseHcs11AccountMemoV1(memo);
+    }
+    catch {
+        throw new AccountReadError("HCS11_ACCOUNT_MEMO_INVALID", true);
+    }
+}
+function checkedRequest(request) {
+    if (!request || (request.hedera_network !== "mainnet" && request.hedera_network !== "testnet") ||
+        typeof request.account_id !== "string" || request.account_id.length > 128 ||
+        !ACCOUNT.test(request.account_id))
+        throw new TypeError("HCS11_ACCOUNT_LOCATOR_INVALID");
+    if (request.hcs2_sequence_number !== undefined && (!Number.isSafeInteger(request.hcs2_sequence_number) ||
+        request.hcs2_sequence_number < 1))
+        throw new TypeError("HCS11_HCS2_SEQUENCE_INVALID");
+    if (request.expected_profile_reference != null) {
+        parseHcs11AccountMemoV1(`hcs-11:${request.expected_profile_reference}`);
+    }
+    if (request.expected_hcs1_reference != null)
+        parseHcs1ReferenceV1(request.expected_hcs1_reference);
+    for (const value of [request.expected_hcs1_sha256, request.expected_profile_sha256]) {
+        if (value != null && (typeof value !== "string" || !SHA256.test(value))) {
+            throw new TypeError("HCS11_EXPECTED_SHA256_INVALID");
+        }
+    }
+    if (request.expected_uaid != null)
+        parseHcs14DidUaidV1(request.expected_uaid);
+    if (request.expected_base_did != null && (typeof request.expected_base_did !== "string" ||
+        !request.expected_base_did.trim() || request.expected_base_did.length > 2048)) {
+        throw new TypeError("HCS11_EXPECTED_DID_INVALID");
+    }
+}
+/** Only follows the observed account memo and, where necessary, an explicit HCS-2 sequence. */
+export async function resolveHcs11ProfileV1(config, request, decodeOptions = {}) {
+    checkedRequest(request);
+    const base = validatedBase(config, request.hedera_network);
+    const bounds = validatedLimits(config);
+    const accountId = request.account_id;
+    let accountMemo = null;
+    let registryEntry = null;
+    let profileRef = null;
+    let contentSha = null;
+    let canonicalSha = null;
+    let profile = null;
+    let didBinding = "not_checked";
+    const output = (status, reason) => Object.freeze({ status, reason_code: reason, hedera_network: request.hedera_network,
+        account_id: accountId, resolver_id: "hedera.mirror-rest.hcs11.v1",
+        account_memo_temporal_scope: "current_observation",
+        account_memo: accountMemo, registry_entry: registryEntry,
+        profile_reference: profileRef, content_sha256: contentSha,
+        canonical_profile_sha256: canonicalSha, profile, did_binding: didBinding });
+    try {
+        const accountUrl = new URL(`${base.toString().replace(/\/$/, "")}/accounts/${accountId}`);
+        const row = await readAccount(config, accountUrl, bounds);
+        if (!row)
+            return output("unavailable", "HCS11_ACCOUNT_NOT_FOUND");
+        if (row.account !== accountId)
+            return output("invalid", "HCS11_ACCOUNT_SCOPE_MISMATCH");
+        if (row.deleted === true)
+            return output("unavailable", "HCS11_ACCOUNT_DELETED");
+        accountMemo = observedAccountMemo(row);
+        if (request.expected_profile_reference != null &&
+            accountMemo.profile_reference !== request.expected_profile_reference) {
+            return output("conflict", "HCS11_ACCOUNT_REFERENCE_MISMATCH");
+        }
+        if (accountMemo.protocol === "hcs-2") {
+            const sequence = request.hcs2_sequence_number;
+            if (sequence === undefined)
+                return output("unavailable", "HCS11_HCS2_SEQUENCE_REQUIRED");
+            const expectedTopic = request.expected_hcs1_reference == null ? null :
+                parseHcs1ReferenceV1(request.expected_hcs1_reference).topic_id;
+            const registry = await resolveHcs2RegisterV1(config, {
+                hedera_network: request.hedera_network,
+                registry_topic_id: accountMemo.topic_id,
+                sequence_number: sequence,
+                expected_t_id: expectedTopic,
+            });
+            if (registry.status !== "resolved" || !registry.verification?.register ||
+                !registry.consensus_timestamp) {
+                return output(registry.status === "conflict" ? "conflict" :
+                    registry.status === "invalid" ? "invalid" : "unavailable", registry.reason_code ?? "HCS11_HCS2_ENTRY_UNAVAILABLE");
+            }
+            registryEntry = Object.freeze({ topic_id: accountMemo.topic_id,
+                sequence_number: sequence, consensus_timestamp: registry.consensus_timestamp });
+            profileRef = `hcs://1/${registry.verification.register.t_id}`;
+        }
+        else {
+            if (request.hcs2_sequence_number !== undefined) {
+                return output("invalid", "HCS11_HCS2_SEQUENCE_NOT_APPLICABLE");
+            }
+            profileRef = accountMemo.profile_reference;
+        }
+        if (request.expected_hcs1_reference != null && profileRef !== request.expected_hcs1_reference) {
+            return output("conflict", "HCS11_PROFILE_REFERENCE_MISMATCH");
+        }
+        const hcs1 = await resolveHcs1FileV1(config, {
+            network: request.hedera_network, reference: profileRef,
+            expected_sha256: request.expected_hcs1_sha256 ?? null,
+        }, decodeOptions);
+        if (hcs1.status !== "resolved" || !hcs1.verification?.bytes || !hcs1.verification.sha256) {
+            return output(hcs1.status === "invalid" && hcs1.reason_code === "HCS1_EXPECTED_CHECKSUM_MISMATCH"
+                ? "conflict" : hcs1.status, hcs1.reason_code ?? "HCS11_PROFILE_CONTENT_UNAVAILABLE");
+        }
+        contentSha = hcs1.verification.sha256;
+        const offline = verifyHcs11AiAgentProfileV1({
+            profile: hcs1.verification.bytes,
+            account_memo: accountMemo.memo,
+            ...(request.expected_profile_sha256 == null ? {} : { expected_sha256: request.expected_profile_sha256 }),
+            ...(request.expected_uaid == null ? {} : { expected_uaid: request.expected_uaid }),
+            ...(request.expected_base_did == null ? {} : { expected_base_did: request.expected_base_did }),
+            ...(request.expected_profile_reference == null ? {} : {
+                expected_profile_reference: request.expected_profile_reference,
+            }),
+        });
+        profile = offline.profile;
+        canonicalSha = offline.sha256;
+        if (offline.status !== "pass") {
+            return output(offline.status === "unsupported" ? "unsupported" :
+                offline.reason_code === "HCS11_CHECKSUM_MISMATCH" || offline.reason_code === "HCS11_UAID_MISMATCH" ||
+                    offline.reason_code === "HCS11_PROFILE_REFERENCE_MISMATCH" || offline.reason_code?.startsWith("HCS14_")
+                    ? "conflict" : "invalid", offline.reason_code);
+        }
+        const nativeId = parseHcs14DidUaidV1(profile.uaid).params.nativeId;
+        const nativeNetwork = typeof nativeId === "string" ? /^hedera:(mainnet|testnet):0\.0\.[0-9]+$/.exec(nativeId) : null;
+        if (nativeNetwork && nativeNetwork[1] !== request.hedera_network) {
+            return output("conflict", "HCS11_UAID_NETWORK_MISMATCH");
+        }
+        if (canonicalSha !== contentSha) {
+            // The pinned HCS-11 profile publisher emits canonical JSON into HCS-1.
+            // A structurally valid but noncanonical third-party profile is not this profile.
+            return output("unsupported", "HCS11_PROFILE_CONTENT_NOT_CANONICAL");
+        }
+        if (request.expected_base_did != null)
+            didBinding = "match";
+        return output("resolved", null);
+    }
+    catch (error) {
+        if (error instanceof AccountReadError) {
+            return output(error.invalid ? "invalid" : "unavailable", error.code);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=hcs11MirrorV1.js.map

package/dist/resolvers/hcs11MirrorV1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcs11MirrorV1.js","sourceRoot":"","sources":["../../src/resolvers/hcs11MirrorV1.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAA2B,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EACpB,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAA6B,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,IAAI,GAA4C,MAAM,CAAC,MAAM,CAAC;IAClE,OAAO,EAAE,qDAAqD;IAC9D,OAAO,EAAE,8CAA8C;CACxD,CAAC,CAAC;AACH,MAAM,OAAO,GAAG,gBAAgB,CAAC;AACjC,MAAM,MAAM,GAAG,gBAAgB,CAAC;AAChC,MAAM,GAAG,GAAG,kEAAkE,CAAC;AAC/E,MAAM,kBAAkB,GAAG,GAAG,GAAG,IAAI,CAAC;AAyCtC,MAAM,gBAAiB,SAAQ,KAAK;IACb;IAAuB;IAA5C,YAAqB,IAAY,EAAW,UAAU,KAAK;QAAI,KAAK,CAAC,IAAI,CAAC,CAAC;QAAtD,SAAI,GAAJ,IAAI,CAAQ;QAAW,YAAO,GAAP,OAAO,CAAQ;IAAiB,CAAC;CAC9E;AACD,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,gBAAgB,CAAC,gCAAgC,EAAE,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AACD,SAAS,aAAa,CAAC,MAA4B,EAAE,OAAsB;IACzE,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAAC,CAAC;IACpE,MAAM,CAAC;QAAC,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5E,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;QACtE,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAChG,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AACD,SAAS,eAAe,CAAC,MAA4B;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,kBAAkB,IAAI,kBAAkB,CAAC;IAC5D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,GAAG,IAAI,OAAO,GAAG,KAAK;QAClE,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,IAAI,IAAI,GAAG,GAAG,kBAAkB,EAAE,CAAC;QACzE,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAC1B,CAAC;AACD,KAAK,UAAU,WAAW,CAAC,MAA4B,EAAE,GAAQ,EAC/D,MAAwC;IACxC,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YAC5D,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YACtD,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;YACzD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,IAAI,gBAAgB,CAAC,2BAA2B,CAAC,CAAC;IAAC,CAAC;IACpE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,gBAAgB,CAAC,4BAA4B,CAAC,CAAC;IACtF,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,gBAAgB,CAAC,2BAA2B,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACtD,IAAI,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,gBAAgB,CAAC,kCAAkC,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI;QAAE,MAAM,IAAI,gBAAgB,CAAC,gCAAgC,EAAE,IAAI,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM;YACrB,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;YAC/B,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;gBACvB,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC7C,MAAM,IAAI,gBAAgB,CAAC,kCAAkC,CAAC,CAAC;YACjE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAgB;YAAE,MAAM,KAAK,CAAC;QACnD,MAAM,IAAI,gBAAgB,CAAC,2BAA2B,CAAC,CAAC;IAC1D,CAAC;YAAS,CAAC;QAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAAC,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC;IAAC,CAAC;IACxE,IAAI,CAAC;QAAC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAAC,CAAC;IAC9F,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,YAAY,gBAAgB;YAAE,MAAM,KAAK,CAAC;QACnD,MAAM,IAAI,gBAAgB,CAAC,gCAAgC,EAAE,IAAI,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AACD,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QACrD,MAAM,IAAI,gBAAgB,CAAC,4BAA4B,EAAE,IAAI,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,gBAAgB,CAAC,4BAA4B,EAAE,IAAI,CAAC,CAAC;IACrF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3C,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QAAC,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IAC1E,MAAM,CAAC;QAAC,MAAM,IAAI,gBAAgB,CAAC,4BAA4B,EAAE,IAAI,CAAC,CAAC;IAAC,CAAC;IACzE,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,KAAK,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;QACnF,MAAM,IAAI,gBAAgB,CAAC,4BAA4B,EAAE,IAAI,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,SAAS,mBAAmB,CAAC,GAA4B;IACvD,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC;IAChC,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,IAAI,OAAO,IAAI,IAAI;QAAE,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,gBAAgB,CAAC,4BAA4B,EAAE,IAAI,CAAC,CAAC;QACjG,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/E,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK;YAAE,MAAM,IAAI,gBAAgB,CAAC,6BAA6B,EAAE,IAAI,CAAC,CAAC;QACrG,IAAI,GAAG,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,gBAAgB,CAAC,gCAAgC,CAAC,CAAC;IACxE,IAAI,CAAC;QAAC,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAC7C,MAAM,CAAC;QAAC,MAAM,IAAI,gBAAgB,CAAC,4BAA4B,EAAE,IAAI,CAAC,CAAC;IAAC,CAAC;AAC3E,CAAC;AACD,SAAS,cAAc,CAAC,OAA6B;IACnD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC;QAC1F,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG;QACzE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAC5F,IAAI,OAAO,CAAC,oBAAoB,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,oBAAoB,CAAC;QAClG,OAAO,CAAC,oBAAoB,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAC;IAC1F,IAAI,OAAO,CAAC,0BAA0B,IAAI,IAAI,EAAE,CAAC;QAC/C,uBAAuB,CAAC,UAAU,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,OAAO,CAAC,uBAAuB,IAAI,IAAI;QAAE,oBAAoB,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACnG,KAAK,MAAM,KAAK,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC;QACpF,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,aAAa,IAAI,IAAI;QAAE,mBAAmB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9E,IAAI,OAAO,CAAC,iBAAiB,IAAI,IAAI,IAAI,CAAC,OAAO,OAAO,CAAC,iBAAiB,KAAK,QAAQ;QACnF,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAA0B,EAC1B,OAA6B,EAC7B,gBAAsC,EAAE;IAExC,cAAc,CAAC,OAAO,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IACrC,IAAI,WAAW,GAAuB,IAAI,CAAC;IAC3C,IAAI,aAAa,GAA0C,IAAI,CAAC;IAChE,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,OAAO,GAA0B,IAAI,CAAC;IAC1C,IAAI,UAAU,GAAuC,aAAa,CAAC;IACnE,MAAM,MAAM,GAAG,CAAC,MAAqC,EAAE,MAAqB,EAAuB,EAAE,CACnG,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc;QACjF,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,6BAAsC;QAC1E,2BAA2B,EAAE,qBAA8B;QAC3D,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa;QACxD,iBAAiB,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU;QACzD,wBAAwB,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IAChF,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;QAC1F,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG;YAAE,OAAO,MAAM,CAAC,aAAa,EAAE,yBAAyB,CAAC,CAAC;QAClE,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,SAAS,EAAE,8BAA8B,CAAC,CAAC;QACxF,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAAC;QAChF,WAAW,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,OAAO,CAAC,0BAA0B,IAAI,IAAI;YAC1C,WAAW,CAAC,iBAAiB,KAAK,OAAO,CAAC,0BAA0B,EAAE,CAAC;YACzE,OAAO,MAAM,CAAC,UAAU,EAAE,kCAAkC,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,WAAW,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAC9C,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,MAAM,CAAC,aAAa,EAAE,8BAA8B,CAAC,CAAC;YACzF,MAAM,aAAa,GAAG,OAAO,CAAC,uBAAuB,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACpE,oBAAoB,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAAC;YACjE,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE;gBACnD,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,iBAAiB,EAAE,WAAW,CAAC,QAAQ;gBACvC,eAAe,EAAE,QAAQ;gBACzB,aAAa,EAAE,aAAa;aAC7B,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ;gBAClE,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;gBAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;oBACzD,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EACzD,QAAQ,CAAC,WAAW,IAAI,8BAA8B,CAAC,CAAC;YAC5D,CAAC;YACD,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC5D,eAAe,EAAE,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB,EAAE,CAAC,CAAC;YAClF,UAAU,GAAG,WAAW,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,IAAI,OAAO,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;gBAC/C,OAAO,MAAM,CAAC,SAAS,EAAE,oCAAoC,CAAC,CAAC;YACjE,CAAC;YACD,UAAU,GAAG,WAAW,CAAC,iBAAiB,CAAC;QAC7C,CAAC;QACD,IAAI,OAAO,CAAC,uBAAuB,IAAI,IAAI,IAAI,UAAU,KAAK,OAAO,CAAC,uBAAuB,EAAE,CAAC;YAC9F,OAAO,MAAM,CAAC,UAAU,EAAE,kCAAkC,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE;YAC3C,OAAO,EAAE,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,UAAU;YACtD,eAAe,EAAE,OAAO,CAAC,oBAAoB,IAAI,IAAI;SACtD,EAAE,aAAa,CAAC,CAAC;QAClB,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;YACzF,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,iCAAiC;gBAC/F,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,IAAI,mCAAmC,CAAC,CAAC;QACzF,CAAC;QACD,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QACtC,MAAM,OAAO,GAAG,2BAA2B,CAAC;YAC1C,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK;YAChC,YAAY,EAAE,WAAW,CAAC,IAAI;YAC9B,GAAG,CAAC,OAAO,CAAC,uBAAuB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,uBAAuB,EAAE,CAAC;YACxG,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;YAClF,GAAG,CAAC,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC9F,GAAG,CAAC,OAAO,CAAC,0BAA0B,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACpD,0BAA0B,EAAE,OAAO,CAAC,0BAA0B;aAC/D,CAAC;SACH,CAAC,CAAC;QACH,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC1B,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;gBAC9D,OAAO,CAAC,WAAW,KAAK,yBAAyB,IAAI,OAAO,CAAC,WAAW,KAAK,qBAAqB;oBAClG,OAAO,CAAC,WAAW,KAAK,kCAAkC,IAAI,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,QAAQ,CAAC;oBACrG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACpE,MAAM,aAAa,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,yCAAyC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrH,IAAI,aAAa,IAAI,aAAa,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC;YACjE,OAAO,MAAM,CAAC,UAAU,EAAE,6BAA6B,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;YAChC,uEAAuE;YACvE,iFAAiF;YACjF,OAAO,MAAM,CAAC,aAAa,EAAE,qCAAqC,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,OAAO,CAAC,iBAAiB,IAAI,IAAI;YAAE,UAAU,GAAG,OAAO,CAAC;QAC5D,OAAO,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;YACtC,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/resolvers/hcs13MirrorV1.d.ts

@@ -0,0 +1,35 @@
+/** Exact historical HCS-13 registration -> HCS-1 schema integrity observation.
+ * No current registry state, JSON Schema instance-validation or consensus proof.
+ */
+import type { HederaNetwork } from "../contracts/verification.js";
+import { type Hcs1MirrorV1Config } from "./hcs1MirrorV1.js";
+import { type Hcs1V1ContentOptions } from "../standards/hcs/hcs1V1.js";
+import { type Hcs13ReferenceV1, type Hcs13SchemaV1 } from "../standards/hcs/hcs13V1.js";
+export type Hcs13MirrorV1Request = Readonly<{
+    hedera_network: HederaNetwork;
+    reference: string;
+    /** Optional independent relying-party commitments. */
+    expected_hcs1_reference?: string | null;
+    expected_schema_sha256?: string | null;
+}>;
+export type Hcs13MirrorV1Result = Readonly<{
+    status: "resolved" | "conflict" | "invalid" | "unavailable" | "unsupported";
+    reason_code: string | null;
+    hedera_network: HederaNetwork;
+    resolver_id: "hedera.mirror-rest.hcs13.v1";
+    reference: Hcs13ReferenceV1;
+    registry_consensus_timestamp_exact: string | null;
+    registry_memo_temporal_scope: "current_observation";
+    /** Exact HCS-1 reference selected by the historical HCS-2 register. */
+    schema_hcs1_reference: string | null;
+    /** Hash of bytes fetched from HCS-1 relative to the observed topic memo. */
+    content_sha256: string | null;
+    /** SHA-256 of the deterministic canonicalized schema document. */
+    schema_sha256: string | null;
+    schema: Hcs13SchemaV1["schema"] | null;
+    /** Registry observations are not consensus authentication. */
+    assurance: "mirror_corroborated";
+}>;
+/** Caller selects the historical reference explicitly. No 'latest' selection. */
+export declare function resolveHcs13SchemaV1(config: Hcs1MirrorV1Config, request: Hcs13MirrorV1Request, decodeOptions?: Hcs1V1ContentOptions): Promise<Hcs13MirrorV1Result>;
+//# sourceMappingURL=hcs13MirrorV1.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hcs13MirrorV1.d.ts","sourceRoot":"","sources":["../../src/resolvers/hcs13MirrorV1.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EACL,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAgB,MAAM,6BAA6B,CAAC;AAG/F,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,cAAc,EAAE,aAAa,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC,CAAC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,CAAC;IAC5E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,aAAa,CAAC;IAC9B,WAAW,EAAE,6BAA6B,CAAC;IAC3C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,kCAAkC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,4BAA4B,EAAE,qBAAqB,CAAC;IACpD,uEAAuE;IACvE,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kEAAkE;IAClE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACvC,8DAA8D;IAC9D,SAAS,EAAE,qBAAqB,CAAC;CAClC,CAAC,CAAC;AAEH,iFAAiF;AACjF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,oBAAoB,EAC7B,aAAa,GAAE,oBAAyB,GACvC,OAAO,CAAC,mBAAmB,CAAC,CAiE9B"}

package/dist/resolvers/hcs13MirrorV1.js

@@ -0,0 +1,72 @@
+import { resolveHcs2RegisterV1 } from "./hcs2MirrorV1.js";
+import { resolveHcs1FileV1 } from "./hcs1MirrorV1.js";
+import { parseHcs1ReferenceV1 } from "../standards/hcs/hcs1V1.js";
+import { parseHcs13ReferenceV1, parseHcs13SchemaV1, verifyHcs13SchemaV1, Hcs13V1Error } from "../standards/hcs/hcs13V1.js";
+const SHA256 = /^[0-9a-f]{64}$/;
+/** Caller selects the historical reference explicitly. No 'latest' selection. */
+export async function resolveHcs13SchemaV1(config, request, decodeOptions = {}) {
+    if (!request || (request.hedera_network !== "mainnet" && request.hedera_network !== "testnet")) {
+        throw new TypeError("HCS13_NETWORK_INVALID");
+    }
+    const reference = parseHcs13ReferenceV1(request.reference);
+    if (request.expected_hcs1_reference != null)
+        parseHcs1ReferenceV1(request.expected_hcs1_reference);
+    if (request.expected_schema_sha256 != null && !SHA256.test(request.expected_schema_sha256)) {
+        throw new TypeError("HCS13_EXPECTED_CHECKSUM_INVALID");
+    }
+    let registryTime = null;
+    let contentRef = null;
+    let contentHash = null;
+    let schemaHash = null;
+    let schema = null;
+    const output = (status, reason_code) => Object.freeze({ status, reason_code, hedera_network: request.hedera_network,
+        resolver_id: "hedera.mirror-rest.hcs13.v1", reference,
+        registry_consensus_timestamp_exact: registryTime,
+        registry_memo_temporal_scope: "current_observation",
+        schema_hcs1_reference: contentRef,
+        content_sha256: contentHash, schema_sha256: schemaHash, schema,
+        assurance: "mirror_corroborated" });
+    const expectedTopic = request.expected_hcs1_reference == null ? null :
+        parseHcs1ReferenceV1(request.expected_hcs1_reference).topic_id;
+    const registry = await resolveHcs2RegisterV1(config, {
+        hedera_network: request.hedera_network, registry_topic_id: reference.registry_topic_id,
+        sequence_number: reference.sequence_number, expected_t_id: expectedTopic,
+    });
+    if (registry.status !== "resolved" || !registry.verification?.register || !registry.consensus_timestamp) {
+        return output(registry.status === "conflict" ? "conflict" : registry.status, registry.reason_code ?? "HCS13_REGISTRY_ENTRY_UNAVAILABLE");
+    }
+    registryTime = registry.consensus_timestamp;
+    contentRef = `hcs://1/${registry.verification.register.t_id}`;
+    const content = await resolveHcs1FileV1(config, {
+        network: request.hedera_network, reference: contentRef,
+        expected_sha256: request.expected_schema_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 ?? "HCS13_SCHEMA_CONTENT_UNAVAILABLE");
+    }
+    contentHash = content.verification.sha256;
+    const verification = verifyHcs13SchemaV1({ reference: reference.ref,
+        schema: content.verification.bytes, expected_sha256: request.expected_schema_sha256 ?? null });
+    if (verification.status !== "pass") {
+        return output(verification.reason_code === "HCS13_CHECKSUM_MISMATCH" ? "conflict" : "invalid", verification.reason_code);
+    }
+    try {
+        const parsed = parseHcs13SchemaV1(content.verification.bytes);
+        schemaHash = parsed.sha256;
+        // The pinned HCS-13 publisher stores its canonical document in HCS-1.
+        // A merely equivalent noncanonical JSON document is not a verified pinned publication.
+        if (parsed.canonical_payload !== Buffer.from(content.verification.bytes).toString("utf8")) {
+            return output("unsupported", "HCS13_SCHEMA_CONTENT_NOT_CANONICAL");
+        }
+        if (schemaHash !== contentHash)
+            return output("conflict", "HCS13_CANONICAL_CONTENT_MISMATCH");
+        schema = parsed.schema;
+        return output("resolved", null);
+    }
+    catch (error) {
+        if (error instanceof Hcs13V1Error)
+            return output("invalid", error.code);
+        throw error;
+    }
+}
+//# sourceMappingURL=hcs13MirrorV1.js.map

package/dist/resolvers/hcs13MirrorV1.js.map

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

package/dist/resolvers/hcs1MirrorV1.d.ts

@@ -0,0 +1,28 @@
+/** Independent Mirror REST HCS-1 observation, never consensus-signature authentication. */
+import type { HederaNetwork } from "../contracts/verification.js";
+import type { HederaMirrorV1Config } from "./hederaMirrorV1.js";
+import { type Hcs1V1ContentOptions, type Hcs1V1ContentResult } from "../standards/hcs/hcs1V1.js";
+export type Hcs1MirrorV1Config = HederaMirrorV1Config & Readonly<{
+    total_timeout_ms?: number;
+}>;
+export type Hcs1MirrorV1Request = Readonly<{
+    reference: string;
+    network: HederaNetwork;
+    /** Caller expectation, not a claim taken from the fetched document. */
+    expected_sha256?: string | null;
+}>;
+export type Hcs1MirrorV1Result = Readonly<{
+    status: "resolved" | "invalid" | "unavailable" | "unsupported";
+    reason_code: string | null;
+    reference: string;
+    hedera_network: HederaNetwork;
+    resolver_id: "hedera.mirror-rest.hcs1.v1";
+    /** When resolved: recomputed file integrity relative to the observed HCS topic memo. */
+    verification: Hcs1V1ContentResult | null;
+}>;
+/**
+ * Mirror response is independently observed relative to VA services, but is
+ * not Hedera consensus-signature authentication. No arbitrary evidence URLs.
+ */
+export declare function resolveHcs1FileV1(config: Hcs1MirrorV1Config, request: Hcs1MirrorV1Request, decodeOptions?: Hcs1V1ContentOptions): Promise<Hcs1MirrorV1Result>;
+//# sourceMappingURL=hcs1MirrorV1.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hcs1MirrorV1.d.ts","sourceRoot":"","sources":["../../src/resolvers/hcs1MirrorV1.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAEL,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EACpD,MAAM,4BAA4B,CAAC;AAapC,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,GAAG,QAAQ,CAAC;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,CAAC;IAC/D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,aAAa,CAAC;IAC9B,WAAW,EAAE,4BAA4B,CAAC;IAC1C,wFAAwF;IACxF,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC1C,CAAC,CAAC;AA2HH;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,mBAAmB,EAC5B,aAAa,GAAE,oBAAyB,GACvC,OAAO,CAAC,kBAAkB,CAAC,CA2D7B"}