Monomer

Monomer uses the OP stack to make Cosmos applications deployable as Ethereum rollups.

⚠ Monomer is pre-production software and should be used with caution. ⚠

At a Glance

From the OP stack's perspective, Monomer replaces the default Ethereum compatible execution engine. From the Cosmos application's perspective, Monomer replaces the CometBFT consensus layer.

Development

We use Go 1.22. We use buf to manage protobufs.

Prerequisites

1. Install go 1.22 or higher.

2. Install jq

3. Install foundry

4. Install buf:

   make install-buf
   

5. Install golangci-lint:

   make install-golangci-lint
   
   

6. Install go-test-coverage:

   make install-go-test-coverage
   
   

Running tests

1. Set up the environment for end-to-end (e2e) tests:

   make setup-e2e
   

2. Run the e2e tests:

   make e2e
   

3. Run the unit tests:

   make test
   

Code Quality, Linting and Coverage

1. Run linting:

   make lint
   

2. Check test coverage

   make check-cover
   

Cleaning Up

1. Clean up generated files and artifacts:

   make clean