Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.paxeer.app/llms.txt

Use this file to discover all available pages before exploring further.

​
1. Connect a Wallet

HyperPaxeer is a standard EVM chain (Chain ID 125). Any Ethereum-compatible wallet works — MetaMask, Rabby, or the native PaxPort Wallet.
Open your wallet’s network settings and add:
FieldValue
Network NameHyperPaxeer
RPC URLhttps://public-rpc.paxeer.app/rpc
Chain ID125
Currency SymbolHPX
Block Explorerhttps://paxscan.io
PaxPort ships with HyperPaxeer pre-configured — no manual network setup required. Download from paxeer.app/paxport.

​
2. Run a Node (Optional)

The hpx CLI deploys Docker-based RPC or Validator nodes with a single command. Minimum requirements: 16 GB RAM, 6 CPU cores, 300 GB disk, Ubuntu 22.04+. 
curl -sSL https://hyperpaxeer.com/hyper-os/new/get-hpx.sh | sudo bash
The installer checks your system, installs dependencies, and launches an interactive setup wizard. After setup: 
hpx deploy my-rpc rpc        # deploy an RPC node
hpx deploy my-val validator   # deploy a validator node
hpx dashboard                 # live status of all nodes
Each node gets its own Docker Compose stack under /root/hyperpax-nodes/<name>/ with isolated ports that auto-increment.
CommandPurpose
hpx listList all registered nodes
hpx info <name>Sync status, height, peers
hpx logs <name>Stream node logs
hpx start all / hpx stop allBulk lifecycle
hpx capacityShow remaining server resources
See Run a Validator for the full operator guide.

​
3. Deploy a Smart Contract

HyperPaxeer is fully compatible with Solidity tooling. Foundry is the recommended framework. 
# Install Foundry
curl -L https://foundry.paradigm.xyz | bash && foundryup

# Create project
forge init my-project && cd my-project

# Deploy (use --legacy --slow for Alexandria Fork chains)
forge create src/Counter.sol:Counter \
  --rpc-url https://public-rpc.paxeer.app/rpc \
  --private-key $PRIVATE_KEY \
  --legacy --slow
Store private keys in a .env file and never commit them to version control.

​
4. Verify on PaxScan

forge verify-contract \
  --chain-id 125 \
  --compiler-version v0.8.24 \
  DEPLOYED_ADDRESS \
  src/Counter.sol:Counter \
  --verifier blockscout \
  --verifier-url https://paxscan.io/api

​
5. Integrate in a Frontend

wagmi-config.ts
import { createConfig, http } from 'wagmi'
import { defineChain } from 'viem'

export const hyperpaxeer = defineChain({
  id: 125,
  name: 'HyperPaxeer',
  network: 'hyperpaxeer',
  nativeCurrency: { decimals: 18, name: 'HyperPaxeer', symbol: 'HPX' },
  rpcUrls: {
    default: { http: ['https://public-rpc.paxeer.app/rpc'] },
  },
  blockExplorers: {
    default: { name: 'PaxScan', url: 'https://paxscan.io' },
  },
})

export const config = createConfig({
  chains: [hyperpaxeer],
  transports: { [hyperpaxeer.id]: http() },
})

​
Next Steps

Network Configuration

wagmi, viem, ethers.js, and web3.js setup

Smart Contracts

Deployment patterns, verification, and interaction guides

Architecture

Dual-VM design, precompiles, and the x/paxoracle module

JSON-RPC Reference

Test RPC methods against the live network