Comment déployer un Smart Contract sur le réseau Solana ?

Comprendre l'architecture de contrat intelligent de Solana

1. Solana n'utilise pas de contrats intelligents compatibles EVM de style Ethereum, mais s'appuie sur des programmes écrits en Rust ou C qui sont déployés en tant qu'exécutables en chaîne.

2. Ces programmes fonctionnent selon un modèle d'exécution unique dans lequel les comptes stockent à la fois les données et le code exécutable, et tous les changements d'état nécessitent une signature explicite du compte.

3. Chaque programme doit déclarer ses dépendances sur des comptes spécifiques lors de l'appel, imposant une séparation stricte entre la logique des instructions et la propriété des données.

4. Les programmes sont immuables une fois déployés : aucun mécanisme de mise à niveau n'existe sans le déploiement d'un nouvel ID de programme et la migration manuelle de l'état.

5. Le runtime impose une exonération de loyer : les comptes contenant du code de programme ou des données persistantes doivent maintenir un solde minimum pour éviter d'être purgés par le réseau.

Configuration de l'environnement de développement

1. Installez Solana CLI à l'aide du script d'installation officiel, qui configure solana-test-validator, solana-cli et les outils de gestion de clés associés.

2. Initialisez une nouvelle paire de clés avec solana-keygen new pour générer un portefeuille pour le déploiement et la signature des transactions.

3. Configurez la CLI pour cibler devnet ou mainnet-beta à l'aide de solana config set --url , en garantissant l'alignement avec la portée de déploiement prévue.

4. Installez la chaîne d'outils Rust, y compris cargo-build-bpf , l'extension de build spécifique à Solana requise pour compiler les programmes dans le bytecode BPF.

5. Créez un nouvel échafaudage de programme à l'aide des modèles solana-program-library ou de la commande Anchor Init si vous utilisez le framework Anchor.

Écrire et compiler un programme de base

1. Définissez une fonction de point d'entrée annotée avec #[program] qui mappe les variantes d'instruction aux fonctions de gestionnaire.

2. Implémentez des gestionnaires d'instructions acceptant &[AccountInfo] et validant les autorisations de compte, la propriété et les indicateurs de mutabilité.

3. Utilisez borsh ou bytemuck pour la sérialisation déterministe des structures transmises entre le client et le programme.

4. Compilez le programme à l'aide de cargo build-bpf , en produisant un fichier .so situé dans le répertoire target/deploy/.

5. Vérifiez que l'artefact compilé correspond à la version BPF et à la disposition ABI attendues à l'aide du programme Solana affiché sur un validateur local.

Déploiement sur le réseau

1. Démarrez solana-test-validator localement pour simuler les conditions du réseau et confirmer le comportement du programme avant le déploiement en direct.

2. Airdrop SOL sur la paire de clés de votre déployeur à l'aide de Solana Airdrop pour couvrir les frais de transaction et les coûts de location.

3. Déployez le programme compilé avec solana program déployer , en spécifiant le chemin .so et en confirmant l'ID du programme résultant.

4. Attribuez des comptes inscriptibles pour l'état du programme en appelant le tampon d'écriture du programme Solana suivi de l'autorité de réglage du tampon du programme Solana si nécessaire.

5. Confirmez le déploiement réussi en interrogeant le compte du programme avec solana program show et en vérifiant que le compte contient des données exécutables et le champ propriétaire correct.

Foire aux questions

Q : Puis-je redéployer un programme vers la même adresse ? R : Non. Chaque déploiement génère un nouvel ID de programme. La réutilisation d'une adresse nécessite le déploiement d'un nouveau programme et le transfert manuel de l'état de l'ancienne instance.

Q : Pourquoi mon déploiement échoue-t-il avec le message « Le compte n'est pas exonéré de loyer » ? R : Le compte du programme ou les comptes de données associés ne disposent pas de suffisamment de lamports pour atteindre les seuils d'exonération de loyer. Financez-les explicitement en utilisant le transfert Solana .

Q : Ai-je besoin d’un compte distinct pour chaque gestionnaire d’instructions ? R : Non. Le routage des instructions se produit au sein d’un seul programme binaire. Les gestionnaires sont sélectionnés au moment de l'exécution en fonction des octets discriminants d'instruction transmis par le client.

Q : Que se passe-t-il si une instruction de programme dépasse le budget de calcul ? R : La transaction est annulée avec l'erreur ComputeBudgetExceeded. Optimisez les boucles, limitez les allocations de mémoire et utilisez msg ! avec parcimonie pour réduire la consommation du cycle.