Ana içeriğe geç

Rollup'lara Genel Bakış

QoreChain Rollup Development Kit (RDK); QoreChain üzerinde zincir üstü x/rdk modülü aracılığıyla mutabakata (settlement) ulaşan, uygulamaya özel rollup'lar oluşturmak için bir istemci kütüphaneleri kümesi (TypeScript, Python, Go, Rust ve Java), bir operatör komut satırı aracı ve başlangıç şablonlarıdır. Onunla bir rollup'ı yapılandırır, işlemlerini oluşturup imzalar, durumunu okur, itiraz pencerelerini (challenge window) takip eder, mutabakat makbuzları düzenleyip doğrular, çapraz-VM çağrıları ile para çekme ispatları hazırlarsınız. Her rollup; kendi blok süresi, sanal makinesi, ücret modeli ve sıralamasıyla (sequencing) bağımsız bir yürütme ortamıdır ve aynı zamanda QoreChain'in güvenliğini, post-kuantum kriptografisini ve veri erişilebilirliği (data availability) garantilerini devralır. Bu sayfa, bir rollup başlatmak veya işletmek isteyen geliştiriciler ve RDK'nın uygulamalarına uyup uymadığına karar veren herkes içindir.

Erken aşama bir yetenek

RDK her iki ağda da dağıtılmıştır, ancak henüz hiçbirinde bir rollup oluşturulmamıştır (27 Ekim 2026 itibarıyla kontrol edildi); dolayısıyla bu bölümde anlatılan akışlar üçüncü taraflarca denenmemiştir. ZK mutabakatı (defi profili, defi-rollup şablonu ve her zk rollup'ı) hiçbir ağda denenmemiştir: doğrulama anahtarı mesajları mainnet'te zincir v3.2.7'den (12 Kasım 2026) ve test ağında 6 Kasım 2026'dan beri etkindir (ZK / STARK ve Para Çekme sayfasına bakın), ancak hiçbir ZK rollup'ı oluşturulmamıştır. Bir ZK rollup'ı uçtan uca çalıştırılana kadar optimistic mutabakatı kullanın.

Ana ağ (qorechain-vladi, EVM zincir kimliği 9801, 7 Haziran 2026'dan beri canlı) zincir sürümü v3.2.7'yi çalıştırır (yönetişim önerisi 16 onu 12 Kasım 2026'da 4.164.600 yüksekliğinde uyguladı; v3.2.6, öneri 15 ile 4 Kasım 2026'da 4.020.000 yüksekliğinde uygulanmıştı; v3.2.5, öneri 14 ile 29 Ekim 2026'da 3.906.833 yüksekliğinde ve v3.2.4 23 Ekim 2026'da 3.742.566 yüksekliğinde, öneri 13, uygulanmıştı); test ağı (qorechain-diana, EVM zincir kimliği 9800) 12 Kasım 2026'dan beri v3.2.8 çalıştırır (9.929.500 yüksekliğinde; v3.2.4 ona 19 Ekim 2026'da, v3.2.5 26 Ekim'de, v3.2.6 27 Ekim'de, v3.2.7 6 Kasım'da ulaştı). Ana ağ test ağının bir sürüm gerisindedir: v3.2.8'i uygulamadı. v3.2.5'in rollup'lar için neyi değiştirdiği zincir v3.2.5 davranışı altında listelenir; her iki ağda da geçerlidir. Davranışın v3.2.3 ile v3.2.4 arasında değiştiği yerlerde bu bölüm hangi sürümün geçerli olduğunu belirtir. Her dağıtımı önce test ağında doğrulayın ve her sayfadaki durum notlarını okuyun: birçok yetenek (ZK doğrulaması, Celestia veri erişilebilirliği, QCAI Copilot, çapraz-VM çağrıları, mutabakat makbuzları) bugün uçtan uca kullanılamaz.

Yenilikler​

  • Post-kuantum mutabakat makbuzları. Bir batch'in durum çapası (state anchor), rollup oluşturucusunun kayıtlı anahtarıyla ML-DSA-87 kullanılarak imzalanır. verifySettlementReceipt, makbuzun her alanını zincirden yeniden okur (rollup, katman, batch kökü ve çapa: durum kökü, katman yüksekliği, Ana Zincir yüksekliği, çapa zamanı, doğrulayıcı kümesi özeti, işlem sayısı, ispat, imza). Doğrulama anahtarı zincirden gelir, asla makbuzdan gelmez; makbuz sorguladığınız ağı belirtmelidir; bilinmeyen bir makbuz sürümü veya ML-DSA-87 dışında bir algoritma herhangi bir okumadan önce reddedilir; ve yalnızca imzaya dayanan bir kontrol asla geçerli olarak bildirilmez. Çapa mesajının, zincir v3.2.2 yüksekliğinin altında geçerli bir ilk biçimi ve ondan itibaren geçerli, zincir kimliğini de bağlayan ikinci bir biçimi vardır; biçim çapanın yüksekliğine göre seçilir. Bkz. Mutabakat makbuzları.
  • İki anahtar türetimiyle hibrit imzalama. İşlemler secp256k1 artı ML-DSA-87 ile imzalanır. Post-kuantum anahtar, anımsatıcı ifadeden (mnemonic) hem kanonik yolla (qorechain:pqc:v1|, adres ve anımsatıcı ifade üzerinde SHAKE-256) hem de eski yolla türetilir ve istemci, zincirin hesap için kaydettiği anahtarı kullanır. Python, Go, Rust ve Java istemcileri 0.8.0'dan itibaren, CLI ise 0.7.1'den itibaren hibrit imzalar; bundan önce yalnızca TypeScript istemcisi imzalıyordu.
  • Zincirin kurduğu gibi kurulan para çekme ispatları. withdrawalsTree (0.7.0, beş dilin hepsinde), bir batch'in para çekme kökünü ve her ispatı tam olarak zincirin yaptığı gibi oluşturur: yaprak konumu para çekme dizinidir, düğümler SHAKE-256 ile özetlenir ve zincir v3.2.5'ten itibaren batch'ler zincir kimliğini de belirten ikinci biçim yaprakları kullanır. Zincirin kendi koduyla üretilen vektörlere karşı test edilmiştir ve bu vektörlerdeki her ispat zincirin doğrulayıcısı tarafından kabul edilir. qorollup withdraw, sonucu batch'in zincir üstündeki withdrawals_root değeri değilse ücret ödemeden önce reddeder.
  • Kanonik geçiş kökü. batchTransitionRoot, zincirin bir optimistic batch'i yargılarken kullandığı tam durum kökünü hesaplar (ana ağın bugün uyguladığı biçim; önceki durum kökünün, veri özetinin ve işlem sayısının SHAKE-256 taahhüdüdür; transitionRootVersionFor bağlı ağın uyguladığı biçimi seçer) ve fraudProof ondan 64 baytlık ispatı oluşturur. İkisi de zincirin kendi koduyla üretilen vektörlere karşı test edilmiştir.
  • Zincirle birebir itiraz pencereleri. batchChallengeWindow, bir batch'in penceresini zincirin yaptığı gibi hesaplar (zamana dayalı: blok zamanı gönderim zamanı artı pencerenin altında olduğu sürece açık; daha eski batch'ler için pencerenin gönderim yüksekliğinden itibaren altıya bölünmüş blok sayısı) ve yerel saate göre değil, RPC /status'tan okunan zincir ucuna göre değerlendirir. Watchtower ve sağlık izleyicisi bunu kullanır. 0.7.0'dan itibaren getRollupHealth, zincirin sıralı kesinliği (v3.2.5, her iki ağ, bkz. zincir v3.2.5 davranışı) bir batch'i geri tuttuğunda ayrıca heldBackBy bildirir ve qorollup watchtower --canonical bir itirazın kazanacağı batch'leri bildirir.
  • Herhangi bir ücret ödenmeden önce kontroller. Kit, ^[a-z0-9][a-z0-9._-]{2,63}$ dışındaki bir rollup kimliğini; uqor cinsinden olmayan, tutarı sıfır olan, 32 baytlık 64 seviyeden daha derin bir ispat taşıyan veya geçersiz bir bech32 adresi belirten bir para çekmeyi; boş olmayan ve tam 32 bayt da olmayan bir para çekme kökünü; zincirin reddedeceği bir rollup durdurmayı (şimdilik test ağında); ve rollup'ı okuyabildiğinde, native veya both veri erişilebilirliğine sahip bir rollup'ta veri özeti belirten bir batch'i reddeder. Bunların her biri aksi halde ücret harcandıktan sonra zincir tarafından reddedilirdi.
  • Çapraz-VM calldata'sı ve canlı kontrol. encodeCrossVmCalldata, executeCrossVMCall(uint8,string,bytes) için calldata oluşturur (seçici 0x3c11078c, ön derleme 0x...0901) ve isCrossVmPrecompileActive ön derlemenin ağda etkin olup olmadığını okur. 0.7.0'dan itibaren getCrossVmParams, crossVmTargetReady, decodeCrossVmResult ve decodeRevertReason, zincir v3.2.5 izin listesini ve yanıt biçimlerini kapsar (her iki ağ). Bkz. Çoklu-VM.
  • Beş dil için tek bir test vektörü kümesi. TypeScript, Python, Go, Rust ve Java paketleri aynı altın (golden) fikstüre karşı kontrol edilir (Go paketinde 100, Rust'ta 77 ve Java'da 75 birim testi vardır).

Nasıl kullanılır​

Okumalar için anahtar da fon da gerekmez. Aşağıdaki kod parçaları, herkese açık test ağındaki (qorechain-diana) canlı rdk modülü parametrelerini ve rollup listesini okur ve 27 Ekim 2026'da yayımlanmış paketlerden çalıştırılmıştır (bu çalıştırmalarda 0.7.0 kullanıldı; güncel sürüm 0.9.0'dır; 0.8.0, Python, Go, Rust ve Java istemcilerine hibrit imzalama ekledi ve burada gösterilen okuma çağrılarını değiştirmez, ancak kod parçaları onunla yeniden çalıştırılmadı). Her biri test ağı parametrelerini (en fazla rollup 200, asgari stake 10.000 QOR, oluşturma yakım oranı 0,01, varsayılan itiraz penceresi 3.600 saniye, en büyük DA blob boyutu 2.097.152 bayt, blob saklama süresi 432.000 blok, blok başına en fazla 10 batch) ve 0 rollups çıktısını verdi.

