@veraanchor/verifier 0.0.0-stage → 0.1.0

package/dist/resolvers/executionMirrorV1.js

@@ -0,0 +1,206 @@
+import { EXECUTION_HEDERA_OBSERVATION_V1_ID } from "../triangulation/executionPlanV1.js";
+const DEFAULT_MIRROR = Object.freeze({
+    mainnet: "https://mainnet-public.mirrornode.hedera.com/api/v1",
+    testnet: "https://testnet.mirrornode.hedera.com/api/v1",
+});
+const TX = /^(0\.0\.\d+)[@-](\d{1,12})[.\-](\d{1,9})$/;
+const TOPIC = /^0\.0\.\d+$/;
+const BASE64 = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+const TIMESTAMP = /^\d{1,12}\.\d{1,9}$/;
+const MAX_BYTES = 256 * 1024;
+const MAX_TARGETS = 8;
+function record(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function transaction(value) {
+    if (typeof value !== "string")
+        return null;
+    const match = TX.exec(value);
+    return match ? `${match[1]}@${match[2]}.${match[3].padStart(9, "0")}` : null;
+}
+function base(config, network) {
+    const value = config.base_urls?.[network] ?? DEFAULT_MIRROR[network];
+    const url = new URL(value);
+    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 ||
+        !/^\/api\/v1\/?$/.test(url.pathname)) {
+        throw new TypeError("Mirror base URL must be a fixed HTTPS /api/v1 endpoint");
+    }
+    return `${url.origin}/api/v1`;
+}
+async function get(config, network, path) {
+    const timeout = config.timeout_ms ?? 8000;
+    const limit = config.max_response_bytes ?? MAX_BYTES;
+    if (!Number.isSafeInteger(timeout) || timeout < 250 || timeout > 15_000 ||
+        !Number.isSafeInteger(limit) || limit < 1024 || limit > MAX_BYTES)
+        throw new TypeError("Invalid Mirror transport bounds");
+    const url = `${base(config, network)}/${path}`;
+    try {
+        const response = await (config.fetch_impl ?? fetch)(url, {
+            method: "GET", redirect: "error", credentials: "omit", cache: "no-store",
+            headers: { Accept: "application/json" }, signal: AbortSignal.timeout(timeout),
+        });
+        if (response.status === 404)
+            return { status: "not_found", body: null };
+        if (!response.ok)
+            return { status: "unavailable", body: null };
+        const header = response.headers.get("content-length");
+        if (header && (!/^\d+$/.test(header) || Number(header) > limit))
+            return { status: "invalid", body: null };
+        if (!response.body)
+            return { status: "invalid", body: null };
+        const reader = response.body.getReader();
+        const chunks = [];
+        let count = 0;
+        try {
+            while (true) {
+                const next = await reader.read();
+                if (next.done)
+                    break;
+                count += next.value.byteLength;
+                if (count > limit) {
+                    await reader.cancel().catch(() => undefined);
+                    return { status: "invalid", body: null };
+                }
+                chunks.push(next.value);
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+        const bytes = new Uint8Array(count);
+        let offset = 0;
+        for (const chunk of chunks) {
+            bytes.set(chunk, offset);
+            offset += chunk.length;
+        }
+        try {
+            const body = record(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes)));
+            return body ? { status: "found", body } : { status: "invalid", body: null };
+        }
+        catch {
+            return { status: "invalid", body: null };
+        }
+    }
+    catch {
+        return { status: "unavailable", body: null };
+    }
+}
+function available(key, value) {
+    return Object.freeze({ key, state: "available", value });
+}
+function unavailable(key, reason_code) {
+    return Object.freeze({ key, state: "unavailable", reason_code });
+}
+export async function resolveExecutionHederaV1(config, input) {
+    const network = input.subject.hedera_network;
+    if ((network !== "mainnet" && network !== "testnet") || input.subject.kind !== "execution" ||
+        typeof input.subject.id !== "string" || !input.subject.id ||
+        !Array.isArray(input.targets) || input.targets.length > MAX_TARGETS) {
+        throw new TypeError("Invalid Hedera execution resolution scope");
+    }
+    const facts = [];
+    const observed = new Set();
+    if (input.targets.length === 0) {
+        return Object.freeze({ status: "unavailable", reason_code: "MIRROR_LEDGER_TARGETS_MISSING",
+            observation: Object.freeze({ id: EXECUTION_HEDERA_OBSERVATION_V1_ID, source: "hedera_mirror",
+                subject: input.subject, resolver_id: "hedera.execution-mirror.v1", facts: Object.freeze([]) }),
+        });
+    }
+    let status = "resolved";
+    let reason = null;
+    for (const target of input.targets) {
+        if (!target || target.network !== network || !["provided_evidence", "public_record"].includes(target.source) ||
+            !["acceptance_anchor", "result_evidence_anchor"].includes(target.role) ||
+            target.observation_fact_prefix !== `ledger.${target.source}.${target.role}` ||
+            (target.transaction_id && transaction(target.transaction_id) !== target.transaction_id) ||
+            (target.topic_id !== null && (typeof target.topic_id !== "string" || !TOPIC.test(target.topic_id))) ||
+            (target.transaction_id !== null && typeof target.transaction_id !== "string") ||
+            (target.sequence_number !== null && (typeof target.sequence_number !== "number")) ||
+            ((target.topic_id === null) !== (target.sequence_number === null)) ||
+            (target.sequence_number !== null && (!Number.isSafeInteger(target.sequence_number) || target.sequence_number < 1)) ||
+            (!target.transaction_id && !target.topic_id)) {
+            throw new TypeError("Invalid scoped Hedera execution target");
+        }
+        const prefix = target.observation_fact_prefix;
+        if (observed.has(prefix))
+            throw new TypeError("Duplicate Hedera execution target");
+        observed.add(prefix);
+        if (target.transaction_id) {
+            const match = TX.exec(target.transaction_id);
+            const resolved = await get(config, network, `transactions/${match[1]}-${match[2]}-${match[3]}`);
+            const key = `${prefix}.transaction_id`;
+            if (resolved.status === "found") {
+                const rows = resolved.body.transactions;
+                if (!Array.isArray(rows) || rows.length > 32) {
+                    facts.push(unavailable(key, "MIRROR_RESPONSE_INVALID"));
+                    if (status !== "conflict")
+                        status = "invalid";
+                    reason ??= "MIRROR_RESPONSE_INVALID";
+                }
+                else {
+                    const candidates = rows.map(record).filter((row) => row !== null);
+                    const exact = candidates.filter((row) => transaction(row.transaction_id) === target.transaction_id);
+                    if (exact.length !== 1 || exact[0].result !== "SUCCESS") {
+                        facts.push(unavailable(key, "MIRROR_TRANSACTION_CONFLICT"));
+                        status = "conflict";
+                        reason = "MIRROR_TRANSACTION_CONFLICT";
+                    }
+                    else {
+                        facts.push(available(key, transaction(exact[0].transaction_id)));
+                    }
+                }
+            }
+            else {
+                facts.push(unavailable(key, `MIRROR_TRANSACTION_${resolved.status.toUpperCase()}`));
+                if (status === "resolved" || (status === "unavailable" && resolved.status === "invalid")) {
+                    status = resolved.status === "invalid" ? "invalid" : "unavailable";
+                }
+                reason ??= `MIRROR_TRANSACTION_${resolved.status.toUpperCase()}`;
+            }
+        }
+        if (target.topic_id && target.sequence_number !== null) {
+            const resolved = await get(config, network, `topics/${target.topic_id}/messages/${target.sequence_number}`);
+            const topicKey = `${prefix}.topic_id`;
+            const sequenceKey = `${prefix}.sequence_number`;
+            if (resolved.status === "found") {
+                const row = resolved.body;
+                if (typeof row.topic_id !== "string" || !TOPIC.test(row.topic_id) ||
+                    !Number.isSafeInteger(Number(row.sequence_number)) || Number(row.sequence_number) < 1 ||
+                    typeof row.consensus_timestamp !== "string" || !TIMESTAMP.test(row.consensus_timestamp) ||
+                    typeof row.message !== "string" || row.message.length > 1368 || !BASE64.test(row.message) ||
+                    Buffer.from(row.message, "base64").toString("base64") !== row.message) {
+                    facts.push(unavailable(topicKey, "MIRROR_RESPONSE_INVALID"), unavailable(sequenceKey, "MIRROR_RESPONSE_INVALID"));
+                    if (status !== "conflict")
+                        status = "invalid";
+                    reason ??= "MIRROR_RESPONSE_INVALID";
+                }
+                else {
+                    facts.push(available(topicKey, row.topic_id), available(sequenceKey, String(row.sequence_number)));
+                    if (row.topic_id !== target.topic_id || Number(row.sequence_number) !== target.sequence_number) {
+                        status = "conflict";
+                        reason = "MIRROR_MESSAGE_SCOPE_MISMATCH";
+                    }
+                }
+            }
+            else {
+                const code = `MIRROR_MESSAGE_${resolved.status.toUpperCase()}`;
+                facts.push(unavailable(topicKey, code), unavailable(sequenceKey, code));
+                if (status === "resolved" || (status === "unavailable" && resolved.status === "invalid")) {
+                    status = resolved.status === "invalid" ? "invalid" : "unavailable";
+                }
+                reason ??= code;
+            }
+        }
+    }
+    const observation = Object.freeze({
+        id: EXECUTION_HEDERA_OBSERVATION_V1_ID,
+        source: "hedera_mirror",
+        subject: input.subject,
+        resolver_id: "hedera.execution-mirror.v1",
+        facts: Object.freeze(facts),
+    });
+    return Object.freeze({ status, reason_code: reason, observation });
+}
+//# sourceMappingURL=executionMirrorV1.js.map

