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 same directory where hexfetch is running.
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>-armv7.tar.gz -C /mnt/sdcard

hexfetch contents into 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

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

# Install wifi firmware
apk add linux-firmware-brcm

# LBU
lbu add /etc/
lbu commit -d

Setup hexfetch

echo "tmpfs /mnt/ramdisk tmpfs size=128m,mode=0755 0 0" >> /etc/fstab

# /etc/local.d/ramdisk.start

#!/bin/sh
cp /media/mmcblk0p1/hexfetch/hexfetch-arm /mnt/ramdisk/
cp -r /media/mmcblk0p1/hexfetch/static /mnt/ramdisk/
/mnt/ramdisk/hexfetch-arm

# Update RC configuration
chmod +x /etc/local.d/ramdisk.start
rc-update add local default

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

# /etc/init.d/hexfetch-arm

#!/sbin/openrc-run
name="hexfetch-arm"
description="hexfetch"
command="/mnt/ramdisk/hexfetch-arm"
command_args=""
pidfile="/var/run/hexfetch-arm.pid"
depend() {
    after ramdisk
}

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

lbu commit

---

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.

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