TypeScript (test edildi)​

npm install @qorechain/rdk
import { createRdkClient } from "@qorechain/rdk";

// Public testnet (chain id qorechain-diana).
const rdk = createRdkClient({
network: "testnet",
endpoints: { rest: "https://api-testnet.qore.host" },
});

// Read the live rdk module parameters and the registered rollups.
const params = await rdk.params();
const rollups = await rdk.rest.listRollups();
console.log(rdk.network.chainId, params, `${rollups.length} rollups`);

mainnet ve testnet hazır profilleri herkese açık qore.host uç noktalarını zaten içerir; bu nedenle createRdkClient({ network: "testnet" }) endpoints alanı olmadan çalışır; test edilen kod parçası onu verdiği için yukarıda gösterilmiştir. Node 20 veya üstüyle çalıştırın (test Node 26 kullandı).

Python (test edildi)​

pip install qorechain-rdk
from qorrdk import create_rdk_client

# Public testnet (chain id qorechain-diana).
rdk = create_rdk_client(network="testnet", endpoints={"rest": "https://api-testnet.qore.host"})

# Read the live rdk module parameters and the registered rollups.
params = rdk.params()
rollups = rdk.rest.list_rollups()
print(rdk.network.chain_id, params, f"{len(rollups)} rollups")

