Εγκατάσταση

Εγκατάσταση Rust

Οι προγραμματιστές δημιουργούν προγράμματα Solana χρησιμοποιώντας τη γλώσσα προγραμματισμού Rust.

Εγκαταστήστε τη Rust με το rustup.

Εκτελέστε την ακόλουθη εντολή για να εγκαταστήσετε τη Rust:

$ 
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -yCopy

Θα πρέπει να δείτε το ακόλουθο μήνυμα μετά την ολοκλήρωση της εγκατάστασης:

Εκτελέστε την ακόλουθη εντολή για να επαναφορτώσετε τη μεταβλητή περιβάλλοντος PATH ώστε να συμπεριλάβει τον κατάλογο bin του Cargo:

$ 
. "$HOME/.cargo/env"Copy

Για να επαληθεύσετε ότι η εγκατάσταση ολοκληρώθηκε με επιτυχία, ελέγξτε την έκδοση της Rust:

$ 
rustc --versionCopy

Θα πρέπει να δείτε μια έξοδο όπως η παρακάτω:

rustc 1.86.0 (05f9846f8 2025-03-31)

Εγκατάσταση του Solana CLI

Το Solana CLI παρέχει όλα τα εργαλεία που απαιτούνται για την ανάπτυξη και την ανάπτυξη προγραμμάτων Solana.

Εγκαταστήστε τη σουίτα εργαλείων Solana CLI χρησιμοποιώντας την επίσημη εντολή εγκατάστασης:

$ 
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"Copy

Μπορείτε να αντικαταστήσετε το stable με την ετικέτα έκδοσης που αντιστοιχεί στην έκδοση λογισμικού που επιθυμείτε (π.χ. v2.0.3), ή να χρησιμοποιήσετε ένα από τα τρία συμβολικά ονόματα καναλιών: stable, beta, ή edge.

Για μια πρώτη εγκατάσταση του Solana CLI, μπορεί να δείτε το ακόλουθο μήνυμα που σας προτρέπει να προσθέσετε μια μεταβλητή περιβάλλοντος PATH:

Close and reopen your terminal to apply the PATH changes or run the following in your existing shell:

export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"

$ 
echo $SHELLCopy

$ 
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc
Copy
$ 
source ~/.bashrcCopy

$ 
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc
Copy
$ 
source ~/.zshrcCopy

$ 
source ~/.bashrc # If using Bash
Copy
$ 
source ~/.zshrc # If using ZshCopy

Για να επαληθεύσετε ότι η εγκατάσταση ήταν επιτυχής, ελέγξτε την έκδοση του Solana CLI:

$ 
solana --versionCopy

Θα πρέπει να δείτε μια έξοδο όπως η παρακάτω:

solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)

Μπορείτε να δείτε όλες τις διαθέσιμες εκδόσεις στο Agave Github repo.

Για να ενημερώσετε αργότερα το Solana CLI στην τελευταία έκδοση, μπορείτε να χρησιμοποιήσετε την ακόλουθη εντολή:

$ 
agave-install updateCopy

Εγκατάσταση του Anchor CLI

Το Anchor είναι ένα framework για την ανάπτυξη προγραμμάτων Solana. Το framework Anchor χρησιμοποιεί macros της Rust για να απλοποιήσει τη διαδικασία συγγραφής προγραμμάτων Solana.

Μπορείτε να εγκαταστήσετε το Anchor CLI και τα εργαλεία με δύο τρόπους:

1. Anchor Version Manager (AVM) - Προτεινόμενη μέθοδος εγκατάστασης
2. Χωρίς AVM - Εγκατάσταση απευθείας από το GitHub

$ 
cargo install --git https://github.com/coral-xyz/anchor avm --forceCopy

$ 
avm --versionCopy

$ 
avm install latest
Copy
$ 
avm use latestCopy

$ 
avm install 0.30.1
Copy
$ 
avm use 0.30.1Copy

Για να επαληθεύσετε ότι η εγκατάσταση ήταν επιτυχής, ελέγξτε την έκδοση του Anchor CLI:

$ 
anchor --versionCopy

Θα πρέπει να δείτε μια έξοδο όπως η ακόλουθη:

anchor-cli 0.31.1

error: could not exec the linker cc = note: Permission denied (os error 13)

Node.js και Yarn

Το προεπιλεγμένο αρχείο δοκιμών του Anchor project (TypeScript) που δημιουργείται με την εντολή anchor init απαιτεί Node.js και Yarn. (Το πρότυπο δοκιμών Rust είναι διαθέσιμο χρησιμοποιώντας anchor init --test-template rust)

Permission denied (os error 13)

No such file or directory (os error 2)

Ρύθμιση παραμέτρων Solana

Για να δείτε την τρέχουσα διαμόρφωσή σας:

$ 
solana config getCopy

Θα πρέπει να δείτε μια έξοδο όπως η παρακάτω:

