Getting Started¶
Every journey below is a sequence of shell scripts stored in developers/examples/. The pages include those files
verbatim, and scripts/devhub/run_examples.sh executes the same files against a disposable local PQWERAI testnet
(chain 77240) before each documentation release. The latest results are in Source provenance.
| Journey | You will | Time | Status |
|---|---|---|---|
| Blockchain quickstart | Check the chain ID, read a block, create an account, send PQAI, wait for BFT finality | 10 min | Tested |
| First smart contract | Compile, deploy, verify and call a Solidity contract with Foundry | 10 min | Tested |
| Create a token | Deploy an OpenZeppelin ERC-20 (Wallet Studio or Foundry) | 10 min | Tested |
| Create NFTs | ERC-721 and ERC-1155: metadata, minting, transfers | 15 min | Tested |
| Become a miner | Run GhostRider mining and read confirmed rewards | 20 min | Rewards check tested; node setup is the operator guide |
| Set up a Smartnode | Keys, registration, staking, delegation, voting and custody | 30 min | Key generation and registry reads tested |
| AI provider quickstart | MeshLLM boundary, opt-in policy, usage records, settlement | 30 min | Experimental, not a public service |
| Build an AI payment application | Quote, fund, propose, accept, finalize, withdraw and refund on ServiceEscrow |
20 min | Tested |
Before you start¶
Private testnet
PQWERAI is a private testnet. There is no public RPC endpoint and no public faucet yet, test PQAI has no value and mainnet does not exist. You need either your own node (see Install a node or the Windows Wallet's Node page) or an endpoint and test funds from the network operator.
Tools used by the journeys:
| Tool | Version tested | Notes |
|---|---|---|
PQWERAI Core (pqwerai-core, pqwerai-cli) |
testnet-rc1 build | Linux x86-64; Windows through WSL2 |
Foundry (forge, cast) |
1.8.5 | foundry.paradigm.xyz |
| solc | 0.8.26 | Pinned; forge downloads it when solc_version = "0.8.26" is set |
| Python | 3.9+ | Standard library only in the examples |
| curl, openssl | any |
Every journey starts by loading the same environment file:
# Shared settings for every PQWERAI tutorial: source this file first (". ./env.sh").
# PQWERAI_RPC defaults to a node on this machine; the Core binds JSON-RPC to 127.0.0.1:8545.
export RPC="${PQWERAI_RPC:-http://127.0.0.1:8545}"
export CHAIN_ID=77240 # 0x12db8, private testnet testnet-rc1
export ETH_RPC_URL="$RPC" # read by Foundry (cast/forge)
# Tutorial account created in quickstart/create-account.sh (encrypted keystore; never commit it).
export KEYSTORE="${KEYSTORE:-$PWD/keystore/dev}"
export PASSWORD_FILE="${PASSWORD_FILE:-$PWD/keystore/dev.password}"
Sources at 72057fe3ec: scripts/devhub/run_examples.sh
Found a problem? Report a documentation issue · Build testnet-rc1+72057fe3ec