Python 3.10 veya üstü. qorechain-rdk, liboqs-python getiren ve liboqs kütüphanesine ihtiyaç duyan qorechain-pqc'ye bağlıdır; o olmayan bir makinede ilk içe aktarma onu derler (git, CMake ve bir C derleyicisi gerekir). Python 3.12 ile yeni bir sanal ortamda test edildi.

Go (test edildi)​

go get github.com/qorechain/qorechain-rdk/packages/go@v0.9.0
package main

import (
"context"
"fmt"

rdk "github.com/qorechain/qorechain-rdk/packages/go"
)

func main() {
// Public testnet (chain id qorechain-diana).
client := rdk.NewRdkClient(rdk.RdkClientOptions{
Network: "testnet",
Endpoints: &rdk.Endpoints{Rest: "https://api-testnet.qore.host"},
})
ctx := context.Background()
// Read the live rdk module parameters and the registered rollups.
params, err := client.Params(ctx)
if err != nil {
panic(err)
}
rollups, _ := client.Rest.ListRollups(ctx)
fmt.Printf("%s %+v %d rollups\n", client.Network.ChainID, params, len(rollups))
}

Go 1.26 ile, modül Go proxy'sinden alınarak test edildi.

Rust (test edildi)​

cargo add qorechain-rdk
use qorechain_rdk::client::{RdkClient, RdkClientOptions};

fn main() -> Result<(), Box<dyn std::error::Error>> {
// Public testnet (chain id qorechain-diana).
let rdk = RdkClient::new(RdkClientOptions {
rest_url: Some("https://api-testnet.qore.host".into()),
..Default::default()
});

// Read the live rdk module parameters and the registered rollups.
let params = rdk.params()?;
let rollups = rdk.rest.list_rollups()?;
println!("{} {:?} {} rollups", rdk.network.chain_id, params, rollups.len());
Ok(())
}

Kütüphane qorechain_rdk'dır. Rust 1.95 ile, crates.io'ya karşı derlenerek test edildi.

Java (test edildi)​

// build.gradle.kts
implementation("io.github.qorechain:qorechain-rdk:0.9.0")
import io.github.qorechain.rdk.client.RdkClient;
import io.github.qorechain.rdk.client.Views.ParamsView;
import io.github.qorechain.rdk.config.Networks;

public class RdkQuickstart {
public static void main(String[] args) {
// Public testnet (chain id qorechain-diana).
RdkClient.Options options = new RdkClient.Options();
options.network = "testnet";
options.endpoints = new Networks.Endpoints();
options.endpoints.rest = "https://api-testnet.qore.host";
RdkClient rdk = new RdkClient(options);

// Read the live rdk module parameters and the registered rollups.
ParamsView params = rdk.params();
int rollups = rdk.rest.listRollups().size();
System.out.println(rdk.network.chainId + " maxRollups=" + params.maxRollups
+ " minStakeForRollup=" + params.minStakeForRollup + " " + rollups + " rollups");
}
}

0.8.0'dan itibaren Java 21 veya üstü (0.7.1 ve öncesi JDK 17 üzerinde çalışıyordu); Maven Central'dan çözümleyen JDK 21 ve Gradle 9.6 ile test edildi. Dosyanın adı RdkQuickstart.java olmalıdır. Maven Central 0.7.0, 0.7.1 ve 0.8.0'ı sunar (31 Ekim 2026'da kontrol edildi).

Komut satırı (test edildi)​

npm install -g @qorechain/rdk-cli
qorollup --version
qorollup params --network testnet

qorollup --version kurulu sürümü yazdırır (test çalıştırmasında 0.7.0) ve qorollup params --network testnet canlı modül parametrelerini yazdırır. Bu, 0.6.2'den itibaren çalışır. 0.6.1 ve önceki sürümler npm'den kurulduğunda 0 koduyla çıkıyor ve hiçbir şey yazdırmıyordu. Test, @qorechain/rdk-cli@0.7.0'ı boş bir projeye kurdu ve node_modules/.bin/qorollup üzerinden çalıştırdı; global kurulum ve npx aynı bin bağlantısını kullanır. Node 20 veya üstü gereklidir.

Bir proje iskeleti oluşturun (test edildi)​

npx create-qorechain-rollup my-rollup --template nft-rollup --network testnet --yes
cd my-rollup && npm run doctor

Şablonlar defi-rollup, gaming-rollup, nft-rollup, enterprise-rollup, custom-rollup ve multivm-rollup'tır. İskeleti oluşturulan proje @qorechain/rdk ^0.9.0'a bağlıdır (0.8.0'da ^0.8.0, öncesinde ^0.7.0). nft-rollup iskeletini 0.6.1 iskele oluşturucusuyla oluşturmak, npm run doctor komutu test ağına karşı geçen bir proje üretti (REST erişilebilir, parametreler okunabilir, ağ qorechain-diana; Celestia veri erişilebilirliği ve eksik bir imzalayıcı için uyarı verir); defi-rollup iskeletini oluşturup npm run typecheck çalıştırmak, güncel sürümle 27 Ekim 2026'da yeniden geçti. Bir rollup başlatmak için henüz defi-rollup kullanmayın (bkz. Sınırlar). Bir rollup oluşturmak ve batch göndermek için Rollup Dağıtma sayfasını izleyin; işlemler kayıtlı bir post-kuantum anahtar gerektirir ve RDK'da TypeScript istemcisine bir pqcKeypair verilmelidir.

Nasıl erişilir​

Ağlar ve uç noktalar. RDK iki ağın herkese açık uç noktalarıyla konuşur; mainnet ve testnet hazır profilleri bunları zaten içerir.

AğZincir kimliğiEVM zincir kimliğiREST uç noktasıZincir sürümü
Ana ağqorechain-vladi9801https://api.qore.hostv3.2.7
Test ağıqorechain-diana9800https://api-testnet.qore.hostv3.2.8

Her iki ağ da RDK sorgularını (/qorechain/rdk/v1/...) REST, gRPC ve CLI üzerinden sunar; bu nedenle rdk.params() gibi okumalar her ikisine karşı da çalışır. Test ağı, kendi parametreleri olan bir hazırlık (staging) ağıdır: varsayılan itiraz penceresi test ağında 3.600 saniye, ana ağda 604.800'dür, test ağında en fazla 200, ana ağda 100 rollup bulunabilir ve çok katmanlı modül test ağında 64, ana ağda 10 yan zincir katmanına izin verir (27 Ekim 2026'da kontrol edildi). Hedeflediğiniz ağda GET /qorechain/rdk/v1/params çağrısını okuyun.

