@flarenetwork/flare-periphery-contract-artifacts 0.1.1 → 0.1.2

package/dist/coston/StateConnector/libs/ts/config-types.d.ts

@@ -0,0 +1,143 @@
+/**
+ * ABI definition fields for request, response and proof of an attestation type.
+ */
+export interface ABIDefinitions {
+    /**
+     * JSON ABI definition for attestation type request
+     */
+    requestAbi: any;
+    /**
+     * JSON ABI definition for attestation type response
+     */
+    responseAbi: any;
+    /**
+     * JSON ABI definition for attestation type proof
+     */
+    proofAbi: any;
+}
+/**
+ * Metadata for basic and ABI configs for an attestation type.
+ */
+export interface TypeRecord extends ABIDefinitions {
+    /**
+     * Attestation type name. Must be unique and in PascalCase (also known as UpperCamelCase, hence CamelCase with the first letter capitalized).
+     */
+    name: string;
+    /**
+     * Full comment for the attestation type as provided in the Solidity definition.
+     */
+    fullComment: string;
+    /**
+     * Description of the attestation type. Used also in the generated documentation.
+     */
+    description: string;
+    /**
+     * Comma separated list of supported sources for the attestation type. The strings defining types are community defined.
+     * Currently, the following are supported: BTC, DOGE, XRP, ETH
+     */
+    supported: string[];
+    /**
+     * Text describing the attestation type verification rules. In Markdown format.
+     */
+    verification: string;
+    /**
+     * The description of how lowest used timestamp is obtained from the attestation response.
+     * Usually a field name.
+     */
+    lut: string;
+    /**
+     * Metadata about the struct describing attestation request.
+     */
+    request: StructRecord;
+    /**
+     * Metadata about the struct describing attestation response.
+     */
+    response: StructRecord;
+    /**
+     * Metadata about the struct describing attestation proof.
+     */
+    proof: StructRecord;
+    /**
+     * Metadata about the struct describing attestation request body.
+     */
+    requestBody: StructRecord;
+    /**
+     * Metadata about the struct describing attestation response body.
+     */
+    responseBody: StructRecord;
+    /**
+     * List of metadata objects describing structs used in attestation request.
+     */
+    requestStructs: StructRecord[];
+    /**
+     * List of metadata objects describing structs used in attestation response.
+     */
+    responseStructs: StructRecord[];
+}
+/**
+ * Metadata for a struct parameter from a Solidity definition of attestation types.
+ */
+export interface ParamRecord {
+    /**
+     * Field name.
+     */
+    name: string;
+    /**
+     * Field type as defined in Solidity.
+     */
+    type: string;
+    /**
+     * Short field type (omitting position prefixes for structs)
+     */
+    typeSimple?: string;
+    /**
+     * Field description. Possibly multiline.
+     */
+    comment: string;
+}
+/**
+ * Metadata for a struct from a Solidity definition of attestation types.
+ */
+export interface StructRecord {
+    /**
+     * Struct name.
+     */
+    name: string;
+    /**
+     * Full comment for the struct as provided in the Solidity definition.
+     */
+    fullComment: string;
+    /**
+     * Struct description. Possibly multiline, can use Markdown.
+     */
+    description: string;
+    /**
+     * Additional markdown text to be used above the struct fields description in documentation.
+     */
+    above?: string;
+    /**
+     * Additional markdown text to be used below the struct fields description in documentation.
+     */
+    below?: string;
+    /**
+     * List of metadata objects describing struct fields.
+     */
+    params: ParamRecord[];
+}
+export interface DataSource {
+    name: string;
+    description: string;
+}
+export interface Protocol {
+    name: string;
+    description: string;
+}
+export interface AttestationTypeProtocolSupport {
+    attestationType: string;
+    supportedDataSources: string[];
+}
+export interface ProtocolSupport {
+    protocol: string;
+    supported: AttestationTypeProtocolSupport[];
+}
+//# sourceMappingURL=config-types.d.ts.map

