@lodestar/prover 1.9.1

package/lib/utils/conversion.js

@@ -0,0 +1,94 @@
+import { isTruthy } from "./assertion.js";
+export function numberToHex(num) {
+    return "0x" + num.toString(16);
+}
+export function hexToNumber(num) {
+    return num.startsWith("0x") ? parseInt(num.slice(2), 16) : parseInt(num, 16);
+}
+export function hexToBigInt(num) {
+    return num.startsWith("0x") ? BigInt(num) : BigInt(`0x${num}`);
+}
+export function bigIntToHex(num) {
+    return `0x${num.toString(16)}`;
+}
+export function bufferToHex(buffer) {
+    return "0x" + Buffer.from(buffer).toString("hex");
+}
+export function hexToBuffer(val) {
+    return Buffer.from(val.replace("0x", ""), "hex");
+}
+export function padLeft(v, length) {
+    const buf = Buffer.alloc(length);
+    Buffer.from(v).copy(buf, length - v.length);
+    if (Buffer.isBuffer(v))
+        return buf;
+    return Uint8Array.from(buf);
+}
+export function headerDataFromELBlock(blockInfo) {
+    var _a;
+    return {
+        parentHash: blockInfo.parentHash,
+        uncleHash: blockInfo.sha3Uncles,
+        coinbase: blockInfo.miner,
+        stateRoot: blockInfo.stateRoot,
+        transactionsTrie: blockInfo.transactionsRoot,
+        receiptTrie: blockInfo.receiptsRoot,
+        logsBloom: blockInfo.logsBloom,
+        difficulty: BigInt(blockInfo.difficulty),
+        number: BigInt(blockInfo.number),
+        gasLimit: BigInt(blockInfo.gasLimit),
+        gasUsed: BigInt(blockInfo.gasUsed),
+        timestamp: BigInt(blockInfo.timestamp),
+        extraData: blockInfo.extraData,
+        mixHash: blockInfo.mixHash,
+        nonce: blockInfo.nonce,
+        baseFeePerGas: blockInfo.baseFeePerGas ? BigInt(blockInfo.baseFeePerGas) : undefined,
+        withdrawalsRoot: (_a = blockInfo.withdrawalsRoot) !== null && _a !== void 0 ? _a : undefined,
+    };
+}
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+export function txDataFromELBlock(txInfo) {
+    return {
+        ...txInfo,
+        data: txInfo.input,
+        gasPrice: isTruthy(txInfo.gasPrice) ? BigInt(txInfo.gasPrice) : null,
+        gasLimit: txInfo.gas,
+        to: isTruthy(txInfo.to) ? padLeft(hexToBuffer(txInfo.to), 20) : undefined,
+        value: txInfo.value ? BigInt(txInfo.value) : undefined,
+        maxFeePerGas: isTruthy(txInfo.maxFeePerGas) ? BigInt(txInfo.maxFeePerGas) : undefined,
+        maxPriorityFeePerGas: isTruthy(txInfo.maxPriorityFeePerGas) ? BigInt(txInfo.maxPriorityFeePerGas) : undefined,
+    };
+}
+export function blockDataFromELBlock(blockInfo) {
+    return {
+        header: headerDataFromELBlock(blockInfo),
+        transactions: blockInfo.transactions.map(txDataFromELBlock),
+    };
+}
+export function cleanObject(obj) {
+    const isNullify = (v) => v === undefined || v === null;
+    if (Array.isArray(obj))
+        return obj.filter((v) => isNullify(v));
+    if (typeof obj === "object") {
+        for (const key of Object.keys(obj)) {
+            if (isNullify(obj[key])) {
+                delete obj[key];
+            }
+            else if (typeof obj[key] === "object") {
+                cleanObject(obj[key]);
+            }
+        }
+    }
+    return obj;
+}
+/**
+ * Convert an array to array of chunks
+ * @example
+ * chunkIntoN([1,2,3,4], 2)
+ * => [[1,2], [3,4]]
+ */
+export function chunkIntoN(arr, n) {
+    const size = Math.ceil(arr.length / n);
+    return Array.from({ length: n }, (v, i) => arr.slice(i * size, i * size + size));
+}
+//# sourceMappingURL=conversion.js.map

