Canonical L1 & L2 contract interfaces for the ZKsync Elastic Network

Snapshot notice
These contracts target protocol version 29, commit 65234ab0.

[!NOTE] 🛠️ This is a development repository for interfaces only. If you're looking for contract implementations, see 👉 matter-labs/era-contracts

📦 Installation

To install with Foundry-ZKsync:

forge install matter-labs/zksync-contracts

Add the following to the remappings.txt file of your project:

@matterlabs/zksync-contracts/=lib/matterlabs/zksync-contracts/

To install with Hardhat:

bun install @matterlabs/zksync-contracts

🚀 Quick start

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import {IPaymaster} from
    "@matterlabs/zksync-contracts/contracts/system-contracts/interfaces/IPaymaster.sol";

contract MyPaymaster is IPaymaster {
    // Your implementation here
}

📖 Documentation

• Interface & Library Docs Solidity interfaces and helper libraries

• System Contract Specifications Core system contract specs

• Source Repository GitHub – matter-labs/era-contracts

• ZKsync Docs docs.zksync.io

🤝 Contributing

Bug fixes, new snapshots, and added ABIs are welcome!
Open an issue before large changes and follow the standard PR workflow.

For full guidelines, please see the Contributing Guide.

📜 License

Dual-licensed under MIT / Apache-2.0. See LICENSE-MIT and LICENSE-APACHE.

Website • GitHub • X • X for Devs • Discord • Mirror