Gestire un Validatore

Questa guida spiega come creare un validatore sulla rete QoreChain, comprendere il sistema di classificazione a pool, registrare una chiave PQC per una sicurezza resistente ai computer quantistici e monitorare il proprio nodo.

nota

Questa guida si riferisce alla mainnet qorechain-vladi (EVM chain ID 9801), attiva dal 7 giugno 2026 con la versione di chain v3.1.95. La testnet qorechain-diana (EVM chain ID 9800) è consigliata per provare la configurazione prima di andare in produzione. Sostituisci il --chain-id appropriato per la rete di destinazione.

Prerequisiti

Un nodo qorechaind completamente sincronizzato (vedi Connessione alla Testnet)
Un account con fondi per almeno 100.000 QOR (100.000.000.000 uqor) per l'auto-delega iniziale — questo minimo è imposto on-chain e create-validator viene rifiutato se non raggiunto
Una licenza validator_operator attiva sul tuo account — vedi la nota sotto; senza di essa, create-validator fallisce con ErrUnauthorized indipendentemente da quanto QOR auto-vincoli
Familiarità con il modello di Staking e Delega

Creare un Validatore

Gate della licenza: `validator_operator`

create-validator è soggetto a due controlli indipendenti, entrambi applicati on-chain, ed entrambi sono necessari — un grande auto-bond da solo non basta:

Auto-bond minimo di 100.000 QOR.
Una licenza validator_operator attiva sull'account che invia la transazione.

Il campo expires_at di una licenza è un'altezza di blocco, non una data o una durata — 0 significa nessuna scadenza. Se mancante o scaduta, create-validator fallisce con ErrUnauthorized, indipendentemente da quanto auto-vincoli; questo è il motivo più comune per cui un tentativo ben finanziato fallisce senza apparente spiegazione. Questo gate esiste specificamente perché il lane di esecuzione EVM non può vederlo né applicarlo (un singolo decoratore ante lì lo aggirerebbe completamente) — è uno dei motivi per cui staking e validazione restano esclusivamente sul lane Nativo.

qorechaind tx staking create-validator \
  --amount 100000000000uqor \
  --pubkey $(qorechaind comet show-validator) \
  --moniker "my-validator" \
  --commission-rate 0.10 \
  --commission-max-rate 0.20 \
  --commission-max-change-rate 0.01 \
  --min-self-delegation 1 \
  --from mykey \
  --gas auto \
  --gas-adjustment 1.3 \
  -y

Parametro	Descrizione
`--amount`	Importo dell'auto-delega — minimo 100.000 QOR (`100000000000uqor`)
`--pubkey`	Chiave pubblica di consenso del validatore (ed25519)
`--moniker`	Nome leggibile del tuo validatore
`--commission-rate`	Tasso di commissione iniziale (es. 0.10 = 10%)
`--commission-max-rate`	Tasso di commissione massimo (immutabile dopo la creazione)
`--commission-max-change-rate`	Variazione massima giornaliera del tasso di commissione
`--min-self-delegation`	Token minimi che l'operatore deve auto-delegare

Dopo la conferma della transazione, verifica il tuo validatore:

qorechaind query staking validator $(qorechaind keys show mykey --bech val -a)

Classificazione a Pool

QoreChain utilizza un sistema di classificazione a tre pool gestito dal modulo x/qca (Quantum Consensus Allocation). Ogni 1,000 blocchi, i validatori vengono riclassificati in uno dei tre pool in base alla loro reputazione e al loro stake:

Pool	Criteri	Allocazione dei blocchi
RPoS (Proof-of-Stake basato sulla reputazione)	Reputazione >= 70° percentile E stake >= mediana	40% dei blocchi
DPoS (Proof-of-Stake delegato)	Delega totale >= 10,000 QOR	35% dei blocchi
PoS (Proof-of-Stake)	Tutti i restanti validatori attivi	25% dei blocchi

All'interno di ciascun pool, i proponenti dei blocchi vengono selezionati tramite selezione casuale ponderata proporzionale al loro stake effettivo. La classificazione garantisce che sia i validatori ad alta reputazione sia quelli con deleghe elevate ricevano una rappresentanza equa, pur consentendo ai validatori più piccoli di partecipare.

Interrogare la Propria Classificazione di Pool

qorechaind query qca pool-classification $(qorechaind keys show mykey --bech val -a)

Via JSON-RPC:

curl -X POST http://localhost:8545 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "qor_getPoolClassification",
    "params": ["qorvaloper1..."],
    "id": 1
  }'

Curva di Bonding

La ricompensa di staking di un validatore è determinata da una curva di bonding che incorpora più fattori:

R = beta * S * (1 + alpha * log(1 + L)) * Q(r) * P(t)

Variabile	Descrizione
`R`	Importo della ricompensa
`beta`	Tasso di ricompensa base
`S`	Stake effettivo
`alpha`	Costante di scala della fedeltà
`L`	Durata della fedeltà (tempo di staking continuo)
`Q(r)`	Fattore di qualità della reputazione, intervallo [0.75 - 1.25]
`P(t)`	Moltiplicatore di fase del protocollo (si adegua lungo il ciclo di vita della rete)