package/lib/utils/conversion.js.map

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

package/lib/utils/errors.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Expected error that shouldn't print a stack trace
+ */
+export declare class YargsError extends Error {
+}
+//# sourceMappingURL=errors.d.ts.map

package/lib/utils/errors.js

@@ -0,0 +1,6 @@
+/**
+ * Expected error that shouldn't print a stack trace
+ */
+export class YargsError extends Error {
+}
+//# sourceMappingURL=errors.js.map

package/lib/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;CAAG"}

package/lib/utils/evm.d.ts

@@ -0,0 +1,44 @@
+import { VM, RunTxResult } from "@ethereumjs/vm";
+import { BlockHeader } from "@ethereumjs/block";
+import { NetworkName } from "@lodestar/config/networks";
+import { allForks } from "@lodestar/types";
+import { Logger } from "@lodestar/utils";
+import { ProofProvider } from "../proof_provider/proof_provider.js";
+import { ELBlock, ELProof, ELTransaction } from "../types.js";
+import { ELRpc } from "./rpc.js";
+export declare function createVM({ proofProvider }: {
+    proofProvider: ProofProvider;
+}): Promise<VM>;
+export declare function getVMWithState({ rpc, executionPayload, tx, vm, logger, }: {
+    rpc: ELRpc;
+    vm: VM;
+    executionPayload: allForks.ExecutionPayload;
+    tx: ELTransaction;
+    logger: Logger;
+}): Promise<VM>;
+type VMState = Record<string, {
+    code: string;
+    proof: ELProof;
+}>;
+export declare function updateVMWithState({ vm, state }: {
+    logger: Logger;
+    state: VMState;
+    vm: VM;
+}): Promise<VM>;
+export declare function executeVMCall({ rpc, tx, vm, executionPayload, network, }: {
+    rpc: ELRpc;
+    tx: ELTransaction;
+    vm: VM;
+    executionPayload: allForks.ExecutionPayload;
+    network: NetworkName;
+}): Promise<RunTxResult["execResult"]>;
+export declare function executeVMTx({ rpc, tx, vm, executionPayload, network, }: {
+    rpc: ELRpc;
+    tx: ELTransaction;
+    vm: VM;
+    executionPayload: allForks.ExecutionPayload;
+    network: NetworkName;
+}): Promise<RunTxResult>;
+export declare function getVMBlockHeaderFromELBlock(block: ELBlock, executionPayload: allForks.ExecutionPayload, network: NetworkName): BlockHeader;
+export {};
+//# sourceMappingURL=evm.d.ts.map

package/lib/utils/evm.js

