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

Αυτή η ενότητα παρουσιάζει τη βασική διαδικασία εγκατάστασης ενός προγράμματος Solana χρησιμοποιώντας το Solana CLI.

Αναφορά εντολών CLI

Βασικές έννοιες

Πριν προχωρήσουμε, ας διευκρινίσουμε κάποια ορολογία:

• Program ID: Η διεύθυνση του προγράμματός σας στο blockchain. Οι χρήστες αλληλεπιδρούν με το πρόγραμμά σας αναφέροντας το Program ID.
• Program Account: Ο λογαριασμός στο blockchain που αποθηκεύει τα μεταδεδομένα του προγράμματός σας. Η διεύθυνση του program account είναι το Program ID. Το program account επίσης αποθηκεύει τη διεύθυνση του ProgramData Account.
• ProgramData Account: Ο λογαριασμός στο blockchain που αποθηκεύει τον εκτελέσιμο κώδικα του προγράμματός σας.
• Program Authority: Ο λογαριασμός που έχει άδεια να ενημερώνει ή να κλείνει το πρόγραμμα. Από προεπιλογή, αυτό είναι το πορτοφόλι του CLI σας.

Προαπαιτούμενα

$ 
solana-keygen newCopy

$ 
solana config get
Copy
[show output]

$ 
solana config set --url mainnet-beta
Copy
$ 
solana config set --url devnet
Copy
$ 
solana config set --url localhost
Copy
$ 
solana config set --url testnet
Copy
$ 
solana config set --url "https://your-rpc-url.com"Copy

$ 
solana airdrop 2
Copy
[show output]

$ 
solana balance
Copy
[show output]

Βασικές λειτουργίες

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

Για να δημιουργήσετε ένα πρόγραμμα, χρησιμοποιήστε την εντολή cargo build-sbf:

$ 
cargo build-sbfCopy

use solana_program::{
    account_info::AccountInfo, entrypoint, entrypoint::ProgramResult, msg, pubkey::Pubkey,
};

entrypoint!(process_instruction);

pub fn process_instruction(
    _program_id: &Pubkey,
    _accounts: &[AccountInfo],
    _instruction_data: &[u8],
) -> ProgramResult {
    msg!("Hello, Solana!");
    Ok(())
}

$ 
cargo build-sbfCopy

$ 
cargo build-sbfCopy

use solana_program::{
    account_info::AccountInfo, entrypoint, entrypoint::ProgramResult, msg, pubkey::Pubkey,
};

entrypoint!(process_instruction);

pub fn process_instruction(
    _program_id: &Pubkey,
    _accounts: &[AccountInfo],
    _instruction_data: &[u8],
) -> ProgramResult {
    msg!("Hello, Solana!");
    Ok(())
}

Έλεγχος Μεγέθους και Κόστους Προγράμματος

Η ανάπτυξη ενός προγράμματος απαιτεί SOL που θα διατεθεί στον λογαριασμό του προγράμματος με βάση το μέγεθος του προγράμματος. Τα μεγαλύτερα προγράμματα κοστίζουν περισσότερο SOL για ανάπτυξη.

Ελέγξτε το μέγεθος του προγράμματός σας:

$ 
wc -c < ./target/deploy/hello_world.so
Copy
[show output]

Υπολογίστε το απαιτούμενο SOL για αυτό το μέγεθος (bytes):

$ 
solana rent 18504
Copy
[show output]

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

Χρησιμοποιήστε την εντολή solana program deploy για να αναπτύξετε το πρόγραμμά σας:

$ 
solana program deploy ./target/deploy/hello_world.so
Copy
[show output]

Το Program Id που εμφανίζεται είναι η μόνιμη διεύθυνση του προγράμματός σας στο δίκτυο.

$ 
solana program deploy ./target/deploy/hello_world.so --program-id ./custom-keypair.jsonCopy

$ 
solana-keygen new -o ./custom-keypair.jsonCopy

Ενημέρωση προγράμματος

Ενημερώστε το πρόγραμμά σας χρησιμοποιώντας την ίδια εντολή solana program deploy:

1. Κάντε αλλαγές στον κώδικα του προγράμματός σας
2. Επαναδημιουργήστε το πρόγραμμά σας: cargo build-sbf
3. Αναπτύξτε την ενημέρωση:

$ 
solana program deploy ./target/deploy/hello_world.so
Copy
[show output]

$ 
solana program extend 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpE 1000
Copy
[show output]

Διαχείριση προγράμματος

Μόλις αναπτυχθεί το πρόγραμμά σας, υπάρχουν αρκετές συνηθισμένες εντολές για τη διαχείριση του λογαριασμού του προγράμματος.

