[ZK Stack] - How to initialise an ecosystem with a local Besu network?

[LimonChillo]

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.81.0

Operating System

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

Issue Description

I would like to connect my zkstack (v0.1.0-a10c4baa) ecosystem to a custom L1. I tried to connect to a private Besu network (IBFT, running in docker on my local machine) rather than the packaged reth client.

I have updated the wallet adresses at /chains/zk_chain_1/configs/wallets.yaml and /configs/wallets.yaml to pre-funded rich wallets on the Besu network.

After that I started zkstack ecosystem init and it failed executing deploy-scripts/DeployL1.s.sol . Contracts seem to be deployed successfully though, the console output shows execution up until after the updateOwners() task.

Did someone encounter something something similar, or can guide me how I may connect the stack to a custom L1 on Besu?

Thanks a lot everyone!

○ zkstack ecosystem init

┌   ZK Stack CLI
│
◇  Do you want to deploy some test ERC20s?
│  No
│
◇  Do you want to deploy ecosystem contracts? (Not needed if you already have an existing one)
│  Yes
│
◇  What is the RPC URL of the L1 network?
│  http://localhost:21021
│
◇  Do you want to setup observability? (Grafana)
│  Yes
│
●  Initializing ecosystem
│
●  Era observability already setup
│
◇  Installing and building dependencies... done in 28.370514792 secs
│
◓  Deploying ecosystem contracts...                               │
■  Command failed to run
│
■    Status:
│      exit status: 1
│    Stdout:
│      No files changed, compilation skipped
│      EIP-3855 is not supported in one or more of the RPCs used.
│      Unsupported Chain IDs: 1337.
│      Contracts deployed with a Solidity version equal or higher than 0.8.20 might not work properly.
│      For more information, please see https://eips.ethereum.org/EIPS/eip-3855
│      Script ran successfully.
│
│      == Logs ==
│      Deploying L1 contracts
│      Create2Factory deployed at: 0x446e083592D2dFa6661E20097F6898990C3CACE5
│      Multicall3 deployed at: 0x102f00d9f2Dd907Ee5780567e8FaC47006E5a427
│      Verifier deployed at: 0x373116b750D8C0922d3a9b25D44bC4D63EAA14Dd
│      DefaultUpgrade deployed at: 0x2f3e26D9f54dF3F9dcA9BAec60b7592911076627
│      GenesisUpgrade deployed at: 0x29AA208fB9FFd6E384028307E260EC279790cF96
│      ValidatorTimelock deployed at: 0xD57bFE0421c1831C035Ceb6B1738D9Ff429C86BB
│      Governance deployed at: 0xD34B472B1971a5521cEA056d84c566fCb71B24b1
│      ChainAdmin deployed at: 0xFF3d305a882b64A62136242ca8F6933a463D430b
│      Transparent Proxy Admin deployed at: 0x3536Ca51D15f6fc0a76c1f42693F7949b5165F0D
│      Bridgehub Implementation deployed at: 0x913CEdFAa0a859775Cce668D98352545D52D1166
│      Bridgehub Proxy deployed at: 0x72E39d058896933794c64f1ABf086A03E044F8A9
│      BlobVersionedHashRetriever deployed at: 0x12EA1C802e8CE7c0fe6f89e8f0D5f0D60f05dFE4
│      ExecutorFacet deployed at: 0x0a066ab5A867b7E6F23f6c5fF8820E39c6903584
│      AdminFacet deployed at: 0x6163A9fa5beE5eE1FB4AE8af553d72a0a2a63605
│      MailboxFacet deployed at: 0xe9A7a66711319080c7f72056529C5FAa688Ebd30
│      GettersFacet deployed at: 0x63ed4ef3E15c197cfDF47f34232208C3cB1D07FA
│      DiamondInit deployed at: 0xD786d2D30445c2B7Cd9f20c996551dD9681038A9
│      StateTransitionManagerImplementation deployed at: 0x5f2946389BA6Fb66D2AA90698Ee304107270DB26
│      StateTransitionManagerProxy deployed at: 0x27e9A2f6f9Df78bb0B5e2D68d8884804E8D17676
│      StateTransitionManager registered
│      StateTransitionManager set in ValidatorTimelock
│      DiamondProxy deployed at: 0xb41eE62946f71c499563f1191D11fBF8AC1f47E0
│      SharedBridgeImplementation deployed at: 0x6d1685e3792e3C5D5A2B64DCf1d3f87bebe5FDFD
│      SharedBridgeProxy deployed at: 0x725a55d9F58Ba1D2823A3C5b661638E7Cab0c528
│      SharedBridge registered
│      Erc20BridgeImplementation deployed at: 0x276a434a07a4bC8e1f4B17Da88fcA7d446F6AbFB
│      Erc20BridgeProxy deployed at: 0x9863F2ab2B24A13ead07db8531640D70D8AaF957
│      SharedBridge updated with ERC20Bridge address
│      Owners updated
│
│      ## Setting up 1 EVM.
│
│      ==========================
│
│      Chain 1337
│
│      Estimated gas price: 0 gwei
│
│      Estimated total gas used for script: 55854283
│
│      Estimated amount required: 0. ETH
│
│      ==========================
│
│      Transactions saved to:
│      /<PROJECT-PATH>/zksync-era/contracts/l1-contracts/broadcast/DeployL1.s.sol/1337/run-latest.json
│
│      Sensitive values saved to:
│      //<PROJECT-PATH>/zksync-era/contracts/l1-contracts/cache-forge/DeployL1.s.sol/1337/run-latest.json
│
│
│
│    Stderr:
│      Error:
│      Transaction Failure: 0x23c6d323742aae6f05496ff4794a79c02df3955bbee70bfccb430abf40e57ae4
│
│
■  Command failed to run: forge script deploy-scripts/DeployL1.s.sol --legacy --ffi --rpc-url=http://localhost:21021 --slow --private-key=ae6ae8e5ccbfb04590405997ee2d52d2b330726137b875053c36d94e974d162f --broadcast
│  Error:
│  Transaction Failure: 0x23c6d323742aae6f05496ff4794a79c02df3955bbee70bfccb430abf40e57ae4
│
│
▲    0: Command failed to run: forge script deploy-scripts/DeployL1.s.sol --legacy --ffi --rpc-url=http://localhost:21021 --slow --private-key=ae6ae8e5ccbfb04590405997ee2d52d2b330726137b875053c36d94e974d162f --broadcast

