Solana CLI -viiteopas

solana-komentoriviliittymä määrittää klusteriyhteyden, lukee verkon tilan, lähettää SOL-tokeneita, hallitsee kestäviä nonceja, ottaa ohjelmia käyttöön sekä hallinnoi stake- ja vote-tilejä.

Tämä viiteopas noudattaa versiota Agave v4.2.1. Tarkista asennettu julkaisu komennolla solana --version ja katso kyseisessä versiossa käytettävissä olevat tarkat valinnat komennolla --help.

Komennot, jotka luovat, siirtävät, valtuuttavat, nostavat tai ottavat käyttöön jotakin, lähettävät transaktioita. Vahvista määritetty klusteri ja allekirjoittaja ennen niiden suorittamista. Devnetin ja Testnetin tokeneilla ei ole arvoa; Mainnetin komennot käyttävät oikeita SOL-tokeneita.

Komennon rakenne

solana [GLOBAL_OPTIONS] <COMMAND> [COMMAND_OPTIONS]

Saat ohjeen millä tahansa tasolla:

solana --help
solana transfer --help
solana address-lookup-table extend --help

Yleiset valinnat

Yleiset valinnat voi sijoittaa ennen komentoa. Komentokohtainen ohje toistaa kyseiseen komentoon sovellettavat valinnat.

Valinta	Tarkoitus
`-u, --url <URL_OR_MONIKER>`	Valitse RPC-URL tai `mainnet-beta`, `testnet`, `devnet` tai `localhost`.
`--ws <URL>`	Ohita WebSocket-päätepiste.
`-k, --keypair <KEYPAIR>`	Valitse keypair-tiedosto, `ASK`, stdin (`-`) tai tuettu allekirjoittajan URL.
`-C, --config <FILEPATH>`	Käytä toista CLI-määritystiedostoa.
`--commitment <LEVEL>`	Lue vahvistustasolla `processed`, `confirmed` tai `finalized`.
`--output <FORMAT>`	Palauta `json` tai `json-compact`, kun se on tuettu.
`--skip-preflight`	Lähetä ilman RPC-simulointia. Käytä vain, kun epäonnistumisen seuraukset ymmärretään.
`--use-tpu-client`	Lähetä transaktiot TPU-asiakkaan kautta.
`--no-address-labels`	Tulosta osoitteet ilman paikallisia nimikkeitä.
`--skip-seed-phrase-validation`	Salli palautuslause, joka ei kuulu BIP39-englanninkieliseen sanalistaan.
`-v, --verbose`	Näytä komennon lisätulostetta.
`-V, --version`	Tulosta asennetun CLI:n versio.

CLI:n määrittäminen

# Inspect the effective configuration.
solana config get

# Use Devnet and a specific signer by default.
solana config set --url devnet
solana config set --keypair ./devnet-keypair.json

# Override defaults for one command.
solana --url mainnet-beta --keypair usb://ledger address

Määritykset sisältävät RPC-URL:n, WebSocket-URL:n, oletusallekirjoittajan ja vahvistustason. Komentoriviltä annettu valinta ohittaa tallennetun arvon kyseisen kutsun ajaksi.

Yleiset tili- ja transaktiotyönkulut

# Print the default signer's address and balance.
solana address
solana balance

# Read an account as JSON.
solana account <ACCOUNT_ADDRESS> --output json

# Request Devnet SOL.
solana airdrop 1 --url devnet

# Send SOL and then confirm the returned signature.
solana transfer <RECIPIENT_ADDRESS> 0.1 --allow-unfunded-recipient
solana confirm <TRANSACTION_SIGNATURE>

# Inspect recent activity and stream logs mentioning an address.
solana transaction-history <ADDRESS> --limit 20
solana logs <ADDRESS>

transfer käsittelee oletuksena SOL-tokeneita. Käytä summana arvoa ALL, jolloin siirretään käytettävissä oleva saldo kulujen jälkeen. Token-esimerkkejä varten katso tokenien pikaopas.

Ohjelmien työnkulut

# Deploy or upgrade an SBF program.
solana program deploy ./target/deploy/my_program.so

# Inspect the deployed program and list programs controlled by the signer.
solana program show <PROGRAM_ID>
solana program show --programs

# Close a program buffer and recover its lamports.
solana program close <BUFFER_ADDRESS>

Anna --program-id <KEYPAIR_OR_ADDRESS>, kun käyttöönotossa on käytettävä tiettyä ohjelmatunnusta. --final tekee uudesta käyttöönotosta muuttumattoman; lue sen ohje huolellisesti ennen käyttöä, koska päivitysvaltuutta ei voi palauttaa.

Kestävän noncen työnkulut

solana-keygen new --outfile nonce-account.json
solana create-nonce-account nonce-account.json 0.1
solana nonce nonce-account.json
solana new-nonce nonce-account.json
solana withdraw-from-nonce-account nonce-account.json <RECIPIENT_ADDRESS> ALL