Punti chiave:

Bonus per durata della fedeltà: i validatori che mantengono lo staking in modo continuativo ricevono ricompense crescenti grazie al termine logaritmico di fedeltà. Questo incentiva l'impegno a lungo termine.
Fattore di qualità della reputazione: varia da 0.75 (reputazione scarsa) a 1.25 (reputazione eccellente). La reputazione è calcolata a partire da uptime, proposte andate a buon fine, partecipazione alla community e qualità della validazione delle transazioni.
Moltiplicatore di fase del protocollo: si adegua man mano che la rete matura attraverso le diverse fasi (bootstrap, crescita, maturità).

Slashing

Le sanzioni base per infrazione, interrogabili in tempo reale e aggiornate al momento della stesura:

qorechaind query slashing params

Parametro	Valore
Finestra dei blocchi firmati	10,000 blocchi (circa 6 ore per accumularsi)
Minimo firmato per finestra	95% (sotto questa soglia si viene jailed)
Durata del jail per downtime	600 secondi (10 minuti)
Frazione di slashing per downtime	1% dello stake
Frazione di slashing per doppia firma	5% dello stake

Il jailing è un timeout fisso di 10 minuti con una sanzione fissa: è distinto dal modello progressivo descritto sotto, che sovrappone conseguenze aggiuntive e crescenti alle infrazioni ripetute su un orizzonte temporale più lungo.

Slashing Progressivo

QoreChain utilizza un modello di slashing progressivo che inasprisce le sanzioni per i recidivi, consentendo al contempo ai validatori di recuperare nel tempo:

penalty = base_rate * escalation^effective_count * severity

Parametro	Valore
Sanzione massima per evento	33% dello stake
Emivita del decadimento	100,000 blocchi
Gravità del downtime	1.0
Gravità della doppia firma	2.0
Gravità dell'attacco al light client	3.0

Ogni infrazione incrementa il conteggio effettivo. Ogni infrazione (downtime, doppia firma, ecc.) aumenta il conteggio effettivo del validatore, che influisce sulle sanzioni future.
La sanzione cresce in modo esponenziale. La sanzione cresce in base al conteggio effettivo secondo la formula sopra riportata, quindi i recidivi subiscono sanzioni molto più pesanti.
Il conteggio effettivo decade nel tempo. Il conteggio effettivo decade con un'emivita di 100,000 blocchi (~7 giorni con blocchi da 6s), consentendo ai validatori di recuperare dopo un periodo di buona condotta.
Eventi singoli vs infrazioni ripetute. Un singolo evento accidentale di downtime comporta una sanzione lieve, mentre le infrazioni ripetute innescano conseguenze che crescono in modo esponenziale.

Registrazione della Chiave PQC

Registra la tua chiave pubblica crittografica post-quantistica (PQC) — ML-DSA-87 — prima di richiedere una licenza da validatore o di eseguire create-validator. Questo passaggio non è opzionale né automatico: la chain richiede una firma ibrida PQC su ogni transazione sul percorso cosmos, MsgCreateValidator non è uno dei tipi di messaggio esentati e — a differenza di un account normale, che registra la propria chiave automaticamente alla prima transazione — un validatore deve eseguire questo comando da sé, sul proprio nodo, in anticipo.

qorechaind tx pqc register-key <pubkey-hex> hybrid \
  --from mykey \
  --gas 600000 \
  -y

Parametro	Descrizione
`<pubkey-hex>`	Chiave pubblica ML-DSA-87 di 2592 byte in codifica esadecimale
`hybrid`	Modalità di registrazione (hybrid = sia classica che PQC)

Imposta --gas esplicitamente

La chiave pubblica ML-DSA-87 è di 2.592 byte, e scriverla on-chain supera il limite di gas predefinito di 200.000. Senza --gas 600000 (o superiore), la transazione fallisce con un oscuro errore out of gas in location: WritePerByte.

Verifica la registrazione:

qorechaind query pqc key <account-address>

Monitoraggio

Metriche Prometheus

QoreChain espone le metriche Prometheus sulla porta 26660:

http://localhost:26660/metrics

Metriche chiave da monitorare:

Metrica	Descrizione
`qorechain_missed_blocks_total`	Totale dei blocchi mancati dal tuo validatore
`qorechain_validator_uptime`	Percentuale di uptime sugli ultimi N blocchi
`qorechain_reputation_score`	Punteggio di reputazione attuale
`qorechain_pool_classification`	Assegnazione attuale al pool (0=PoS, 1=DPoS, 2=RPoS)
`qorechain_consecutive_signed`	Blocchi firmati consecutivi
`consensus_height`	Altezza del blocco attuale
`consensus_rounds`	Round di consenso per l'altezza attuale

Interrogare il Punteggio di Reputazione

qorechaind query reputation score $(qorechaind keys show mykey --bech val -a)

Via JSON-RPC:

