HP Verification Node Plugin

A verification node plugin for Humanity Protocol. It runs as a Docker container managed by interactive setup scripts, automatically processing on-chain verification tasks.

Prerequisites

• Docker installed and running
• A Humanity Protocol License NFT

Quick Start

One-Line Install (Recommended)

No need to clone the repo. Just run one command and follow the interactive wizard.

macOS / Linux (Testnet - default):

curl -sSL https://github.com/humanity-org/hp-verification-node-plugin/releases/latest/download/start.sh | bash

macOS / Linux (Mainnet):

curl -sSL https://github.com/humanity-org/hp-verification-node-plugin/releases/latest/download/start.sh | bash -s -- --network mainnet

Windows (PowerShell - Testnet):

irm https://github.com/humanity-org/hp-verification-node-plugin/releases/latest/download/start.ps1 | iex

Windows (PowerShell - Mainnet):

& ([scriptblock]::Create((irm https://github.com/humanity-org/hp-verification-node-plugin/releases/latest/download/start.ps1))) --network mainnet

Windows (CMD - Testnet):

powershell -Command "irm https://github.com/humanity-org/hp-verification-node-plugin/releases/latest/download/start.ps1 | iex"

Windows (CMD - Mainnet):

powershell -Command "& ([scriptblock]::Create((irm https://github.com/humanity-org/hp-verification-node-plugin/releases/latest/download/start.ps1))) --network mainnet"

Passing Options

You can skip the interactive wizard by passing options directly:

macOS / Linux:

curl -sSL https://github.com/humanity-org/hp-verification-node-plugin/releases/latest/download/start.sh | bash -s -- --network mainnet --owner-address 0xYOUR_ADDRESS

Windows (PowerShell):

& ([scriptblock]::Create((irm https://github.com/humanity-org/hp-verification-node-plugin/releases/latest/download/start.ps1))) --network mainnet --owner-address 0xYOUR_ADDRESS

Available Options

Option	Description
--network <testnet|mainnet>	Select network (default: testnet)
--owner-address <address>	License NFT holder's Ethereum address
--private-key <key>	Private key for transaction signing (without 0x prefix)
--container-name <name>	Custom container name (default: hp-verification-node-plugin)
--restart	Restart using saved config (skip setup wizard)
-v, --verbose	Enable debug-level logging

Network Configuration

The --network flag selects the blockchain network and corresponding Docker image:

Network	Chain ID	Docker Image Tag
testnet (default)	7080969	ghcr.io/humanity-org/hp-verification-node-plugin:testnet
mainnet	6985385	ghcr.io/humanity-org/hp-verification-node-plugin:latest

Run Locally

If you've already downloaded the scripts:

# Testnet (default)
./start.sh

# Mainnet
./start.sh --network mainnet

On Windows, double-click start.cmd or run:

.\start.ps1
.\start.ps1 --network mainnet

Running Multiple Instances

Run the wizard multiple times with different node names, or use CLI arguments:

./start.sh --network mainnet --owner-address 0xAddr1 --private-key key1 --container-name node-1
./start.sh --network mainnet --owner-address 0xAddr2 --private-key key2 --container-name node-2

Each instance requires its own License NFT and HP token balance.

Common Commands

# View help
./start.sh -h

# Check container status
docker ps --filter name=hp-verification-node-plugin

# Follow logs
docker logs -f hp-verification-node-plugin

# Stop the node
docker stop hp-verification-node-plugin

# Restart / update to latest version (just re-run the start script)
./start.sh
./start.sh --restart  # skip wizard, reuse saved config

Troubleshooting

Authentication Failures

• Verify private key is correctly configured
• Ensure verification API base URL is accessible

Version Mismatch

If jobs are being skipped with "Node version too old" message, re-run the start script to pull the latest image.

License

MIT