# PQWERAI Developers > Build on the PQWERAI private testnet — JSON-RPC, smart contracts, GhostRider mining, Smartnodes, AI services and explorer APIs. Network: PQWERAI private testnet, chain ID 77240. No real funds. Mainnet is not available. Build testnet-rc1+72057fe3ec. Only public, read-only interfaces are documented for applications; operator and validator interfaces are marked. ## AI Network and MeshLLM - [AI Network and MeshLLM](https://docs.pqwerai.com/testnet-rc1/ai/): PQWERAI AI services — MeshLLM inference outside consensus, provider opt-in, signed quotes and PQAI escrow settlement. Experimental, local only. - [MeshLLM runtime integration](https://docs.pqwerai.com/testnet-rc1/ai/meshllm-runtime/): How PQWERAI providers run upstream MeshLLM — pinned versions, supervision, loopback-only API, resource admission and what remains untested. - [AI service revenue policy](https://docs.pqwerai.com/testnet-rc1/ai/revenue-policy/): Revenue policy v3 for PQWERAI AI services — inference only, provider receives the remainder, no founder or training share; history of v1 and v2. - [ServiceEscrow contract reference](https://docs.pqwerai.com/testnet-rc1/ai/service-escrow/): ServiceEscrow (revenue policy v3) interface reference — quote structure and signing, states, functions, events, windows and revert reasons. ## Blockchain and EVM - [Blockchain and EVM](https://docs.pqwerai.com/testnet-rc1/blockchain/): How the PQWERAI chain works for developers — GhostRider PoW blocks, Ethereum-compatible EVM, EIP-1559 fees and Smartnode BFT finality. - [EVM compatibility](https://docs.pqwerai.com/testnet-rc1/blockchain/evm-compatibility/): Which EVM opcodes, EIPs and compiler targets work on PQWERAI chain 77240 — measured on a live node, including the unsupported blob opcodes. - [Finality for applications](https://docs.pqwerai.com/testnet-rc1/blockchain/finality/): How to decide when a PQWERAI transaction is irreversible — inclusion, confirmations and BFT checkpoint finality via g4_status. - [Network parameters](https://docs.pqwerai.com/testnet-rc1/blockchain/network-parameters/): Chain ID, GhostRider, issuance, EVM, finality, Smartnode and RPC parameters of the PQWERAI private testnet. - [Transactions and fees](https://docs.pqwerai.com/testnet-rc1/blockchain/transactions-and-fees/): Transaction types, chain-ID replay protection, EIP-1559 base fee burn and priority fee, gas estimation and fee rules on PQWERAI. ## Smart Contracts and Tokens - [Smart Contracts and Tokens](https://docs.pqwerai.com/testnet-rc1/contracts/): Write PQWERAI smart contracts in Solidity, Vyper, Yul, Huff or Fe; deploy standard tokens; verify deployed bytecode. - [Application languages (JavaScript, TypeScript, Python)](https://docs.pqwerai.com/testnet-rc1/contracts/application-languages/): JavaScript, TypeScript and Python are application languages on PQWERAI — they build transactions and read state; they do not execute on chain. - [Access control and ownership](https://docs.pqwerai.com/testnet-rc1/contracts/guides/access-control/): Ownable, two-step ownership transfer and role-based access control with OpenZeppelin 5.0.2 on PQWERAI, with tested revert behaviour. - [ERC-1155 multi-tokens](https://docs.pqwerai.com/testnet-rc1/contracts/guides/erc1155/): ERC-1155 on PQWERAI — one contract for many token types, the {id} URI template, batch operations and current tooling limits. - [ERC-20 tokens](https://docs.pqwerai.com/testnet-rc1/contracts/guides/erc20/): ERC-20 on PQWERAI — interface, decimals, OpenZeppelin 5.0.2 implementation, events, allowances and wallet/explorer support. - [ERC-721 NFTs](https://docs.pqwerai.com/testnet-rc1/contracts/guides/erc721/): ERC-721 on PQWERAI — OpenZeppelin implementation, metadata URIs, safe transfers, wallet and explorer support. - [Contract events](https://docs.pqwerai.com/testnet-rc1/contracts/guides/events/): Declaring, emitting, indexing and reading contract events on PQWERAI, including the bounded eth_getLogs range. - [Solidity library compatibility](https://docs.pqwerai.com/testnet-rc1/contracts/guides/libraries/): Using internal and external Solidity libraries and OpenZeppelin on PQWERAI — linking, versions and EVM-target compatibility. - [Payable functions](https://docs.pqwerai.com/testnet-rc1/contracts/guides/payable/): Receiving native PQAI in contracts on PQWERAI — payable functions, receive/fallback, pull payments and reentrancy safety. - [Language center](https://docs.pqwerai.com/testnet-rc1/contracts/languages/): The same Counter contract in Solidity, Vyper, Yul, Huff and Fe — compiled with pinned toolchains, deployed on chain 77240, with measured runtime size and gas. - [Fe on PQWERAI (experimental)](https://docs.pqwerai.com/testnet-rc1/contracts/languages/fe/): Fe 26.5.1 on PQWERAI — experimental language status, build, ABI output and deployment of a counter; not for value-bearing contracts. - [Huff on PQWERAI](https://docs.pqwerai.com/testnet-rc1/contracts/languages/huff/): Huff Neo hnc 1.7.1 on PQWERAI — opcode-level contracts, ABI from - [Solidity on PQWERAI](https://docs.pqwerai.com/testnet-rc1/contracts/languages/solidity/): Pinned solc 0.8.26 setup, EVM target, Foundry project layout, compile, deploy, ABI, gas, verification and security caveats for Solidity on PQWERAI. - [Vyper on PQWERAI](https://docs.pqwerai.com/testnet-rc1/contracts/languages/vyper/): Pinned Vyper 0.4.3 setup, EVM target, compile, ABI, deploy, gas and security caveats on the PQWERAI testnet. - [Yul on PQWERAI](https://docs.pqwerai.com/testnet-rc1/contracts/languages/yul/): Standalone Yul compiled with solc 0.8.26 strict-assembly mode — manual ABI, deployment and caveats on PQWERAI. - [Contract verification](https://docs.pqwerai.com/testnet-rc1/contracts/verification/): Verify a deployed PQWERAI contract by reproducing its runtime bytecode byte for byte, masking immutables; current explorer limits. ## Explorer and Analytics APIs - [Explorer and Analytics APIs](https://docs.pqwerai.com/testnet-rc1/explorer/): The PQWERAI explorer — reorganisation-safe indexer reconciled with Core, read-only REST API v1, OpenAPI schema and Postman collection. - [Explorer REST API reference](https://docs.pqwerai.com/testnet-rc1/explorer/reference/): Every endpoint of the PQWERAI explorer JSON API, generated from its contract-tested OpenAPI 3.1 schema. - [Explorer data semantics](https://docs.pqwerai.com/testnet-rc1/explorer/semantics/): Canonical chain identity, freshness, reorganisation handling, finality alarms, pagination windows, size limits and error format of the PQWERAI explorer API. ## Getting Started - [Getting Started](https://docs.pqwerai.com/testnet-rc1/getting-started/): Developer journeys for the PQWERAI private testnet, each executed end to end against a real node before publication. - [Build an AI payment application](https://docs.pqwerai.com/testnet-rc1/getting-started/ai-payment-app/): Integrate the PQWERAI ServiceEscrow contract — signed provider quotes, funding, usage proposals, acceptance, settlement, withdrawals and refunds — tested end to end. - [AI provider quickstart](https://docs.pqwerai.com/testnet-rc1/getting-started/ai-provider/): How AI providers integrate the MeshLLM runtime with PQWERAI — opt-in policy, local inference, signed usage records and PQAI escrow settlement. Experimental. - [Become a miner](https://docs.pqwerai.com/testnet-rc1/getting-started/become-a-miner/): Configure a GhostRider CPU miner on a PQWERAI node, connect it to the private testnet and inspect confirmed rewards and issuance counters. - [Blockchain quickstart](https://docs.pqwerai.com/testnet-rc1/getting-started/blockchain-quickstart/): Connect to a PQWERAI node, verify chain ID 77240, inspect a block, create an account, send test PQAI and wait for BFT finality. - [Create NFTs](https://docs.pqwerai.com/testnet-rc1/getting-started/create-nfts/): Create ERC-721 and ERC-1155 collections on PQWERAI — metadata, minting and transfers, tested with OpenZeppelin 5.0.2. - [Create a token](https://docs.pqwerai.com/testnet-rc1/getting-started/create-token/): Deploy an ERC-20 token on PQWERAI with the Windows Wallet Studio (no code) or with Foundry and OpenZeppelin Contracts 5.0.2. - [First smart contract](https://docs.pqwerai.com/testnet-rc1/getting-started/first-smart-contract/): Write, compile, deploy, verify and interact with a Solidity contract on the PQWERAI testnet using Foundry and the pinned solc 0.8.26. - [Set up a Smartnode](https://docs.pqwerai.com/testnet-rc1/getting-started/smartnode/): Smartnode validator registration, key custody, staking, delegation, voting, finality and exit on the PQWERAI testnet. ## GhostRider Mining - [GhostRider Mining](https://docs.pqwerai.com/testnet-rc1/mining/): GhostRider CPU proof of work on PQWERAI — the pinned helper, adaptive difficulty, fork choice and how mining relates to finality and AI. - [Rewards and issuance](https://docs.pqwerai.com/testnet-rc1/mining/rewards-and-issuance/): PQWERAI issuance split (79.2% PoW, 19.8% PoS, 1% founder), fee burn and the exact on-chain counters exposed by g4_status and the explorer. ## Node Operations and Infrastructure - [Node Operations and Infrastructure](https://docs.pqwerai.com/testnet-rc1/nodes/): Run PQWERAI nodes — requirements, installation, configuration, firewall, safe RPC exposure, monitoring, backup, upgrade and rollback. - [Install a node](https://docs.pqwerai.com/testnet-rc1/nodes/install/): Install a PQWERAI testnet-rc1 node on Ubuntu — requirements, verified download, install script, core.env configuration, firewall, start and health check. - [Monitoring, backup and upgrades](https://docs.pqwerai.com/testnet-rc1/nodes/operations/): Prometheus exporter and alert rules, backup and restore, release install, activation and rollback for PQWERAI nodes. - [RPC exposure and security](https://docs.pqwerai.com/testnet-rc1/nodes/rpc-security/): How to expose PQWERAI JSON-RPC safely — loopback default, bearer tokens, TLS proxy limits, never-exposed namespaces and operator-only methods. ## Playground - [API playground](https://docs.pqwerai.com/testnet-rc1/playground/): Build, validate and inspect read-only PQWERAI JSON-RPC requests; view recorded responses or send to your own node. No keys, tokens or write methods. ## API reference - [JSON-RPC reference](https://docs.pqwerai.com/testnet-rc1/reference/json-rpc/): Every JSON-RPC method served by PQWERAI Core, verified against source and a live node. - [JSON-RPC errors and limits](https://docs.pqwerai.com/testnet-rc1/reference/json-rpc/errors/): JSON-RPC error codes, transport limits and real error responses from PQWERAI Core. - [JSON-RPC: eth namespace](https://docs.pqwerai.com/testnet-rc1/reference/json-rpc/eth/): Ethereum-compatible chain, account, transaction, fee, call and log methods served by PQWERAI Core. - [JSON-RPC: g4 namespace (finality)](https://docs.pqwerai.com/testnet-rc1/reference/json-rpc/g4/): PQWERAI BFT finality, Smartnode registry and exact issuance accounting. - [JSON-RPC: net namespace](https://docs.pqwerai.com/testnet-rc1/reference/json-rpc/net/): Network identity and peer count. - [Operator JSON-RPC interfaces](https://docs.pqwerai.com/testnet-rc1/reference/json-rpc/operator/): Privileged, unsupported and disabled JSON-RPC methods of PQWERAI Core, with warnings. - [JSON-RPC: txpool namespace](https://docs.pqwerai.com/testnet-rc1/reference/json-rpc/txpool/): Transaction-pool inspection (node-local view of pending and queued transactions). - [JSON-RPC: web3 namespace](https://docs.pqwerai.com/testnet-rc1/reference/json-rpc/web3/): Client version and Keccak-256 helper. ## Protocol Research and Specifications - [Protocol Research and Specifications](https://docs.pqwerai.com/testnet-rc1/research/): Where PQWERAI's specifications, historical design plans and research tracks live, and how they differ from tested product documentation. ## Resources - [Resources](https://docs.pqwerai.com/testnet-rc1/resources/): Changelog, compatibility matrix, documentation versions, machine-readable downloads, provenance and known gaps for the PQWERAI Developer Hub. - [AI-friendly resources](https://docs.pqwerai.com/testnet-rc1/resources/ai-resources/): Machine-readable PQWERAI developer resources — llms.txt, llms-full.txt, OpenRPC, OpenAPI, Postman and the method inventory — with the same classification as the human docs. - [Changelog](https://docs.pqwerai.com/testnet-rc1/resources/changelog/): Changes to PQWERAI APIs, tooling, contract toolchains and protocol relevant to developers, newest first. - [Compatibility matrix](https://docs.pqwerai.com/testnet-rc1/resources/compatibility/): PQWERAI Wallet, Core, explorer API, compilers and tools tested together for testnet-rc1, with exact versions and hashes. - [Known gaps and limitations](https://docs.pqwerai.com/testnet-rc1/resources/gaps/): What the PQWERAI developer platform does not provide yet — public endpoints, faucet, explorer features, SDKs, AI network and audits. - [Source provenance](https://docs.pqwerai.com/testnet-rc1/resources/provenance/): How the PQWERAI Developer Hub is built from an allowlisted source manifest, which checks gate publication, and the latest test results. - [Documentation versions](https://docs.pqwerai.com/testnet-rc1/resources/versions/): Which PQWERAI documentation versions exist, what each covers, and the rules for experimental and future mainnet documentation. ## Smartnodes and Finality - [Smartnodes and Finality](https://docs.pqwerai.com/testnet-rc1/smartnodes/): PQWERAI Smartnodes — stake-backed validators that finalize 32-block checkpoints; registry, delegation, slashing and finality guarantees. - [BFT finality](https://docs.pqwerai.com/testnet-rc1/smartnodes/finality/): How PQWERAI checkpoint finality works — epochs, vote contexts, signed votes, certificates, equivocation evidence, signer safety and liveness. - [Smartnode registry operations](https://docs.pqwerai.com/testnet-rc1/smartnodes/registry-operations/): The nine Smartnode registry operations, their parameters, gas, timing rules and the pqwerai-cli and Windows Wallet commands that send them. ## Wallets and SDKs - [Wallets and SDKs](https://docs.pqwerai.com/testnet-rc1/tools/): Searchable catalog of PQWERAI wallets, CLIs and Ethereum developer tools, with what is official, what was tested and how to configure chain 77240. - [Core CLI and flags](https://docs.pqwerai.com/testnet-rc1/tools/core-cli/): pqwerai-core node flags, genesis flags, pqwerai-cli global flags and commands, extracted from source. - [ethers.js](https://docs.pqwerai.com/testnet-rc1/tools/ethers/): ethers.js v6 against the PQWERAI testnet — provider, chain check, balances, sending, contracts and finality. Example not executed for this release. - [Foundry](https://docs.pqwerai.com/testnet-rc1/tools/foundry/): Configure Foundry (forge, cast) 1.8.5 for the PQWERAI testnet — pinned solc, EVM target, keystores, deploy and RPC calls. Every tutorial is tested with it. - [Hardhat](https://docs.pqwerai.com/testnet-rc1/tools/hardhat/): Hardhat network configuration for the PQWERAI testnet (chain 77240, cancun target, keystore-safe accounts). Not executed for this release. - [Remix](https://docs.pqwerai.com/testnet-rc1/tools/remix/): Use the Remix browser IDE with a PQWERAI node — compiler settings and the limits of browser-to-node connections. Not executed for this release. - [viem](https://docs.pqwerai.com/testnet-rc1/tools/viem/): viem 2 chain definition and client setup for the PQWERAI testnet, with finality handling. Example not executed for this release. - [web3.py](https://docs.pqwerai.com/testnet-rc1/tools/web3py/): web3.py 7 with the PQWERAI testnet — connection, chain check, keystore signing, contracts and g4_status finality. Example not executed for this release. - [PQWERAI Windows Wallet](https://docs.pqwerai.com/testnet-rc1/tools/windows-wallet/): PQWERAI Windows wallet — latest 0.7.3 development features, tested baseline, local models, Contract Studio and opt-in AI sharing. ## Machine-readable - [JSON-RPC method inventory](https://docs.pqwerai.com/testnet-rc1/downloads/rpc-methods.json) - [OpenRPC document](https://docs.pqwerai.com/testnet-rc1/downloads/pqwerai-openrpc.json) - [Explorer OpenAPI](https://docs.pqwerai.com/testnet-rc1/downloads/explorer-openapi.yaml) - [Postman collection](https://docs.pqwerai.com/testnet-rc1/downloads/pqwerai-postman-collection.json)