Programme deployen

Dieser Abschnitt führt durch den grundlegenden Prozess der Bereitstellung eines Solana-Programms mit der Solana CLI.

CLI-Befehlsreferenz

Schlüsselkonzepte

Bevor wir beginnen, klären wir einige Begriffe:

• Program ID: Die On-Chain-Adresse deines Programms. Benutzer interagieren mit deinem Programm, indem sie auf die Program ID verweisen.
• Program Account: Das On-Chain-Konto, das die Metadaten deines Programms speichert. Die Adresse des program account ist die Program ID. Der program account speichert auch die Adresse des programdata account.
• ProgramData Account: Das On-Chain-Konto, das den bereitgestellten ausführbaren Code deines Programms speichert.
• Programmautorität: Das Konto, das die Berechtigung hat, das Programm zu aktualisieren oder zu schließen. Standardmäßig ist dies dein CLI-Wallet.

Voraussetzungen

$ 
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]

Grundlegende Operationen

Programm bauen

Um ein Programm zu bauen, verwenden Sie den Befehl 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(())
}

Programmgröße und -kosten prüfen

Das Deployen eines Programms erfordert SOL, das basierend auf der Größe des Programms dem Programmkonto zugewiesen wird. Größere Programme kosten mehr SOL für das Deployment.

Überprüfen Sie die Größe Ihres Programms:

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

Berechnen Sie das erforderliche SOL für diese Größe (Bytes):

$ 
solana rent 18504
Copy
[show output]

Programm deployen

Verwenden Sie den Befehl solana program deploy, um Ihr Programm zu deployen:

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

Die angezeigte Program Id ist die permanente Adresse Ihres Programms im Netzwerk.

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

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

Programm aktualisieren

Aktualisieren Sie Ihr Programm mit demselben solana program deploy Befehl:

1. Nehmen Sie Änderungen an Ihrem Programmcode vor
2. Erstellen Sie Ihr Programm neu: cargo build-sbf
3. Führen Sie das Deployment des Updates durch:

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

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

Programmverwaltung

Sobald Ihr Programm deployed ist, gibt es mehrere gängige Befehle zur Verwaltung des Programmkontos.

Programm-Metadaten anzeigen

Um Ihre Programm-Metadaten zu überprüfen, verwenden Sie den solana program show Befehl:

$ 
solana program show 7NxQjW8H8hVcqBKgXbVDWqGQCovHbqDW9p1SJJwUyTpECopy

Beispielausgabe:

$ 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

Programm-Authority übertragen

Um die Programm-Authority auf ein anderes Konto zu übertragen, verwenden Sie den Befehl solana program set-upgrade-authority:

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

Ihr Programm unveränderlich machen

Um Ihr Programm unveränderlich zu machen, verwenden Sie den Befehl solana program set-upgrade-authority mit der Option --final, um die Programm-Authority zu entfernen:

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

Ihr Programm schließen

Um Ihr Programm zu schließen und das dem Programmkonto zugewiesene SOL zurückzufordern, verwenden Sie den Befehl solana program close:

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

Dienstprogramm-Befehle

Alle Programme auflisten

Zeigen Sie alle Programme an, bei denen Ihre aktuelle Wallet die Authority ist:

$ 
solana program show --programsCopy

Beispielausgabe:

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

Ein Deployed Programm herunterladen

Um ein deployed Programm herunterzuladen, verwenden Sie den Befehl solana program dump:

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

Erweiterte Optionen

Deployment-Flags

Wenn das Solana-Netzwerk überlastet ist, verwenden Sie diese Flags, um bei dem Programm-Deployment zu helfen.

Beispielanwendung:

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

Erklärung der Optionen:

• --with-compute-unit-price: Legt priority fee in Mikro-Lamports (0,000001 SOL) pro Compute-Einheit fest. Prüfen Sie die Helius Priority Fee API für aktuelle Raten. Eine priority fee ist eine zusätzliche Gebühr, die an den aktuellen Leader gezahlt wird, um Ihre Transaktion zu priorisieren.
• --max-sign-attempts: Anzahl der Wiederholungsversuche mit einem neuen Blockhash, falls Transaktionen ablaufen. (Standard: 5)
• --use-rpc: Sendet Transaktionen an den konfigurierten RPC. Dieses Flag erfordert eine stake-weighted RPC-Verbindung von Anbietern wie Triton oder Helius.