Kora Operatörleri Dokümantasyonu

Kora Düğüm Operatörü Nedir?

Kora düğüm operatörü olarak, kullanıcılarınız için Solana işlem ücretlerini sponsor olan bir ödeme hizmeti çalıştırırsınız. Düğümünüz SPL token ödemelerini kabul eder ve gerçek ağ ücretlerini ödemek için SOL'unuzu kullanır, böylece uygulamanız için gaz ücreti olmayan işlemleri mümkün kılar.

Neden Kora Düğümü Çalıştırmalısınız?

  • Daha İyi Kullanıcı Deneyimi: Kullanıcılarınız SOL'a ihtiyaç duymadan işlem yapar (kolaylaştırılmış katılım, daha iyi elde tutma vb.)
  • Gelir Akışı: İşletmenizin tercih ettiği tokenlarla ücret toplayın (USDC, BONK, vb.)

İçindekiler

Hızlı Başlangıç

Önce yerel olarak denemek mi istiyorsunuz? Birkaç dakika içinde yerel bir Kora düğümü başlatın:Yerel Hızlı Başlangıç Kılavuzu

Temel Kavramlar

Kora düğüm operatörü olarak, kullanıcılarınız için gaz ücreti olmayan işlemleri mümkün kılan güvenli bir ödeme hizmeti çalıştırmaktan sorumlusunuz. Düğümünüzün dört temel sorumluluğu vardır:

1. İşlemleri Doğrulama

