gate-evm-tools 1.0.23 → 1.0.24

package/dist/core/preparation/zkManifestSync.d.ts

@@ -0,0 +1,49 @@
+import { type GateToolArtifact } from './artifacts.js';
+import { loadZkValidationCandidate, type ZkValidationCandidate, type ZkValidationHre } from './zkUpgradeValidation.js';
+interface ZkManifestSyncHre extends ZkValidationHre {
+    run(task: string, options?: Record<string, unknown>): Promise<unknown>;
+    artifacts: {
+        readArtifact(name: string): Promise<GateToolArtifact>;
+    };
+    ethers: {
+        provider: {
+            getNetwork(): Promise<{
+                chainId: bigint | number | string;
+            }>;
+            getCode(address: string): Promise<string>;
+        };
+    };
+}
+export interface ZkManifestSyncOptions {
+    root?: string;
+    scheme: 'zksync-eravm';
+    network: string;
+    target: string;
+    proxy: string;
+    contract: string;
+    constructorArgs?: unknown[];
+    unsafeAllow?: string[];
+    transactionHash?: string;
+    hre: ZkManifestSyncHre;
+}
+export interface ZkManifestSyncDependencies {
+    loadCandidate?: (hre: ZkValidationHre, request: Parameters<typeof loadZkValidationCandidate>[1], artifact: GateToolArtifact) => Promise<ZkValidationCandidate>;
+    assertImplementationSafe?: (candidate: ZkValidationCandidate) => void;
+    getCurrentImplementation?: (hre: ZkValidationHre, proxy: string) => Promise<string>;
+}
+export declare const syncZkManifest: (options: ZkManifestSyncOptions, dependencies?: ZkManifestSyncDependencies) => Promise<{
+    manifestTransaction: import("../../utils/manifestTransaction.js").ManifestTransactionReport;
+    syncReport: string;
+    scheme: "zksync-eravm";
+    network: string;
+    target: string;
+    chainId: string;
+    proxy: string;
+    implementation: string;
+    artifact: import("./types.js").GateToolArtifactIdentity;
+    layoutHash: string;
+    manifestDigest: string;
+    manifestFile: string;
+}>;
+export {};
+//# sourceMappingURL=zkManifestSync.d.ts.map

package/dist/core/preparation/zkManifestSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zkManifestSync.d.ts","sourceRoot":"","sources":["../../../src/core/preparation/zkManifestSync.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EAGL,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAGlC,UAAU,iBAAkB,SAAQ,eAAe;IACjD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,SAAS,EAAE;QAAE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;KAAE,CAAC;IACrE,MAAM,EAAE;QACN,QAAQ,EAAE;YACR,UAAU,IAAI,OAAO,CAAC;gBAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;aAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;SAC3C,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,iBAAiB,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE,CACd,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAC,EACxD,QAAQ,EAAE,gBAAgB,KACvB,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpC,wBAAwB,CAAC,EAAE,CAAC,SAAS,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtE,wBAAwB,CAAC,EAAE,CACzB,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB;AAmDD,eAAO,MAAM,cAAc,GACzB,SAAS,qBAAqB,EAC9B,eAAc,0BAA+B;;;;;;;;;;;;;EA0H9C,CAAC"}

package/dist/core/preparation/zkManifestSync.js

@@ -0,0 +1,159 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getAddress, hexlify } from 'ethers';
+import { utils } from 'zksync-ethers';
+import { artifactIdentity, assertArtifactScheme, } from './artifacts.js';
+import { hashStorageLayout, parseTargetManifest, resolveTargetManifestPaths, } from './manifest.js';
+import { assertZkImplementationSafe, getZkCurrentImplementation, loadZkValidationCandidate, } from './zkUpgradeValidation.js';
+import { withManifestTransaction } from '../../utils/manifestTransaction.js';
+const bytecodeHash = (bytecode, label) => {
+    try {
+        return hexlify(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 = fs.existsSync(manifestFile);
+    const fallbackExists = fallbackFile !== manifestFile && fs.existsSync(fallbackFile);
+    if (!canonicalExists && !fallbackExists) {
+        return { manifestVersion: '3.2', impls: {}, proxies: [] };
+    }
+    const selected = canonicalExists ? manifestFile : fallbackFile;
+    const stat = fs.lstatSync(selected);
+    if (stat.isSymbolicLink() || !stat.isFile()) {
+        throw new Error('OpenZeppelin manifest must be a regular file');
+    }
+    return parseTargetManifest(fs.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 } : {}),
+});
+export 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 = path.resolve(options.root ?? options.hre.config.paths.root);
+    if (root !== path.resolve(options.hre.config.paths.root)) {
+        throw new Error('sync root does not match the Hardhat project root');
+    }
+    const proxy = 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);
+    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 ?? loadZkValidationCandidate)(options.hre, request, artifact);
+    (dependencies.assertImplementationSafe ?? assertZkImplementationSafe)(candidate);
+    if (!/^[0-9a-f]{64}$/.test(candidate.version.linkedWithoutMetadata)) {
+        throw new Error('zkSync implementation version key is invalid');
+    }
+    const implementation = getAddress(await (dependencies.getCurrentImplementation ?? 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 = resolveTargetManifestPaths(root, options.target, chainId);
+    const transaction = await 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 && hashStorageLayout(existing.layout) !== 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) => 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 && fs.existsSync(fallbackFile))
+                fs.unlinkSync(fallbackFile);
+            writeManifestAtomic(Buffer.from(`${JSON.stringify(manifest, null, 2)}\n`));
+            const verified = parseTargetManifest(fs.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: artifactIdentity(artifact, 'zksync-eravm'),
+                layoutHash: hashStorageLayout(candidate.layout),
+                manifestDigest: crypto.createHash('sha256').update(fs.readFileSync(manifestFile)).digest('hex'),
+                manifestFile,
+            };
+        },
+    });
+    return {
+        ...transaction.value,
+        manifestTransaction: transaction.report,
+        syncReport: transaction.reportFile,
+    };
+};
+//# sourceMappingURL=zkManifestSync.js.map

