gate-evm-tools 1.0.22 → 1.0.24

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

@@ -0,0 +1,166 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncZkManifest = void 0;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const ethers_1 = require("ethers");
+const zksync_ethers_1 = require("zksync-ethers");
+const artifacts_js_1 = require("./artifacts.js");
+const manifest_js_1 = require("./manifest.js");
+const zkUpgradeValidation_js_1 = require("./zkUpgradeValidation.js");
+const manifestTransaction_js_1 = require("../../utils/manifestTransaction.js");
+const bytecodeHash = (bytecode, label) => {
+    try {
+        return (0, ethers_1.hexlify)(zksync_ethers_1.utils.hashBytecode(bytecode)).toLowerCase();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`${label} is not valid EraVM bytecode: ${message}`);
+    }
+};
+const readManifestForSync = (manifestFile, fallbackFile) => {
+    const canonicalExists = node_fs_1.default.existsSync(manifestFile);
+    const fallbackExists = fallbackFile !== manifestFile && node_fs_1.default.existsSync(fallbackFile);
+    if (!canonicalExists && !fallbackExists) {
+        return { manifestVersion: '3.2', impls: {}, proxies: [] };
+    }
+    const selected = canonicalExists ? manifestFile : fallbackFile;
+    const stat = node_fs_1.default.lstatSync(selected);
+    if (stat.isSymbolicLink() || !stat.isFile()) {
+        throw new Error('OpenZeppelin manifest must be a regular file');
+    }
+    return (0, manifest_js_1.parseTargetManifest)(node_fs_1.default.readFileSync(selected));
+};
+const normalizeTransactionHash = (raw) => {
+    if (raw === undefined)
+        return undefined;
+    if (!/^0x[0-9a-fA-F]{64}$/.test(raw)) {
+        throw new Error('sync transactionHash must be 32-byte hex');
+    }
+    return raw.toLowerCase();
+};
+const candidateRequest = (options) => ({
+    version: 1,
+    kind: 'uups-upgrade',
+    scheme: 'zksync-eravm',
+    network: options.network,
+    target: options.target,
+    contract: options.contract,
+    constructorArgs: options.constructorArgs ?? [],
+    factory: '0x0000000000000000000000000000000000000001',
+    proxyKind: 'uups',
+    proxy: options.proxy,
+    implementationSalt: `0x${'00'.repeat(31)}01`,
+    ...(options.unsafeAllow ? { unsafeAllow: options.unsafeAllow } : {}),
+});
+const syncZkManifest = async (options, dependencies = {}) => {
+    if (options.scheme !== 'zksync-eravm')
+        throw new Error('zkSync sync requires zksync-eravm');
+    if (options.hre.network.config?.zksync !== true) {
+        throw new Error(`Hardhat network ${options.hre.network.name} is not configured for zkSync`);
+    }
+    if (options.network !== options.hre.network.name) {
+        throw new Error(`sync network ${options.network} does not match Hardhat network ${options.hre.network.name}`);
+    }
+    if (options.target !== options.network) {
+        throw new Error('zkSync sync requires target to equal the active network');
+    }
+    const root = node_path_1.default.resolve(options.root ?? options.hre.config.paths.root);
+    if (root !== node_path_1.default.resolve(options.hre.config.paths.root)) {
+        throw new Error('sync root does not match the Hardhat project root');
+    }
+    const proxy = (0, ethers_1.getAddress)(options.proxy).toLowerCase();
+    const txHash = normalizeTransactionHash(options.transactionHash);
+    await options.hre.run('compile', { quiet: true });
+    const artifact = await options.hre.artifacts.readArtifact(options.contract);
+    (0, artifacts_js_1.assertArtifactScheme)(artifact, 'zksync-eravm');
+    const network = await options.hre.ethers.provider.getNetwork();
+    const chainId = Number(network.chainId);
+    if (!Number.isSafeInteger(chainId) || chainId <= 0)
+        throw new Error('provider chainId is invalid');
+    const configuredChainId = options.hre.network.config?.chainId;
+    if (configuredChainId !== undefined && configuredChainId !== chainId) {
+        throw new Error(`provider chainId ${chainId} does not match configured chainId ${configuredChainId}`);
+    }
+    const request = candidateRequest(options);
+    const candidate = await (dependencies.loadCandidate ?? zkUpgradeValidation_js_1.loadZkValidationCandidate)(options.hre, request, artifact);
+    (dependencies.assertImplementationSafe ?? zkUpgradeValidation_js_1.assertZkImplementationSafe)(candidate);
+    if (!/^[0-9a-f]{64}$/.test(candidate.version.linkedWithoutMetadata)) {
+        throw new Error('zkSync implementation version key is invalid');
+    }
+    const implementation = (0, ethers_1.getAddress)(await (dependencies.getCurrentImplementation ?? zkUpgradeValidation_js_1.getZkCurrentImplementation)(options.hre, proxy)).toLowerCase();
+    const [proxyCode, implementationCode] = await Promise.all([
+        options.hre.ethers.provider.getCode(proxy),
+        options.hre.ethers.provider.getCode(implementation),
+    ]);
+    if (!proxyCode || proxyCode === '0x')
+        throw new Error(`proxy has no code at ${proxy}`);
+    if (!implementationCode || implementationCode === '0x') {
+        throw new Error(`implementation has no code at ${implementation}`);
+    }
+    const expectedHash = bytecodeHash(artifact.bytecode, 'artifact bytecode');
+    const actualHash = bytecodeHash(implementationCode, 'deployed implementation bytecode');
+    if (actualHash !== expectedHash) {
+        throw new Error(`implementation bytecode mismatch: actual=${actualHash} expected=${expectedHash}`);
+    }
+    const paths = (0, manifest_js_1.resolveTargetManifestPaths)(root, options.target, chainId);
+    const transaction = await (0, manifestTransaction_js_1.withManifestTransaction)({
+        root,
+        manifestFile: paths.file,
+        fallbackFile: paths.fallbackFile,
+        operation: async ({ manifestFile, fallbackFile, writeManifestAtomic }) => {
+            const manifest = readManifestForSync(manifestFile, fallbackFile);
+            const versionKey = candidate.version.linkedWithoutMetadata;
+            const existing = manifest.impls[versionKey];
+            if (existing && (0, manifest_js_1.hashStorageLayout)(existing.layout) !== (0, manifest_js_1.hashStorageLayout)(candidate.layout)) {
+                throw new Error('registered implementation layout conflicts with compiled artifact');
+            }
+            const priorAddresses = existing
+                ? [existing.address, ...(existing.allAddresses ?? [])]
+                : [];
+            const allAddresses = [...new Set([...priorAddresses, implementation].map((address) => (0, ethers_1.getAddress)(address).toLowerCase()))];
+            manifest.impls[versionKey] = {
+                address: implementation,
+                ...(txHash ? { txHash } : {}),
+                layout: candidate.layout,
+                ...(allAddresses.length > 1 ? { allAddresses } : {}),
+            };
+            manifest.proxies = manifest.proxies.filter((entry) => entry.address.toLowerCase() !== proxy);
+            manifest.proxies.push({ address: proxy, kind: 'uups' });
+            if (fallbackFile !== manifestFile && node_fs_1.default.existsSync(fallbackFile))
+                node_fs_1.default.unlinkSync(fallbackFile);
+            writeManifestAtomic(Buffer.from(`${JSON.stringify(manifest, null, 2)}\n`));
+            const verified = (0, manifest_js_1.parseTargetManifest)(node_fs_1.default.readFileSync(manifestFile));
+            if (verified.impls[versionKey]?.address.toLowerCase() !== implementation) {
+                throw new Error('implementation registration post-condition failed');
+            }
+            const registeredProxy = verified.proxies.find((entry) => entry.address.toLowerCase() === proxy);
+            if (registeredProxy?.kind !== 'uups') {
+                throw new Error('proxy registration post-condition failed');
+            }
+            return {
+                scheme: 'zksync-eravm',
+                network: options.network,
+                target: options.target,
+                chainId: chainId.toString(10),
+                proxy,
+                implementation,
+                artifact: (0, artifacts_js_1.artifactIdentity)(artifact, 'zksync-eravm'),
+                layoutHash: (0, manifest_js_1.hashStorageLayout)(candidate.layout),
+                manifestDigest: node_crypto_1.default.createHash('sha256').update(node_fs_1.default.readFileSync(manifestFile)).digest('hex'),
+                manifestFile,
+            };
+        },
+    });
+    return {
+        ...transaction.value,
+        manifestTransaction: transaction.report,
+        syncReport: transaction.reportFile,
+    };
+};
+exports.syncZkManifest = syncZkManifest;
+//# sourceMappingURL=zkManifestSync.js.map

