Mochimo Mesh API v1.1.2

A Rosetta API implementation for the Mochimo blockchain. This middleware provides standardized blockchain interaction via the Rosetta protocol.

System Requirements

• Mochimo Node v3pre2p1
• Go 1.22.5 or higher
• Ubuntu 22.04 (recommended) or compatible Linux distribution

Configuration

Command Line Flags

Flag	Type	Default	Description
-settings	string	"interface_settings.json"	Path to interface settings file
-tfile	string	"mochimo/bin/d/tfile.dat"	Path to node's tfile.dat file
-fp	float	0.4	Lower percentile of fees from recent blocks
-refresh_interval	duration	5s	Sync refresh interval in seconds
-ll	int	5	Log level (1-5, Least to most verbose)
-solo	string	""	Single node IP bypass (e.g., "0.0.0.0")
-p	int	8080	HTTP port
-ptls	int	8443	HTTPS port
-online	bool	true	Run in online mode
-cert	string	""	Path to SSL certificate file
-key	string	""	Path to SSL private key file

Environment Variables

• MCM_CERT_FILE: Path to SSL certificate
• MCM_KEY_FILE: Path to SSL private key

HTTPS Configuration

Enable HTTPS using either method:

1. Command line flags:

-cert string      Path to SSL certificate file
-key string       Path to SSL private key file

2. Environment variables:

• MCM_CERT_FILE: Path to SSL certificate
• MCM_KEY_FILE: Path to SSL private key

3. Using Certbot: Certbot can be used to automatically obtain and renew SSL certificates from Let's Encrypt. Follow these steps to set up Certbot:

• Install Certbot:

sudo apt-get update
sudo apt-get install certbot

• Obtain a certificate:

sudo certbot certonly --standalone -d yourdomain.com

• Configure the paths to the obtained certificate and key in your environment variables or command line flags:

export MCM_CERT_FILE=/etc/letsencrypt/live/yourdomain.com/fullchain.pem
export MCM_KEY_FILE=/etc/letsencrypt/live/yourdomain.com/privkey.pem

• Set up a cron job to renew the certificate automatically:

sudo crontab -e

Add the following line to the crontab file to renew the certificate every day at noon:

0 12 * * * /usr/bin/certbot renew --quiet

Quick Start with Docker

docker build -t mochimo-mesh .
docker run -d \
  -p 8080:8080 \
  -p 8443:8443 \
  -v mochimo_data:/data/mochimo \
  -v mesh_data:/data/mesh \
  --name mochimo-mesh \
  mochimo-mesh

Manual Setup

1. Clone and build:

git clone -b 3.0 https://github.com/NickP005/mochimo-mesh.git
cd mochimo-mesh
go build -o mesh .

2. Ensure Mochimo node is running and synced under the mochimo/bin/ subfolder:

git clone -b v3rc2 https://github.com/mochimodev/mochimo mochimo/
cd mochimo/
make mochimo
cd ..

3. Run:

./mesh -solo 0.0.0.0         # Connect to local node
./mesh -p 8081               # Custom port
./mesh -cert cert.pem -key key.pem  # Enable HTTPS

API Endpoints

All endpoints accept POST requests with JSON payloads.

For detailed examples on how to use these endpoints, see our Query Examples documentation.

Network

• /network/list - List supported networks
• /network/status - Get chain status
• /network/options - Get network options

Account

• /account/balance - Get address balance
  • Address format: "0x" + hex string

Block

• /block - Get block by number or hash
• /block/transaction - Get transaction details

Mempool

• /mempool - List pending transactions' id
• /mempool/transaction - Get pending transactison

Construction

• /construction/derive - Derive address from public key
• /construction/preprocess - Prepare transaction
• /construction/metadata - Get transaction metadata
• /construction/payloads - Create unsigned transaction
• /construction/combine - Add signatures
• /construction/submit - Submit transaction

Custom Methods

• /call
  • tag_resolve: Resolve tag to address

Address Types

• Tag: 20 bytes (hex encoded with "0x" prefix)
• Address: 20 bytes (hex encoded with "0x" prefix)
• Tagged Address: 40 bytes (hex encoded with "0x" prefix)

Technical Details

• Currency Symbol: MCM
• Decimals: 9 (1 MCM = 10^9 nanoMCM)
• Block Sync: Requires mochimo/bin/d/tfile.dat access (if no other path is specified in the flags)
• Node Communication: Local node on specified IP/port

Error Codes

Code	Message	Retriable
1	Invalid request	false
2	Internal error	true
3	TX not found	true
4	Account not found	true
5	Wrong network	false
6	Block not found	true
7	Wrong curve type	false
8	Invalid address	false

Support & Community

Join our communities for support and discussions:

• NickP005 Development Server: Technical support and development discussions
• Mochimo Official: General Mochimo blockchain discussions and community