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:
The binaries are not code-signed yet, so Windows SmartScreen may warn. The first launch opens a setup wizard:
- Create or import an account — a brand-new key, a private key, a V3 keystore file, or a backup.
- Choose a password — it encrypts the keystore on disk.
- Save an encrypted backup — keep it somewhere safe and separate.
- 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_*oreth_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