package/dist-cjs/core/preparation/zkManifestSync.js.map

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

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

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateZkImplementation = exports.getZkCurrentImplementation = exports.assertZkImplementationSafe = exports.loadZkValidationCandidate = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const ethers_1 = require("ethers");
+const upgrades_core_1 = require("@openzeppelin/upgrades-core");
+const artifacts_js_1 = require("./artifacts.js");
+const manifest_js_1 = require("./manifest.js");
+const confinedValidationFile = (hre) => {
+    const root = node_path_1.default.resolve(hre.config.paths.root);
+    const cache = node_path_1.default.resolve(hre.config.paths.cache);
+    const relative = node_path_1.default.relative(root, cache);
+    if (relative === '..' || relative.startsWith(`..${node_path_1.default.sep}`) || node_path_1.default.isAbsolute(relative)) {
+        throw new Error('Hardhat validation cache must stay inside the project root');
+    }
+    const file = node_path_1.default.join(cache, 'validations.json');
+    if (!node_fs_1.default.existsSync(file)) {
+        throw new Error('zkSync validations cache is missing; compile with the pinned Matter Labs plugin');
+    }
+    const stat = node_fs_1.default.lstatSync(file);
+    if (stat.isSymbolicLink() || !stat.isFile()) {
+        throw new Error('zkSync validations cache must be a regular file');
+    }
+    return file;
+};
+const loadZkValidationCandidate = async (hre, request, artifact) => {
+    const file = confinedValidationFile(hre);
+    const rawValidations = JSON.parse(node_fs_1.default.readFileSync(file, 'utf8'));
+    if (!(0, upgrades_core_1.isCurrentValidationData)(rawValidations)) {
+        throw new Error('zkSync validations cache is missing or outdated');
+    }
+    const validations = rawValidations;
+    const factory = new ethers_1.ContractFactory(artifact.abi, artifact.bytecode);
+    const constructorInput = factory.interface.encodeDeploy(request.constructorArgs);
+    const version = (0, upgrades_core_1.getVersion)(artifact.bytecode, artifact.bytecode, constructorInput);
+    const validationOptions = (0, upgrades_core_1.withValidationDefaults)({
+        kind: 'uups',
+        ...(request.unsafeAllow ? { unsafeAllow: request.unsafeAllow } : {}),
+    });
+    return {
+        validations,
+        version,
+        layout: (0, upgrades_core_1.getStorageLayout)(validations, version),
+        validationOptions,
+    };
+};
+exports.loadZkValidationCandidate = loadZkValidationCandidate;
+const assertZkImplementationSafe = (candidate) => {
+    (0, upgrades_core_1.assertUpgradeSafe)(candidate.validations, candidate.version, candidate.validationOptions);
+};
+exports.assertZkImplementationSafe = assertZkImplementationSafe;
+const getZkCurrentImplementation = async (hre, proxy) => (0, upgrades_core_1.getImplementationAddress)(hre.network.provider, proxy);
+exports.getZkCurrentImplementation = getZkCurrentImplementation;
+const selectedChainId = async (hre) => {
+    const configured = hre.network.config?.chainId;
+    if (configured !== undefined)
+        return configured;
+    return (0, upgrades_core_1.getChainId)(hre.network.provider);
+};
+const validateZkImplementation = async (hre, request, artifact, dependencies = {}) => {
+    (0, artifacts_js_1.assertArtifactScheme)(artifact, 'zksync-eravm');
+    if (hre.network.config?.zksync !== true) {
+        throw new Error(`Hardhat network ${hre.network.name} is not configured for zkSync`);
+    }
+    const candidate = await (dependencies.loadCandidate ?? exports.loadZkValidationCandidate)(hre, request, artifact);
+    (dependencies.assertImplementationSafe ?? exports.assertZkImplementationSafe)(candidate);
+    if (request.kind === 'uups-placeholder-deploy') {
+        return {
+            kind: 'uups-initial',
+            engine: 'matterlabs-openzeppelin',
+            artifactFormat: 'hh-zksolc-artifact-1',
+            implementationSafe: true,
+        };
+    }
+    const implementation = (0, ethers_1.getAddress)(await (dependencies.getCurrentImplementation ?? exports.getZkCurrentImplementation)(hre, request.proxy)).toLowerCase();
+    const state = (0, manifest_js_1.readRegisteredZkUpgradeState)({
+        root: hre.config.paths.root,
+        target: request.target,
+        chainId: await selectedChainId(hre),
+        proxy: request.proxy,
+        currentImplementation: implementation,
+    });
+    (0, upgrades_core_1.assertStorageUpgradeSafe)(state.oldLayout, candidate.layout, candidate.validationOptions);
+    return {
+        kind: 'uups-upgrade',
+        engine: 'matterlabs-openzeppelin',
+        artifactFormat: 'hh-zksolc-artifact-1',
+        implementationSafe: true,
+        storageLayoutCompatible: true,
+        currentImplementation: implementation,
+        oldLayoutHash: (0, manifest_js_1.hashStorageLayout)(state.oldLayout),
+        newLayoutHash: (0, manifest_js_1.hashStorageLayout)(candidate.layout),
+        manifestDigest: state.digest,
+    };
+};
+exports.validateZkImplementation = validateZkImplementation;
+//# sourceMappingURL=zkUpgradeValidation.js.map