Käytä komentoa authorize-nonce-account noncen valtuuttajan vaihtamiseen ja komentoa nonce-account tilin koko tilan tarkastamiseen. Noncea käyttävät transaktiot hyväksyvät tuetuissa komennoissa myös valinnat --nonce ja --nonce-authority.

Stake-työnkulut

solana-keygen new --outfile stake-account.json
solana create-stake-account stake-account.json 1
solana delegate-stake stake-account.json <VOTE_ACCOUNT_ADDRESS>
solana stake-account stake-account.json

solana deactivate-stake stake-account.json
solana withdraw-stake stake-account.json <RECIPIENT_ADDRESS> ALL

Deaktivointi valmistuu epoch-rajalla ja voi kestää useita epoch-jaksoja. Käytä komentoja stakes, validators, stake-history ja stake-minimum-delegation klusterin ja delegoinnin tilan tarkastamiseen ennen muutosten lähettämistä.

Osoiteapuohjelmat

# Derive a PDA from typed seeds.
solana find-program-derived-address \
  <PROGRAM_ID> \
  string:profile \
  pubkey:<OWNER_ADDRESS>

# Create and extend an address lookup table.
solana address-lookup-table create
solana address-lookup-table extend \
  <LOOKUP_TABLE_ADDRESS> \
  --addresses <ADDRESS_1>,<ADDRESS_2>

PDA-seed-arvot käyttävät muotoa PREFIX:VALUE. Tuettuja etuliitteitä ovat muun muassa string, pubkey, hex, u8 sekä kiinteänleveyksiset etumerkilliset tai etumerkittömät kokonaislukukoodaukset, kuten u64le.

Ketjun ulkopuoliset viestit ja komentotulkin täydennys

solana sign-offchain-message "terms accepted"
solana verify-offchain-signature \
  "terms accepted" \
  <SIGNATURE> \
  --signer <SIGNER_ADDRESS>

# Print a completion script for the current shell.
solana completion --shell zsh

Täydellinen komentohakemisto

Seuraava hakemisto sisältää kaikki Agave v4.2.1:n ylimmän tason komennot. Komennot, kuten program, config, feature ja address-lookup-table, sisältävät alikomentoja; listaa ne komennolla <command> --help.