Bir rollup oluşturmanın önkoşulları.

GereksinimAyrıntılar
Fonlanmış hesapStake, katman stake'i ve ücretler için yeterli QOR'a sahip bir hesap.
Emanete alınan stakeBir rollup oluşturmak min_stake_for_rollup tutarını, her iki ağda 10.000 QOR, emanete alır. Stake'in %1'i (100 QOR) oluşturma sırasında yakılır; geri kalanı emanette kalır ve rollup durdurulduğunda iade edilir.
Katman stake'iOluşturma ayrıca rollup'ın katmanını çok katmanlı modülde kaydeder (asgari stake 1.000 QOR). Katman kaydedilemezse rollup yine de oluşturulur ancak gerçek bir katmanı olmaz; bu yüzden batch'leri çapalanamaz ve hiçbir makbuz düzenlenemez.
Kayıtlı post-kuantum anahtarHesap için kaydedilmiş bir ML-DSA-87 anahtarı. Yalnızca klasik anahtarla imzalanan yerel lane (native-lane) işlemleri reddedilir. Yeni bir hesap, başka herhangi bir şeyden önce kuantum sonrası anahtarını kendi başına bir işlemde kaydetmelidir; RDK istemcileri 0.9.0 bu kaydı sizin için yapar.
ÜcretlerÜcret tabanı gas birimi başına 0,1 uqor'dur; gas limitini ve ücreti birlikte ayarlayın.
AraçlarCLI ve iskele oluşturucu için Node 20 veya üstü; Python istemcisi için Python 3.10 veya üstü (liboqs ile, yukarıya bakın); Java için Java 21 veya üstü (RDK 0.8.0'dan itibaren); Go modülü github.com/qorechain/qorechain-rdk/packages/go.

Durumu okumak bunların hiçbirini gerektirmez. Ayrıca Dashboard üzerinden bir rollup talep edebilir (zincir üstü bir işlem değil, bir talep formu) veya zincir CLI'sı ile bir tane oluşturabilirsiniz; tam akış, CLI komutları ve TypeScript imzalama yolu için Rollup Dağıtma sayfasına bakın.

Zincir v3.2.5 davranışı: her iki ağda canlı​

Zincir v3.2.5 ana ağda (yönetişim önerisi 14 ile 29 Ekim 2026'da 3.906.833 yüksekliğinde uygulandı) ve test ağında (26 Ekim 2026'dan beri) canlıdır. Ana ağ v3.2.7'yi, test ağı v3.2.8'i çalıştırır ve ikisi de onu içerir. RDK 0.7.0 ve sonrası her ikisini de destekler. Bu kurallar her iki ağda da geçerlidir; ana ağda henüz hiç rollup oluşturulmamıştır (GET /qorechain/rdk/v1/rollups 4 Kasım 2026'da boş bir liste döndürdü), bu nedenle aşağıdaki kurallar sürümün kurallarıdır ve canlı bir ana ağ rollup'ı tarafından henüz denenmemiştir. Bir rollup geliştiricisi için:

DavranışHer iki ağ (v3.2.5 ve sonrası)
Bir itirazı kim çözebilirHerhangi bir hesap
Kanıtlanan bir sahtecilikten sonraBatch ve sonraki tüm kesinleşmemiş batch'ler reddedilir; sıralayıcı, son iyi kökten itibaren aynı dizinler altında yeniden gönderir
Kesinlik sırasıBatch'ler dizin sırasıyla kesinleşir
Bekleyen optimistic batch'lerRollup başına en fazla 4.096
Bir rollup'ı durdurmaSon batch submitted veya challenged durumundayken reddedilir; durdurulan bir rollup yuvasını serbest bırakır
withdrawals_rootBoş veya tam 32 bayt; ikinci biçim para çekme yaprakları zincir kimliğini belirtir
Çapraz-VM köprüsüGET /qorechain/crossvm/v1/params izin listesini sunar (bridge_allowed_targets: mainnet'te boş, 4 Kasım 2026'da yeniden kontrol edildi; testnet'te 30 Ekim'de boştu ve 4 Kasım'da üç CosmWasm hedefi içeriyordu); ön derleme abi.encode(bytes) döndürür ve Error(string) ile reddeder
Çapraz-VM ön derlemesi 0x...0901Test ağında, incelenmiş CosmWasm sözleşmelerinden oluşan bir izin listesiyle etkin (7 Kasım 2026'da eth_call ile bir çağrı test edildi); mainnet'te etkin değil

Zincir v3.2.6 her iki ağda da canlıdır (mainnet 4 Kasım 2026'dan, yükseklik 4.020.000, öneri 15). Rollup'lar için sürüm batch görünümüne withdrawals_bound ekler (bir batch'in çekimlerinin ona bağlı olup olmadığı); ayrıca bir rollup'ın nasıl mutabakata vardığını değiştirmeyen IBC ve gözlemlenebilirlik değişiklikleri de ekler. Yeni alanı gösterecek bir mainnet rollup'ı yoktur; bu nedenle gözlemlenmiş değil, sürüm notlarından aktarılmıştır.

Zincir v3.2.7: her iki ağ​

Test ağı zincir v3.2.7'yi 6 Kasım 2026'dan (yükseklik 9.594.600, yönetişimle uygulandı) itibaren çalıştırdı ve 12 Kasım'da v3.2.8'e geçti. Mainnet v3.2.7'yi 12 Kasım 2026'dan beri çalıştırır (yükseklik 4.164.600, yönetişim önerisi 16). Aşağıdaki kontroller test ağında 7 Kasım 2026'da yapıldı; mainnet'te tekrarlanmadı, orada yalnızca sürümün anahtarları bilinir. Rollup'lar için:

  • ZK doğrulama anahtarı mesajları. Test ağı MsgSetVerificationKey ve MsgUpdateVerificationKey mesajlarını kabul etti (boş mesajlı simüle edilmiş bir işlem mesaj türü çözümlemesini geçti ve boş adres alanında başarısız oldu; mainnet aynı mesaj için 7 Kasım'da, v3.2.7'yi uygulamadan önce "unable to resolve type URL" yanıtını verdi). Doğrulama anahtarı mesajları mainnet'te 12 Kasım 2026'dan beri etkindir. Sürüm notları, kayıtlı anahtarı olmayan bir ZK batch'inin ücret ödenmeden önce reddedildiğini söyler. Test ağında hiçbir rollup yoktur (GET /qorechain/rdk/v1/rollups boş bir liste döndürdü) ve GET /qorechain/rdk/v1/rollups mainnet'te de 12 Kasım 2026'da boş bir liste döndürdü, bu yüzden hiçbir anahtar kaydedilmedi ve hiçbir ZK batch'i doğrulanmadı. RDK 0.8.0'da bu mesajlar için bir oluşturucu yoktur.
  • VM'ler arası precompile 0x...0901. Test ağında, incelenmiş üç CosmWasm sözleşmesinden oluşan bir izin listesiyle etkindir; salt okunur bir eth_call izin listesindeki bir sözleşmeye ulaştı ve başka her hedef için reddedildi (ayrıntılar Multi-VM sayfasında). Mainnet'te precompile ve VM'ler arası çağrılar, v3.2.7 sonrasında da kapalı kalır (VM'ler arası çağrı mesajı durdurulmuştur).

Bugün neler mevcut​

Durum
Kayıtlı rollup'lar (ana ağ ve test ağı)Yok
x/rdk modülü ve parametreleriHer iki ağda da dağıtılmıştır; qorechaind query rdk config ile okuyun
RDK sorgularıHer iki ağda da CLI, gRPC ve REST (/qorechain/rdk/v1/...) üzerinden sunulur; bu nedenle TypeScript rdk.params() gibi REST tabanlı okumalar ana ağa karşı çalışır
RDK tarafından yazılan mutabakat çapalarıYok. v3.2.2'den itibaren bir batch bir anchor_signature taşıyabilir ve bu durumda aynı işlemde x/multilayer'a çapalanır; bu alan olmadan batch çapasız olarak mutabık kalır. Henüz hiçbir rollup, katman veya çapa mevcut değildir. TypeScript RDK (0.6.0 ve sonrası), istemcisi hibrit imzaladığında ve rollup'ın oluşturucusu olduğunda bu alanı gönderir (canlıda denenmedi); Python, Go, Rust ve Java istemcileri 0.8.0'dan itibaren hibrit imzalar ancak alanı göndermez (Python için kontrol edildi)
x/multilayer'da kayıtlı rollup katmanlarıYok
ZK mutabakatıDoğrulama anahtarı mesajları mainnet'te etkindir (v3.2.7, 12 Kasım 2026) ve test ağında kabul edilir; henüz hiçbirinde ZK rollup'ı denenmedi
Para çekme işlemleriv3.2.3'ten beri rollup başına bir emanet (escrow) defterinden ödenir (bkz. ZK / STARK ve Para Çekme); hiçbir rollup bulunmadığı için hiç yapılmamıştır

Daha alt seviyedeki modül referansı (modül parametreleri, yaşam döngüsü iç işleyişi, yakım (burn) entegrasyonu ve çok katmanlı çapalama) için Mimari bölümündeki Rollup Development Kit sayfasına bakın. Bu Rollup'lar bölümü ise geliştiriciye dönük uygulama kılavuzudur.

Nerede yayımlanır​

Sürümler 12 Kasım 2026'da kayıt defterlerinde kontrol edildi. Tüm paketler Apache-2.0 lisanslıdır.

RDK 0.9.0 (12 Kasım 2026) zincir v3.2.8'i destekler (test ağı 12 Kasım 2026'dan beri onu çalıştırır): rollup veri gönderimi, tabanlı sıralama (based sequencing), hile kanıtlı (fraud proof) qledger-v1 optimistik rollup'ları, özel rollup'lar, kanonik ZK girdileri; STARK mutabakatı duraklatılmıştır. Bkz. GitHub'daki sürüm notları.

Kayıt defteriPaketGüncel sürümBağlantı
npm@qorechain/rdk (TypeScript istemcisi)0.9.0npmjs.com
npm@qorechain/rdk-cli (qorollup)0.9.0npmjs.com
npmcreate-qorechain-rollup (iskele oluşturucu)0.9.0npmjs.com
PyPIqorechain-rdk (içe aktarma qorrdk)0.9.0pypi.org
crates.ioqorechain-rdk (kütüphane qorechain_rdk)0.9.0crates.io
Go modül proxy'sigithub.com/qorechain/qorechain-rdk/packages/gov0.9.0pkg.go.dev
Maven Centralio.github.qorechain:qorechain-rdk0.9.0central.sonatype.com

Maven Central, önceki sürümlerin yanı sıra 0.7.0, 0.7.1, 0.8.0 ve 0.9.0'ı da sunar ve Go proxy'sinin @latest değeri yeni bir etiketin gerisinde kalabilir; bu yüzden Go sürümünü sabitleyin. Kaynak kod github.com/qorechain/qorechain-rdk adresinde herkese açıktır, sürüm notları v0.9.0 (ve v0.8.0, v0.7.1) adresindedir ve kitin kendi belgeleri qorechain.github.io/qorechain-rdk adresindedir. TypeScript paketi @qorechain/sdk ^0.10.0'a (0.7.0'dan itibaren; 0.6.x ^0.9.0 kullanıyordu; Python, Go, Rust ve Java paketleri 0.8.0'dan itibaren eşleşen QoreChain SDK 0.10.x sürümünü kullanır) ve @qorechain/evm ^0.8.0'a, Python paketi ise qorechain-pqc 0.2.x'e bağlıdır. Zincirin x/rdk modül mantığının kendisi herkese açık kitin parçası değildir.

Sınırlar ve bilinen sorunlar​

  • ZK mutabakatı hiçbir ağda denenmemiştir. Bu, defi profilini, defi-rollup şablonunu ve zk mutabakatıyla oluşturulmuş her rollup'ı kapsar. Doğrulama anahtarı mesajları mainnet'te zincir v3.2.7'den (12 Kasım 2026) ve test ağında 6 Kasım 2026'dan beri etkindir, ancak hiçbir ZK rollup'ı oluşturulmadı, RDK 0.8.0'da bu mesajlar için bir oluşturucu yoktur ve kayıtlı anahtarı olmayan bir ZK batch'i reddedilir. Şimdilik optimistic mutabakatı kullanın (bkz. ZK / STARK ve Para Çekme).
  • Hiçbir ağda henüz bir rollup oluşturulmamıştır. Oluşturma, batch, itiraz, makbuz ve para çekme yolları birim testleri ve ortak vektörlerle kapsanır, ancak zincir üzerinde denenmemiştir.
  • Hibrit imzalama kuantum sonrası anahtarınızı gerektirir. RDK 0.8.0'dan itibaren beş istemcinin hepsi bir kuantum sonrası anahtar çifti verildiğinde hibrit imzalar ve qorollup işlem komutları (create, pause, resume, stop, withdraw) bunu 0.7.1'den itibaren yapar; anahtar olmadan veya önceki sürümlerde bir işlem yalnızca klasik olur ve her iki ağ da onu reddeder. Hiçbir istemciden hibrit bir işlem canlı bir rollup üzerinden gönderilmemiştir. Çapalı batch'leri yalnızca TypeScript istemcisi gönderir.
  • (a) qorollup CLI'sı 0.6.1 ve önceki sürümlerde npm'den kurulduğunda hiçbir şey yazdırmıyordu. Bu 0.6.2'de düzeltildi: npm i -g @qorechain/rdk-cli sonrasında qorollup ... çalışır ve qorollup --version 0.6.2 yazdırır.
  • (b) Para çekme Merkle yardımcıları 0.6.2 ve öncesinde varsayılan olarak SHA-256 kullanıyordu, oysa zincir SHAKE-256 kullanır. Bu varsayılanlarla oluşturulan bir ispat zincirde hiçbir zaman doğrulanmadı. 0.7.0'da düzeltildi: withdrawalsTree zincirin birebir ağacını oluşturur ve zincirin kendi doğrulayıcısına karşı kontrol edilmiştir (bkz. Yaprak ve düğüm kodlaması). Yükseltin; SHA-256 varsayılanlarına dayanan kodun artık hash değerini açıkça geçmesi gerekir.
  • (c) buildDaBlob 0.6.2 ve öncesinde SHA-256 ile özetliyordu, oysa zincirin blob taahhüdü SHAKE-256'dır. 0.7.0'da düzeltildi; taahhüdü artık zincirin taahhüdüdür. Hiçbir işlem blob yayımlamadığı için hiçbir zaman pratik bir etkisi olmadı; native ve both veri erişilebilirliğinde dataHash değerini boş bırakın (bkz. Veri Erişilebilirliği).
  • (d) defi şablonunun demo devresi doğrulanamaz. Bu bir snarkjs çarpıcısıdır ve zincir, önceki durum kökünü, durum kökünü ve veri özetini genel girdi olarak alan BLS12-381 üzerinde Groth16'yı kontrol eder; o devre bunları sunmaz. Anahtar kaydı yayımlandıktan sonra bile kendi devrenize ihtiyacınız vardır.
  • Herhangi bir hesap bir itirazı çözebilir (v3.2.5 ve sonrası, her iki ağ). Zincir sahtecilik ispatını kendisi kontrol eder; v3.2.5'ten önce çözümü yalnızca rollup'ın oluşturucusu gönderebilirdi (bkz. zincir v3.2.5 davranışı ve Optimistic).
  • Canlı ağlarda kullanılamayanlar: Celestia veri erişilebilirliği (uygulanmadı), QCAI Rollup Copilot (danışmanlık servisleri herkese açık uç noktalarda yok), çapraz-VM çağrıları (0x...0901 ön derlemesi mainnet'te etkin değil; test ağında bir izin listesiyle etkindir ve 7 Kasım 2026'da eth_call ile test edildi), paylaşımlı ve based sıralayıcılar (zincir yalnızca yapılandırılmış sıralayıcıyı veya hiçbiri ayarlanmamışsa oluşturucuyu kabul eder) ve suggest-profile (sabit bir yedek olarak defi döndürür).
  • Sürüm notları. Her şey için 0.9.0'ı kullanın (0.7.0 ve öncesi ağların kabul ettiği qorollup işlemlerini gönderemez ve 0.8.0 öncesinde Python, Go, Rust ve Java istemcileri hiçbir işlem gönderemez): 0.6.2 ve öncesi zincirde hiçbir zaman doğrulanmayan para çekme ispatları oluşturur ve 0.6.1 ve öncesi npm'den kurulduğunda qorollup hiçbir şey yazdırmaz. 0.5.0 ve öncesi makbuzlar, Watchtower veya çapraz-VM calldata'sı için kullanılmamalıdır. Her sürümün neyi değiştirdiğinin tam listesi RDK 0.8.0: değişiklikler ve sınırlar sayfasındadır.

Referans: bir rollup neyden oluşur​

RDK size ne sağlar​

RDK ile oluşturulan bir rollup, dört yapılandırılabilir başlığı bir araya getirir:

BaşlıkNeyi kontrol ederSeçenekler
Mutabakat moduRollup'ın durum geçişlerinin QoreChain üzerinde nasıl doğrulanıp kesinleştirileceğinioptimistic, zk, based, sovereign
İspat sistemiMutabakatı destekleyen kriptografik veya ekonomik mekanizmayıfraud, snark, stark, none
Sıralayıcı (sequencer) moduİşlemlerin mutabakattan önce kim tarafından sıralanacağınıdedicated, shared, based
Veri erişilebilirliğiHerkesin durumu yeniden oluşturabilmesi için işlem verilerinin nerede yayımlanacağınınative, celestia, both

Her rollup benzersiz bir rollup-id ile kaydedilir, QOR cinsinden bir stake teminatıyla desteklenir ve bir yaşam döngüsü durumu (pending, active, paused, stopped) atanır. Oluşturma ve yaşam döngüsü akışının tamamı için Rollup Dağıtma sayfasına bakın.

QoreChain'e özgü yetenekler ve durumları​

Herhangi bir rollup kitinin standart özelliklerinin ötesinde, RDK; QoreChain'in Katman 1'i etrafında inşa edilmiş üç yetenek ve bir watchtower otomatik itiraz (auto-challenger) çerçevesi içerir. Bunların durumu farklıdır; tablo bugün nelerin çalıştığını söyler.

YetenekNe yapar
Mutabakat makbuzlarıBir mutabakat çapasını, post-kuantum (ML-DSA-87 / Dilithium-5) imza taşıyan taşınabilir bir makbuz olarak paketler. Erken aşama: henüz hiçbir çapa mevcut değildir, dolayısıyla gerçek bir çapaya karşı hiçbir şey doğrulanmamıştır; bir makbuz zincir durumuna karşı kontrol edilmesi gereken bir iddiadır ve 0.7.0 doğrulayıcısı bunu alan alan yapar.
QCAI Rollup CopilotTek bir rollup için salt okunur bir danışmanlık yardımcısı (ücret tahmini, öneriler, dolandırıcılık soruşturmaları). Okuduğu danışmanlık servisleri henüz herkese açık uç noktalarda sunulmamaktadır.
Çoklu-VM çapraz-VM çağrılarıÇapraz-VM ön derlemesi (0x...0901) aracılığıyla bir EVM'den QoreChain Native'e çağrıyı kodlamaya yarayan araçlar. Ön derleme mainnet'te etkin değildir (orada bir çağrı hiçbir şey yapmaz) ve test ağında bir izin listesiyle etkindir (7 Kasım 2026'da eth_call ile test edildi); 0.6.0'dan beri kodlayıcı zincirin çözdüğü düzenle eşleşir.
WatchtowerOptimistic rollup'lar için yeni batch'leri ve itiraz penceresi (challenge window) son tarihlerini ortaya çıkaran ve geçersiz batch'lere sizin geçerlilik yüklemenize (validity predicate) göre itiraz eden bir otomatik itiraz çerçevesi. REST üzerinden okur ve her iki ağ da bunu sunar; 0.6.0'dan itibaren her batch'in penceresini zincirin yaptığı gibi değerlendirir (sonraki sürümler bunu korur).

Gerekçenin tamamı ve kod örnekleri için Neden QoreChain RDK sayfasına bakın.

Dört mutabakat paradigması​

QoreChain RDK, her biri farklı güven varsayımlarına, kesinlik (finality) özelliklerine ve ispat gereksinimlerine sahip dört ayrı mutabakat modunu destekler. Mutabakat modu ile ispat sistemi kombinasyonu zincir üzerinde doğrulanır ve uyumsuz bir eşleşme oluşturma sırasında reddedilir. Aşağıdaki diyagram, her mutabakat modunu geçerli ispat sistemiyle eşler.

Optimistic​

Optimistic rollup'lar, gönderilen batch'lerin varsayılan olarak geçerli olduğunu kabul eder ve uyuşmazlık çözümü için sahtecilik ispatlarına (fraud proofs) dayanır.

  • İspat sistemi: fraud (etkileşimli sahtecilik ispatları).
  • Sıralayıcı: dedicated veya shared.
  • Kesinlik: Yapılandırılabilir itiraz penceresi başarılı bir itiraz olmadan sona erene kadar gecikmelidir.
  • Uyuşmazlıklar: Pencere içinde herkes, bir teminat (bond) ve bir sahtecilik ispatı yayımlayarak gönderilmiş bir batch'e itiraz edebilir. İtiraz batch'i dondurur; v3.2.5'ten itibaren (her iki ağ) herhangi bir hesap bunu çözebilir, oysa v3.2.5'ten önce yalnızca rollup'ı oluşturan taraf çözebilirdi. Zincir ispatı kendisi kontrol eder: kanıtlanan sahtecilik batch'i reddeder ve itiraz edene ödeme yapar, reddedilen bir itiraz batch'i submitted durumuna geri döndürür. v3.2.5'ten itibaren kanıtlanan bir sahtecilik ayrıca sonraki tüm kesinleşmemiş batch'leri de reddeder; sıralayıcı bunları son iyi kökten itibaren aynı dizinler altında yeniden gönderir (bkz. zincir v3.2.5 davranışı). Bkz. Rollup Dağıtma.
  • Pencere uzunluğu: varsayılan pencere ana ağda 604.800 "saniyedir" (modülün default_challenge_window değeri; test ağının varsayılanı 3.600 saniyedir, 27 Ekim 2026'da okundu ve bir rollup kendi değerini belirleyebilir). v3.2.4'ten önce (ana ağda 3.742.566 yüksekliğinden önce) zincir bunu blok başına sabit 6 saniye üzerinden bloğa çevirir, yani 100.800 blok; dolayısıyla gerçek geçen süre fiili blok süresini izler (ana ağın mevcut ≈3,1 sn'lik blokları ile yaklaşık 3,7 gün); gün cinsinden değil, blok cinsinden planlama yapın. v3.2.4'ten itibaren, yükseltme yüksekliğinden itibaren gönderilen bir batch, blok süresinin saniyesi cinsinden ölçülen bir pencere alır (tam 7 gün); daha önceki batch'ler blok sayısı kuralını korur. Yükseltme yüksekliği test ağında 8.337.253 (19 Ekim 2026'dan beri) ve ana ağda 3.742.566'dır (23 Ekim 2026).

ZK (Sıfır Bilgi / Zero-Knowledge)​

ZK rollup'lar her batch'e, durum geçişinin doğruluğunu yeniden yürütme olmadan kanıtlayan kriptografik bir geçerlilik ispatı ekler.

  • İspat sistemi: snark (özlü ispatlar) veya stark (şeffaf ispatlar, güvenilir kurulum gerektirmez).
  • Sıralayıcı: dedicated veya shared.
  • Kesinlik: Geçerli ispat doğrulandığında, itiraz penceresi olmadan.
  • Olgunluk: ZK mutabakatı hiçbir ağda denenmemiştir. SNARK batch'lerinin, rollup ile birlikte saklanan bir doğrulama anahtarına karşı zincir üzerinde doğrulanması amaçlanır (BLS12-381 üzerinde Groth16); doğrulama anahtarı mesajları mainnet'te zincir v3.2.7'den (12 Kasım 2026) ve test ağında 6 Kasım 2026'dan beri etkindir; henüz hiçbir ZK rollup'ı denenmemiştir. STARK doğrulaması deneyseldir: isteğe bağlıdır ve sizin rollup'ınızın kendi durum geçişini değil, bir gösterim devresini kontrol eder. Bkz. ZK / STARK ve Para Çekme.

Based​

Based rollup'lar, işlem sıralamasını QoreChain (L1) önericilerine (proposers) devrederek ana zincirin canlılığını (liveness) ve sansüre direncini devralır.

  • İspat sistemi: none (sıralama gerçeğinin kaynağı L1 önericileridir).
  • Sıralayıcı: based (zorunlu, zincir üstü doğrulamayla uygulanır).
  • Kesinlik: Ana zincir onayını takip eder.
  • Ödünleşim: QoreChain doğrulayıcıları sıralamayı üstlendiği için en basit operasyonel model; karşılığında özel sıralayıcının sağladığı gecikme kontrolünden vazgeçilir.
  • Bugünkü durum: based, rollup yapılandırmasında kaydedilir, ancak QoreChain henüz L1 önericilerini batch gönderici olarak kabul etmez; batch'i rollup'ı oluşturan taraf gönderir (bkz. Sıralayıcı modları).

Sovereign​

Sovereign rollup'lar kendi konsensüslerini çalıştırır ve kendi kendilerini sıralarlar. Doğrulanabilirlik için durumlarını QoreChain'e çapalar, ancak kesinlik için ana zincire bağımlı değildirler.

  • İspat sistemi: none.
  • Sıralayıcı: rollup tarafından kendi kendine yönetilir.
  • Kesinlik: Bağımsız, rollup'ın kendi konsensüsü tarafından belirlenir.
  • Durum çapalama: Durum kökleri (state roots) şeffaflık için QoreChain'e gönderilir, ancak ana zincir bunları zorunlu kılmaz.

İspat sistemi uyumluluğu​

Mutabakat modu, hangi ispat sistemlerinin geçerli olduğunu kısıtlar. Bu eşleşmeler, rollup oluşturulurken zorunlu tutulur.

Mutabakat modufraudsnarkstarknone
optimisticZorunlu---
zk-DesteklenirDesteklenir-
based---Zorunlu
sovereign---Zorunlu

Sıralayıcı modları​

Sıralayıcı, mutabakattan önce işlemlerin bir rollup bloğu içinde kim tarafından sıralanacağını belirler.

ModKim sıralarNotlar
dedicatedTek bir belirlenmiş operatör adresiEn düşük gecikme; canlılık ve adil sıralama için operatöre güven gerektirir
sharedPaylaşımlı bir sıralayıcı kümesiSıralama küme genelinde dağıtılır; koordinasyon yükü biraz daha yüksektir
basedQoreChain L1 önericileriAna zincir doğrulayıcı güvenliğini ve sansüre direnci devralır; based mutabakatı için zorunludur
Bugün neler uygulanıyor

Zincir üzerinde bir batch'i yalnızca rollup'ın yapılandırılmış sıralayıcı adresi veya hiçbiri ayarlanmamışsa (tüm hazır profillerde durum budur) onu oluşturan taraf gönderebilir. shared ve based modları rollup yapılandırmasında kaydedilir, ancak QoreChain henüz paylaşımlı bir sıralayıcı listesini veya L1 önericilerini batch gönderici olarak kabul etmez; bu modlar amaçlanan tasarımı anlatır.

Paradigma seçimi​

Şunu istiyorsanız...Şunu değerlendirin
QoreChain doğrulayıcılarının sıraladığı en basit operasyonel kurulumbased
Kriptografik garantilerle hızlı kesinlik (henüz kullanılamaz)zk (snark / stark)
Ekonomik uyuşmazlık çözümüne sahip, iyi anlaşılmış bir modeloptimistic (fraud)
Kendi konsensüsünüzle tam bağımsızlık, doğrulanabilirlik için çapalamasovereign

Nereden başlayacağınızdan emin değil misiniz? RDK, yaygın uygulama kategorileri için bu seçimleri paketleyen hazır profiller sunar; bkz. Hazır Profiller. Bir suggest-profile yardımcısı vardır, ancak şu anda sabit bir defi yedeği döndürür (ve defi henüz kullanılamaz), bu nedenle profil tablosundan seçim yapın.

İlgili sayfalar​