package/dist-cjs/core/preparation/zkUpgradeValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zkUpgradeValidation.js","sourceRoot":"","sources":["../../../src/core/preparation/zkUpgradeValidation.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAC7B,mCAAqD;AACrD,+DAcqC;AAErC,iDAA6E;AAC7E,+CAGuB;AA2CvB,MAAM,sBAAsB,GAAG,CAAC,GAAoB,EAAU,EAAE;IAC9D,MAAM,IAAI,GAAG,mBAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,mBAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,mBAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,mBAAI,CAAC,GAAG,EAAE,CAAC,IAAI,mBAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3F,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,IAAI,GAAG,mBAAI,CAAC,IAAI,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;IAClD,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,IAAI,GAAG,iBAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEK,MAAM,yBAAyB,GAAG,KAAK,EAC5C,GAAoB,EACpB,OAAsB,EACtB,QAA0B,EACM,EAAE;IAClC,MAAM,IAAI,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC;IAC5E,IAAI,CAAC,IAAA,uCAAuB,EAAC,cAAgC,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,WAAW,GAAG,cAAuC,CAAC;IAC5D,MAAM,OAAO,GAAG,IAAI,wBAAe,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrE,MAAM,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACjF,MAAM,OAAO,GAAG,IAAA,0BAAU,EAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IACnF,MAAM,iBAAiB,GAAG,IAAA,sCAAsB,EAAC;QAC/C,IAAI,EAAE,MAAM;QACZ,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChF,CAAC,CAAC;IACH,OAAO;QACL,WAAW;QACX,OAAO;QACP,MAAM,EAAE,IAAA,gCAAgB,EAAC,WAAW,EAAE,OAAO,CAAC;QAC9C,iBAAiB;KAClB,CAAC;AACJ,CAAC,CAAC;AAxBW,QAAA,yBAAyB,6BAwBpC;AAEK,MAAM,0BAA0B,GAAG,CAAC,SAAgC,EAAQ,EAAE;IACnF,IAAA,iCAAiB,EAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;AAC3F,CAAC,CAAC;AAFW,QAAA,0BAA0B,8BAErC;AAEK,MAAM,0BAA0B,GAAG,KAAK,EAC7C,GAAoB,EACpB,KAAa,EACI,EAAE,CAAC,IAAA,wCAAwB,EAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAH/D,QAAA,0BAA0B,8BAGqC;AAE5E,MAAM,eAAe,GAAG,KAAK,EAAE,GAAoB,EAAmB,EAAE;IACtE,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAChD,OAAO,IAAA,0BAAU,EAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEK,MAAM,wBAAwB,GAAG,KAAK,EAC3C,GAAoB,EACpB,OAAsB,EACtB,QAA0B,EAC1B,eAAyC,EAAE,EAC6B,EAAE;IAC1E,IAAA,mCAAoB,EAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC/C,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,OAAO,CAAC,IAAI,+BAA+B,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CACtB,YAAY,CAAC,aAAa,IAAI,iCAAyB,CACxD,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1B,CAAC,YAAY,CAAC,wBAAwB,IAAI,kCAA0B,CAAC,CAAC,SAAS,CAAC,CAAC;IAEjF,IAAI,OAAO,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;QAC/C,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,yBAAyB;YACjC,cAAc,EAAE,sBAAsB;YACtC,kBAAkB,EAAE,IAAI;SACzB,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,IAAA,mBAAU,EAAC,MAAM,CACtC,YAAY,CAAC,wBAAwB,IAAI,kCAA0B,CACpE,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,IAAA,0CAA4B,EAAC;QACzC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI;QAC3B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,MAAM,eAAe,CAAC,GAAG,CAAC;QACnC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,qBAAqB,EAAE,cAAc;KACtC,CAAC,CAAC;IACH,IAAA,wCAAwB,EACtB,KAAK,CAAC,SAAS,EACf,SAAS,CAAC,MAAM,EAChB,SAAS,CAAC,iBAAiB,CAC5B,CAAC;IACF,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,yBAAyB;QACjC,cAAc,EAAE,sBAAsB;QACtC,kBAAkB,EAAE,IAAI;QACxB,uBAAuB,EAAE,IAAI;QAC7B,qBAAqB,EAAE,cAAc;QACrC,aAAa,EAAE,IAAA,+BAAiB,EAAC,KAAK,CAAC,SAAS,CAAC;QACjD,aAAa,EAAE,IAAA,+BAAiB,EAAC,SAAS,CAAC,MAAM,CAAC;QAClD,cAAc,EAAE,KAAK,CAAC,MAAM;KAC7B,CAAC;AACJ,CAAC,CAAC;AAlDW,QAAA,wBAAwB,4BAkDnC"}

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