package/dist/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/core/preparation/zkUpgradeValidation.d.ts

@@ -0,0 +1,37 @@
+import { getChainId, type StorageLayout, type ValidationDataCurrent, type ValidationOptions, type Version } from '@openzeppelin/upgrades-core';
+import { type GateToolArtifact } from './artifacts.js';
+import type { GateToolUupsInitialValidation, GateToolUupsPlaceholderDeployRequestV1, GateToolUupsUpgradeRequestV1, GateToolUupsUpgradeValidation } from './types.js';
+export interface ZkValidationHre {
+    config: {
+        paths: {
+            root: string;
+            cache: string;
+        };
+    };
+    network: {
+        name: string;
+        config?: {
+            zksync?: boolean;
+            chainId?: number;
+        };
+        provider: Parameters<typeof getChainId>[0];
+    };
+}
+export interface ZkValidationCandidate {
+    validations: ValidationDataCurrent;
+    version: Version;
+    layout: StorageLayout;
+    validationOptions: Required<ValidationOptions>;
+}
+type ZkUupsRequest = GateToolUupsPlaceholderDeployRequestV1 | GateToolUupsUpgradeRequestV1;
+export interface ZkValidationDependencies {
+    loadCandidate?: (hre: ZkValidationHre, request: ZkUupsRequest, artifact: GateToolArtifact) => Promise<ZkValidationCandidate>;
+    assertImplementationSafe?: (candidate: ZkValidationCandidate) => void;
+    getCurrentImplementation?: (hre: ZkValidationHre, proxy: string) => Promise<string>;
+}
+export declare const loadZkValidationCandidate: (hre: ZkValidationHre, request: ZkUupsRequest, artifact: GateToolArtifact) => Promise<ZkValidationCandidate>;
+export declare const assertZkImplementationSafe: (candidate: ZkValidationCandidate) => void;
+export declare const getZkCurrentImplementation: (hre: ZkValidationHre, proxy: string) => Promise<string>;
+export declare const validateZkImplementation: (hre: ZkValidationHre, request: ZkUupsRequest, artifact: GateToolArtifact, dependencies?: ZkValidationDependencies) => Promise<GateToolUupsInitialValidation | GateToolUupsUpgradeValidation>;
+export {};
+//# sourceMappingURL=zkUpgradeValidation.d.ts.map

package/dist/core/preparation/zkUpgradeValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zkUpgradeValidation.d.ts","sourceRoot":"","sources":["../../../src/core/preparation/zkUpgradeValidation.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,UAAU,EAMV,KAAK,aAAa,EAElB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACb,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAK7E,OAAO,KAAK,EACV,6BAA6B,EAC7B,sCAAsC,EACtC,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACnD,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,OAAO,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAChD,QAAQ,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;KAC5C,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,qBAAqB,CAAC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;CAChD;AAED,KAAK,aAAa,GACd,sCAAsC,GACtC,4BAA4B,CAAC;AAEjC,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,CACd,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,gBAAgB,KACvB,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpC,wBAAwB,CAAC,EAAE,CACzB,SAAS,EAAE,qBAAqB,KAC7B,IAAI,CAAC;IACV,wBAAwB,CAAC,EAAE,CACzB,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB;AAoBD,eAAO,MAAM,yBAAyB,GACpC,KAAK,eAAe,EACpB,SAAS,aAAa,EACtB,UAAU,gBAAgB,KACzB,OAAO,CAAC,qBAAqB,CAoB/B,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,WAAW,qBAAqB,KAAG,IAE7E,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,KAAK,eAAe,EACpB,OAAO,MAAM,KACZ,OAAO,CAAC,MAAM,CAA0D,CAAC;AAQ5E,eAAO,MAAM,wBAAwB,GACnC,KAAK,eAAe,EACpB,SAAS,aAAa,EACtB,UAAU,gBAAgB,EAC1B,eAAc,wBAA6B,KAC1C,OAAO,CAAC,6BAA6B,GAAG,6BAA6B,CA6CvE,CAAC"}