package/dist/resolvers/executionMirrorV1.js.map

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

package/dist/resolvers/explorerExecutionV1.d.ts

@@ -0,0 +1,17 @@
+import type { HederaNetwork } from "../contracts/verification.js";
+import type { PublicExecutionStandardsEvidence } from "../profiles/execution/contractV1.js";
+import { type ExplorerPublicTransportV1 } from "./explorerTransportV1.js";
+type Status = "resolved" | "not_found" | "unavailable" | "invalid" | "conflict" | "verification_material_unavailable";
+export type ExplorerExecutionV1Request = Readonly<{
+    job_id: string;
+    result_id?: string | null;
+    network: HederaNetwork;
+}>;
+export type ExplorerExecutionV1Result = Readonly<{
+    status: Status;
+    reason_code: string | null;
+    evidence: PublicExecutionStandardsEvidence | null;
+}>;
+export declare function resolveExplorerExecutionV1(config: ExplorerPublicTransportV1, request: ExplorerExecutionV1Request): Promise<ExplorerExecutionV1Result>;
+export {};
+//# sourceMappingURL=explorerExecutionV1.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explorerExecutionV1.d.ts","sourceRoot":"","sources":["../../src/resolvers/explorerExecutionV1.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AAC5F,OAAO,EAAwB,KAAK,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAIhG,KAAK,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,mCAAmC,CAAC;AACtH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,gCAAgC,GAAG,IAAI,CAAC;CACnD,CAAC,CAAC;AAYH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,yBAAyB,EACjC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CA0CpC"}

