@veraanchor/verifier 0.0.0-stage → 0.1.0

package/dist/standards/hcs/hcs14V1.js

@@ -0,0 +1,168 @@
+/** Pinned HCS-14 Draft: deterministic DID-backed UAID checks (uaid:did only).
+ *  Structural consistency does not authenticate DID control or a Hedera account.
+ */
+const DID = /^did:([a-z0-9]+):(.+)$/;
+const PREFIX = "uaid:did:";
+const ORDER = ["uid", "registry", "proto", "nativeId", "domain", "src"];
+const ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+export class Hcs14V1Error extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+        this.name = "Hcs14V1Error";
+    }
+}
+function fail(code) { throw new Hcs14V1Error(code); }
+function text(value, _name, max) {
+    if (typeof value !== "string" || !value.trim() || value.trim().length > max ||
+        /[\u0000-\u001f\u007f;]/.test(value))
+        return fail("HCS14_FIELD_INVALID");
+    return value.trim();
+}
+function didParts(value) {
+    if (typeof value !== "string")
+        return fail("HCS14_DID_INVALID");
+    const did = value.trim();
+    const match = DID.exec(did);
+    if (!match)
+        return fail("HCS14_DID_INVALID");
+    const methodSpecificId = match[2];
+    const cut = methodSpecificId.search(/[;?#]/);
+    const id = cut < 0 ? methodSpecificId : methodSpecificId.slice(0, cut);
+    if (!id || id.includes(";"))
+        return fail("HCS14_DID_ID_INVALID");
+    return { did, id, sanitized: cut >= 0 };
+}
+function base58encode(bytes) {
+    let leading = 0;
+    while (leading < bytes.length && bytes[leading] === 0)
+        leading++;
+    let n = 0n;
+    for (const value of bytes)
+        n = (n << 8n) + BigInt(value);
+    let out = "";
+    while (n > 0n) {
+        out = ALPHABET[Number(n % 58n)] + out;
+        n /= 58n;
+    }
+    return `z${"1".repeat(leading)}${out || (leading ? "" : "1")}`;
+}
+function base58decode(input) {
+    if (!/^z[1-9A-HJ-NP-Za-km-z]+$/.test(input))
+        return fail("HCS14_SRC_INVALID");
+    const encoded = input.slice(1);
+    let leading = 0;
+    while (leading < encoded.length && encoded[leading] === "1")
+        leading++;
+    let n = 0n;
+    for (const c of encoded) {
+        const digit = ALPHABET.indexOf(c);
+        if (digit < 0)
+            return fail("HCS14_SRC_INVALID");
+        n = n * 58n + BigInt(digit);
+    }
+    const reversed = [];
+    while (n > 0n) {
+        reversed.push(Number(n & 255n));
+        n >>= 8n;
+    }
+    reversed.reverse();
+    const result = Uint8Array.from([...Array(leading).fill(0), ...reversed]);
+    if (base58encode(result) !== input)
+        return fail("HCS14_SRC_INVALID");
+    return result;
+}
+export function parseHcs14DidUaidV1(value) {
+    if (typeof value !== "string")
+        return fail("HCS14_UAID_INVALID");
+    if (value.length > 8192)
+        return fail("HCS14_UAID_INVALID");
+    const uaid = value.trim();
+    if (!uaid.startsWith(PREFIX)) {
+        return fail(uaid.startsWith("uaid:aid:") ? "HCS14_TARGET_UNSUPPORTED" : "HCS14_UAID_INVALID");
+    }
+    if (uaid.length > 8192)
+        return fail("HCS14_UAID_INVALID");
+    const body = uaid.slice(PREFIX.length);
+    const pos = body.indexOf(";");
+    if (pos < 1)
+        return fail("HCS14_UAID_INVALID");
+    const id = body.slice(0, pos);
+    if (/[\u0000-\u001f\u007f]/.test(id))
+        return fail("HCS14_UAID_INVALID");
+    const rawParams = body.slice(pos + 1).split(";");
+    const params = {};
+    const seen = [];
+    for (const entry of rawParams) {
+        const eq = entry.indexOf("=");
+        if (eq <= 0)
+            return fail("HCS14_PARAMETER_INVALID");
+        const key = entry.slice(0, eq);
+        if (!ORDER.includes(key) || Object.prototype.hasOwnProperty.call(params, key)) {
+            return fail("HCS14_PARAMETER_INVALID");
+        }
+        // The pinned parser accepts up to 512 chars for every parameter except nativeId.
+        const limit = key === "nativeId" ? 2048 : 512;
+        const value = text(entry.slice(eq + 1), key, limit);
+        params[key] = value;
+        seen.push(key);
+    }
+    if (seen.join("\0") !== ORDER.filter((key) => params[key] !== undefined).join("\0")) {
+        return fail("HCS14_PARAMETER_ORDER_INVALID");
+    }
+    for (const key of ["uid", "registry", "proto", "nativeId"]) {
+        if (!params[key])
+            return fail("HCS14_PARAMETER_MISSING");
+    }
+    return Object.freeze({ uaid, target: "did", id, params: Object.freeze(params) });
+}
+/** Build a deterministic UAID for supplied DID material; this does not issue an identity. */
+export function buildHcs14DidUaidV1(input) {
+    const did = didParts(input.base_did);
+    const params = {
+        uid: text(input.uid ?? "0", "uid", 256),
+        registry: text(input.registry ?? "self", "registry", 128),
+        proto: text(input.proto, "proto", 64),
+        nativeId: text(input.native_id, "nativeId", 2048),
+    };
+    if (input.domain != null && input.domain.trim())
+        params.domain = text(input.domain, "domain", 253);
+    if (did.sanitized)
+        params.src = base58encode(Buffer.from(did.did, "utf8"));
+    return parseHcs14DidUaidV1(`${PREFIX}${did.id};${ORDER.filter((k) => params[k] !== undefined).map((k) => `${k}=${params[k]}`).join(";")}`);
+}
+/** Compare against a separately supplied base DID. This does not resolve or authenticate it. */
+export function verifyHcs14DidBindingV1(input) {
+    let binding = null;
+    try {
+        binding = parseHcs14DidUaidV1(input?.uaid);
+        const did = didParts(input?.base_did);
+        if (binding.id !== did.id)
+            return fail("HCS14_DID_BINDING_MISMATCH");
+        const src = binding.params.src;
+        if (did.sanitized) {
+            if (!src)
+                return fail("HCS14_SRC_REQUIRED");
+            const bytes = base58decode(src);
+            let recovered;
+            try {
+                recovered = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+            }
+            catch {
+                return fail("HCS14_SRC_INVALID");
+            }
+            if (recovered !== did.did)
+                return fail("HCS14_SRC_MISMATCH");
+        }
+        else if (src)
+            return fail("HCS14_SRC_UNEXPECTED");
+        return Object.freeze({ status: "pass", reason_code: null, binding });
+    }
+    catch (error) {
+        if (error instanceof Hcs14V1Error)
+            return Object.freeze({ status: "fail", reason_code: error.code, binding });
+        throw error;
+    }
+}
+//# sourceMappingURL=hcs14V1.js.map

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

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

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

@@ -0,0 +1,30 @@
+export declare const MAX_HCS1_V1_FILE_BYTES: number;
+export declare const MAX_HCS1_V1_CHUNKS = 4096;
+export type Hcs1V1ContentInput = Readonly<{
+    /** Supplied topic memo; not independently authenticated in offline mode. */
+    memo: unknown;
+    /** Original HCS message bytes containing {o,c} chunk JSON. */
+    messages: readonly Uint8Array[];
+    /** Optional independently established checksum. */
+    expected_sha256?: string | null;
+}>;
+export type Hcs1V1ContentOptions = Readonly<{
+    max_file_bytes?: number;
+    /** Explicit optional runtime adapter; never obtained from untrusted evidence. */
+    decompress_zstd?: (compressed: Uint8Array, maxOutputBytes: number) => Uint8Array | Promise<Uint8Array>;
+}>;
+export type Hcs1V1ContentResult = Readonly<{
+    status: "pass" | "fail" | "unsupported";
+    reason_code: string | null;
+    sha256: string | null;
+    mime_type: string | null;
+    chunk_count: number;
+    /** Returned only after the checksum is recomputed and matches all expectations. */
+    bytes: Uint8Array | null;
+}>;
+export declare function parseHcs1ReferenceV1(value: unknown): Readonly<{
+    reference: string;
+    topic_id: string;
+}>;
+export declare function verifyHcs1ContentV1(input: Hcs1V1ContentInput, options?: Hcs1V1ContentOptions): Promise<Hcs1V1ContentResult>;
+//# sourceMappingURL=hcs1V1.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hcs1V1.d.ts","sourceRoot":"","sources":["../../../src/standards/hcs/hcs1V1.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AACtD,eAAO,MAAM,kBAAkB,OAAO,CAAC;AASvC,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,4EAA4E;IAC5E,IAAI,EAAE,OAAO,CAAC;IACd,8DAA8D;IAC9D,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IAChC,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACxG,CAAC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;IACxC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1B,CAAC,CAAC;AAMH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAItG;AAoCD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CA+D9B"}

package/dist/standards/hcs/hcs1V1.js

@@ -0,0 +1,140 @@
+/** Pinned HCS-1 zstd/base64 integrity verification; offline, with no network I/O. */
+import { createHash } from "node:crypto";
+import * as zlib from "node:zlib";
+export const MAX_HCS1_V1_FILE_BYTES = 8 * 1024 * 1024;
+export const MAX_HCS1_V1_CHUNKS = 4096;
+const MAX_MESSAGE_BYTES = 1024;
+const MAX_COMPRESSED_BYTES = MAX_HCS1_V1_CHUNKS * MAX_MESSAGE_BYTES;
+const REF = /^hcs:\/\/1\/(0\.0\.[0-9]+)$/;
+const MEMO = /^([0-9a-f]{64}):zstd:base64$/;
+const SHA256 = /^[0-9a-f]{64}$/;
+const MIME = /^[A-Za-z0-9][A-Za-z0-9!#$&^_.+\-/]{0,126}$/;
+const BASE64 = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+class Hcs1Failure extends Error {
+    code;
+    unsupported;
+    constructor(code, unsupported = false) {
+        super(code);
+        this.code = code;
+        this.unsupported = unsupported;
+    }
+}
+export function parseHcs1ReferenceV1(value) {
+    const match = typeof value === "string" ? REF.exec(value) : null;
+    if (!match)
+        throw new TypeError("HCS1_REFERENCE_INVALID");
+    return Object.freeze({ reference: value, topic_id: match[1] });
+}
+function failed(code, count = 0, unsupported = false) {
+    return Object.freeze({ status: unsupported ? "unsupported" : "fail",
+        reason_code: code, sha256: null, mime_type: null, chunk_count: count, bytes: null });
+}
+function boundFileBytes(options) {
+    const n = options.max_file_bytes ?? MAX_HCS1_V1_FILE_BYTES;
+    if (!Number.isSafeInteger(n) || n < 1 || n > MAX_HCS1_V1_FILE_BYTES) {
+        throw new TypeError("HCS1_FILE_LIMIT_INVALID");
+    }
+    return n;
+}
+async function decompress(compressed, limit, options) {
+    if (options.decompress_zstd) {
+        const out = await options.decompress_zstd(new Uint8Array(compressed), limit);
+        if (!(out instanceof Uint8Array))
+            throw new Hcs1Failure("HCS1_DECOMPRESSION_INVALID");
+        if (out.byteLength > limit)
+            throw new Hcs1Failure("HCS1_FILE_TOO_LARGE");
+        return Buffer.from(out);
+    }
+    const fn = zlib.zstdDecompressSync;
+    if (typeof fn !== "function")
+        throw new Hcs1Failure("HCS1_ZSTD_UNAVAILABLE", true);
+    try {
+        return fn(compressed, { maxOutputLength: limit });
+    }
+    catch (error) {
+        if (error?.code === "ERR_BUFFER_TOO_LARGE") {
+            throw new Hcs1Failure("HCS1_FILE_TOO_LARGE");
+        }
+        throw new Hcs1Failure("HCS1_DECOMPRESSION_INVALID");
+    }
+}
+export async function verifyHcs1ContentV1(input, options = {}) {
+    const limit = boundFileBytes(options);
+    const count = Array.isArray(input?.messages) ? input.messages.length : 0;
+    try {
+        const memo = typeof input?.memo === "string" ? MEMO.exec(input.memo) : null;
+        if (!memo)
+            throw new Hcs1Failure("HCS1_MEMO_INVALID");
+        const expected = input.expected_sha256 == null ? null :
+            typeof input.expected_sha256 === "string" ? input.expected_sha256.toLowerCase() : "";
+        if (expected !== null && !SHA256.test(expected))
+            throw new Hcs1Failure("HCS1_EXPECTED_CHECKSUM_INVALID");
+        if (!Array.isArray(input.messages) || count < 1 || count > MAX_HCS1_V1_CHUNKS) {
+            throw new Hcs1Failure("HCS1_CHUNKS_INVALID");
+        }
+        const byOrder = new Map();
+        for (const message of input.messages) {
+            if (!(message instanceof Uint8Array) || message.byteLength > MAX_MESSAGE_BYTES || !message.byteLength) {
+                throw new Hcs1Failure("HCS1_MESSAGE_INVALID");
+            }
+            let chunk;
+            try {
+                chunk = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(message));
+            }
+            catch {
+                throw new Hcs1Failure("HCS1_CHUNK_INVALID");
+            }
+            if (!chunk || typeof chunk !== "object" || Array.isArray(chunk)) {
+                throw new Hcs1Failure("HCS1_CHUNK_INVALID");
+            }
+            const obj = chunk;
+            if (Object.keys(obj).sort().join("\0") !== "c\0o" ||
+                !Number.isSafeInteger(obj.o) || obj.o < 0 ||
+                typeof obj.c !== "string" || !obj.c) {
+                throw new Hcs1Failure("HCS1_CHUNK_INVALID");
+            }
+            if (byOrder.has(obj.o))
+                throw new Hcs1Failure("HCS1_CHUNK_DUPLICATE");
+            byOrder.set(obj.o, obj.c);
+        }
+        const parts = [];
+        for (let i = 0; i < count; i += 1) {
+            const chunk = byOrder.get(i);
+            if (chunk === undefined)
+                throw new Hcs1Failure("HCS1_CHUNK_GAP");
+            parts.push(chunk);
+        }
+        const prefix = /^data:([^;]+);base64,/.exec(parts[0]);
+        if (!prefix || !MIME.test(prefix[1]))
+            throw new Hcs1Failure("HCS1_PREFIX_INVALID");
+        parts[0] = parts[0].slice(prefix[0].length);
+        const encoded = parts.join("");
+        if (!encoded || encoded.length > Math.ceil(MAX_COMPRESSED_BYTES * 4 / 3) + 4 ||
+            encoded.length % 4 !== 0 || !BASE64.test(encoded)) {
+            throw new Hcs1Failure("HCS1_BASE64_INVALID");
+        }
+        const compressed = Buffer.from(encoded, "base64");
+        if (compressed.toString("base64") !== encoded || compressed.byteLength > MAX_COMPRESSED_BYTES) {
+            throw new Hcs1Failure("HCS1_BASE64_INVALID");
+        }
+        const bytes = await decompress(compressed, limit, options);
+        if (!bytes.byteLength || bytes.byteLength > limit)
+            throw new Hcs1Failure("HCS1_FILE_TOO_LARGE");
+        const actual = createHash("sha256").update(bytes).digest("hex");
+        if (actual !== memo[1])
+            throw new Hcs1Failure("HCS1_CHECKSUM_MISMATCH");
+        if (expected && actual !== expected)
+            throw new Hcs1Failure("HCS1_EXPECTED_CHECKSUM_MISMATCH");
+        return Object.freeze({ status: "pass", reason_code: null, sha256: actual,
+            mime_type: prefix[1], chunk_count: count, bytes: new Uint8Array(bytes) });
+    }
+    catch (error) {
+        if (error instanceof Hcs1Failure)
+            return failed(error.code, count, error.unsupported);
+        // An explicitly supplied decompressor may throw on malformed bytes.
+        if (options.decompress_zstd)
+            return failed("HCS1_DECOMPRESSION_INVALID", count);
+        throw error;
+    }
+}
+//# sourceMappingURL=hcs1V1.js.map

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

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

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

@@ -0,0 +1,58 @@
+export declare const MAX_HCS26_V1_MANIFEST_BYTES: number;
+export declare class Hcs26V1Error extends Error {
+    readonly code: string;
+    constructor(code: string);
+}
+export type Hcs26MemoV1 = Readonly<{
+    memo: string;
+    indexed: boolean;
+    ttl: number;
+    type: "discovery" | "version";
+    type_code: 0 | 1;
+}>;
+export declare function parseHcs26MemoV1(value: unknown): Hcs26MemoV1;
+/** Supplied historical raw registry message; not a read of current registry state. */
+export declare function parseHcs26DiscoveryRegisterV1(raw: string | Uint8Array): Readonly<Record<string, unknown>>;
+export declare function parseHcs26DiscoveryUpdateV1(raw: string | Uint8Array): Readonly<Record<string, unknown>>;
+export type Hcs26VersionRegisterV1 = Readonly<{
+    p: "hcs-26";
+    op: "register";
+    skill_uid: number;
+    version: string;
+    t_id: string;
+    checksum: string;
+    status: "active" | "deprecated" | "yanked";
+    m?: string;
+}>;
+export declare function parseHcs26VersionRegisterV1(raw: string | Uint8Array): Hcs26VersionRegisterV1;
+export type Hcs26SkillManifestV1 = Readonly<{
+    manifest: Readonly<Record<string, unknown>>;
+    canonical_payload: string;
+    sha256: string;
+    byte_length: number;
+}>;
+export declare function finalizeHcs26SkillManifestV1(value: unknown): Hcs26SkillManifestV1;
+export declare function parseHcs26SkillManifestV1(raw: Uint8Array | string): Hcs26SkillManifestV1;
+export type Hcs26VersionVerificationV1 = Readonly<{
+    status: "pass" | "fail";
+    reason_code: string | null;
+    skill_uid: number | null;
+    version: string | null;
+    manifest_topic_id: string | null;
+    checksum_match: "match" | "mismatch" | "not_checked";
+    /** Version state is recorded as historical register state, not current policy. */
+    version_status: Hcs26VersionRegisterV1["status"] | null;
+    sha256: string | null;
+}>;
+/** Cross-check a supplied historical version register against actual SKILL.json
+ * canonical content. This does not authenticate where the register came from.
+ */
+export declare function verifyHcs26SkillVersionV1(input: Readonly<{
+    version_register: string | Uint8Array;
+    manifest: string | Uint8Array;
+    expected_skill_uid?: number | null;
+    expected_version?: string | null;
+    expected_manifest_topic_id?: string | null;
+    expected_sha256?: string | null;
+}>): Hcs26VersionVerificationV1;
+//# sourceMappingURL=hcs26V1.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hcs26V1.d.ts","sourceRoot":"","sources":["../../../src/standards/hcs/hcs26V1.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,2BAA2B,QAAa,CAAC;AAatD,qBAAa,YAAa,SAAQ,KAAK;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAClC;AA+GD,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAA;CAAE,CAAC,CAAC;AACrI,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAQ5D;AAED,sFAAsF;AACtF,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAQzG;AACD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUvG;AACD,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,CAAC,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAChE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAC;CACxF,CAAC,CAAC;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,sBAAsB,CAW5F;AAkBD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,QAAQ,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,CAAC;CAC7G,CAAC,CAAC;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CA2CjF;AACD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,oBAAoB,CAUxF;AAED,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;IACrD,kFAAkF;IAClF,cAAc,EAAE,sBAAsB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACxD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC,CAAC;AACH;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC;IACxD,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC;IACtC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,0BAA0B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC,GAAG,0BAA0B,CAyB9B"}