@veraanchor/verifier 0.0.0-stage → 0.1.0

package/dist/resolvers/hcs26RegistryMirrorV1.js

@@ -0,0 +1,200 @@
+import { parseHcs26MemoV1, Hcs26V1Error } from "../standards/hcs/hcs26V1.js";
+const DEFAULT_BASE = Object.freeze({
+    mainnet: "https://mainnet-public.mirrornode.hedera.com/api/v1",
+    testnet: "https://testnet.mirrornode.hedera.com/api/v1",
+});
+const TOPIC = /^0\.0\.[0-9]+$/;
+const B64 = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+const TS = /^[0-9]{1,20}\.[0-9]{1,9}$/;
+const MAX_RESPONSE = 256 * 1024;
+class ReadError extends Error {
+    code;
+    invalid;
+    constructor(code, invalid = false) {
+        super(code);
+        this.code = code;
+        this.invalid = invalid;
+    }
+}
+function object(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new ReadError("HCS26_MIRROR_RESPONSE_INVALID", true);
+    }
+    return value;
+}
+function baseUrl(config, network) {
+    let url;
+    try {
+        url = new URL(config.base_urls?.[network] ?? DEFAULT_BASE[network]);
+    }
+    catch {
+        throw new TypeError("HCS26_MIRROR_BASE_URL_INVALID");
+    }
+    const loopback = ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
+    if ((url.protocol !== "https:" && !(url.protocol === "http:" && loopback)) ||
+        url.username || url.password || url.search || url.hash || !url.pathname.endsWith("/api/v1")) {
+        throw new TypeError("HCS26_MIRROR_BASE_URL_INVALID");
+    }
+    return url;
+}
+function limits(config) {
+    const timeout = config.timeout_ms ?? 8000;
+    const bytes = config.max_response_bytes ?? MAX_RESPONSE;
+    if (!Number.isSafeInteger(timeout) || timeout < 250 || timeout > 15000 ||
+        !Number.isSafeInteger(bytes) || bytes < 1024 || bytes > MAX_RESPONSE) {
+        throw new TypeError("HCS26_MIRROR_BOUNDS_INVALID");
+    }
+    return { timeout, bytes };
+}
+function singleMessageChunk(value) {
+    if (value == null)
+        return true;
+    if (typeof value !== "object" || Array.isArray(value))
+        return false;
+    const chunk = value;
+    return chunk.number === 1 && chunk.total === 1;
+}
+async function readJson(config, url, limit) {
+    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(limit.timeout),
+        });
+    }
+    catch {
+        throw new ReadError("HCS26_MIRROR_UNAVAILABLE");
+    }
+    if (response.status === 404)
+        return null;
+    if (response.status === 429)
+        throw new ReadError("HCS26_MIRROR_RATE_LIMITED");
+    if (!response.ok)
+        throw new ReadError("HCS26_MIRROR_UNAVAILABLE");
+    const length = response.headers.get("content-length");
+    if (length && (!Number.isSafeInteger(Number(length)) || Number(length) > limit.bytes)) {
+        throw new ReadError("HCS26_MIRROR_RESPONSE_TOO_LARGE");
+    }
+    if (!response.body)
+        throw new ReadError("HCS26_MIRROR_RESPONSE_INVALID", true);
+    const reader = response.body.getReader();
+    const chunks = [];
+    let count = 0;
+    try {
+        while (true) {
+            const part = await reader.read();
+            if (part.done)
+                break;
+            count += part.value.byteLength;
+            if (count > limit.bytes) {
+                await reader.cancel().catch(() => undefined);
+                throw new ReadError("HCS26_MIRROR_RESPONSE_TOO_LARGE");
+            }
+            chunks.push(part.value);
+        }
+    }
+    catch (error) {
+        if (error instanceof ReadError)
+            throw error;
+        throw new ReadError("HCS26_MIRROR_UNAVAILABLE");
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const bytes = new Uint8Array(count);
+    let position = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, position);
+        position += chunk.byteLength;
+    }
+    try {
+        return object(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes)));
+    }
+    catch (error) {
+        if (error instanceof ReadError)
+            throw error;
+        throw new ReadError("HCS26_MIRROR_RESPONSE_INVALID", true);
+    }
+}
+function normalizedMemo(value) {
+    if (typeof value !== "string" || value.length > 256)
+        throw new ReadError("HCS26_TOPIC_MEMO_INVALID", true);
+    let text = value;
+    if (!value.startsWith("hcs-26:")) {
+        if (!B64.test(value))
+            throw new ReadError("HCS26_TOPIC_MEMO_INVALID", true);
+        const decoded = Buffer.from(value, "base64");
+        if (decoded.toString("base64") !== value)
+            throw new ReadError("HCS26_TOPIC_MEMO_INVALID", true);
+        try {
+            text = new TextDecoder("utf-8", { fatal: true }).decode(decoded);
+        }
+        catch {
+            throw new ReadError("HCS26_TOPIC_MEMO_INVALID", true);
+        }
+    }
+    try {
+        return parseHcs26MemoV1(text);
+    }
+    catch (error) {
+        if (error instanceof Hcs26V1Error)
+            throw new ReadError(error.code, true);
+        throw error;
+    }
+}
+function decodeMessage(value) {
+    if (typeof value !== "string" || !value || !B64.test(value)) {
+        throw new ReadError("HCS26_MIRROR_MESSAGE_INVALID", true);
+    }
+    const bytes = Buffer.from(value, "base64");
+    if (!bytes.length || bytes.length > 1024 || bytes.toString("base64") !== value) {
+        throw new ReadError("HCS26_MIRROR_MESSAGE_INVALID", true);
+    }
+    return new Uint8Array(bytes);
+}
+function output(status, reason, evidence = null) {
+    return Object.freeze({ status, reason_code: reason, evidence });
+}
+export async function readHcs26RegistryMessageV1(config, request) {
+    if (!request || (request.hedera_network !== "testnet" && request.hedera_network !== "mainnet") ||
+        !TOPIC.test(request.topic_id) || !Number.isSafeInteger(request.sequence_number) ||
+        request.sequence_number < 1 || (request.registry_type !== "discovery" && request.registry_type !== "version")) {
+        throw new TypeError("HCS26_REGISTRY_LOCATOR_INVALID");
+    }
+    const base = baseUrl(config, request.hedera_network);
+    const bound = limits(config);
+    const prefix = base.toString().replace(/\/$/, "");
+    const path = `topics/${request.topic_id}`;
+    try {
+        const topic = await readJson(config, new URL(`${prefix}/${path}`), bound);
+        if (!topic)
+            return output("unavailable", "HCS26_REGISTRY_NOT_FOUND");
+        if (topic.topic_id !== request.topic_id)
+            throw new ReadError("HCS26_REGISTRY_SCOPE_MISMATCH", true);
+        const memo = normalizedMemo(topic.memo);
+        if (memo.type !== request.registry_type)
+            return output("invalid", "HCS26_REGISTRY_TYPE_MISMATCH");
+        const row = await readJson(config, new URL(`${prefix}/${path}/messages/${request.sequence_number}`), bound);
+        if (!row)
+            return output("unavailable", "HCS26_REGISTRY_ENTRY_NOT_FOUND");
+        if (row.topic_id !== request.topic_id ||
+            row.sequence_number !== request.sequence_number ||
+            !singleMessageChunk(row.chunk_info)) {
+            throw new ReadError("HCS26_REGISTRY_MESSAGE_SCOPE_MISMATCH", true);
+        }
+        if (typeof row.consensus_timestamp !== "string" || !TS.test(row.consensus_timestamp)) {
+            throw new ReadError("HCS26_REGISTRY_TIMESTAMP_INVALID", true);
+        }
+        const message = decodeMessage(row.message);
+        return output("resolved", null, Object.freeze({ topic_id: request.topic_id,
+            sequence_number: request.sequence_number, consensus_timestamp: row.consensus_timestamp,
+            memo, message }));
+    }
+    catch (error) {
+        if (error instanceof ReadError)
+            return output(error.invalid ? "invalid" : "unavailable", error.code);
+        throw error;
+    }
+}
+//# sourceMappingURL=hcs26RegistryMirrorV1.js.map

