Android Node: Arch Linux via proot (RocksDB/UTXO Mode)

1. Install proot-distro in Termux

Open Termux and run:

pkg update && pkg upgrade -y

pkg install proot-distro -y

2. Install Arch Linux via proot-distro

This will download the Arch Linux root filesystem:

proot-distro install archlinux

3. Login to Arch Linux Environment

Each time you want to run the node using this method, you first need to log into the Arch environment:

proot-distro login archlinux

Your terminal prompt should change, indicating you are now inside Arch Linux within Termux.

4. Inside Arch Linux: Install Dependencies (First Time Only)

Update package lists:

pacman -Syu --noconfirm

Install Java (OpenJDK 17 recommended), wget, and nano:

pacman -S jdk-openjdk wget nano --noconfirm

5. Inside Arch Linux: Download RocksDB Ergo Node JAR

You must download the JAR variant specifically built with RocksDB support. Find the correct .jar file (often named ergo-<version>-rocksdb.jar) on the Ergo Releases page.

Get the download URL for the specific RocksDB JAR you need. Use wget to download it within the Arch environment:

# Example (replace URL with the actual RocksDB JAR URL):
ROCKSDB_JAR_URL="https://github.com/ergoplatform/ergo/releases/download/vX.Y.Z/ergo-X.Y.Z-rocksdb.jar"
echo "Downloading RocksDB Ergo node JAR from: $ROCKSDB_JAR_URL"
wget -q --show-progress "$ROCKSDB_JAR_URL" -O ergo-rocksdb.jar

(Replace URL with the actual RocksDB JAR URL from the releases page).

6. Inside Arch Linux: Create Configuration File (ergo.conf)

Create the file using nano:

nano ergo.conf

Paste a configuration suitable for stateType="utxo" with pruning (adjust blocksToKeep based on your storage capacity):

ergo {
  node {
    stateType = "utxo" // Use UTXO state with RocksDB
    // Keep ~1 week of blocks (~3-5GB?), adjust based on storage
    // WARNING: -1 (archival) is likely impractical on mobile storage
    blocksToKeep = 10080 
    mining = false

    # Enable faster bootstrapping (both recommended)
    nipopow.nipopowBootstrap = true
    utxoBootstrap = true
  }
}

scorex {
  restApi {
    apiKeyHash = "324dcf027dd4a30a932c441f365a25e86b173defa4b8e58948253471b81b72cf" // Example, change this
  }
  network {
    # Optional: Add known reliable peers
    # knownPeers = ["ip:port", "ip:port"]
  }
}

• stateType = "utxo": Use UTXO state with RocksDB.
• blocksToKeep = 10080: Keeps roughly the last week's worth of full blocks. Adjust based on storage/needs. Lower values save space but limit historical data access via API.
• nipopow.nipopowBootstrap = true & utxoBootstrap = true: Enable fast synchronization methods. The node will use the best available option from peers.

Save the file: Press CTRL + O, then Enter. Exit nano: Press CTRL + X.

7. Inside Arch Linux: Launch the Node

Run the RocksDB JAR, allocating sufficient memory (UTXO mode generally needs more than digest mode):

java -Xmx2G -jar ergo-rocksdb.jar --mainnet -c ergo.conf

Adjust -Xmx2G based on your device's available RAM. You might need more or less.

8. Monitor Synchronization

Open a web browser on your Android device and go to http://127.0.0.1:9053/panel.
Synchronization, especially the initial UTXO snapshot download, will take time and consume significant storage.