package/dist/resolvers/explorerExecutionV1.js

@@ -0,0 +1,61 @@
+import { readExplorerPublicV1 } from "./explorerTransportV1.js";
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function record(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function identity(value) {
+    return typeof value === "string" && UUID.test(value.trim()) ? value.trim().toLowerCase() : null;
+}
+function result(status, reason_code, evidence = null) {
+    return Object.freeze({ status, reason_code, evidence });
+}
+export async function resolveExplorerExecutionV1(config, request) {
+    const job = identity(request.job_id);
+    const selected = request.result_id == null ? null : identity(request.result_id);
+    if (!job || (request.result_id != null && !selected) ||
+        (request.network !== "mainnet" && request.network !== "testnet")) {
+        throw new TypeError("Execution lookup requires a valid job, result and network scope");
+    }
+    if (selected) {
+        const scoped = await readExplorerPublicV1(config, `/v1/sage/results/${selected}`, request.network);
+        if (scoped.status !== "ok")
+            return result(scoped.status, scoped.reason_code ?? "EXPLORER_RESULT_UNAVAILABLE");
+        const row = record(scoped.body);
+        if (!row)
+            return result("invalid", "EXPLORER_RESULT_INVALID");
+        const resultId = identity(row.result_id ?? row.id);
+        const jobId = identity(row.job_id);
+        if (!resultId || !jobId)
+            return result("invalid", "EXPLORER_RESULT_SCOPE_MISSING");
+        if (resultId !== selected || jobId !== job ||
+            (row.hedera_network != null && row.hedera_network !== request.network)) {
+            return result("conflict", "EXPLORER_RESULT_SCOPE_MISMATCH");
+        }
+    }
+    const response = await readExplorerPublicV1(config, `/v1/sage/jobs/${job}/standards`, request.network, undefined, selected ? { resultId: selected } : undefined);
+    if (response.status !== "ok")
+        return result(response.status, response.reason_code ?? "EXPLORER_EXECUTION_UNAVAILABLE");
+    const body = record(response.body);
+    if (!body)
+        return result("invalid", "EXPLORER_EXECUTION_INVALID");
+    const execution = record(body.execution);
+    if (!execution || identity(execution.job_id) !== job || execution.hedera_network !== request.network) {
+        return result("conflict", "EXPLORER_EXECUTION_SCOPE_MISMATCH");
+    }
+    if (body.available === false)
+        return result("verification_material_unavailable", "EXPLORER_STANDARDS_UNAVAILABLE");
+    if (body.available !== true || body.contract_version !== "1.0.0") {
+        return result("invalid", "EXPLORER_EXECUTION_CONTRACT_UNSUPPORTED");
+    }
+    if (selected) {
+        const resultEvidence = record(body.result_evidence);
+        const actual = identity(resultEvidence?.result_id);
+        if (!resultEvidence || !actual)
+            return result("verification_material_unavailable", "EXPLORER_RESULT_EVIDENCE_UNAVAILABLE");
+        if (actual !== selected || (execution.result_id != null && identity(execution.result_id) !== selected)) {
+            return result("conflict", "EXPLORER_RESULT_EVIDENCE_SCOPE_MISMATCH");
+        }
+    }
+    return Object.freeze({ status: "resolved", reason_code: null, evidence: body });
+}
+//# sourceMappingURL=explorerExecutionV1.js.map

package/dist/resolvers/explorerExecutionV1.js.map

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

package/dist/resolvers/explorerPublicV1.d.ts

@@ -0,0 +1,37 @@
+import type { HederaNetwork, VerificationObservation } from "../contracts/verification.js";
+import { type ExplorerPublicTransportV1 } from "./explorerTransportV1.js";
+export type ExplorerPublicationV1 = Readonly<{
+    hedera_network: HederaNetwork;
+    entity_kind: "dataset" | "dataset_version" | "merkle_anchor" | "merkle_root";
+    entity_id: string;
+    transaction_id: string | null;
+    message_id: string | null;
+    topic_id: string | null;
+    sequence_number: number | null;
+}>;
+export type ExplorerPublicRecordV1 = Readonly<{
+    status: "resolved" | "not_found" | "unavailable" | "invalid" | "conflict";
+    reason_code: string | null;
+    observation: VerificationObservation | null;
+    publication: ExplorerPublicationV1 | null;
+}>;
+export type ExplorerDatasetV1Request = Readonly<{
+    dataset_key: string;
+    network: HederaNetwork;
+}>;
+export type ExplorerIngestV1Request = Readonly<{
+    anchor_request_id: string;
+    ingest_object_key: string;
+    network: HederaNetwork;
+}>;
+export type ExplorerMerkleRootV1Request = Readonly<{
+    root_id: string;
+    network: HederaNetwork;
+}>;
+/** Resolve the active Dataset manifest; never infer bundle_digest from manifest_hash. */
+export declare function resolveExplorerDatasetV1(config: ExplorerPublicTransportV1, request: ExplorerDatasetV1Request): Promise<ExplorerPublicRecordV1>;
+/** Resolve a public Merkle anchor by its explicit ID; bind it to caller's Ingest object key. */
+export declare function resolveExplorerIngestV1(config: ExplorerPublicTransportV1, request: ExplorerIngestV1Request): Promise<ExplorerPublicRecordV1>;
+/** Core-generated root evidence; independent of any HF tenant anchor request. */
+export declare function resolveExplorerMerkleRootV1(config: ExplorerPublicTransportV1, request: ExplorerMerkleRootV1Request): Promise<ExplorerPublicRecordV1>;
+//# sourceMappingURL=explorerPublicV1.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explorerPublicV1.d.ts","sourceRoot":"","sources":["../../src/resolvers/explorerPublicV1.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAoB,uBAAuB,EAAuB,MAAM,8BAA8B,CAAC;AAClI,OAAO,EAAwB,KAAK,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAShG,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,cAAc,EAAE,aAAa,CAAC;IAC9B,WAAW,EAAE,SAAS,GAAG,iBAAiB,GAAG,eAAe,GAAG,aAAa,CAAC;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC5C,WAAW,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC3C,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC,CAAC;AAoIH,yFAAyF;AACzF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,yBAAyB,EACjC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAwBjC;AAED,gGAAgG;AAChG,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,yBAAyB,EACjC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CA0BjC;AAED,iFAAiF;AACjF,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,yBAAyB,EACjC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,sBAAsB,CAAC,CAoBjC"}

package/dist/resolvers/explorerPublicV1.js

@@ -0,0 +1,210 @@
+import { readExplorerPublicV1 } from "./explorerTransportV1.js";
+const HASH = /^[0-9a-f]{128}$/i;
+const KEY = /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,255}$/;
+const UUID = /^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/i;
+const TOPIC = /^0\.0\.[1-9][0-9]*$/;
+const MAX_VALUE = 4096;
+function record(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new TypeError("Invalid Explorer public record");
+    return value;
+}
+function string(value, max = MAX_VALUE) {
+    if (value === null || value === undefined || value === "")
+        return null;
+    if (typeof value !== "string" || value.length > max || !value.trim()) {
+        throw new TypeError("Invalid Explorer public string");
+    }
+    return value.trim();
+}
+function hash(value) {
+    const s = string(value, 128);
+    if (!s)
+        return null;
+    if (!HASH.test(s))
+        throw new TypeError("Invalid Explorer SHA3-512 commitment");
+    return s.toLowerCase();
+}
+function positiveInt(value) {
+    if (value === null || value === undefined || value === "")
+        return null;
+    const n = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
+    if (!Number.isSafeInteger(n) || n < 1)
+        throw new TypeError("Invalid Explorer sequence number");
+    return n;
+}
+function count(value) {
+    if (value === null || value === undefined || value === "")
+        return null;
+    const n = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
+    if (!Number.isSafeInteger(n) || n < 0)
+        throw new TypeError("Invalid Explorer count");
+    return n;
+}
+function available(key, value, reason = "PUBLIC_FIELD_UNAVAILABLE") {
+    return value === null
+        ? { key, state: "unavailable", reason_code: reason }
+        : { key, state: "available", value };
+}
+function observation(subject, id, facts) {
+    return Object.freeze({
+        id,
+        subject: Object.freeze({ ...subject }),
+        source: "public_record",
+        resolver_id: "explorer.public-http.v1",
+        facts: Object.freeze(facts.map((fact) => Object.freeze(fact))),
+    });
+}
+function outcome(status, reason) {
+    return { status, reason_code: reason, observation: null, publication: null };
+}
+function publication(row, prefix, kind, entityId, network) {
+    const transaction = string(row[`${prefix}transaction_id`], 256);
+    const message = string(row[`${prefix}message_id`], 256);
+    const topic = string(row[`${prefix}topic_id`], 64);
+    const sequence = positiveInt(row[`${prefix}sequence_number`]);
+    if (!transaction && !message && !topic && sequence === null)
+        return null;
+    if (!entityId || (!transaction && !message && !(topic && sequence !== null)) ||
+        (topic !== null && !TOPIC.test(topic)) || (topic === null) !== (sequence === null)) {
+        throw new TypeError("Invalid Explorer publication locator");
+    }
+    if (message) {
+        const match = /^(?:(\d+)@(0\.0\.\d+)|(0\.0\.\d+)@(\d+))$/.exec(message);
+        if (!match)
+            throw new TypeError("Invalid Explorer publication message id");
+        const messageTopic = match[2] ?? match[3];
+        const messageSequence = Number(match[1] ?? match[4]);
+        if (!messageTopic || !TOPIC.test(messageTopic) || !Number.isSafeInteger(messageSequence) || messageSequence < 1 ||
+            (topic && messageTopic !== topic) || (sequence !== null && sequence !== messageSequence)) {
+            throw new TypeError("Inconsistent Explorer publication message identity");
+        }
+        return Object.freeze({
+            hedera_network: network,
+            entity_kind: kind,
+            entity_id: entityId,
+            transaction_id: transaction,
+            message_id: `${messageSequence}@${messageTopic}`,
+            topic_id: topic ?? messageTopic,
+            sequence_number: sequence ?? messageSequence,
+        });
+    }
+    return Object.freeze({
+        hedera_network: network,
+        entity_kind: kind,
+        entity_id: entityId,
+        transaction_id: transaction,
+        message_id: topic && sequence !== null ? `${sequence}@${topic}` : null,
+        topic_id: topic,
+        sequence_number: sequence,
+    });
+}
+function requiredNetwork(row, network) {
+    if (row.hedera_network !== network)
+        throw new TypeError("Explorer public record network mismatch");
+}
+function materialize(subject, id, facts, pub) {
+    facts.push(available("publication.entity_kind", pub?.entity_kind ?? null, "PUBLICATION_ANCHOR_UNAVAILABLE"), available("publication.entity_id", pub?.entity_id ?? null, "PUBLICATION_ANCHOR_UNAVAILABLE"), available("publication.topic_id", pub?.topic_id ?? null, "PUBLICATION_ANCHOR_UNAVAILABLE"), available("publication.sequence_number", pub?.sequence_number ?? null, "PUBLICATION_ANCHOR_UNAVAILABLE"));
+    return Object.freeze({
+        status: "resolved",
+        reason_code: null,
+        observation: observation(subject, id, facts),
+        publication: pub,
+    });
+}
+function validatedInput(id, network, pattern) {
+    if (typeof id !== "string" || !pattern.test(id) || (network !== "testnet" && network !== "mainnet")) {
+        throw new TypeError("Invalid Explorer public lookup input");
+    }
+}
+/** Resolve the active Dataset manifest; never infer bundle_digest from manifest_hash. */
+export async function resolveExplorerDatasetV1(config, request) {
+    validatedInput(request.dataset_key, request.network, KEY);
+    const read = await readExplorerPublicV1(config, `/v1/datasets/${encodeURIComponent(request.dataset_key)}`, request.network);
+    if (read.status !== "ok")
+        return outcome(read.status, read.reason_code);
+    try {
+        const row = record(read.body);
+        requiredNetwork(row, request.network);
+        if (row.dataset_key == null)
+            return outcome("unavailable", "PUBLIC_DATASET_KEY_UNAVAILABLE");
+        if (row.dataset_key !== request.dataset_key)
+            return outcome("conflict", "PUBLIC_DATASET_KEY_MISMATCH");
+        const versionId = string(row.dataset_version_id, 128);
+        const datasetId = string(row.dataset_id, 128);
+        const version = publication(row, "publication_version_", "dataset_version", versionId, request.network);
+        const dataset = publication(row, "publication_dataset_", "dataset", datasetId, request.network);
+        const selected = version ?? dataset;
+        return materialize({ kind: "dataset", id: request.dataset_key, hedera_network: request.network }, "dataset.public_record", [
+            available("dataset_key", request.dataset_key),
+            available("dataset_fingerprint", hash(row.dataset_fingerprint)),
+            available("dataset.manifest_hash", hash(row.manifest_hash)),
+            available("dataset.version_id", versionId),
+            available("dataset.dataset_id", datasetId),
+        ], selected);
+    }
+    catch {
+        return outcome("invalid", "PUBLIC_DATASET_RESPONSE_INVALID");
+    }
+}
+/** Resolve a public Merkle anchor by its explicit ID; bind it to caller's Ingest object key. */
+export async function resolveExplorerIngestV1(config, request) {
+    validatedInput(request.anchor_request_id, request.network, UUID);
+    validatedInput(request.ingest_object_key, request.network, KEY);
+    const read = await readExplorerPublicV1(config, `/v1/merkle/anchors/${request.anchor_request_id}`, request.network);
+    if (read.status !== "ok")
+        return outcome(read.status, read.reason_code);
+    try {
+        const row = record(read.body);
+        requiredNetwork(row, request.network);
+        if (row.anchor_request_id == null)
+            return outcome("unavailable", "PUBLIC_ANCHOR_ID_UNAVAILABLE");
+        if (row.anchor_request_id !== request.anchor_request_id)
+            return outcome("conflict", "PUBLIC_ANCHOR_ID_MISMATCH");
+        if (row.ingest_object_key == null)
+            return outcome("unavailable", "PUBLIC_INGEST_OBJECT_UNAVAILABLE");
+        if (row.ingest_object_key !== request.ingest_object_key)
+            return outcome("conflict", "PUBLIC_INGEST_OBJECT_MISMATCH");
+        const pub = publication(row, "publication_anchor_", "merkle_anchor", request.anchor_request_id, request.network);
+        return materialize({ kind: "ingest", id: request.ingest_object_key, hedera_network: request.network }, "ingest.public_record", [
+            available("ingest.object_key", request.ingest_object_key),
+            available("fingerprint", hash(row.ingest_fingerprint)),
+            available("bundle_digest", hash(row.ingest_bundle_digest)),
+            available("ingest.merkle_root", hash(row.ingest_merkle_root)),
+            available("ingest.total_bytes", count(row.ingest_total_bytes)),
+            available("merkle.anchor_request_id", request.anchor_request_id),
+            available("merkle.root_id", string(row.root_id, 128)),
+            available("merkle.root_hash", hash(row.root_hash)),
+        ], pub);
+    }
+    catch {
+        return outcome("invalid", "PUBLIC_INGEST_RESPONSE_INVALID");
+    }
+}
+/** Core-generated root evidence; independent of any HF tenant anchor request. */
+export async function resolveExplorerMerkleRootV1(config, request) {
+    validatedInput(request.root_id, request.network, UUID);
+    const read = await readExplorerPublicV1(config, `/v1/merkle/roots/${request.root_id}`, request.network);
+    if (read.status !== "ok")
+        return outcome(read.status, read.reason_code);
+    try {
+        const row = record(read.body);
+        requiredNetwork(row, request.network);
+        if (row.id == null)
+            return outcome("unavailable", "PUBLIC_ROOT_ID_UNAVAILABLE");
+        if (row.id !== request.root_id)
+            return outcome("conflict", "PUBLIC_ROOT_ID_MISMATCH");
+        const pub = publication(row, "publication_root_", "merkle_root", request.root_id, request.network);
+        return materialize({ kind: "merkle_root", id: request.root_id, hedera_network: request.network }, "merkle_root.public_record", [
+            available("merkle.root_id", request.root_id),
+            available("merkle.root_hash", hash(row.root_hash)),
+            available("merkle.leaf_count", count(row.leaf_count)),
+            available("merkle.hash_alg", string(row.hash_alg, 64)),
+            available("merkle.tree_alg", string(row.tree_alg, 64)),
+        ], pub);
+    }
+    catch {
+        return outcome("invalid", "PUBLIC_MERKLE_RESPONSE_INVALID");
+    }
+}
+//# sourceMappingURL=explorerPublicV1.js.map

