> ## Documentation Index
> Fetch the complete documentation index at: https://sidiorresearchlabs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Connect a wallet, run a node, and deploy your first contract on HyperPaxeer in under ten minutes

## 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**.

> [accordion] PaxPort Wallet
>
> PaxPort ships with HyperPaxeer pre-configured — no manual network setup required. Download from [paxportwallet.com](http://paxportwallet.com) .

> [accordion] Manual — MetaMask / Rabby
>
> Open your wallet's network settings and add:
>
> | Field | Value |
> | - | - |
> | Network Name | `HyperPaxeer` |
> | RPC URL | `https://public-rpc.paxeer.app/rpc` |
> | Chain ID | `125` |
> | Currency Symbol | `HPX` |
> | Block Explorer | `https://paxscan.io` |

***

## 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+.

```bash theme={null}
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:

```bash theme={null}
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
```

> [!TIP]
>
> Each node gets its own Docker Compose stack under `/root/hyperpax-nodes/<name>/` with isolated ports that auto-increment.

| Command | Purpose |
| - | - |
| `hpx list` | List all registered nodes |
| `hpx info <name>` | Sync status, height, peers |
| `hpx logs <name>` | Stream node logs |
| `hpx start all` / `hpx stop all` | Bulk lifecycle |
| `hpx capacity` | Show remaining server resources |

See [Run a Validator](https://sidiorresearchlabs.mintlify.site/validate/setup/run-a-validator.md) for the full operator guide.

***

## 3. Deploy a Smart Contract

HyperPaxeer is fully compatible with Solidity tooling. Foundry is the recommended framework.

> [tab] Foundry
>
> ```bash theme={null}
> # 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
> ```

> [tab] Hardhat
>
> ```bash theme={null}
> npm install --save-dev hardhat @nomicfoundation/hardhat-toolbox
> ```
>
> ```javascript hardhat.config.js theme={null}
> module.exports = {
>   solidity: "0.8.24",
>   networks: {
>     hyperpaxeer: {
>       url: "https://public-rpc.paxeer.app/rpc",
>       chainId: 125,
>       accounts: [process.env.PRIVATE_KEY]
>     }
>   }
> };
> ```
>
> ```bash theme={null}
> npx hardhat run scripts/deploy.js --network hyperpaxeer
> ```

> [tab] Remix
>
> 1. Open [remix.ethereum.org](https://remix.ethereum.org)
> 2. Write or import your contract
> 3. Compile with Solidity 0.8.24+
> 4. Connect MetaMask (ensure Chain ID 125 is selected)
> 5. Deploy via **Injected Provider — MetaMask**

> [!WARNING]
>
> Store private keys in a `.env` file and never commit them to version control.

***

## 4. Verify on PaxScan

```bash theme={null}
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

```typescript wagmi-config.ts theme={null}
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

> [card] [Network Configuration](https://sidiorresearchlabs.mintlify.site/configuration.md)
>
> wagmi, viem, ethers.js, and web3.js setup

> [card] [Smart Contracts](https://sidiorresearchlabs.mintlify.site/contracts.md)
>
> Deployment patterns, verification, and interaction guides

> [card] [Architecture](https://sidiorresearchlabs.mintlify.site/concepts/architecture/overview.md)
>
> Dual-VM design, precompiles, and the x/paxoracle module

> [card] [JSON-RPC Reference](https://sidiorresearchlabs.mintlify.site/rpc.md)
>
> Test RPC methods against the live network


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.