@veraanchor/verifier 0.0.0-stage → 0.1.0

package/dist/standards/hcs/hcs11V1.js

@@ -0,0 +1,289 @@
+/** Pinned HCS-11 Draft 1.1 AI-agent profile (type 1), offline only.
+ *  Does not authenticate Hedera account memo, DID control, or publication.
+ */
+import { createHash } from "node:crypto";
+import { parseHcs14DidUaidV1, verifyHcs14DidBindingV1, Hcs14V1Error } from "./hcs14V1.js";
+export const MAX_HCS11_V1_PROFILE_BYTES = 128 * 1024;
+const REF = /^hcs:\/\/(1|2)\/(0\.0\.[0-9]+)$/;
+const TOP_KEYS = new Set(["version", "type", "display_name", "uaid", "alias", "bio", "profileImage", "properties", "aiAgent"]);
+const AGENT_KEYS = new Set(["type", "capabilities", "model", "creator"]);
+export class Hcs11V1Error extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+        this.name = "Hcs11V1Error";
+    }
+}
+function fail(code) { throw new Hcs11V1Error(code); }
+function record(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return fail("HCS11_FIELD_INVALID");
+    const proto = Object.getPrototypeOf(value);
+    if (proto !== null && proto !== Object.prototype)
+        return fail("HCS11_FIELD_INVALID");
+    return value;
+}
+function keysOnly(value, allowed) {
+    for (const key of Object.keys(value))
+        if (!allowed.has(key))
+            fail("HCS11_FIELD_UNSUPPORTED");
+}
+function requiredText(value, max) {
+    if (typeof value !== "string")
+        return fail("HCS11_FIELD_INVALID");
+    const out = value.trim();
+    if (!out || out.length > max || /[\u0000-\u001f\u007f]/.test(out))
+        return fail("HCS11_FIELD_INVALID");
+    return out;
+}
+function optionalText(value, max) {
+    if (value == null || value === "")
+        return null;
+    if (typeof value === "string" && !value.trim())
+        return null;
+    return requiredText(value, max);
+}
+export function parseHcs11AccountMemoV1(value) {
+    if (typeof value !== "string")
+        return fail("HCS11_MEMO_INVALID");
+    if (value.length > 4096)
+        return fail("HCS11_MEMO_TOO_LARGE");
+    const memo = value.trim();
+    if (!memo.startsWith("hcs-11:"))
+        return fail("HCS11_MEMO_INVALID");
+    if (Buffer.byteLength(memo, "utf8") > 100)
+        return fail("HCS11_MEMO_TOO_LARGE");
+    const reference = memo.slice(7);
+    const match = REF.exec(reference);
+    if (!match)
+        return fail("HCS11_PROFILE_REF_INVALID");
+    return Object.freeze({ memo, profile_reference: reference,
+        protocol: `hcs-${match[1]}`, topic_id: match[2] });
+}
+/** Reject ambiguous JSON duplicate keys, including nested and escaped key aliases. */
+function assertUniqueJsonKeys(source) {
+    let i = 0;
+    const space = () => { while (i < source.length && /\s/.test(source[i]))
+        i++; };
+    const jsonString = () => {
+        const start = i++;
+        while (i < source.length) {
+            if (source[i] === "\\") {
+                i += 2;
+                continue;
+            }
+            if (source[i++] === '"')
+                return JSON.parse(source.slice(start, i));
+        }
+        return fail("HCS11_PROFILE_JSON_INVALID");
+    };
+    const visit = (depth) => {
+        if (depth > 32)
+            return fail("HCS11_PROFILE_TOO_LARGE");
+        space();
+        if (source[i] === '{') {
+            i++;
+            space();
+            const keys = new Set();
+            while (source[i] !== '}') {
+                const key = jsonString();
+                if (keys.has(key))
+                    return fail("HCS11_PROFILE_JSON_INVALID");
+                keys.add(key);
+                space();
+                i++;
+                space(); // validated colon (JSON.parse called first)
+                visit(depth + 1);
+                space();
+                if (source[i] !== ',')
+                    break;
+                i++;
+                space();
+            }
+            i++;
+        }
+        else if (source[i] === '[') {
+            i++;
+            space();
+            while (source[i] !== ']') {
+                visit(depth + 1);
+                space();
+                if (source[i] !== ',')
+                    break;
+                i++;
+                space();
+            }
+            i++;
+        }
+        else if (source[i] === '"') {
+            jsonString();
+        }
+        else {
+            while (i < source.length && !/[\s,\]}]/.test(source[i]))
+                i++;
+        }
+    };
+    visit(0);
+}
+function freezeJson(value, depth = 0) {
+    if (depth > 32)
+        return fail("HCS11_PROFILE_TOO_LARGE");
+    if (value && typeof value === "object" && !Object.isFrozen(value)) {
+        for (const child of Object.values(value))
+            freezeJson(child, depth + 1);
+        Object.freeze(value);
+    }
+    return value;
+}
+export function parseHcs11AiAgentProfileV1(value) {
+    let bytes;
+    if (typeof value === "string") {
+        if (value.length > MAX_HCS11_V1_PROFILE_BYTES)
+            return fail("HCS11_PROFILE_TOO_LARGE");
+        bytes = Buffer.from(value, "utf8");
+    }
+    else if (value instanceof Uint8Array)
+        bytes = value;
+    else
+        return fail("HCS11_PROFILE_JSON_INVALID");
+    if (!bytes.byteLength || bytes.byteLength > MAX_HCS11_V1_PROFILE_BYTES) {
+        return fail(bytes.byteLength ? "HCS11_PROFILE_TOO_LARGE" : "HCS11_PROFILE_JSON_INVALID");
+    }
+    let obj;
+    try {
+        const source = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+        obj = record(JSON.parse(source));
+        assertUniqueJsonKeys(source);
+    }
+    catch (e) {
+        if (e instanceof Hcs11V1Error)
+            throw e;
+        return fail("HCS11_PROFILE_JSON_INVALID");
+    }
+    keysOnly(obj, TOP_KEYS);
+    if (obj.type !== 1)
+        return fail("HCS11_PROFILE_TYPE_UNSUPPORTED");
+    const uaid = requiredText(obj.uaid, 4096);
+    parseHcs14DidUaidV1(uaid);
+    const agent = record(obj.aiAgent);
+    keysOnly(agent, AGENT_KEYS);
+    if (agent.type !== 0 && agent.type !== 1)
+        return fail("HCS11_AGENT_TYPE_INVALID");
+    if (!Array.isArray(agent.capabilities))
+        return fail("HCS11_CAPABILITIES_INVALID");
+    const numeric = agent.capabilities.map((n) => Number(n));
+    if (numeric.some((n) => !Number.isSafeInteger(n) || n < 0) || new Set(numeric).size !== numeric.length) {
+        return fail("HCS11_CAPABILITIES_INVALID");
+    }
+    const alias = optionalText(obj.alias, 256);
+    const bio = optionalText(obj.bio, 4096);
+    const profileImage = optionalText(obj.profileImage, 4096);
+    const creator = optionalText(agent.creator, 256);
+    let properties;
+    if (obj.properties != null)
+        properties = record(obj.properties);
+    // Material is reconstructed from validated typed fields, not mutated in place.
+    const normalized = {
+        version: requiredText(obj.version ?? "1.1", 32), type: 1,
+        display_name: requiredText(obj.display_name, 128), uaid,
+        ...(alias == null ? {} : { alias }),
+        ...(bio == null ? {} : { bio }),
+        ...(profileImage == null ? {} : { profileImage }),
+        ...(properties === undefined ? {} : { properties }),
+        aiAgent: {
+            type: agent.type,
+            capabilities: Object.freeze(numeric.sort((a, b) => a - b)),
+            model: requiredText(agent.model, 256),
+            ...(creator == null ? {} : { creator }),
+        },
+    };
+    return freezeJson(normalized);
+}
+/** A strict canonical JSON subset for the pinned profile contract; rejects non-I-JSON material. */
+function canonical(value, depth = 0, seen = new Set()) {
+    if (depth > 32)
+        return fail("HCS11_CANONICALIZATION_FAILED");
+    if (value === null)
+        return "null";
+    if (typeof value === "string") {
+        if (/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/u.test(value)) {
+            return fail("HCS11_CANONICALIZATION_FAILED");
+        }
+        return JSON.stringify(value);
+    }
+    if (typeof value === "boolean")
+        return value ? "true" : "false";
+    if (typeof value === "number" && Number.isFinite(value))
+        return JSON.stringify(value);
+    if (!value || typeof value !== "object")
+        return fail("HCS11_CANONICALIZATION_FAILED");
+    if (seen.has(value))
+        return fail("HCS11_CANONICALIZATION_FAILED");
+    seen.add(value);
+    if (Array.isArray(value)) {
+        const out = `[${value.map((v) => canonical(v, depth + 1, seen)).join(",")}]`;
+        seen.delete(value);
+        return out;
+    }
+    const object = record(value);
+    const fields = Object.keys(object).sort().map((key) => {
+        const val = object[key];
+        if (val === undefined)
+            return fail("HCS11_CANONICALIZATION_FAILED");
+        return `${canonical(key, depth + 1, seen)}:${canonical(val, depth + 1, seen)}`;
+    });
+    seen.delete(value);
+    return `{${fields.join(",")}}`;
+}
+/** Offline parsing + digest recomputation over normalized pinned profile material. */
+export function verifyHcs11AiAgentProfileV1(input) {
+    let profile = null;
+    let memo = null;
+    let sha256 = null;
+    let memoReferenceMatch = "not_checked";
+    const output = (status, reason) => Object.freeze({ status, reason_code: reason, profile, sha256, account_memo: memo,
+        memo_reference_match: memoReferenceMatch });
+    try {
+        if (!input || typeof input !== "object" || Array.isArray(input))
+            return fail("HCS11_INPUT_INVALID");
+        profile = parseHcs11AiAgentProfileV1(input.profile);
+        if (profile.version !== "1.1")
+            return output("unsupported", "HCS11_VERSION_UNSUPPORTED");
+        const canonicalBytes = Buffer.from(canonical(profile), "utf8");
+        if (canonicalBytes.byteLength > MAX_HCS11_V1_PROFILE_BYTES)
+            return fail("HCS11_PROFILE_TOO_LARGE");
+        sha256 = createHash("sha256").update(canonicalBytes).digest("hex");
+        if (input.expected_sha256 != null) {
+            if (typeof input.expected_sha256 !== "string" || !/^[0-9a-f]{64}$/.test(input.expected_sha256)) {
+                return fail("HCS11_EXPECTED_CHECKSUM_INVALID");
+            }
+            if (sha256 !== input.expected_sha256)
+                return fail("HCS11_CHECKSUM_MISMATCH");
+        }
+        if (input.expected_uaid != null && profile.uaid !== input.expected_uaid)
+            return fail("HCS11_UAID_MISMATCH");
+        if (input.expected_base_did != null) {
+            const binding = verifyHcs14DidBindingV1({ uaid: profile.uaid, base_did: input.expected_base_did });
+            if (binding.status !== "pass")
+                return fail(binding.reason_code ?? "HCS14_DID_BINDING_MISMATCH");
+        }
+        if (input.account_memo != null) {
+            memo = parseHcs11AccountMemoV1(input.account_memo);
+            if (input.expected_profile_reference != null) {
+                memoReferenceMatch = memo.profile_reference === input.expected_profile_reference ? "match" : "mismatch";
+                if (memoReferenceMatch === "mismatch")
+                    return fail("HCS11_PROFILE_REFERENCE_MISMATCH");
+            }
+        }
+        else if (input.expected_profile_reference != null)
+            return fail("HCS11_ACCOUNT_MEMO_UNAVAILABLE");
+        return output("pass", null);
+    }
+    catch (error) {
+        if (error instanceof Hcs11V1Error || error instanceof Hcs14V1Error)
+            return output("fail", error.code);
+        throw error;
+    }
+}
+//# sourceMappingURL=hcs11V1.js.map

