hexfetch

README

hexfetch

hexfetch is a web application for hexfetch with convenient features like HEX miners, charts and periodical data fetching from Pulsechain API.
This doesn't itself interact Pulsechain network but instead it uses HEXDailyStats API to fetch data.
hexfetch doesn't need the 0x addresses at all so it's 100% privacy.

hexfetch is made with go 1.24.2.

Running hexfetch will create a folder into /opt/ path.
settings directory contains user defined config.json and miners.json.

Environment variables

env	value	explanation
DEBUG	true/false	Enable logging. Default value: false

---

hexfetch for arm architecture

This branch called arm is for arm based architecture microcontrollers such as Raspberry Pi.
We are using Raspberry Pi Zero 2W for this build.

NOTE: ALL COMMANDS MUST BE RUN AS SUDO!

Prepare SD-card

Format SD-card with FAT32 partition called ALPINE.

Initialize ALPINE partition

sudo mkdir /mnt/sdcard
sudo mount /dev/sdc1 /mnt/sdcard

# Extract archive into /mnt/sdcard
sudo tar -xzf alpine-rpi-<version>-aarch64.tar.gz -C /mnt/sdcard

WiFi setup

sudo nano /mnt/sdcard/wpa_supplicant.conf

country=FI

network={
	key_mgmt=WPA-PSK
	ssid="mySSID"
	psk="myPassPhrase"
}

Headless Alpine bootstrap

# Download from https://github.com/macmpi/alpine-linux-headless-bootstrap/releases
sudo mv headless.apkovl.tar.gz /mnt/sdcard

Unmount SD-card

sync
sudo umount /mnt/sdcard

Connecting into rpi0

ssh root@192.168.68.102

Setup the Alpine Linux

setup-alpine
# Proceed with default options.

# SSH
# Allow root ssh login: prohibit-password
# input public SSH key

# Disk & Install
none

# ramdisk filesystem
echo "tmpfs /mnt/ramdisk tmpfs size=8m,mode=0755 0 0" >> /etc/fstab
mount -a

# LBU
lbu add /etc/wpa_supplicant/
lbu commit -d

# You may reboot and check ramdisk filesystem
df -h

hexfetch contents into sdcard

After Alpine Linux setup, you must run poweroff to shut rpi off. Take sd card off and mount it in PC:

sudo mount /dev/sdc1 /mnt/sdcard

sudo mkdir /mnt/sdcard/hexfetch
sudo mkdir /mnt/sdcard/hexfetch/static
# Copy hexfetch-arm executable into /mnt/sdcard/hexfetch
# Copy static files into /mnt/sdcard/hexfetch/static

sync
sudo umount mnt/sdcard

Setup hexfetch

# SSH into rpi
ssh root@<rpi-ip>

# Copy hexfetch file contents from init.d folder into /etc/init.d/hexfetch

# Update RC configuration
chmod +x /etc/init.d/hexfetch
rc-update add hexfetch default

# Settings folder
mkdir /opt/settings/
# Optionally move config.json and miners.json files into /opt/settings/ folder

lbu add /opt/settings/
lbu commit
reboot # after reboot hexfetch should be available from <rpi-ip>:5555

rc-service hexfetch status

# Add a daily cronjob:
crontab -e
1 0 * * * /etc/init.d/hexfetch restart # Restart hexfetch service every day at 00:01 UTC.

---

Updating hexfetch

To run newer hexfetch executable, power off the raspberry pi and pull sd-card out. Plug it into PC.

sudo mount /dev/sdc1 /mnt/sdcard
sudo mv hexfetch-arm /mnt/sdcard/hexfetch
# If static files are updated:
sudo rm -r /mnt/sdcard/hexfetch/static
sudo cp -r /static /mnt/sdcard/hexfetch

sync
sudo umount /mnt/sdcard

Notes

Any changes in settings or ending a miner in profile must be saved with lbu commit.
Daily cronjob is for fetching latest data for Charts tab because code isn't doing it every day at 00:00 UTC.

---

Tabs

Profile

Profile tab shows user's miners and T-Shares and total value of T-Shares.
If miner is matured, it will be shown (MATURED) with END button. Ending the miner will move it into Completed Miners container.

Viewing Completed Miners button opens a window of completed HEX miners.

Live Data

Live Data tab shows periodically fetched data from Pulsechain API.

Charts

Charts tab show historical charts of HEX price, T-Share rate and other useful information of HEX.

System info

System info tab shows system information of rpi.

• Memory
• CPU
• Disk

Settings

Settings tab shows:

• Live Data Settings for changing the frequency of fetching data (in minutes)
• Liquid HEX to calculate and show the value of liquid HEX in Profile tab
• Add New Miner for adding HEX miner with start date, end date and amount of T-Shares
• Existing Miners for list of HEX miners with Delete function