Dokumentasi Solana

Dokumentasi Operator Kora

Apa itu Operator Node Kora?

Sebagai operator node Kora, Anda menjalankan layanan paymaster yang mensponsori biaya transaksi Solana untuk pengguna Anda. Node Anda menerima pembayaran token SPL dan menggunakan SOL Anda untuk membayar biaya jaringan aktual, memungkinkan transaksi tanpa gas untuk aplikasi Anda.

Mengapa Menjalankan Node Kora?

  • UX yang Lebih Baik: Pengguna Anda bertransaksi tanpa memerlukan SOL (onboarding yang lebih efisien, retensi yang lebih baik, dll.)
  • Aliran Pendapatan: Kumpulkan biaya dalam token yang bisnis Anda sukai (USDC, BONK, dll.)

Daftar Isi

Mulai Cepat

Ingin mencoba secara lokal terlebih dahulu? Jalankan node Kora lokal dalam beberapa menit: → Panduan Mulai Cepat Lokal

Konsep Inti

Sebagai operator node Kora, Anda bertanggung jawab menjalankan layanan paymaster yang aman yang memungkinkan transaksi tanpa gas untuk pengguna Anda. Node Anda memiliki empat tanggung jawab utama:

1. Validasi Transaksi

Konfigurasikan node Anda untuk hanya menerima transaksi yang memenuhi persyaratan bisnis Anda melalui kora.toml:

  • Daftar izin token: Tentukan token SPL mana yang Anda terima sebagai pembayaran (mendukung SPL dan Token-2022)
  • Daftar izin program: Daftar putih program Solana mana yang dapat berinteraksi dengan pengguna
  • Batas transaksi: Tetapkan biaya maksimum yang bersedia Anda bayar dan batas tanda tangan
  • Daftar blokir akun: Cegah interaksi dengan alamat yang bermasalah
  • Oracle harga: Konfigurasikan Jupiter atau mock pricing untuk perhitungan biaya
  • Token pembayaran: Tentukan jenis token yang akan Anda terima sebagai pembayaran
  • Kebijakan feepayer: Kontrol operasi apa yang dapat dilakukan feepayer Anda (transfer, burn, persetujuan, dll.)
  • Ekstensi Token-2022: Blokir ekstensi Token-2022 tertentu untuk keamanan yang lebih baik
  • Caching: Aktifkan caching Redis untuk meningkatkan performa dengan mengurangi panggilan RPC
  • Batas penggunaan: Tetapkan batas transaksi per-wallet untuk mencegah penyalahgunaan, memastikan penggunaan yang adil, atau memberikan reward kepada pengguna dengan transaksi bersubsidi hingga batas tertentu

→ Referensi Konfigurasi Lengkap Kora.toml → Contoh kora.toml

2. Menandatangani Transaksi

Node Anda memerlukan keypair Solana untuk menandatangani transaksi sebagai pembayar biaya. Untuk deployment produksi, Kora mendukung konfigurasi multi-penandatangan untuk meningkatkan keandalan dan distribusi penguncian akun. Pertimbangkan untuk menerapkan rotasi kunci, kontrol akses, backup, dan strategi lain untuk keamanan penandatangan. Opsi penandatanganan yang tersedia:

  • Kunci Privat Lokal: Simpan kunci privat langsung di lingkungan server (sebagai base58, file .json, atau array u8)
  • Turnkey: Manajemen kunci privat yang sederhana. Buat wallet, tandatangani transaksi, dan otomatiskan tindakan onchain.
  • Privy: Infrastruktur kripto yang mudah. Buat wallet whitelabel dengan aman dan tandatangani transaksi.
  • HashiCorp Vault: Kelola Secret & Lindungi Data Sensitif

→ Panduan Konfigurasi Penandatangan Lengkap

3. Membayar Biaya Transaksi

Pertahankan SOL yang cukup untuk menutupi biaya jaringan sesuai volume transaksi yang diharapkan:

  • Pemantauan saldo: Lacak saldo SOL dan siapkan peringatan saldo rendah (Kora menyediakan metrik Prometheus bawaan - lihat Pemantauan)
  • Otomasi: Terapkan prosedur pengisian ulang SOL otomatis untuk lingkungan produksi
  • Perencanaan kapasitas: Rencanakan untuk kasus penggunaan yang diharapkan, volume pengguna, dll.

Penting bagi Anda untuk memahami bagaimana Kora memperkirakan biaya dan cara mengonfigurasi node Anda untuk memaksimalkan pendapatan. Lihat Panduan Estimasi Biaya untuk detail lebih lanjut.

