Kora-operaattorien dokumentaatio

Mikä on Kora-solmuoperaattori?

Kora-solmuoperaattorina ylläpidät paymaster-palvelua, joka kattaa Solana-transaktiomaksut käyttäjillesi. Solmusi hyväksyy SPL-token-maksuja ja käyttää SOL:iasi todellisten verkkomaksujen maksamiseen, mahdollistaen kaasuttomat transaktiot sovelluksellesi.

Miksi ylläpitää Kora-solmua?

Parempi käyttökokemus: Käyttäjäsi voivat suorittaa transaktioita ilman SOL:ia (sujuvoitettu käyttöönotto, parempi käyttäjien säilyvyys jne.)
Tulovirta: Kerää maksuja haluamissasi tokeneissa (USDC, BONK jne.)

Pikaopas

Haluatko ensin kokeilla paikallisesti? Käynnistä paikallinen Kora-solmu muutamassa minuutissa: → Paikallinen pikaopas

Peruskäsitteet

Kora-solmuoperaattorina olet vastuussa turvallisen paymaster-palvelun ylläpidosta, joka mahdollistaa kaasuttomat transaktiot käyttäjillesi. Solmullasi on neljä keskeistä vastuuta:

1. Validoi transaktiot

Konfiguroi solmusi hyväksymään vain transaktiot, jotka täyttävät liiketoimintavaatimuksesi kora.toml:n kautta:

Token-sallituslistat: Määritä, mitkä SPL-tokenit hyväksyt maksuna (tukee sekä SPL:ää että Token-2022:ta)
Ohjelma-sallituslistat: Valkolistaa, minkä Solana-ohjelmien kanssa käyttäjät voivat olla vuorovaikutuksessa
Transaktiorajat: Aseta enimmäismaksut, jotka olet valmis maksamaan, ja allekirjoitusrajat
Tiliestolista: Estä vuorovaikutus ongelmallisten osoitteiden kanssa
Hinnoitteluoraakit: Konfiguroi Jupiter tai mock-hinnoittelu maksulaskelmia varten
Maksutokenit: Määritä, minkä tyyppisiä tokeneita hyväksyt maksuna
Maksajan käytännöt: Hallitse, mitä toimintoja maksajasi voi suorittaa (siirrot, polttamiset, hyväksynnät jne.)
Token-2022-laajennukset: Estä tietyt Token-2022-laajennukset turvallisuuden parantamiseksi
Välimuisti: Ota käyttöön Redis-välimuisti suorituskyvyn parantamiseksi vähentämällä RPC-kutsuja
Käyttörajat: Aseta lompakoittaiset transaktiorajat väärinkäytön estämiseksi, reilun käytön varmistamiseksi tai käyttäjien palkitsemiseksi subventoiduilla transaktioilla tiettyyn rajaan asti

→ Täydellinen Kora.toml-konfiguraation viite → Esimerkki kora.toml

2. Allekirjoita transaktiot

Solmusi tarvitsee Solana-keypair(it) transaktioiden allekirjoittamiseen maksun maksajana. Tuotantoympäristöissä Kora tukee monen allekirjoittajan konfiguraatioita paremman luotettavuuden ja tilin lukituksen jakamisen vuoksi. Harkitse avainten kierrätyksen, pääsynhallinnan, varmuuskopioiden ja muiden strategioiden käyttöönottoa allekirjoittajan turvallisuuden varmistamiseksi. Saatavilla olevat allekirjoitusvaihtoehdot:

Paikallinen yksityinen avain: Tallenna yksityinen avain suoraan palvelinympäristöön (base58-, .json-tiedostona tai u8-taulukkona)
Turnkey: Yksityisten avainten hallinta yksinkertaiseksi. Luo lompakoita, allekirjoita transaktioita ja automatisoi onchain-toimintoja.
Privy: Helppokäyttöinen kryptoinfrastruktuuri. Luo turvallisesti whitelabel-lompakoita ja allekirjoita transaktioita.
HashiCorp Vault: Hallitse salaisuuksia ja suojaa arkaluonteista dataa

→ Täydellinen allekirjoittajien konfiguraatio-opas

3. Maksa transaktiomaksut

Varmista riittävä SOL-saldo verkkomaksujen kattamiseksi odotetun transaktiovolyymin mukaan:

Saldon seuranta: Seuraa SOL-saldoa ja aseta hälytykset alhaisesta saldosta (Kora tarjoaa sisäänrakennetut Prometheus-mittarit - katso Valvonta)
Automaatio: Toteuta automaattiset SOL-täydennystoimenpiteet tuotantoympäristöihin
Kapasiteettisuunnittelu: Suunnittele odotetun käyttötapauksen, käyttäjämäärän jne. mukaan.

