Core CLI and configuration flags¶
Extracted from the Core source at the documented revision. pqwerai-core is the node; pqwerai-cli is the command-line wallet and Smartnode tool (the Windows Wallet ships the equivalent pqwerai-wallet-cli).
pqwerai-core node flags¶
| Flag | Type | Default | Description |
|---|---|---|---|
--datadir |
string | — | database directory (required) |
--genesis |
string | — | private-testnet genesis.json (required) |
--helper |
string | — | GhostRider hash helper path (required) |
--helper-sha256 |
string | — | GhostRider hash helper SHA-256 (required) |
--difficulty |
uint64 | 16 |
fixed private-testnet base difficulty; must match genesis |
--port |
int | 0 |
P2P TCP port (0 = random) |
--rpc.addr |
string | 127.0.0.1 |
JSON-RPC bind address |
--rpc.port |
int | 8545 |
JSON-RPC port |
--rpc.token-file |
string | — | file containing a bearer token; REQUIRED for non-loopback RPC |
--peers |
string | — | comma separated enode URLs to connect to |
--mine |
bool | false |
mine GhostRider blocks |
--etherbase |
string | — | mining reward address |
--pase-workers |
int | 0 |
experimental PASE workers (0 = canonical serial, the default) |
--g4-relayer-key |
string | — | secp256k1 key file of a funded disposable test account that relays finality certificates |
--verbosity |
int | 3 |
log level 0-5 |
--expect-genesis-hash |
string | — | refuse to start unless the genesis block hash equals this value |
--maxpeers |
int | 16 |
maximum P2P peers |
--p2p.target |
int | 8 |
keep at least this many peer connections when candidates exist (<= maxpeers) |
--p2p.subnet-limit |
int | 2 |
max connected peers per IPv4 /24 or IPv6 /48 (0 = off; loopback exempt; --peers never pruned) |
--p2p.peer-cache |
bool | true |
persist peers that completed the eth handshake on this chain (datadir/pqwerai-peers.json) |
--seed-manifest |
string | — | comma separated signed seed manifest files (dial candidates only, no consensus authority) |
--seed-manifest-keys |
string | — | comma separated trusted ed25519 seed-manifest public keys (hex) |
--discovery |
bool | false |
enable discv4 peer discovery seeded by --bootnodes |
--bootnodes |
string | — | comma separated enode URLs used to seed discovery (no consensus privileges) |
--nat |
string | none |
NAT mapping: none|any|upnp|pmp|extip: |
--rpc.logs-max-range |
uint64 | 5000 |
maximum block range of one eth_getLogs request |
--miner.gasceil |
uint64 | 0 |
block gas limit this miner targets (0 = keep the genesis gas limit) |
--miner.certificate-hold |
duration | ethash.CertificateHoldDuration |
local policy: max wait after a finality checkpoint for its certificate before sealing (0 = off) |
pqwerai-core genesis flags (network creation)¶
| Flag | Type | Default | Description |
|---|---|---|---|
--helper |
string | — | GhostRider hash helper path |
--helper-sha256 |
string | — | GhostRider hash helper SHA-256 |
--difficulty |
uint64 | 16 |
fixed private-testnet base difficulty |
--out |
string | genesis.json |
output file |
--alloc |
string | — | comma separated 0xADDRESS=PQAI whole-coin test allocations |
--validators |
string | — | JSON validator list; enables the private registry + FFG finality profile |
--founder |
string | — | public founder address receiving 1% of new issuance (79.2/19.8/1); registry profile only |
--timestamp |
uint64 | uint64(time.Now().Unix()-3600) |
genesis timestamp |
--chain-id |
uint64 | ethash.DevFixtureChainID |
private testnet chain ID (1337 disposable fixture, 77240 testnet-rc1) |
--gas-limit |
uint64 | 15000000 |
genesis block gas limit |
pqwerai-cli global flags¶
| Flag | Type | Default | Description |
|---|---|---|---|
-rpc |
string | http://127.0.0.1:8545 (env PQWERAI_RPC) |
node JSON-RPC URL |
-token-file |
string | env PQWERAI_RPC_TOKEN_FILE |
RPC bearer token file |
-keystore |
string | pqwerai-keystore (env PQWERAI_KEYSTORE) |
keystore directory |
-password-file |
string | env PQWERAI_PASSWORD_FILE |
password file (else first stdin line) |
-backup-password-file |
string | env PQWERAI_BACKUP_PASSWORD_FILE |
backup passphrase file (encrypted backups) |
-timeout |
duration | 60s |
operation timeout |
pqwerai-cli commands¶
backup balance call deploy erc20-balance erc20-transfer erc721-owner erc721-transfer history import-key list new nonce read restore send sn-claim sn-delegate sn-exit sn-keygen sn-register sn-rotate sn-slash sn-status sn-topup sn-undelegate sn-validators sn-withdraw status tx verify-backup
Transaction and Smartnode commands accept:
| Flag | Description |
|---|---|
-from |
sender |
-to |
recipient / contract |
-amount |
PQAI (or token units for erc20) |
-code |
contract creation bytecode hex file |
-data |
calldata hex |
-token |
token contract |
-id |
token id or validator id |
-keyfile |
BFT key file |
-vote-a |
signed vote hex (sn-slash) |
-vote-b |
signed vote hex (sn-slash) |
-stake |
stake in PQAI |
-owner |
owner |
-encrypt |
seal the whole backup with the backup passphrase |
-out |
output key file |
Secrets
Pass passwords with -password-file (mode 0600) or stdin, never as arguments. Keep mining payout keys and validator keys off shared servers.
Sources at 72057fe3ec: core/source/cmd/pqwerai-core/main.go · core/source/cmd/pqwerai-cli/main.go
Found a problem? Report a documentation issue · Build testnet-rc1+72057fe3ec