package/dist/standards/hcs/hcs11V1.js.map

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

package/dist/standards/hcs/hcs13V1.d.ts

@@ -0,0 +1,39 @@
+export declare const MAX_HCS13_V1_SCHEMA_BYTES: number;
+export declare class Hcs13V1Error extends Error {
+    readonly code: string;
+    constructor(code: string);
+}
+export type Hcs13ReferenceV1 = Readonly<{
+    ref: string;
+    registry_topic_id: string;
+    sequence_number: number;
+}>;
+export type Hcs13SchemaV1 = Readonly<{
+    schema: Readonly<Record<string, unknown>>;
+    canonical_payload: string;
+    sha256: string;
+    byte_length: number;
+}>;
+export type Hcs13SchemaVerificationV1 = Readonly<{
+    status: "pass" | "fail";
+    reason_code: string | null;
+    reference: Hcs13ReferenceV1 | null;
+    sha256: string | null;
+    /** Compares only against an independently supplied SHA-256 expectation. */
+    checksum_match: "match" | "mismatch" | "not_checked";
+}>;
+export declare function buildHcs13ReferenceV1(registry_topic_id: unknown, sequence_number: unknown): string;
+export declare function parseHcs13ReferenceV1(value: unknown): Hcs13ReferenceV1;
+export declare function finalizeHcs13SchemaV1(value: unknown): Hcs13SchemaV1;
+export declare function parseHcs13SchemaV1(value: Uint8Array | string): Hcs13SchemaV1;
+/** Offline structure/digest check. A 'pass' without an expected checksum is not
+ * an independent schema-publication or registry-validation claim.
+ */
+export declare function verifyHcs13SchemaV1(input: Readonly<{
+    reference: unknown;
+    schema: Uint8Array | string;
+    expected_sha256?: string | null;
+    expected_registry_topic_id?: string | null;
+    expected_sequence_number?: number | null;
+}>): Hcs13SchemaVerificationV1;
+//# sourceMappingURL=hcs13V1.d.ts.map