On tärkeää, että ymmärrät kuinka Kora arvioi maksut ja miten solmusi konfigurointi voidaan tehdä tulojesi maksimoimiseksi. Katso lisätietoja Maksuarviointi-oppaasta.

4. Valvo toimintoja

Seuraa jatkuvasti solmusi turvallisuutta, suorituskykyä ja liiketoimintamittareita:

Turvallisuuden valvonta: Epätavalliset käyttäytymismallit, epäonnistuneet validoinnit ja nopeusrajoitusten ylitykset
Operatiiviset hälytykset: Järjestelmän tila, saldovaroitukset ja turvallisuustapahtumat
Taloudellinen seuranta: SOL-kulut vs. token-tulot, kannattavuusanalyysi
Allekirjoittajan saldon seuranta: Seuraa allekirjoittajan saldoa ja aseta hälytykset alhaisesta saldosta

Kora tarjoaa valinnaisen /metrics-päätepisteen, joka tarjoaa reaaliaikaista suorituskykydataa Prometheus-muodossa.

→ Kora-seurannan viiteopas

5. Optimoi suorituskyky (valinnainen)

Korkean liikenteen käyttöönotoissa ota käyttöön Redis-välimuisti vähentääksesi RPC-kutsuja ja parantaaksesi vasteaikoja:

Tilivälimuisti: Välimuistita Solana-tilidata määritettävällä elinikäarvolla (TTL)
Automaattinen varajärjestelmä: Siirtyy sujuvasti suoriin RPC-kutsuihin, jos Redis ei ole käytettävissä
Välimuistin hallinta: Automaattinen vanheneminen ja pakollisen päivityksen mahdollisuudet kriittisille toiminnoille

Kora CLI

kora-cli-paketti on tuotantovalmis Rust-binääri, joka tarjoaa kaiken tarvitsemasi Kora-maksunvälittäjäsolmun ajamiseen. Se jaetaan itsenäisenä suoritettavana tiedostona, jonka voit asentaa globaalisti tai ottaa käyttöön konteissa.

Asennusvaihtoehdot

Globaali asennus (suositeltu kehitykseen)

cargo install kora-cli

Tai rakenna lähdekoodista (suositeltu kehitystyöhön)

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

Peruskäyttö

Kora RPC -palvelin tarjoaa JSON-RPC-päätepisteen (oletus: http://localhost:8080). Käynnistä se kora rpc-komennolla:

# 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

Lisätietoja Kora CLI:n käytöstä on saatavilla CLI-oppaassa.

Sovellukset voivat käyttää Kora RPC -palvelinta Kora TS SDK:n kautta

Määritykset

Jokainen Kora RPC -solmu on määritettävä vähintään seuraavilla:

Solana RPC -päätepiste (määritetty --rpc-url-lipulla tai RPC_URL-ympäristömuuttujalla) [oletus: http://127.0.0.1:8899]
Solana-allekirjoittajien määritykset (määritetty --signers-config signers.toml-lipulla)
määritystiedosto, kora.toml (määritetty --config path/to/kora.toml-lipulla)

kora.toml

Ennen käyttöönottoa sinun on luotava ja määritettävä kora.toml määrittääksesi:

Nopeusrajoitus ja todentaminen
Maksun kohdeosoite
RPC-metodien saatavuus
Tapahtuman validointisäännöt
Turvallisuuskäytännöt (SPL-tokenien, ohjelmien, tilien, token-laajennusten jne. sallittujen tai kiellettyjen luettelo)
Maksujen hinnoittelumallit
Parannetut maksajien käytännöt (suojaa ei-toivotulta allekirjoittajakäyttäytymiseltä)
Mittareiden kerääminen
Redis-välimuistin määritykset (valinnainen)

signers.toml

Sinun täytyy myös luoda signers.toml-tiedosto määrittääksesi:

Solmusi allekirjoittaja(t)
Allekirjoittajan valintastrategia
Kunkin allekirjoittajan kokoonpano ja sovellettavat avaimet

Railway-käyttöönotto

Lisää integrointioppaita tulossa pian

Tarvitsetko apua?

Solana Stack Exchange - Esitä kysymyksiä/jaa oppeja (muista käyttää kora-tagia)
GitHub Issues - Ilmoita virheistä tai hanki apua
Suorita kora rpc --help nähdäksesi kaikki käytettävissä olevat liput ja kokoonpanovaihtoehdot