Kora Operators Dokumentation

Was ist ein Kora Node-Betreiber?

Als Kora Node-Betreiber betreiben Sie einen Paymaster-Service, der Solana-Transaktionsgebühren für Ihre Nutzer übernimmt. Ihr Node akzeptiert SPL-Token-Zahlungen und verwendet Ihre SOL, um die tatsächlichen Netzwerkgebühren zu bezahlen, wodurch gebührenfreie Transaktionen für Ihre Anwendung ermöglicht werden.

Warum einen Kora Node betreiben?

Bessere UX: Ihre Nutzer können Transaktionen durchführen, ohne SOL zu benötigen (vereinfachtes Onboarding, bessere Nutzerbindung usw.)
Einnahmequelle: Kassieren Sie Gebühren in den Token, die Ihr Unternehmen bevorzugt (USDC, BONK usw.)

Schnellstart

Möchten Sie es zuerst lokal ausprobieren? Starten Sie in wenigen Minuten einen lokalen Kora Node: → Lokale Schnellstart-Anleitung

Kernkonzepte

Als Kora Node-Betreiber sind Sie dafür verantwortlich, einen sicheren Paymaster-Service zu betreiben, der gebührenfreie Transaktionen für Ihre Nutzer ermöglicht. Ihr Node hat vier wesentliche Aufgaben:

1. Transaktionen validieren

Konfigurieren Sie Ihren Node so, dass er nur Transaktionen akzeptiert, die Ihre geschäftlichen Anforderungen über kora.toml erfüllen:

Token-Allowlists: Definieren Sie, welche SPL-Token Sie als Zahlung akzeptieren (unterstützt sowohl SPL als auch Token-2022)
Programm-Allowlists: Whitelisten Sie, mit welchen Solana-Programmen Nutzer interagieren können
Transaktionslimits: Legen Sie maximale Gebühren fest, die Sie zu zahlen bereit sind, sowie Signaturlimits
Account-Blocklists: Verhindern Sie Interaktionen mit problematischen Adressen
Preis-Oracles: Konfigurieren Sie Jupiter oder Mock-Preise für Gebührenberechnungen
Zahlungs-Token: Geben Sie an, welche Arten von Token Sie als Zahlung akzeptieren
Feepayer-Richtlinien: Kontrollieren Sie, welche Operationen Ihr Feepayer durchführen kann (Überweisungen, Verbrennungen, Genehmigungen usw.)
Token-2022-Erweiterungen: Blockieren Sie bestimmte Token-2022-Erweiterungen für erhöhte Sicherheit
Caching: Aktivieren Sie Redis-Caching, um die Leistung durch Reduzierung von RPC-Aufrufen zu verbessern
Nutzungslimits: Legen Sie Transaktionslimits pro Wallet fest, um Missbrauch zu verhindern, eine faire Nutzung sicherzustellen oder Nutzer mit subventionierten Transaktionen bis zu einem bestimmten Limit zu belohnen

→ Vollständige Kora.toml Konfigurationsreferenz → Beispiel kora.toml

2. Transaktionen signieren

Ihr Node benötigt Solana-Keypair(s), um Transaktionen als Fee-Zahler zu signieren. Für Produktivumgebungen unterstützt Kora Multi-Signer-Konfigurationen für verbesserte Zuverlässigkeit und Verteilung von Account-Locks. Erwägen Sie die Implementierung von Schlüsselrotation, Zugriffskontrollen, Backups und anderen Strategien für die Signer-Sicherheit. Verfügbare Signierungsoptionen:

Lokaler privater Schlüssel: Speichern Sie den privaten Schlüssel direkt in der Serverumgebung (als base58, .json-Datei oder u8-Array)
Turnkey: Verwaltung privater Schlüssel leicht gemacht. Erstellen Sie Wallets, signieren Sie Transaktionen und automatisieren Sie Onchain-Aktionen.
Privy: Einfache Krypto-Infrastruktur. Erstellen Sie sicher Whitelabel-Wallets und signieren Sie Transaktionen.
HashiCorp Vault: Secrets verwalten & sensible Daten schützen

→ Vollständiger Leitfaden zur Signer-Konfiguration

3. Transaktionsgebühren bezahlen

Halten Sie ausreichend SOL bereit, um Netzwerkgebühren für Ihr erwartetes Transaktionsvolumen zu decken:

Guthabenüberwachung: Verfolgen Sie das SOL-Guthaben und richten Sie Warnungen bei niedrigem Kontostand ein (Kora bietet integrierte Prometheus-Metriken – siehe Monitoring)
Automatisierung: Implementieren Sie automatische SOL-Aufstockungsverfahren für Produktivumgebungen
Kapazitätsplanung: Planen Sie für erwarteten Anwendungsfall, Benutzervolumen usw.