package/dist/standards/hcs/hcs13V1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcs13V1.d.ts","sourceRoot":"","sources":["../../../src/standards/hcs/hcs13V1.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,yBAAyB,QAAa,CAAC;AAMpD,qBAAa,YAAa,SAAQ,KAAK;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAClC;AAYD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAC7G,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AACpJ,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2EAA2E;IAC3E,cAAc,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;CACtD,CAAC,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,GAAG,MAAM,CAElG;AACD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAKtE;AAsBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAA4B;AAChG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,aAAa,CAU5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0BAA0B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C,CAAC,GAAG,yBAAyB,CA6B7B"}

package/dist/standards/hcs/hcs13V1.js

@@ -0,0 +1,114 @@
+/** Pinned HCS-13 Draft: exact historical schema refs and offline canonical digest.
+ * Registry and HCS-1 content must be resolved independently by a separate adapter.
+ * JSON Schema semantic evaluation is NOT performed here.
+ */
+import { createHash } from "node:crypto";
+import { canonicalHcsJsonV1, cloneHcsJsonV1, HcsJsonV1Error, parseStrictHcsJsonV1 } from "./jsonCanonicalV1.js";
+export const MAX_HCS13_V1_SCHEMA_BYTES = 512 * 1024;
+const RAW_SCHEMA_BYTES = MAX_HCS13_V1_SCHEMA_BYTES + 64 * 1024;
+const TOPIC = /^0\.0\.[0-9]+$/;
+const REFERENCE = /^hcs:\/\/13\/(0\.0\.[0-9]+)#([1-9][0-9]*)$/;
+const SHA256 = /^[0-9a-f]{64}$/;
+export class Hcs13V1Error extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+        this.name = "Hcs13V1Error";
+    }
+}
+function fail(code) { throw new Hcs13V1Error(code); }
+function topicId(value) {
+    if (typeof value !== "string" || !TOPIC.test(value.trim()))
+        return fail("HCS13_TOPIC_INVALID");
+    return value.trim();
+}
+function sequence(value) {
+    const number = Number(value);
+    if (value == null || value === "" || !Number.isSafeInteger(number) || number < 1)
+        return fail("HCS13_SEQUENCE_INVALID");
+    return number;
+}
+export function buildHcs13ReferenceV1(registry_topic_id, sequence_number) {
+    return `hcs://13/${topicId(registry_topic_id)}#${sequence(sequence_number)}`;
+}
+export function parseHcs13ReferenceV1(value) {
+    const match = typeof value === "string" ? REFERENCE.exec(value.trim()) : null;
+    if (!match)
+        return fail("HCS13_REF_INVALID");
+    const number = sequence(match[2]);
+    return Object.freeze({ ref: `hcs://13/${match[1]}#${number}`, registry_topic_id: match[1], sequence_number: number });
+}
+function finalize(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value) ||
+        ![null, Object.prototype].includes(Object.getPrototypeOf(value))) {
+        return fail("HCS13_SCHEMA_INVALID");
+    }
+    const schema = value;
+    if (schema.$schema != null && typeof schema.$schema !== "string")
+        return fail("HCS13_SCHEMA_INVALID");
+    let canonical;
+    try {
+        canonical = canonicalHcsJsonV1(schema, MAX_HCS13_V1_SCHEMA_BYTES);
+    }
+    catch (error) {
+        if (error instanceof HcsJsonV1Error) {
+            return fail(error.code === "JSON_TOO_LARGE" ? "HCS13_SCHEMA_TOO_LARGE" : "HCS13_CANONICALIZATION_FAILED");
+        }
+        throw error;
+    }
+    const bytes = Buffer.from(canonical, "utf8");
+    return Object.freeze({ schema: cloneHcsJsonV1(schema), canonical_payload: canonical,
+        sha256: createHash("sha256").update(bytes).digest("hex"), byte_length: bytes.byteLength });
+}
+export function finalizeHcs13SchemaV1(value) { return finalize(value); }
+export function parseHcs13SchemaV1(value) {
+    let document;
+    try {
+        document = parseStrictHcsJsonV1(value, RAW_SCHEMA_BYTES);
+    }
+    catch (error) {
+        if (error instanceof HcsJsonV1Error) {
+            return fail(error.code === "JSON_TOO_LARGE" ? "HCS13_SCHEMA_TOO_LARGE" : "HCS13_SCHEMA_JSON_INVALID");
+        }
+        throw error;
+    }
+    return finalize(document);
+}
+/** Offline structure/digest check. A 'pass' without an expected checksum is not
+ * an independent schema-publication or registry-validation claim.
+ */
+export function verifyHcs13SchemaV1(input) {
+    let reference = null;
+    let sha256 = null;
+    let checksumMatch = "not_checked";
+    const result = (status, reason) => Object.freeze({ status, reason_code: reason, reference, sha256, checksum_match: checksumMatch });
+    try {
+        if (!input || typeof input !== "object")
+            return fail("HCS13_INPUT_INVALID");
+        reference = parseHcs13ReferenceV1(input.reference);
+        if (input.expected_registry_topic_id != null && topicId(input.expected_registry_topic_id) !== reference.registry_topic_id) {
+            return fail("HCS13_REGISTRY_MISMATCH");
+        }
+        if (input.expected_sequence_number != null && sequence(input.expected_sequence_number) !== reference.sequence_number) {
+            return fail("HCS13_SEQUENCE_MISMATCH");
+        }
+        const document = parseHcs13SchemaV1(input.schema);
+        sha256 = document.sha256;
+        if (input.expected_sha256 != null) {
+            if (typeof input.expected_sha256 !== "string" || !SHA256.test(input.expected_sha256)) {
+                return fail("HCS13_EXPECTED_CHECKSUM_INVALID");
+            }
+            checksumMatch = input.expected_sha256 === sha256 ? "match" : "mismatch";
+            if (checksumMatch === "mismatch")
+                return fail("HCS13_CHECKSUM_MISMATCH");
+        }
+        return result("pass", null);
+    }
+    catch (error) {
+        if (error instanceof Hcs13V1Error)
+            return result("fail", error.code);
+        throw error;
+    }
+}
+//# sourceMappingURL=hcs13V1.js.map

