Ana içeriğe geç

Düğüm Komutları

Bir QoreChain düğümünü başlatmak, yapılandırmak ve işletmek için kullanılan qorechaind komutlarına yönelik referans.

not

QoreChain iki ağ çalıştırır: qorechain-vladi ana ağı (7 Haziran 2026'dan beri canlı; düğüm sürümü v3.2.7, yönetişim önerisi 16 ile 12 Kasım 2026'da 4,164,600 yüksekliğinde uygulandı; v3.2.6, 4 Kasım 2026'da 4,020,000 yüksekliğinde uygulanmıştı; v3.2.5, 29 Ekim 2026'da 3,906,833 yüksekliğinde, v3.2.4, 23 Ekim 2026'da 3,742,566 yüksekliğinde ve v3.2.3, 20 Ekim 2026'da 3,662,051 yüksekliğinde uygulanmıştı) ve qorechain-diana test ağı (düğüm sürümü v3.2.8, 12 Kasım 2026'da 9,929,500 yüksekliğinde uygulandı; öncesinde v3.2.7, 6 Kasım'da 9,594,600 yüksekliğinde, v3.2.6, 27 Ekim'de 8,970,638 yüksekliğinde, v3.2.5, 26 Ekim'de 8,890,800 yüksekliğinde ve v3.2.4, 19 Ekim'de 8,337,253 yüksekliğinde uygulanmıştı; ana ağ v3.2.8'i uygulamamıştır). Katılmak istediğiniz ağ için uygun --chain-id değerini geçirin — aşağıdaki örnekler test ağını hedefler; ana ağ için --chain-id qorechain-vladi kullanın. Her ağın güncel sürümü, download.qore.host altındaki latest.json dosyasında listelenir.

Bu sayfadaki komutlar, v3.2.3 sürüm ikili dosyasına karşı denetlenmiştir. v3.2.4 ikili dosyası, v3.2.3 ikili dosyasında bulunmayan komutlar ekler (örneğin stakingtier); bunlar her iki ağda da çalışır (test ağında 19 Ekim 2026'dan beri, ana ağda 23 Ekim 2026'dan beri) ve bu kılavuz bunlardan birini andığında bunu belirtir. v3.2.6 ikili dosyası (her iki ağ) iki sorgu komutu daha ekler: query rlconsensus applied-params ve last-action (bkz. Sorgu Komutları). Bu sayfadaki diğer her şey iki sürümde de aynı davranır.


init​

Verilen takma ad (moniker) ile yeni bir düğüm başlatın.

qorechaind init <moniker> --chain-id qorechain-diana
BayrakTürAçıklama
--chain-idstringZincir tanımlayıcısı (her zaman belirtin; belirtilmezse rastgele bir tanesi oluşturulur)
--homestringDüğüm ana dizini (varsayılan: ~/.qorechaind)
--overwriteboolMevcut genesis.json dosyasının üzerine yaz
--recoverboolYeni bir anahtar oluşturmak yerine mevcut bir anahtarı kurtarmak için tohum (seed) ifadesi girin

--home altında config/, data/ ve bir başlangıç genesis.json ile dizin yapısını oluşturur. Bir ağ düğümü için, başlatmadan önce bu genesis.json dosyasını ağın genesis dosyasıyla değiştirin (Ana Ağa Bağlanma bölümüne bakın).

init ayrıca ağın EVM zincir kimliğini (qorechain-vladi için 9801, qorechain-diana için 9800) app.toml içindeki evm-chain-id ayarına yazar; bu nedenle doğru --chain-id değerini geçirin.


start​

Düğümü başlatın ve senkronize etmeye ya da blok üretmeye başlayın.

qorechaind start [flags]
BayrakTürAçıklama
--homestringDüğüm ana dizini
--minimum-gas-pricesstringBu düğümün kabul ettiği minimum gaz fiyatı. Ağ tabanı 0.1uqor'dur; en az bu değeri ayarlayın
--pruningstringBudama stratejisi: default, nothing, everything, custom (--pruning-keep-recent ve --pruning-interval ile)
--halt-heightuintDüğümü bu blok yüksekliğinde durdur
--halt-timeuintDüğümü bu Unix zaman damgasında durdur
--log_levelstringGünlük ayrıntı düzeyi: info, debug, warn, error
--traceboolHatalarda tam yığın izini (stack trace) etkinleştir

Genel kaynak ağacından derlenen bir ikili dosya (topluluk derlemesi), qorechain-vladi veya qorechain-diana üzerinde başlamayı reddeder: kuantum sonrası imzaları doğrulayamaz ve ağların bloklarını aslına uygun biçimde yeniden oynatamaz (düğüm sürümü v3.2.3 ve sonrası). download.qore.host adresindeki sürüm ikili dosyasını kullanın; bkz. Kaynaktan Derleme.


version​

qorechaind version, sürüm ikili dosyalarında sürüm numarasını bildirmez: boş bir satır yazdırır ve version --long hiçbir derleme ayrıntısı eklemez. Sürümleri birbirinden ayırt etmek için buna güvenmeyin. Çalıştırdığınız sürümü doğrulamak için:

  • İndirilen arşivin SHA-256 değerini, arşivi açmadan önce ağın manifestindeki binary.sha256 ile karşılaştırın (ve neyi kurduğunuzun kaydı olarak bu arşivi veya sağlama toplamını saklayın).
  • Zincire hangi yükseltmeleri uyguladığını sorun: GET /cosmos/upgrade/v1beta1/applied_plan/<upgrade_name>, bir yükseltmenin uygulandığı yüksekliği veya uygulanmadıysa 0 değerini döndürür.
