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.
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
| Bayrak | Tür | Açıklama |
|---|---|---|
--chain-id | string | Zincir tanımlayıcısı (her zaman belirtin; belirtilmezse rastgele bir tanesi oluşturulur) |
--home | string | Düğüm ana dizini (varsayılan: ~/.qorechaind) |
--overwrite | bool | Mevcut genesis.json dosyasının üzerine yaz |
--recover | bool | Yeni 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]
| Bayrak | Tür | Açıklama |
|---|---|---|
--home | string | Düğüm ana dizini |
--minimum-gas-prices | string | Bu düğümün kabul ettiği minimum gaz fiyatı. Ağ tabanı 0.1uqor'dur; en az bu değeri ayarlayın |
--pruning | string | Budama stratejisi: default, nothing, everything, custom (--pruning-keep-recent ve --pruning-interval ile) |
--halt-height | uint | Düğümü bu blok yüksekliğinde durdur |
--halt-time | uint | Düğümü bu Unix zaman damgasında durdur |
--log_level | string | Günlük ayrıntı düzeyi: info, debug, warn, error |
--trace | bool | Hatalarda 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.sha256ile 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ıysa0değ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
| Bayrak | Tür | Açıklama |
|---|---|---|
--node | string | RPC 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]
| Bayrak | Tür | Açıklama |
|---|---|---|
--keyring-backend | string | Arka uç: os, file, kwallet, pass, test, memory |
--key-type | string | Anahtar algoritması: secp256k1 (varsayılan) veya eth_secp256k1 |
--coin-type | uint32 | HD coin türü (varsayılan 118) |
--recover | bool | Anahtarı anımsatıcıdan (mnemonic) kurtar |
--multisig | string | Çoklu imza için virgülle ayrılmış anahtar listesi |
--multisig-threshold | uint | Gereken 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]
| Bayrak | Tür | Açıklama |
|---|---|---|
--bech | string | Çıktı formatı: acc, val, cons |
--address | bool | Yalnızca adresi göster |
--pubkey | bool | Yalnı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]
| Bayrak | Tür | Açıklama |
|---|---|---|
--vesting-amount | string | Hak ediş (vesting) miktarı |
--vesting-start-time | int | Hak ediş başlangıç zamanı (Unix zaman damgası) |
--vesting-end-time | int | Hak ediş bitiş zamanı (Unix zaman damgası) |
Bir Genesis İşlemi Oluşturma
qorechaind genesis gentx <key-name> <stake-amount> [flags]
| Bayrak | Tür | Açıklama |
|---|---|---|
--chain-id | string | Zincir tanımlayıcısı |
--moniker | string | Doğrulayıcı takma adı |
--commission-rate | string | Başlangıç komisyon oranı |
--commission-max-rate | string | Maksimum 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]
| Bayrak | Tür | Açıklama |
|---|---|---|
--for-zero-height | bool | Yükseklik 0'da yeniden başlatma için dışa aktarmayı hazırla |
--height | int | Durumu belirli bir blok yüksekliğinde dışa aktar |
--home | string | Düğüm ana dizini |
--output-document | string | Dışa aktarımı STDOUT yerine bu dosyaya yaz |
--modules-to-export | strings | Dışa aktarılacak modüllerin virgülle ayrılmış listesi (varsayılan: tümü) |
--jail-allowed-addrs | strings | Hapisten çı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]
| Bayrak | Tür | Açıklama |
|---|---|---|
--hard | bool | Son bloğu blok deposundan da kaldır |
--home | string | Düğüm ana dizini |
Bu komut hem uygulama durumunu hem de uzlaşma durumunu geri alır. Geri alınamayacağı için dikkatli kullanın.