package/dist/standards/hcs/hcs13V1.js.map

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

package/dist/standards/hcs/hcs14V1.d.ts

@@ -0,0 +1,35 @@
+declare const ORDER: readonly ["uid", "registry", "proto", "nativeId", "domain", "src"];
+type Parameter = (typeof ORDER)[number];
+export type Hcs14DidUaidV1 = Readonly<{
+    uaid: string;
+    target: "did";
+    id: string;
+    params: Readonly<Partial<Record<Parameter, string>>>;
+}>;
+export type Hcs14BindingV1Result = Readonly<{
+    status: "pass" | "fail";
+    reason_code: string | null;
+    /** Consistency of supplied values only; NOT DID controller authentication. */
+    binding: Hcs14DidUaidV1 | null;
+}>;
+export declare class Hcs14V1Error extends Error {
+    readonly code: string;
+    constructor(code: string);
+}
+export declare function parseHcs14DidUaidV1(value: unknown): Hcs14DidUaidV1;
+/** Build a deterministic UAID for supplied DID material; this does not issue an identity. */
+export declare function buildHcs14DidUaidV1(input: Readonly<{
+    base_did: string;
+    uid?: string;
+    registry?: string;
+    proto: string;
+    native_id: string;
+    domain?: string | null;
+}>): Hcs14DidUaidV1;
+/** Compare against a separately supplied base DID. This does not resolve or authenticate it. */
+export declare function verifyHcs14DidBindingV1(input: Readonly<{
+    uaid: unknown;
+    base_did: unknown;
+}>): Hcs14BindingV1Result;
+export {};
+//# sourceMappingURL=hcs14V1.d.ts.map

package/dist/standards/hcs/hcs14V1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hcs14V1.d.ts","sourceRoot":"","sources":["../../../src/standards/hcs/hcs14V1.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,KAAK,oEAAqE,CAAC;AAEjF,KAAK,SAAS,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AACxC,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACtD,CAAC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,8EAA8E;IAC9E,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;CAChC,CAAC,CAAC;AACH,qBAAa,YAAa,SAAQ,KAAK;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAClC;AA0CD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAoClE;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7G,CAAC,GAAG,cAAc,CAWlB;AAED,gGAAgG;AAChG,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,oBAAoB,CAoBnH"}