# archive checksum, as published
curl -s https://download.qore.host/mainnet/latest.json | jq -r '.version, .binary.sha256'
# has v3.2.3 / v3.2.4 / v3.2.5 / v3.2.6 / v3.2.7 been applied on mainnet, and at which height? (a name that was not applied returns {"height":"0"})
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.3 # {"height":"3662051"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.4 # {"height":"3742566"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.6 # {"height":"4020000"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.7 # {"height":"4164600"}

status​

Çalışan düğümü; senkronizasyon durumu, en son blok yüksekliği ve uzlaşma bilgileri dahil olmak üzere mevcut durumu için sorgulayın.

qorechaind status
BayrakTürAçıklama
--nodestringRPC uç noktası (varsayılan: tcp://localhost:26657)

node_info, sync_info ve validator_info bölümleriyle JSON döndürür.


client configuration​

config alt komutu yoktur. İstemci varsayılanları (chain-id, keyring-backend, output, node) <home>/config/client.toml dosyasından okunur; bu dosyayı düzenleyin veya her komutta bayrağı geçirin (--chain-id, --keyring-backend, --output, --node).


keys​

İşlemleri imzalamak için yerel anahtarlığı (keyring) yönetin.

Yeni Bir Anahtar Ekleme​

qorechaind keys add <name> [flags]
BayrakTürAçıklama
--keyring-backendstringArka uç: os, file, kwallet, pass, test, memory
--key-typestringAnahtar algoritması: secp256k1 (varsayılan) veya eth_secp256k1
--coin-typeuint32HD coin türü (varsayılan 118)
--recoverboolAnahtarı anımsatıcıdan (mnemonic) kurtar
--multisigstringÇoklu imza için virgülle ayrılmış anahtar listesi
--multisig-thresholduintGereken minimum imza sayısı

Tüm Anahtarları Listeleme​

qorechaind keys list --keyring-backend <backend>

Anahtar Ayrıntılarını Gösterme​

qorechaind keys show <name> [flags]
BayrakTürAçıklama
--bechstringÇıktı formatı: acc, val, cons
--addressboolYalnızca adresi göster
--pubkeyboolYalnızca açık anahtarı göster

Bir Anahtarı Silme​

qorechaind keys delete <name> --keyring-backend <backend>

Bir Anahtarı Dışa Aktarma (Zırh-Şifreli)​

qorechaind keys export <name>

Bir Anahtarı İçe Aktarma​

qorechaind keys import <name> <keyfile>

genesis​

Genesis dosyasını yönetin.

Bir Genesis Hesabı Ekleme​

qorechaind genesis add-genesis-account <address> <coins> [flags]
BayrakTürAçıklama
--vesting-amountstringHak ediş (vesting) miktarı
--vesting-start-timeintHak ediş başlangıç zamanı (Unix zaman damgası)
--vesting-end-timeintHak ediş bitiş zamanı (Unix zaman damgası)

Bir Genesis İşlemi Oluşturma​

qorechaind genesis gentx <key-name> <stake-amount> [flags]
BayrakTürAçıklama
--chain-idstringZincir tanımlayıcısı
--monikerstringDoğrulayıcı takma adı
--commission-ratestringBaşlangıç komisyon oranı
--commission-max-ratestringMaksimum komisyon oranı

Genesis İşlemlerini Toplama​

qorechaind genesis collect-gentxs

Diğer genesis alt komutları: bulk-add-genesis-account ve migrate.

Genesis Dosyasını Doğrulama​

qorechaind genesis validate

Uzlaşma Motoru​

Bu alt komutlar, QoreChain Uzlaşma Motoru katmanıyla etkileşime girer.

Doğrulayıcı Anahtarını Gösterme​

qorechaind comet show-validator

Uzlaşma açık anahtarını JSON formatında verir. Doğrulayıcı kimliğini doğrulamak için kullanılır.

Düğüm Kimliğini Gösterme​

qorechaind comet show-node-id

P2P düğüm tanımlayıcısını (onaltılık kodlanmış) verir. Kalıcı eş (peer) yapılandırması için kullanılır.


export​

Mevcut zincir durumunu JSON genesis dosyası olarak dışa aktarın. Zincir yükseltmeleri veya anlık görüntüler için kullanışlıdır.

qorechaind export [flags]
BayrakTürAçıklama
--for-zero-heightboolYükseklik 0'da yeniden başlatma için dışa aktarmayı hazırla
--heightintDurumu belirli bir blok yüksekliğinde dışa aktar
--homestringDüğüm ana dizini
--output-documentstringDışa aktarımı STDOUT yerine bu dosyaya yaz
--modules-to-exportstringsDışa aktarılacak modüllerin virgülle ayrılmış listesi (varsayılan: tümü)
--jail-allowed-addrsstringsHapisten çıkarılacak hapisteki doğrulayıcıların operatör adresleri

rollback​

Zincir durumunu bir blok geri alın. Bir uzlaşma hatasından kurtulmak için kullanışlıdır.

qorechaind rollback [flags]
BayrakTürAçıklama
--hardboolSon bloğu blok deposundan da kaldır
--homestringDüğüm ana dizini

Bu komut hem uygulama durumunu hem de uzlaşma durumunu geri alır. Geri alınamayacağı için dikkatli kullanın.