Skip to content

TTCECO/rosetta-maro

 
 

Repository files navigation

Rosetta

Rosetta maro

ROSETTA-MARO IS CONSIDERED ALPHA SOFTWARE. USE AT YOUR OWN RISK! MARO ASSUMES NO RESPONSIBILITY NOR LIABILITY IF THERE IS A BUG IN THIS IMPLEMENTATION.

Overview

rosetta-maro provides a reference implementation of the Rosetta API for maro in Golang. If you haven't heard of the Rosetta API, you can find more information here.

Features

  • Comprehensive tracking of all maro balance changes
  • Stateless, offline, curve-based transaction construction (with address checksum validation)
  • Atomic balance lookups using gttc's GraphQL Endpoint (gttc is maro in golang)
  • Idempotent access to all transaction traces and receipts

Usage

As specified in the Rosetta API Principles, all Rosetta implementations must be deployable via Docker and support running via either an online or offline mode.

YOU MUST INSTALL DOCKER FOR THE FOLLOWING INSTRUCTIONS TO WORK. YOU CAN DOWNLOAD DOCKER HERE.

Install

Running the following commands will create a Docker image called rosetta-maro:latest.

Run Local

After cloning this repository, run:

make install
export MODE=ONLINE
export NETWORK=MAINNET
export PORT=8080
export GRPC=http://35.189.152.23:8501
export GRAPHQL=http://35.189.152.23:8507
rosetta-maro run

Docker build From Source

After cloning this repository, run:

make build-local

Run

Running the following commands will start a Docker container in detached mode with a data directory at <working directory>/maro-data and the Rosetta API accessible at port 8080.

Configuration Environment Variables

  • MODE (required) - Determines if Rosetta can make outbound connections. Options: ONLINE or OFFLINE.
  • NETWORK (required) - maro network to launch and/or communicate with. Options: MAINNET or TESTNET (which defaults to MAINNET for backwards compatibility).
  • PORT(required) - Which port to use for Rosetta.
  • GRPC (optional) - Point to a remote gttc node's RPC address instead of initializing one
  • GRAPHQL (optional) - Point to a remote gttc node's GraphQL address instead of initializing one

Mainnet:Online

docker run -d --rm --ulimit "nofile=100000:100000" -v "$(pwd)/maro-data:/data" -e "MODE=ONLINE" -e "NETWORK=MAINNET" -e "PORT=8080" -p 8080:8080 -p 30303:30303 rosetta-maro:latest

If you cloned the repository, you can run make run-mainnet-online.

Mainnet:Online (Remote)

docker run -d --rm --ulimit "nofile=100000:100000" -e "MODE=ONLINE" -e "NETWORK=MAINNET" -e "PORT=8080" -e "GRPC=<NODE RPC URL>" -e "GRAPHQL=<NODE GRAPHQL URL>" -p 8080:8080 -p 30303:30303 rosetta-maro:latest

If you cloned the repository, you can run make run-mainnet-remote grpc=http://35.189.152.23:8501 graphql=http://35.189.152.23:8507.

Mainnet:Offline

docker run -d --rm -e "MODE=OFFLINE" -e "NETWORK=MAINNET" -e "PORT=8081" -p 8081:8081 rosetta-maro:latest

If you cloned the repository, you can run make run-mainnet-offline.

System Requirements

rosetta-maro has been tested on an AWS c5.2xlarge instance. This instance type has 8 vCPU and 16 GB of RAM. If you use a computer with less than 16 GB of RAM, it is possible that rosetta-maro will exit with an OOM error.

Recommended OS Settings

To increase the load rosetta-maro can handle, it is recommended to tune your OS settings to allow for more connections. On a linux-based OS, you can run the following commands (source):

sysctl -w net.ipv4.tcp_tw_reuse=1
sysctl -w net.core.rmem_max=16777216
sysctl -w net.core.wmem_max=16777216
sysctl -w net.ipv4.tcp_max_syn_backlog=10000
sysctl -w net.core.somaxconn=10000
sysctl -p (when done)

We have not tested rosetta-maro with net.ipv4.tcp_tw_recycle and do not recommend enabling it.

You should also modify your open file settings to 100000. This can be done on a linux-based OS with the command: ulimit -n 100000.

Development

  • make deps to install dependencies
  • make test to run tests
  • make lint to lint the source code
  • make salus to check for security concerns
  • make build-local to build a Docker image from the local context
  • make coverage-local to generate a coverage report

License

This project is available open source under the terms of the Apache 2.0 License.

© 2021 maro

Packages

No packages published

Languages

  • Go 89.5%
  • JavaScript 4.5%
  • Shell 2.6%
  • Makefile 2.1%
  • Dockerfile 1.3%