00-environment-setup.md

00 — Environment Setup

Get a working Quantova development environment before anything else. [testnet] items apply today; mainnet is a configuration change later.

Toolchain

• Install Node.js 18+ and/or Python 3.10+ for the @quantova SDK.
• Install the @quantova SDK packages (@quantova/api, @quantova/keyring, @quantova/util-crypto).
• Install Qdock.io (IDE) if compiling and deploying QVM contracts.
• Install Qmask.io (post-quantum wallet, browser extension) for interactive signing.
• For node work: install Rust (rustup) and the build dependencies (clang, cmake, protobuf, libssl).

Network access [testnet]

• Point the SDK at the testnet endpoints:
  • WebSocket: wss://testnet.quantova.io
  • HTTP JSON-RPC: https://testnet.quantova.io
• Claim TQTOV from the testnet faucet (no monetary value; for development only).
• Confirm connectivity with a read call (q_blockNumber) and verify a non-zero height.

Local dev node (optional)

• Run a local dev node: ./target/release/quantova-node --dev --ws-external.
• Point the SDK at ws://127.0.0.1:9944 / http://127.0.0.1:9933.

Project hygiene

• Pin SDK and tool versions in your manifest (no floating latest).
• Add a .env for endpoints and never commit private keys or seed phrases.
• Configure linting and formatting for your contract and app code.

Mainnet switch (later) [mainnet]

• The only change from testnet should be the RPC endpoint and chain id — the Q-address scheme and SDK are identical. Confirm nothing else is hardcoded to testnet.