Ana içeriğe geç

Düğüm Çalıştırma

Bu kılavuz, yalnızca düğüm olarak çalışan bir QoreChain dağıtımını kapsar — zinciri senkronize eden ve entegrasyon için uç noktalar sunan, ancak doğrulayıcı görevleri üstlenmeyen bir tam (full) veya RPC düğümü. Ağa güvenilir okuma/yazma erişimine ihtiyaç duyan ancak blok imzalamayan borsalara (CEX), cüzdan arka uçlarına, indeksleyicilere ve entegratörlere yöneliktir.

not

Blok üretimi, staking, slashing ve havuz sınıflandırması için bunun yerine Doğrulayıcı Çalıştırma sayfasına bakın. Yalnızca düğüm olarak yapılan bir dağıtım hiçbir zaman doğrulayıcı konsensüs anahtarı tutmaz ve aktif kümede asla görünmez.

uyarı

İkili dosyalar (binary), genesis ve anlık görüntüler (snapshot) SHA-256 sağlama toplamlarıyla birlikte download.qore.host adresinde yayınlanır. Kurmadan veya arşivi açmadan önce sağlama toplamlarını her zaman doğrulayın ve yatırılan tutarları (deposit) yalnızca kendi senkronize düğümünüze karşı doğrulayın.

Tek doğru kaynak: canlı manifesto

Güncel ikili dosya, genesis, eşler (peers), tohum düğümler (seeds) ve bir state-sync güven noktası, canlı olarak yenilenen bir JSON manifestosu olarak yayınlanır — kurulum betiklerinizde bir ikili dosya sürümünü, sağlama toplamını veya anlık görüntü dosya adını sabit kodlamayın, çünkü yeni bir sürüm çıkar çıkmaz bunlar güncelliğini yitirir:

  • Mainnet: https://download.qore.host/mainnet/latest.json
  • Testnet: https://download.qore.host/testnet/latest.json

Manifestonun alanları şunları içerir: binary (url + sha256), genesis (url + sha256 + sizeBytes), peers, seeds, p2pPort, stateSync (saatlik yenilenen bir güven noktası) ve minCompatible. Aşağıdaki kurulum ve katılım adımları bu manifestoyu alır ve güncel değerlerini kullanır.

Manifestonun adını verdiği sürümü kullanın: mainnet'te v3.2.7, testnet'te v3.2.8