package/dist/resolvers/hcs26RegistryMirrorV1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcs26RegistryMirrorV1.js","sourceRoot":"","sources":["../../src/resolvers/hcs26RegistryMirrorV1.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAoB,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE/F,MAAM,YAAY,GAA4C,MAAM,CAAC,MAAM,CAAC;IAC1E,OAAO,EAAE,qDAAqD;IAC9D,OAAO,EAAE,8CAA8C;CACxD,CAAC,CAAC;AACH,MAAM,KAAK,GAAG,gBAAgB,CAAC;AAC/B,MAAM,GAAG,GAAG,kEAAkE,CAAC;AAC/E,MAAM,EAAE,GAAG,2BAA2B,CAAC;AACvC,MAAM,YAAY,GAAG,GAAG,GAAG,IAAI,CAAC;AAehC,MAAM,SAAU,SAAQ,KAAK;IACN;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,SAAS,CAAC,+BAA+B,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAa,CAAC;AACvB,CAAC;AACD,SAAS,OAAO,CAAC,MAA4B,EAAE,OAAsB;IACnE,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAAC,CAAC;IAC5E,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,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,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,MAAM,CAAC,MAA4B;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,kBAAkB,IAAI,YAAY,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,GAAG,IAAI,OAAO,GAAG,KAAK;QAClE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,YAAY,EAAE,CAAC;QACzE,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AACD,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpE,MAAM,KAAK,GAAG,KAAgC,CAAC;IAC/C,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC;AACjD,CAAC;AACD,KAAK,UAAU,QAAQ,CAAC,MAA4B,EAAE,GAAQ,EAC5D,KAAyC;IACzC,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,KAAK,CAAC,OAAO,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAAC,CAAC;IAC5D,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,SAAS,CAAC,2BAA2B,CAAC,CAAC;IAC9E,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACtD,IAAI,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACtF,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,EAAE,IAAI,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,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,KAAK,CAAC,KAAK,EAAE,CAAC;gBACxB,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC7C,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;YACzD,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,SAAS;YAAE,MAAM,KAAK,CAAC;QAC5C,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAClD,CAAC;YAAS,CAAC;QAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAAC,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC;IAAC,CAAC;IACzF,IAAI,CAAC;QAAC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,CAAC;IAC3F,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,YAAY,SAAS;YAAE,MAAM,KAAK,CAAC;QAC5C,MAAM,IAAI,SAAS,CAAC,+BAA+B,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AACD,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,SAAS,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;IAC3G,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,KAAK;YAAE,MAAM,IAAI,SAAS,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;QAChG,IAAI,CAAC;YAAC,IAAI,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QACzE,MAAM,CAAC;YAAC,MAAM,IAAI,SAAS,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;QAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC;QAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IACtC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,YAAY,YAAY;YAAE,MAAM,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AACD,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,SAAS,CAAC,8BAA8B,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;QAC/E,MAAM,IAAI,SAAS,CAAC,8BAA8B,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AACD,SAAS,MAAM,CAAC,MAAqC,EAAE,MAAqB,EAC1E,WAA0C,IAAI;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AAClE,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAA4B,EAC5B,OACoE;IAEpE,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC;QAC1F,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,eAAe,CAAC;QAC/E,OAAO,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,KAAK,WAAW,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,EAAE,CAAC;QAClH,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,UAAU,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAC1E,IAAI,CAAC,KAAK;YAAE,OAAO,MAAM,CAAC,aAAa,EAAE,0BAA0B,CAAC,CAAC;QACrE,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ;YAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,EAAE,IAAI,CAAC,CAAC;QACpG,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,aAAa;YAAE,OAAO,MAAM,CAAC,SAAS,EAAE,8BAA8B,CAAC,CAAC;QAClG,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,GAAG,MAAM,IAAI,IAAI,aAAa,OAAO,CAAC,eAAe,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5G,IAAI,CAAC,GAAG;YAAE,OAAO,MAAM,CAAC,aAAa,EAAE,gCAAgC,CAAC,CAAC;QACzE,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ;YACjC,GAAG,CAAC,eAAe,KAAK,OAAO,CAAC,eAAe;YAChD,CAAC,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,SAAS,CAAC,uCAAuC,EAAE,IAAI,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,OAAO,GAAG,CAAC,mBAAmB,KAAK,QAAQ,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACrF,MAAM,IAAI,SAAS,CAAC,kCAAkC,EAAE,IAAI,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ;YACxE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,mBAAmB,EAAE,GAAG,CAAC,mBAAmB;YACtF,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,SAAS;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACrG,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/resolvers/hcs2MirrorV1.d.ts