Προβολή μεταδεδομένων προγράμματος

Για να ελέγξετε τα μεταδεδομένα του προγράμματός σας, χρησιμοποιήστε την εντολή solana program show:

$ 
solana program show 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpECopy

Παράδειγμα εξόδου:

$ solana program show 7283x8k8fyBcfaFLyPsxbd2VV1AMmZFP7FNoyTXVKJw7
Program Id: 7283x8k8fyBcfaFLyPsxbd2VV1AMmZFP7FNoyTXVKJw7
Owner: BPFLoaderUpgradeab1e11111111111111111111111
ProgramData Address: Gqn7YQVCP8NtYV1qkEqR4Udhj8EJ3fkikvS7HskCNQ7c
Authority: 5kh6HxYZiAebF8HWLsUWod2EaQQ6iWHpHYCz8UcmFbM1
Last Deployed In Slot: 6573
Data Length: 18504 (0x4848) bytes
Balance: 0.12999192 SOL

Μεταφορά της authority του προγράμματος

Για να μεταφέρετε την authority του προγράμματος σε διαφορετικό λογαριασμό, χρησιμοποιήστε την εντολή solana program set-upgrade-authority:

$ 
solana program set-upgrade-authority 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpE --new-upgrade-authority ./new-authority-keypair.jsonCopy

Κάντε το πρόγραμμά σας αμετάβλητο

Για να κάνετε το πρόγραμμά σας αμετάβλητο, χρησιμοποιήστε την εντολή solana program set-upgrade-authority με τη σημαία --final για να αφαιρέσετε την authority του προγράμματος:

$ 
solana program set-upgrade-authority 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpE --final
Copy
[show output]

Κλείσιμο του προγράμματός σας

Για να κλείσετε το πρόγραμμά σας και να ανακτήσετε το SOL που έχει κατανεμηθεί στον λογαριασμό του προγράμματος, χρησιμοποιήστε την εντολή solana program close:

$ 
solana program close 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpE --bypass-warning
Copy
[show output]

Εντολές βοηθητικών προγραμμάτων

Λίστα όλων των προγραμμάτων

Δείτε όλα τα προγράμματα όπου το τρέχον πορτοφόλι σας είναι η authority:

$ 
solana program show --programsCopy

Παράδειγμα εξόδου:

Program Id                                       | Slot       | Authority                                      | Balance
-------------------------------------------------|------------|------------------------------------------------|-------------
7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpE     | 249885434  | 5kh6HxYZiAebF8HWLsUWod2EaQQ6iWHpHYCz8UcmFbM1   | 0.12999192
3KSGCk4m5hqJkTjPHBXUCPcqMwJnK3VmkqEsFUKKGJPK     | 249883212  | 5kh6HxYZiAebF8HWLsUWod2EaQQ6iWHpHYCz8UcmFbM1   | 0.28654328

Λήψη ενός αναπτυγμένου προγράμματος

Για να κατεβάσετε ένα αναπτυγμένο πρόγραμμα, χρησιμοποιήστε την εντολή solana program dump:

$ 
solana program dump 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpE ./downloaded_program.so
Copy
[show output]

Προηγμένες επιλογές

Σημαίες ανάπτυξης

Όταν το δίκτυο Solana είναι συμφορημένο, χρησιμοποιήστε αυτές τις σημαίες για να βοηθήσουν στην ανάπτυξη του προγράμματος.

Παράδειγμα χρήσης:

$ 
solana program deploy ./target/deploy/hello_world.so \
    --with-compute-unit-price 10000 \
    --max-sign-attempts 10 \
    --use-rpcCopy

Επεξήγηση επιλογών:

• --with-compute-unit-price: Ορίστε το τέλος προτεραιότητας σε μικρο-λάμπορτς (0.000001 SOL) ανά μονάδα υπολογισμού. Ελέγξτε το Helius Priority Fee API για τις τρέχουσες τιμές. Το τέλος προτεραιότητας είναι ένα επιπλέον τέλος που καταβάλλεται στον τρέχοντα ηγέτη για να δώσει προτεραιότητα στη συναλλαγή σας.
• --max-sign-attempts: Αριθμός επαναλήψεων με νέο blockhash εάν οι συναλλαγές λήξουν. (Προεπιλογή: 5)
• --use-rpc: Αποστολή συναλλαγών στο διαμορφωμένο RPC. Αυτή η σημαία απαιτεί σύνδεση RPC με στάθμιση συμμετοχής από παρόχους όπως το Triton ή το Helius.