Genesis'ten senkronize olan veya bir anlık görüntüden yeniden oynatma (replay) yapan bir düğüm, birkaç yönetişim (governance) yükseltmesinden geçer (aşağıdaki Yükseltmeler bölümüne bakın); bu nedenle her zaman manifestonun işaret ettiği ikili dosyayı kurun: bu dosya tüm yükseltme işleyicilerini (handler) taşır. Mainnet'te manifestodaki minCompatible ve version değerlerinin ikisi de 3.2.7'dir (12 Kasım 2026'da 4.164.600 yüksekliğinde uygulandı, yönetişim önerisi 16); bu nedenle şimdi katılan bir düğüm v3.2.7 gerektirir: daha eski bir ikili dosya, bilmediği bir yükseltme yüksekliğinde durur. Sürüm, qorechaind-v3.2.7-b3-linux-amd64.tar.gz paketidir (99.472.930 bayt, SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5, manifestodan 12 Kasım 2026'da okundu; asıl kaynak canlı manifestodur). Manifesto, yeni düğümlerin state sync ile katılmasını önerir. İçinde qorechaind ve libqorepqc.so, libqoresvm.so ile libwasmvm.x86_64.so (v3.2.8'den itibaren ayrıca libwasmvmqore_v1.x86_64.so) içeren lib/ bulunur. Tek tek dosyaları değil, lib/ dizininin tamamını kopyalayın. Hâlâ v3.2.6 üzerinde olan bir düğüm 4.164.600 yüksekliğinde UPGRADE "v3.2.7" NEEDED iletisiyle durdu: paketi kurun ve yeniden başlatın, durumu korunur. Başka bir mainnet yükseltmesi planlanmamıştır (current_plan değeri null'dır, 12 Kasım 2026'da kontrol edildi); manifesto daha yeni bir sürüm adlandırdığında kurulacak ikili dosya odur. Testnet'te manifestodaki minCompatible ve version değerlerinin ikisi de 3.2.8'dir (v3.2.5 26 Ekim 2026'da 8.890.800 yüksekliğinde, v3.2.6 27 Ekim'de 8.970.638 yüksekliğinde, v3.2.7 6 Kasım'da 9.594.600 yüksekliğinde ve v3.2.8 12 Kasım'da 9.929.500 yüksekliğinde uygulandı); bu nedenle testnet'e katılan bir düğüm v3.2.8 ikili dosyasına ihtiyaç duyar: paketin adını, boyutunu ve SHA-256'sını canlı testnet manifestosundan alın; asıl kaynak odur (7 Kasım 2026'da, v3.2.7 üzerindeyken, qorechaind-v3.2.7-b3-linux-amd64.tar.gz adını, 99.472.930 baytı ve SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5 değerini gösteriyordu). Hâlâ v3.2.7 üzerinde olan bir testnet düğümü 9.929.500 yüksekliğinde UPGRADE "v3.2.8" NEEDED iletisiyle durur: qorechaind dosyasını değiştirin, paketin lib/ klasörünün tamamını kopyalayın ve yeniden başlatın; durumu korunur ve yeniden senkronize olması gerekmez. Mainnet v3.2.7'de kalır, testnet'in bir sürüm gerisindedir; v3.2.8'i uygulamamıştır, bu yüzden v3.2.8 notlarındaki hiçbir şey mainnet düğümleri için değişmez. Bir testnet ikili dosyasını mainnet'e karşı veya tersini çalıştırmayın: her dizin kendi sürümünü taşır (bkz. Yükseltmeler). Manifesto kasıtlı olarak kademeli yükseltilir (önce testnet'e, ardından bir dinlenme/soak süresinin sonunda mainnet'e); bu yüzden binary.url'e güvenmeden önce manifestonun "version" alanını minCompatible ile karşılaştırarak kontrol edin.

Genel kaynaktan derlenen bir ikili dosya (topluluk derlemesi) her iki genel ağda da başlamayı reddeder (v3.2.3 ve sonrası): kuantum sonrası imzaları doğrulayamaz ve ağların bloklarını sadık biçimde yeniden oynatamaz. Yalnızca sürüm arşivini kullanın.

v3.2.1'den itibaren iki ayar önem taşır: sistem saatini NTP ile senkronize tutun (saati 60 saniyeden fazla sapan düğüm durur) ve app.toml içinde evm-chain-id değerini ayarlayın (Düğüm sınırları bölümüne bakın).


Düğüm ve Doğrulayıcı Karşılaştırması​

KonuYalnızca düğüm (bu kılavuz)Doğrulayıcı
Konsensüs anahtarıYoked25519 konsensüs anahtarı (güvence altına alınmalıdır)
Blok üretimiHayırEvet — blok önerir ve imzalar
Staking / slashingGeçerli değilÖz-delegasyon, slashing riski
Temel amaçEntegrasyonlara RPC/REST/gRPC/EVM (ve salt okunur SVM) sunmakAğı güvence altına almak (staking ödülleri geçerlidir)
Genele açıklıkRPC/EVM uç noktaları genellikle dışa açılırDoğrulayıcı, sentry düğümlerin arkasında gizlenir

Hedef Ağlar​

AğZincir kimliğiEVM zincir kimliğiNotlar
Mainnetqorechain-vladi9801 (hex 0x2649)Birincil ağ — 7 Haziran 2026'dan beri canlı; düğüm sürümü v3.2.7 (12 Kasım 2026'dan beri)
Testnetqorechain-diana9800Entegrasyonların provasını önce burada yapın; düğüm sürümü v3.2.8 (12 Kas 2026'dan beri)

Bu kılavuz boyunca hedef ağınıza uygun --chain-id değerini kullanın. Örnekler varsayılan olarak mainnet'i kullanır.


ProfilCPURAMDisk (NVMe SSD)Ağ
Budanmış (pruned) RPC düğümü4 çekirdek16 GB500 GB+100 Mbps+
Tam/arşiv düğümü8 çekirdek32 GB2 TB+ (zamanla büyür)1 Gbps
Borsa entegrasyonu8 çekirdek32 GB2 TB+ (yedek alanla)1 Gbps

NVMe SSD şiddetle önerilir: zincir durumu (state) ile EVM/SVM depoları yoğun G/Ç (I/O) kullanır. Yukarıdaki disk rakamları cömerttir. Mainnet'te ölçülen değerler (27 Ekim 2026): pruning = "custom" (keep-recent 100000) ve indexer = "null" ile state sync yoluyla katılan bir doğrulayıcı iki ay sonra yaklaşık 10 GB tutar; genesis'ten beri çalışan ve varsayılan budamayı kullanan bir düğüm ise dört ay sonra yaklaşık 100 ila 130 GB tutar. Doğrulayıcı boyutlandırması Doğrulayıcı Çalıştırma: Donanım bölümündedir. Arşiv düğümleri (budama yok, tam tx indeksleme) sürekli büyür; diski yedek alan bırakarak ve izlemeyle (monitoring) birlikte planlayın.


Dağıtım​

Docker Compose​

Docker Compose ile yalnızca düğüm dağıtımı. Çekilebilecek genele açık, yayınlanmış bir qorechaind imajı yok (projenin Docker Hub organizasyonu altında hiçbir şey yayınlanmamıştır). Genel depodaki Dockerfile, topluluk (community) ikili dosyasını derler (kuantum sonrası kütüphane yok, stub keeper'lar): yerel geliştirme için uygundur, ancak mainnet'i veya testnet'i takip edemez ve v3.2.3'ten beri onlarda başlamayı reddeder. Bir ağ düğümü için, latest.json içinde belirtilen sürüm arşivinden kendi imajınızı derleyin, sürüm numarasıyla etiketleyin (yazım sırasında hem mainnet'te hem de testnet'te v3.2.6), ardından zincir verisi için kalıcı bir volume bağlayın:

# Fetch and verify the release archive (see "Joining the Network" below for the manifest steps)
curl -s https://download.qore.host/mainnet/latest.json -o latest.json
curl -fsSL "$(jq -r .binary.url latest.json)" -o qore.tgz
echo "$(jq -r .binary.sha256 latest.json) qore.tgz" | sha256sum -c -
mkdir release && tar xzf qore.tgz -C release

cat > release/Dockerfile <<'EOF'
FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y ca-certificates curl jq && rm -rf /var/lib/apt/lists/*
COPY qorechaind /usr/local/bin/qorechaind
COPY lib/ /opt/qorechain/lib/
ENV LD_LIBRARY_PATH=/opt/qorechain/lib
ENTRYPOINT ["qorechaind"]
EOF
docker build -t qorechain-node:v3.2.7 release/

Arşiv, qorechaind dosyasını ve paylaşımlı kütüphanelerini (libqorepqc.so, libqoresvm.so, libwasmvm.x86_64.so ve v3.2.8'den itibaren libwasmvmqore_v1.x86_64.so) içeren bir lib/ dizinini barındırır. Tek tek dosyaları değil, lib/ dizininin tamamını kopyalayın; yukarıdaki imaj, sürüm arşivi gibi yalnızca linux/amd64 içindir.

# docker-compose.yml
services:
qorechain-node:
image: qorechain-node:v3.2.7
container_name: qorechain-node
restart: unless-stopped
command: ["start", "--home", "/root/.qorechaind"]
volumes:
- qorechain-data:/root/.qorechaind
ports:
- "26657:26657" # RPC
- "26656:26656" # P2P
- "1317:1317" # REST
- "9090:9090" # gRPC
- "8545:8545" # EVM JSON-RPC
- "8546:8546" # EVM WebSocket
- "8899:8899" # SVM RPC (read-only: SVM transactions are disabled)
- "26660:26660" # Prometheus

volumes:
qorechain-data:

Veri dizinini bir kez başlatın (örneğin docker compose run --rm qorechain-node init my-node --chain-id qorechain-vladi --home /root/.qorechaind; genesis ve eş/peer yapılandırması aşağıda anlatılmıştır), ardından başlatın:

docker compose up -d
docker compose logs -f qorechain-node

systemd​

Doğrudan sunucuya (bare-metal) kurulum için qorechaind'i systemd altında çalıştırın:

# /etc/systemd/system/qorechaind.service
[Unit]
Description=QoreChain node
After=network-online.target
Wants=network-online.target

[Service]
User=qorechain
ExecStart=/usr/local/bin/qorechaind start --home /var/lib/qorechaind
Restart=on-failure
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now qorechaind
sudo journalctl -u qorechaind -f

Ağa Katılma​

1. Başlatma​

qorechaind init my-node --chain-id qorechain-vladi

2. Manifestoyu alın​

curl -s https://download.qore.host/mainnet/latest.json -o latest.json
# testnet: https://download.qore.host/testnet/latest.json

Aşağıdaki adımlarda ikili dosya, genesis ve eş değerleri için bu dosyayı kaynak olarak kullanın — jq -r .minCompatible latest.json çıktısını kontrol edin ve en az o sürümü çalıştırın (önerilen sürüm jq -r .version latest.json çıktısıdır).

3. Genesis'i indirin ve doğrulayın​

GENESIS_URL=$(jq -r .genesis.url latest.json)
GENESIS_SHA256=$(jq -r .genesis.sha256 latest.json)

curl -fsSL "$GENESIS_URL" -o ~/.qorechaind/config/genesis.json
echo "${GENESIS_SHA256} $HOME/.qorechaind/config/genesis.json" | sha256sum -c -

# Cross-verify against the genesis served live by the chain:
curl -s https://rpc.qore.host/genesis | jq '.result.genesis' > /tmp/genesis-live.json

4. Eşleri ve ücret tabanını yapılandırın​

Düğüm kimliklerini ve adresleri sabit kodlamak yerine güncel eşleri ve tohum düğümleri manifestodan okuyun — bunlar zaman içinde değişir:

PEERS=$(jq -r '.peers | join(",")' latest.json)
SEEDS=$(jq -r '.seeds | join(",")' latest.json)

~/.qorechaind/config/config.toml dosyasını açın ve persistent_peers (ve seeds) değerlerini bu değerlere ayarlayın:

persistent_peers = "<value of $PEERS>"
seeds = "<value of $SEEDS>"

Ardından ~/.qorechaind/config/app.toml dosyasında asgari gaz fiyatını ayarlayın (ağ ücret tabanı: 0.1uqor):

minimum-gas-prices = "0.1uqor"

qorechaind init <moniker> --chain-id qorechain-vladi komutu, ağın EVM zincir kimliğini de app.toml dosyasına yazar (Düğüm sınırları bölümüne bakın); uzun zaman önce başlatılmış bir home dizininde bu değeri kontrol edin.

5. Senkronizasyonu başlatın​

qorechaind start --minimum-gas-prices=0.1uqor

Hızlı Başlatma​

Genesis'ten senkronize olmak uzun sürebilir. Katılmanın varsayılan yolu olarak state sync kullanın; anlık görüntü (snapshot) yalnızca bir yedektir (mainnet anlık görüntüsü 21 Ağustos 2026 tarihlidir ve testnet hiç anlık görüntü yayınlamaz).

State sync​

State sync, her bloğu yeniden oynatmak yerine güvenilir RPC sunucularından güncel bir uygulama durumu anlık görüntüsü alır. config.toml içindeki [statesync] bölümünü yapılandırın:

[statesync]
enable = true
rpc_servers = "https://rpc.qore.host:443,https://<a second RPC you run or trust>:26657"
trust_height = <TRUSTED_BLOCK_HEIGHT>
trust_hash = "<TRUSTED_BLOCK_HASH>"
trust_period = "168h0m0s"

trust_height / trust_hash değerlerini manifestonun stateSync alanından alın. Bu alan saatlik olarak yenilenir, dolayısıyla tercih edilen kaynaktır:

TRUST_HEIGHT=$(jq -r .stateSync.trustHeight latest.json)
TRUST_HASH=$(jq -r .stateSync.trustHash latest.json)
İki farklı RPC sunucusu

State sync, güven noktasını iki RPC sunucusuna karşı çapraz kontrol eder. Manifestonun stateSync.rpcServers alanı mainnet'te https://rpc.qore.host adresini iki kez listeler (testnet'te ise https://rpc-testnet.qore.host adresini iki kez): iki özdeş girdi sayı koşulunu karşılar ama çapraz kontrolü boşa çıkarır. Bağımsız olarak çalıştırdığınız veya güvendiğiniz ikinci bir RPC ekleyin ve güven hash'ini ikinci bir kaynakla karşılaştırın, örneğin curl -s "https://<second-rpc>/block?height=$TRUST_HEIGHT" | jq -r .result.block_id.hash; çıktı $TRUST_HASH değerine eşit olmalıdır.

Yedek/alternatif olarak, güvenilir bir yükseklik ve hash değerini genele açık RPC'den kendiniz türetebilirsiniz:

curl -s https://rpc.qore.host/block | jq -r '.result.block.header.height, .result.block_id.hash'

Anlık görüntüden geri yükleme​

Alternatif olarak, yayınlanan zincir verisi anlık görüntüsünü indirin, sağlama toplamını doğrulayın ve veri dizininizin üzerine açın. Mainnet'te manifestonun snapshot nesnesi URL'yi, blok height değerini, boyutu ve SHA-256 değerini verir. Testnet manifestosunun anlık görüntü URL'si şu anda 404 döndürür (hiçbir testnet anlık görüntüsü yayınlanmamıştır), bu yüzden orada state sync kullanın. Mainnet anlık görüntüsünü kullanmadan önce snapshot.height değerini okuyun: yaklaşık 27 GB'lık tek bir arşivdir ve eski bir anlık görüntü uzun bir yetişme süresi demektir. Şu anda yayınlanan mainnet anlık görüntüsü 21 Ağustos 2026 tarihlidir (yükseklik 1.966.629): v3.1.94, v3.2.0, v3.2.2, v3.2.3 ve v3.2.4 yükseltme yüksekliklerinden öncesine aittir; bu nedenle ondan geri yüklenen bir düğüm, manifestonun adlandırdığı sürüm ikili dosyasıyla yaklaşık iki aylık bloğu yeniden oynatır. State sync neredeyse her zaman daha iyi seçimdir.

SNAP_URL=$(jq -r .snapshot.url latest.json)
SNAP_SHA256=$(jq -r .snapshot.sha256 latest.json)
curl -fsSL "$SNAP_URL" -o snapshot.tar.gz
echo "${SNAP_SHA256} snapshot.tar.gz" | sha256sum -c -

tar xzf snapshot.tar.gz -C ~/.qorechaind/
qorechaind start --minimum-gas-prices=0.1uqor
not

Manifestonun snapshot.height ve snapshot.ts alanları arşivin ne kadar güncel olduğunu söyler; state sync (yukarıda) genellikle 27 GB'lık bir indirmeden daha hızlıdır. Arşivi açmadan önce sağlama toplamını her zaman doğrulayın ve bir anlık görüntüden yeniden oynatırken tüm yükseltme işleyicilerini taşıyan bir düğüm sürümü kullanın (bu sayfanın başındaki uyarıya bakın).


Yükseltmeler​

Konsensüs değişiklikleri koordineli yönetişim yükseltmeleri olarak gelir: kabul edilen bir önerge bir plan (örneğin v3.2.3) ve bir blok yüksekliği belirtir. Sürüm ikili dosyası yükseltme işleyicilerini taşır; plan yüksekliğinde her düğümün onu çalıştırıyor olması gerekir ve hâlâ önceki ikili dosyada olan bir düğüm o yükseklikte durur (bu, yükseltme modülünün amaçlanan davranışıdır). Manifesto, bir sürümün hangi türde olduğunu söyler: upgradeType, koordineli bir yükseltme için height'tır (upgradeHeight ayarlıdır) ve düğüm düğüm değiştirilebilen düğüme yerel bir sürüm için rolling'dir. Yeni ikili dosyayı yükseklikten önce kurun; düğümünüz önce durduysa ikili dosyayı değiştirip yeniden başlatın (Sorun Giderme altındaki geri alma notuna bakın).

SürümMainnet qorechain-vladiTestnet qorechain-diana
v3.1.94yükseklik 2.122.074uygulanmadı
v3.2.0yükseklik 2.981.742yükseklik 5.920.000
v3.2.1düğüme yerel, yükseklik yokdüğüme yerel
v3.2.2yükseklik 3.556.788 (16 Eki 2026)yükseklik 6.905.034 (2 Eki 2026)
v3.2.3yükseklik 3.662.051 (20 Eki 2026, yönetişim önerisi 11)yükseklik 8.003.746 (15 Eki 2026)
v3.2.4yükseklik 3.742.566 (23 Eki 2026, yönetişim önerisi 13)yükseklik 8.337.253 (19 Eki 2026, yönetişim önerisi 13)
v3.2.5yükseklik 3.906.833 (29 Eki 2026, yönetişim önerisi 14)yükseklik 8.890.800 (26 Eki 2026)
v3.2.6yükseklik 4.020.000 (4 Kas 2026, yönetişim önerisi 15)yükseklik 8.970.638 (27 Eki 2026)
v3.2.7yükseklik 4.164.600 (12 Kas 2026, yönetişim önerisi 16)yükseklik 9.594.600 (6 Kas 2026, yönetişim önerisi 33)
v3.2.8uygulanmadıyükseklik 9.929.500 (12 Kas 2026)

Bir düğüm operatörü v3.2.4 için ne yaptı (mainnet yüksekliği 3.742.566). Yönetişim önerisi 13, planı 3.742.566 yüksekliğinde v3.2.4 olarak adlandırdı (23 Ekim 2026'da uygulandı): düğümler o yüksekliğe kadar v3.2.3'te kaldı, orada durdu ve v3.2.4 ile yeniden başladı. Bir sonraki koordineli yükseltme için adımlar aynıdır:

  1. Manifestoyu (https://download.qore.host/mainnet/latest.json) izleyin: yeni sürümü adlandırana kadar kurulacak bir şey yoktur ve testnet dizinindeki bir ikili dosya mainnet sürümü değildir.
  2. Manifesto sürümü adlandırdığında, arşivi binary.url adresinden indirin, sha256 değerini doğrulayın (öneri metni de ikili dosyanın sha256 değerini yayımlar) ve yükseklikten önce yerleştirin. Bekleyen plan (name ve height) için GET /cosmos/upgrade/v1beta1/current_plan adresini, mevcut yükseklik için RPC üzerinde GET /status adresini kontrol edin.
  3. Plan yüksekliğinde hâlâ eski ikili dosyada olan bir düğüm durur (bu, yükseltme modülünün amaçlanan davranışıdır, bir arıza değildir); zaten yeni ikili dosyayı çalıştıran bir düğüm yükseltme işleyicisini uygular ve devam eder. Sizinki önce durduysa, ikili dosyayı değiştirin ve yeniden başlatın. Yükseltmeden sonra GET /cosmos/upgrade/v1beta1/applied_plan/v3.2.4 adresi 0 yerine yüksekliği döndürür (mainnet'te 3742566, testnet'te 8337253).
  4. Şimdi mainnet'e katılan bir düğüm manifestonun adlandırdığı sürümü kurar (yazım sırasında v3.2.7; version değerini minCompatible ile karşılaştırın).

İşlem imzalama, adresler, ondalık basamaklar, memolar ve ücretler v3.2.4 ile değişmez.

Mainnet'te v3.2.5 (yükseklik 3.906.833, 29 Ekim 2026, yönetişim önerisi 14). Aynı adımlar uygulandı: manifesto hem version hem de minCompatible olarak 3.2.5 adlandırdı ve hâlâ v3.2.4 üzerinde olan bir düğüm plan yüksekliğinde UPGRADE "v3.2.5" NEEDED iletisiyle durdu. Çözüm, v3.2.5 paketini kurmak (qorechaind ile lib/ paylaşımlı kütüphanelerini birlikte getirir; yan yana tutun) ve yeniden başlatmaktır; düğümün durumu korunur.

Mainnet'te v3.2.6 (yükseklik 4.020.000, 4 Kasım 2026, yönetişim önerisi 15). Aynı adımlar uygulandı: manifesto hem version hem de minCompatible olarak 3.2.6 adlandırır ve hâlâ v3.2.5 üzerinde olan bir düğüm plan yüksekliğinde UPGRADE "v3.2.6" NEEDED iletisiyle durur; v3.2.6 paketini kurun ve yeniden başlatın. İmzalama (sign-bytes v2), adresler, ondalıklar, memolar ve ücretler değişmez ve manifesto, operatörlerden saati NTP ile senkronize tutmalarını ister. GET /cosmos/upgrade/v1beta1/applied_plan/v3.2.6 mainnet'te {"height":"4020000"} döndürür. Başka bir mainnet yükseltmesi planlanmamıştır.

Mainnet'te v3.2.7 (yükseklik 4.164.600, 12 Kasım 2026, yönetişim önerisi 16). Aynı adımlar uygulandı: manifesto hem version hem de minCompatible olarak 3.2.7 adlandırır ve hâlâ v3.2.6 üzerinde olan bir düğüm plan yüksekliğinde UPGRADE "v3.2.7" NEEDED iletisiyle durur; v3.2.7 paketini kurun ve yeniden başlatın, durumu korunur. GET /cosmos/upgrade/v1beta1/applied_plan/v3.2.7 mainnet'te {"height":"4164600"} döndürür. Yükseltme on bir protokol özelliğini açtı (hibrit kuantum sonrası multisig, her kuantum sonrası doğrulama için sabit 2.000 gas, EVM pencere olayı, RDK doğrulama anahtarı mesajları ve çeşitli SVM adres ve cross-VM düzeltmeleri), toplam 101. SVM şeridi, cross-VM çağrısı ve CosmWasm yükleme ile örnekleme mainnet'te kapalı kalır.

Canlı kaydı GET /cosmos/upgrade/v1beta1/applied_plan/<name> ile (0 = uygulanmadı) ve bekleyen herhangi bir planı GET /cosmos/upgrade/v1beta1/current_plan ile okuyun. v3.2.2; konsensüs motoru, Cosmos SDK (v0.53.8) ve IBC bağımlılıklarını yükseltti ve SDK'nın daha katı işlem kontrolleri, bu sürümün önceki ikili dosyayı düğüm düğüm değil yükseltme yüksekliğinde değiştirmesini sağlar. İşlem imzalama, adresler, ondalık basamaklar, memo'lar ve ücretler v3.2.2 veya v3.2.3'te değişmedi.

State sync ve saat. State sync güven noktasını manifestonun stateSync bloğundan alır (trustHeight, trustHash, saatlik yenilenir); listelediği RPC sunucusu projenin kendi sunucusudur, bu nedenle üretim düğümü için güvendiğiniz RPC sunucuları ekleyin ve güven hash'ini başka bir kaynağa karşı kontrol edin. Saati NTP ile senkronize tutun: düğüm, ağla arasındaki sapma 60 saniyeyi aştığında durur.


Budama (Pruning) ve İndeksleme​

Budamayı ve işlem indekslemeyi entegrasyonunuza uyacak şekilde ayarlayın. Tam işlem geçmişine ihtiyaç duyan borsalar, asgari budamayla ve işlem indeksleyicisi etkin olarak çalışmalıdır.

Budama (app.toml)​

# Keep recent state only — smallest disk footprint
pruning = "default"

# Keep everything — required for archive / full historical queries
# pruning = "nothing"
pruningDavranışKullanım senaryosu
defaultGüncel durumu tutar, gerisini budarRPC düğümü, bakiye/durum sorguları
nothingTüm geçmiş durumu tutarArşiv düğümü, tam geçmiş
customOperatör tanımlı keep/interval değerleriÖzelleştirilmiş saklama

v3.2.8'de sözleşme çalışma zamanı​

v3.2.8 sürümündeki bir düğüm (daha sonraki bir ana ağ yükseltmesine kadar yalnızca test ağında) şunlara ihtiyaç duyar: paketin lib/ dizininin tamamı (libwasmvm, libqorepqc ve libqoresvm yanında libwasmvmqore da taşır); en az 256 MiB'lık bir [wasm] memory_cache_size (daha küçük bir değer bir uyarıyla 256'ya yükseltilir, bu yüzden belleği planlayın); ve sözleşme kodu dizininin <home>/wasm konumunda olması (başka bir yerdeki mevcut bir kod dizini bir uyarıyla çalışmaya devam eder). Yeni bir app.toml ayrıca simulation_gas_limit = 50000000 ayarlar ve eth,net,web3 JSON-RPC ad alanlarını sunar.

Düğüm sınırları (app.toml)​

v3.2.1 düğüm sürümünden itibaren init, düğüme yerel üç sınır içeren bir [qorechain] bölümü yazar. Bu sınırlar yalnızca bu düğümün bellekte neyi tuttuğunu ve önerdiği bloklara neyi koyduğunu değiştirir; bir bloğun geçerli olması için neleri içermesi gerektiğini asla değiştirmez:

[qorechain]
# Maximum number of Cosmos transactions held in the app-side mempool (default 5000).
# When full, a new transaction that pays more per gas evicts the lowest-paying one; otherwise it is refused.
cosmos-mempool-max-txs = 5000

# Time the node may spend selecting transactions for a proposal before it proposes what it has ("0s" disables the budget).
prepare-proposal-budget = "1s"

# Stop after this many candidates in a row that do not fit in the remaining block space (0 disables the cap).
prepare-proposal-max-skips = 64

init ayrıca ağın EVM zincir kimliğini app.toml dosyasındaki [evm] bölümünün evm-chain-id ayarına yazar (--chain-id qorechain-vladi için 9801, qorechain-diana için 9800). app.toml dosyasında farklı bir değer taşıyan bir düğüm yine de başlar, ancak başlangıçta bir hata kaydeder ve dosyayı düzeltene kadar kendi JSON-RPC'si (eth_chainId, o düğüme karşı imzalama) yanlış zincir kimliğiyle yanıt verir; konsensüs etkilenmez. Eski ikili dosyalar --chain-id değerinden bağımsız olarak testnet değerini (9800) yazıyordu; bu yüzden uzun zaman önce başlatılmış bir mainnet düğümü bu ayarı kontrol etmelidir. QORE_EVM_CHAIN_ID değerini ağın değerinden farklı bir değere ayarlamayın: böyle bir düğüm başlamayı reddeder.

İşlem indeksleme (config.toml)​

[tx_index]
indexer = "kv"

İşlemlerin hash ve event üzerinden sorgulanabilmesi için indexer = "kv" (veya daha zengin bir indeksleyici) ayarlayın — bu, yatırma ve çekme işlemlerini mutabakata bağlayan borsalar için vazgeçilmezdir. indexer = "null" ayarını yalnızca geçmiş tx sorgularına ihtiyacınız yoksa kullanın.


Entegrasyon için Uç Noktaları Dışa Açma​

Entegratörlerin ihtiyaç duyduğu API sunucularını app.toml içinde etkinleştirin ve bağlayın:

[api]
enable = true
address = "tcp://0.0.0.0:1317"

[grpc]
enable = true
address = "0.0.0.0:9090"

[json-rpc]
enable = true
address = "0.0.0.0:8545"
ws-address = "0.0.0.0:8546"
api = "eth,net,web3,txpool"

Düğüm sürümü v3.2.4'te JSON-RPC sınırları. v3.2.4 ikili dosyasını çalıştıran bir düğüm (testnet'te 19 Ekim 2026'dan beri; mainnet'te 23 Ekim 2026'dan beri) kendi JSON-RPC sunucusunu sınırlar. Bunlar app.toml içindeki [json-rpc] bölümündeki düğüme yerel ayarlardır ve konsensüsü etkilemez: http-body-limit (varsayılan 262144 bayt, 256 KiB; daha büyük bir istek gövdesi okunmadan önce HTTP 413 ile reddedilir), max-concurrent-requests (varsayılan 256; bunun ötesindeki istekler hemen HTTP 503 alır) ve max-open-connections (eksik veya sıfır bir değer artık sınırsız değil, 1000 anlamına gelir). Buna ek olarak, eth_getLogs ve eth_newFilter filtre argümanı, 4'ten fazla konu (topic) konumu, tek bir konumda 1000'den fazla alternatif veya 1000'den fazla adres listelediğinde reddedilir. Kendi düğümüne çok büyük toplu veya sözleşme dağıtım istekleri gönderen bir entegratör, en büyük isteğinin gövde sınırına sığdığını kontrol etmeli ve gerekirse sınırı yükseltmelidir.

Genel uç noktalar eth_, net_, web3_ ve txpool_ (yalnızca durum) ad alanlarını (namespace) sunar; v3.2.3 veya sonrasıyla başlatılan bir düğüm varsayılan olarak eth,net,web3 kullanır ve txpool'u dışarıda bırakır (düğümün bekleyen işlemlerini yayınlar), bu yüzden onu yalnızca ihtiyacınız varsa ekleyin. qor_ ad alanı yayınlanmış hiçbir düğüm derlemesi tarafından sunulmaz; bu yüzden onu eklemeyin (qor_ ad alanına bakın).

Ve config.toml içindeki RPC dinleyicisini:

[rpc]
laddr = "tcp://0.0.0.0:26657"
Uç noktaPortKullanım amacı
RPC26657İşlem yayınlama, blok/durum sorgulama
REST1317Zincir durumunun HTTP ile sorgulanması
gRPC9090Yüksek verimli programatik erişim
EVM JSON-RPC8545Ethereum uyumlu entegrasyonlar (zincir kimliği 9801)
EVM WS8546EVM olay (event) abonelikleri
SVM RPC8899Solana uyumlu okumalar (SVM işlemleri devre dışıdır)
uyarı

RPC, EVM JSON-RPC veya gRPC'yi ters proxy (reverse proxy), hız sınırlama (rate limiting), kimlik doğrulama ve güvenlik duvarı olmadan asla doğrudan genele açık internete açmayın. 0.0.0.0 adresine bağlamayı yalnızca kontrollü bir giriş (ingress) katmanının arkasında yapın.


Sağlık ve Senkronizasyon İzleme​

Senkronizasyon durumu​

curl -s localhost:26657/status | jq '.result.sync_info.catching_up'
  • true — hâlâ senkronize oluyor.
  • false — tamamen senkronize olmuş ve güncel durumu sunuyor.
# Latest height and network
curl -s localhost:26657/status | jq '.result.sync_info.latest_block_height, .result.node_info.network'

network alanı qorechain-vladi (mainnet) veya qorechain-diana (testnet) değerini bildirmelidir.

Prometheus ve Grafana​

Düğüm, Prometheus metriklerini 26660 portunda sunabilir (config.toml içindeki [instrumentation] bölümünde prometheus = true ayarlayın):

http://localhost:26660/metrics

Bu metrikleri Prometheus uyumlu herhangi bir toplayıcıyla toplayın. Docker Compose izleme yığınını çalıştırıyorsanız, Grafana http://localhost:3001 adresinde erişilebilir — ilk girişte kendi kimlik bilgilerinizi belirleyin. Blok yüksekliği gecikmesini, eş (peer) sayısını ve kaynak kullanımını takip edin; catching_up değeri true olarak kaldığında veya eş sayısı sıfıra düştüğünde uyarı verecek şekilde yapılandırın.

EVM uç noktası kontrolü​

curl -s -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
# Expect "0x2649" (9801) on mainnet

Operasyonel En İyi Uygulamalar​

  1. Zincir sürümünü sabitleyin. Manifestonun önerdiği sürümü çalıştırın (yazım sırasında mainnet'te v3.2.7 ve testnet'te v3.2.8), koordineli yükseltmeler için resmi sürümleri takip edin ve sistem saatini NTP ile senkronize tutun.

  2. Yedekli düğümler çalıştırın. Tek bir yeniden başlatma veya yeniden senkronizasyonun entegrasyon trafiğini kesintiye uğratmaması için bir yük dengeleyicinin (load balancer) arkasında en az iki düğüm işletin.

  3. Genesis ve anlık görüntüleri doğrulayın. Başlatmadan önce genesis SHA-256 değerini ve tüm anlık görüntü sağlama toplamlarını her zaman resmi sürüme karşı doğrulayın.

  4. Genele açık uç noktaları koruyun. RPC/EVM/gRPC'nin önüne ters proxy, hız sınırlama ve güvenlik duvarı koyun. Kimlik doğrulaması olmayan yazma RPC'sini asla internete açmayın.

  5. Budamayı ihtiyaca göre seçin. Tam yatırma/çekme geçmişini mutabakata bağlayan borsalar için pruning = "nothing" artı tx_index = "kv" kullanın; hafif sorgular için default kullanın.

  6. Senkronizasyonu sürekli izleyin. Blok yüksekliği gecikmesi, sıfır eş ve catching_up durumunda takılı kalan düğüm için uyarı kurun.

Yalnızca düğüm olarak yapılan bir dağıtım hiçbir zaman imza atmaz. Entegrasyonunuzun bu düğüm üzerinden yayınladığı işlemler, hibrit kuantum sonrası imzayı zaten taşımalıdır (EVM şeridi için ayrıca göndericinin kayıtlı bir anahtara ve açık bir yetkilendirme penceresine ihtiyacı vardır); bkz. Borsa Entegrasyonu ve Kuantum Sonrası İmzalama.

Tam bir düğüm çalıştırmadan ağı gözlemlemek için Light Node dokümantasyonuna bakın.


Sorun Giderme​

Düğüm bir saat hatasıyla duruyor​

v3.2.1 düğüm sürümünden itibaren konsensüs motoru, sistem saati ağdan 60 saniyeden fazla saptığında durur. Bir NTP istemcisi (chrony veya systemd-timesyncd) çalıştırın, saatin timedatectl status ile senkronize olduğunu doğrulayın, ardından düğümü yeniden başlatın.

Yükseltmeden önce duran bir düğüm, ikili dosya değişiminden sonra devam etmiyor​

Düğümünüz ikili dosyasını yükseltmeden önce zaten durmuş veya takılı kalmışsa, yeni ikili dosyayı yerleştirip yeniden başlatmak tek başına yeterli değildir — düğümde eski çalıştırmadan kalan bayat ABCI sonuçları önbelleğe alınmıştır ve durmaya neden olan bloğu yeniden yürütmez. Yeniden başlatmadan önce açıkça geri alın (rollback):

qorechaind rollback --home <HOME>
systemctl restart <unit>

Komut qorechaind rollback'tir (üst düzey bir alt komut) — bir comet rollback alt komutu yoktur ve bunun için bir --hard bayrağı bulunmaz.

Eksik bir priv_validator_state.json nedeniyle anlık görüntü geri yükleme çökme döngüsüne giriyor​

Yayınlanan bir arşiv/anlık görüntü data/priv_validator_state.json dosyasını içermez ve düğüm bu dosya olmadan başlamayı reddeder. Bir anlık görüntü geri yüklemesinden sonra bu dosya eksikse, oluşturun — ancak yalnızca zaten mevcut değilse. Gerçek bir dosyanın üzerine asla yazmayın: bir doğrulayıcıda bu dosya çift imzalamaya (double-signing) karşı koruma sağlar ve üzerine yazmak çift imzalama riski taşır.

echo '{"height":"0","round":0,"step":0}' > <HOME>/data/priv_validator_state.json

Sonraki Adımlar​