package/dist/coston/StateConnector/libs/ts/config-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.d.ts","sourceRoot":"","sources":["../../../../../coston/StateConnector/libs/ts/config-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,UAAU,EAAE,GAAG,CAAC;IAChB;;OAEG;IACH,WAAW,EAAE,GAAG,CAAC;IACjB;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAC9C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAC;IACvB;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IACpB;;OAEG;IACH,WAAW,EAAE,YAAY,CAAC;IAC1B;;OAEG;IACH,YAAY,EAAE,YAAY,CAAC;IAC3B;;OAEG;IACH,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B;;OAEG;IACH,eAAe,EAAE,YAAY,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAClC;AACD,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,8BAA8B,EAAE,CAAC;CAC/C"}

package/dist/coston/StateConnector/libs/ts/config-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config-types.js.map

package/dist/coston/StateConnector/libs/ts/config-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.js","sourceRoot":"","sources":["../../../../../coston/StateConnector/libs/ts/config-types.ts"],"names":[],"mappings":""}

package/dist/coston/StateConnector/libs/ts/interfaces.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Generic interface for the request of an attestation request.
+ */
+export interface ARBase {
+    attestationType: string;
+    sourceId: string;
+    messageIntegrityCode?: string;
+    requestBody: any;
+}
+/**
+ * Generic interface for the response of an attestation request.
+ */
+export interface ARESBase {
+    attestationType: string;
+    sourceId: string;
+    votingRound: string;
+    lowestUsedTimestamp: string;
+    requestBody: any;
+    responseBody: any;
+}
+/**
+ * Generic interface for example data usually randomly generated for testing purposes and examples.
+ */
+export interface ExampleData<RNM, REQ, RES> {
+    requestNoMic: RNM;
+    request: REQ;
+    response: RES;
+    messageIntegrityCode: string;
+    encodedRequestZeroMic: string;
+    encodedRequest: string;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/coston/StateConnector/libs/ts/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../../coston/StateConnector/libs/ts/interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC;IACjB,YAAY,EAAE,GAAG,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG;IACtC,YAAY,EAAE,GAAG,CAAC;IAClB,OAAO,EAAE,GAAG,CAAC;IACb,QAAQ,EAAE,GAAG,CAAC;IACd,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CAC1B"}

package/dist/coston/StateConnector/libs/ts/interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/coston/StateConnector/libs/ts/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../../coston/StateConnector/libs/ts/interfaces.ts"],"names":[],"mappings":""}

package/dist/coston/StateConnector/libs/ts/random.d.ts

@@ -0,0 +1,9 @@
+export declare function seededRandHex(n: number, seed?: string): string;
+/**
+ * Helper random value generator for Solidity type values used in in randomized attestation requests or responses.
+ * Primarily used for testing
+ * @param typeName solidity type (e.g. uint256)
+ * @returns
+ */
+export declare function randSol(typeName: string, seed?: string): string | boolean;
+//# sourceMappingURL=random.d.ts.map

package/dist/coston/StateConnector/libs/ts/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../../../../coston/StateConnector/libs/ts/random.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,SAAM,UAElD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,MAAM,GAAG,OAAO,CAyDtE"}

package/dist/coston/StateConnector/libs/ts/random.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randSol = exports.seededRandHex = void 0;
+const ethers_1 = require("ethers");
+function seededRandHex(n, seed = "0") {
+    return ethers_1.ethers.keccak256(ethers_1.ethers.toUtf8Bytes(seed)).slice(0, 2 + 2 * n);
+}
+exports.seededRandHex = seededRandHex;
+/**
+ * Helper random value generator for Solidity type values used in in randomized attestation requests or responses.
+ * Primarily used for testing
+ * @param typeName solidity type (e.g. uint256)
+ * @returns
+ */
+function randSol(typeName, seed = "0") {
+    let match = typeName.match(/^.+(\[(\d*)\])$/);
+    if (match) {
+        const brackets = match[1];
+        const value = parseInt(match[2]);
+        const typeOfArray = typeName.slice(0, -brackets.length);
+        if (!isNaN(value) || value === 0) {
+            return ("[" +
+                Array(value)
+                    .fill(0)
+                    .map(() => randSol(typeOfArray, seed))
+                    .join(", ") +
+                "]");
+        }
+        else {
+            const length = 3; // fixed length
+            return ("[" +
+                Array(length)
+                    .fill(0)
+                    .map(() => randSol(typeOfArray, seed))
+                    .join(", ") +
+                "]");
+        }
+    }
+    match = typeName.match(/^uint(\d+)$/);
+    if (match) {
+        return BigInt(seededRandHex(parseInt(match[1]) / 8, seed)).toString();
+    }
+    match = typeName.match(/^int(\d+)$/);
+    if (match) {
+        const val = seededRandHex(parseInt(match[1]) / 8, seed);
+        return BigInt("0x0" + val.slice(3)).toString();
+    }
+    if (typeName.match(/^bool$/)) {
+        return true;
+    }
+    match = typeName.match(/^bytes(\d+)$/);
+    if (match) {
+        return seededRandHex(parseInt(match[1]), seed);
+    }
+    if (typeName.match(/^address$/)) {
+        return seededRandHex(20, seed);
+    }
+    if (typeName.match(/^string$/)) {
+        return "Random string";
+    }
+    if (typeName.match(/^byte$/)) {
+        return seededRandHex(1, seed);
+    }
+    if (typeName.match(/^bytes$/)) {
+        return seededRandHex(30, seed);
+    }
+    throw new Error(`Unsupported type ${typeName}`);
+}
+exports.randSol = randSol;
+//# sourceMappingURL=random.js.map

package/dist/coston/StateConnector/libs/ts/random.js.map

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

package/dist/coston/StateConnector/libs/ts/utils.d.ts

@@ -0,0 +1,73 @@
+import { TypeRecord } from "./config-types";
+/**
+ * ABIFragment is a subset of ethers ABIFragment. It is used to define the ABI fragments
+ */
+export interface ABIFragment {
+    components?: ABIFragment[];
+    internalType: string;
+    name: string;
+    type: string;
+}
+export declare const DEFAULT_ATTESTATION_TYPE_CONFIGS_PATH = "./node_modules/@flarenetwork/flare-periphery-contract-artifacts/coston/StateConnector/configs/";
+export declare const MIC_SALT = "Flare";
+export declare const ZERO_BYTES_32: string;
+export declare const ZERO_BYTES_20: string;
+/**
+ * Checks if the type is one of the supported Solidity type names.
+ * Note: the checks for supported numbers N in 'intN', 'uintN' and 'bytesN' is not implemented. The function is safe only under assumption
+ * that the correct types supported by the Solidity compiler are used.
+ * @param type
+ * @returns
+ */
+export declare function isSupportedBasicSolidityType(type: string): boolean;
+/**
+ * Encodes attestation type name or source id as a 32-byte hex string.
+ * It takes the UTF-8 bytes of the name and pads them with zeros to 32 bytes.
+ * @param attestationTypeName
+ * @returns '0x'-prefixed hex string representing 32-bytes
+ */
+export declare function encodeAttestationName(attestationTypeName: string): string;
+/**
+ * Decodes attestation type name or source id from a 32-byte hex string.
+ * @param encoded Should be a '0x'-prefixed hex string representing exactly 32-bytes.
+ * @returns
+ */
+export declare function decodeAttestationName(encoded: string): string;
+/**
+ * Given a ABI decoded object (with tuples) based on the provided JSON ABI definition,
+ * it creates a possibly nested Javascript object compatible with the ABI definitions.
+ * The function assumes that the decoded objects matches the ABI. If this is not the case,
+ * function may behave in strange ways.
+ * This is auxiliary function not intended to be used directly.
+ * @param decoded
+ * @param abi
+ * @param ignoreArray parameter for recursion call when handling of arrays are needed.
+ * @returns
+ */
+export declare function remapABIParsedToObjects(decoded: any, abi: ABIFragment, ignoreArray?: boolean): any;
+/**
+ * Checks whether the struct objects are deep equal. Objects should match the ABI definition.
+ * @param struct1
+ * @param struct2
+ * @param abi
+ * @returns
+ */
+export declare function structsDeepEqual(struct1: any, struct2: any, abi: ABIFragment): boolean;
+/**
+ * Loader of the attestation type definition configs
+ * @returns a map from attestation types to definition configs
+ */
+export declare function readAttestationTypeConfigs(configsPath?: string): Map<string, TypeRecord>;
+/**
+ * Helper function serializing bigints to strings recursively.
+ * @param obj
+ * @returns
+ */
+export declare function serializeBigInts(obj: any): any;
+/**
+ * Find the package root than contains the directory.
+ * @param moduleDir the directory of a module, typically use `__dirname`
+ * @returns the directory of the modules's package root.
+ */
+export declare function findPackageRoot(moduleDir: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/coston/StateConnector/libs/ts/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../coston/StateConnector/libs/ts/utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,qCAAqC,mGAAmG,CAAA;AACrJ,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,aAAa,QAAgC,CAAC;AAC3D,eAAO,MAAM,aAAa,QAAgC,CAAC;AA+C3D;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUlE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,mBAAmB,EAAE,MAAM,UAYhE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,UAUpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,UAAQ,GAAG,GAAG,CA8BhG;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CA2DtF;AACD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,SAAwC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAQvH;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,OAOxC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,UAiBhD"}

package/dist/coston/StateConnector/libs/ts/utils.js

@@ -0,0 +1,282 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPackageRoot = exports.serializeBigInts = exports.readAttestationTypeConfigs = exports.structsDeepEqual = exports.remapABIParsedToObjects = exports.decodeAttestationName = exports.encodeAttestationName = exports.isSupportedBasicSolidityType = exports.ZERO_BYTES_20 = exports.ZERO_BYTES_32 = exports.MIC_SALT = exports.DEFAULT_ATTESTATION_TYPE_CONFIGS_PATH = void 0;
+const ethers_1 = require("ethers");
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+exports.DEFAULT_ATTESTATION_TYPE_CONFIGS_PATH = "./node_modules/@flarenetwork/flare-periphery-contract-artifacts/coston/StateConnector/configs/";
+exports.MIC_SALT = "Flare";
+exports.ZERO_BYTES_32 = ethers_1.ethers.zeroPadBytes("0x", 32);
+exports.ZERO_BYTES_20 = ethers_1.ethers.zeroPadBytes("0x", 20);
+/**
+ * Compares values of Solidity elementary types when represented in JSON.
+ * Checks the consistency of the types and the values.
+ * @param val1
+ * @param val2
+ * @param type
+ * @returns
+ */
+function compareElementaryTypes(val1, val2, type) {
+    if (type.match(/^u?int\d+$/)) {
+        // Input values could be number, BigInt or string representing decimal or hex (0x-prefixed).
+        if (typeof val1 === "number" || typeof val1 === "bigint" || typeof val1 === "string") {
+            // throws if the value is not parsable as a BigInt
+            return BigInt(val1) === BigInt(val2);
+        }
+        throw new Error(`Invalid values for type '${type}': ${val1}, ${val2}`);
+    }
+    if (type.match(/^bool$/)) {
+        // values must be true or false
+        if ((val1 === true || val1 === false) && (val2 === true || val2 === false)) {
+            return val1 === val2;
+        }
+        throw new Error(`Invalid values for type '${type}': ${val1}, ${val2}`);
+    }
+    if (type.match(/^bytes\d*$/) || type.match(/^byte$/) || type.match(/^address$/)) {
+        // Input values must be be string or hex (0x-prefixed)
+        if (typeof val1 === "string" && typeof val2 === "string") {
+            const lower1 = val1.toLowerCase();
+            const lower2 = val2.toLowerCase();
+            if (/^0x[0-9a-f]+$/i.test(lower1) && /^0x[0-9a-f]+$/i.test(lower2)) {
+                return lower1 === lower2;
+            }
+        }
+        throw new Error(`Invalid values for type '${type}': '${val1}', '${val2}'`);
+    }
+    if (type.match(/^string$/)) {
+        // Input values must be string
+        if (typeof val1 === "string" && typeof val2 === "string") {
+            return val1 === val2;
+        }
+        throw new Error(`Invalid values for type '${type}': '${val1}', '${val2}'`);
+    }
+    throw new Error(`Unknown or unsupported type '${type}'`);
+}
+/**
+ * Checks if the type is one of the supported Solidity type names.
+ * Note: the checks for supported numbers N in 'intN', 'uintN' and 'bytesN' is not implemented. The function is safe only under assumption
+ * that the correct types supported by the Solidity compiler are used.
+ * @param type
+ * @returns
+ */
+function isSupportedBasicSolidityType(type) {
+    //
+    return (!!type.match(/^u?int\d+$/) ||
+        !!type.match(/^bool$/) ||
+        !!type.match(/^bytes\d*$/) ||
+        !!type.match(/^byte$/) ||
+        !!type.match(/^address$/) ||
+        !!type.match(/^string$/));
+}
+exports.isSupportedBasicSolidityType = isSupportedBasicSolidityType;
+/**
+ * Encodes attestation type name or source id as a 32-byte hex string.
+ * It takes the UTF-8 bytes of the name and pads them with zeros to 32 bytes.
+ * @param attestationTypeName
+ * @returns '0x'-prefixed hex string representing 32-bytes
+ */
+function encodeAttestationName(attestationTypeName) {
+    if (typeof attestationTypeName !== "string") {
+        throw new Error(`Attestation type name must be a string. Provided value ${attestationTypeName}`);
+    }
+    if (attestationTypeName.startsWith("0x") || attestationTypeName.startsWith("0X")) {
+        throw new Error(`Attestation type name must not start with '0x'. Provided value '${attestationTypeName}'. Possible confusion with hex encoding.`);
+    }
+    const bytes = ethers_1.ethers.toUtf8Bytes(attestationTypeName);
+    if (bytes.length > 32) {
+        throw new Error(`Attestation type name ${attestationTypeName} is too long`);
+    }
+    return ethers_1.ethers.zeroPadBytes(bytes, 32);
+}
+exports.encodeAttestationName = encodeAttestationName;
+/**
+ * Decodes attestation type name or source id from a 32-byte hex string.
+ * @param encoded Should be a '0x'-prefixed hex string representing exactly 32-bytes.
+ * @returns
+ */
+function decodeAttestationName(encoded) {
+    if (!/^0x[0-9a-fA-F]{64}$/i.test(encoded)) {
+        throw new Error("Not a 0x-prefixed 32-byte hex string");
+    }
+    // strip trailing zeros
+    let stripped = encoded.replace(/0+$/, "");
+    // if the string is odd-length, add a zero to the end for full bytes
+    stripped = stripped.length % 2 == 0 ? stripped : stripped + "0";
+    const bytes = ethers_1.ethers.toBeArray(stripped);
+    return ethers_1.ethers.toUtf8String(bytes);
+}
+exports.decodeAttestationName = decodeAttestationName;
+/**
+ * Given a ABI decoded object (with tuples) based on the provided JSON ABI definition,
+ * it creates a possibly nested Javascript object compatible with the ABI definitions.
+ * The function assumes that the decoded objects matches the ABI. If this is not the case,
+ * function may behave in strange ways.
+ * This is auxiliary function not intended to be used directly.
+ * @param decoded
+ * @param abi
+ * @param ignoreArray parameter for recursion call when handling of arrays are needed.
+ * @returns
+ */
+function remapABIParsedToObjects(decoded, abi, ignoreArray = false) {
+    if (abi.type == "tuple" || (abi.type == "tuple[]" && ignoreArray)) {
+        const result = {};
+        for (const [index, item] of abi.components.entries()) {
+            const key = item.name;
+            result[key] = remapABIParsedToObjects(decoded[index], item);
+        }
+        return result;
+    }
+    if (abi.type == "tuple[]") {
+        const result = [];
+        for (const item of decoded) {
+            result.push(remapABIParsedToObjects(item, abi, true));
+        }
+        return result;
+    }
+    if (abi.type.match(/^.+(\[(\d*)\])(\[(\d*)\])$/) || abi.type.match(/^.+(\[(\d+)\])$/)) {
+        throw new Error(`Nested arrays or fixed length arrays not supported. Type: ${abi.type}`);
+    }
+    // we assume here we have `type[]` where `type` is one of simple types.
+    const match = abi.type.match(/^(.+)\[\]$/);
+    if (match && isSupportedBasicSolidityType(match[1])) {
+        const result = [];
+        for (const item of decoded) {
+            result.push(item);
+        }
+        return result;
+    }
+    return decoded;
+}
+exports.remapABIParsedToObjects = remapABIParsedToObjects;
+/**
+ * Checks whether the struct objects are deep equal. Objects should match the ABI definition.
+ * @param struct1
+ * @param struct2
+ * @param abi
+ * @returns
+ */
+function structsDeepEqual(struct1, struct2, abi) {
+    if (Object.keys(struct1).length !== Object.keys(struct2).length) {
+        return false;
+    }
+    for (const item of abi.components || []) {
+        const key = item.name;
+        const val1 = struct1[key];
+        const val2 = struct2[key];
+        if (val1 === undefined || val2 === undefined) {
+            throw new Error(`Structs must not have undefined values for ${key}`);
+        }
+        if (item.type == "tuple") {
+            if (!structsDeepEqual(struct1[key], struct2[key], item)) {
+                return false;
+            }
+            continue;
+        }
+        if (item.type == "tuple[]") {
+            if (val1.length != val2.length) {
+                return false;
+            }
+            for (let i = 0; i < val1.length; i++) {
+                if (!structsDeepEqual(val1[i], val2[i], item)) {
+                    return false;
+                }
+            }
+            continue;
+        }
+        if (item.components) {
+            throw new Error("Components should not appear in non tuple ABI fragments");
+        }
+        if (item.type.match(/^.+(\[(\d*)\])(\[(\d*)\])$/) || item.type.match(/^.+(\[(\d+)\])$/)) {
+            throw new Error(`Nested arrays or fixed length arrays not supported. Type: ${item.type}`);
+        }
+        // we assume here we have `type[]` where `type` is one of simple types.
+        const match = item.type.match(/^(.+)\[\]$/);
+        if (match && isSupportedBasicSolidityType(match[1])) {
+            if (val1.length !== val2.length) {
+                return false;
+            }
+            for (let i = 0; i < val1.length; i++) {
+                if (!compareElementaryTypes(val1[i], val2[i], item.type.slice(0, -2))) {
+                    return false;
+                }
+            }
+            continue;
+        }
+        if (!compareElementaryTypes(val1, val2, item.type)) {
+            return false;
+        }
+    }
+    return true;
+}
+exports.structsDeepEqual = structsDeepEqual;
+/**
+ * Loader of the attestation type definition configs
+ * @returns a map from attestation types to definition configs
+ */
+function readAttestationTypeConfigs(configsPath = exports.DEFAULT_ATTESTATION_TYPE_CONFIGS_PATH) {
+    const typeRecMap = new Map();
+    const files = (0, fs_1.readdirSync)(configsPath);
+    files.forEach((fileName) => {
+        const name = path.basename(fileName, ".json");
+        typeRecMap.set(name, JSON.parse((0, fs_1.readFileSync)(`${configsPath}/${fileName}`, "utf8")));
+    });
+    return typeRecMap;
+}
+exports.readAttestationTypeConfigs = readAttestationTypeConfigs;
+/**
+ * Helper function serializing bigints to strings recursively.
+ * @param obj
+ * @returns
+ */
+function serializeBigInts(obj) {
+    return JSON.parse(JSON.stringify(obj, (key, value) => (typeof value === "bigint" ? value.toString() : value)));
+}
+exports.serializeBigInts = serializeBigInts;
+/**
+ * Find the package root than contains the directory.
+ * @param moduleDir the directory of a module, typically use `__dirname`
+ * @returns the directory of the modules's package root.
+ */
+function findPackageRoot(moduleDir) {
+    let dir = path.resolve(moduleDir);
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const packageJson = path.resolve(dir, "package.json");
+        const hasPackageJson = (0, fs_1.existsSync)(packageJson) && (0, fs_1.statSync)(packageJson).isFile();
+        const nodeModules = path.resolve(dir, "node_modules");
+        const hasNodeModules = (0, fs_1.existsSync)(nodeModules) && (0, fs_1.statSync)(nodeModules).isDirectory();
+        if (hasPackageJson && hasNodeModules) {
+            return dir;
+        }
+        if (path.dirname(dir) === dir) {
+            // arrived at filesystem root without finding package root
+            throw new Error("Cannot find package root");
+        }
+        dir = path.dirname(dir);
+    }
+}
+exports.findPackageRoot = findPackageRoot;
+//# sourceMappingURL=utils.js.map