Giao diện dòng lệnh solana cho phép cấu hình kết nối cluster, đọc
trạng thái mạng, gửi SOL, quản lý durable nonce, triển khai chương trình và vận hành
các tài khoản stake và vote.
Tài liệu tham khảo này dựa trên
Agave v4.2.1. Chạy
solana --version để kiểm tra phiên bản đã cài đặt và dùng --help để xem chính xác
các tùy chọn có trong phiên bản đó.
Các lệnh tạo, chuyển, ủy quyền, rút hoặc triển khai sẽ gửi giao dịch. Hãy xác nhận cluster và signer đã cấu hình trước khi chạy chúng. Token Devnet và Testnet không có giá trị; các lệnh trên Mainnet sử dụng SOL thật.
Cấu trúc lệnh
solana [GLOBAL_OPTIONS] <COMMAND> [COMMAND_OPTIONS]
Xem trợ giúp ở bất kỳ cấp nào:
solana --helpsolana transfer --helpsolana address-lookup-table extend --help
Tùy chọn toàn cục
Các tùy chọn toàn cục có thể đặt trước lệnh. Phần trợ giúp riêng của từng lệnh sẽ lặp lại các tùy chọn áp dụng cho lệnh đó.
| Tùy chọn | Mục đích |
|---|---|
-u, --url <URL_OR_MONIKER> | Chọn một RPC URL hoặc mainnet-beta, testnet, devnet hay localhost. |
--ws <URL> | Ghi đè endpoint WebSocket. |
-k, --keypair <KEYPAIR> | Chọn một tệp keypair, ASK, stdin (-) hoặc một URL signer được hỗ trợ. |
-C, --config <FILEPATH> | Sử dụng một tệp cấu hình CLI khác. |
--commitment <LEVEL> | Đọc ở mức commitment processed, confirmed hoặc finalized. |
--output <FORMAT> | Trả về json hoặc json-compact ở những lệnh có hỗ trợ. |
--skip-preflight | Gửi mà không mô phỏng qua RPC. Chỉ dùng khi đã hiểu rõ sự đánh đổi về rủi ro thất bại. |
--use-tpu-client | Gửi giao dịch thông qua TPU client. |
--no-address-labels | In địa chỉ mà không kèm nhãn cục bộ. |
--skip-seed-phrase-validation | Cho phép dùng cụm từ khôi phục nằm ngoài danh sách tiếng Anh của BIP39. |
-v, --verbose | Hiển thị thêm thông tin đầu ra của lệnh. |
-V, --version | In phiên bản CLI đã cài đặt. |
Cấu hình CLI
# Inspect the effective configuration.solana config get# Use Devnet and a specific signer by default.solana config set --url devnetsolana config set --keypair ./devnet-keypair.json# Override defaults for one command.solana --url mainnet-beta --keypair usb://ledger address
Cấu hình bao gồm RPC URL, WebSocket URL, signer mặc định và commitment. Một tùy chọn dòng lệnh sẽ ghi đè giá trị đã lưu cho lần gọi lệnh đó.
Quy trình làm việc phổ biến với tài khoản và giao dịch
# Print the default signer's address and balance.solana addresssolana 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-recipientsolana confirm <TRANSACTION_SIGNATURE># Inspect recent activity and stream logs mentioning an address.solana transaction-history <ADDRESS> --limit 20solana logs <ADDRESS>
transfer mặc định chuyển SOL. Dùng ALL làm số lượng để chuyển toàn bộ số dư
khả dụng sau khi trừ phí. Để xem ví dụ về token, hãy xem
hướng dẫn nhanh về token.
Quy trình làm việc với chương trình
# 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>
Truyền --program-id <KEYPAIR_OR_ADDRESS> khi một lần triển khai phải dùng một
program ID đã biết. --final biến một lần triển khai mới thành bất biến; hãy đọc kỹ phần trợ giúp
trước khi sử dụng vì không thể khôi phục upgrade authority.
Quy trình làm việc với durable nonce
solana-keygen new --outfile nonce-account.jsonsolana create-nonce-account nonce-account.json 0.1solana nonce nonce-account.jsonsolana new-nonce nonce-account.jsonsolana withdraw-from-nonce-account nonce-account.json <RECIPIENT_ADDRESS> ALL
Dùng authorize-nonce-account để thay đổi nonce authority và nonce-account
để kiểm tra toàn bộ trạng thái tài khoản. Các giao dịch sử dụng nonce cũng chấp nhận
--nonce và --nonce-authority ở những lệnh có hỗ trợ.
Quy trình làm việc với stake
solana-keygen new --outfile stake-account.jsonsolana create-stake-account stake-account.json 1solana delegate-stake stake-account.json <VOTE_ACCOUNT_ADDRESS>solana stake-account stake-account.jsonsolana deactivate-stake stake-account.jsonsolana withdraw-stake stake-account.json <RECIPIENT_ADDRESS> ALL
Việc hủy kích hoạt hoàn tất tại ranh giới epoch và có thể mất hơn một epoch.
Hãy dùng stakes, validators, stake-history và stake-minimum-delegation để
kiểm tra trạng thái cluster và ủy thác trước khi gửi các thay đổi.
Tiện ích địa chỉ
# 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 createsolana address-lookup-table extend \<LOOKUP_TABLE_ADDRESS> \--addresses <ADDRESS_1>,<ADDRESS_2>
Các seed của PDA dùng định dạng PREFIX:VALUE. Các tiền tố được hỗ trợ gồm string, pubkey,
hex, u8 và các kiểu mã hóa số nguyên có dấu hoặc không dấu với độ rộng cố định, chẳng hạn
u64le.
Thông điệp off-chain và tự động hoàn thành shell
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
Danh mục lệnh đầy đủ
Danh mục dưới đây bao gồm mọi lệnh cấp cao nhất trong Agave v4.2.1. Các lệnh
như program, config, feature và address-lookup-table chứa
các lệnh lồng nhau; hãy chạy <command> --help để liệt kê chúng.
| Lệnh | Mô tả |
|---|---|
account | Hiển thị lamport, chủ sở hữu, dữ liệu và trạng thái thực thi của một tài khoản. |
address | In khóa công khai của signer đã chọn. |
address-lookup-table | Tạo, mở rộng, đóng băng, hủy kích hoạt, đóng và kiểm tra các bảng tra cứu địa chỉ. |
airdrop | Yêu cầu SOL từ faucet của cluster. |
alpenglow-genesis-info | Đọc thông tin về chứng chỉ genesis của Alpenglow. |
authorize-nonce-account | Gán authority cho tài khoản durable nonce. |
balance | Hiển thị số dư SOL của một tài khoản. |
block | Lấy một block đã xác nhận theo slot. |
block-height | Hiển thị block height hiện tại. |
block-production | Hiển thị việc tạo block của leader trong một phạm vi slot. |
block-time | Ước tính thời điểm tạo một block. |
catchup | Chờ một validator bắt kịp cluster. |
close-vote-account | Đóng một tài khoản vote và rút số tiền còn lại. |
cluster-date | Ước tính ngày của cluster dựa trên thời gian genesis và thời gian mạng. |
cluster-version | Hiển thị phiên bản phần mềm của entrypoint cluster. |
completion | Tạo tập lệnh tự động hoàn thành cho shell. |
config | Xem hoặc đặt các giá trị mặc định của CLI. |
confirm | Kiểm tra trạng thái xác nhận của chữ ký giao dịch. |
create-address-with-seed | Suy ra một địa chỉ hệ thống từ base, seed và program ID. |
create-nonce-account | Tạo và khởi tạo một tài khoản durable nonce. |
create-stake-account | Tạo một tài khoản stake. |
create-stake-account-checked | Tạo một tài khoản stake đồng thời kiểm tra withdraw authority với tư cách signer. |
create-vote-account | Tạo một tài khoản vote cho validator. |
deactivate-stake | Bắt đầu hủy kích hoạt stake đã ủy thác. |
decode-transaction | Giải mã một giao dịch đã được tuần tự hóa. |
delegate-stake | Ủy thác một tài khoản stake cho một tài khoản vote. |
epoch | Hiển thị số epoch hiện tại. |
epoch-info | Hiển thị thông tin về epoch, slot, block height và số lượng giao dịch. |
feature | Kiểm tra và quản lý các tài khoản tính năng của runtime. |
find-program-derived-address | Suy ra một PDA và bump chuẩn từ các seed có kiểu dữ liệu. |
first-available-block | Hiển thị block đầy đủ đầu tiên mà node RPC còn lưu giữ. |
genesis-hash | Hiển thị genesis hash của cluster. |
gossip | Liệt kê các node hiển thị qua gossip. |
help | In trợ giúp gốc hoặc trợ giúp của lệnh. |
inflation | Hiển thị thông tin về inflation governor, tỷ lệ lạm phát hoặc phần thưởng. |
largest-accounts | Liệt kê các tài khoản lớn nhất của cluster. |
leader-schedule | Hiển thị lịch trình của leader. |
live-slots | Phát trực tiếp tiến trình slot hiện tại. |
logs | Phát trực tiếp nhật ký giao dịch, có thể lọc theo địa chỉ. |
merge-stake | Hợp nhất các tài khoản stake tương thích. |
new-nonce | Tiến tới giá trị mới của một durable nonce. |
nonce | In giá trị của một durable nonce. |
nonce-account | Hiển thị đầy đủ trạng thái tài khoản durable nonce. |
program | Triển khai, nâng cấp, kiểm tra, dump, đặt authority hoặc đóng các chương trình và buffer. |
recent-prioritization-fees | Hiển thị phí ưu tiên gần đây cho các tài khoản có thể ghi. |
rent | Tính mức tối thiểu để được miễn rent cho một kích thước dữ liệu tài khoản. |
resolve-signer | Phân giải một tham chiếu signer chung, chẳng hạn URL Ledger, thành đường dẫn cụ thể của nó. |
sign-offchain-message | Ký một thông điệp off-chain UTF-8. |
slot | Hiển thị slot hiện tại. |
split-stake | Tách lamport từ một tài khoản stake sang tài khoản khác. |
stake-account | Hiển thị các authority, số dư và trạng thái ủy thác của một tài khoản stake. |
stake-authorize | Thay đổi stake authority hoặc withdraw authority. |
stake-authorize-checked | Thay đổi stake authority đồng thời kiểm tra authority mới với tư cách signer. |
stake-history | Hiển thị lịch sử kích hoạt và hủy kích hoạt stake của cluster. |
stake-minimum-delegation | Hiển thị mức ủy thác stake tối thiểu của cluster. |
stake-set-lockup | Đặt lockup cho một tài khoản stake. |
stake-set-lockup-checked | Đặt lockup đồng thời kiểm tra custodian mới với tư cách signer. |
stakes | Liệt kê các tài khoản stake, có thể lọc theo validator hoặc authority. |
supply | Hiển thị nguồn cung SOL đang lưu hành, không lưu hành và tổng cộng. |
transaction-count | Hiển thị số lượng giao dịch của cluster. |
transaction-history | Liệt kê các giao dịch liên quan đến một địa chỉ từ mới nhất đến cũ nhất. |
transfer | Chuyển SOL giữa các tài khoản hệ thống. |
upgrade-nonce-account | Nâng cấp một tài khoản nonce cũ theo cách idempotent. |
validator-info | Công bố hoặc đọc thông tin của validator. |
validators | Hiển thị tóm tắt về stake, hoa hồng, tỷ lệ bỏ qua và phiên bản của validator. |
verify-offchain-signature | Xác minh một thông điệp off-chain đã ký. |
vote-account | Hiển thị các authority, hoa hồng, credit và các lượt vote của một tài khoản vote. |
vote-authorize-voter | Thay đổi voter authority của một tài khoản vote. |
vote-authorize-voter-checked | Thay đổi voter authority đồng thời kiểm tra authority mới với tư cách signer. |
vote-authorize-withdrawer | Thay đổi withdraw authority của một tài khoản vote. |
vote-authorize-withdrawer-checked | Thay đổi withdraw authority đồng thời kiểm tra authority mới với tư cách signer. |
vote-update-commission | Thay đổi hoa hồng của một tài khoản vote. |
vote-update-validator | Thay đổi danh tính validator được gán cho một tài khoản vote. |
withdraw-from-nonce-account | Rút một phần hoặc toàn bộ SOL từ một tài khoản durable nonce. |
withdraw-from-vote-account | Rút lamport từ một tài khoản vote. |
withdraw-stake | Rút SOL không hoạt động từ một tài khoản stake. |
Đầu ra cho tập lệnh
Hãy dùng --output json hoặc --output json-compact ở những lệnh có hỗ trợ thay vì
phân tích đầu ra dành cho người đọc:
solana epoch-info --output jsonsolana account <ACCOUNT_ADDRESS> --output json-compactsolana validators --output json > validators.json
Không phải lệnh nào cũng hỗ trợ đầu ra có cấu trúc. Hãy kiểm tra phần trợ giúp của lệnh trước khi phụ thuộc vào nó trong tự động hóa, và coi mã thoát khác không là thất bại.
Is this page helpful?