Düğümünüzü yalnızca kora.toml aracılığıyla iş gereksinimlerinizi karşılayan işlemleri kabul edecek şekilde yapılandırın:

  • Token izin listeleri: Ödeme olarak hangi SPL tokenlarını kabul edeceğinizi tanımlayın (hem SPL hem de Token-2022'yi destekler)
  • Program izin listeleri: Kullanıcıların hangi Solana programlarıyla etkileşime girebileceğini beyaz listeye ekleyin
  • İşlem limitleri: Ödemeye razı olduğunuz maksimum ücretleri ve imza limitlerini belirleyin
  • Hesap engelleme listeleri: Sorunlu adreslerle etkileşimleri engelleyin
  • Fiyatlandırma oracle'ları: Ücret hesaplamaları için Jupiter veya mock fiyatlandırmayı yapılandırın
  • Ödeme tokenları: Ödeme olarak hangi tür tokenları kabul edeceğinizi belirtin
  • Ücret ödeyici politikaları: Ücret ödeyicinizin hangi işlemleri gerçekleştirebileceğini kontrol edin (transferler, yakma, onaylar vb.)
  • Token-2022 uzantıları: Gelişmiş güvenlik için belirli Token-2022 uzantılarını engelleyin
  • Önbelleğe alma: RPC çağrılarını azaltarak performansı artırmak için Redis önbelleğe almayı etkinleştirin
  • Kullanım limitleri: Kötüye kullanımı önlemek, adil kullanımı sağlamak veya belirli bir limite kadar sübvansiyonlu işlemlerle kullanıcıları ödüllendirmek için cüzdan başına işlem limitleri belirleyin

→ Tam Kora.toml Yapılandırma Referansı → Örnek kora.toml

2. İşlemleri İmzalayın

Düğümünüzün işlemleri ücret ödeyici olarak imzalamak için Solana keypair'lerine ihtiyacı vardır. Üretim dağıtımları için Kora, geliştirilmiş güvenilirlik ve hesap kilidi dağıtımı için çoklu imzalayan yapılandırmalarını destekler. İmzalayan güvenliği için anahtar rotasyonu, erişim kontrolleri, yedeklemeler ve diğer stratejileri uygulamayı düşünün. Mevcut imzalama seçenekleri:

  • Yerel Özel Anahtar: Özel anahtarı doğrudan sunucu ortamında saklayın (base58, .json dosyası veya u8 dizisi olarak)
  • Turnkey: Özel anahtar yönetimi basitleştirildi. Cüzdanlar oluşturun, işlemleri imzalayın ve zincir üstü eylemleri otomatikleştirin.
  • Privy: Kolay kripto altyapısı. Güvenli bir şekilde beyaz etiketli cüzdanlar oluşturun ve işlemleri imzalayın.
  • HashiCorp Vault: Sırları Yönetin ve Hassas Verileri Koruyun

→ Tam İmzalayanlar Yapılandırma Kılavuzu

3. İşlem Ücretlerini Ödeyin

Beklenen işlem hacminiz için ağ ücretlerini karşılamaya yetecek kadar SOL bulundurun:

  • Bakiye izleme: SOL bakiyesini takip edin ve düşük bakiye uyarıları ayarlayın (Kora yerleşik Prometheus metrikleri sağlar - bkz. İzleme)
  • Otomasyon: Üretim ortamları için otomatik SOL yenileme prosedürleri uygulayın
  • Kapasite planlama: Beklenen kullanım senaryosu, kullanıcı hacmi vb. için planlama yapın.

Kora'nın ücretleri nasıl tahmin ettiğini ve gelirinizi maksimize etmek için düğümünüzü nasıl yapılandıracağınızı anlamanız önemlidir. Daha fazla ayrıntı için Ücret Tahmini Kılavuzu'na bakın.

4. Operasyonları İzleyin

Düğümünüzün güvenlik, performans ve iş metriklerini sürekli olarak takip edin:

  • Güvenlik izleme: Olağandışı desenler, başarısız doğrulamalar ve oran sınırı ihlalleri
  • Operasyonel uyarılar: Sistem sağlığı, bakiye uyarıları ve güvenlik olayları
  • Finansal takip: SOL maliyetleri ile token geliri karşılaştırması, karlılık analizi
  • İmzalayan bakiye izleme: İmzalayan bakiyesini takip edin ve düşük bakiye uyarıları ayarlayın

Kora, Prometheus formatında gerçek zamanlı performans verileri sağlayan isteğe bağlı bir /metrics uç noktası sunar.

→ Kora İzleme Referans Kılavuzu

5. Performansı Optimize Edin (İsteğe Bağlı)

Yüksek trafikli dağıtımlar için, RPC çağrılarını azaltmak ve yanıt sürelerini iyileştirmek amacıyla Redis önbelleklemeyi etkinleştirin:

  • Hesap önbellekleme: Yapılandırılabilir yaşam süresi (TTL) ile Solana hesap verilerini önbelleğe alın
  • Otomatik yedekleme: Redis kullanılamıyorsa zarif bir şekilde doğrudan RPC çağrılarına geri döner
  • Önbellek yönetimi: Kritik işlemler için otomatik süre sonu ve zorla yenileme yetenekleri

Kora CLI

kora-cli crate, bir Kora paymaster düğümünü çalıştırmak için ihtiyacınız olan her şeyi sağlayan üretime hazır bir Rust ikili dosyasıdır. Global olarak yükleyebileceğiniz veya kapsayıcılarda dağıtabileceğiniz bağımsız bir çalıştırılabilir dosya olarak dağıtılır.

Kurulum Seçenekleri

Global Kurulum (geliştirme için önerilir)

cargo install kora-cli

Veya kaynaktan derleyin (katkıda bulunmak için önerilir)

git clone https://github.com/solana-foundation/kora.git
cd kora
just install

Temel Kullanım

Kora RPC sunucusu bir JSON-RPC uç noktası sunar (varsayılan: http://localhost:8080). kora rpc komutuyla başlatın:

# Run with specified kora.toml and signers.toml
kora --config path/to/kora.toml rpc start --signers-config path/to/signers.toml
# Help
kora rpc --help

Kora CLI kullanımı hakkında daha fazla bilgi için CLI Kılavuzu'na bakın.

Uygulamalar, Kora RPC Sunucusuna Kora TS SDK aracılığıyla erişebilir

Yapılandırma

Her Kora RPC düğümü en azından şunlarla yapılandırılmalıdır:

  • bir Solana RPC uç noktası (--rpc-url bayrağı veya RPC_URL ortam değişkeni ile belirtilir) [varsayılan: http://127.0.0.1:8899]
  • Solana imzalayıcı(lar) yapılandırması (--signers-config signers.toml bayrağı ile belirtilir)
  • bir yapılandırma dosyası, kora.toml (--config path/to/kora.toml bayrağı ile belirtilir)

kora.toml

Dağıtımdan önce, şunları belirtmek için bir kora.toml oluşturmanız ve yapılandırmanız gerekecektir:

  • Hız sınırlama ve kimlik doğrulama
  • Ödeme hedef adresi
  • RPC metot kullanılabilirliği
  • İşlem doğrulama kuralları
  • Güvenlik politikaları (SPL token'ları, programlar, hesaplar, token uzantıları vb. için beyaz liste veya kara liste)
  • Ücret fiyatlandırma modelleri
  • Gelişmiş ücret ödeyici politikaları (istenmeyen imzalayıcı davranışlarına karşı koruma)
  • Metrik toplama
  • Redis önbellekleme yapılandırması (isteğe bağlı)

signers.toml

Ayrıca şunları belirtmek için bir signers.toml dosyası oluşturmanız gerekecek:

  • Düğümünüz için imzalayıcı(lar)
  • İmzalayıcı seçim stratejisi
  • Her imzalayıcının yapılandırması ve geçerli anahtarları

Dağıtım

Yerel Dağıtım

Dakikalar içinde yerel bir Kora Sunucusu başlatın ve test edin: Hızlı Başlangıç Kılavuzu

Docker

Herhangi bir konteyner platformunda dağıtım yapmak için örnek Dockerfile'ı kullanın. docker-compose.yml dosyası, önbellekleme desteği için Redis içerir:

→ Örnek Dockerfile → Redis ile Docker Compose

Platforma Özgü Kılavuzlar

Yakında daha fazla entegrasyon kılavuzu gelecek

Yardıma mı İhtiyacınız Var?

  • Solana Stack Exchange - Soru sorun/öğrendiklerinizi paylaşın (kora etiketini kullanmayı unutmayın)
  • GitHub Issues - Hata bildirin veya yardım alın
  • Tüm mevcut bayrakları ve yapılandırma seçeneklerini görmek için kora rpc --help komutunu çalıştırın

Is this page helpful?

Yönetici

© 2026 Solana Vakfı.
Tüm hakları saklıdır.
Bağlanın