Network Configuration

Configure HyperPaxeer in your applications using various libraries and frameworks

Overview

Configure HyperPaxeer in your applications using wagmi, viem, ethers.js, or web3.js.

Network Details

Parameter	Value
Chain ID	125
Network Name	Paxeer Network
Native Currency	PAX (Paxeer)
Decimals	18
RPC Endpoint	https://public-rpc.paxeer.app/rpc
Block Explorer	https://paxscan.io
Explorer API	https://paxscan.io/api

Configuration by Library

wagmi

wagmi Configuration

Setup HyperPaxeer with wagmi for React applications.

wagmi-config.ts

import { createConfig, http } from 'wagmi'
import { defineChain } from 'viem'

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

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

Usage in React

App.tsx

import { WagmiProvider } from 'wagmi'
import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
import { config } from './wagmi-config'

const queryClient = new QueryClient()

function App() {
  return (
    <WagmiProvider config={config}>
      <QueryClientProvider client={queryClient}>
        <YourApp />
      </QueryClientProvider>
    </WagmiProvider>
  )
}

Install required packages: npm install wagmi viem @tanstack/react-query

viem

viem Configuration

Setup HyperPaxeer with viem for TypeScript applications.

viem-config.ts

import { createPublicClient, http, defineChain } from 'viem'

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

export const publicClient = createPublicClient({
  chain: paxeer,
  transport: http(),
})

Usage

import { publicClient } from './viem-config'

// Get block number
const blockNumber = await publicClient.getBlockNumber()

// Get balance
const balance = await publicClient.getBalance({
  address: '0x...',
})

// Read contract
const data = await publicClient.readContract({
  address: '0x...',
  abi: contractAbi,
  functionName: 'balanceOf',
  args: ['0x...'],
})

Install viem: npm install viem

ethers.js

ethers.js Configuration

Setup HyperPaxeer with ethers.js v6.

ethers-config.js

import { ethers } from 'ethers'

const paxeerNetwork = {
  chainId: 125,
  name: 'HyperPaxeer',
}

// Connect to HyperPaxeer
const provider = new ethers.JsonRpcProvider(
  'https://public-rpc.paxeer.app/rpc',
  paxeerNetwork
)

export { provider }

Usage

import { provider } from './ethers-config'

// Get block number
const blockNumber = await provider.getBlockNumber()
console.log('Current block:', blockNumber)

// Get balance
const balance = await provider.getBalance('0x...')
console.log('Balance:', ethers.formatEther(balance), 'HPX')

// Get signer from MetaMask
const signer = await provider.getSigner()

// Send transaction
const tx = await signer.sendTransaction({
  to: '0x...',
  value: ethers.parseEther('1.0'),
})
await tx.wait()

// Interact with contract
const contract = new ethers.Contract(
  contractAddress,
  contractABI,
  signer
)
await contract.transfer('0x...', ethers.parseEther('10'))

Install ethers: npm install ethers@6

web3.js

web3.js Configuration

Setup HyperPaxeer with web3.js v4.

web3-config.js

import Web3 from 'web3'

// Connect to HyperPaxeer
const web3 = new Web3('https://public-rpc.paxeer.app/rpc')

export { web3 }

Usage

import { web3 } from './web3-config'

// Get network ID
const networkId = await web3.eth.net.getId()
console.log('Network ID:', networkId) // 125

// Get current block number
const blockNumber = await web3.eth.getBlockNumber()
console.log('Current block:', blockNumber)

// Get balance
const balance = await web3.eth.getBalance(address)
console.log('Balance:', web3.utils.fromWei(balance, 'ether'), 'HPX')

// Send transaction
const receipt = await web3.eth.sendTransaction({
  from: fromAddress,
  to: toAddress,
  value: web3.utils.toWei('1', 'ether'),
})

// Interact with contract
const contract = new web3.eth.Contract(contractABI, contractAddress)
await contract.methods.transfer(toAddress, amount).send({
  from: fromAddress,
})

Install web3.js: npm install web3@4

MetaMask Configuration

Add HyperPaxeer to MetaMask programmatically:

async function addPaxeerNetwork() {
  try {
    await window.ethereum.request({
      method: 'wallet_addEthereumChain',
      params: [
        {
          chainId: '0xe5', // 125 in hex
          chainName: 'HyperPaxeer',
          nativeCurrency: {
            name: 'HyperPaxeer',
            symbol: 'HPX',
            decimals: 18,
          },
          rpcUrls: ['https://public-rpc.paxeer.app/rpc'],
          blockExplorerUrls: ['https://paxscan.io'],
        },
      ],
    });
    console.log('HyperPaxeer added to MetaMask');
  } catch (error) {
    console.error('Error adding network:', error);
  }
}

Environment Variables

Store your configuration in environment variables:

.env

# HyperPaxeer Configuration
PAXEER_RPC_URL=https://public-rpc.paxeer.app/rpc
PAXEER_CHAIN_ID=125
PAXEER_EXPLORER=https://paxscan.io

# Your private key (NEVER commit this!)
PRIVATE_KEY=your_private_key_here

Never commit private keys or sensitive credentials to version control. Use environment variables and add .env to your .gitignore.

Hardhat Configuration

hardhat.config.js

require("@nomicfoundation/hardhat-toolbox");
require('dotenv').config();

module.exports = {
  solidity: "0.8.20",
  networks: {
    paxeer: {
      url: process.env.PAXEER_RPC_URL,
      chainId: parseInt(process.env.PAXEER_CHAIN_ID),
      accounts: [process.env.PRIVATE_KEY],
    },
  },
  etherscan: {
    apiKey: {
      paxeer: process.env.ETHERSCAN_API_KEY || "YOUR_API_KEY",
    },
    customChains: [
      {
        network: "paxeer",
        chainId: 125,
        urls: {
          apiURL: "https://paxscan.io/api",
          browserURL: "https://paxscan.io",
        },
      },
    ],
  },
};

Foundry Configuration

foundry.toml

[profile.default]
src = "src"
out = "out"
libs = ["lib"]
solc_version = "0.8.20"

[rpc_endpoints]
paxeer = "https://public-rpc.paxeer.app/rpc"

[etherscan]
paxeer = { key = "${ETHERSCAN_API_KEY}", url = "https://paxscan.io/api" }

Testing Connection

Verify your configuration is working:

TypeScript

import { publicClient } from './viem-config'

async function testConnection() {
  try {
    const blockNumber = await publicClient.getBlockNumber()
    console.log('✅ Connected! Current block:', blockNumber)
    console.log('✅ Chain ID:', publicClient.chain.id)
  } catch (error) {
    console.error('❌ Connection failed:', error)
  }
}

testConnection()

Next Steps

Quick Start

Follow our getting started guide

Smart Contracts

Deploy and interact with contracts

Examples

View complete integration examples

API Reference

Explore all available RPC methods