Ana içeriğe geç

REST / gRPC Uç Noktaları

QoreChain, programatik erişim için üç temel arayüz sunar:

ArayüzVarsayılan PortProtokolAçıklama
REST1317HTTP/1.1REST ağ geçidi (Cosmos SDK API sunucusu)
gRPC9090HTTP/2Protobuf ile kodlanmış gRPC servisi
RPC26657HTTP + WSQoreChain Consensus Engine RPC

Tüm REST uç noktaları JSON döndürür. gRPC uç noktaları Protocol Buffers kullanır ve herhangi bir gRPC istemcisiyle tüketilebilir. RPC arayüzü, konsensüs düzeyinde sorgular ve işlem yayını sağlar.

not

Bu arayüzler hem qorechain-vladi mainnet'inde (7 Haziran 2026'dan beri canlı) hem de qorechain-diana testnet'inde kullanılabilir. Testnet v3.2.8 düğüm sürümünü çalıştırır (testnet yönetişimi tarafından 12 Kasım 2026'da 9.929.500 yüksekliğinde uygulandı; bundan önce v3.2.7, 6 Kasım 2026'da 9.594.600 yüksekliğinde), mainnet ise v3.2.7 çalıştırır, yani bir sürüm geridedir. Mainnet v3.2.7'yi 12 Kasım 2026'da 4.164.600 yüksekliğinde uyguladı (yönetişim önerisi 16; bundan önce v3.2.6, 4 Kasım 2026'da 4.020.000 yüksekliğinde, yönetişim önerisi 15, v3.2.5, 29 Ekim 2026'da 3.906.833 yüksekliğinde, öneri 14, ve v3.2.4, 23 Ekim 2026'da 3.742.566 yüksekliğinde uygulanmıştı); testnet v3.2.5'i 26 Ekim 2026'da 8.890.800 yüksekliğinde, v3.2.6'yı 27 Ekim 2026'da 8.970.638 yüksekliğinde, v3.2.7'yi 9.594.600 yüksekliğinde ve v3.2.8'i 9.929.500 yüksekliğinde uyguladı. Mainnet v3.2.8'i henüz uygulamadı. Bir sürümün eklediği rotalar ve alanlar, bir ağda yalnızca o ağ sürümü uyguladıktan sonra görünür. Aşağıda 4 Kasım 2026 ile işaretlenen rota kontrolleri, v3.2.6 yükseltmesinden sonra genel mainnet ana makinesine karşı yapıldı; v3.2.7 ile işaretlenen rotalar 7 Kasım 2026'da genel testnet ana makinesinde, mainnet v3.2.7'yi uyguladıktan sonra 12 Kasım 2026'da ise genel mainnet ana makinesinde kontrol edildi (hepsi yönlendirilmiş; bkz. her rotadaki notlar). Aşağıdaki temel URL'ler yerel olarak çalışan bir düğüm varsayar. Genel barındırılan uç noktalar https://api.qore.host / https://api-testnet.qore.host (REST) ve https://rpc.qore.host / https://rpc-testnet.qore.host (RPC) olup Ağlar sayfasında listelenmiştir. Genel bir gRPC uç noktası yoktur: grpc.qore.host ve grpc-testnet.qore.host ana makine adları mevcut değildir; gRPC'ye ihtiyacınız varsa kendi düğümünüzü çalıştırın.

Temel URL'ler​

REST: http://localhost:1317
gRPC: localhost:9090
RPC: http://localhost:26657

Hangi rotalar mevcut​

QoreChain'e özgü modüller REST üzerinden /qorechain/<module>/v1/... öneki altında sunulur ve yalnızca aşağıda listelenen modüllerin REST rotaları vardır. Diğer modüllere yalnızca gRPC ile erişilebilir (Yalnızca gRPC modülleri bölümüne bakın). Standart Cosmos SDK, EVM ve QoreChain Native rotaları Standart rotalar bölümünde listelenmiştir.

Var olmayan bir rota HTTP 501 ve {"code":12,"message":"Not Implemented"} ile yanıt verir. Bu, rotanın sunulmadığı anlamına gelir; sorgunun boş döndüğü anlamına gelmez. /qorechain/ öneki olmayan kısaltılmış yollar (örneğin /bridge/v1/chains veya /pqc/v1/params) sunulmaz. Var olan bir rotada bilinmeyen bir kayıt HTTP 404 ve {"code":5,"message":"... not found"} döndürür.

Aşağıdaki örnekler genel mainnet ana makinesini kullanır; testnet için bunu https://api-testnet.qore.host ile değiştirin. Örneklerdeki değerler 20 ile 27 Ekim 2026 arasında canlı ağlardan okunmuştur ve zamanla değişir; bunları yalnızca yanıtın biçimi için kullanın. v3.2.4 sürümü birkaç rota ve alan ekledi. Bunlar aşağıda v3.2.4 ile işaretlenmiştir: testnet bunları 19 Ekim 2026'dan, mainnet ise 23 Ekim 2026'dan beri sunar. v3.2.5 sürümü (mainnet'te 29 Ekim 2026'dan, testnet'te 26 Ekim'den beri) cross-VM parametre ve mesaj rotalarını ile yerel anahtar kayıt defteri rotasını ekledi; bunlar v3.2.5 ile işaretlenmiştir. v3.2.6 sürümü (testnet'te 27 Ekim 2026'dan, mainnet'te 4 Kasım 2026'dan beri) daha fazlasını ekledi ve bunlar v3.2.6 ile işaretlenmiştir: mainnet ana makinesi bunlara 4 Kasım 2026'da 200 ile yanıt verdi (geçerli olduğu yerde bir istisna belirtilmiştir). Daha eski bir sürümde kalmış bir düğüm yeni bir rotaya 501 ile yanıt verir. v3.2.7 sürümü (testnet'te 6 Kasım 2026'dan, mainnet'te 12 Kasım 2026'dan beri) v3.2.7 ile işaretlenen rotaları ekledi: PQC multisig ve textual imzalama, staking APR ve SVM küme kimliği.

PQC Modülü​

