Ana içeriğe geç

Ana Ağa Bağlanma

Düğümünüzü resmi genesis dosyası, eşler (peers) ve ağ ayarlarıyla yapılandırarak canlı QoreChain Vladi ana ağına katılın.

not

Bu sayfa, Cosmos SDK v0.53 üzerinde 7 Haziran 2026 tarihinden beri canlı olan ve 12 Kasım 2026'dan beri v3.2.7 sürümünü çalıştıran (yönetişim önerisi 16 ile 4,164,600 yüksekliğinde, bloklar yaklaşık 15:01 UTC'de yeniden başlayarak uygulandı; v3.2.6, 4 Kasım 2026'da 4,020,000 yüksekliğinde uygulanmıştı) qorechain-vladi ana ağını (EVM zincir kimliği 9801, onaltılık 0x2649) kapsar. qorechain-diana test ağı (EVM zincir kimliği 9800) için Test Ağına Bağlanma bölümüne bakın ve canlıya geçmeden önce kurulumunuzu orada prova edin.

Genel Erişime Açık Uç Noktalar​

Yalnızca zinciri sorgulamanız veya işlem yayınlamanız gerekiyorsa kendi düğümünüze ihtiyacınız yoktur — genel erişime açık uç noktalar şunlardır:

HizmetURL
Konsensüs RPChttps://rpc.qore.host (WebSocket: wss://rpc.qore.host/websocket)
Cosmos REST (LCD)https://api.qore.host
EVM JSON-RPChttps://evm.qore.host (zincir kimliği 9801)
SVM JSON-RPC (salt okunur)https://svm.qore.host
Blok gezginiexplore.qore.network

Yoğun veya üretim düzeyindeki iş yükleri (borsalar, indeksleyiciler) için aşağıda açıklandığı gibi kendi düğümünüzü çalıştırın.

Genel ana makineler paylaşımlıdır ve sınırları vardır (istek hızı, SVM RPC boyutları, EVM filtreleri); eth_call ve gas tahmini EVM JSON-RPC ana makinesi üzerinden yapılır. Bkz. Genel uç noktalardaki sınırlar.


Kurulum​

qorechaind ikili dosyasını resmi önceden derlenmiş paketten veya kaynak koddan derleyerek kurun.

Önceden derlenmiş ikili paket (linux/amd64)​

Güncel ikili dosya için asıl doğruluk kaynağı, https://download.qore.host/mainnet/latest.json adresinde canlı olarak güncellenen bir JSON dosyası olan ana ağ manifestosudur. Bu dosya; güncel ikili dosya URL'sini ve SHA-256 değerini, güncel genesis URL'si/SHA-256/boyutunu, güncel eşleri (peers) ve tohum düğümlerini (seeds), P2P portunu, bir durum senkronizasyonu (state-sync) güven noktasını ve minimum uyumlu zincir sürümünü içerir. Kurulum betiklerinizde bir ikili dosya sürümünü veya sağlama toplamını sabit kodlamak yerine bu dosyayı indirip değerlerini kullanın — yeni bir sürüm yayımlanır yayımlanmaz bunlar eskir:

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

BINARY_URL=$(jq -r .binary.url latest.json)
BINARY_SHA256=$(jq -r .binary.sha256 latest.json)

curl -fsSL "$BINARY_URL" -o qore.tgz
echo "${BINARY_SHA256} qore.tgz" | sha256sum -c -

