Solana CLI-referentie

De opdrachtregelinterface solana configureert een clusterverbinding, leest de netwerkstatus, verstuurt SOL, beheert durable nonces, deployt programma's en beheert stake- en vote-accounts.

Deze referentie volgt Agave v4.2.1. Voer solana --version uit om de geïnstalleerde release te controleren en gebruik --help voor de exacte opties die in die versie beschikbaar zijn.

Commando's die aanmaken, overdragen, autoriseren, opnemen of deployen, dienen transacties in. Controleer het geconfigureerde cluster en de ondertekenaar voordat je ze uitvoert. Devnet- en Testnet-tokens hebben geen waarde; Mainnet-commando's gebruiken echte SOL.

Commandostructuur

solana [GLOBAL_OPTIONS] <COMMAND> [COMMAND_OPTIONS]

Hulp opvragen op elk niveau:

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

Globale opties

Globale opties kunnen vóór het commando worden geplaatst. De commandospecifieke hulp herhaalt de opties die voor dat commando van toepassing zijn.

Optie	Doel
`-u, --url <URL_OR_MONIKER>`	Selecteer een RPC-URL of `mainnet-beta`, `testnet`, `devnet` of `localhost`.
`--ws <URL>`	Overschrijf het WebSocket-eindpunt.
`-k, --keypair <KEYPAIR>`	Selecteer een keypair-bestand, `ASK`, stdin (`-`) of een ondersteunde signer-URL.
`-C, --config <FILEPATH>`	Gebruik een ander CLI-configuratiebestand.
`--commitment <LEVEL>`	Lees met het commitment-niveau `processed`, `confirmed` of `finalized`.
`--output <FORMAT>`	Geef `json` of `json-compact` terug waar ondersteund.
`--skip-preflight`	Verzenden zonder RPC-simulatie. Gebruik dit alleen als je de afweging bij mislukking begrijpt.
`--use-tpu-client`	Verstuur transacties via de TPU-client.
`--no-address-labels`	Toon adressen zonder lokale labels.
`--skip-seed-phrase-validation`	Sta een herstelzin toe die niet in de Engelse BIP39-lijst voorkomt.
`-v, --verbose`	Toon extra commando-uitvoer.
`-V, --version`	Toon de geïnstalleerde CLI-versie.

De CLI configureren

# 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

De configuratie bevat een RPC-URL, WebSocket-URL, standaardondertekenaar en commitment. Een opdrachtregeloptie overschrijft de opgeslagen waarde voor die aanroep.

Veelgebruikte account- en transactieworkflows

# 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 accepteert standaard SOL. Gebruik ALL als bedrag om het beschikbare saldo na aftrek van kosten over te maken. Voor tokenvoorbeelden, zie de token-quickstart.

Programmaworkflows

# 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>

Geef --program-id <KEYPAIR_OR_ADDRESS> mee wanneer een deployment een bekende programma-ID moet gebruiken. --final maakt een nieuwe deployment onveranderlijk; lees de help zorgvuldig voordat je het gebruikt, omdat de upgrade authority niet kan worden hersteld.

Durable nonce-workflows

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

Gebruik authorize-nonce-account om de nonce authority te wijzigen en nonce-account om de volledige accountstatus te inspecteren. Transacties die een nonce gebruiken accepteren bij ondersteunde commando's ook --nonce en --nonce-authority.

Stake-workflows

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

Deactivering wordt voltooid op een epoch-grens en kan meer dan één epoch duren. Gebruik stakes, validators, stake-history en stake-minimum-delegation om de cluster- en delegatiestatus te inspecteren voordat je wijzigingen indient.

Adreshulpmiddelen

# 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-seeds gebruiken PREFIX:VALUE. Ondersteunde prefixen zijn onder andere string, pubkey, hex, u8 en integercoderingen met vaste breedte, met of zonder teken, zoals u64le.

Off-chain-berichten en shell-aanvulling

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

Volledige commando-index

De volgende index bevat elk commando op het hoogste niveau in Agave v4.2.1. Commando's zoals program, config, feature en address-lookup-table bevatten genestelde commando's; voer <command> --help uit om ze weer te geven.