Expected Behavior

Stack should be initiated with a custom L1

Current Behavior

See error output above

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]]

It seems you are encountering an issue with initializing the ZKsync ecosystem using a custom L1 Besu network. The error message indicates a problem with the deployment script DeployL1.s.sol and specifically mentions a transaction failure.

Here are a few steps and considerations that might help you resolve this issue:

1. Check RPC Compatibility: Ensure that your Besu network's RPC is fully compatible with the Ethereum JSON-RPC specifications required by ZKsync. The error message about EIP-3855 not being supported suggests there might be compatibility issues with the Besu version you are using.

2. Verify Network Configuration: Double-check the network configuration and ensure that the Besu network is correctly set up to handle the types of transactions and contracts being deployed by ZKsync. This includes checking the chain ID and ensuring it matches the expected value in your deployment scripts.

3. Examine Gas Settings: The error log suggests issues related to gas estimation (Estimated gas price: 0 gwei). Verify that your Besu network is configured to provide accurate gas estimates and that it can process transactions with the gas limits being used by the deployment scripts.

4. Review Contract Compatibility: Since the contracts are deployed but the script fails afterward, it might be useful to review the contracts for any compatibility issues with the Besu network, especially concerning features introduced in newer Solidity versions (like EIP-3855).

5. Manual Transaction Submission: Try manually submitting a simple transaction on the network using the same RPC URL to confirm basic connectivity and functionality. This can help isolate the problem to either network configuration or script-specific issues.

6. Logs and Debugging: Increase the logging level of your Besu network and the ZKsync deployment process to capture more detailed error information. This might provide further insights into what exactly is failing.

7. Consult Documentation and Community: Review the ZKsync and Besu documentation for any notes on compatibility or special configuration settings required. You might also want to reach out to the ZKsync developer community or Besu support channels for advice specific to this kind of setup.

If you continue to face issues, providing the detailed logs and configurations might help further diagnose the problem.

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.

[dutterbutter]

Hey @LimonChillo 👋

I do not think anyone has tried to connect to besu before so this is a bit uncharted territory. However, I don't foresee any reason why it should not work but likely some changes may be required when using the cli.

Are you able to successfully run the following forge script forge script deploy-scripts/DeployL1.s.sol --legacy --ffi --rpc-url=http://localhost:21021 --slow --private-key=ae6ae8e5ccbfb04590405997ee2d52d2b330726137b875053c36d94e974d162f --broadcast by itself against your running besu network?

If so, that is a good initial step. Then we need to confirm that the following additional forge scripts can be successfully run against your besu network. Once we have the contracts fully deployed / admins and permissions set then I think that would confirm our ability to use besu as our L1.