Es ist wichtig, dass Sie verstehen, wie Kora Gebühren schätzt und wie Sie Ihren Node konfigurieren, um Ihren Ertrag zu maximieren. Weitere Details finden Sie im Leitfaden zur Fee-Schätzung.

4. Betrieb überwachen

Verfolgen Sie kontinuierlich die Sicherheits-, Leistungs- und Geschäftsmetriken Ihres Nodes:

Sicherheitsüberwachung: Ungewöhnliche Muster, fehlgeschlagene Validierungen und Überschreitungen von Rate-Limits
Betriebswarnungen: Systemzustand, Guthabenwarnungen und Sicherheitsereignisse
Finanzielle Nachverfolgung: SOL-Kosten vs. Token-Umsatz, Rentabilitätsanalyse
Signer-Guthabenüberwachung: Verfolgen Sie das Signer-Guthaben und richten Sie Warnungen bei niedrigem Kontostand ein

Kora bietet einen optionalen /metrics-Endpunkt, der Echtzeit-Leistungsdaten im Prometheus-Format bereitstellt.

→ Kora Monitoring-Referenzhandbuch

5. Leistung optimieren (optional)

Aktivieren Sie für Deployments mit hohem Traffic Redis-Caching, um RPC-Aufrufe zu reduzieren und die Antwortzeiten zu verbessern:

Konto-Caching: Zwischenspeicherung von Solana-Kontodaten mit konfigurierbarer Time to Live (TTL)
Automatisches Fallback: Fällt bei Nichtverfügbarkeit von Redis elegant auf direkte RPC-Aufrufe zurück
Cache-Verwaltung: Automatische Ablauf- und Zwangsaktualisierungsfunktionen für kritische Operationen

Kora CLI

Das kora-cli Crate ist eine produktionsreife Rust-Binary, die alles bietet, was Sie zum Betrieb eines Kora Paymaster-Knotens benötigen. Es wird als eigenständige ausführbare Datei verteilt, die Sie global installieren oder in Containern deployen können.

Installationsoptionen

Globale Installation (empfohlen für die Entwicklung)

cargo install kora-cli

Oder aus dem Quellcode erstellen (empfohlen zum Beitragen)

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

Grundlegende Verwendung

Der Kora RPC-Server stellt einen JSON-RPC-Endpunkt bereit (Standard: http://localhost:8080). Starten Sie ihn mit dem Befehl 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

Weitere Informationen zur Verwendung der Kora CLI finden Sie im CLI-Leitfaden.

Anwendungen können über das Kora TS SDK auf den Kora RPC-Server zugreifen.

Konfiguration

Jeder Kora RPC-Knoten muss mindestens mit Folgendem konfiguriert werden:

einem Solana RPC-Endpunkt (angegeben über das Flag --rpc-url oder die Umgebungsvariable RPC_URL) [Standard: http://127.0.0.1:8899]
Solana Signer-Konfiguration (angegeben über das Flag --signers-config signers.toml)
einer Konfigurationsdatei kora.toml (angegeben über das Flag --config path/to/kora.toml)

kora.toml

Vor dem Deployment müssen Sie eine kora.toml erstellen und konfigurieren, um Folgendes festzulegen:

Ratenbegrenzung und Authentifizierung
Zieladresse für Zahlungen
Verfügbarkeit von RPC-Methoden
Transaktionsvalidierungsregeln
Sicherheitsrichtlinien (Whitelist oder Blacklist von SPL-Token, Programmen, Konten, Token Extensions usw.)
Gebührenpreismodelle
Erweiterte Fee-Payer-Richtlinien (Schutz vor unerwünschtem Signer-Verhalten)
Metrikenerfassung
Redis-Caching-Konfiguration (optional)

signers.toml

Sie müssen außerdem eine signers.toml-Datei erstellen, um Folgendes festzulegen:

Signer für Ihren Knoten
Strategie zur Signer-Auswahl
Konfiguration und zugehörige Schlüssel für jeden Signer

Railway-Deployment

Weitere Integrationsanleitungen folgen in Kürze

Benötigen Sie Hilfe?

Solana Stack Exchange - Stellen Sie Fragen/teilen Sie Ihr Wissen (verwenden Sie unbedingt den kora-Tag)
GitHub Issues - Melden Sie Fehler oder erhalten Sie Hilfe
Führen Sie kora rpc --help aus, um alle verfügbaren Flags und Konfigurationsoptionen anzuzeigen