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

Wallet Manual

This manual explains every function of the PQWERAI wallet, one task at a time. The wallet is a non-custodial desktop application for the PQWERAI test network: your keys are created, stored and used to sign on your own PC, and the wallet talks to a PQWERAI Core node over JSON-RPC. It never holds your keys for you and no company can move your funds.

Test network only

PQWERAI testnet 20777 is a test network. Test PQAI, tEUR and QAI have no monetary value and there is no mainnet. The wallet is private testnet software: not a release, not independently audited, not code-signed.

For the feature summary and release notes, see the reference page PQWERAI Windows Wallet. This manual is the step-by-step companion.

Install and first start

Artifact How to use it
PQWERAI-Wallet-<v>-win-x64.msi Double-click. Per-user install to %LOCALAPPDATA%\Programs\PQWERAI Wallet, with Start-menu and desktop shortcuts and no administrator rights. Uninstall from Settings → Apps.
PQWERAI-Wallet-<v>-win-x64-portable.zip Extract and run PQWERAI.Wallet.exe. Data stays in wallet-data\ next to the exe. Bundles pqwerai-wallet-cli.exe and qai-wallet.exe.
pqwerai-wallet-cli-<v>-linux-x64.tar.gz Self-contained Linux command-line wallet with qai-wallet and node-run.

Both builds are self-contained — no .NET install is required. Always verify the download against SHA256SUMS before running it:

Get-FileHash .\PQWERAI-Wallet-<v>-win-x64.msi -Algorithm SHA256

The binaries are not code-signed yet, so Windows SmartScreen may warn. The first launch opens a setup wizard:

  1. Create or import an account — a brand-new key, a private key, a V3 keystore file, or a backup.
  2. Choose a password — it encrypts the keystore on disk.
  3. Save an encrypted backup — keep it somewhere safe and separate.
  4. Connect to a node — the wallet probes 127.0.0.1:8545 (the Core default) and the smoke-test ports. Remote nodes are only used after you enter and approve them.

See Accounts and backup for every account and backup task in detail.

Simple and Advanced mode

New wallets start in Simple mode, which shows the everyday pages: Dashboard, Send, Receive, Transactions, Tokens, Studio (token and NFT flows), Node (one button plus mining on/off) and Settings.

Turn on Advanced mode (the sidebar switch, or Settings) to reveal the expert pages: Smartnodes, Network, AI Sharing, Console, custom-contract deployment, the contract console and the full node controls. A keyboard shortcut to an expert page switches to Advanced mode automatically.

Where your data lives

Data Location (installed build)
Keystores, settings, transaction journal %PQWERAI_WALLET_DATA%, or the per-user default; a portable build keeps wallet-data\ next to the exe
Your own node's chain data and binaries %LOCALAPPDATA%\PQWERAI\Wallet\node (native)
Local AI models and runtimes %LOCALAPPDATA%\PQWERAI\Wallet\ai\local

A portable.flag file next to the exe switches to portable storage. The environment variable PQWERAI_WALLET_DATA overrides the data folder.

Every function, by page

Page What you do there Manual
Dashboard See your balance and address, copy your address, pick the next step Send and receive
Send Send PQAI with a fee preview and confirmation Send and receive
Receive Show your address and a QR code Send and receive
Transactions Follow each transaction from Pending to BFT-Finalized Transactions and status
Tokens Discover and transfer ERC-20 and ERC-721 tokens Tokens
Studio Build, deploy and verify tokens, NFTs and custom contracts Contract Studio
Network Connect to local or remote nodes; pin chain ID and genesis Network and your node
Node Run your own full node, mine, run a Smartnode signer Network and your node
Smartnodes Register, delegate, exit, withdraw and claim; finality health Smartnodes
Pools Find, create or join a per-model pool Model Pools
Recurring Grant and manage recurring payment permissions Recurring permissions
AI Sharing Share AI compute; run a local model AI Sharing
AI Escrow / Paid Ask Pay an approved provider per job Paid Ask and AI escrow
QAI Post-quantum Quantum Smart Accounts QAI post-quantum
Console Run wallet CLI commands inside the app Console and CLI
Workflows / Canvas Node editor for AI tasks; visual contract builder AI Workflows in the wallet
Settings Theme, motion, modes, security options Settings and security

The rules the wallet always follows

  • It signs only with an approved node whose chain ID and genesis hash still match what you approved.
  • Keys are decrypted only for the signing call and wiped from memory afterwards; only the signed raw transaction leaves your PC.
  • It never uses personal_* or eth_sign* RPC methods, and it sends no telemetry.
  • Amounts are exact integers — there is no floating-point rounding.

The full list is on Settings and security.


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

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