Skip to main content

Create an Application With Monomer

In this tutorial, you will learn how to create a new Monomer L2 application. Before starting this tutorial, we recommend reading through the Overview and Learn sections in the documentation to familiarize yourself with the Monomer architecture and concepts.

Create a New Monomer Application​

We'll use the monogen tool to bootstrap a new Monomer L2 application.

To generate a new Monomer application with the default configuration, navigate to the parent directory of where you want to store your application and run the following command:

rm -rf ~/.testapp \
  && rm -rf testapp \
  && go run github.com/polymerdao/monomer/cmd/[email protected] \
  && cd testapp \
  && ./setup-helper.sh

To modify the default configuration, you can pass the following flags to the go run github.com/polymerdao/monomer/cmd/monogen command:

--address-prefix string   address prefix (default "cosmos")
--app-dir-path string     project directory (default "./testapp")
--gomod-path string       go module path (default "github.com/testapp/testapp")

Build and Run​

To build the application, run one of the following commands from the testapp directory:

If using a Go version <1.23.0, run:

go build -o testappd ./cmd/testappd

If using a Go version >=1.23.0, run:

go build -ldflags=-checklinkname=0 -o testappd ./cmd/testappd

Now that our application is configured, we can start the Monomer application by running the following command. Ensure that you specify the address of your L1 wallet address instead of {your_l1_wallet_address} to grant ETH to your L1 wallet on genesis.

./testappd monomer start --minimum-gas-prices 0.01wei --monomer.dev-start --api.enable --monomer.dev.l1-user-address "{your_l1_wallet_address}"

Congratulations! You've successfully integrated Monomer into your Cosmos SDK application.