@@ -0,0 +1,26 @@
+/** Read-only HCS-2 historical register observation through a configured Hedera Mirror REST API. */
+import type { HederaNetwork } from "../contracts/verification.js";
+import type { HederaMirrorV1Config } from "./hederaMirrorV1.js";
+import { type Hcs2V1VerificationResult } from "../standards/hcs/hcs2V1.js";
+export type Hcs2MirrorV1Request = Readonly<{
+    hedera_network: HederaNetwork;
+    registry_topic_id: string;
+    /** Explicit historical sequence; not a request to reconstruct mutable current state. */
+    sequence_number: number;
+    /** Caller-supplied expected target; unrelated to any value read from the register. */
+    expected_t_id?: string | null;
+}>;
+export type Hcs2MirrorV1Result = Readonly<{
+    status: "resolved" | "conflict" | "invalid" | "unavailable";
+    reason_code: string | null;
+    hedera_network: HederaNetwork;
+    registry_topic_id: string;
+    sequence_number: number;
+    /** Exact timestamp observed from Mirror (not authenticated ledger consensus). */
+    consensus_timestamp: string | null;
+    resolver_id: "hedera.mirror-rest.hcs2.v1";
+    verification: Hcs2V1VerificationResult | null;
+}>;
+/** Verifies an exact historical HCS-2 register; does NOT determine the current registry state. */
+export declare function resolveHcs2RegisterV1(config: HederaMirrorV1Config, request: Hcs2MirrorV1Request): Promise<Hcs2MirrorV1Result>;
+//# sourceMappingURL=hcs2MirrorV1.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hcs2MirrorV1.d.ts","sourceRoot":"","sources":["../../src/resolvers/hcs2MirrorV1.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAwB,KAAK,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAcjG,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,cAAc,EAAE,aAAa,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wFAAwF;IACxF,eAAe,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;IAC5D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,aAAa,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,4BAA4B,CAAC;IAC1C,YAAY,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC/C,CAAC,CAAC;AAmHH,kGAAkG;AAClG,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA2C7B"}