Config File: /Users/test/.config/solana/cli/config.yml
RPC URL: https://api.mainnet-beta.solana.com
WebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)
Keypair Path: /Users/test/.config/solana/id.json
Commitment: confirmed

Το RPC URL και το Websocket URL καθορίζουν το cluster του Solana στο οποίο το CLI κάνει αιτήματα.

Μπορείτε να ενημερώσετε το cluster του Solana CLI χρησιμοποιώντας τις ακόλουθες εντολές:

$ 
solana config set --url mainnet-beta
Copy
$ 
solana config set --url devnet
Copy
$ 
solana config set --url localhost
Copy
$ 
solana config set --url testnetCopy

Μπορείτε επίσης να χρησιμοποιήσετε τις ακόλουθες σύντομες επιλογές:

$ 
solana config set -um    # For mainnet-beta
Copy
$ 
solana config set -ud    # For devnet
Copy
$ 
solana config set -ul    # For localhost
Copy
$ 
solana config set -ut    # For testnetCopy

Η διαδρομή του keypair δείχνει στο προεπιλεγμένο πορτοφόλι Solana (keypair) που χρησιμοποιείται από το Solana CLI για την πληρωμή χρεώσεων συναλλαγών και την ανάπτυξη προγραμμάτων. Από προεπιλογή, αυτό το αρχείο αποθηκεύεται στο ~/.config/solana/id.json.

Δημιουργία πορτοφολιού

Για να στείλετε συναλλαγές χρησιμοποιώντας το Solana CLI, χρειάζεστε ένα πορτοφόλι Solana με SOL.

Για να δημιουργήσετε ένα keypair στην προεπιλεγμένη διαδρομή keypair, εκτελέστε την ακόλουθη εντολή:

$ 
solana-keygen newCopy

Θα πρέπει να δείτε μια έξοδο όπως η παρακάτω:

Generating a new keypair

For added security, enter a BIP39 passphrase

NOTE! This passphrase improves security of the recovery seed phrase NOT the
keypair file itself, which is stored as insecure plain text

BIP39 Passphrase (empty for none):

Wrote new keypair to /Users/test/.config/solana/id.json
===========================================================================
pubkey: 8dBTPrjnkXyuQK3KDt9wrZBfizEZijmmUQXVHpFbVwGT
===========================================================================
Save this seed phrase and your BIP39 passphrase to recover your new keypair:
cream bleak tortoise ocean nasty game gift forget fancy salon mimic amazing
===========================================================================

Για να δείτε τη διεύθυνση του πορτοφολιού σας (δημόσιο κλειδί), εκτελέστε:

$ 
solana addressCopy

Airdrop SOL

Ζητήστε ένα airdrop SOL στο πορτοφόλι σας για να πληρώσετε για συναλλαγές και αναπτύξεις προγραμμάτων.

Ορίστε το cluster σας στο devnet:

$ 
solana config set -udCopy

Στη συνέχεια, ζητήστε ένα airdrop devnet SOL:

$ 
solana airdrop 2Copy

Για να ελέγξετε το υπόλοιπο SOL του πορτοφολιού σας, εκτελέστε την ακόλουθη εντολή:

$ 
solana balanceCopy

Εκτέλεση τοπικού validator

Το Solana CLI περιλαμβάνει έναν ενσωματωμένο test validator για τοπική ανάπτυξη.

Σε ξεχωριστό τερματικό, εκτελέστε την ακόλουθη εντολή για να ξεκινήσετε έναν τοπικό validator:

$ 
solana-test-validatorCopy

$ 
solana config set -ulCopy

Αρχικοποίηση έργου

Για να δημιουργήσετε ένα νέο έργο Anchor, εκτελέστε την ακόλουθη εντολή:

$ 
anchor init <project-name>Copy

Για παράδειγμα, για να δημιουργήσετε ένα project με όνομα my-project, εκτελέστε:

$ 
anchor init my-projectCopy

Αυτή η εντολή δημιουργεί έναν νέο κατάλογο με το όνομα του project και αρχικοποιεί ένα νέο project Anchor με ένα βασικό πρόγραμμα Rust και πρότυπο δοκιμών TypeScript.

Μεταβείτε στον κατάλογο του project:

$ 
cd <project-name>Copy

Δείτε τη δομή αρχείων του project Anchor.

Δημιουργία προγράμματος

Για να δημιουργήσετε το project σας, εκτελέστε την ακόλουθη εντολή:

$ 
anchor buildCopy

Μπορείτε να βρείτε το μεταγλωττισμένο πρόγραμμα στον κατάλογο /target/deploy.

Ανάπτυξη προγράμματος

Για να αναπτύξετε το project σας, εκτελέστε την ακόλουθη εντολή:

$ 
anchor deployCopy

Αυτή η εντολή αναπτύσσει το πρόγραμμά σας στο cluster που καθορίζεται στο αρχείο Anchor.toml.

Δοκιμή προγράμματος

Για να δοκιμάσετε το project σας, εκτελέστε την ακόλουθη εντολή:

$ 
anchor testCopy