@@ -0,0 +1,252 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareZkSync = void 0;
+const ethers_1 = require("ethers");
+const zksync_ethers_1 = require("zksync-ethers");
+const artifacts_js_1 = require("./artifacts.js");
+const normalize_js_1 = require("./normalize.js");
+const zkUpgradeValidation_js_1 = require("./zkUpgradeValidation.js");
+const ERC1967_PROXY_ARTIFACT = '@openzeppelin/contracts/proxy/ERC1967/ERC1967Proxy.sol:ERC1967Proxy';
+const CONTRACT_DEPLOYER_INTERFACE = new ethers_1.Interface([
+    'function create2(bytes32 salt, bytes32 bytecodeHash, bytes input) returns (address)',
+]);
+const FACTORY_INTERFACE = new ethers_1.Interface([
+    'function deploy(bytes32 salt, bytes initCode, bytes data, uint256 create2ForwardValue, uint256 callForwardValue) payable returns (address)',
+]);
+const UPGRADE_INTERFACE = new ethers_1.Interface([
+    'function upgradeToAndCall(address newImplementation, bytes data) payable',
+]);
+const assertAddressPolicy = (predictedAddress, policy, label) => {
+    if (!policy)
+        return;
+    const normalized = (0, ethers_1.getAddress)(predictedAddress);
+    if (policy.expectedAddress && normalized !== (0, ethers_1.getAddress)(policy.expectedAddress)) {
+        throw new Error(`${label} predicted ${normalized} but expected ${policy.expectedAddress}`);
+    }
+    if (policy.leadingZeroBytes !== undefined
+        && !normalized.slice(2).toLowerCase().startsWith('00'.repeat(policy.leadingZeroBytes))) {
+        throw new Error(`${label} does not satisfy leadingZeroBytes=${policy.leadingZeroBytes}`);
+    }
+};
+const bytecodeHash = (bytecode, label) => {
+    try {
+        return (0, ethers_1.hexlify)(zksync_ethers_1.utils.hashBytecode(bytecode)).toLowerCase();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`${label} is not valid EraVM bytecode: ${message}`);
+    }
+};
+const assertZeroForwarding = (request) => {
+    if (BigInt(request.create2ForwardValue ?? '0') !== 0n
+        || BigInt(request.callForwardValue ?? '0') !== 0n) {
+        throw new Error('zkSync V1 requires zero factory and call forwarding values');
+    }
+};
+const buildDeployment = async (input) => {
+    (0, artifacts_js_1.assertArtifactScheme)(input.artifact, 'zksync-eravm');
+    const contractFactory = new ethers_1.ContractFactory(input.artifact.abi, input.artifact.bytecode);
+    const constructorInput = contractFactory.interface.encodeDeploy(input.constructorArgs);
+    const selectedBytecodeHash = bytecodeHash(input.artifact.bytecode, `${input.role} bytecode`);
+    const predictedAddress = zksync_ethers_1.utils.create2Address(input.factory, selectedBytecodeHash, input.salt, constructorInput);
+    assertAddressPolicy(predictedAddress, input.policy, input.role);
+    const existingCode = await input.hre.ethers.provider.getCode(predictedAddress);
+    const status = existingCode && existingCode !== '0x' ? 'reused' : 'required';
+    if (status === 'reused') {
+        const existingHash = bytecodeHash(existingCode, `${input.role} deployed bytecode`);
+        if (existingHash !== selectedBytecodeHash) {
+            throw new Error(`${input.role} bytecode mismatch at ${predictedAddress}: `
+                + `actual=${existingHash} expected=${selectedBytecodeHash}`);
+        }
+    }
+    const deployment = {
+        role: input.role,
+        address: predictedAddress,
+        salt: input.salt,
+        status,
+        constructorInput,
+        bytecodeHash: selectedBytecodeHash,
+        constructorInputHash: (0, ethers_1.keccak256)(constructorInput),
+    };
+    if (status === 'reused')
+        return { deployment, contractFactory };
+    const deployerInput = CONTRACT_DEPLOYER_INTERFACE.encodeFunctionData('create2', [
+        input.salt,
+        selectedBytecodeHash,
+        constructorInput,
+    ]);
+    const purpose = input.role === 'contract'
+        ? 'deploy-contract'
+        : input.role === 'implementation'
+            ? 'deploy-implementation'
+            : 'deploy-proxy';
+    const factoryDeps = await (0, artifacts_js_1.collectZkFactoryDeps)(input.hre.artifacts, input.artifact);
+    return {
+        deployment,
+        contractFactory,
+        transaction: {
+            id: purpose,
+            purpose,
+            to: input.factory,
+            value: '0',
+            data: FACTORY_INTERFACE.encodeFunctionData('deploy', [
+                input.salt,
+                deployerInput,
+                '0x',
+                0n,
+                0n,
+            ]),
+            operation: 0,
+            factoryDeps,
+        },
+    };
+};
+const preparePlain = async (hre, request, artifact) => {
+    assertZeroForwarding(request);
+    const prepared = await buildDeployment({
+        hre,
+        role: 'contract',
+        artifact,
+        constructorArgs: request.constructorArgs,
+        factory: request.factory,
+        salt: request.salt,
+        policy: request.addressPolicy,
+    });
+    const network = await hre.ethers.provider.getNetwork();
+    return (0, normalize_js_1.normalizePreparationPlan)({
+        version: 1,
+        requestHash: (0, normalize_js_1.hashPreparationRequest)(request),
+        kind: request.kind,
+        scheme: request.scheme,
+        network: request.network,
+        target: request.target,
+        chainId: network.chainId.toString(),
+        contract: request.contract,
+        artifact: (0, artifacts_js_1.artifactIdentity)(artifact, 'zksync-eravm'),
+        validation: {
+            kind: 'artifact',
+            engine: 'hardhat-artifact',
+            artifactFormat: 'hh-zksolc-artifact-1',
+        },
+        deployments: [prepared.deployment],
+        transactions: prepared.transaction ? [prepared.transaction] : [],
+    });
+};
+const initializerData = (factory, call) => (call ? factory.interface.encodeFunctionData(call.method, call.args) : '0x');
+const prepareUupsInitial = async (hre, request, artifact, dependencies) => {
+    const validation = await (0, zkUpgradeValidation_js_1.validateZkImplementation)(hre, request, artifact, dependencies.validation);
+    if (validation.kind !== 'uups-initial') {
+        throw new Error('zkSync initial UUPS validation returned an invalid result');
+    }
+    const implementation = await buildDeployment({
+        hre,
+        role: 'implementation',
+        artifact,
+        constructorArgs: request.constructorArgs,
+        factory: request.factory,
+        salt: request.implementationSalt,
+    });
+    const proxyArtifact = await hre.artifacts.readArtifact(ERC1967_PROXY_ARTIFACT);
+    (0, artifacts_js_1.assertArtifactScheme)(proxyArtifact, 'zksync-eravm');
+    const proxy = await buildDeployment({
+        hre,
+        role: 'proxy',
+        artifact: proxyArtifact,
+        constructorArgs: [request.placeholderImplementation, '0x'],
+        factory: request.factory,
+        salt: request.proxySalt,
+        policy: request.proxyAddressPolicy,
+    });
+    const transactions = [implementation.transaction, proxy.transaction]
+        .filter((transaction) => transaction !== undefined);
+    transactions.push({
+        id: 'upgrade-proxy',
+        purpose: 'upgrade-proxy',
+        to: proxy.deployment.address,
+        value: '0',
+        data: UPGRADE_INTERFACE.encodeFunctionData('upgradeToAndCall', [
+            implementation.deployment.address,
+            initializerData(implementation.contractFactory, request.call),
+        ]),
+        operation: 0,
+        factoryDeps: [],
+    });
+    const network = await hre.ethers.provider.getNetwork();
+    return (0, normalize_js_1.normalizePreparationPlan)({
+        version: 1,
+        requestHash: (0, normalize_js_1.hashPreparationRequest)(request),
+        kind: request.kind,
+        scheme: request.scheme,
+        network: request.network,
+        target: request.target,
+        chainId: network.chainId.toString(),
+        contract: request.contract,
+        proxyKind: 'uups',
+        artifact: (0, artifacts_js_1.artifactIdentity)(artifact, 'zksync-eravm'),
+        validation,
+        deployments: [implementation.deployment, proxy.deployment],
+        transactions,
+    });
+};
+const prepareUupsUpgrade = async (hre, request, artifact, dependencies) => {
+    const validation = await (0, zkUpgradeValidation_js_1.validateZkImplementation)(hre, request, artifact, dependencies.validation);
+    if (validation.kind !== 'uups-upgrade') {
+        throw new Error('zkSync UUPS upgrade validation returned an invalid result');
+    }
+    const implementation = await buildDeployment({
+        hre,
+        role: 'implementation',
+        artifact,
+        constructorArgs: request.constructorArgs,
+        factory: request.factory,
+        salt: request.implementationSalt,
+        policy: request.implementationAddressPolicy,
+    });
+    const transactions = implementation.transaction ? [implementation.transaction] : [];
+    transactions.push({
+        id: 'upgrade-proxy',
+        purpose: 'upgrade-proxy',
+        to: request.proxy,
+        value: '0',
+        data: UPGRADE_INTERFACE.encodeFunctionData('upgradeToAndCall', [
+            implementation.deployment.address,
+            initializerData(implementation.contractFactory, request.call),
+        ]),
+        operation: 0,
+        factoryDeps: [],
+    });
+    const network = await hre.ethers.provider.getNetwork();
+    return (0, normalize_js_1.normalizePreparationPlan)({
+        version: 1,
+        requestHash: (0, normalize_js_1.hashPreparationRequest)(request),
+        kind: request.kind,
+        scheme: request.scheme,
+        network: request.network,
+        target: request.target,
+        chainId: network.chainId.toString(),
+        contract: request.contract,
+        proxyKind: 'uups',
+        artifact: (0, artifacts_js_1.artifactIdentity)(artifact, 'zksync-eravm'),
+        validation,
+        deployments: [implementation.deployment],
+        transactions,
+    });
+};
+const prepareZkSync = async (hre, request, dependencies = {}) => {
+    if (request.scheme !== 'zksync-eravm') {
+        throw new Error('zkSync adapter received a non-zkSync request');
+    }
+    if (hre.network.config?.zksync !== true) {
+        throw new Error(`Hardhat network ${hre.network.name} is not configured for zkSync`);
+    }
+    const artifact = await hre.artifacts.readArtifact(request.contract);
+    (0, artifacts_js_1.assertArtifactScheme)(artifact, 'zksync-eravm');
+    if (request.kind === 'create2-deploy')
+        return preparePlain(hre, request, artifact);
+    if (request.kind === 'uups-placeholder-deploy') {
+        return prepareUupsInitial(hre, request, artifact, dependencies);
+    }
+    return prepareUupsUpgrade(hre, request, artifact, dependencies);
+};
+exports.prepareZkSync = prepareZkSync;
+//# sourceMappingURL=zksync.js.map

package/dist-cjs/core/preparation/zksync.js.map

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