tar xzf qore.tgz
sudo install -m0755 qorechaind /usr/local/bin/
sudo mkdir -p /opt/qorechain/lib && sudo cp lib/*.so /opt/qorechain/lib/
export LD_LIBRARY_PATH=/opt/qorechain/lib

Bu paket, qorechaind ile birlikte gerekli paylaşılan kitaplıklarını (libqorepqc.so, libqoresvm.so, libwasmvm.x86_64.so ve v3.2.8'den itibaren libwasmvmqore_v1.x86_64.so) içerir. Tek tek dosyaları değil, lib/ dizininin tamamını kopyalayın.

Düğümünüzü güncel tutun

Tam düğümler ağın canlı sürümünü takip etmek zorundadır — her zaman manifestonun işaret ettiği ikili dosyayı kurun, eski bir sürümü sabitlemeyin. Güncel manifesto (12 Kasım 2026'da kontrol edildi) v3.2.7'dir; minCompatible değeri 3.2.7 ve upgradeHeight değeri 4,164,600'dır: ana ağ v3.2.7'yi orada, 12 Kasım 2026'da, 16 numaralı yönetişim önerisiyle uyguladı (bloklar yaklaşık 15:01 UTC'de yeniden başladı) ve daha eski bir sürümde kalan bir düğüm zinciri o yüksekliğin ötesinde takip edemez. Paket qorechaind-v3.2.7-b3-linux-amd64.tar.gz (99,472,930 bayt, SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5). Manifesto, paketin lib/ klasörünün tamamının kopyalanmasını söyler; v3.2.7 için bu klasör libqorepqc.so, libqoresvm.so ve libwasmvm.x86_64.so dosyalarını içerir. Yükseltmeyi kaçıran ve hâlâ v3.2.6'da olan bir düğüm 4,164,600 yüksekliğinde UPGRADE "v3.2.7" NEEDED hatasıyla durur ve çözüm bu paketi (lib/ klasörüyle birlikte) kurup yeniden başlatmaktır (durum korunur). Ana ağdaki önceki yönetişim yükseltmeleri; 2,122,074 yüksekliğinde v3.1.94 (emisyon tavanı), 2,981,742 yüksekliğinde v3.2.0 (EVM yetkilendirme penceresi ve v2 hibrit imza baytları), 3,556,788 yüksekliğinde v3.2.2 (16 Ekim 2026, öneri 7), 3,662,051 yüksekliğinde v3.2.3 (20 Ekim 2026, öneri 11), 3,742,566 yüksekliğinde v3.2.4 (23 Ekim 2026, öneri 13), 3,906,833 yüksekliğinde v3.2.5 (29 Ekim 2026, öneri 14) ve 4,020,000 yüksekliğinde v3.2.6 (4 Kasım 2026, öneri 15) idi. v3.2.1, yüksekliği olmayan düğüm-yerel bir sürümdü. İşlem imzalama v3.2.6'da değişmedi; v3.2.7 textual imza modunu ek bir seçenek olarak ekler. Taze katılan bir düğümün manifestonun adını verdiği v3.2.7 ikili dosyasına ihtiyacı vardır; genesis'ten yeniden oynatmak yerine state sync'i (aşağıda) tercih edin. Yayımlanan zincir verisi anlık görüntüsü bu yükseltme yüksekliklerinin hepsinden öncesine aittir; bu nedenle ondan geri yüklenen bir düğüm bunları yeniden oynatmalıdır.

app.toml içinde evm-chain-id = 9801 ayarlayın (farklı bir değer hata olarak günlüğe yazılır) ve sistem saatini NTP ile senkronize tutun: saati 60 saniyeden fazla sapan bir düğüm durur. binary.url değerine güvenmeden önce her zaman manifestonun "version" ve "minCompatible" alanlarını kontrol edin — manifesto kasıtlı olarak yükseltilir (önce test ağı, ardından bir olgunlaşma süresinin sonunda ana ağ). İmzalama biçimi, adresler, ondalık basamaklar, memolar ve ücretler v3.2.3 veya v3.2.4'te değişmedi.

Test ağı (qorechain-diana) v3.2.8'i çalıştırmaktadır; ana ağın bir sürüm önündedir (v3.2.5 orada 26 Ekim 2026'da, v3.2.6 27 Ekim 2026'da, v3.2.7 6 Kasım 2026'da ve v3.2.8 12 Kasım 2026'da uygulandı; ana ağ v3.2.8'i uygulamadı). İkili dosyaları asla iki ağ arasında kopyalamayın: her zaman çalıştırdığınız ağın manifestosunu izleyin.

Koordineli bir yükseltme planlandığında, öneri metni yüksekliği belirtir ve o zamana kadar önceki sürümde kalmanızı söyler: düğüm o yükseklikte durur ve siz onu yeni ikili dosyayla yeniden başlatırsınız. Herhangi bir ikili dosyayı değiştirmeden önce önerinin status değerini (curl -s https://api.qore.host/cosmos/gov/v1/proposals/<id>) ve ana ağ manifestosunun version ile upgradeHeight alanlarını okuyun ve bir yükseltme ikili dosyasını yüksekliğinden önce asla kurmayın: onu erken taşıyan bir düğüm de durur. 12 Kasım 2026'da bir yükseltme planı belirlenmemişti (curl -s https://api.qore.host/cosmos/upgrade/v1beta1/current_plan komutu "plan": null döndürdü) Sonuncusu, yönetişim önerisi 16, v3.2.7 (build 3) sürümünü 4.164.600 yüksekliğinde, 12 Kasım 2026'da uyguladı (bir öncekisi, öneri 15, v3.2.6'yı 4.020.000 yüksekliğinde, 4 Kasım 2026'da uygulamıştı); taze bir düğümün neyi kuracağı konusunda yukarıdaki manifesto esas kaynaktır.

Kaynak koddan derleme (yalnızca geliştirme için)​

git clone https://github.com/qorechain/qorechain-core.git
cd qorechain-core
CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/

Bu, stub keeper'lı ve kuantum-sonrası imzalayıcısı olmayan topluluk ikili dosyasını derler; bu dosya ağların konsensüs durumunu yeniden üretemez veya hibrit imzalı işlemler oluşturamaz. Ana ağda bir düğüm çalıştırmak için yukarıdaki sürüm ikili dosyasını kurun. Tüm ön koşullar (Go 1.26+, CGO, yerel kitaplıklar) için Kaynak Koddan Derleme sayfasına bakın.

Düğümü ilklendirme​

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

Bu komut, ~/.qorechaind/ altında varsayılan yapılandırma ve veri dizinlerini oluşturur.


Genesis Dosyasını İndirme​

Yerel genesis dosyanızı, yukarıda getirilen manifestodaki URL ve SHA-256 değerlerini kullanarak resmi ana ağ genesis dosyasıyla değiştirin:

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 -

Aynı dosya zincirin kendisi tarafından da canlı olarak sunulur — indirdiğiniz dosyayı bununla çapraz doğrulayabilirsiniz:

curl -s https://rpc.qore.host/genesis | jq '.result.genesis' > /tmp/genesis-live.json

Bu dosya; genesis doğrulayıcı kümesi, token tahsisleri (genesis'te TGE) ve modül parametreleri dahil olmak üzere Vladi ana ağının başlangıç durumunu tanımlar.


Eşleri (Peers) Yapılandırma​

Genel erişime açık ana ağ sentry düğümlerine bağlanmak için düğüm yapılandırmanızı düzenleyin. Düğüm kimliklerini ve adreslerini sabit kodlamak yerine güncel eş (peer) ve tohum (seed) listelerini manifestodan okuyun — bunlar zaman zaman 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) alanlarını bu değerlere ayarlayın:

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

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

minimum-gas-prices = "0.1uqor"

Önerilen Ayarlar​

Tam bir düğüm blok süresini seçmez — bunu doğrulayıcılar seçer (ana ağ şu anda yaklaşık her 3.1 saniyede bir blok üretir). Bir doğrulayıcı işletmiyorsanız ve doğrulayıcı grubu tarafından size değerler verilmediyse konsensüs zaman aşımlarını varsayılanlarında bırakın. Genel bir RPC düğümü için config.toml içinde yararlı bir mempool ayarı:

[mempool]
size = 5000

Hızlı Başlatma (Anlık Görüntü veya State Sync)​

Genesis'ten senkronize olmak uzun sürebilir. Manifestonun stateSync alanı, saatlik olarak güncellenen bir güven yüksekliği/karma (hash) çiftini taşır — bir yüksekliği elle aramak yerine state sync'i yapılandırmak için bunu kullanın:

TRUST_HEIGHT=$(jq -r .stateSync.trustHeight latest.json)
TRUST_HASH=$(jq -r .stateSync.trustHash latest.json)

Ardından config.toml dosyasının [statesync] bölümünü bu değerlerle ayarlayın — güven noktasını kendiniz türetmeniz gerekirse elle RPC tabanlı bir yedek yöntem dahil olmak üzere tam iş akışı için Düğüm Çalıştırma sayfasına bakın.

Bir zincir verisi anlık görüntüsü (snapshot) de manifestoda listelenir (snapshot.url, snapshot.sha256, snapshot.height). Yeni bir anlık görüntü eskisinin yerini aldığından, bir dosya adını veya yüksekliği sabit kodlamak yerine değerleri manifestodan okuyun. Anlık görüntü büyüktür (onlarca gigabayt) ve Ekim 2026'da yayımlandığı haliyle 1,966,629 yüksekliğinde (21 Ağustos 2026) alınmıştır — yukarıda listelenen her yükseltme yüksekliğinden önce — dolayısıyla ondan geri yüklenen bir düğüm bu yükseltmeleri yeniden oynatmalıdır; state sync genellikle daha hızlıdır ve bunu önler:

SNAPSHOT_URL=$(jq -r .snapshot.url latest.json)
SNAPSHOT_SHA256=$(jq -r .snapshot.sha256 latest.json)

curl -fsSL "$SNAPSHOT_URL" -o snapshot.tar.gz
echo "${SNAPSHOT_SHA256} snapshot.tar.gz" | sha256sum -c -

tar xzf snapshot.tar.gz -C ~/.qorechaind/

Düğümü Başlatma​

Ağla senkronizasyona başlamak için düğümünüzü çalıştırın:

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

Düğüm eşlere bağlanır ve blokları indirmeye başlar (genesis'ten veya bir anlık görüntü geri yüklediyseniz anlık görüntü yüksekliğinden itibaren).


Senkronizasyon Durumunu Kontrol Etme​

Düğümünüzün en son bloğa yetişmekte olduğunu doğrulayın:

curl localhost:26657/status | jq '.result.sync_info.catching_up'
  • true — Düğüm hâlâ senkronize oluyor. Yetişmesini bekleyin.
  • false — Düğüm tamamen senkronize olmuş ve yeni blokları işliyor.

En son blok yüksekliğini de kontrol edebilirsiniz:

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

Doğru ağda olduğunuzdan emin olun — network alanı qorechain-vladi değerini bildirmelidir:

curl localhost:26657/status | jq '.result.node_info.network'

İzleme​

QoreChain, düğüm sağlığını ve performansını izlemek için çeşitli uç noktalar sunar.

Prometheus Metrikleri​

Ham metrikler şu adreste sunulur:

http://localhost:26660/metrics

Bu metrikler, Prometheus uyumlu herhangi bir toplayıcı tarafından çekilebilir.

Grafana Panoları​

Docker Compose ile çalıştırıyorsanız Grafana şu adreste kullanılabilir:

http://localhost:3001

İlk oturum açmada, istendiğinde kendi kimlik bilgilerinizi belirleyin — varsayılan değerleri olduğu gibi bırakmayın. Önceden yapılandırılmış panolar; blok üretimini, işlem hacmini, eş bağlantılarını ve kaynak kullanımını görüntüler.

REST Sağlık Kontrolü​

REST API hızlı bir durum uç noktası sağlar:

http://localhost:1317

Port Referansı​

PortProtokolAçıklama
26657TCPRPC — işlemleri sorgulama ve yayınlama
26656TCPP2P — eşler arası ağ iletişimi
1317HTTPREST API — zincir durumunu HTTP üzerinden sorgulama
9090gRPCgRPC API — zincire programatik erişim
8545HTTPEVM JSON-RPC — Ethereum uyumlu RPC (zincir kimliği 9801)
8546WebSocketEVM WebSocket — gerçek zamanlı EVM olay abonelikleri
8899HTTPSVM RPC — Solana uyumlu RPC (yalnızca okuma; SVM işlem hattı devre dışıdır)
26660HTTPPrometheus metrik uç noktası

Ağ Bilgileri​

AlanDeğer
Zincir kimliğiqorechain-vladi
EVM zincir kimliği9801 (onaltılık 0x2649)
Zincir sürümüv3.2.7 (12 Kasım 2026'da 4,164,600 yüksekliğinde uygulandı)
Canlıya geçiş tarihi7 Haziran 2026
Blok süresiyaklaşık 3.1 saniye (ölçülen ortalama)
TokenQOR (uqor, 10^6 mikro birim = 1 QOR)
Asgari gaz fiyatı0.1uqor
Hesap ön ekiqor
Doğrulayıcı ön ekiqorvaloper
SDKCosmos SDK v0.53

Sonraki Adımlar​