getting-started.md

Getting Started

This guide takes you from nothing to reading the chain and sending your first post-quantum-signed transaction with the Quantova tools.

1. Pick a client

Quantova has two official clients with the same surface:

# JavaScript / TypeScript
npm install qweb3.js

# Python
pip install qweb3

2. Choose an endpoint

Point the client at a network (full list and details in the chain-specs tool):

Environment	WebSocket	HTTP JSON-RPC
Mainnet	wss://mainnet.quantova.io	https://mainnet.quantova.io
Testnet	wss://testnet.quantova.io	https://testnet.quantova.io
Local dev	ws://127.0.0.1:9944	http://127.0.0.1:9933

export QUANTOVA_RPC=https://testnet.quantova.io

3. Connect and read

# qweb3.py
from qweb3 import QWeb3
q = QWeb3("https://testnet.quantova.io")
print("block:", q.rpc.block_number())

// qweb3.js
const { QWeb3 } = require('qweb3.js');
const q = new QWeb3('https://testnet.quantova.io');
console.log('block:', await q.rpc.blockNumber());

Runnable versions: ../examples/python/connect.py and ../examples/javascript/connect.js.

4. Get a wallet and test funds

1. Install QMask from qmask.io and create a quantum-resistant account — its address begins with Q.
2. Claim free TQTOV for your address from the faucet at Qtox.io, on the Quantova Testnet.

5. Send your first transaction

A transfer is built, post-quantum-signed, and broadcast. The runnable examples show the full flow end to end:

• ../examples/python/transfer.py
• ../examples/javascript/transfer.js

Every Quantova transaction is signed with a NIST post-quantum scheme (Dilithium, Falcon, or SPHINCS+) and verified on-chain as a QSignature — there is no classical-key path.

6. Go further

• Contracts (QVM): deploy and call Solidity contracts — ../examples/python/contract_call.py.
• Names (QNS): resolve and register .qtov names — ../examples/python/qns_resolve.py.
• Verify your work: use the pq-test-vectors and node-conformance-tests tools.

See the full tools catalog, for developers, and for companies.