mara-chain

README

Mara chain

Mara chain is a scalable and interoperable Ethereum library, built on Proof-of-Stake with fast finality using the Cosmos SDK, which runs on top of Tendermint Core consensus engine.

Note: Requires Go 1.18+

Installation

If you don't have Go installed or configured on your PC, the command make install command will return an error /bin/sh: go: command not found.

Kindly follow the following steps to install and configure your PC to run the Mara Chain locally.

Step 1

Download and install Go quickly with the steps described here.

Next, run go version to confirm the installation succeeded.

Step 2

Run the following command to install dependencies:

make install

If you haven't installed jq already or encounter jq not found follow the guide to install jq.

Step 3

Navigate to the Mara Chain project directory using the following command.

cd mara-chain

Verify everything went well by running the following command.

which marad

You will get the error marad not found. This is because you need to set $GOBIN and add it to the path where marad would be located. Let's fix that by running the following command:

export PATH=$PATH:$(go env GOPATH)/bin

The scripts in the rest of this document use $GOPATH instead of $(go env GOPATH) for brevity. To make the scripts run as written if you have not set GOPATH, you can substitute $HOME/go in those commands or else run:

export GOPATH=$(go env GOPATH)

Check here to learn more about GOPATH.

Step 4

To start up the Mara chain, run the following command:

./init.sh

Check out the latest release.

Quick Start

To learn how the Mara chain works from a high-level perspective, go to the Introduction section from the documentation. You can also check the instructions to Run a Node.

For an example of how the Mara Chain can be used on any Cosmos-SDK chain, please refer to Evmos.

Contributing

Looking for an excellent place to start contributing? Check out some good first issues.