@@ -0,0 +1,193 @@
+import { Blockchain } from "@ethereumjs/blockchain";
+import { Account, Address } from "@ethereumjs/util";
+import { VM } from "@ethereumjs/vm";
+import { TransactionFactory } from "@ethereumjs/tx";
+import { BlockHeader } from "@ethereumjs/block";
+import { ZERO_ADDRESS } from "../constants.js";
+import { bufferToHex, chunkIntoN, cleanObject, hexToBigInt, hexToBuffer, numberToHex, padLeft } from "./conversion.js";
+import { getChainCommon, getTxType } from "./execution.js";
+import { isValidResponse } from "./json_rpc.js";
+import { isNullish, isValidAccount, isValidCodeHash, isValidStorageKeys } from "./validation.js";
+export async function createVM({ proofProvider }) {
+    const common = getChainCommon(proofProvider.config.PRESET_BASE);
+    const blockchain = await Blockchain.create({ common });
+    // Connect blockchain object with existing proof provider for block history
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
+    blockchain.getBlock = async (blockId) => {
+        const payload = await proofProvider.getExecutionPayload(blockId);
+        return {
+            hash: () => payload.blockHash,
+        };
+    };
+    const vm = await VM.create({ common, blockchain });
+    return vm;
+}
+export async function getVMWithState({ rpc, executionPayload, tx, vm, logger, }) {
+    var _a;
+    const { stateRoot, blockHash, gasLimit } = executionPayload;
+    const blockHashHex = bufferToHex(blockHash);
+    // If tx does not have a from address then it must be initiated via zero address
+    const from = (_a = tx.from) !== null && _a !== void 0 ? _a : ZERO_ADDRESS;
+    const to = tx.to;
+    // Create Access List for the contract call
+    const accessListTx = cleanObject({
+        to,
+        from,
+        data: tx.data,
+        value: tx.value,
+        gas: tx.gas ? tx.gas : numberToHex(gasLimit),
+        gasPrice: "0x0",
+    });
+    const response = await rpc.request("eth_createAccessList", [accessListTx, blockHashHex], { raiseError: false });
+    if (!isValidResponse(response) || response.result.error) {
+        throw new Error(`Invalid response from RPC. method: eth_createAccessList, params: ${JSON.stringify(tx)}`);
+    }
+    const storageKeysMap = {};
+    for (const { address, storageKeys } of response.result.accessList) {
+        storageKeysMap[address] = storageKeys;
+    }
+    // If from address is not present then we have to fetch it for all keys
+    if (isNullish(storageKeysMap[from])) {
+        storageKeysMap[from] = [];
+    }
+    // If to address is not present then we have to fetch it with for all keys
+    if (to && isNullish(storageKeysMap[to])) {
+        storageKeysMap[to] = [];
+    }
+    const batchRequests = [];
+    for (const [address, storageKeys] of Object.entries(storageKeysMap)) {
+        batchRequests.push({ jsonrpc: "2.0", method: "eth_getProof", params: [address, storageKeys, blockHashHex] });
+        batchRequests.push({ jsonrpc: "2.0", method: "eth_getCode", params: [address, blockHashHex] });
+    }
+    // If all responses are valid then we will have even number of responses
+    // For each address, one response for eth_getProof and one for eth_getCode
+    const batchResponse = await rpc.batchRequest(batchRequests, { raiseError: true });
+    const batchResponseInChunks = chunkIntoN(batchResponse, 2);
+    const vmState = {};
+    for (const [proofResponse, codeResponse] of batchResponseInChunks) {
+        const addressHex = proofResponse.request.params[0];
+        if (!isNullish(vmState[addressHex]))
+            continue;
+        const proof = proofResponse.response.result;
+        const storageKeys = proofResponse.request.params[1];
+        const code = codeResponse.response.result;
+        const validAccount = await isValidAccount({ address: addressHex, proof, logger, stateRoot });
+        const validStorage = validAccount && (await isValidStorageKeys({ storageKeys, proof, logger }));
+        if (!validAccount || !validStorage) {
+            throw new Error(`Invalid account: ${addressHex}`);
+        }
+        if (!(await isValidCodeHash({ codeResponse: code, logger, codeHash: proof.codeHash }))) {
+            throw new Error(`Invalid code hash: ${addressHex}`);
+        }
+        vmState[addressHex] = { code, proof };
+    }
+    return updateVMWithState({ vm, state: vmState, logger });
+}
+export async function updateVMWithState({ vm, state }) {
+    await vm.stateManager.checkpoint();
+    for (const [addressHex, { proof, code }] of Object.entries(state)) {
+        const address = Address.fromString(addressHex);
+        const codeBuffer = hexToBuffer(code);
+        const account = Account.fromAccountData({
+            nonce: BigInt(proof.nonce),
+            balance: BigInt(proof.balance),
+            codeHash: proof.codeHash,
+        });
+        await vm.stateManager.putAccount(address, account);
+        for (const { key, value } of proof.storageProof) {
+            await vm.stateManager.putContractStorage(address, padLeft(hexToBuffer(key), 32), padLeft(hexToBuffer(value), 32));
+        }
+        if (codeBuffer.byteLength !== 0)
+            await vm.stateManager.putContractCode(address, codeBuffer);
+    }
+    await vm.stateManager.commit();
+    return vm;
+}
+export async function executeVMCall({ rpc, tx, vm, executionPayload, network, }) {
+    var _a;
+    const { from, to, gas, gasPrice, maxPriorityFeePerGas, value, data } = tx;
+    const { result: block } = await rpc.request("eth_getBlockByHash", [bufferToHex(executionPayload.blockHash), true], {
+        raiseError: true,
+    });
+    if (!block) {
+        throw new Error(`Block not found: ${bufferToHex(executionPayload.blockHash)}`);
+    }
+    const { execResult } = await vm.evm.runCall({
+        caller: from ? Address.fromString(from) : undefined,
+        to: to ? Address.fromString(to) : undefined,
+        gasLimit: hexToBigInt(gas !== null && gas !== void 0 ? gas : block.gasLimit),
+        gasPrice: hexToBigInt((_a = gasPrice !== null && gasPrice !== void 0 ? gasPrice : maxPriorityFeePerGas) !== null && _a !== void 0 ? _a : "0x0"),
+        value: hexToBigInt(value !== null && value !== void 0 ? value : "0x0"),
+        data: data ? hexToBuffer(data) : undefined,
+        block: {
+            header: getVMBlockHeaderFromELBlock(block, executionPayload, network),
+        },
+    });
+    if (execResult.exceptionError) {
+        throw new Error(execResult.exceptionError.error);
+    }
+    return execResult;
+}
+export async function executeVMTx({ rpc, tx, vm, executionPayload, network, }) {
+    var _a, _b;
+    const { result: block } = await rpc.request("eth_getBlockByHash", [bufferToHex(executionPayload.blockHash), true], {
+        raiseError: true,
+    });
+    if (!block) {
+        throw new Error(`Block not found: ${bufferToHex(executionPayload.blockHash)}`);
+    }
+    const txType = getTxType(tx);
+    const from = tx.from ? Address.fromString(tx.from) : Address.zero();
+    const to = tx.to ? Address.fromString(tx.to) : undefined;
+    const txData = {
+        ...tx,
+        from,
+        to,
+        type: txType,
+        // If no gas limit is specified use the last block gas limit as an upper bound.
+        gasLimit: hexToBigInt((_a = tx.gas) !== null && _a !== void 0 ? _a : block.gasLimit),
+    };
+    if (txType === 2) {
+        // Handle EIP-1559 transactions
+        // To fix the vm error: Transaction's maxFeePerGas (0) is less than the block's baseFeePerGas
+        txData.maxFeePerGas = (_b = txData.maxFeePerGas) !== null && _b !== void 0 ? _b : block.baseFeePerGas;
+    }
+    else {
+        // Legacy transaction
+        txData.gasPrice = isNullish(txData.gasPrice) || txData.gasPrice === "0x0" ? block.baseFeePerGas : txData.gasPrice;
+    }
+    const txObject = TransactionFactory.fromTxData(txData, { common: getChainCommon(network), freeze: false });
+    // Override to avoid tx signature verification
+    txObject.getSenderAddress = () => (tx.from ? Address.fromString(tx.from) : Address.zero());
+    const result = await vm.runTx({
+        tx: txObject,
+        skipNonce: true,
+        skipBalance: true,
+        skipBlockGasLimitValidation: true,
+        skipHardForkValidation: true,
+        block: {
+            header: getVMBlockHeaderFromELBlock(block, executionPayload, network),
+        },
+    });
+    return result;
+}
+export function getVMBlockHeaderFromELBlock(block, executionPayload, network) {
+    const blockHeaderData = {
+        number: hexToBigInt(block.number),
+        cliqueSigner: () => Address.fromString(block.miner),
+        timestamp: hexToBigInt(block.timestamp),
+        difficulty: hexToBigInt(block.difficulty),
+        gasLimit: hexToBigInt(block.gasLimit),
+        baseFeePerGas: block.baseFeePerGas ? hexToBigInt(block.baseFeePerGas) : undefined,
+        // Use these values from the execution payload
+        // instead of the block values to ensure that
+        // the VM is using the verified values from the lightclient
+        prevRandao: Buffer.from(executionPayload.prevRandao),
+        stateRoot: Buffer.from(executionPayload.stateRoot),
+        parentHash: Buffer.from(executionPayload.parentHash),
+        // TODO: Fix the coinbase address
+        coinbase: Address.fromString(block.miner),
+    };
+    return BlockHeader.fromHeaderData(blockHeaderData, { common: getChainCommon(network) });
+}
+//# sourceMappingURL=evm.js.map