4. Memantau Operasi

Lacak terus menerus metrik keamanan, kinerja, dan bisnis node Anda:

  • Pemantauan keamanan: Pola yang tidak biasa, validasi gagal, dan pelanggaran batas rate
  • Peringatan operasional: Kesehatan sistem, peringatan saldo, dan kejadian keamanan
  • Pelacakan keuangan: Biaya SOL vs. pendapatan token, analisis profitabilitas
  • Pemantauan saldo penandatangan: Lacak saldo penandatangan dan siapkan peringatan saldo rendah

Kora menyediakan endpoint /metrics opsional yang menyediakan data performa real-time dalam format Prometheus.

→ Panduan Referensi Pemantauan Kora

5. Optimalkan Performa (Opsional)

Untuk deployment dengan traffic tinggi, aktifkan caching Redis untuk mengurangi panggilan RPC dan meningkatkan waktu respons:

  • Caching akun: Cache data akun Solana dengan time to live (TTL) yang dapat dikonfigurasi
  • Fallback otomatis: Secara otomatis beralih ke panggilan RPC langsung jika Redis tidak tersedia
  • Manajemen cache: Kemampuan kedaluwarsa otomatis dan force-refresh untuk operasi penting

CLI Kora

Crate kora-cli adalah binary Rust siap produksi yang menyediakan semua yang Anda butuhkan untuk menjalankan node paymaster Kora. Binary ini didistribusikan sebagai executable standalone yang dapat Anda instal secara global atau deploy dalam container.

Opsi Instalasi

Instalasi Global (direkomendasikan untuk pengembangan)

cargo install kora-cli

Atau build dari source (direkomendasikan untuk kontribusi)

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

cd kora

just install

Penggunaan Dasar

Server RPC Kora mengekspos endpoint JSON-RPC (default: http://localhost:8080). Jalankan dengan perintah kora rpc:

# 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

Untuk informasi lebih lanjut tentang penggunaan CLI Kora, lihat Panduan CLI.

Aplikasi dapat mengakses Server RPC Kora melalui Kora TS SDK

Konfigurasi

Setiap node RPC Kora harus dikonfigurasi dengan minimal:

  • endpoint RPC Solana (ditentukan melalui flag --rpc-url atau variabel environment RPC_URL) [default: http://127.0.0.1:8899]
  • konfigurasi signer Solana (ditentukan melalui flag --signers-config signers.toml)
  • file config, kora.toml (ditentukan melalui flag --config path/to/kora.toml)

kora.toml

Sebelum deploy, Anda perlu membuat dan mengonfigurasi kora.toml untuk menentukan:

  • Rate limiting dan autentikasi
  • Alamat tujuan pembayaran
  • Ketersediaan metode RPC
  • Aturan validasi transaksi
  • Kebijakan keamanan (whitelist atau blacklist token SPL, program, akun, token extensions, dll.)
  • Model penetapan harga biaya
  • Kebijakan fee payer yang ditingkatkan (perlindungan terhadap perilaku signer yang tidak diinginkan)
  • Pengumpulan metrik
  • Konfigurasi caching Redis (opsional)

signers.toml

Anda juga perlu membuat file signers.toml untuk menentukan:

  • Penandatangan untuk node Anda
  • Strategi pemilihan penandatangan
  • Konfigurasi setiap penandatangan dan kunci yang berlaku

Deployment

Deployment Lokal

Jalankan dan uji Kora Server lokal dalam hitungan menit: Panduan Mulai Cepat

Docker

Gunakan contoh Dockerfile untuk deployment di platform container mana pun. File docker-compose.yml menyertakan Redis untuk dukungan caching:

→ Contoh Dockerfile → Docker Compose dengan Redis

Panduan Khusus Platform

Panduan integrasi lainnya segera hadir

Butuh Bantuan?

  • Solana Stack Exchange - Ajukan pertanyaan/bagikan pembelajaran (pastikan menggunakan tag kora)
  • GitHub Issues - Laporkan bug atau dapatkan bantuan
  • Jalankan kora rpc --help untuk melihat semua flag dan opsi konfigurasi yang tersedia

Is this page helpful?

Sebelumnya

Panduan Memulai Cepat Kora

Berikutnya

Konfigurasi

Daftar Isi

Edit Halaman

Dikelola oleh

© 2026 Yayasan Solana.
Semua hak dilindungi.
Solana
Terhubung