[ZK Stack] - (bug) HardhatError: HH700: Artifact for contract "SystemContext" not found.

[sachanayush47]

Team or Project

No response

Module Affected

• System contracts (era-system-contracts)
• Smart contracts (era-contracts)
• zkEVM (era-zk_evm)
• Server (zksync-era)
• Prover (era-boojum)
• Fee withdrawer (era-fee-withdrawer)
• Block Explorer (clock-explorer)
• Portal - Wallet + Bridge (dapp-portal)
• Other (please specify below)

Rust Version

1.82.0

Operating System

• Ubuntu
• MacOS
• Windows
• Other (Please specify below)

Issue Description

While trying to deploy ecosystem using zkstack, we encountered below error. We never encountered this error earlier.

Steps to reproduce:
zkstack ecosystem create
zkstack ecosystem init --verbose

--> contracts-preprocessed/test-contracts/TransferTest.sol
⚙  Command completed: forge build --zksync --zk-enable-eravm-extensions
│  
⚙  Running: yarn preprocess:bootloader
│  

yarn run v1.22.19
$ rm -rf ./bootloader/build && yarn ts-node scripts/preprocess-bootloader.ts
$ /home/zksync/ecosystemv3/zksync-era/contracts/node_modules/.bin/ts-node scripts/preprocess-bootloader.ts
Using zksolc from https://github.com/matter-labs/era-compiler-solidity/releases/download/prerelease-a167aa3-code4rena/zksolc-linux-amd64-musl-v1.5.0
/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/hardhat/src/internal/artifacts.ts:721
    throw new HardhatError(ERRORS.ARTIFACTS.NOT_FOUND, {
          ^
HardhatError: HH700: Artifact for contract "SystemContext" not found. 
    at Artifacts._handleWrongArtifactForContractName (/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/hardhat/src/internal/artifacts.ts:721:11)
    at Artifacts._getArtifactPathFromFiles (/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/hardhat/src/internal/artifacts.ts:852:19)
    at Artifacts._getArtifactPathSync (/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/hardhat/src/internal/artifacts.ts:588:21)
    at Artifacts.readArtifactSync (/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/hardhat/src/internal/artifacts.ts:76:31)
    at getSystemContextCodeHash (/home/zksync/ecosystemv3/zksync-era/contracts/system-contracts/scripts/preprocess-bootloader.ts:58:30)
    at Object.<anonymous> (/home/zksync/ecosystemv3/zksync-era/contracts/system-contracts/scripts/preprocess-bootloader.ts:109:38)
    at Module._compile (node:internal/modules/cjs/loader:1469:14)
    at Module.m._compile (/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/ts-node/src/index.ts:1618:23)
    at Module._extensions..js (node:internal/modules/cjs/loader:1548:10)
    at Object.require.extensions.<computed> [as .ts] (/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/ts-node/src/index.ts:1621:12) {
  parent: undefined,
  _stack: 'HardhatError: HH700: Artifact for contract "SystemContext" not found. \n' +
    '    at Artifacts._handleWrongArtifactForContractName (/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/hardhat/src/internal/artifacts.ts:721:11)\n' +
    '    at Artifacts._getArtifactPathFromFiles (/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/hardhat/src/internal/artifacts.ts:852:19)\n' +
    '    at Artifacts._getArtifactPathSync (/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/hardhat/src/internal/artifacts.ts:588:21)\n' +
    '    at Artifacts.readArtifactSync (/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/hardhat/src/internal/artifacts.ts:76:31)\n' +
    '    at getSystemContextCodeHash (/home/zksync/ecosystemv3/zksync-era/contracts/system-contracts/scripts/preprocess-bootloader.ts:58:30)\n' +
    '    at Object.<anonymous> (/home/zksync/ecosystemv3/zksync-era/contracts/system-contracts/scripts/preprocess-bootloader.ts:109:38)\n' +
    '    at Module._compile (node:internal/modules/cjs/loader:1469:14)\n' +
    '    at Module.m._compile (/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/ts-node/src/index.ts:1618:23)\n' +
    '    at Module._extensions..js (node:internal/modules/cjs/loader:1548:10)\n' +
    '    at Object.require.extensions.<computed> [as .ts] (/home/zksync/ecosystemv3/zksync-era/contracts/node_modules/ts-node/src/index.ts:1621:12)',
  errorDescriptor: {
    number: 700,
    message: 'Artifact for contract "%contractName%" not found. %suggestion%',
    title: 'Artifact not found',
    description: 'Tried to import a nonexistent artifact.\n' +
      '\n' +
      "Please double check that your contracts have been compiled and double check your artifact's name.",
    shouldBeReported: false
  },
  number: 700,
  messageArguments: { contractName: 'SystemContext', suggestion: '' },
  _isHardhatError: true
}
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.
│
■  Command failed to run
│  
■    Status:
│      exit status: 1
│    Stdout:
│      
│  
│    Stderr:
│      
│  
■  Command failed to run: yarn preprocess:bootloader
│  
│  
▲    0: Command failed to run: yarn preprocess:bootloader
│  
└  Failed to run command

Expected Behavior

Contracts should get compiled

Current Behavior

Failed to compile contracts

Repository Link (if applicable)

No response

Additional Details

No response

Prior Research

• Yes, I searched for similar issues and did not find any matching ones.

[gleenai[bot]]

The error you're encountering, HH700: Artifact for contract "SystemContext" not found, typically indicates that the contract compilation did not generate the expected artifact, which is necessary for subsequent steps in your deployment process.

Here are a few steps you can take to resolve this issue:

1. Ensure Contract Exists: Verify that the SystemContext contract is correctly defined in your contracts directory and that there are no naming mismatches or typos.

2. Recompile Contracts: Run the compilation command again to ensure all contracts are compiled correctly. Sometimes, a clean build helps:

   yarn hardhat clean
   yarn hardhat compile

3. Check Hardhat Configuration: Ensure your hardhat.config.js (or .ts) file is correctly set up to include all necessary paths and settings for your contracts, especially the paths to sources and artifacts.

4. Dependencies and Plugins: Make sure all dependencies are up to date and that you are using the correct versions of Hardhat plugins necessary for ZKsync, particularly those that might affect the compilation process.

5. Review Compilation Scripts: If you have custom scripts or tasks in your Hardhat setup, ensure they are correctly handling the compilation and artifact generation.

If these steps do not resolve the issue, it might be helpful to look into the specific configurations of your Hardhat setup or any recent changes in the environment that might affect the build process.

For more detailed troubleshooting, you can also visit the ZKsync developers discussions on Github for assistance from the community.

Your feedback helps us serve you better. If this fully addresses your question, please give it a thumbs up. If it doesn't, please give it a thumbs down. This will inform the community and team so we can improve our support.

[dimazhornyk]

Hi! The issue you encountered is usually caused by the caches generated by the foundry scripts. Could you please run zkstack dev clean all? If that doesn’t help - try manually deleting the compiled contracts, look for directories like out, zkout and similar in l2-contracts and system-contracts.

[sachanayush47]

Not working, even I tried creating a new ecosystem and still it fails.

[dimazhornyk]

Ok, which version of the era-contracts do you use?

[sachanayush47]

Im not sure about this but below some git output might help.

/home/zksync/ecosystemv3/zksync-era/contracts# git branch
* (HEAD detached at 46d75088)
  main
/home/zksync/ecosystemv3/zksync-era/contracts# git rev-parse HEAD
46d75088e7ddb534101874c3ec15b877da1cb417

[dimazhornyk]

Just tried to reproduce:

• zkstackup --local in main branch
• checked out era-contracts to 46d75088
• zkstack dev clean contracts-cache
• cd contracts && cd system-contracts
• yarn build
• yarn preprocess:bootloader

the last 3 are basically the commands executed inside zkstack and they worked on my env
please verify that the manual execution works and retry with recompiled zkstack tool

[sachanayush47]

Thanks, it worked after running these commands explicitly in the system-contracts directory.
yarn build
yarn preprocess:bootloader

[dimazhornyk]

era-contracts is a submodule within zksync-era in contracts directory
try running git submodule update --init --recursive to initialize it if you haven't done that before

[rithythul]

I follow the instruction on zksync doc page and led to the same error. After that I try follow @dimazhornyk's instruction . Though, I could locate the era-contracts anywhere. Anyhow, the command beside that works.

Then, cd my_elastic_chain and run the command

zkstack ecosystem init --dev --verbose

Then, I get this error at the last part

##### 9
✅  [Success]Hash: 0x0580046f2017b2a81b2663f46a19cf8bbc2c51ea397f593bb2ad586df38cc119
Block: 162948
Paid: 0.00004871000004871 ETH (48710 gas * 1.000000001 gwei)

✅ Sequence #1 on 9 | Total Paid: 0.00004871000004871 ETH (48710 gas * avg 1.000000001 gwei)
                                                                                                                                                                           

==========================

ONCHAIN EXECUTION COMPLETE & SUCCESSFUL.

Transactions saved to: /home/pi/projects/zkchain/my_elastic_chain/zksync-era/contracts/l1-contracts/broadcast/AcceptAdmin.s.sol/9/7475e9ea-latest.json

Sensitive values saved to: /home/pi/projects/zkchain/my_elastic_chain/zksync-era/contracts/l1-contracts/cache-forge/AcceptAdmin.s.sol/9/7475e9ea-latest.json

⚙  Command completed: forge script deploy-scripts/AcceptAdmin.s.sol --legacy --ffi --rpc-url=http://127.0.0.1:8545 --broadcast --sig=7475e9ea000000000000000000000000508700d5cd6db58a99e9968f25c2c632790edf73000000000000000000000000e9bdfd0fdba6e53892659e4b324106991de6ded8 --private-key=2d64990aa363e3d38ae3417950fd40801d75e3d3bd57b86d17fcc261a6c951c6
│  
⚙  Running: forge build --zksync --zk-enable-eravm-extensions
│  

[⠃] Using zksolc-1.5.0
[⠊] Compiling (zksync)
No files changed, compilation skipped
⚙  Command completed: forge build --zksync --zk-enable-eravm-extensions
│  
⚙  Running: forge script deploy-scripts/DeployL2Contracts.sol --legacy --ffi --rpc-url=http://127.0.0.1:8545/ --broadcast --private-key=f12e28c0eb1ef4ff90478f6805b68d63737b7f33abfa091601140805da450d93
│  

[⠊] Compiling...
No files changed, compilation skipped
Traces:
  [3146166] → new DeployL2Script@0x5b73C5498c1E3b4dbA84de0F1833c4a029d90519
    └─ ← [Return] 15603 bytes of code

  [277225] DeployL2Script::run()
    ├─ [0] VM::projectRoot() [staticcall]
    │   └─ ← [Return] "/home/pi/projects/zkchain/my_elastic_chain/zksync-era/contracts/l1-contracts"
    ├─ [0] VM::readFile("/home/pi/projects/zkchain/my_elastic_chain/zksync-era/contracts/l1-contracts/script-config/config-deploy-l2-contracts.toml") [staticcall]
    │   └─ ← [Return] <file>
    ├─ [0] VM::parseTomlAddress("<stringified TOML>", "$.bridgehub") [staticcall]
    │   └─ ← [Return] 0x375D8Dca0B9323edede8fB971c93DE10Df763198
    ├─ [0] VM::parseTomlAddress("<stringified TOML>", "$.governance") [staticcall]
    │   └─ ← [Return] 0x25BB6f94624236bEd93DE9f0910DDcb538038489
    ├─ [0] VM::parseTomlAddress("<stringified TOML>", "$.l1_shared_bridge") [staticcall]
    │   └─ ← [Return] 0x4f0d6f95C13624b834B0908b57f40F71F8C58230
    ├─ [0] VM::parseTomlAddress("<stringified TOML>", "$.erc20_bridge") [staticcall]
    │   └─ ← [Return] 0x0BD8e414a520F0a2b1c25F44f22efd304Ed2265D
    ├─ [0] VM::parseTomlAddress("<stringified TOML>", "$.consensus_registry_owner") [staticcall]
    │   └─ ← [Return] 0x25BB6f94624236bEd93DE9f0910DDcb538038489
    ├─ [0] VM::parseTomlUint("<stringified TOML>", "$.chain_id") [staticcall]
    │   └─ ← [Return] 271
    ├─ [0] VM::parseTomlUint("<stringified TOML>", "$.era_chain_id") [staticcall]
    │   └─ ← [Return] 270
    ├─ [0] VM::projectRoot() [staticcall]
    │   └─ ← [Return] "/home/pi/projects/zkchain/my_elastic_chain/zksync-era/contracts/l1-contracts"
    ├─ [0] VM::readFile("/home/pi/projects/zkchain/my_elastic_chain/zksync-era/contracts/l1-contracts/../l2-contracts/zkout/UpgradeableBeacon.sol/UpgradeableBeacon.json") [staticcall]
    │   └─ ← [Return] <file>
    ├─ [0] VM::parseJsonBytes("<stringified JSON>", ".bytecode.object") [staticcall]
    │   └─ ← [Revert] vm.parseJsonBytes: path ".bytecode.object" must return exactly one JSON value
    └─ ← [Revert] vm.parseJsonBytes: path ".bytecode.object" must return exactly one JSON value


Error: script failed: vm.parseJsonBytes: path ".bytecode.object" must return exactly one JSON value
│
■  Command failed to run
│  
■    Status:
│      exit status: 1
│    Stdout:
│      
│  
│    Stderr:
│      
│  
■  Command failed to run: forge script deploy-scripts/DeployL2Contracts.sol --legacy --ffi --rpc-url=http://127.0.0.1:8545/ --broadcast --private-key=f12e28c0eb1ef4ff90478f6805b68d63737b7f33abfa091601140805da450d93
│  
│  
▲    0: Command failed to run: forge script deploy-scripts/DeployL2Contracts.sol --legacy --ffi --rpc-url=http://127.0.0.1:8545/ --broadcast --private-key=f12e28c0eb1ef4ff90478f6805b68d63737b7f33abfa091601140805da450d93
│  
└  Failed to run command

How did you get it to work @sachanayush47?

[rithythul]

git submodule update --init --recursive

Thanks. let me try this.