curl -X POST http://localhost:8545 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "qor_getReputationScore",
    "params": ["qorvaloper1..."],
    "id": 1
  }'

Controlli di Integrità

# Node status
qorechaind status | jq '.sync_info'

# Validator signing info (uptime, missed blocks)
qorechaind query slashing signing-info $(qorechaind comet show-validator)

# Check if your validator is in the active set
qorechaind query staking validators --status bonded | grep "my-validator"

Buone Pratiche Operative

Usa un'architettura a nodi sentry. Esegui il tuo validatore dietro nodi sentry per proteggerlo dagli attacchi DDoS. Esponi alla rete pubblica solo i nodi sentry.
Configura gli avvisi. Imposta avvisi per blocchi mancati, uptime basso e riavvii imprevisti. Qualche blocco mancato è normale; mancanze prolungate innescheranno lo slashing.
Mantieni un uptime elevato. Il sistema di reputazione premia l'uptime costante. Un downtime prolungato degrada il tuo fattore di qualità della reputazione, riducendo le ricompense.
Mantieni il software aggiornato. Segui le release di QoreChain e applica gli aggiornamenti tempestivamente. Coordinati con la community dei validatori per gli upgrade della chain.
Metti al sicuro le tue chiavi. Usa un modulo di sicurezza hardware (HSM) o un remote signer per la chiave di consenso del validatore. Non conservare mai le chiavi sulla stessa macchina del nodo.
Registra una chiave PQC. Rendi il tuo validatore a prova di futuro contro le minacce quantistiche registrando una chiave ML-DSA-87.
Monitora il tuo pool. Tieni traccia della tua classificazione di pool ogni 1,000 blocchi. Migliorare la tua reputazione può farti passare da PoS a RPoS, aumentando in modo significativo le opportunità di proporre blocchi.

Riferimento dei Comandi per Validatori

# Edit validator metadata
qorechaind tx staking edit-validator \
  --moniker "new-name" \
  --website "https://myvalidator.com" \
  --details "Description of my validator" \
  --from mykey -y

# Unjail after downtime slashing
qorechaind tx slashing unjail --from mykey -y

# Delegate additional stake
qorechaind tx staking delegate $(qorechaind keys show mykey --bech val -a) \
  500000000uqor --from mykey -y

# Withdraw rewards
qorechaind tx distribution withdraw-rewards $(qorechaind keys show mykey --bech val -a) \
  --commission --from mykey -y

Validare le Reti Connesse

A partire dalla versione di chain v3.1.80, un validatore QoreChain può anche contribuire a validare le reti connesse tramite il bridge. Questa funzionalità è soggetta a licenza e opt-in:

Possedere la licenza. Il validatore deve possedere una licenza validator_<chain> (o qcb_bridge) attiva per la rete di destinazione. L'orchestratore si rifiuta di avviare un client esterno senza di essa (fail-closed).
L'attivazione effettua il provisioning automatico del client. Quando la licenza viene attivata, QoreChain effettua il provisioning del client della rete corrispondente sul tuo nodo — scaricando il client con versione bloccata, generandone la configurazione ed eseguendolo sotto l'orchestrazione di QoreChain. Nulla viene scaricato prima dell'attivazione.
Fornire le chiavi e lo stake della rete. Le chiavi di validazione/stake e di firma della rete esterna sono fornite dall'operatore per ciascuna rete; QoreChain fornisce il framework dei driver e il gate di licenza applicato, non il tuo stake sulla chain esterna.

Esistono driver per tutte le 37 reti del bridge, classificate in base a come un validatore può partecipare:

Classe	Partecipazione	Esempi
Validatore permissionless	Fai staking ed esegui il nodo	Solana, Ethereum, Avalanche, Sui, Aptos, Cardano, Tezos, Algorand, Starknet
Con tetto / elezione / ammissione	Staking, soggetto a un tetto o a un'elezione	BSC, Polygon, Polkadot, TRON, Sei, Injective, NEAR, Hedera
Full-node L2	Esegui un full node (senza staking)	Optimism, Base, zkSync Era, Linea, Scroll, Arbitrum
Senza staking / trust-list	Osserva / partecipa senza staking	Bitcoin, Filecoin, XRPL, Stellar

nota

I pin di versione dei client sono best-effort; verifica la release upstream del client per la tua rete di destinazione prima di un'attivazione in produzione.

Prossimi Passi

Compilare dal Sorgente — Compila il binario qorechaind
Sviluppo EVM — Distribuisci smart contract su QoreChain
Account Abstraction — Account programmabili per le tue operazioni da validatore

Prerequisiti​

Creare un Validatore​

Gate della licenza: validator_operator​

Classificazione a Pool​

Interrogare la Propria Classificazione di Pool​

Curva di Bonding​

Slashing​

Slashing Progressivo​

Registrazione della Chiave PQC​

Monitoraggio​

Metriche Prometheus​

Interrogare il Punteggio di Reputazione​

Controlli di Integrità​

Buone Pratiche Operative​

Riferimento dei Comandi per Validatori​

Validare le Reti Connesse​

Prossimi Passi​