package/lib/utils/evm.js.map

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

package/lib/utils/execution.d.ts

@@ -0,0 +1,12 @@
+import { Common } from "@ethereumjs/common";
+import { ELApiParams, ELApiReturn, ELTransaction } from "../types.js";
+import { ELRpc } from "./rpc.js";
+export type Optional<T, K extends keyof T> = Omit<T, K> & {
+    [P in keyof T]?: T[P] | undefined;
+};
+export declare function getELCode(rpc: ELRpc, args: ELApiParams["eth_getCode"]): Promise<ELApiReturn["eth_getCode"]>;
+export declare function getELProof(rpc: ELRpc, args: ELApiParams["eth_getProof"]): Promise<ELApiReturn["eth_getProof"]>;
+export declare function getELBlock(rpc: ELRpc, args: ELApiParams["eth_getBlockByNumber"]): Promise<ELApiReturn["eth_getBlockByNumber"]>;
+export declare function getChainCommon(network: string): Common;
+export declare function getTxType(tx: ELTransaction): number;
+//# sourceMappingURL=execution.d.ts.map

package/lib/utils/execution.js

@@ -0,0 +1,53 @@
+import { Common, CustomChain, Hardfork } from "@ethereumjs/common";
+import { isValidResponse } from "./json_rpc.js";
+import { isBlockNumber, isPresent } from "./validation.js";
+export async function getELCode(rpc, args) {
+    const codeResult = await rpc.request("eth_getCode", args, { raiseError: false });
+    if (!isValidResponse(codeResult)) {
+        throw new Error(`Can not find code for address=${args[0]}`);
+    }
+    return codeResult.result;
+}
+export async function getELProof(rpc, args) {
+    const proof = await rpc.request("eth_getProof", args, { raiseError: false });
+    if (!isValidResponse(proof)) {
+        throw new Error(`Can not find proof for address=${args[0]}`);
+    }
+    return proof.result;
+}
+export async function getELBlock(rpc, args) {
+    const block = await rpc.request(isBlockNumber(args[0]) ? "eth_getBlockByNumber" : "eth_getBlockByHash", args, {
+        raiseError: false,
+    });
+    if (!isValidResponse(block)) {
+        throw new Error(`Can not find block. id=${args[0]}`);
+    }
+    return block.result;
+}
+export function getChainCommon(network) {
+    switch (network) {
+        case "mainnet":
+        case "goerli":
+        case "ropsten":
+        case "sepolia":
+            // TODO: Not sure how to detect the fork during runtime
+            return new Common({ chain: network, hardfork: Hardfork.Shanghai });
+        case "minimal":
+            // TODO: Not sure how to detect the fork during runtime
+            return new Common({ chain: "mainnet", hardfork: Hardfork.Shanghai });
+        case "gnosis":
+            return new Common({ chain: CustomChain.xDaiChain });
+        default:
+            throw new Error(`Non supported network "${network}"`);
+    }
+}
+export function getTxType(tx) {
+    if (isPresent(tx.maxFeePerGas) || isPresent(tx.maxPriorityFeePerGas)) {
+        return 2;
+    }
+    if (isPresent(tx.accessList)) {
+        return 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=execution.js.map

package/lib/utils/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/utils/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAC,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAC,eAAe,EAAC,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAC,aAAa,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAKzD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAU,EAAE,IAAgC;IAC1E,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,EAAE,EAAC,UAAU,EAAE,KAAK,EAAC,CAAC,CAAC;IAE/E,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE;QAChC,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KAC7D;IAED,OAAO,UAAU,CAAC,MAAM,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAU,EAAE,IAAiC;IAC5E,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,EAAC,UAAU,EAAE,KAAK,EAAC,CAAC,CAAC;IAC3E,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE;QAC3B,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KAC9D;IACD,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAU,EACV,IAAyC;IAEzC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,oBAAoB,EAAE,IAAI,EAAE;QAC5G,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;IAEH,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE;QAC3B,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KACtD;IAED,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,QAAQ,OAAO,EAAE;QACf,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,SAAS;YACZ,uDAAuD;YACvD,OAAO,IAAI,MAAM,CAAC,EAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAC,CAAC,CAAC;QACnE,KAAK,SAAS;YACZ,uDAAuD;YACvD,OAAO,IAAI,MAAM,CAAC,EAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAC,CAAC,CAAC;QACrE,KAAK,QAAQ;YACX,OAAO,IAAI,MAAM,CAAC,EAAC,KAAK,EAAE,WAAW,CAAC,SAAS,EAAC,CAAC,CAAC;QACpD;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,GAAG,CAAC,CAAC;KACzD;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAiB;IACzC,IAAI,SAAS,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,EAAE,CAAC,oBAAoB,CAAC,EAAE;QACpE,OAAO,CAAC,CAAC;KACV;IAED,IAAI,SAAS,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE;QAC5B,OAAO,CAAC,CAAC;KACV;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

package/lib/utils/file.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Read a JSON serializable object from a file
+ *
+ * Parse either from json, yaml, or toml
+ * Optional acceptedFormats object can be passed which can be an array of accepted formats, in future can be extended to include parseFn for the accepted formats
+ */
+export declare function readFile<T>(filepath: string, acceptedFormats?: string[]): T;
+//# sourceMappingURL=file.d.ts.map

package/lib/utils/file.js

@@ -0,0 +1,50 @@
+import fs from "node:fs";
+import path from "node:path";
+import yaml from "js-yaml";
+const { load, FAILSAFE_SCHEMA, Type } = yaml;
+var FileFormat;
+(function (FileFormat) {
+    FileFormat["json"] = "json";
+    FileFormat["yaml"] = "yaml";
+    FileFormat["yml"] = "yml";
+    FileFormat["toml"] = "toml";
+})(FileFormat || (FileFormat = {}));
+const yamlSchema = FAILSAFE_SCHEMA.extend({
+    implicit: [
+        new Type("tag:yaml.org,2002:str", {
+            kind: "scalar",
+            construct: function construct(data) {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+                return data !== null ? data : "";
+            },
+        }),
+    ],
+});
+/**
+ * Parse file contents as Json.
+ */
+function parse(contents, fileFormat) {
+    switch (fileFormat) {
+        case FileFormat.json:
+            return JSON.parse(contents);
+        case FileFormat.yaml:
+        case FileFormat.yml:
+            return load(contents, { schema: yamlSchema });
+        default:
+            return contents;
+    }
+}
+/**
+ * Read a JSON serializable object from a file
+ *
+ * Parse either from json, yaml, or toml
+ * Optional acceptedFormats object can be passed which can be an array of accepted formats, in future can be extended to include parseFn for the accepted formats
+ */
+export function readFile(filepath, acceptedFormats) {
+    const fileFormat = path.extname(filepath).substr(1);
+    if (acceptedFormats && !acceptedFormats.includes(fileFormat))
+        throw new Error(`UnsupportedFileFormat: ${filepath}`);
+    const contents = fs.readFileSync(filepath, "utf-8");
+    return parse(contents, fileFormat);
+}
+//# sourceMappingURL=file.js.map

package/lib/utils/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/utils/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,MAAM,EAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAC,GAAG,IAAI,CAAC;AAE3C,IAAK,UAKJ;AALD,WAAK,UAAU;IACb,2BAAa,CAAA;IACb,2BAAa,CAAA;IACb,yBAAW,CAAA;IACX,2BAAa,CAAA;AACf,CAAC,EALI,UAAU,KAAV,UAAU,QAKd;AAED,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE;QACR,IAAI,IAAI,CAAC,uBAAuB,EAAE;YAChC,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI;gBAChC,+DAA+D;gBAC/D,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,CAAC;SACF,CAAC;KACH;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,SAAS,KAAK,CAAI,QAAgB,EAAE,UAAsB;IACxD,QAAQ,UAAU,EAAE;QAClB,KAAK,UAAU,CAAC,IAAI;YAClB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAM,CAAC;QACnC,KAAK,UAAU,CAAC,IAAI,CAAC;QACrB,KAAK,UAAU,CAAC,GAAG;YACjB,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAC,MAAM,EAAE,UAAU,EAAC,CAAM,CAAC;QACnD;YACE,OAAO,QAAwB,CAAC;KACnC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAI,QAAgB,EAAE,eAA0B;IACtE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,eAAe,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;IACpH,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,QAAQ,EAAE,UAAwB,CAAC,CAAC;AACnD,CAAC"}

package/lib/utils/gitData/gitDataPath.d.ts

@@ -0,0 +1,17 @@
+/**
+ * WARNING!! If you change this path make sure to update:
+ * - 'packages/cli/package.json' -> .files -> `".git-data.json"`
+ */
+export declare const gitDataPath: string;
+/** Git data type used to construct version information string and persistence. */
+export type GitData = {
+    /** "developer-feature" */
+    branch: string;
+    /** "80c248bb392f512cc115d95059e22239a17bbd7d" */
+    commit: string;
+};
+/** Writes a persistent git data file. */
+export declare function writeGitDataFile(gitData: GitData): void;
+/** Reads the persistent git data file. */
+export declare function readGitDataFile(): GitData;
+//# sourceMappingURL=gitDataPath.d.ts.map

package/lib/utils/gitData/gitDataPath.js

@@ -0,0 +1,37 @@
+import path from "node:path";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+// Global variable __dirname no longer available in ES6 modules.
+// Solutions: https://stackoverflow.com/questions/46745014/alternative-for-dirname-in-node-js-when-using-es6-modules
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// Persist git data and distribute through NPM so CLI consumers can know exactly
+// at what commit was this src build. This is used in the metrics and to log initially.
+//
+// - For NPM release (stable): Only the version is persisted. Once must then track the version's tag
+//   in Github to resolve that version to a specific commit. While this is okay, git-data.json gives
+//   a gurantee of the exact commit at build time.
+//
+// - For NPM release (dev): canary commits include the commit, so this feature is not really
+//   necessary. However, it's more cumbersome to have conditional logic on stable / dev.
+//
+// - For build from source: .git folder is available in the context of the built code, so it can extract
+//   branch and commit directly without the need for .git-data.json.
+//
+// - For build from source dockerized: This feature is required to know the branch and commit, since
+//   git data is not persisted past the build. However, .dockerignore prevents .git folder from being
+//   copied into the container's context, so .git-data.json can't be generated.
+/**
+ * WARNING!! If you change this path make sure to update:
+ * - 'packages/cli/package.json' -> .files -> `".git-data.json"`
+ */
+export const gitDataPath = path.resolve(__dirname, "../../../.git-data.json");
+/** Writes a persistent git data file. */
+export function writeGitDataFile(gitData) {
+    fs.writeFileSync(gitDataPath, JSON.stringify(gitData, null, 2));
+}
+/** Reads the persistent git data file. */
+export function readGitDataFile() {
+    return JSON.parse(fs.readFileSync(gitDataPath, "utf8"));
+}
+//# sourceMappingURL=gitDataPath.js.map

package/lib/utils/gitData/gitDataPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitDataPath.js","sourceRoot":"","sources":["../../../src/utils/gitData/gitDataPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAEvC,gEAAgE;AAChE,oHAAoH;AACpH,gEAAgE;AAChE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,gFAAgF;AAChF,uFAAuF;AACvF,EAAE;AACF,oGAAoG;AACpG,oGAAoG;AACpG,kDAAkD;AAClD,EAAE;AACF,4FAA4F;AAC5F,wFAAwF;AACxF,EAAE;AACF,wGAAwG;AACxG,oEAAoE;AACpE,EAAE;AACF,oGAAoG;AACpG,qGAAqG;AACrG,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;AAU9E,yCAAyC;AACzC,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAY,CAAC;AACrE,CAAC"}

package/lib/utils/gitData/index.d.ts

@@ -0,0 +1,6 @@
+import { GitData } from "./gitDataPath.js";
+/** Reads git data from a persisted file or local git data at build time. */
+export declare function readAndGetGitData(): GitData;
+/** Gets git data containing current branch and commit info from CLI. */
+export declare function getGitData(): GitData;
+//# sourceMappingURL=index.d.ts.map