MetotUç NoktaAçıklama
GET/qorechain/pqc/v1/account/{address}Bir hesabın kuantum sonrası anahtar kaydı (found, anahtar türü, algoritma)
GET/qorechain/pqc/v1/evm_window/{address}Hesabın EVM şeridi yetkilendirme penceresi ve bunun kalan kısmı
GET/qorechain/pqc/v1/evm_limitsYürürlükteki EVM gas limitleri (işlem başına 30.000.000); yalnızca test ağında, v3.2.8'den itibaren; mainnet v3.2.8'i uygulamadı ve 501 yanıtı verir (12 Kasım 2026'da kontrol edildi)
GET/qorechain/pqc/v1/evm_delegation_consent/{address}Hesabın EIP-7702 delegasyon onayı, geçerli delegasyonu ve EVM nonce değeri (v3.2.2'den beri)
GET/qorechain/pqc/v1/protocol_featuresv3.2.4 (test ağında 19 Ekim 2026'dan beri; ana ağda 23 Ekim 2026'dan beri; eski bir düğümde 501). İkili dosyanın bildiği her protokol özelliği; enabled, known ve staged bayraklarıyla
GET/qorechain/pqc/v1/kem/{address}v3.2.5 (her iki ağda: ana ağda 29 Ekim 2026'dan beri, test ağında 26 Ekim'den beri; eski bir düğümde 501). Bir adres için yerel anahtar kayıt defterinde kayıtlı ML-KEM şifreleme anahtarı: hiçbiri kayıtlı değilse {"found":false,"key":null}
GET/qorechain/pqc/v1/paramsv3.2.6 (testnet'te 27 Ekim 2026'dan, mainnet'te 4 Kasım 2026'dan beri; daha eski bir düğümde 501). Modül parametreleri
GET/qorechain/pqc/v1/multisig/{address}v3.2.7 (testnet'te 6 Kasım 2026'dan, mainnet'te 12 Kasım 2026'dan beri; daha eski bir düğümde 501). Bir adresin hibrit kuantum sonrası multisig kaydı: hiç kayıtlı yoksa {"found":false,"multisig":null}
POST/qorechain/pqc/v1/textual_sign_docv3.2.7 (testnet'te 6 Kasım 2026'dan, mainnet'te 12 Kasım 2026'dan beri; daha eski bir düğümde 501; GET da 501 yanıtı verir). Bir web cüzdanının göstermesi ve imzalaması için bir işlemin SIGN_MODE_TEXTUAL belgesini oluşturur (aşağıya bakın)

Yol bölümünün tekil account olduğuna dikkat edin. /qorechain/pqc/v1/stats rotası yoktur (qorechaind query pqc stats kullanın). /qorechain/pqc/v1/params v3.2.6'dan itibaren sunulur ve 4 Kasım 2026'da her iki ağda da 200 yanıtı verdi (mainnet'te: pqc_primary true, allow_classical_fallback false, min_security_level 5, default_signature_algo_name dilithium5, hybrid_signature_mode_name required). v3.2.6'dan eski bir düğümde bunun yerine qorechaind query pqc params kullanın.

PQC multisig ve textual imzalama (v3.2.7)​

v3.2.7'den itibaren (testnet'te 6 Kasım 2026'dan, mainnet'te 12 Kasım 2026'dan beri; mainnet'te pqc-multisig protokol özelliği 4.164.600 yüksekliğinden itibaren etkindir) bir hesap, hibrit kuantum sonrası k-of-n multisig'e sahip olabilir. Mesaj /qorechain.pqc.v1.MsgRegisterPQCMultisig'dir; kuantum sonrası küme, hesabın mevcut klasik multisig'inin üyelerini ve anahtarlarını izler. GET /qorechain/pqc/v1/multisig/{address} kaydı döndürür. 7 Kasım 2026'da multisig'i olmayan bir hesap için {"found":false,"multisig":null} ile 200 yanıtı verdi (rota geçerli bir qor1... adresi ister; hatalı biçimli bir adres 400 yanıtı verir). Mainnet'te rota 12 Kasım 2026'dan beri sunulur (geçerli olmayan bir adresle yapılan istek 400 yanıtı verdi; bu, rotanın bağlı olduğunu gösterir). Kayıtlı bir multisig'in kayıt alanları burada okunmadı, çünkü testnet'te henüz kayıtlı multisig yok.

POST /qorechain/pqc/v1/textual_sign_doc, SIGN_MODE_TEXTUAL ile imzalayan donanım ve web cüzdanlarına hizmet eder. JSON gövdesi tx_json (imzasız işlem, JSON dizesi olarak) veya tx_bytes (base64) ile birlikte chain_id, account_number, sequence ve public_key (@type ve key içeren bir Any) taşır. Yanıt, sign_bytes (base64, imzalanacak belge) ve bir cihazın gösterdiği satırların listesi olan screens (title, content, indent, expert) içerir. Mainnet'te boş bir JSON gövdesi 12 Kasım 2026'da 400 yanıtı verdi, yani rota orada bağlıdır. İşlemi olmayan bir gövde 400 (tx_bytes or tx_json is required) yanıtı verir; mesajı olmayan veya 32'den fazla mesaj içeren bir işlem reddedilir. Komut satırında qorechaind tx pqc cosign, v3.2.7'den itibaren textual imza modunu destekler (bkz. İşlem Komutları).

curl -s https://api.qore.host/qorechain/pqc/v1/multisig/qor1... # veya api-testnet.qore.host
curl -s -X POST https://api.qore.host/qorechain/pqc/v1/textual_sign_doc \
-H 'content-type: application/json' -d @request.json

Kuantum sonrası bir imza denetimi için alınan gas, v3.2.7'den itibaren (testnet'te 6 Kasım 2026'dan, mainnet'te 12 Kasım 2026'dan beri, pqc-verify-gas-calibrated anahtarı) doğrulama başına sabit 2.000 gas'tır; bkz. Sürüm Geçmişi.

curl -s https://api.qore.host/qorechain/pqc/v1/account/qor1...
{
"found": true,
"account": {
"address": "qor1...",
"public_key": "<base64 ML-DSA-87 public key>",
"algorithm_id": 1,
"algorithm_name": "dilithium5",
"ecdsa_pubkey": null,
"key_type": "hybrid",
"created_at_height": "209015",
"migration_public_key": null,
"migration_algorithm_id": 0,
"classical_key_source": "auth_account"
}
}

classical_key_source, ecdsa_pubkey değerinin nereden geldiğini söyler: stored (kayıt sırasında verilen anahtar), auth_account (hiçbir şey saklanmadı, dolayısıyla hesabın kendi zincir üstü genel anahtarıdır) veya none. v3.2.4'ten itibaren (test ağında 19 Ekim 2026'dan beri; ana ağda 23 Ekim 2026'dan beri) kayıt ayrıca "possession_proven": false alanını da taşır; bu alan, bir anahtar doğrulanmış bir sahiplik kanıtıyla kaydedildiğinde true olur; daha eski bir sürümdeki düğüm bu alanı raporlamaz.

Kayıtlı anahtarı olmayan bir hesap {"found": false, "account": null} döndürür. Bir hesabın gönderim yapabilmesi için önce anahtar kaydetmesi gerekip gerekmediğine karar vermek için found alanını kullanın.

curl -s https://api.qore.host/qorechain/pqc/v1/evm_window/qor1...
{
"found": false,
"live": false,
"opened_height": "0",
"expiry_height": "0",
"max_txs": "0",
"used_txs": "0",
"max_value": "",
"used_value": "",
"remaining_blocks": "0",
"remaining_txs": "0",
"remaining_value": "",
"native_only": false,
"allowed_targets": []
}

Bu rota, penceresi olmayan bir adres için asla hata vermez; found: false döndürür. v3.2.0'dan itibaren EVM şeridi, bir işlemi yalnızca kayıtlı bir PQC anahtarına ve açık bir pencereye sahip bir hesaptan kabul eder. live, pencere geçerli yükseklikte en az bir işlem daha kabul ettiği sürece true olur. remaining_blocks, remaining_txs ve remaining_value hangi sınırın tükenmeye en yakın olduğunu gösterir; değerler dize olarak döndürülen uqor tam sayılarıdır. v3.2.3'ten itibaren bir pencere kapsam taşıyabilir: native_only (yalnızca düz QOR transferleri) ve allowed_targets (yalnızca listelenen alıcılar; hangi kontratlara ve token'lara dokunulabileceğini sınırlar, ne kadar olduğunu değil). EVM şeridinin nasıl çalıştığı için EVM Geliştirme sayfasına bakın.

curl -s https://api.qore.host/qorechain/pqc/v1/evm_delegation_consent/qor1...
{
"found": false,
"live": false,
"delegate": "",
"granted_height": "0",
"expiry_height": "0",
"current_delegate": "",
"nonce": "0"
}

Bir hesabın EIP-7702 delegasyonu yalnızca hesabın kendi kuantum sonrası onayıyla (MsgAuthorizeEVMDelegation) yürürlüğe girer. found ve live, delegate için kaydedilmiş ve hâlâ kullanılabilir bir onayı raporlar; current_delegate hesabın şu anda ayarladığı delegasyondur ve nonce hesabın EVM nonce değeridir.

Bridge Modülü​

Bridge modülünün salt okunur durumu REST üzerinden /qorechain/bridge/v1/... altında sunulur (zincir sürümü v3.1.77'den itibaren gerçek zincir üstü JSON sunar). Bridge config çıktısı örneğin min_validators=10 ve attestation_threshold=7 değerlerini raporlar.

MetotUç NoktaAçıklama
GET/qorechain/bridge/v1/configGeçerli bridge modülü yapılandırması
GET/qorechain/bridge/v1/chainsKayıtlı tüm bridge zincirlerini listeler
GET/qorechain/bridge/v1/chains/{chain_id}Köprülenmiş belirli bir zincirin ayrıntıları
GET/qorechain/bridge/v1/validatorsKayıtlı bridge doğrulayıcılarını listeler
GET/qorechain/bridge/v1/validators/{address}Belirli bir bridge doğrulayıcısının ayrıntıları
GET/qorechain/bridge/v1/operationsBridge operasyonlarını listeler
GET/qorechain/bridge/v1/operations/{id}Belirli bir bridge operasyonunun ayrıntıları
curl -s https://api.qore.host/qorechain/bridge/v1/config
{
"config": {
"min_validators": 10,
"attestation_threshold": 7,
"challenge_period_secs": "86400",
"large_transfer_threshold": "100000000000",
"enabled": true
}
}

chains/{chain_id}, {"chain": {"chain_id": "ethereum", "name": "Ethereum", "chain_type": "evm", "bridge_contract": "0x000…0", "status": "pending", "min_confirmations": 12, ...}} gibi tek bir kayıt döndürür.

Bridge henüz canlı değil

Yapılandırılmış 37 bridge zincirinin tamamı her iki ağda da "status": "pending" raporlar; validators ve operations boş listelerdir. Bu rotalar modülün yapılandırmasını gösterir; bugün varlıkların köprülenebileceği anlamına gelmez. Bridge Mimarisi sayfasına bakın.

Multilayer Modülü​

Multilayer modülünün tam sorgu servisi REST üzerinden /qorechain/multilayer/v1/... altında sunulur (zincir sürümü v3.1.80'den itibaren); buna iki durum çıpası (state-anchor) okuma sorgusu da dahildir: anchor/{layer_id} bir katman için en son uzlaşı (settlement) çıpasını, anchors/{layer_id} ise o katmanın çıpa geçmişini döndürür. Her çıpa, kanonik alanları üzerinde bir ML-DSA-87 (Dilithium-5) imzası taşır; böylece bir istemci bir çıpayı çekip bağımsız olarak doğrulayabilir — bu, Rollup Development Kit'in uzlaşı makbuzlarının zincir üstü temelidir.

MetotUç NoktaAçıklama
GET/qorechain/multilayer/v1/paramsGeçerli Multilayer modülü parametreleri
GET/qorechain/multilayer/v1/layersKayıtlı tüm katmanları listeler
GET/qorechain/multilayer/v1/layers/{layer_id}Belirli bir katmanın ayrıntıları
GET/qorechain/multilayer/v1/anchor/{layer_id}Bir katman için en son durum çıpası
GET/qorechain/multilayer/v1/anchors/{layer_id}Bir katman için durum çıpası geçmişi
GET/qorechain/multilayer/v1/routing-statsKatmanlar arası işlem yönlendirme istatistikleri

Bir StateAnchorView şunları içerir: layer_id, layer_height, state_root, validator_set_hash, main_chain_height, anchored_at, pqc_aggregate_signature, transaction_count ve compressed_state_proof. v3.2.2'den itibaren imzalanan mesaj v2 çıpa mesajıdır: qorechain-multilayer-anchor-v2 alan etiketi, ardından zincir kimliği, katman kimliği, katman yüksekliği, durum kökü, doğrulayıcı kümesi özeti, işlem sayısı ve sıkıştırılmış durum kanıtı; değişken uzunluklu her alanın önüne 8 baytlık big-endian uzunluğu eklenir (önceki v1 mesajında zincir kimliği ve uzunluk önekleri yoktu, dolayısıyla bir imza her zincirde geçerliydi). Mesaj, katman oluşturucusunun kayıtlı PQC anahtarına karşı doğrulanır. qorechaind query rdk anchor-sign-bytes bir rollup batch'i için baytları yazdırır. Çıpası olmayan bir katman, anchor/{layer_id} rotasından HTTP 404 (no anchor for layer ...), anchors/{layer_id} rotasından ise boş bir liste ({"anchors": []}) döndürür.

curl -s https://api.qore.host/qorechain/multilayer/v1/params
{
"params": {
"max_sidechains": "10",
"max_paychains": "50",
"min_anchor_interval": "100",
"max_anchor_interval": "1000",
"default_challenge_period": "86400",
"min_sidechain_stake": "1000000000",
"min_paychain_stake": "100000000",
"routing_enabled": true,
"routing_confidence_threshold": "0.6",
"cross_layer_fee_bundling": true
}
}

Bu yazının hazırlandığı sırada layers her iki ağda da boş bir listedir. Örnek, ana ağ yanıtıdır; test ağında max_sidechains 64'tür (builder etkinliği için 16 numaralı yönetişim önerisiyle yükseltildi, 25 Ekim 2026'da kabul edildi).

Burn Modülü​

Burn modülünün salt okunur durumu REST üzerinden /qorechain/burn/v1/... altında sunulur. Burn params çıktısı örneğin gas_burn_rate=0.30 değerini içerir.

MetotUç NoktaAçıklama
GET/qorechain/burn/v1/paramsGeçerli Burn modülü parametreleri
GET/qorechain/burn/v1/statsKaynağa göre ayrıştırılmış kümülatif yakım toplamı
GET/qorechain/burn/v1/recordsSon yakım kayıtlarını listeler
GET/qorechain/burn/v1/milestoneYakım kilometre taşı ilerlemesi (kümülatif işlem sayısı)
GET/qorechain/burn/v1/stranded_rewardsAyrılan ve henüz yönetişim tarafından serbest bırakılmamış staker payı
curl -s https://api.qore.host/qorechain/burn/v1/stats
{
"stats": {
"total_burned": "31574710367921",
"burns_by_source": {
"gas_fee": "31574710282421",
"failed_tx": "85500",
"milestone": "0",
"amm": "0",
"xqore_penalty": "0"
},
"last_burn_height": "3666968"
}
}

Gerçek yanıt her yakım kaynağını listeler (ai_service, amm, auto_buyback, bridge_fee, contract_create, failed_tx, gas_fee, milestone, rollup_create, tge, treasury_buyback, xqore_penalty ve v3.2.4'ten itibaren staking_tier_penalty, yani bir staking-tier kilidinin erken açılma cezası, yakılır); örnek kısaltılmıştır. Tutarlar uqor cinsindendir. failed_tx, başarısız işlem yakımının fiilen tahsil edilen ücrete uygulanmaya başladığı v3.2.2 yükseltmesinden beri sıfırdan farklıdır. v3.2.3'ten itibaren eski yakım başına records kayıtları budanır; dolayısıyla records tüm geçmiş değil, yakın bir penceredir; stats içindeki toplamlar ise kümülatiftir.

curl -s https://api.qore.host/qorechain/burn/v1/stranded_rewards
{ "reserved": "0", "released": "10500542706858", "initialized": true, "snapshot_height": "2981742" }

reserved serbest bırakılmak üzere kalan miktardır, released yönetişimin şimdiye kadar taşıdığı miktardır, snapshot_height ise ayrılan rezervi kaydeden v3.2.0 yükseltmesinin yüksekliğidir. Yukarıdaki değerler 23 Ekim 2026'da okunanlardır: yönetişim ilk miktarı (6.693.045,921330 QOR) 19 Ekim 2026'da serbest bıraktı, v3.2.3 yükseltmesi kalan rezervi kendi yüksekliğinde yeniden hesapladı (3.807.496,785528 QOR) ve yönetişim önerisi 12 bu miktarı serbest bıraktı (kabul edildi, oylama 21 Ekim 2026'da sona erdi); dolayısıyla rezerv artık boştur ve released toplamı 10.500.542,706858 QOR'dur. Canlı değerleri okuyun. Tokenomi sayfasına bakın.

Abstract Account Modülü​

Abstract-account sorgu servisi REST üzerinden /qorechain/abstractaccount/v1/... altında sunulur (zincir sürümü v3.1.85'ten itibaren); buna, authenticator kapsamlarını sabit kodlama olmadan doğrulamak için kullanılan izin şeması da dahildir.

MetotUç NoktaAçıklama
GET/qorechain/abstractaccount/v1/configModül yapılandırması (özellik denetimi: enabled)
GET/qorechain/abstractaccount/v1/accountsAbstract hesapları listeler
GET/qorechain/abstractaccount/v1/accounts/{address}Bir adres için abstract-account durumu (yoksa 404)
GET/qorechain/abstractaccount/v1/permission_schemaschema_version, permissions, msg_permissions, key_management_msgs, lane_rules
GET/qorechain/abstractaccount/v1/auth_nonce/{address}/{pubkey_hex}v3.2.4 (test ağında 19 Ekim 2026'dan beri; ana ağda 23 Ekim 2026'dan beri; eski bir düğümde 501). Bağlı bir authenticator anahtarının sıradaki imzalaması gereken sıra numarası (nonce, linked)
curl -s https://api.qore.host/qorechain/abstractaccount/v1/config
{ "config": { "enabled": false, "max_session_keys": 10, "max_spending_rules": 5, "default_session_ttl": "86400" } }
Ana ağda devre dışı, test ağında etkin

Yukarıdaki örnek ana ağ yanıtıdır: orada enabled false'tur (ve accounts boş bir listedir), dolayısıyla bağlı cüzdan harcaması gibi abstract-account özellikleri ana ağda kullanılamaz. Test ağında enabled, 18 numaralı yönetişim önerisinden beri (27 Ekim 2026'da kabul edildi) true'dur ve accounts şimdiye kadar oluşturulan hesapları listeler (27 Ekim 2026'da kontrol edildi). Bu modüle güvenmeden önce özellik denetimi olarak config.enabled alanını kullanın. Hesap Soyutlama sayfasına bakın.

AMM Modülü​

MetotUç NoktaAçıklama
GET/qorechain/amm/v1/paramsGeçerli AMM parametreleri (baz puan cinsinden ücretler, limitler)
GET/qorechain/amm/v1/poolsHavuzları listeler
GET/qorechain/amm/v1/pools/{pool_id}Tek bir havuz (bilinmiyorsa 404)
GET/qorechain/amm/v1/pools/{pool_id}/lp/{address}Bir adresin bir havuzdaki LP token bakiyesi
GET/qorechain/amm/v1/pool_by_denoms?denom_a=&denom_b=Bir denom çifti için havuzu bulur (yoksa 404)
GET/qorechain/amm/v1/quote/exact_in?pool_id=&denom_in=&amount_in=Fiyat teklifi: tam bir girdi için çıktı
GET/qorechain/amm/v1/quote/exact_out?pool_id=&denom_out=&amount_out=Fiyat teklifi: tam bir çıktı için gereken girdi
curl -s https://api.qore.host/qorechain/amm/v1/params
{
"params": {
"swap_fee_bps": 30,
"protocol_fee_bps": 10,
"min_liquidity": "1000",
"max_pools_per_creator": 50,
"lp_token_decimals": 6,
"pool_creation_fee": "100000000",
"max_swap_impact_bps": 500,
"enabled": true
}
}

Yedi AMM rotasının tümü her iki ağda da yanıt verir (27 Ekim 2026'da kontrol edildi). Bu yazının hazırlandığı sırada her iki ağda da havuz yoktur ({"pools": []}). Hiçbir şeyle eşleşmeyen girdiler için yanıtlar: bilinmeyen bir kimlikle pools/{pool_id} HTTP 404 döndürür ({"code":5,"message":"pool 1 not found"}); çift için havuz olmayan pool_by_denoms 404 döndürür (no pool for uqor/foo); bilinmeyen bir havuz için fiyat teklifi HTTP 400 ve {"code":3,"message":"pool not found"} döndürür; LP pozisyonu olmayan bir adres için pools/{pool_id}/lp/{address} {"balance":"0"} döndürür (adres geçerli bir qor1 bech32 adresi olmalıdır, aksi halde 400). İki fiyat teklifi rotası ve pool_by_denoms girdilerini sorgu dizesinden okur, bu yüzden parametre gerektirirler: amount_in / amount_out olmadan 400 ile yanıt verirler (invalid amount_in / invalid amount_out).

Testnet'te bir havuzun ihtiyaç duyduğu ikinci birim kullanılabilir: yönetişimle kaydedilmiş üç test token'ı, bkz. Testnet test token'ları (Fest). Mainnet'te bunun bir karşılığı yoktur; tek bank birimi uqor'dur.

Lisans Modülü​

MetotUç NoktaAçıklama
GET/qorechain/license/v1/check/{grantee}/{feature_id}grantee adresinin özellik için etkin bir izne sahip olup olmadığı (yoksa 404)
GET/qorechain/license/v1/holders/{feature_id}Bir özelliğe ait tüm izinler
GET/qorechain/license/v1/list/{grantee}Bir adresin sahip olduğu tüm izinler

Bir izin (LicenseView) şu alanlara sahiptir: grantee, feature_id, expires_at, granted_at, granted_by, suspended ve metadata. check ayrıca active döndürür. Eşleşmesi olmayan bir list veya holders sorgusu {"licenses": []} döndürür; izni olmayan bir adres için check, HTTP 404 ve {"code":5,"message":"no license for <grantee>/<feature_id>"} döndürür.

curl -s https://api.qore.host/qorechain/license/v1/holders/lightnode_operator
{
"licenses": [
{
"grantee": "qor1...",
"feature_id": "lightnode_operator",
"expires_at": "0",
"granted_at": "3536305",
"granted_by": "qor1...",
"suspended": false,
"metadata": "",
"active": true
}
]
}

expires_at: "0" iznin sona ermediği anlamına gelir. v3.2.3'ten itibaren yönetişim, bu lisansları veren lisans otoritesini değiştirebilir (MsgUpdateAuthority); daha önce verilmiş izinler yerinde kalır.

Light Node Modülü​

MetotUç NoktaAçıklama
GET/qorechain/lightnode/v1/paramsKayıt, heartbeat ve ödül parametreleri
GET/qorechain/lightnode/v1/statstotal_registered, total_active, total_rewards, last_reward_height
GET/qorechain/lightnode/v1/nodesKayıtlı hafif düğümleri listeler
GET/qorechain/lightnode/v1/node/{address}Tek bir düğüm (kayıtlı değilse {"node": null, "found": false})
GET/qorechain/lightnode/v1/rewards/{address}Bir operatör adresi için biriken ödüller (accumulated_rewards)
GET/qorechain/lightnode/v1/reward_poolÖdül havuzu muhasebesi (balance, reserved, outstanding, payable, distributable, max_reward_per_block_per_node, max_reward_per_month_per_node, initialized)
curl -s https://api.qore.host/qorechain/lightnode/v1/params
{
"registration_fee": "1000000",
"heartbeat_interval": "1000",
"min_delegated_stake": "1000000000",
"reward_share": "0.030000000000000000",
"min_uptime_for_rewards": "0.800000000000000000",
"max_light_nodes": "10000",
"heartbeat_grace_period": "100"
}
curl -s https://api.qore.host/qorechain/lightnode/v1/reward_pool
{
"balance": "5645408555",
"reserved": "5645276228",
"outstanding": "130077",
"payable": "0",
"max_reward_per_block_per_node": "1713",
"distributable": "2250",
"initialized": true,
"max_reward_per_month_per_node": "2000000000",
"monthly_cap_active": true,
"last_distribution_time": "1792775155",
"last_distribution_height": "3744000"
}

reserved, havuzun ayrılmış olan ve yalnızca bir yönetişim oyuyla taşınabilen kısmıdır. Düğüm başına sınırlar uqor cinsindendir: max_reward_per_block_per_node blok başına üst sınırdır ve v3.2.3'ten itibaren max_reward_per_month_per_node (2000000000 uqor = 30 günde 2.000 QOR) aylık üst sınırdır; blok süresine ve çalışma süresine (uptime) göre orantılanır, dolayısıyla artık blokların ne kadar hızlı geldiğine bağlı değildir. Üst sınır, vaat edilen bir miktar değildir. Örnek, yönetişimin önceki rezervi serbest bırakmasından sonra (öneri 8, 19 Ekim 2026) 23 Ekim 2026'da okunan canlı ana ağ yanıtıdır. v3.2.4'ten itibaren (test ağında 19 Ekim 2026'dan beri; ana ağda 23 Ekim 2026'dan beri) yanıt ayrıca monthly_cap_active, last_distribution_time ve last_distribution_height alanlarını içerir ve bir düğümün sınırı kendi kaydıyla başlar.

Kayıt için lisans gerekir

Zincir, etkin bir lightnode_operator lisans izni olmadan bir hafif düğüm kaydını reddeder (holders/lightnode_operator izinleri listeler). 27 Ekim 2026'da stats, hem ana ağda hem de test ağında "total_registered": "1" raporlar. Program durumu için Hafif Düğümler sayfasına bakın.

RDK Modülü​

Rollup Development Kit sorgu servisi REST üzerinden /qorechain/rdk/v1/... altında sunulur (zincir sürümü v3.2.2'den itibaren; v3.2.0 ve v3.2.1'de yalnızca gRPC idi).

MetotUç NoktaAçıklama
GET/qorechain/rdk/v1/paramsModül parametreleri
GET/qorechain/rdk/v1/rollupsRollup'ları listeler
GET/qorechain/rdk/v1/rollup/{rollup_id}Tek bir rollup (bilinmiyorsa 404)
GET/qorechain/rdk/v1/latest_batch/{rollup_id}Rollup'un en son uzlaşı batch'i
GET/qorechain/rdk/v1/batch/{rollup_id}/{batch_index}Tek bir uzlaşı batch'i
GET/qorechain/rdk/v1/batches/{rollup_id}Rollup'un batch'leri indeks sırasıyla (sayfalanmış)
GET/qorechain/rdk/v1/blob/{rollup_id}/{blob_index}Tek bir veri erişilebilirliği (DA) blob kaydı
curl -s https://api.qore.host/qorechain/rdk/v1/params
{
"params": {
"max_rollups": 100,
"min_stake_for_rollup": "10000000000",
"rollup_creation_burn_rate": "0.01",
"default_challenge_window": "604800",
"max_da_blob_size": "2097152",
"blob_retention_blocks": "432000",
"max_batches_per_block": 10
}
}

Yazının hazırlandığı sırada rollups her iki ağda da boş bir listedir; bu nedenle rollup başına rotalar 404 ile yanıt verir (örneğin {"code":5,"message":"rollup foo not found"}). default_challenge_window saniye cinsinden ifade edilir (604800). v3.2.4'ten itibaren yeni gönderilen bir batch'in iyimser itiraz penceresi blok süresiyle ölçülür: test ağında 8.337.253 numaralı yükseklikten (19 Ekim 2026), ana ağda 3.742.566 numaralı yükseklikten (23 Ekim 2026) itibaren. Yükseltmeden önce zincir saniye değerini sabit blok başına 6 saniyeyle bloğa çeviriyordu. Test ağında 17 numaralı yönetişim önerisi (27 Ekim 2026'da kabul edildi), builder etkinliği için default_challenge_window değerini 3600 (bir saat) ve max_rollups değerini 200 olarak belirledi; bu nedenle yukarıdaki örnek (ana ağ) orada test ağından farklıdır; rollups bu yazının hazırlandığı sırada test ağında hâlâ boştur.

v3.2.7 (testnet'te 6 Kasım 2026'dan beri; rdk-zk-verification-key anahtarı mainnet'te 12 Kasım 2026'dan beri açıktır): bir ZK rollup, doğrulama anahtarını MsgSetVerificationKey ile kaydedebilir (ve daha sonra MsgUpdateVerificationKey ile değiştirebilir); anahtarı olmayan bir rollup için ZK batch'i ücret ödenmeden önce reddedilir. Bunlar sorgu değil mesajdır: kayıtlı bir anahtarı okuyan bir REST rotası yoktur (bariz yollar 7 Kasım 2026'da 501 yanıtı verdi) ve testnet'te kayıtlı bir ZK rollup yoktur (rollups boştur; mainnet'te de en son 4 Kasım 2026'da kontrol edildiğinde hiç yoktu), bu yüzden kayıt burada uçtan uca denenmedi. Bkz. Sürüm Geçmişi.

Inflation Modülü​

Emisyon ayarları ve ilerlemesi REST üzerinden /qorechain/inflation/v1/... altında sunulur (zincir sürümü v3.2.2'den itibaren). Bir CLI komutuyla erişilemezler.

MetotUç NoktaAçıklama
GET/qorechain/inflation/v1/paramsEmisyon parametreleri: emission_mode, fixed_epoch_emission, max_total_emission, epoch_length, enabled
GET/qorechain/inflation/v1/epoch_infoİlerleme: current_epoch, block_start, next_epoch_height, total_minted, max_total_emission, remaining_emission
curl -s https://api.qore.host/qorechain/inflation/v1/params
curl -s https://api.qore.host/qorechain/inflation/v1/epoch_info

Ana ağda emission_mode "fixed", fixed_epoch_emission "86000000000" (dönem başına 86.000 QOR), epoch_length "43200" blok ve max_total_emission "590000000000000" değerindedir (590.000.000 QOR, kümülatif tavan). Bunlar 10 numaralı yönetişim önerisiyle belirlendi (19 Ekim 2026'da kabul edildi); yeni sabit miktarı kullanan ilk dönem 3.672.000 numaralı blokta başlar ve epoch_info devam eden dönemi ve şimdiye kadar basılan miktarı gösterir. Yanıttaki schedule listesi özgün schedule moduna aittir; sabit modda bir dönemin ne bastığını açıklamaz. Tüm tutarlar uqor cinsindendir. Test ağı kendi, farklı değerlerini raporlar. v3.2.4'ten itibaren üçüncü bir mod olan target_apy vardır; target_apy_bps alanıyla birlikte gelir (test ağında 19 Ekim 2026'dan beri; ana ağda 23 Ekim 2026'dan beri). Bir ağ buna yalnızca kendi yönetişim oyuyla geçer; dolayısıyla böyle bir oy kabul edilene kadar ana ağ fixed modunda kalır (27 Ekim 2026'da kontrol edildi: hâlâ fixed). Test ağı target_apy moduna kendi yönetişimiyle geçti (14 numaralı öneri, 20 Ekim 2026'da kabul edildi) ve bu yazının hazırlandığı sırada "emission_mode": "target_apy" raporlar; epoch_info, kümülatif tavana zaten ulaşıldığını gösterir (remaining_emission 0).

Gas Abstraction Modülü​

MetotUç NoktaAçıklama
GET/qorechain/gasabstraction/v1/configKabul edilen ücret token'ları, prim, blok başına dönüşüm üst sınırı
GET/qorechain/gasabstraction/v1/conversion_rate?denom=Bir birim ücret token'ının uqor cinsinden değeri ve usable olup olmadığı
GET/qorechain/gasabstraction/v1/floatDönüşüm float'ının adresi, bakiyeleri ve bu bloktaki kullanımı
curl -s https://api.qore.host/qorechain/gasabstraction/v1/config
{
"config": {
"enabled": true,
"native_denom": "uqor",
"accepted_tokens": [
{ "denom": "uqor", "conversion_rate": "1.0", "price_source": "", "rate_expiry_height": "0",
"pool_id": "0", "min_liquidity": "", "max_deviation_bps": 0 }
],
"premium_bps": 300,
"max_tip_multiplier": 3,
"float_min": "0",
"block_conversion_cap": "0"
}
}

Kabul edilenler listesi her iki ağda da yalnızca yerel uqor içerir; dolayısıyla ücretler uqor ile ödenir ve herhangi bir dönüşüm gerçekleşmez. Yönetişim bir token ekler (bir havuz, asgari bir likidite ve zaman ağırlıklı ile spot fiyat arasında azami bir sapma ile); böyle bir token ile ödenen ücret bir QOR float'ı üzerinden dönüştürülür ve bir AMM havuzu aracılığıyla yeniden doldurulur. ?denom= olmadan conversion_rate, 500 (denom is required) ile yanıt verir.

RL Consensus Modülü (v3.2.6)​

v3.2.6'dan itibaren her iki ağda sunulur

rlconsensus modülünün REST ağ geçidi v3.2.6 ile geldi; qorechain-diana testnet'i bunu 27 Ekim 2026'da 8.970.638 yüksekliğinde, mainnet ise 4 Kasım 2026'da 4.020.000 yüksekliğinde uyguladı. 4 Kasım 2026'da aşağıdaki yedi rotanın tamamı hem genel mainnet ana makinesinde hem de testnet'te HTTP 200 ile yanıt verdi; hiçbiri parametre gerektirmez. v3.2.6'dan önce 501 yanıtı veriyorlardı ({"code":12,"message":"Not Implemented"}) ve modüle yalnızca gRPC üzerinden erişilebiliyordu.

MetotUç NoktaAçıklama
GET/qorechain/rlconsensus/v1/agentAjan durumu: mode, current_epoch, total_steps, last_observation_at, last_action_at, circuit_breaker_active, blocks_since_revert
GET/qorechain/rlconsensus/v1/paramsModül parametreleri: gözlem aralığı, ajan modu, adım sınırları, devre kesici penceresi ve eşiği, ödül ağırlıkları, varsayılan blok süresi, gas fiyatı ve doğrulayıcı kümesi boyutu
GET/qorechain/rlconsensus/v1/observationEn son gözlem vektörü (height ve 25 values)
GET/qorechain/rlconsensus/v1/rewardEn son ödül sinyali ve bileşenleri
GET/qorechain/rlconsensus/v1/policySaklanan politika ağı: epoch, updated_at, weight_count (ağırlıkların kendisi döndürülmez)
GET/qorechain/rlconsensus/v1/applied_paramsAjanın uygulanmış olarak tuttuğu değerler: block_time_ms, gas_limit, gas_price_floor, pool_weight_rpos, pool_weight_dpos
GET/qorechain/rlconsensus/v1/last_actionAjanın son adımında önerdiği eylem: height, mode, beş values ve applied
curl -s https://api-testnet.qore.host/qorechain/rlconsensus/v1/agent
curl -s https://api-testnet.qore.host/qorechain/rlconsensus/v1/last_action
{ "mode": "shadow", "current_epoch": "1", "total_steps": "209", "last_observation_at": "8975660",
"last_action_at": "8975660", "circuit_breaker_active": false, "blocks_since_revert": "0" }
{ "height": "8975660", "mode": "shadow", "values": ["-0.334711810000000000", "-0.500000000000000000",
"0.000000000000000000", "0.000000000000000000", "0.000000000000000000"], "applied": false }

Yukarıdaki örnekler testnet'ten alınmıştır. Mainnet'te (4 Kasım 2026'da kontrol edildi) ajan conservative modundadır; current_epoch 0, total_steps 0 ve circuit_breaker_active false değerindedir, policy için weight_count 0 döner (kayıtlı politika yok), last_action boştur (height 0, applied false) ve applied_params varsayılan değerleri taşır. Ajan her observation_interval blokta (10) bir adım atar. shadow modunda bir eylem hesaplar ve hiçbir şeyi uygulamadan kaydeder; bu nedenle applied false olur ve applied_params varsayılan değerlerinde kalır (block_time_ms 5000, gas_price_floor 100, havuz ağırlıkları 0.40 ve 0.35). Testnet'te ajan, 29 numaralı yönetişim önerisiyle (27 Ekim 2026'da kabul edildi) kayıtlı bir politikayla gölge modunda başlatıldı; circuit_breaker_active değeri false'tur. Mainnet ajanı başlatmamıştır. Tutarlar ve değerler dizelerdir. Uygulanan değerler bu sürümde yalnızca bilgilendiricidir: zincir üzerindeki tek okuyucu salt okunur rlConsensusParams precompile'ıdır. Karşılık gelen gRPC yöntemleri AgentStatus, Params, Observation, Reward, Policy, AppliedParams ve LastAction'dır (hizmet qorechain.rlconsensus.v1.Query); CLI komutları Sorgu Komutları sayfasındadır.

Staking Tiers Modülü (v3.2.4)​

v3.2.4'ten itibaren kullanılabilir

Staking-tiers modülü v3.2.4 sürümünün parçasıdır. Bu rotalar test ağında 19 Ekim 2026'dan beri, ana ağda ise 23 Ekim 2026'dan beri sunulur (yönetişim önerisi 13, yükseklik 3.742.566). Daha eski bir sürümdeki düğüm bunlara 501 ile yanıt verir.

MetotUç NoktaAçıklama
GET/qorechain/stakingtier/v1/paramsKilit kademeleri, asgari kilit miktarı, erken kilit açma cezası
GET/qorechain/stakingtier/v1/locks/{holder}Bir sahibin kilitleri, her birinin şu anda biriktirdiği ve talep edilebilecek miktar
GET/qorechain/stakingtier/v1/poolBonus havuzu: bakiye, bekleyen tutar, fazlalık ve son uzlaşı
GET/qorechain/stakingtier/v1/aprv3.2.7 (testnet'te 6 Kasım 2026'dan, mainnet'te 12 Kasım 2026'dan beri; daha eski bir düğümde 501). Temel staking oranı ve kademe bonusları
GET/qorechain/stakingtier/v1/apr/{delegator}v3.2.7 (aynı kullanılabilirlik). Tek bir delegatör için aynısı: hafif düğüm bonus durumu, delegasyonlar ve efektif oran

params, üç kilit süresini (3, 6 ve 12 ay) parametreleriyle ve min_lock_amount ile ("10000000" uqor, 10 QOR) listeler. Kilitler tx stakingtier lock ile oluşturulur (bkz. İşlem Komutları).

APR rotaları (v3.2.7). Mainnet rotası 12 Kasım 2026'da source emission, bonus_enabled true ve max_total_apy_bps 2500 ile 200 yanıtı verdi; delegatör rotası geçerli olmayan bir adres için 400 yanıtı verdi. GET /qorechain/stakingtier/v1/apr, base (gross_base_apr_bps, source, computed_height, bonus_enabled, max_total_apy_bps), base_apr_bps, bir tiers listesi (3, 6 ve 12 ay için: efektif değerleriyle birlikte bonus_bps 150, 300 ve 500) ile hafif düğüm ve doğrulayıcı bonuslarını (light_node_bonus_bps 200, validator_bonus_bps 300) döndürür. 7 Kasım 2026'da testnet temel oranı 0 okundu (source fees_only), yani yalnızca kademe bonusları sıfırdan farklıydı; havuz rotası bonus havuzunu bildirir. Delegasyonu olmayan bir adres için delegatör rotası, boş bir delegations listesi ve 0 efektif oranla 200 yanıtı verir. Her rakam, zincirin son uzlaşısında hesapladığı değerin baz puan cinsinden okumasıdır. Garanti değildir, ücretlere ve fonlamaya göre değişir ve herhangi bir getiri vaadi değildir.

İtibar Modülü​

İtibar modülünün REST rotaları zincir v3.2.6 ile geldi ve her iki ağ tarafından sunulur (testnet'te 27 Ekim 2026'dan, mainnet'te 4 Kasım 2026'dan beri). Genel mainnet ana makinesinde 4 Kasım 2026'da kontrol edildi: /qorechain/reputation/v1/params, /validators ve /validator/{address} rotalarının üçü de 200 yanıtı verdi. v3.2.6'dan önce her rota HTTP 501 ile yanıt veriyordu ({"code":12,"message":"Not Implemented"}) ve modüle yalnızca gRPC üzerinden erişilebiliyordu.

MetotUç NoktaAçıklama
GET/qorechain/reputation/v1/paramsSkor ağırlıkları (alpha, beta, gamma, delta), lambda ve min_score
GET/qorechain/reputation/v1/validator/{address}Bir doğrulayıcının kaydı. {address} bir qorvaloper1... operatör adresi veya bir qorvalcons1... konsensüs adresidir. Alanlar arasında composite_score, stake_score, performance_score, contribution_score, time_score, uptime_blocks, missed_blocks ve last_updated_height bulunur. 404, doğrulayıcının henüz skoru olmadığı anlamına gelir; ne operatör ne de konsensüs adresi olan bir dize 400 ile yanıtlanır
GET/qorechain/reputation/v1/validatorsSkoru bulunan tüm doğrulayıcıların kayıtları (reputations)

Puanlar 0 ile 1 arasında ondalık dizelerdir. Hafif düğüm, delege edilen bir doğrulayıcı min_reputation değerinin altına düştüğünde uyarı vermek için doğrulayıcı başına rotayı okur (bkz. Ödüller ve İzleme). Aynı rotalar her iki genel ana makinede de çalışır.

SVM küme kimliği (v3.2.7)​

MetotUç NoktaAçıklama
GET/qorechain/svm/v1/cluster_infov3.2.7 (testnet'te 6 Kasım 2026'dan, mainnet'te 12 Kasım 2026'dan beri; daha eski bir düğümde 501). SVM kümesinin kimliği: chain_id, genesis_hash, caip2_chain_id (Wallet Standard zincir kimliği), derivation ve execution_enabled

7 Kasım 2026'da testnet şu değerleri yanıtladı: genesis_hash 6Z9pa53SwiprqiAoNCqqUdj5c3C4P1zRw31gQVnF4Czj, caip2_chain_id solana:6Z9pa53SwiprqiAoNCqqUdj5c3C4P1zR ve execution_enabled false. Genesis hash zincir kimliğinden türetilir (sabit bir etiketin ve zincir kimliğinin SHA-256 özeti, base58 kodlu), bu yüzden kararlıdır. Aynı değerler SVM JSON-RPC getGenesisHash ve getVersion içinde de bulunur (bkz. JSON-RPC Solana uyumlu). SVM kapalı kalır: execution_enabled değeri false'tur. 12 Kasım 2026'da mainnet, chain_id qorechain-vladi, genesis_hash 4LQ9znKk8J3C8YBz2unNdqRCC35ZXvSiFN9YGJNwu3er, caip2_chain_id solana:4LQ9znKk8J3C8YBz2unNdqRCC35ZXvSi ve execution_enabled false ile 200 yanıtı verdi; SVM şeridi mainnet'te hâlâ kapalıdır.

Yalnızca gRPC modülleri​

Mainnet'te (düğüm sürümü v3.2.7, 12 Kasım 2026'dan beri; modül listesi svm satırı dışında 4 Kasım 2026'da v3.2.6 üzerinde kontrol edildi) bu modüllerin gRPC Query hizmeti vardır, ancak tablodaki istisnalar dışında REST rotası yoktur. Hizmet adları qorechain.<module>.v1.Query biçimindedir.

ModülgRPC sorgu yöntemleri (mainnet, zincir sürümü v3.2.7)
aiConfig, Stats
crossvmPendingMessages (v3.2.5'ten beri REST üzerinden: Params, /qorechain/crossvm/v1/params adresinde ve Message, /qorechain/crossvm/v1/message/{id} adresinde)
reputationParams (v3.2.6'dan beri REST üzerinden de, bkz. İtibar Modülü)
rlconsensusAgentStatus, Params, Observation, Reward, Policy, AppliedParams, LastAction (v3.2.6'dan beri REST üzerinden de)
svmSlot, Account, Program (v3.2.7 her iki ağda ClusterInfo ekler, REST üzerinden de, bkz. SVM küme kimliği)
qcaConfig

rlconsensus sorguları v3.2.6'dan itibaren her iki ağda REST üzerinden sunulur (AppliedParams ve LastAction olmak üzere iki yöntemle daha); bkz. RL Consensus Modülü. Kendi düğümünüze karşı grpcurl kullanın veya CLI sorgu komutlarına bakın. rdk sorguları REST üzerinden de kullanılabilir (bkz. RDK Modülü); v3.2.2'den önce yalnızca gRPC idi.

xQORE, BTC restaking (Babylon) ve FairBlock modüllerinin mevcut sürümde ne REST ne de gRPC üzerinden hiçbir sorgu servisi yoktur. v3.2.2'den önce hiçbir sorgu servisi olmayan inflation ve gas-abstraction modülleri REST üzerinden sunulur (Inflation Modülü ve Gas Abstraction Modülü bölümlerine bakın).

Standart rotalar​

Standart Cosmos SDK, IBC, EVM ve QoreChain Native REST rotaları da sunulur. Her iki ağda doğrulanmış örnekler:

Uç NoktaAçıklama
/cosmos/bank/v1beta1/supplyToplam arz
/cosmos/bank/v1beta1/balances/{address}Hesap bakiyeleri
/cosmos/staking/v1beta1/validatorsDoğrulayıcılar
/cosmos/staking/v1beta1/paramsStaking parametreleri
/cosmos/distribution/v1beta1/paramsDağıtım parametreleri
/cosmos/gov/v1/params/votingYönetişim parametreleri
/cosmos/slashing/v1beta1/paramsSlashing parametreleri
/cosmos/upgrade/v1beta1/current_plan, /applied_plan/{name}Bekleyen / uygulanan yükseltmeler (applied_plan/v3.2.3 ana ağda {"height":"3662051"} döndürür)
/cosmos/circuit/v1/disable_listAğ genelinde kapatılmış mesaj türleri
/cosmos/base/node/v1beta1/configDüğümün asgari gas fiyatı (her iki ağda 0.1uqor)
/cosmos/base/tendermint/v1beta1/blocks/latestEn son blok
/cosmos/tx/v1beta1/txs, /txs/{hash}, /txs/block/{height}İşlem arama / sorgulama / bloğa göre
/cosmos/evm/vm/v1/paramsEVM modülü parametreleri
/cosmos/evm/feemarket/v1/paramsEVM ücret piyasası parametreleri
/cosmwasm/wasm/v1/codes/paramsQoreChain Native yükleme/örnekleme izinleri
/ibc/apps/transfer/v1/paramsIBC transfer parametreleri
/ibc/core/client/v2/counterparty_info/{client_id}v3.2.6. Bir istemci için kayıtlı IBC v2 karşı tarafı (hiç yoksa 404)
/ibc/core/client/v2/config/{client_id}v3.2.6. IBC v2 istemci yapılandırması (allowed_relayers)
/cosmos/evm/erc20/v1/token_pairs, /token_pairs/{token}ERC20 token çiftleri (testnet: üç Fest test token'ı ve bir IBC token'ı; ana ağ: hiçbiri)

QoreChain Native öneki /cosmwasm/wasm/v1/... şeklindedir; /cosmos/wasm/v1/... sunulmaz.

IBC v2 istemci rotaları (v3.2.6)​

IBC v2 istemci sorgu hizmeti daha önce gRPC üzerinden sunuluyordu, ancak REST rotaları eksikti; v3.2.6 bunları bağlar. Bir röle, bir istemcinin karşı tarafını buradan okur. Her iki rota da istemci kimliğini yolda alır (örneğin 07-<type>-0); boş bir kimlik 400 yanıtı verir. Testnet'te 27 Ekim 2026'da ve mainnet'te 4 Kasım 2026'da kontrol edildi:

RotaTestnetMainnet (v3.2.6)
/ibc/core/client/v2/counterparty_info/{client_id}200 ile karşı taraf, ya da kayıtlı karşı tarafı olmayan bir istemci için 404 (client 07-<type>-0 counterparty not found); boş bir kimlik 400 yanıtı veriraynı biçimler: karşı tarafı olmayan bir istemci için 404 (client 07-tendermint-0 counterparty not found) (mainnet'te henüz IBC istemcisi yok)
/ibc/core/client/v2/config/{client_id}200, {"config":{"allowed_relayers":[]}} (boş liste herhangi bir rölenin kullanabileceği anlamına gelir)200, {"config":{"allowed_relayers":[]}}
/ibc/core/channel/v2/clients/{client_id}/next_sequence_send, /packet_commitments ve diğer IBC v2 kanal rotalarıyanıt verir (istemci için hiçbir şey kaydedilmemişse 404, taahhütler için boş bir liste ile 200)yanıt verir, aynı biçimler (4 Kasım 2026'da kontrol edildi)

IBC v1 rotaları (/ibc/core/client/v1/..., /ibc/core/channel/v1/...) her iki ağda da yanıt verir. Bu yazı sırasında testnet bir IBC istemcisi ve bir açık transfer kanalı (channel-0, IBC birimli bir token ile) barındırır; mainnet'te ise hiçbir IBC istemcisi, kanalı veya IBC birimli token'ı yoktur. Hız sınırı modülü /Stride-Labs/ibc-rate-limiting/ratelimit/ratelimits adresinde, 08-wasm sağlama toplamı listesi ise /ibc/lightclients/wasm/v1/checksums adresinde yanıt verir: her iki ağda da birincisi boş bir rate_limits listesi (sınır belirlenmemiştir), ikincisi boş bir checksums listesi döndürür. Mainnet ikisine de 4 Kasım 2026'da 200 ile yanıt verdi (v3.2.6'dan önce 501 yanıtı veriyordu). Paket iletme sorgu rotası /ibc/apps/packetforward/v1/params mainnet'te 501 yanıtı verdi; bunun için herkese açık bir rota bulunamadı, bu nedenle ayarları orada REST üzerinden okunamaz.

Testnet test token'ları (Fest)​

Yalnızca testnet, değeri yok

Aşağıdaki üç token yalnızca qorechain-diana test ağında vardır. Bunlar geliştiriciler için test token'larıdır: değerleri yoktur ve ana ağda hiçbir ERC20 token çifti yoktur (27 Ekim 2026'da kontrol edildi: token_pairs boştur ve bank arzı yalnızca uqor içerir). Yönetişim bunları 27 Ekim 2026'da ERC20 token çiftleri olarak kaydetti (öneri 26).

Test ağında kayıtlı bir ERC20 token'ı aynı zamanda bir bank coin'i olarak da bulunur; böylece tutulabilir, gönderilebilir ve bir AMM havuzunun ikinci birimi olarak kullanılabilir. Bank birimi, erc20: ve ardından EIP-55 karışık harfli sağlama toplamı biçiminde sözleşme adresidir ve birim dizesi büyük/küçük harfe duyarlıdır: tamamı küçük harfli yazım farklı bir dizedir ve bulunamaz.

TokenSözleşme adresiBank birimiOndalık
fUSD (FestUSD)0x97143B771D34ddb9130b807b135Ae675A5a963CAerc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA6
fETH (FestETH)0x02292293c13880a26242690eb70a0e42B8E91c28erc20:0x02292293c13880a26242690eb70a0e42B8E91c2818
fBTC (FestBTC)0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451Aerc20:0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451A8
# the three tokens and their display names / decimals
curl -s https://api-testnet.qore.host/cosmos/bank/v1beta1/denoms_metadata
# one denom: the case matters (this returns the metadata, the lowercase spelling returns 404)
curl -s "https://api-testnet.qore.host/cosmos/bank/v1beta1/denoms_metadata/erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA"
# the ERC20 token pairs, and the supply of one denom
curl -s https://api-testnet.qore.host/cosmos/evm/erc20/v1/token_pairs
curl -s "https://api-testnet.qore.host/cosmos/bank/v1beta1/supply/by_denom?denom=erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA"

denoms_metadata, her token'ı symbol fUSD / fETH / fBTC, display FestUSD / FestETH / FestBTC ve görüntüleme biriminin üssü olarak ondalıklarla listeler. Bir bakiye sorgusu (/cosmos/bank/v1beta1/balances/{address}), bir sahibin bakiyesinin dönüştürülmüş kısmını erc20:... birimi altında gösterir; hâlâ EVM tarafında tutulan token'lar ise ERC20 sözleşmesinin kendi balanceOf değerinde görünür. İki biçim arasındaki dönüştürme MsgConvertERC20 (EVM'den bank'a) ve MsgConvertCoin (bank'tan EVM'e) ile yapılır; MsgConvertERC20 göndericisi bir qor1 bech32 adresi olarak yazılmalıdır. Bkz. EVM Geliştirme.

gRPC Reflection​

Kendi çalıştırdığınız bir düğüm gRPC'yi 9090 portunda sunar. Sunucu yansıması (reflection) etkin olduğunda, grpcurl gibi araçlar mevcut servisleri keşfedebilir:

grpcurl -plaintext localhost:9090 list

Belirli bir servisi sorgulamak için:

grpcurl -plaintext -d '{"address":"qor1..."}' localhost:9090 qorechain.pqc.v1.Query/Account

qorechain.pqc.v1.Query bir v3.2.3 düğümünde üç yönteme sahiptir: Account, EVMWindow ve EVMDelegationConsent; v3.2.4'ten itibaren (testnet'te 19 Ekim 2026'dan, mainnet'te 23 Ekim 2026'dan beri) dördüncü bir yöntem olan ProtocolFeatures eklenir. v3.2.6'da bir Params yöntemi eklenir (testnet'te 27 Ekim 2026'dan, mainnet'te 4 Kasım 2026'dan beri); v3.2.6'dan eski bir düğümde Params yöntemi yoktur. v3.2.7 sürümü (her iki ağ), PQC multisig ve textual imzalama bölümünde açıklanan multisig ve textual belge rotalarını ekler.

Kimlik Doğrulama​

Tüm REST ve gRPC uç noktaları varsayılan olarak kimlik doğrulamasızdır. Üretim dağıtımlarında, TLS sonlandırma ve erişim denetimini yönetmek için düğümün önüne bir ters proxy (ör. Nginx veya Caddy) yerleştirin.