Commando	Beschrijving
`account`	Toon de lamports, eigenaar, data en uitvoerbare status van een account.
`address`	Toon de publieke sleutel van de geselecteerde ondertekenaar.
`address-lookup-table`	Maak address lookup tables aan, breid ze uit, bevries, deactiveer, sluit en inspecteer ze.
`airdrop`	Vraag SOL aan bij de faucet van een cluster.
`alpenglow-genesis-info`	Lees informatie over het Alpenglow-genesiscertificaat.
`authorize-nonce-account`	Wijs een authority toe aan een durable nonce-account.
`balance`	Toon het SOL-saldo van een account.
`block`	Haal een bevestigd blok op via slot.
`block-height`	Toon de huidige bloklengte.
`block-production`	Toon de blokproductie van de leader voor een slotbereik.
`block-time`	Schat het productietijdstip van een blok.
`catchup`	Wacht tot een validator is bijgewerkt met het cluster.
`close-vote-account`	Sluit een vote-account en neem het resterende saldo op.
`cluster-date`	Schat de clusterdatum op basis van de genesistijd en netwerktijd.
`cluster-version`	Toon de softwareversie van het entrypoint van het cluster.
`completion`	Genereer een shell-aanvulscript.
`config`	Haal CLI-standaardwaarden op of stel ze in.
`confirm`	Controleer de bevestigingsstatus van een transactiehandtekening.
`create-address-with-seed`	Leid een systeemadres af uit een base, seed en programma-ID.
`create-nonce-account`	Maak een durable nonce-account aan en initialiseer het.
`create-stake-account`	Maak een stake-account aan.
`create-stake-account-checked`	Maak een stake-account aan en controleer daarbij de withdraw authority als ondertekenaar.
`create-vote-account`	Maak een vote-account voor een validator aan.
`deactivate-stake`	Begin met het deactiveren van gedelegeerde stake.
`decode-transaction`	Decodeer een geserialiseerde transactie.
`delegate-stake`	Delegeer een stake-account aan een vote-account.
`epoch`	Toon het huidige epoch-nummer.
`epoch-info`	Toon informatie over epoch, slot, bloklengte en aantal transacties.
`feature`	Inspecteer en beheer runtime feature-accounts.
`find-program-derived-address`	Leid een PDA en canonieke bump af uit getypeerde seeds.
`first-available-block`	Toon het eerste volledige blok dat de RPC-node bewaart.
`genesis-hash`	Toon de genesis-hash van het cluster.
`gossip`	Toon nodes die zichtbaar zijn via gossip.
`help`	Toon de algemene hulp of de hulp bij een commando.
`inflation`	Toon informatie over de inflation governor, inflatiepercentage of beloningen.
`largest-accounts`	Toon de grootste accounts van het cluster.
`leader-schedule`	Toon het leader-schema.
`live-slots`	Stream de voortgang van de huidige slots.
`logs`	Stream transactielogs, optioneel gefilterd op adres.
`merge-stake`	Voeg compatibele stake-accounts samen.
`new-nonce`	Schuif een durable nonce door.
`nonce`	Toon de waarde van een durable nonce.
`nonce-account`	Toon de volledige status van een durable nonce-account.
`program`	Deploy, upgrade, inspecteer, dump, stel de authority in van of sluit programma's en buffers.
`recent-prioritization-fees`	Toon recente prioriteitskosten voor beschrijfbare accounts.
`rent`	Bereken het minimum voor rent-vrijstelling bij een bepaalde accountdatagrootte.
`resolve-signer`	Herleid een algemene signer-verwijzing, zoals een Ledger-URL, naar het specifieke pad.
`sign-offchain-message`	Onderteken een UTF-8 off-chain-bericht.
`slot`	Toon de huidige slot.
`split-stake`	Splits lamports van het ene stake-account af naar een ander.
`stake-account`	Toon de authorities, het saldo en de delegatiestatus van een stake-account.
`stake-authorize`	Wijzig een stake- of withdraw authority.
`stake-authorize-checked`	Wijzig een stake authority en controleer daarbij de nieuwe authority als ondertekenaar.
`stake-history`	Toon de geschiedenis van stake-activering en -deactivering van het cluster.
`stake-minimum-delegation`	Toon de minimale stake-delegatie van het cluster.
`stake-set-lockup`	Stel een lockup in voor een stake-account.
`stake-set-lockup-checked`	Stel een lockup in en controleer daarbij de nieuwe custodian als ondertekenaar.
`stakes`	Toon stake-accounts, optioneel gefilterd op validator of authority.
`supply`	Toon het circulerende, niet-circulerende en totale aanbod van SOL.
`transaction-count`	Toon het aantal transacties van het cluster.
`transaction-history`	Toon transacties waarbij een adres betrokken is, van nieuw naar oud.
`transfer`	Maak SOL over tussen systeemaccounts.
`upgrade-nonce-account`	Upgrade idempotent een verouderd nonce-account.
`validator-info`	Publiceer of lees validator-informatie.
`validators`	Toon een overzicht van validator-stake, commissie, skip rate en versie.
`verify-offchain-signature`	Verifieer een ondertekend off-chain-bericht.
`vote-account`	Toon de authorities, commissie, credits en stemmen van een vote-account.
`vote-authorize-voter`	Wijzig de voter authority van een vote-account.
`vote-authorize-voter-checked`	Wijzig de voter authority en controleer daarbij de nieuwe authority als ondertekenaar.
`vote-authorize-withdrawer`	Wijzig de withdraw authority van een vote-account.
`vote-authorize-withdrawer-checked`	Wijzig de withdraw authority en controleer daarbij de nieuwe authority als ondertekenaar.
`vote-update-commission`	Wijzig de commissie van een vote-account.
`vote-update-validator`	Wijzig de validator-identiteit die aan een vote-account is toegewezen.
`withdraw-from-nonce-account`	Neem een deel van of alle SOL op uit een durable nonce-account.
`withdraw-from-vote-account`	Neem lamports op uit een vote-account.
`withdraw-stake`	Neem inactieve SOL op uit een stake-account.

Scriptuitvoer

Gebruik --output json of --output json-compact waar ondersteund in plaats van uitvoer voor mensen te parsen:

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

Niet elk commando ondersteunt gestructureerde uitvoer. Controleer de help van het commando voordat je in automatisering ervan afhankelijk bent, en beschouw een afsluitstatus ongelijk aan nul als een fout.

Inhoudsopgave