# Hegemon Testnet Join > Join the Hegemon testnet using the shared chainspec, verify genesis, sync to the tip, and enable mining safely on the live InlineTx path. Use when this capability is needed. - Skill: `tomevault-io/hegemon-testnet-join` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/hegemon-testnet-join` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/hegemon-testnet-join/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/hegemon-testnet-join --- # Goal Connect a new node to the Hegemon testnet, verify it is on the canonical chain, and mine only after sync completes. # Defaults - Approved public seed list: hegemon.pauli.group:30333,158.69.222.121:30333 - Chain spec: config/dev-chainspec.json - Chainspec SHA-256: 455f552ec9e73bb07ad95ac8b9bf03c72461acc16ffd9afe738b70c31cce3cc1 - RPC port: 9944 - P2P listen: /ip4/0.0.0.0/tcp/30333 # Steps 1. Ensure binaries exist (fresh clones must run make setup and make node): - make setup - make node - cargo build --release -p walletd 2. Verify the shared chainspec matches the boot node. Do not use --chain dev. - shasum -a 256 config/dev-chainspec.json - Expected: 455f552ec9e73bb07ad95ac8b9bf03c72461acc16ffd9afe738b70c31cce3cc1 3. Create or open a wallet and export the shielded mining address: - export HEGEMON_MINER_ADDRESS=$(printf '%s\n{"id":1,"method":"status.get","params":{}}\n' "YOUR_PASSPHRASE" \ | ./target/release/walletd --store ~/.hegemon-wallet --mode open \ | jq -r '.result.primaryAddress') 4. Start the node with the shared chainspec and seed: - HEGEMON_MINE=1 \ HEGEMON_SEEDS="hegemon.pauli.group:30333,158.69.222.121:30333" \ HEGEMON_MINER_ADDRESS="$HEGEMON_MINER_ADDRESS" \ HEGEMON_PQ_STRICT_COMPATIBILITY=1 \ ./target/release/hegemon-node \ --dev \ --base-path ~/.hegemon-node \ --chain config/dev-chainspec.json \ --listen-addr /ip4/0.0.0.0/tcp/30333 \ --rpc-port 9944 \ --rpc-external \ --rpc-methods safe \ --name "TestnetNode" - This is the live InlineTx path. Do not provision `hegemon-prover`, `hegemon-prover-worker`, or proof-sidecar / recursive flags for a normal testnet join. 5. Monitor sync status and height. Mining pauses while syncing and resumes once caught up. - curl -s -H "Content-Type: application/json" \ -d '{"id":1,"jsonrpc":"2.0","method":"system_health"}' \ http://127.0.0.1:9944 | jq - curl -s -H "Content-Type: application/json" \ -d '{"id":1,"jsonrpc":"2.0","method":"hegemon_consensusStatus"}' \ http://127.0.0.1:9944 | jq - curl -s -H "Content-Type: application/json" \ -d '{"id":1,"jsonrpc":"2.0","method":"chain_getHeader"}' \ http://127.0.0.1:9944 | jq 6. If height stalls, check peers and genesis hash: - curl -s -H "Content-Type: application/json" \ -d '{"id":1,"jsonrpc":"2.0","method":"chain_getBlockHash","params":[0]}' \ http://127.0.0.1:9944 | jq - The returned genesis must match the already-synced trusted authoring node on the same chainspec. 7. Sync wallet notes against the node RPC: - printf '%s\n{"id":1,"method":"sync.once","params":{"ws_url":"ws://127.0.0.1:9944","force_rescan":false}}\n' "YOUR_PASSPHRASE" \ | ./target/release/walletd --store ~/.hegemon-wallet --mode open # Notes - All miners should use the exact same `HEGEMON_SEEDS` list to avoid accidental forks/partitions. Keep private peer IPs out of public docs. - Keep host clock sync enabled (NTP/chrony). PoW import rejects future-skewed timestamps. - If the genesis hash or chainspec differ, stop the node and wipe the base path before restarting. - Keep RPC access locked down if you expose it beyond localhost. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/pauli-group) — claim your Tome and manage your conversions.