package/dist/core/preparation/zkUpgradeValidation.js

@@ -0,0 +1,91 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { ContractFactory, getAddress } from 'ethers';
+import { assertStorageUpgradeSafe, assertUpgradeSafe, getChainId, getImplementationAddress, getStorageLayout, getVersion, isCurrentValidationData, withValidationDefaults, } from '@openzeppelin/upgrades-core';
+import { assertArtifactScheme } from './artifacts.js';
+import { hashStorageLayout, readRegisteredZkUpgradeState, } from './manifest.js';
+const confinedValidationFile = (hre) => {
+    const root = path.resolve(hre.config.paths.root);
+    const cache = path.resolve(hre.config.paths.cache);
+    const relative = path.relative(root, cache);
+    if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+        throw new Error('Hardhat validation cache must stay inside the project root');
+    }
+    const file = path.join(cache, 'validations.json');
+    if (!fs.existsSync(file)) {
+        throw new Error('zkSync validations cache is missing; compile with the pinned Matter Labs plugin');
+    }
+    const stat = fs.lstatSync(file);
+    if (stat.isSymbolicLink() || !stat.isFile()) {
+        throw new Error('zkSync validations cache must be a regular file');
+    }
+    return file;
+};
+export const loadZkValidationCandidate = async (hre, request, artifact) => {
+    const file = confinedValidationFile(hre);
+    const rawValidations = JSON.parse(fs.readFileSync(file, 'utf8'));
+    if (!isCurrentValidationData(rawValidations)) {
+        throw new Error('zkSync validations cache is missing or outdated');
+    }
+    const validations = rawValidations;
+    const factory = new ContractFactory(artifact.abi, artifact.bytecode);
+    const constructorInput = factory.interface.encodeDeploy(request.constructorArgs);
+    const version = getVersion(artifact.bytecode, artifact.bytecode, constructorInput);
+    const validationOptions = withValidationDefaults({
+        kind: 'uups',
+        ...(request.unsafeAllow ? { unsafeAllow: request.unsafeAllow } : {}),
+    });
+    return {
+        validations,
+        version,
+        layout: getStorageLayout(validations, version),
+        validationOptions,
+    };
+};
+export const assertZkImplementationSafe = (candidate) => {
+    assertUpgradeSafe(candidate.validations, candidate.version, candidate.validationOptions);
+};
+export const getZkCurrentImplementation = async (hre, proxy) => getImplementationAddress(hre.network.provider, proxy);
+const selectedChainId = async (hre) => {
+    const configured = hre.network.config?.chainId;
+    if (configured !== undefined)
+        return configured;
+    return getChainId(hre.network.provider);
+};
+export const validateZkImplementation = async (hre, request, artifact, dependencies = {}) => {
+    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 ?? loadZkValidationCandidate)(hre, request, artifact);
+    (dependencies.assertImplementationSafe ?? assertZkImplementationSafe)(candidate);
+    if (request.kind === 'uups-placeholder-deploy') {
+        return {
+            kind: 'uups-initial',
+            engine: 'matterlabs-openzeppelin',
+            artifactFormat: 'hh-zksolc-artifact-1',
+            implementationSafe: true,
+        };
+    }
+    const implementation = getAddress(await (dependencies.getCurrentImplementation ?? getZkCurrentImplementation)(hre, request.proxy)).toLowerCase();
+    const state = readRegisteredZkUpgradeState({
+        root: hre.config.paths.root,
+        target: request.target,
+        chainId: await selectedChainId(hre),
+        proxy: request.proxy,
+        currentImplementation: implementation,
+    });
+    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: hashStorageLayout(state.oldLayout),
+        newLayoutHash: hashStorageLayout(candidate.layout),
+        manifestDigest: state.digest,
+    };
+};
+//# sourceMappingURL=zkUpgradeValidation.js.map

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

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

package/dist/core/preparation/zksync.d.ts

