connecting to testnet

Join the live QoreChain Diana testnet by configuring your node with the correct genesis file, peers, and network settings.

---

Download Genesis

Replace your local genesis file with the official testnet genesis:

curl -o ~/.qorechaind/config/genesis.json \
  https://raw.githubusercontent.com/qorechain/qorechain-core/main/config/genesis.json

This file defines the initial state of the Diana testnet, including the validator set, token allocations, and module parameters.

---

Configure Peers

Edit your node configuration to connect to existing testnet peers.

Open ~/.qorechaind/config/config.toml and set the persistent_peers field:

persistent_peers = "[email protected]:26656,[email protected]:26656"

Refer to the QoreChain repository for the latest peer list.

Recommended Settings

You may also want to adjust the following in config.toml:

[mempool]
size = 5000

[consensus]
timeout_propose = "3s"
timeout_commit = "5s"

These values are tuned for the Diana testnet's block times and throughput.

---

Start Node

Launch your node to begin syncing with the network:

./qorechaind start

The node connects to peers and begins downloading blocks from genesis. Initial sync time depends on the current chain height and your network speed.

---

Check Sync Status

Verify that your node is catching up to the latest block:

curl localhost:26657/status | jq '.result.sync_info.catching_up'

• true -- The node is still syncing. Wait for it to catch up.

• false -- The node is fully synced and processing new blocks.

You can also check the latest block height:

curl localhost:26657/status | jq '.result.sync_info.latest_block_height'

---

Monitoring

QoreChain exposes several endpoints for monitoring node health and performance.

Prometheus Metrics

Raw metrics are available at:

http://localhost:26660/metrics

These metrics can be scraped by any Prometheus-compatible collector.

Grafana Dashboards

If running via Docker Compose, Grafana is available at:

http://localhost:3001

Default credentials: admin / admin. Pre-configured dashboards display block production, transaction throughput, peer connections, and resource usage.

REST Health Check

The REST API provides a quick status endpoint:

http://localhost:1317

---

Ports Reference

Port	Protocol	Description
26657	TCP	RPC -- query and broadcast transactions
26656	TCP	P2P -- peer-to-peer network communication
1317	HTTP	REST API -- query chain state via HTTP
9090	gRPC	gRPC API -- programmatic chain access
8545	HTTP	EVM JSON-RPC -- Ethereum-compatible RPC
8546	WebSocket	EVM WebSocket -- real-time EVM event subscriptions
8899	HTTP	SVM RPC -- Solana-compatible RPC
26660	HTTP	Prometheus metrics endpoint

---

Next Steps

• Wallet Setup -- Configure a wallet for the testnet

• Your First Transaction -- Send your first QOR transfer