Files
pezkuwi-sdk/.claude/PROJECT_STATE.md
T
pezkuwichain 7d3d60fb29 fix: add libclang packages for all distros and fix EVM workflow ref
- Add libclang-dev for Ubuntu/Debian
- Add clang-devel for Fedora
- Add llvm-libs for Arch
- opensuse already has clang-devel from previous commit
- Fix EVM workflow: use 'main' branch ref instead of short SHA
- Update VPS list with 3 new runners
2026-01-27 19:39:15 +03:00

5.6 KiB
Raw Blame History

PEZKUWI SDK - PROJECT STATE

Son Güncelleme: 2026-01-02 Bu dosya SessionStart hook tarafından otomatik okunur


PROJE NEDİR

Pezkuwi SDK, Polkadot SDK'nın tamamen rebrand edilmiş BAĞIMSIZ bir fork'udur.

  • Polkadot ile artık HİÇBİR ilişkisi yoktur
  • Tüm crate'ler crates.io'da yayınlanmıştır (~516 crate)
  • Kendi token ekonomisi vardır (HEZ + PEZ)

KRİTİK KURALLAR - MUTLAKA OKU

  1. ASLA Polkadot.js API önerme - Rebrand nedeniyle çalışmıyor
  2. ASLA rebrand'i geri alma - Terminoloji kalıcı
  3. ASLA geçici çözüm önerme - Kalıcı çözümler bul
  4. ÖNCE mevcut araçları kontrol et - Aşağıdaki listeye bak

MEVCUT ARAÇLAR (ZATEN MEVCUT - YENİDEN YAZMA)

1. pezkuwi-subxt (Token Transfer, RPC)

Konum: /home/mamostehp/pezkuwi-sdk/vendor/pezkuwi-subxt/
Durum: TAMAMLANDI - Kullanıma hazır
Kullanım: Token transfer, chain query, extrinsic submit

Polkadot.js yerine BUNU KULLAN!

2. pezkuwi-zombienet-sdk (Network Orchestration)

Konum: /home/mamostehp/pezkuwi-sdk/vendor/pezkuwi-zombienet-sdk/
Binary: /home/mamostehp/pezkuwi-sdk/target/release/pezkuwi-zombienet
Durum: TAMAMLANDI - ParaGenesisArgs fix uygulandı

3. pezkuwi (Relay Chain Node)

Binary: /home/mamostehp/pezkuwi-sdk/target/release/pezkuwi
Durum: TAMAMLANDI - Build edildi

4. pezkuwi-teyrchain (Collator)

Binary: /home/mamostehp/pezkuwi-sdk/target/release/pezkuwi-teyrchain
Durum: TAMAMLANDI - Build edildi

CI/CD ALTYAPISI (GitHub Actions Self-Hosted Runners)

VPS IP CPU RAM Runner Sayısı
VPS1 37.60.230.9 8 23GB 3
VPS2 62.146.235.186 16 62GB 7
VPS3 217.77.6.126 18 94GB 10
VPS-NEW-1 217.77.15.51 4 8GB 1
VPS-NEW-2 161.97.183.44 4 8GB 1
VPS-NEW-3 161.97.185.100 4 8GB 1
TOPLAM - 54 203GB 23

SSH Erişimi

ssh root@37.60.230.9      # VPS1
ssh root@62.146.235.186   # VPS2
ssh root@217.77.6.126     # VPS3
ssh root@217.77.15.51     # VPS-NEW-1 (şifre: SqM210305yBkBnm90)
ssh root@161.97.183.44    # VPS-NEW-2 (şifre: SqM210305yBkBnm90)
ssh root@161.97.185.100   # VPS-NEW-3 (şifre: SqM210305yBkBnm90)