package/dist/resolvers/explorerPublicV1.js.map

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

package/dist/resolvers/explorerPublicationV1.d.ts

@@ -0,0 +1,20 @@
+import type { VerificationObservation } from "../contracts/verification.js";
+import { type ExplorerDatasetV1Request, type ExplorerIngestV1Request, type ExplorerMerkleRootV1Request, type ExplorerPublicRecordV1 } from "./explorerPublicV1.js";
+import { type ExplorerPublicTransportV1 } from "./explorerTransportV1.js";
+export type ExplorerPublicationDisclosureV1 = Readonly<{
+    status: "resolved" | "unavailable" | "invalid" | "conflict" | "unsupported";
+    reason_code: string | null;
+    /** Core/Explorer-supplied disclosure claims; NOT independently decrypted evidence. */
+    receipt_observation: VerificationObservation | null;
+    /** Core's claimed HCS message digest, for independent comparison in Phase 3C. */
+    message_binding_observation: VerificationObservation | null;
+}>;
+/** Public workflows cannot accept a caller-constructed publication locator. */
+export type ExplorerPublishedEvidenceV1 = Readonly<{
+    public_record: ExplorerPublicRecordV1;
+    disclosure: ExplorerPublicationDisclosureV1;
+}>;
+export declare function resolveExplorerDatasetPublicationV1(config: ExplorerPublicTransportV1, request: ExplorerDatasetV1Request): Promise<ExplorerPublishedEvidenceV1>;
+export declare function resolveExplorerIngestPublicationV1(config: ExplorerPublicTransportV1, request: ExplorerIngestV1Request): Promise<ExplorerPublishedEvidenceV1>;
+export declare function resolveExplorerMerkleRootPublicationV1(config: ExplorerPublicTransportV1, request: ExplorerMerkleRootV1Request): Promise<ExplorerPublishedEvidenceV1>;
+//# sourceMappingURL=explorerPublicationV1.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explorerPublicationV1.d.ts","sourceRoot":"","sources":["../../src/resolvers/explorerPublicationV1.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE9F,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAE5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAwB,KAAK,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAOhG,MAAM,MAAM,+BAA+B,GAAG,QAAQ,CAAC;IACrD,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;IAC5E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sFAAsF;IACtF,mBAAmB,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACpD,iFAAiF;IACjF,2BAA2B,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC7D,CAAC,CAAC;AAkKH,+EAA+E;AAC/E,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IACjD,aAAa,EAAE,sBAAsB,CAAC;IACtC,UAAU,EAAE,+BAA+B,CAAC;CAC7C,CAAC,CAAC;AAYH,wBAAsB,mCAAmC,CACvD,MAAM,EAAE,yBAAyB,EACjC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,2BAA2B,CAAC,CAEtC;AAED,wBAAsB,kCAAkC,CACtD,MAAM,EAAE,yBAAyB,EACjC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,2BAA2B,CAAC,CAEtC;AAED,wBAAsB,sCAAsC,CAC1D,MAAM,EAAE,yBAAyB,EACjC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,2BAA2B,CAAC,CAEtC"}