@@ -0,0 +1,28 @@
+import { type GateToolArtifact } from './artifacts.js';
+import type { GateToolPreparationPlanV1, GateToolPreparationRequestV1 } from './types.js';
+import { type ZkValidationDependencies, type ZkValidationHre } from './zkUpgradeValidation.js';
+interface ZkPreparationHre extends ZkValidationHre {
+    network: ZkValidationHre['network'] & {
+        config?: {
+            zksync?: boolean;
+            chainId?: number;
+        };
+    };
+    artifacts: {
+        readArtifact(name: string): Promise<GateToolArtifact>;
+    };
+    ethers: {
+        provider: {
+            getNetwork(): Promise<{
+                chainId: bigint | number | string;
+            }>;
+            getCode(address: string): Promise<string>;
+        };
+    };
+}
+export interface ZkPreparationDependencies {
+    validation?: ZkValidationDependencies;
+}
+export declare const prepareZkSync: (hre: ZkPreparationHre, request: GateToolPreparationRequestV1, dependencies?: ZkPreparationDependencies) => Promise<GateToolPreparationPlanV1>;
+export {};
+//# sourceMappingURL=zksync.d.ts.map

package/dist/core/preparation/zksync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zksync.d.ts","sourceRoot":"","sources":["../../../src/core/preparation/zksync.ts"],"names":[],"mappings":"AASA,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,KAAK,EAIV,yBAAyB,EACzB,4BAA4B,EAI7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAiBlC,UAAU,gBAAiB,SAAQ,eAAe;IAChD,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,GAAG;QACpC,MAAM,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,OAAO,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACjD,CAAC;IACF,SAAS,EAAE;QAAE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;KAAE,CAAC;IACrE,MAAM,EAAE;QACN,QAAQ,EAAE;YACR,UAAU,IAAI,OAAO,CAAC;gBAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;aAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;SAC3C,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,wBAAwB,CAAC;CACvC;AAwRD,eAAO,MAAM,aAAa,GACxB,KAAK,gBAAgB,EACrB,SAAS,4BAA4B,EACrC,eAAc,yBAA8B,KAC3C,OAAO,CAAC,yBAAyB,CAcnC,CAAC"}

package/dist/core/preparation/zksync.js

@@ -0,0 +1,248 @@
+import { ContractFactory, getAddress, hexlify, Interface, keccak256, } from 'ethers';
+import { utils } from 'zksync-ethers';
+import { artifactIdentity, assertArtifactScheme, collectZkFactoryDeps, } from './artifacts.js';
+import { hashPreparationRequest, normalizePreparationPlan, } from './normalize.js';
+import { validateZkImplementation, } from './zkUpgradeValidation.js';
+const ERC1967_PROXY_ARTIFACT = '@openzeppelin/contracts/proxy/ERC1967/ERC1967Proxy.sol:ERC1967Proxy';
+const CONTRACT_DEPLOYER_INTERFACE = new Interface([
+    'function create2(bytes32 salt, bytes32 bytecodeHash, bytes input) returns (address)',
+]);
+const FACTORY_INTERFACE = new Interface([
+    'function deploy(bytes32 salt, bytes initCode, bytes data, uint256 create2ForwardValue, uint256 callForwardValue) payable returns (address)',
+]);
+const UPGRADE_INTERFACE = new Interface([
+    'function upgradeToAndCall(address newImplementation, bytes data) payable',
+]);
+const assertAddressPolicy = (predictedAddress, policy, label) => {
+    if (!policy)
+        return;
+    const normalized = getAddress(predictedAddress);
+    if (policy.expectedAddress && normalized !== 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 hexlify(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) => {
+    assertArtifactScheme(input.artifact, 'zksync-eravm');
+    const contractFactory = new 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 = 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: 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 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 normalizePreparationPlan({
+        version: 1,
+        requestHash: hashPreparationRequest(request),
+        kind: request.kind,
+        scheme: request.scheme,
+        network: request.network,
+        target: request.target,
+        chainId: network.chainId.toString(),
+        contract: request.contract,
+        artifact: 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 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);
+    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 normalizePreparationPlan({
+        version: 1,
+        requestHash: hashPreparationRequest(request),
+        kind: request.kind,
+        scheme: request.scheme,
+        network: request.network,
+        target: request.target,
+        chainId: network.chainId.toString(),
+        contract: request.contract,
+        proxyKind: 'uups',
+        artifact: artifactIdentity(artifact, 'zksync-eravm'),
+        validation,
+        deployments: [implementation.deployment, proxy.deployment],
+        transactions,
+    });
+};
+const prepareUupsUpgrade = async (hre, request, artifact, dependencies) => {
+    const validation = await 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 normalizePreparationPlan({
+        version: 1,
+        requestHash: hashPreparationRequest(request),
+        kind: request.kind,
+        scheme: request.scheme,
+        network: request.network,
+        target: request.target,
+        chainId: network.chainId.toString(),
+        contract: request.contract,
+        proxyKind: 'uups',
+        artifact: artifactIdentity(artifact, 'zksync-eravm'),
+        validation,
+        deployments: [implementation.deployment],
+        transactions,
+    });
+};
+export 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);
+    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);
+};
+//# sourceMappingURL=zksync.js.map