package/dist/resolvers/hcs2MirrorV1.js

@@ -0,0 +1,196 @@
+import { verifyHcs2RegisterV1 } from "../standards/hcs/hcs2V1.js";
+const DEFAULT_MIRROR = Object.freeze({
+    mainnet: "https://mainnet-public.mirrornode.hedera.com/api/v1",
+    testnet: "https://testnet.mirrornode.hedera.com/api/v1",
+});
+const TOPIC = /^0\.0\.[0-9]+$/;
+const BASE64 = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+const MEMO = /^hcs-2:[01]:[0-9]+$/;
+const TIMESTAMP = /^[0-9]{1,20}\.[0-9]{1,9}$/;
+const MAX_RESPONSE_BYTES = 256 * 1024;
+class ReadFailure 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 ReadFailure("HCS2_MIRROR_RESPONSE_INVALID", true);
+    }
+    return value;
+}
+function baseUrl(config, network) {
+    const raw = config.base_urls?.[network] ?? DEFAULT_MIRROR[network];
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        throw new TypeError("HCS2_MIRROR_BASE_URL_INVALID");
+    }
+    const loopback = ["localhost", "127.0.0.1", "[::1]"].includes(parsed.hostname);
+    if ((parsed.protocol !== "https:" && !(loopback && parsed.protocol === "http:")) ||
+        parsed.username || parsed.password || parsed.search || parsed.hash ||
+        !parsed.pathname.endsWith("/api/v1")) {
+        throw new TypeError("HCS2_MIRROR_BASE_URL_INVALID");
+    }
+    return parsed;
+}
+function requestBounds(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("HCS2_MIRROR_BOUNDS_INVALID");
+    }
+    return { timeout, max };
+}
+function singleMessageChunk(value) {
+    if (value == null)
+        return true;
+    if (typeof value !== "object" || Array.isArray(value))
+        return false;
+    const chunk = value;
+    return chunk.number === 1 && chunk.total === 1;
+}
+async function readJson(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 ReadFailure("HCS2_MIRROR_UNAVAILABLE");
+    }
+    if (response.status === 404)
+        return null;
+    if (response.status === 429)
+        throw new ReadFailure("HCS2_MIRROR_RATE_LIMITED");
+    if (!response.ok)
+        throw new ReadFailure("HCS2_MIRROR_UNAVAILABLE");
+    const advertised = response.headers.get("content-length");
+    if (advertised && (!Number.isFinite(Number(advertised)) || Number(advertised) > bounds.max)) {
+        throw new ReadFailure("HCS2_MIRROR_RESPONSE_TOO_LARGE");
+    }
+    if (!response.body)
+        throw new ReadFailure("HCS2_MIRROR_RESPONSE_INVALID", true);
+    const reader = response.body.getReader();
+    const pieces = [];
+    let size = 0;
+    try {
+        while (true) {
+            const part = await reader.read();
+            if (part.done)
+                break;
+            size += part.value.byteLength;
+            if (size > bounds.max) {
+                await reader.cancel().catch(() => undefined);
+                throw new ReadFailure("HCS2_MIRROR_RESPONSE_TOO_LARGE");
+            }
+            pieces.push(part.value);
+        }
+    }
+    catch (error) {
+        if (error instanceof ReadFailure)
+            throw error;
+        throw new ReadFailure("HCS2_MIRROR_UNAVAILABLE");
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const all = new Uint8Array(size);
+    let offset = 0;
+    for (const piece of pieces) {
+        all.set(piece, offset);
+        offset += piece.length;
+    }
+    try {
+        return record(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(all)));
+    }
+    catch (error) {
+        if (error instanceof ReadFailure)
+            throw error;
+        throw new ReadFailure("HCS2_MIRROR_RESPONSE_INVALID", true);
+    }
+}
+function normalizedMemo(value) {
+    if (typeof value !== "string" || value.length > 256) {
+        throw new ReadFailure("HCS2_TOPIC_MEMO_INVALID", true);
+    }
+    if (MEMO.test(value))
+        return value;
+    if (!BASE64.test(value))
+        throw new ReadFailure("HCS2_TOPIC_MEMO_INVALID", true);
+    const bytes = Buffer.from(value, "base64");
+    let decoded;
+    try {
+        decoded = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    }
+    catch {
+        throw new ReadFailure("HCS2_TOPIC_MEMO_INVALID", true);
+    }
+    if (bytes.toString("base64") !== value || !MEMO.test(decoded)) {
+        throw new ReadFailure("HCS2_TOPIC_MEMO_INVALID", true);
+    }
+    return decoded;
+}
+function output(request, status, reason_code, verification, consensus_timestamp = null) {
+    return Object.freeze({ status, reason_code, hedera_network: request.hedera_network,
+        registry_topic_id: request.registry_topic_id, sequence_number: request.sequence_number,
+        consensus_timestamp, resolver_id: "hedera.mirror-rest.hcs2.v1", verification });
+}
+/** Verifies an exact historical HCS-2 register; does NOT determine the current registry state. */
+export async function resolveHcs2RegisterV1(config, request) {
+    if (!request || (request.hedera_network !== "mainnet" && request.hedera_network !== "testnet") ||
+        !TOPIC.test(request.registry_topic_id) || !Number.isSafeInteger(request.sequence_number) ||
+        request.sequence_number < 1) {
+        throw new TypeError("HCS2_REGISTRY_LOCATOR_INVALID");
+    }
+    const base = baseUrl(config, request.hedera_network);
+    const bounds = requestBounds(config);
+    const prefix = base.toString().replace(/\/$/, "");
+    const topic = request.registry_topic_id;
+    try {
+        const topicRow = await readJson(config, new URL(`${prefix}/topics/${topic}`), bounds);
+        if (!topicRow)
+            return output(request, "unavailable", "HCS2_REGISTRY_NOT_FOUND", null);
+        if (topicRow.topic_id !== topic)
+            throw new ReadFailure("HCS2_REGISTRY_SCOPE_MISMATCH", true);
+        const memo = normalizedMemo(topicRow.memo);
+        const row = await readJson(config, new URL(`${prefix}/topics/${topic}/messages/${request.sequence_number}`), bounds);
+        if (!row)
+            return output(request, "unavailable", "HCS2_REGISTER_NOT_FOUND", null);
+        if (row.topic_id !== topic || row.sequence_number !== request.sequence_number ||
+            !singleMessageChunk(row.chunk_info) ||
+            typeof row.message !== "string" || !BASE64.test(row.message)) {
+            throw new ReadFailure("HCS2_MESSAGE_SCOPE_INVALID", true);
+        }
+        const timestamp = row.consensus_timestamp;
+        if (typeof timestamp !== "string" || !TIMESTAMP.test(timestamp)) {
+            throw new ReadFailure("HCS2_MESSAGE_TIMESTAMP_INVALID", true);
+        }
+        const message = Buffer.from(row.message, "base64");
+        if (!message.length || message.length > 1024 || message.toString("base64") !== row.message) {
+            throw new ReadFailure("HCS2_MIRROR_MESSAGE_INVALID", true);
+        }
+        const verification = verifyHcs2RegisterV1({ memo, message,
+            expected_t_id: request.expected_t_id ?? null });
+        const status = verification.status === "pass" ? "resolved" :
+            verification.reason_code === "HCS2_TARGET_MISMATCH" ? "conflict" : "invalid";
+        return output(request, status, verification.reason_code, verification, timestamp);
+    }
+    catch (error) {
+        if (error instanceof ReadFailure) {
+            return output(request, error.invalid ? "invalid" : "unavailable", error.code, null);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=hcs2MirrorV1.js.map

package/dist/resolvers/hcs2MirrorV1.js.map

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

package/dist/resolvers/hederaMirrorV1.d.ts

@@ -0,0 +1,22 @@
+import type { HederaNetwork, VerificationObservation, VerificationSubject } from "../contracts/verification.js";
+import type { ExplorerPublicationV1 } from "./explorerPublicV1.js";
+export type HederaMirrorV1Config = Readonly<{
+    /** Trusted caller configuration, never loaded from an evidence package. */
+    base_urls?: Readonly<Partial<Record<HederaNetwork, string>>>;
+    fetch_impl?: typeof fetch;
+    timeout_ms?: number;
+    max_response_bytes?: number;
+}>;
+export type HederaPublicationObservationV1 = Readonly<{
+    status: "resolved" | "unavailable" | "invalid" | "conflict";
+    reason_code: string | null;
+    /** Digest recomputed over independently retrieved, fully reassembled HCS bytes. */
+    observation: VerificationObservation | null;
+}>;
+/**
+ * Directly observe a public publication on a separately configured Hedera Mirror.
+ * The publication locator is a CLAIM until resolved; Mirror data is a distinct
+ * network observation, not cryptographic consensus authentication.
+ */
+export declare function resolveHederaPublicationV1(config: HederaMirrorV1Config, publication: ExplorerPublicationV1, subject: VerificationSubject): Promise<HederaPublicationObservationV1>;
+//# sourceMappingURL=hederaMirrorV1.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hederaMirrorV1.d.ts","sourceRoot":"","sources":["../../src/resolvers/hederaMirrorV1.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAChH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAkBnE,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,2EAA2E;IAC3E,SAAS,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7D,UAAU,CAAC,EAAE,OAAO,KAAK,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC;IACpD,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;IAC5D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mFAAmF;IACnF,WAAW,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC7C,CAAC,CAAC;AA2MH;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,oBAAoB,EAC5B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,8BAA8B,CAAC,CAqDzC"}