[LimonChillo]

Hi @dutterbutter, thanks for your reply. Oh really, no one has tried to connect to Besu yet? 😅
Is there a specific reason or has there been just no need/will so far? Anyway, happy to provide more info to eventually confirm Besu compatibility together with you. :)

So I did run the command you provided, and it did fail again with the same error. I've posted the full failed transaction below, and so far I could figure out it's been a transaction to the 'create2 factory'.

create2_factory_addr = "0x9Dee536694e1f0Adc640972E61826732666345b3"

    {
      "hash": "0xb78d1499f5b8d1f48f5f2bce774bdc9cb94c98643a6ad81f3ade126361bb9d4d",
      "transactionType": "CALL",
      "contractName": null,
      "contractAddress": "0x9dee536694e1f0adc640972e61826732666345b3",
      "function": null,
      "arguments": null,
      "transaction": {
        "from": "0xf17f52151ebef6c7334fad080c5704d77216b732",
        "to": "0x9dee536694e1f0adc640972e61826732666345b3",
        "gas": "0x131a04",
        "value": "0x0",
        "input": "0x158387faafbf206384048e611a3cb8160d4dd09eec8cd510afc45a8056401e18608060405234801561000f575f80fd5b50610e838061001d5f395ff3fe6080604052600436106100ef575f3560e01c80634d2301cc11610087578063a8b0574e11610057578063a8b0574e1461024d578063bce38bd714610267578063c3077fa91461027a578063ee82ac5e1461028d575f80fd5b80634d2301cc146101e257806372425d9d1461021657806382ad56cb1461022857806386d516e81461023b575f80fd5b80633408e470116100c25780633408e4701461018a578063399542e91461019c5780633e64a696146101be57806342cbb15c146101d0575f80fd5b80630f28c97d146100f3578063174dea7114610114578063252dba421461013457806327e86d6e14610155575b5f80fd5b3480156100fe575f80fd5b50425b6040519081526020015b60405180910390f35b610127610122366004610a52565b6102ab565b60405161010b9190610b7c565b610147610142366004610a52565b6104d7565b60405161010b929190610b95565b348015610160575f80fd5b50437fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0140610101565b348015610195575f80fd5b5046610101565b6101af6101aa366004610c1d565b610672565b60405161010b93929190610c72565b3480156101c9575f80fd5b5048610101565b3480156101db575f80fd5b5043610101565b3480156101ed575f80fd5b506101016101fc366004610c99565b73ffffffffffffffffffffffffffffffffffffffff163190565b348015610221575f80fd5b5044610101565b610127610236366004610a52565b61068d565b348015610246575f80fd5b5045610101565b348015610258575f80fd5b5060405141815260200161010b565b610127610275366004610c1d565b610833565b6101af610288366004610a52565b6109ec565b348015610298575f80fd5b506101016102a7366004610ccc565b4090565b60605f828067ffffffffffffffff8111156102c8576102c8610ce3565b60405190808252806020026020018201604052801561030d57816020015b604080518082019091525f8152606060208201528152602001906001900390816102e65790505b509250365f5b8281101561045f575f85828151811061032e5761032e610d10565b6020026020010151905087878381811061034a5761034a610d10565b905060200281019061035c9190610d3d565b6040810135958601959093506103756020850185610c99565b73ffffffffffffffffffffffffffffffffffffffff16816103996060870187610d79565b6040516103a7929190610dda565b5f6040518083038185875af1925050503d805f81146103e1576040519150601f19603f3d011682016040523d82523d5f602084013e6103e6565b606091505b506020808501919091529015158084529085013517610455577f08c379a0000000000000000000000000000000000000000000000000000000005f52602060045260176024527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060445260845ffd5b5050600101610313565b508234146104ce576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f4d756c746963616c6c333a2076616c7565206d69736d6174636800000000000060448201526064015b60405180910390fd5b50505092915050565b436060828067ffffffffffffffff8111156104f4576104f4610ce3565b60405190808252806020026020018201604052801561052757816020015b60608152602001906001900390816105125790505b509150365f5b82811015610668575f87878381811061054857610548610d10565b905060200281019061055a9190610de9565b92506105696020840184610c99565b73ffffffffffffffffffffffffffffffffffffffff1661058c6020850185610d79565b60405161059a929190610dda565b5f604051808303815f865af19150503d805f81146105d3576040519150601f19603f3d011682016040523d82523d5f602084013e6105d8565b606091505b508684815181106105eb576105eb610d10565b602090810291909101015290508061065f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601760248201527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060448201526064016104c5565b5060010161052d565b5050509250929050565b4380406060610682868686610833565b905093509350939050565b6060818067ffffffffffffffff8111156106a9576106a9610ce3565b6040519080825280602002602001820160405280156106ee57816020015b604080518082019091525f8152606060208201528152602001906001900390816106c75790505b509150365f5b828110156104ce575f84828151811061070f5761070f610d10565b6020026020010151905086868381811061072b5761072b610d10565b905060200281019061073d9190610e1b565b925061074c6020840184610c99565b73ffffffffffffffffffffffffffffffffffffffff1661076f6040850185610d79565b60405161077d929190610dda565b5f604051808303815f865af19150503d805f81146107b6576040519150601f19603f3d011682016040523d82523d5f602084013e6107bb565b606091505b50602080840191909152901515808352908401351761082a577f08c379a0000000000000000000000000000000000000000000000000000000005f52602060045260176024527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060445260645ffd5b506001016106f4565b6060818067ffffffffffffffff81111561084f5761084f610ce3565b60405190808252806020026020018201604052801561089457816020015b604080518082019091525f81526060602082015281526020019060019003908161086d5790505b509150365f5b828110156109e2575f8482815181106108b5576108b5610d10565b602002602001015190508686838181106108d1576108d1610d10565b90506020028101906108e39190610de9565b92506108f26020840184610c99565b73ffffffffffffffffffffffffffffffffffffffff166109156020850185610d79565b604051610923929190610dda565b5f604051808303815f865af19150503d805f811461095c576040519150601f19603f3d011682016040523d82523d5f602084013e610961565b606091505b5060208301521515815287156109d95780516109d9576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601760248201527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060448201526064016104c5565b5060010161089a565b5050509392505050565b5f8060606109fc60018686610672565b919790965090945092505050565b5f8083601f840112610a1a575f80fd5b50813567ffffffffffffffff811115610a31575f80fd5b6020830191508360208260051b8501011115610a4b575f80fd5b9250929050565b5f8060208385031215610a63575f80fd5b823567ffffffffffffffff811115610a79575f80fd5b610a8585828601610a0a565b90969095509350505050565b5f81518084525f5b81811015610ab557602081850181015186830182015201610a99565b505f6020828601015260207fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f83011685010191505092915050565b5f82825180855260208086019550808260051b8401018186015f5b84811015610b6f578583037fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe001895281518051151584528401516040858501819052610b5b81860183610a91565b9a86019a9450505090830190600101610b0d565b5090979650505050505050565b602081525f610b8e6020830184610af2565b9392505050565b5f6040820184835260206040602085015281855180845260608601915060608160051b8701019350602087015f5b82811015610c0f577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa0888703018452610bfd868351610a91565b95509284019290840190600101610bc3565b509398975050505050505050565b5f805f60408486031215610c2f575f80fd5b83358015158114610c3e575f80fd5b9250602084013567ffffffffffffffff811115610c59575f80fd5b610c6586828701610a0a565b9497909650939450505050565b838152826020820152606060408201525f610c906060830184610af2565b95945050505050565b5f60208284031215610ca9575f80fd5b813573ffffffffffffffffffffffffffffffffffffffff81168114610b8e575f80fd5b5f60208284031215610cdc575f80fd5b5035919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52603260045260245ffd5b5f82357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff81833603018112610d6f575f80fd5b9190910192915050565b5f8083357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe1843603018112610dac575f80fd5b83018035915067ffffffffffffffff821115610dc6575f80fd5b602001915036819003821315610a4b575f80fd5b818382375f9101908152919050565b5f82357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc1833603018112610d6f575f80fd5b5f82357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa1833603018112610d6f575f80fdfea2646970667358221220317d6d106ceedcf7109e6ece36bb7cd9eca9d5c53ce0a25adfa934e0b090a0ea64736f6c63430008180033",
        "nonce": "0xc",
        "chainId": "0x539"
      },
      "additionalContracts": [],
      "isFixedGasLimit": false
    }

[dutterbutter]

No specific reason, we just defaulted with reth.

Let me try to spin up a local besu and work through these steps. I am not all familiar with running besu but I assume i can just install the binaries here, and then start based on the steps here?

Lets see how far I can get 🫡

[LimonChillo]

Yes you can either start a single node in --network=dev mode or run a private dev network in Docker, thats what I'm currently using.

[dutterbutter]

I am able to get where you failed, will do some more investigation.