Skip to content
Available on private testnetTestnet: yesMainnet: Not availableSoftware: Core bad4a06ea · protocol pqwerai-v8-testnet/1Updated

Network and your own node

The wallet signs transactions locally but needs a node to read the chain and broadcast. This page covers connecting to a node (the Network page) and running your own (the Node page).

The Network page (Advanced mode)

Use Network to choose which node the wallet talks to:

  • Local discovery — the wallet probes 127.0.0.1:8545 (the Core default) and the smoke-test ports and offers any node it finds.
  • Remote node — enter a node's URL. A remote node can use a bearer token, which the wallet stores DPAPI-protected on Windows.

Approval pins chain ID and genesis

When you approve a node, the wallet pins its chain ID and its genesis hash. From then on it refuses to sign if either value changes — so a node that is swapped for one on a different chain cannot trick the wallet. The wallet reconnects automatically with backoff if the node drops.

For an https node, the certificate's SHA-256 is shown and pinned at approval (self-signed node certificates work safely), and a different certificate later is refused. Plain http is allowed for remote nodes but flagged.

The Node page — run your own full node

The wallet can run PQWERAI Core as its own full node, so the chain is downloaded and verified on your PC. Core binaries are supplied separately by the network operator; the wallet does not bundle them.

Backends

Under Advanced → Node → Backend:

  • native runs pqwerai-core.exe directly on Windows (or pqwerai-core on Linux via the CLI's node-run) when the node build sits next to the wallet or in a folder you choose. This is the default and needs no WSL, Go, GCC, Python or installed .NET.
  • wsl is an explicit legacy option for the Linux build inside WSL.
  • auto selects native and reports a missing native bundle rather than silently starting WSL.

Steps

  1. Install copies pqwerai-core (and pqwerai-cli) and the GhostRider helper into a wallet-owned folder. The helper's SHA-256 is pinned on first install and the node is refused if it later changes.
  2. Chain — Simple setup joins the existing 20777 network using the bundled, SHA-256-verified genesis and its expected genesis hash. It never generates a replacement genesis or overwrites another profile's database. Advanced mode can instead create a disposable private chain or import another operator's genesis.
  3. Start runs the node with RPC on 127.0.0.1 only, shows sync progress and the log, and the wallet automatically approves (pins chain ID and genesis) and connects to it. You can optionally stop it with the wallet.

The native P2P listener defaults to loopback, and outbound peers work. Operators who need incoming peers can set LocalNode.P2pListenAddress to a specific interface in settings and open their firewall; RPC always stays on loopback.

GhostRider mining

With your own node running, "Mine with this node" mines proof-of-work blocks with the rewards going to the selected account. The native Windows node bundled since wallet 0.8.11 mines without WSL. Mining threads (0.8.13) sets how many GhostRider workers run: 0 = every logical processor; Apply (restarts the node) applies it. Step by step: Mine from the Windows wallet. If AI Sharing is active, you can have the node and helper drop to Idle CPU priority so AI sharing comes first (CR-0053).

Smartnode signer

The Node page can also run pqwerai-core validator with your validator key so your registered Smartnode votes for BFT finality:

  • The key password reaches the signer through an owner-only file that is deleted as soon as the signer is ready — it never appears on a command line.
  • Enroll new key is only for a brand-new validator key. Start signer reuses the original journal and trusted anchor and refuses missing state.

Never re-enroll an old key or copy a live signer

Re-enrolling a key that already voted, or running the same signer on two machines, can produce conflicting votes and get your Smartnode slashed. Always Start signer on an existing key; only Enroll a truly new one.


Sources at 7a33c77104: apps/pqwerai-wallet-windows/README.md

Found a problem? Report a documentation issue · Build testnet-rc1+7a33c77104