gate-evm-tools 1.0.28 → 1.2.0

package/dist-cjs/core/BytecodeChecker.js

@@ -0,0 +1,526 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BytecodeChecker = void 0;
+const upgrades_core_1 = require("@openzeppelin/upgrades-core");
+const legacyProxyArtifact_js_1 = require("./legacyProxyArtifact.js");
+class BytecodeChecker {
+    hre;
+    addressData;
+    scheme;
+    constructor(hre, addressData, scheme) {
+        this.hre = hre;
+        this.addressData = addressData;
+        this.scheme = scheme;
+    }
+    /**
+     * 解析合约名称，支持 "别名:合约名" 格式
+     *
+     * 例如：
+     * - "LedgerImplA:LedgerImpl" -> { alias: "LedgerImplA", contractName: "LedgerImpl" }
+     * - "Vault" -> { alias: "Vault", contractName: "Vault" }
+     * - "MyContract::Proxy" -> { alias: "MyContract::Proxy", contractName: "MyContract::Proxy" }
+     *
+     * 注意：::Proxy 后缀用于代理合约检查，不参与别名解析
+     */
+    parseContractName(name) {
+        // 先处理 ::Proxy 后缀
+        const isProxy = name.endsWith('::Proxy');
+        const nameWithoutProxySuffix = isProxy ? name.slice(0, -7) : name;
+        // 检查是否包含别名分隔符 ":"
+        const colonIndex = nameWithoutProxySuffix.indexOf(':');
+        if (colonIndex > 0) {
+            // 有别名格式: "别名:合约名"
+            const alias = nameWithoutProxySuffix.slice(0, colonIndex);
+            const contractName = nameWithoutProxySuffix.slice(colonIndex + 1);
+            return {
+                alias: isProxy ? `${alias}::Proxy` : alias,
+                contractName: isProxy ? `${contractName}::Proxy` : contractName
+            };
+        }
+        // 无别名格式，名称即为合约名
+        return { alias: name, contractName: name };
+    }
+    /**
+     * 获取链上合约的bytecode
+     */
+    async getOnchainBytecode(address, network) {
+        try {
+            const networkConfig = this.hre.config.networks[network];
+            if (!networkConfig) {
+                throw new Error(`Network ${network} not found in hardhat config`);
+            }
+            const ethers = this.hre.ethers;
+            const provider = new ethers.JsonRpcProvider(networkConfig.url);
+            const bytecode = await provider.getCode(address);
+            return bytecode;
+        }
+        catch (error) {
+            throw new Error(`Failed to get onchain bytecode: ${error.message}`);
+        }
+    }
+    /**
+     * 获取本地编译的bytecode（使用deployedBytecode）
+     *
+     * 对于代理合约（名称包含 ::Proxy 后缀），使用 ERC1967Proxy
+     */
+    async getLocalBytecode(contractName) {
+        try {
+            // 检查是否是代理合约检查（名称包含 ::Proxy 后缀）
+            if (contractName.endsWith('::Proxy')) {
+                return await this.getProxyLocalBytecode();
+            }
+            return await this.getArtifactLocalBytecode(contractName);
+        }
+        catch (error) {
+            throw new Error(`Failed to get local bytecode: ${error.message}`);
+        }
+    }
+    /**
+     * 获取代理合约的本地 bytecode
+     * 使用 ERC1967Proxy
+     */
+    async getProxyLocalBytecode() {
+        try {
+            return await this.getArtifactLocalBytecode('ERC1967Proxy');
+        }
+        catch (error) {
+            throw new Error(`无法找到 ERC1967Proxy 的本地 artifact。\n` +
+                `请确保项目中包含 ERC1967Proxy 的源码（通常来自 @openzeppelin/contracts）`);
+        }
+    }
+    /**
+     * 使用 artifact 的 fully-qualified identity 读取编译器生成的 immutableReferences。
+     * build-info 缺失时保留空引用，使完全一致的 bytecode 仍可通过；一旦存在差异，
+     * compareBytecode 会按 fail-closed 规则拒绝缺少编译器证据的匹配。
+     */
+    async getArtifactLocalBytecode(contractName) {
+        const artifact = await this.hre.artifacts.readArtifact(contractName);
+        if (this.scheme) {
+            const expectedFormat = this.scheme === 'zksync-eravm'
+                ? 'hh-zksolc-artifact-1'
+                : 'hh-sol-artifact-1';
+            if (artifact._format !== expectedFormat) {
+                throw new Error(`Artifact ${contractName} does not match ${this.scheme} artifact format ${expectedFormat}`);
+            }
+        }
+        let immutableReferences = {};
+        const sourceName = artifact.sourceName;
+        const artifactContractName = artifact.contractName;
+        const getBuildInfo = this.hre.artifacts.getBuildInfo;
+        if (typeof sourceName === 'string' &&
+            typeof artifactContractName === 'string' &&
+            typeof getBuildInfo === 'function') {
+            try {
+                const fullyQualifiedName = `${sourceName}:${artifactContractName}`;
+                const buildInfo = await getBuildInfo.call(this.hre.artifacts, fullyQualifiedName);
+                const compilerReferences = buildInfo?.output?.contracts?.[sourceName]?.[artifactContractName]
+                    ?.evm?.deployedBytecode?.immutableReferences;
+                if (compilerReferences &&
+                    typeof compilerReferences === 'object' &&
+                    !Array.isArray(compilerReferences)) {
+                    immutableReferences = compilerReferences;
+                }
+            }
+            catch {
+                immutableReferences = {};
+            }
+        }
+        return {
+            bytecode: artifact.deployedBytecode,
+            abi: artifact.abi,
+            immutableReferences
+        };
+    }
+    /**
+     * 标准化bytecode（移除metadata）
+     */
+    normalizeBytecode(bytecode) {
+        const code = bytecode.replace(/^0x/, '').toLowerCase();
+        if (code.length < 4 || code.length % 2 !== 0)
+            return code;
+        const lengthSuffix = code.slice(-4);
+        if (!/^[0-9a-f]{4}$/.test(lengthSuffix))
+            return code;
+        const metadataLength = Number.parseInt(lengthSuffix, 16) * 2;
+        const metadataStart = code.length - 4 - metadataLength;
+        if (metadataLength === 0 || metadataStart <= 0)
+            return code;
+        const metadata = code.slice(metadataStart, -4);
+        if (!/^[0-9a-f]+$/.test(metadata))
+            return code;
+        // The marker can occur in executable PUSH data. Only trim the trailing
+        // length-delimited region when OpenZeppelin's public helper confirms it
+        // consumed a complete CBOR item (including rejection of trailing garbage).
+        // hashBytecode also supports Solidity library placeholders, so the original
+        // prefix and its compiler immutable offsets remain intact for comparison.
+        const executable = code.slice(0, metadataStart);
+        try {
+            if ((0, upgrades_core_1.hashBytecodeWithoutMetadata)(code) === (0, upgrades_core_1.hashBytecode)(executable)) {
+                return executable;
+            }
+        }
+        catch {
+            // Invalid bytecode/metadata must remain visible to the comparison.
+        }
+        return code;
+    }
+    /**
+     * 检测并替换本地 bytecode 中的外部库占位符（__$...$__）
+     *
+     * Solidity 编译器对需要单独部署的外部库会生成占位符：
+     * 格式为 __$<34 hex chars>$__ （总共 40 字符，与地址长度一致）
+     * 链上 bytecode 在这些位置是实际部署的库地址
+     *
+     * @returns 归一化后的本地/链上 bytecode 以及检测到的库链接信息
+     */
+    normalizeLibraryPlaceholders(onchainCode, localCode) {
+        const libraryLinks = [];
+        const placeholderRegex = /__\$[0-9a-f]{34}\$__/gi;
+        let match;
+        let normalizedLocal = localCode;
+        let normalizedOnchain = onchainCode;
+        const placeholders = [];
+        while ((match = placeholderRegex.exec(localCode)) !== null) {
+            placeholders.push({ placeholder: match[0], index: match.index });
+        }
+        // 从后往前替换，避免位置偏移
+        for (let i = placeholders.length - 1; i >= 0; i--) {
+            const { placeholder, index } = placeholders[i];
+            const zeroFill = '0'.repeat(40);
+            const linkedAddress = onchainCode.length >= index + 40
+                ? onchainCode.substring(index, index + 40)
+                : '';
+            libraryLinks.unshift({
+                placeholder,
+                position: index,
+                linkedAddress: linkedAddress ? `0x${linkedAddress}` : 'unknown'
+            });
+            normalizedLocal = normalizedLocal.substring(0, index) + zeroFill + normalizedLocal.substring(index + 40);
+            if (linkedAddress) {
+                normalizedOnchain = normalizedOnchain.substring(0, index) + zeroFill + normalizedOnchain.substring(index + 40);
+            }
+        }
+        return { onchain: normalizedOnchain, local: normalizedLocal, libraryLinks };
+    }
+    /**
+     * 检测 library 合约自身的地址嵌入模式
+     *
+     * Solidity library 部署后，bytecode 开头有自保护代码：
+     *   73 <20字节地址> 30 14 ...
+     *   (PUSH20 <address> ADDRESS EQ ...)
+     *
+     * 本地编译产物中地址部分为零：
+     *   73 0000000000000000000000000000000000000000 3014 ...
+     * 链上 bytecode 中是库自身的部署地址：
+     *   73 <actual_library_address> 3014 ...
+     *
+     * @returns 归一化后的 bytecode 和检测到的库自身地址，未检测到则返回 null
+     */
+    normalizeLibrarySelfAddress(onchainCode, localCode) {
+        // 匹配: 73 + 40个零 + 3014（PUSH20 + zero_address + ADDRESS + EQ）
+        const libSelfPattern = /^73(0{40})3014/;
+        const localMatch = libSelfPattern.exec(localCode);
+        if (!localMatch)
+            return null;
+        // 从链上 bytecode 提取实际地址：跳过 73 (2 hex)，取 40 hex chars
+        if (onchainCode.length < 44)
+            return null;
+        const selfAddress = onchainCode.substring(2, 42);
+        // 验证链上也有相同的模式结构：73 + <addr> + 3014
+        if (!onchainCode.startsWith('73') || onchainCode.substring(42, 46) !== '3014')
+            return null;
+        const zeroFill = '0'.repeat(40);
+        const normalizedOnchain = '73' + zeroFill + onchainCode.substring(42);
+        return { onchain: normalizedOnchain, local: localCode, selfAddress: `0x${selfAddress}` };
+    }
+    /**
+     * 只屏蔽编译器声明的 immutable 区间，并比较其余 runtime bytecode。
+     */
+    compareWithImmutableReferences(onchainCode, localCode, immutableReferences) {
+        if (!immutableReferences ||
+            typeof immutableReferences !== 'object' ||
+            Array.isArray(immutableReferences) ||
+            Object.keys(immutableReferences).length === 0) {
+            return {
+                matches: false,
+                reason: '字节码不匹配，compiler immutableReferences 缺失'
+            };
+        }
+        const ranges = [];
+        for (const [id, references] of Object.entries(immutableReferences)) {
+            if (!Array.isArray(references) || references.length === 0) {
+                return {
+                    matches: false,
+                    reason: `compiler immutable ${id} 引用列表无效`
+                };
+            }
+            const onchainValuesByLength = new Map();
+            for (let index = 0; index < references.length; index++) {
+                const reference = references[index];
+                if (!reference ||
+                    !Number.isInteger(reference.start) ||
+                    !Number.isInteger(reference.length) ||
+                    reference.start < 0 ||
+                    reference.length <= 0) {
+                    return {
+                        matches: false,
+                        reason: `compiler immutable ${id}[${index}] 元数据无效：start 必须是非负整数，length 必须是正整数`
+                    };
+                }
+                const startHex = reference.start * 2;
+                const lengthHex = reference.length * 2;
+                const endHex = startHex + lengthHex;
+                if (endHex > onchainCode.length || endHex > localCode.length) {
+                    return {
+                        matches: false,
+                        reason: `compiler immutable ${id}[${index}] 引用越界`
+                    };
+                }
+                const onchainValue = onchainCode.slice(startHex, endHex);
+                const priorValue = onchainValuesByLength.get(reference.length);
+                if (priorValue !== undefined && priorValue !== onchainValue) {
+                    return {
+                        matches: false,
+                        reason: `compiler immutable ${id} 的重复引用值不一致`
+                    };
+                }
+                onchainValuesByLength.set(reference.length, onchainValue);
+                ranges.push({ id, index, startHex, endHex, lengthHex });
+            }
+        }
+        if (ranges.length === 0) {
+            return {
+                matches: false,
+                reason: '字节码不匹配，compiler immutableReferences 缺失'
+            };
+        }
+        ranges.sort((left, right) => left.startHex - right.startHex || left.endHex - right.endHex);
+        for (let index = 1; index < ranges.length; index++) {
+            const previous = ranges[index - 1];
+            const current = ranges[index];
+            if (current.startHex < previous.endHex) {
+                return {
+                    matches: false,
+                    reason: `compiler immutable 引用区间重叠：${previous.id}[${previous.index}] 与 ${current.id}[${current.index}]`
+                };
+            }
+        }
+        let maskedOnchain = onchainCode;
+        let maskedLocal = localCode;
+        for (let index = ranges.length - 1; index >= 0; index--) {
+            const range = ranges[index];
+            const mask = '0'.repeat(range.lengthHex);
+            maskedOnchain = maskedOnchain.slice(0, range.startHex) + mask + maskedOnchain.slice(range.endHex);
+            maskedLocal = maskedLocal.slice(0, range.startHex) + mask + maskedLocal.slice(range.endHex);
+        }
+        if (maskedOnchain !== maskedLocal) {
+            return {
+                matches: false,
+                reason: 'compiler immutableReferences 区间外仍存在代码差异'
+            };
+        }
+        return {
+            matches: true,
+            reason: `编译器 immutableReferences 精确匹配（${ranges.length} 处）`
+        };
+    }
+    /**
+     * 比较两个bytecode
+     */
+    compareBytecode(onchainBytecode, localBytecode, _abi = null, immutableReferences = {}) {
+        const onchainNormalized = this.normalizeBytecode(onchainBytecode);
+        let localNormalized = this.normalizeBytecode(localBytecode);
+        let libraryLinks = [];
+        let onchainForCompare = onchainNormalized;
+        let localForCompare = localNormalized;
+        let librarySelfAddress = null;
+        // 场景1: library 合约自身的地址嵌入（73 <addr> 3014 模式）
+        const selfAddrResult = this.normalizeLibrarySelfAddress(onchainForCompare, localForCompare);
+        if (selfAddrResult) {
+            onchainForCompare = selfAddrResult.onchain;
+            localForCompare = selfAddrResult.local;
+            librarySelfAddress = selfAddrResult.selfAddress;
+        }
+        // 场景2: 合约引用外部库的占位符（__$...$__ 模式）
+        const hasLibraryPlaceholders = /__\$[0-9a-f]{34}\$__/i.test(localForCompare);
+        if (hasLibraryPlaceholders) {
+            const result = this.normalizeLibraryPlaceholders(onchainForCompare, localForCompare);
+            onchainForCompare = result.onchain;
+            localForCompare = result.local;
+            libraryLinks = result.libraryLinks;
+        }
+        // 构建附加信息描述
+        const extraParts = [];
+        if (librarySelfAddress) {
+            extraParts.push(`library自身地址: ${librarySelfAddress}`);
+        }
+        if (libraryLinks.length > 0) {
+            extraParts.push(`外部库链接: ${libraryLinks.map(l => l.linkedAddress).join(', ')}`);
+        }
+        const extraSuffix = extraParts.length > 0 ? `（${extraParts.join('；')}）` : '';
+        if (onchainForCompare === localForCompare) {
+            return {
+                matches: true,
+                reason: `完全匹配${extraSuffix}`,
+                libraryLinks: libraryLinks.length > 0 ? libraryLinks : undefined
+            };
+        }
+        const immutableComparison = this.compareWithImmutableReferences(onchainForCompare, localForCompare, immutableReferences);
+        return {
+            ...immutableComparison,
+            reason: immutableComparison.matches
+                ? `${immutableComparison.reason}${extraSuffix}`
+                : immutableComparison.reason,
+            libraryLinks: immutableComparison.matches && libraryLinks.length > 0
+                ? libraryLinks
+                : undefined
+        };
+    }
+    /**
+     * 检查单个合约
+     *
+     * 支持 "别名:合约名" 格式，例如：
+     * - "LedgerImplA:LedgerImpl" - 使用 LedgerImpl 验证 bytecode，报告 key 为 LedgerImplA
+     */
+    async checkContract(contractInfo) {
+        // 解析合约名称（支持别名格式）
+        const { alias, contractName } = this.parseContractName(contractInfo.name);
+        // 判断是否是代理合约检查
+        const isProxyCheck = alias.endsWith('::Proxy');
+        // 提取纯别名（不含 ::Proxy 后缀）
+        const pureAlias = isProxyCheck ? alias.replace('::Proxy', '') : alias;
+        // 提取实际合约名（不含 ::Proxy 后缀）
+        const pureContractName = isProxyCheck ? contractName.replace('::Proxy', '') : contractName;
+        // 对于代理合约检查，使用 "_Proxy" 后缀作为报告 key
+        const reportKey = isProxyCheck ? `${pureAlias}_Proxy` : pureAlias;
+        // contract 字段显示实际合约名（代理合约显示 ERC1967Proxy）
+        const actualContract = isProxyCheck ? 'ERC1967Proxy' : pureContractName;
+        const result = {
+            contract: actualContract, // 实际合约名
+            contractName: reportKey, // 别名（用于报告 key）
+            network: contractInfo.network,
+            ...(this.scheme ? { scheme: this.scheme } : {}),
+            address: contractInfo.address,
+            matches: false,
+            error: null,
+            reason: "",
+            onChainBytecodeLength: 0,
+            localBytecodeLength: 0
+        };
+        let onchainBytecode;
+        try {
+            onchainBytecode = await this.getOnchainBytecode(contractInfo.address, contractInfo.network);
+            result.onChainBytecodeLength = onchainBytecode.length;
+            // 使用实际合约名获取本地 bytecode
+            const localData = await this.getLocalBytecode(contractName);
+            result.localBytecodeLength = localData.bytecode.length;
+            const comparison = this.compareBytecode(onchainBytecode, localData.bytecode, localData.abi, localData.immutableReferences);
+            result.matches = comparison.matches;
+            result.reason = comparison.reason;
+        }
+        catch (error) {
+            result.error = error.message;
+        }
+        // A known historical EVM proxy must match its complete package runtime,
+        // including metadata; no immutable masking or chain-only trust is allowed.
+        if (!result.matches && isProxyCheck && onchainBytecode
+            && this.scheme !== 'zksync-eravm'
+            && this.hre.config.networks?.[contractInfo.network]?.zksync !== true) {
+            const legacy = (0, legacyProxyArtifact_js_1.matchLegacyProxyArtifact)(this.hre.config.paths?.root || process.cwd(), onchainBytecode);
+            if (legacy) {
+                result.matches = true;
+                result.error = null;
+                result.reason = legacy.reason;
+                result.localBytecodeLength = legacy.length;
+            }
+        }
+        return result;
+    }
+    /**
+     * 检查指定网络的合约
+     */
+    async checkNetworkContracts(networkName) {
+        if (!this.addressData[networkName]) {
+            throw new Error(`No contracts found for network: ${networkName}`);
+        }
+        const results = [];
+        const contracts = this.addressData[networkName];
+        for (const [contractName, address] of Object.entries(contracts)) {
+            const contractInfo = {
+                name: contractName,
+                address: address,
+                network: networkName
+            };
+            const result = await this.checkContract(contractInfo);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * 检查指定合约（跨所有网络）
+     */
+    async checkSpecificContract(contractName) {
+        const results = [];
+        for (const [networkName, contracts] of Object.entries(this.addressData)) {
+            if (contracts[contractName]) {
+                const contractInfo = {
+                    name: contractName,
+                    address: contracts[contractName],
+                    network: networkName
+                };
+                const result = await this.checkContract(contractInfo);
+                results.push(result);
+            }
+        }
+        if (results.length === 0) {
+            throw new Error(`Contract ${contractName} not found on any network`);
+        }
+        return results;
+    }
+    /**
+     * 检查所有合约
+     */
+    async checkAllContracts() {
+        const results = [];
+        for (const network of Object.keys(this.addressData)) {
+            try {
+                const networkResults = await this.checkNetworkContracts(network);
+                results.push(...networkResults);
+            }
+            catch (error) {
+                console.log(`⚠️ Skipping network ${network}: ${error.message}`);
+            }
+        }
+        return results;
+    }
+    /**
+     * 生成以network为key，contractName为二级key的结果结构
+     */
+    generateNetworkContractResults(results) {
+        const networkResults = {};
+        results.forEach(result => {
+            const network = result.network;
+            const contractName = result.contractName;
+            if (!networkResults[network]) {
+                networkResults[network] = {};
+            }
+            networkResults[network][contractName] = {
+                contract: result.contract,
+                ...(result.scheme ? { scheme: result.scheme } : {}),
+                address: result.address,
+                matches: result.matches,
+                error: result.error,
+                reason: result.reason,
+                onChainBytecodeLength: result.onChainBytecodeLength,
+                localBytecodeLength: result.localBytecodeLength,
+                onChainBytecodeHash: result.onChainBytecodeHash,
+                localBytecodeHash: result.localBytecodeHash,
+                onChainBytecodeHashNormalized: result.onChainBytecodeHashNormalized,
+                localBytecodeHashNormalized: result.localBytecodeHashNormalized
+            };
+        });
+        return networkResults;
+    }
+}
+exports.BytecodeChecker = BytecodeChecker;
+//# sourceMappingURL=BytecodeChecker.js.map

package/dist-cjs/core/BytecodeChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BytecodeChecker.js","sourceRoot":"","sources":["../../src/core/BytecodeChecker.ts"],"names":[],"mappings":";;;AAAA,+DAAwF;AACxF,qEAAoE;AA8BpE,MAAa,eAAe;IAClB,GAAG,CAA4B;IAC/B,WAAW,CAAiB;IAC5B,MAAM,CAAoB;IAElC,YACE,GAA8B,EAC9B,WAA2B,EAC3B,MAAyB;QAEzB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;OASG;IACK,iBAAiB,CAAC,IAAY;QACpC,iBAAiB;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAElE,kBAAkB;QAClB,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEvD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,kBAAkB;YAClB,MAAM,KAAK,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YAC1D,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;YAElE,OAAO;gBACL,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK;gBAC1C,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,SAAS,CAAC,CAAC,CAAC,YAAY;aAChE,CAAC;QACJ,CAAC;QAED,gBAAgB;QAChB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,OAAe,EAAE,OAAe;QACvD,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAQ,CAAC;YAC/D,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,8BAA8B,CAAC,CAAC;YACpE,CAAC;YAED,MAAM,MAAM,GAAI,IAAI,CAAC,GAAW,CAAC,MAAM,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,eAAe,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YAC/D,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACjD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAAC,YAAoB;QACzC,IAAI,CAAC;YACH,+BAA+B;YAC/B,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACrC,OAAO,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC5C,CAAC;YAED,OAAO,MAAM,IAAI,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,qBAAqB;QACjC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,mCAAmC;gBACnC,yDAAyD,CAC1D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,wBAAwB,CAAC,YAAoB;QACzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,KAAK,cAAc;gBACnD,CAAC,CAAC,sBAAsB;gBACxB,CAAC,CAAC,mBAAmB,CAAC;YACxB,IAAI,QAAQ,CAAC,OAAO,KAAK,cAAc,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CACb,YAAY,YAAY,mBAAmB,IAAI,CAAC,MAAM,oBAAoB,cAAc,EAAE,CAC3F,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,mBAAmB,GAAwB,EAAE,CAAC;QAElD,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;QACvC,MAAM,oBAAoB,GAAG,QAAQ,CAAC,YAAY,CAAC;QACnD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC;QAErD,IACE,OAAO,UAAU,KAAK,QAAQ;YAC9B,OAAO,oBAAoB,KAAK,QAAQ;YACxC,OAAO,YAAY,KAAK,UAAU,EAClC,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,kBAAkB,GAAG,GAAG,UAAU,IAAI,oBAAoB,EAAE,CAAC;gBACnE,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;gBAClF,MAAM,kBAAkB,GAAG,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,oBAAoB,CAAC;oBAC3F,EAAE,GAAG,EAAE,gBAAgB,EAAE,mBAAmB,CAAC;gBAE/C,IACE,kBAAkB;oBAClB,OAAO,kBAAkB,KAAK,QAAQ;oBACtC,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAClC,CAAC;oBACD,mBAAmB,GAAG,kBAAyC,CAAC;gBAClE,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,mBAAmB,GAAG,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,QAAQ,CAAC,gBAAgB;YACnC,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,mBAAmB;SACpB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,QAAgB;QAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACvD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC;YAAE,OAAO,IAAI,CAAC;QACrD,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,cAAc,CAAC;QACvD,IAAI,cAAc,KAAK,CAAC,IAAI,aAAa,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAE/C,uEAAuE;QACvE,wEAAwE;QACxE,2EAA2E;QAC3E,4EAA4E;QAC5E,0EAA0E;QAC1E,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,IAAI,IAAA,2CAA2B,EAAC,IAAI,CAAC,KAAK,IAAA,4BAAY,EAAC,UAAU,CAAC,EAAE,CAAC;gBACnE,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;QACrE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,4BAA4B,CAC1B,WAAmB,EACnB,SAAiB;QAEjB,MAAM,YAAY,GAAsB,EAAE,CAAC;QAC3C,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;QAClD,IAAI,KAA6B,CAAC;QAElC,IAAI,eAAe,GAAG,SAAS,CAAC;QAChC,IAAI,iBAAiB,GAAG,WAAW,CAAC;QAEpC,MAAM,YAAY,GAA6C,EAAE,CAAC;QAClE,OAAO,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3D,YAAY,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,gBAAgB;QAChB,KAAK,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAEhC,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,IAAI,KAAK,GAAG,EAAE;gBACpD,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,EAAE,CAAC;gBAC1C,CAAC,CAAC,EAAE,CAAC;YAEP,YAAY,CAAC,OAAO,CAAC;gBACnB,WAAW;gBACX,QAAQ,EAAE,KAAK;gBACf,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS;aAChE,CAAC,CAAC;YAEH,eAAe,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;YACzG,IAAI,aAAa,EAAE,CAAC;gBAClB,iBAAiB,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;YACjH,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,2BAA2B,CACzB,WAAmB,EACnB,SAAiB;QAEjB,6DAA6D;QAC7D,MAAM,cAAc,GAAG,gBAAgB,CAAC;QACxC,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAE7B,mDAAmD;QACnD,IAAI,WAAW,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEjD,mCAAmC;QACnC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAE3F,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,iBAAiB,GAAG,IAAI,GAAG,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAEtE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,EAAE,CAAC;IAC3F,CAAC;IAED;;OAEG;IACK,8BAA8B,CACpC,WAAmB,EACnB,SAAiB,EACjB,mBAAwC;QAExC,IACE,CAAC,mBAAmB;YACpB,OAAO,mBAAmB,KAAK,QAAQ;YACvC,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,MAAM,KAAK,CAAC,EAC7C,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,wCAAwC;aACjD,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAMP,EAAE,CAAC;QAER,KAAK,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1D,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,sBAAsB,EAAE,SAAS;iBAC1C,CAAC;YACJ,CAAC;YAED,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAkB,CAAC;YAExD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;gBACvD,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;gBACpC,IACE,CAAC,SAAS;oBACV,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC;oBAClC,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;oBACnC,SAAS,CAAC,KAAK,GAAG,CAAC;oBACnB,SAAS,CAAC,MAAM,IAAI,CAAC,EACrB,CAAC;oBACD,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE,sBAAsB,EAAE,IAAI,KAAK,qCAAqC;qBAC/E,CAAC;gBACJ,CAAC;gBAED,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;gBACrC,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;gBACvC,MAAM,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;gBAEpC,IAAI,MAAM,GAAG,WAAW,CAAC,MAAM,IAAI,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;oBAC7D,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE,sBAAsB,EAAE,IAAI,KAAK,QAAQ;qBAClD,CAAC;gBACJ,CAAC;gBAED,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACzD,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAC/D,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;oBAC5D,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE,sBAAsB,EAAE,YAAY;qBAC7C,CAAC;gBACJ,CAAC;gBACD,qBAAqB,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;gBAE1D,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,wCAAwC;aACjD,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3F,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACnC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACvC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,6BAA6B,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,KAAK,OAAO,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,KAAK,GAAG;iBACxG,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,aAAa,GAAG,WAAW,CAAC;QAChC,IAAI,WAAW,GAAG,SAAS,CAAC;QAC5B,KAAK,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YACxD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACzC,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAClG,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9F,CAAC;QAED,IAAI,aAAa,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,yCAAyC;aAClD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,gCAAgC,MAAM,CAAC,MAAM,KAAK;SAC3D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,eAAe,CACb,eAAuB,EACvB,aAAqB,EACrB,OAAqB,IAAI,EACzB,sBAA2C,EAAE;QAE7C,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;QAClE,IAAI,eAAe,GAAG,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAE5D,IAAI,YAAY,GAAsB,EAAE,CAAC;QACzC,IAAI,iBAAiB,GAAG,iBAAiB,CAAC;QAC1C,IAAI,eAAe,GAAG,eAAe,CAAC;QACtC,IAAI,kBAAkB,GAAkB,IAAI,CAAC;QAE7C,4CAA4C;QAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,2BAA2B,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;QAC5F,IAAI,cAAc,EAAE,CAAC;YACnB,iBAAiB,GAAG,cAAc,CAAC,OAAO,CAAC;YAC3C,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC;YACvC,kBAAkB,GAAG,cAAc,CAAC,WAAW,CAAC;QAClD,CAAC;QAED,iCAAiC;QACjC,MAAM,sBAAsB,GAAG,uBAAuB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7E,IAAI,sBAAsB,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,4BAA4B,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;YACrF,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC;YACnC,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC;YAC/B,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACrC,CAAC;QAED,WAAW;QACX,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,IAAI,kBAAkB,EAAE,CAAC;YACvB,UAAU,CAAC,IAAI,CAAC,gBAAgB,kBAAkB,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,UAAU,CAAC,IAAI,CAAC,UAAU,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAE7E,IAAI,iBAAiB,KAAK,eAAe,EAAE,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO,WAAW,EAAE;gBAC5B,YAAY,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;aACjE,CAAC;QACJ,CAAC;QAED,MAAM,mBAAmB,GAAG,IAAI,CAAC,8BAA8B,CAC7D,iBAAiB,EACjB,eAAe,EACf,mBAAmB,CACpB,CAAC;QAEF,OAAO;YACL,GAAG,mBAAmB;YACtB,MAAM,EAAE,mBAAmB,CAAC,OAAO;gBACjC,CAAC,CAAC,GAAG,mBAAmB,CAAC,MAAM,GAAG,WAAW,EAAE;gBAC/C,CAAC,CAAC,mBAAmB,CAAC,MAAM;YAC9B,YAAY,EAAE,mBAAmB,CAAC,OAAO,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;gBAClE,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,YAInB;QACC,iBAAiB;QACjB,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAE1E,cAAc;QACd,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAE/C,uBAAuB;QACvB,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAEtE,yBAAyB;QACzB,MAAM,gBAAgB,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QAE3F,kCAAkC;QAClC,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAElE,0CAA0C;QAC1C,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAExE,MAAM,MAAM,GAAgB;YAC1B,QAAQ,EAAE,cAAc,EAAG,QAAQ;YACnC,YAAY,EAAE,SAAS,EAAI,eAAe;YAC1C,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE;YACV,qBAAqB,EAAE,CAAC;YACxB,mBAAmB,EAAE,CAAC;SACvB,CAAC;QAEF,IAAI,eAAmC,CAAC;QACxC,IAAI,CAAC;YACH,eAAe,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;YAC5F,MAAM,CAAC,qBAAqB,GAAG,eAAe,CAAC,MAAM,CAAC;YAEtD,uBAAuB;YACvB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;YAC5D,MAAM,CAAC,mBAAmB,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;YAEvD,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CACrC,eAAe,EACf,SAAS,CAAC,QAAQ,EAClB,SAAS,CAAC,GAAG,EACb,SAAS,CAAC,mBAAmB,CAC9B,CAAC;YACF,MAAM,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;YACpC,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAEpC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,CAAC;QAED,wEAAwE;QACxE,2EAA2E;QAC3E,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,YAAY,IAAI,eAAe;eACjD,IAAI,CAAC,MAAM,KAAK,cAAc;eAC9B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;YACvE,MAAM,MAAM,GAAG,IAAA,iDAAwB,EAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;YACvG,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;gBACpB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;gBAC9B,MAAM,CAAC,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,WAAmB;QAC7C,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,WAAW,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAEhD,KAAK,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAChE,MAAM,YAAY,GAAG;gBACnB,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,OAAO;gBAChB,OAAO,EAAE,WAAW;aACrB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,YAAoB;QAC9C,MAAM,OAAO,GAAkB,EAAE,CAAC;QAElC,KAAK,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACxE,IAAI,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC5B,MAAM,YAAY,GAAG;oBACnB,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,SAAS,CAAC,YAAY,CAAC;oBAChC,OAAO,EAAE,WAAW;iBACrB,CAAC;gBAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;gBACtD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,YAAY,YAAY,2BAA2B,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB;QACrB,MAAM,OAAO,GAAkB,EAAE,CAAC;QAElC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;gBACjE,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;YAClC,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,8BAA8B,CAAC,OAAsB;QACnD,MAAM,cAAc,GAAwC,EAAE,CAAC;QAE/D,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACvB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YAC/B,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;YAEzC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7B,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YAC/B,CAAC;YAED,cAAc,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG;gBACtC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;gBACnD,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;gBAC/C,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;gBAC/C,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;gBAC3C,6BAA6B,EAAE,MAAM,CAAC,6BAA6B;gBACnE,2BAA2B,EAAE,MAAM,CAAC,2BAA2B;aAChE,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,cAAc,CAAC;IACxB,CAAC;CACF;AA7nBD,0CA6nBC"}

package/dist-cjs/core/legacyProxyArtifact.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchLegacyProxyArtifact = matchLegacyProxyArtifact;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_module_1 = require("node:module");
+const node_crypto_1 = require("node:crypto");
+/** Known OZ EVM proxy artifacts only; never normalize or mask historical runtime. */
+function matchLegacyProxyArtifact(root, onchain) {
+    if (!/^0x(?:[0-9a-fA-F]{2})+$/.test(onchain))
+        return;
+    const projectRequire = (0, node_module_1.createRequire)(node_path_1.default.join(node_path_1.default.resolve(root), 'package.json'));
+    for (const family of ['contracts-v5', 'contracts']) {
+        const artifactPath = `artifacts/@openzeppelin/${family}/proxy/ERC1967/ERC1967Proxy.sol/ERC1967Proxy.json`;
+        try {
+            const packagePath = projectRequire.resolve('@openzeppelin/upgrades-core/package.json');
+            const pkg = JSON.parse(node_fs_1.default.readFileSync(packagePath, 'utf8'));
+            if (pkg.name !== '@openzeppelin/upgrades-core' || typeof pkg.version !== 'string')
+                continue;
+            const raw = node_fs_1.default.readFileSync(node_path_1.default.join(node_path_1.default.dirname(packagePath), artifactPath));
+            const artifact = JSON.parse(raw.toString('utf8'));
+            if (artifact._format !== 'hh-sol-artifact-1' || artifact.contractName !== 'ERC1967Proxy'
+                || artifact.sourceName !== '@openzeppelin/contracts/proxy/ERC1967/ERC1967Proxy.sol'
+                || typeof artifact.deployedBytecode !== 'string'
+                || artifact.deployedBytecode.toLowerCase() !== onchain.toLowerCase())
+                continue;
+            const digest = (0, node_crypto_1.createHash)('sha256').update(raw).digest('hex');
+            return {
+                length: artifact.deployedBytecode.length,
+                reason: `历史代理完整字节码匹配 @openzeppelin/upgrades-core@${pkg.version}/${artifactPath}; artifact SHA-256 ${digest}`,
+            };
+        }
+        catch {
+            // Missing or invalid evidence is not a match; the original failure is retained.
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=legacyProxyArtifact.js.map

package/dist-cjs/core/legacyProxyArtifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacyProxyArtifact.js","sourceRoot":"","sources":["../../src/core/legacyProxyArtifact.ts"],"names":[],"mappings":";;;;;AAMA,4DAyBC;AA/BD,sDAAyB;AACzB,0DAA6B;AAC7B,6CAA4C;AAC5C,6CAAyC;AAEzC,qFAAqF;AACrF,SAAgB,wBAAwB,CAAC,IAAY,EAAE,OAAe;IACpE,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO;IACrD,MAAM,cAAc,GAAG,IAAA,2BAAa,EAAC,mBAAI,CAAC,IAAI,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IACpF,KAAK,MAAM,MAAM,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,EAAE,CAAC;QACnD,MAAM,YAAY,GAAG,2BAA2B,MAAM,mDAAmD,CAAC;QAC1G,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC;YACvF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;YAC7D,IAAI,GAAG,CAAC,IAAI,KAAK,6BAA6B,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;gBAAE,SAAS;YAC5F,MAAM,GAAG,GAAG,iBAAE,CAAC,YAAY,CAAC,mBAAI,CAAC,IAAI,CAAC,mBAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;YAChF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAClD,IAAI,QAAQ,CAAC,OAAO,KAAK,mBAAmB,IAAI,QAAQ,CAAC,YAAY,KAAK,cAAc;mBACnF,QAAQ,CAAC,UAAU,KAAK,wDAAwD;mBAChF,OAAO,QAAQ,CAAC,gBAAgB,KAAK,QAAQ;mBAC7C,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE;gBAAE,SAAS;YACjF,MAAM,MAAM,GAAG,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9D,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,MAAM;gBACxC,MAAM,EAAE,2CAA2C,GAAG,CAAC,OAAO,IAAI,YAAY,sBAAsB,MAAM,EAAE;aAC7G,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,gFAAgF;QAClF,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist-cjs/core/preparation/artifacts.js

@@ -3,19 +3,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.artifactIdentity = exports.collectZkFactoryDeps = exports.assertArtifactScheme = void 0;
+exports.artifactIdentity = exports.collectZkFactoryDeps = exports.assertArtifactScheme = exports.assertArtifactIdentity = void 0;
 const node_crypto_1 = __importDefault(require("node:crypto"));
 const ethers_1 = require("ethers");
 const normalize_js_1 = require("./normalize.js");
 const jsonSafe = (value) => JSON.parse(JSON.stringify(value));
-const assertArtifactScheme = (artifact, scheme) => {
+const assertArtifactIdentity = (artifact, scheme) => {
     const expected = scheme === 'evm'
         ? 'hh-sol-artifact-1'
         : 'hh-zksolc-artifact-1';
     if (artifact._format !== expected) {
         throw new Error(`${scheme} requires artifact format ${expected}`);
     }
-    if (!artifact.sourceName || !artifact.contractName || !artifact.bytecode || artifact.bytecode === '0x') {
+    if (!artifact.sourceName || !artifact.contractName || !artifact.bytecode) {
         throw new Error('artifact is missing source, contract, or bytecode');
     }
     if (!(0, ethers_1.isHexString)(artifact.bytecode))
@@ -27,6 +27,13 @@ const assertArtifactScheme = (artifact, scheme) => {
         throw new Error('hh-zksolc artifact factoryDeps must be an object');
     }
 };
+exports.assertArtifactIdentity = assertArtifactIdentity;
+/** Identity/ABI roots may be interfaces. Deployment always requires code. */
+const assertArtifactScheme = (artifact, scheme) => {
+    (0, exports.assertArtifactIdentity)(artifact, scheme);
+    if (artifact.bytecode === '0x')
+        throw new Error('deployment artifact bytecode must be non-empty');
+};
 exports.assertArtifactScheme = assertArtifactScheme;
 const artifactName = (artifact) => (`${artifact.sourceName}:${artifact.contractName}`);
 const collectZkFactoryDeps = async (artifacts, rootArtifact) => {
@@ -67,7 +74,7 @@ const collectZkFactoryDeps = async (artifacts, rootArtifact) => {
 };
 exports.collectZkFactoryDeps = collectZkFactoryDeps;
 const artifactIdentity = (artifact, scheme) => {
-    (0, exports.assertArtifactScheme)(artifact, scheme);
+    (0, exports.assertArtifactIdentity)(artifact, scheme);
     const digest = node_crypto_1.default.createHash('sha256').update((0, normalize_js_1.canonicalPreparationJson)(jsonSafe({
         _format: artifact._format,
         sourceName: artifact.sourceName,