Panoramica

Cos'è Kora?

Kora è un livello di astrazione delle commissioni per Solana che consente agli utenti di pagare le commissioni di transazione con token SPL invece di SOL (o di evitare completamente le commissioni di transazione). È un server JSON-RPC che funge da paymaster, sponsorizzando le commissioni di transazione sulla rete Solana mentre accetta pagamenti nei token supportati dalla tua applicazione.

Il Problema: Gli utenti hanno bisogno di SOL per pagare le commissioni di transazione su Solana, creando attriti per le app in cui gli utenti detengono principalmente altri token (ad esempio, un portafoglio di pagamenti che utilizza solo USDC o un gioco che effettua transazioni solo in BONK, ecc.).

La Soluzione: Gli operatori dei nodi Kora accettano pagamenti di commissioni in token SPL, verificano e firmano le transazioni e pagano le commissioni di rete con i propri SOL, creando un'esperienza senza gas per gli utenti.

Esempi di Casi d'Uso

Neobanche: Consentire agli utenti di inviare USDC senza aver bisogno di SOL per le commissioni
Gaming: I giocatori spendono token di gioco per tutte le transazioni
Liquid Staking: Consentire agli utenti della tua dApp di detenere/utilizzare i tuoi token di liquid staking anziché SOL nativo
Programmi Fedeltà: Premiare gli utenti con un certo numero di commissioni sovvenzionate in base al loro livello di fedeltà

Caratteristiche Principali

Sicuro: Regole di validazione configurabili per programmi, token e account
Prezzi Flessibili: Supporto per più token di pagamento delle commissioni con prezzi in tempo reale
Distribuzione Semplice: Crate CLI Kora pronto per la distribuzione
Developer Friendly: API JSON-RPC con CLI e SDK TypeScript per un'integrazione fluida con Solana Kit
Pronto per la Produzione: Limitazione della frequenza integrata, monitoraggio e funzionalità di sicurezza

Come Funziona

I nodi Kora operano come middleware tra la tua applicazione e Solana. Tutte le transazioni su Solana richiedono un fee payer per firmare la transazione e coprire le commissioni di transazione di rete in SOL. Inoltre, le transazioni potrebbero richiedere firme da altri portafogli a seconda della logica del programma (ad esempio, i trasferimenti di token richiedono la firma del proprietario del token).

Kora esamina le transazioni Solana prima che vengano inviate alla rete, verifica che soddisfino i requisiti di sicurezza configurati dal nodo e conferma che la transazione includa un'istruzione di pagamento di token SPL adeguata all'operatore del nodo. Una volta verificata, Kora co-firma la transazione come pagatore delle commissioni e restituisce la transazione completamente firmata all'applicazione per l'invio alla rete.

Flusso delle Transazioni Kora

L'utente avvia una transazione
L'app costruisce una transazione (con un'istruzione di pagamento in token all'operatore del nodo Kora)
L'utente firma la transazione
L'app invia la transazione firmata a un operatore del nodo Kora
Kora convalida la transazione rispetto alle regole configurate (programmi consentiti, token, ecc.) e verifica che il pagamento sia adeguato a coprire le commissioni di rete (in base ai prezzi di mercato attuali tramite un Oracle)
Kora firma la transazione convalidata come pagatore delle commissioni e la restituisce all'app
L'app invia la transazione firmata da Kora a Solana per l'elaborazione
Solana elabora la transazione: i token SPL vengono trasferiti all'operatore del nodo, le commissioni SOL vengono pagate da Kora e la transazione dell'utente viene elaborata
L'app conferma che la transazione è stata completata con successo e notifica l'utente

L'utente completa con successo la propria transazione utilizzando solo token SPL, mentre Kora si è occupato di tutte le commissioni di rete denominate in SOL.

Flusso delle Transazioni Kora

Terminologia Chiave

Fee payer: L'account firmatario di una transazione Solana che copre i costi di rete associati all'elaborazione della transazione on-chain.
Gas (o commissioni gas): Costi associati all'invio e alla registrazione delle transazioni su Solana (pagati in SOL).
Gasless Relayer: Un servizio che facilita le transazioni blockchain per conto degli utenti senza richiedere loro di pagare direttamente le commissioni gas (Kora è un gasless relayer).
JSON-RPC: Un protocollo di chiamata di procedura remota (RPC) stateless e leggero che utilizza JSON (JavaScript Object Notation) per la serializzazione dei dati. Consente la comunicazione tra un client e un server permettendo al client di invocare metodi sul server come se fossero funzioni locali.
Oracle: Un servizio che fornisce dati sui prezzi in tempo reale per i token.
Paymaster: Un servizio o account che paga le commissioni di transazione per conto degli utenti, tipicamente in cambio di un pagamento in token o valute alternative (gli operatori dei nodi Kora sono paymaster).
Rent: Un deposito richiesto da Solana per mantenere attivi gli account sulla blockchain. Il rent può essere recuperato quando gli account vengono chiusi.

Inizia

Scegli il tuo percorso:

Voglio provare Kora rapidamente

→ Guida Rapida

Avvia un server Kora locale e scopri l'astrazione delle commissioni in azione in meno di 10 minuti.

Voglio eseguire un nodo Kora

→ Risorse per Operatori di Nodi

Configura e distribuisci il tuo server Kora per sponsorizzare le transazioni della tua applicazione.

Voglio utilizzare Kora nella mia app

Aggiungi l'astrazione delle commissioni alla tua applicazione Solana utilizzando l'SDK Kora. L'approccio consigliato è utilizzare createKitKoraClient(), che si integra con l'architettura dei plugin di Kit e gestisce automaticamente la pianificazione delle transazioni, la stima delle commissioni, l'iniezione dei pagamenti e l'invio.

→ Guida al Client Kit - Crea transazioni senza gas con il client Kit

Per un controllo di livello inferiore, consulta la guida Flusso Completo delle Transazioni utilizzando direttamente KoraClient, oppure il Riferimento API per tutte le opzioni client disponibili.

Serve Aiuto?

Solana Stack Exchange - Fai domande con il tag kora
GitHub Issues - Segnala bug o richiedi nuove funzionalità

Indice dei contenuti