Komento	Kuvaus
`account`	Näytä tilin lamport-määrä, omistaja, data ja suoritettavuustila.
`address`	Tulosta valitun allekirjoittajan julkinen avain.
`address-lookup-table`	Luo, laajenna, jäädytä, deaktivoi, sulje ja tarkastele osoitehakutaulukoita.
`airdrop`	Pyydä SOL-tokeneita klusterin faucetista.
`alpenglow-genesis-info`	Lue tietoja Alpenglow-genesis-varmenteesta.
`authorize-nonce-account`	Määritä kestävän nonce-tilin valtuuttaja.
`balance`	Näytä tilin SOL-saldo.
`block`	Hae vahvistettu lohko slot-numeron perusteella.
`block-height`	Näytä nykyinen lohkokorkeus.
`block-production`	Näytä johtajan lohkontuotanto slot-välille.
`block-time`	Arvioi lohkon tuotantoaika.
`catchup`	Odota, että validator saavuttaa klusterin.
`close-vote-account`	Sulje vote-tili ja nosta sen jäljellä olevat varat.
`cluster-date`	Arvioi klusterin päivämäärä genesis-ajan ja verkkoajan perusteella.
`cluster-version`	Näytä klusterin sisääntulopisteen ohjelmistoversio.
`completion`	Luo komentotulkin täydennyskomentosarja.
`config`	Hae tai aseta CLI:n oletusarvot.
`confirm`	Tarkista transaktion allekirjoituksen vahvistustila.
`create-address-with-seed`	Johda järjestelmäosoite base-arvosta, seed-arvosta ja ohjelmatunnuksesta.
`create-nonce-account`	Luo ja alusta kestävä nonce-tili.
`create-stake-account`	Luo stake-tili.
`create-stake-account-checked`	Luo stake-tili ja tarkista nostovaltuuttajan allekirjoitus.
`create-vote-account`	Luo vote-tili validator-solmulle.
`deactivate-stake`	Aloita delegoidun staken deaktivointi.
`decode-transaction`	Pura serialisoitu transaktio.
`delegate-stake`	Delegoi stake-tili vote-tilille.
`epoch`	Näytä nykyinen epoch-numero.
`epoch-info`	Näytä epoch-, slot-, lohkokorkeus- ja transaktiomäärätiedot.
`feature`	Tarkastele ja hallitse ajonaikaisia ominaisuustilejä.
`find-program-derived-address`	Johda PDA ja kanoninen bump tyypitetyistä seed-arvoista.
`first-available-block`	Näytä RPC-solmun säilyttämä ensimmäinen täydellinen lohko.
`genesis-hash`	Näytä klusterin genesis-tiiviste.
`gossip`	Listaa gossip-verkon kautta näkyvät solmut.
`help`	Tulosta juuriohje tai komentokohtainen ohje.
`inflation`	Näytä inflaation ohjaus-, korko- tai palkkiotiedot.
`largest-accounts`	Listaa klusterin suurimmat tilit.
`leader-schedule`	Näytä johtajien aikataulu.
`live-slots`	Suoratoista slot-etenemistä.
`logs`	Suoratoista transaktiolokeja, tarvittaessa osoitteella suodatettuna.
`merge-stake`	Yhdistä yhteensopivat stake-tilit.
`new-nonce`	Siirrä kestävä nonce seuraavaan arvoon.
`nonce`	Tulosta kestävän noncen arvo.
`nonce-account`	Näytä kestävän nonce-tilin täydellinen tila.
`program`	Ota käyttöön, päivitä, tarkastele, tallenna tiedostoon, aseta valtuuttaja tai sulje ohjelmia ja puskureita.
`recent-prioritization-fees`	Näytä viimeaikaiset priorisointimaksut kirjoitettaville tileille.
`rent`	Laske tilin datakoon vuokravapaa vähimmäismäärä.
`resolve-signer`	Selvitä yleinen allekirjoittajaviittaus, kuten Ledger-URL, sen tarkaksi poluksi.
`sign-offchain-message`	Allekirjoita UTF-8-muotoinen ketjun ulkopuolinen viesti.
`slot`	Näytä nykyinen slot.
`split-stake`	Jaa stake-tili siirtämällä lamport-määrä toiselle stake-tilille.
`stake-account`	Näytä stake-tilin valtuuttajat, saldo ja delegoinnin tila.
`stake-authorize`	Vaihda stake- tai nostovaltuuttaja.
`stake-authorize-checked`	Vaihda stake-valtuuttaja ja tarkista uuden valtuuttajan allekirjoitus.
`stake-history`	Näytä klusterin staken aktivointi- ja deaktivointihistoria.
`stake-minimum-delegation`	Näytä klusterin pienin stake-delegointi.
`stake-set-lockup`	Aseta stake-tilin lukitus.
`stake-set-lockup-checked`	Aseta lukitus ja tarkista uuden säilyttäjän allekirjoitus.
`stakes`	Listaa stake-tilit, tarvittaessa validator- tai valtuuttajasuodatuksella.
`supply`	Näytä kierrossa oleva, kierron ulkopuolinen ja kokonais-SOL-tarjonta.
`transaction-count`	Näytä klusterin transaktiomäärä.
`transaction-history`	Listaa osoitteeseen liittyvät transaktiot uusimmasta vanhimpaan.
`transfer`	Siirrä SOL-tokeneita järjestelmätilien välillä.
`upgrade-nonce-account`	Päivitä vanha nonce-tili idempotentisti.
`validator-info`	Julkaise tai lue validator-tietoja.
`validators`	Näytä validator-staken, provisioiden, ohitusasteen ja versioiden yhteenveto.
`verify-offchain-signature`	Vahvista allekirjoitettu ketjun ulkopuolinen viesti.
`vote-account`	Näytä vote-tilin valtuuttajat, provisio, krediitit ja äänet.
`vote-authorize-voter`	Vaihda vote-tilin äänestysvaltuuttaja.
`vote-authorize-voter-checked`	Vaihda äänestysvaltuuttaja ja tarkista uuden valtuuttajan allekirjoitus.
`vote-authorize-withdrawer`	Vaihda vote-tilin nostovaltuuttaja.
`vote-authorize-withdrawer-checked`	Vaihda nostovaltuuttaja ja tarkista uuden valtuuttajan allekirjoitus.
`vote-update-commission`	Vaihda vote-tilin provisio.
`vote-update-validator`	Vaihda vote-tilille määritetty validator-identiteetti.
`withdraw-from-nonce-account`	Nosta osa tai kaikki SOL-tokenit kestävästä nonce-tilistä.
`withdraw-from-vote-account`	Nosta lamport-määrä vote-tililtä.
`withdraw-stake`	Nosta passiiviset SOL-tokenit stake-tililtä.

Komentosarjojen tuloste

Käytä tuetuissa komennoissa valintaa --output json tai --output json-compact ihmisluettavan tulosteen jäsentämisen sijaan:

solana epoch-info --output json
solana account <ACCOUNT_ADDRESS> --output json-compact
solana validators --output json > validators.json

Kaikki komennot eivät tue jäsenneltyä tulostetta. Tarkista komennon ohje, ennen kuin turvaudut siihen automaatiossa, ja käsittele nollasta poikkeava poistumiskoodi virheenä.

Sisällysluettelo