Passa al contenuto principale

Avvio rapido

Avvia un nodo QoreChain in pochi minuti. Scegli Docker Compose per la configurazione più rapida, oppure compila dal sorgente per il pieno controllo.


Docker Compose (consigliato)​

Il modo più semplice per eseguire un ambiente QoreChain completo con tutti i servizi preconfigurati.

git clone https://github.com/qorechain/qorechain-core.git
cd qorechain-core
cp .env.example .env
cp .env.sidecar.example .env.sidecar
# edit .env and set GRAFANA_PASSWORD (Compose refuses to start without it)
docker compose up -d

Prima del primo avvio, copia .env.example in .env e .env.sidecar.example in .env.sidecar (come sopra) e imposta GRAFANA_PASSWORD.

Questo avvia i seguenti servizi:

ServizioPorteDescrizione
qorechain-node26657 (RPC), 1317 (REST), 9090 (gRPC), 8545 / 8546 (EVM)Nodo blockchain completo con supporto multi-VM
ai-sidecar50051Motore QCAI di rilevamento anomalie e punteggio di rischio
indexer--Indicizzatore di blocchi per query storiche
postgres5432Backend di database per l'indicizzatore
prometheus9091Raccolta delle metriche
grafana3001Dashboard di monitoraggio

Una volta che tutti i container sono integri, hai una chain di sviluppo locale a nodo singolo (inizializza un proprio genesis; non si unisce alla mainnet né alla testnet). Per unirti a una rete attiva, segui le pagine Connessione alla mainnet o Connessione alla testnet.


Compilazione dal sorgente​

Prerequisiti​

  • Go 1.26+ con CGO abilitato
  • Toolchain Rust (per la compilazione della crittografia PQC e delle librerie del runtime SVM)
  • Git

Compilazione del binario​

CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/
La compilazione dal sorgente è pensata per lo sviluppo locale

L'albero dei sorgenti pubblico compila il binario della community. Dispone dell'intero set di comandi ma non del firmatario post-quantistico: tx pqc gen-key e tx pqc cosign restituiscono un errore (« requires the full build »), quindi non può creare transazioni per una rete che richiede firme ibride, e i suoi keeper stub non riproducono lo stato di consenso delle reti. Per unirti alla mainnet o alla testnet, o per effettuare transazioni su di esse, installa il binario di release indicato in latest.json su download.qore.host.

Inizializzazione del nodo​

./qorechaind init my-node --chain-id qorechain-diana

Questo crea le directory di configurazione e dati predefinite in ~/.qorechaind/. Avviato da solo, il nodo forma una chain locale a nodo singolo; per unirti a una rete attiva segui le pagine di connessione.

Avvio del nodo​

./qorechaind start

Il nodo si avvia con le impostazioni predefinite. Vedi Connessione alla testnet per unirti alla rete attiva con una corretta configurazione di genesis e peer.

nota

Gli esempi in questa pagina sono rivolti alla testnet qorechain-diana (EVM chain ID 9800). La mainnet (qorechain-vladi, EVM chain ID 9801) è attiva dal 7 giugno 2026 (release v3.2.7 dal 12 novembre 2026; la testnet esegue la v3.2.8 dal 12 novembre 2026) e ha una propria pagina dedicata Connessione alla mainnet.


Verifica dell'installazione​

Conferma che il tuo nodo sia in esecuzione correttamente:

# Check that the binary runs
./qorechaind --help
# Query the node status via RPC
curl localhost:26657/status

Una risposta corretta include il moniker del nodo, la network (qorechain-diana per la chain di sviluppo locale creata sopra, oppure la chain a cui ti sei unito) e l'altezza attuale del blocco.


Prossimi passi​