Kora Operators Documentatie

Wat is een Kora Node Operator?

Als Kora node operator run je een paymaster service die Solana transactiekosten sponsort voor je gebruikers. Je node accepteert SPL token betalingen en gebruikt jouw SOL om de daadwerkelijke netwerkkosten te betalen, waardoor gasloos transacties mogelijk worden voor je applicatie.

Waarom een Kora Node Draaien?

Betere UX: Je gebruikers kunnen transacties uitvoeren zonder SOL nodig te hebben (gestroomlijnde onboarding, betere retentie, etc.)
Inkomstenstroom: Incasseer kosten in tokens die je bedrijf prefereert (USDC, BONK, etc.)

Snelstart

Wil je eerst lokaal proberen? Start een lokale Kora node op in een paar minuten: → Lokale Snelstartgids

Kernconcepten

Als Kora node operator ben je verantwoordelijk voor het draaien van een veilige paymaster service die gasloze transacties mogelijk maakt voor je gebruikers. Je node heeft vier belangrijke verantwoordelijkheden:

1. Transacties Valideren

Configureer je node om alleen transacties te accepteren die voldoen aan je bedrijfseisen via kora.toml:

Token allowlists: Bepaal welke SPL tokens je accepteert als betaling (ondersteunt zowel SPL als Token-2022)
Programma allowlists: Whitelist welke Solana programma's gebruikers kunnen gebruiken
Transactielimieten: Stel maximale kosten in die je bereid bent te betalen en handtekeninglimieten
Account blocklists: Voorkom interacties met problematische adressen
Pricing oracles: Configureer Jupiter of mock pricing voor kostenberekeningen
Betalingstokens: Specificeer welk type tokens je als betaling accepteert
Feepayer beleid: Bepaal welke operaties je feepayer kan uitvoeren (transfers, burns, goedkeuringen, etc.)
Token-2022 extensies: Blokkeer specifieke Token-2022 extensies voor verbeterde beveiliging
Caching: Schakel Redis caching in om prestaties te verbeteren door RPC-aanroepen te verminderen
Gebruikslimieten: Stel per-wallet transactielimieten in om misbruik te voorkomen, eerlijk gebruik te garanderen, of gebruikers te belonen met gesubsidieerde transacties tot een bepaalde limiet

→ Volledige Kora.toml Configuratie Referentie → Voorbeeld kora.toml

2. Transacties Ondertekenen

Je node heeft Solana keypair(s) nodig om transacties te ondertekenen als fee payer. Voor productie-implementaties ondersteunt Kora multi-signer configuraties voor verbeterde betrouwbaarheid en verdeling van account-locks. Overweeg het implementeren van key rotatie, toegangscontroles, back-ups en andere strategieën voor signer-beveiliging. Beschikbare ondertekeningsopties:

Lokale Private Key: Bewaar private key rechtstreeks in serveromgeving (als base58, .json bestand, of u8 array)
Turnkey: Private key beheer eenvoudig gemaakt. Maak wallets aan, onderteken transacties en automatiseer onchain acties.
Privy: Eenvoudige crypto-infrastructuur. Creëer veilig whitelabel wallets en onderteken transacties.
HashiCorp Vault: Beheer Secrets & Bescherm Gevoelige Data

→ Volledige Signers Configuratie Handleiding

3. Transactiekosten Betalen

Houd voldoende SOL aan om netwerkkosten te dekken voor je verwachte transactievolume:

Saldo monitoring: Volg je SOL-saldo en stel waarschuwingen in voor een laag saldo (Kora biedt ingebouwde Prometheus metrics - zie Monitoring)
Automatisering: Implementeer automatische SOL-aanvulprocedures voor productieomgevingen
Capaciteitsplanning: Plan voor verwachte use case, gebruikersvolume, enz.

Het is belangrijk dat je begrijpt hoe Kora kosten inschat en hoe je je node configureert om je omzet te maximaliseren. Zie de Fee Estimation Handleiding voor meer details.

4. Operaties Monitoren

Volg continu de beveiliging, prestaties en bedrijfsmetrics van je node:

Beveiligingsmonitoring: Ongebruikelijke patronen, mislukte validaties en overschrijdingen van rate limits
Operationele waarschuwingen: Systeemgezondheid, saldowaarschuwingen en beveiligingsincidenten
Financiële tracking: SOL-kosten vs. token-inkomsten, winstgevendheidsanalyse
Signer saldo monitoring: Volg signer-saldo en stel waarschuwingen in voor een laag saldo

Kora biedt een optioneel /metrics eindpunt dat real-time prestatiegegevens levert in Prometheus-formaat.

→ Kora Monitoring Naslaggids

5. Prestaties Optimaliseren (Optioneel)

Voor implementaties met veel verkeer kun je Redis-caching inschakelen om RPC-aanroepen te verminderen en responstijden te verbeteren:

Account caching: Cache Solana-accountgegevens met configureerbare time to live (TTL)
Automatische fallback: Schakelt automatisch over naar directe RPC-aanroepen als Redis niet beschikbaar is
Cachebeheer: Automatische vervaldatum en mogelijkheden voor geforceerd verversen bij kritieke handelingen

Kora CLI

De kora-cli crate is een productierijpe Rust-binary die alles biedt wat je nodig hebt om een Kora paymaster-node te draaien. Het wordt gedistribueerd als een standalone uitvoerbaar bestand dat je globaal kunt installeren of in containers kunt implementeren.

Installatie-opties

Globale installatie (aanbevolen voor ontwikkeling)

cargo install kora-cli

Of bouwen vanuit de broncode (aanbevolen voor bijdragen)

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

Basisgebruik

De Kora RPC-server maakt een JSON-RPC-eindpunt beschikbaar (standaard: http://localhost:8080). Start het met het kora rpc commando:

# 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

Voor meer informatie over het gebruik van de Kora CLI, zie de CLI-gids.

Applicaties kunnen de Kora RPC-server benaderen via de Kora TS SDK

Configuratie

Elke Kora RPC-node moet minimaal worden geconfigureerd met:

een Solana RPC-eindpunt (gespecificeerd via de --rpc-url vlag of RPC_URL omgevingsvariabele) [standaard: http://127.0.0.1:8899]
Solana signer(s) configuratie (gespecificeerd via de --signers-config signers.toml vlag)
een configuratiebestand, kora.toml (gespecificeerd via de --config path/to/kora.toml vlag)

kora.toml

Voordat je implementeert, moet je een kora.toml aanmaken en configureren om het volgende op te geven:

Rate limiting en authenticatie
Betalingsbestemmingsadres
Beschikbaarheid van RPC-methoden
Validatieregels voor transacties
Beveiligingsbeleid (whitelist of blacklist van SPL-tokens, programma's, accounts, token extensions, enz.)
Prijsmodellen voor fees
Uitgebreid fee payer-beleid (bescherming tegen ongewenst signer-gedrag)
Verzamelen van metrieken
Redis caching-configuratie (optioneel)

signers.toml

Je moet ook een signers.toml bestand aanmaken om het volgende te specificeren:

Ondertekenaar(s) voor je node
Strategie voor selectie van ondertekenaars
Configuratie en toepasselijke sleutels voor elke ondertekenaar

Railway Implementatie

Meer integratiegidsen volgen binnenkort

Hulp Nodig?

Solana Stack Exchange - Stel vragen/deel kennis (zorg ervoor dat je de kora tag gebruikt)
GitHub Issues - Meld bugs of krijg hulp
Voer kora rpc --help uit om alle beschikbare vlaggen en configuratieopties te zien