Skip to content

Limonata Network Testnet Installation Guide

Official public testnet guide for Limonata Network brought to you by INCENTIVED.ORG.


🖥️ Hardware Requirements

The following hardware specifications are recommended for optimal node performance:

ComponentMinimum Requirement
CPU4 or more physical CPU cores
MemoryAt least 8 GB RAM
StorageAt least 200 GB SSD NVMe
BandwidthAt least 100 Mbps internet connection

🛠️ 1. Install System Dependencies

Update your system repository and install the essential build packages:

bash
sudo apt update && sudo apt upgrade -y

sudo apt install curl tar wget clang pkg-config libssl-dev jq build-essential bsdmainutils git make ncdu gcc chrony liblz4-tool zip -y
🐹 2. Install Go (Golang)
Set up the recommended Go environment variable (v1.24.5) required to build and operate the network binary:

Bash
ver="1.24.5"
wget "[https://golang.org/dl/go$ver.linux-amd64.tar.gz](https://golang.org/dl/go$ver.linux-amd64.tar.gz)"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz"
rm "go$ver.linux-amd64.tar.gz"

# Configure environment paths
echo "export PATH=\$PATH:/usr/local/go/bin:\$HOME/go/bin" >> ~/.bash_profile
source ~/.bash_profile

# Verify installation
go version
📦 3. Install Node Binary
Download the compiled testnet binary from the official release repository and move it to the execution path:

Bash
wget [https://github.com/Limonata-Blockchain/limonata/releases/download/limonata-testnet-v0.1.0/limonatad-linux-amd64.tar.gz](https://github.com/Limonata-Blockchain/limonata/releases/download/limonata-testnet-v0.1.0/limonatad-linux-amd64.tar.gz)
tar xzf limonatad-linux-amd64.tar.gz
chmod +x limonatad
mv limonatad /usr/local/bin/
rm -rf limonatad-linux-amd64.tar.gz

# Check binary version
limonatad version
⚙️ 4. Initialize the Node
Initialize your genesis configurations. Please replace <YOUR_MONIKER> with your preferred validator identity name:

Bash
limonatad init <YOUR_MONIKER> --chain-id limonata_10777-1
📂 5. Fetch Genesis and Addrbook
Download the latest verified Genesis file and official address book directory:

Bash
# Download Genesis
curl -L [https://snapshot.vinjan-inc.com/limonata/genesis.json](https://snapshot.vinjan-inc.com/limonata/genesis.json) > \$HOME/.evmd/config/genesis.json

# Download Addrbook
curl -L [https://snapshot.vinjan-inc.com/limonata/addrbook.json](https://snapshot.vinjan-inc.com/limonata/addrbook.json) > \$HOME/.evmd/config/addrbook.json
🔗 6. Configure Network Peers & Gas Prices
Apply persistent node connections, configure gas prices, and adjust settings within config.toml and app.toml:

Bash
# Add seed/peers configurations
peers="[email protected]:19156"
sed -i -e "s|^persistent_peers *=.*|persistent_peers = \"\$peers\"|" \$HOME/.evmd/config/config.toml

# Set minimum gas prices
sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0aLIMO\"/" \$HOME/.evmd/config/app.toml

# Set node type configuration
sed -i -E "s|type = \".*\"|type = \"app\"|g" \$HOME/.evmd/config/config.toml

# Disable Indexer to save storage space (Optional)
sed -i 's|^indexer *=.*|indexer = "null"|' \$HOME/.evmd/config/config.toml
🚀 7. Create Systemd Service & Launch Node
Construct the system service daemon file to manage the background process and allow autostart on system reboots:

Bash
sudo tee /etc/systemd/system/limonatad.service > /dev/null <<EOF
[Unit]
Description=Limonata Testnet Node
After=network-online.target

[Service]
User=\$USER
ExecStart=\$(which limonatad) start --chain-id limonata_10777-1 --evm.evm-chain-id 10777 --minimum-gas-prices 0aLIMO
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target