Skip to content

Latest commit

 

History

History
91 lines (62 loc) · 2.59 KB

README.md

File metadata and controls

91 lines (62 loc) · 2.59 KB

Account Abstraction Project

Overview

This project implements account abstraction using the ERC-4337 standard and zkSync Era. It includes a minimal account implementation (MinimalAccount) and a zkSync-specific account implementation (ZkMinimalAccount). The project also contains test suites to ensure the functionality and security of the contracts.

Contracts

1. MinimalAccount

  • Location: src/ethereum/MinimalAccount.sol
  • Description: A minimal implementation of ERC-4337 account abstraction. It allows the owner to execute transactions and validate user operations.
  • Key Features:
    • Owner-based access control.
    • Transaction execution with ETH transfer.
    • User operation validation.

2. ZkMinimalAccount

  • Location: src/zksync/ZkMinimalAccount.sol
  • Description: A minimal implementation of a zkSync Era account abstraction contract. It handles transaction validation and execution in the zkSync environment.
  • Key Features:
    • Supports zkSync transaction lifecycle.
    • Validates transactions and updates nonce.
    • Allows external execution of transactions.

Tests

1. MinimalAccountTest

  • Location: test/ethereum/MinimalAccountTest.t.sol
  • Description: Test suite for the MinimalAccount contract.
  • Key Tests:
    • Owner can execute commands.
    • Non-owner cannot execute commands.
    • Validates signed user operations.

2. ZkMinimalAccountTest

  • Location: test/zksync/ZkMinimalAccountTest.sol
  • Description: Test suite for the ZkMinimalAccount contract.
  • Key Tests:
    • Owner can execute commands.
    • Validates transaction execution.
    • Tests transaction signing and validation.

Installation

To get started with this project, follow these steps:

  1. Clone the repository:

    git clone <repository-url>
cd <repository-directory>

  2. Install dependencies: Make sure you have Foundry installed. Then run:

    forge install

  3. Compile the contracts:

    forge build

  4. Run the tests:

    forge test

Usage

  • Deploy the contracts using the provided deployment scripts located in the script directory.
  • Interact with the contracts through the deployed addresses using a web3 provider or a frontend application.

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue for any suggestions or improvements.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Author

  • Abraham Elijah (Mr. Grade)