Notlar

  • VPS1'de production servisleri de çalışıyor (ai-lawyer, safechild, naturel-bot)
  • Runner versiyon: v2.321.0 (yeni VPS'ler)
  • Docker network pool dolunca VPS reboot gerekebilir
  • Yeni VPS'ler 2026-01-27 tarihinde eklendi

TERMİNOLOJİ (ASLA ESKİ TERİMLERİ KULLANMA)

ESKİ (KULLANMA) YENİ (KULLAN)
parachain teyrchain
Polkadot Pezkuwi
polkadot pezkuwi
Substrate Bizinikiwi
substrate bizinikiwi
Cumulus Pezcumulus
Westend Zagros
Rococo Pezkuwichain
paritytech pezkuwichain
sp- pezsp-
sc- pezsc-
frame- pezframe-
pallet- pezpallet-

TOKEN EKONOMİSİ

HEZ (Relay Chain Native Token)

  • Genesis: 200,000,000 HEZ
  • Model: DOT benzeri inflationary
  • Unit: 1 HEZ = 10^18 TYR

PEZ (Asset Hub Governance Token)

  • Supply: 5,000,000,000 PEZ (sabit)
  • Asset ID: 1 (Asset Hub'da)
  • wHEZ Asset ID: 2

MAINNET ROADMAP DURUMU

Faz Durum
FAZ 0: Analiz TAMAMLANDI
FAZ 1: Kod TAMAMLANDI
FAZ 2: Chain-spec TAMAMLANDI
FAZ 3: Network Test 🔄 IN PROGRESS
FAZ 4: Mainnet PENDING

FAZ 3 Detay:

  • DEV (1 validator): TAMAMLANDI
  • LOCAL (2 validator): TAMAMLANDI
  • ALPHA (4 validator): BEKLEMEDE
  • BETA (8 validator): BEKLEMEDE
  • STAGING (21 validator): BEKLEMEDE

ÇÖZÜLEN KRİTİK SORUNLAR

1. Teyrchain Genesis Registration (2026-01-02)

Sorun: Teyrchain block #0'da kalıyordu Kök Neden: ParaGenesisArgs format uyumsuzluğu (array vs object) Çözüm: vendor/pezkuwi-zombienet-sdk/crates/orchestrator/src/generators/chain_spec.rs düzeltildi Durum: ÇÖZÜLDÜ

2. Polkadot.js API Uyumsuzluğu → ÇÖZÜLDÜ

Sorun: "Expected 32 bytes, found 48 bytes" AccountId hatası Kök Neden: Rebrand edilmiş metadata type mismatch Çözüm: pezkuwi-subxt kullanıldı Durum: ÇÖZÜLDÜ (2026-01-02)

Token Transfer Test Sonucu:

✓ Connected to Pezkuwichain node
✓ Transaction finalized!
✓ Transfer event: 1,000,000,000,000 TYR (1 HEZ) Alice → Bob

Test Dosyası: vendor/pezkuwi-subxt/subxt/examples/tx_pezkuwichain.rs Çalıştırma: cargo run --release -p pezkuwi-subxt --example tx_pezkuwichain


ZOMBIENET CONFIG DOSYALARI

/home/mamostehp/pezkuwi-sdk/zombienet-dev.toml   # 1 validator (DEV)
/home/mamostehp/pezkuwi-sdk/zombienet-local.toml # 2 validator (LOCAL)

Spawn Komutu:

cd /home/mamostehp/pezkuwi-sdk
./target/release/pezkuwi-zombienet spawn -p native zombienet-dev.toml

KRİTİK DOSYA KONUMLARI

Dosya Konum
CLAUDE.md /home/mamostehp/pezkuwi-sdk/.claude/CLAUDE.md
MAINNET_ROADMAP.md /home/mamostehp/pezkuwi-sdk/.claude/MAINNET_ROADMAP.md
TERMINOLOGY.md /home/mamostehp/pezkuwi-sdk/.claude/TERMINOLOGY.md
Genesis presets pezkuwi/runtime/pezkuwichain/src/genesis_config_presets.rs
Asset Hub presets pezcumulus/teyrchains/runtimes/assets/asset-hub-pezkuwichain/src/genesis_config_presets.rs

SONRAKİ ADIMLAR (ÖNCELİK SIRASI)

  1. pezkuwi-subxt ile token transfer testi - API çalışıyor mu doğrula
  2. XCM messaging testi - Relay ↔ Asset Hub iletişimi
  3. ALPHA network - 4 validator konfigürasyonu

Bu dosya SessionStart hook tarafından otomatik yüklenir. Güncel tutun!