Déploiement sur Sepolia

Sepolia est le réseau de test public d'Ethereum (chain ID 11155111). Y déployer BlockLucky permet une démonstration publique avec le vrai coordinateur Chainlink VRF, un upkeep Chainlink Automation et un code source vérifiable sur Etherscan. Cette page donne la procédure complète, de la création des comptes à la configuration du backend. Elle reprend le pas à pas de smart-contract/README.md.

#Vue d'ensemble

flowchart TD
    a["1. Comptes : déployeur, multisig, trésorerie, opérateur"] --> b["2. ETH et LINK Sepolia sur les faucets"]
    b --> c["3. Accès RPC et clé Etherscan"]
    c --> d["4. Secrets dans le keystore Hardhat"]
    d --> e["5. npm run vrf:sepolia"]
    e --> f["6. npm run deploy:sepolia"]
    f --> g["7. acceptOwnership par le multisig"]
    g --> h["8. npm run automation:sepolia et npm run verify:sepolia"]
    h --> i["9. Configuration du backend"]
    i --> j["10. Contrôles après déploiement"]

#1. Comptes

Chaque rôle du contrat a son propre compte. La répartition est calculée par planRoles de scripts/lib/roles.ts et appliquée par applyRoles :

Le script refuse une adresse absente, invalide ou nulle, et un administrateur identique à l'opérateur. ALLOW_SHARED_ROLES=true lève ce dernier refus ; il n'est pas recommandé, puisque la clé de l'opérateur vit sur le serveur.

#2. Fonds de test

Faucets possibles : sepoliafaucet.com, le faucet Web3 de Google Cloud et faucets.chain.link (ETH et LINK). La dotation de bienvenue est le poste dominant : la réduire sur Sepolia, où l'ETH de test se distribue au compte-gouttes, en gardant de quoi payer un ticket et ses frais.

#3. Accès RPC et clé Etherscan

• Créer un accès RPC Sepolia chez un fournisseur (Alchemy, Infura) ou utiliser un nœud public. Noter l'URL HTTPS.
• Créer une clé d'API sur Etherscan, pour la vérification du code source.

#4. Secrets dans le keystore Hardhat

hardhat.config.ts lit trois secrets par configVariable, qui cherche d'abord dans le keystore chiffré de Hardhat, puis dans les variables d'environnement. Depuis smart-contract/, saisir chacun ; Hardhat demande la valeur et un mot de passe de keystore, sans écho à l'écran :

npx hardhat keystore set SEPOLIA_PRIVATE_KEY

npx hardhat keystore set SEPOLIA_RPC_URL

npx hardhat keystore set ETHERSCAN_API_KEY

npx hardhat keystore list affiche les clés enregistrées, sans leurs valeurs. Le keystore est stocké hors du dépôt (npx hardhat keystore path en donne l'emplacement) : aucun secret ne passe par Git ni par l'historique du shell.

#5. Abonnement Chainlink VRF

scripts/setup-vrf-sepolia.ts crée et finance l'abonnement VRF v2.5 :

npm run vrf:sepolia

1. Il vérifie le réseau et que le solde du déployeur dépasse le montant à verser.
2. Il réutilise l'abonnement de SEPOLIA_VRF_SUBSCRIPTION_ID ou de deployments/sepolia-vrf.json s'il existe (rechargement seulement) ; sinon, ou avec VRF_NEW_SUBSCRIPTION=true, il appelle createSubscription sur le coordinateur.
3. Il verse VRF_FUND_ETH ETH Sepolia (0,5 par défaut) par fundSubscriptionWithNative.
4. Il écrit deployments/sepolia-vrf.json (coordinateur, identifiant, propriétaire, soldes ETH et LINK, date) et affiche SEPOLIA_VRF_SUBSCRIPTION_ID=<identifiant>.

Le coordinateur est 0x9DdfaCa8183c41ad55329BdeeD9F6A8d53168B1B, modifiable par SEPOLIA_VRF_COORDINATOR. Un abonnement créé à la main sur vrf.chain.link et financé en LINK reste possible : passer alors son identifiant par SEPOLIA_VRF_SUBSCRIPTION_ID.

#6. Déploiement

Variables lues par scripts/deploy-sepolia.ts :

Sous PowerShell, en adaptant les adresses :

$env:MAIRIE_ADMIN_ADDRESS = "0x..."; $env:MAIRIE_TREASURY_ADDRESS = "0x..."; $env:OPERATOR_ADDRESS = "0x..."; $env:POAP_BASE_URI = "https://api.etherbay.tech/api/v1/lottery/poap/"; npm run deploy:sepolia

En Bash :

MAIRIE_ADMIN_ADDRESS=0x... MAIRIE_TREASURY_ADDRESS=0x... OPERATOR_ADDRESS=0x... POAP_BASE_URI=https://api.etherbay.tech/api/v1/lottery/poap/ npm run deploy:sepolia

#Vérifications faites par le script

Avant toute dépense, le script s'arrête si :

#Ce que fait le script

1. Déploie BlockLucky avec le déployeur comme administrateur provisoire, la trésorerie prévue et la configuration VRF : callbackGasLimit 500 000, requestConfirmations 3, drawTimeout 24 heures, nativePayment à true si l'abonnement a un solde en ETH (cas de npm run vrf:sepolia), sauf VRF_NATIVE_PAYMENT.
2. Déploie BlockLuckyPOAP(déployeur, POAP_BASE_URI).
3. Si le déployeur possède l'abonnement, appelle addConsumer(subId, lottery) ; sinon, l'affiche dans les actions restantes.
4. Accorde DEFAULT_ADMIN_ROLE à l'administrateur sur les deux contrats, OPERATOR_ROLE à l'opérateur et PAUSER_ROLE au pauseur sur BlockLucky, MINTER_ROLE à l'opérateur sur BlockLuckyPOAP, positionne la trésorerie si besoin (setTreasury) et propose la propriété VRF (transferOwnership(VRF_OWNER_ADDRESS)).
5. Retire au déployeur OPERATOR_ROLE, PAUSER_ROLE et MINTER_ROLE, puis le fait renoncer à DEFAULT_ADMIN_ROLE (renounceRole) : aucune clé chaude ne garde le pouvoir d'administration.
6. Relit les titulaires (readRoleHolders) et s'arrête sur « Rôles incohérents » si l'un manque ou si le déployeur a gardé un rôle (roleProblems).
7. Écrit deployments/sepolia.json : réseau, bloc de déploiement, adresses, configuration VRF (nativePayment, propriétaire de l'abonnement, consumerAdded), plan de rôles appliqué (roles, avec deployerRenouncedAdmin et vrfOwnershipPending), arguments des constructeurs (constructorArgs) et configuration des tours.
8. Affiche le tableau des titulaires, le bloc de déploiement et les actions restantes.

La répartition des rôles est couverte par test/roles.test.ts sur le réseau Hardhat (voir Tests) ; le script lui-même n'est exécuté par aucun test.

#7. Actions du multisig

La propriété ConfirmedOwner de Chainlink se transfère en deux temps : le script a appelé transferOwnership(VRF_OWNER_ADDRESS), et le nouveau propriétaire doit appeler acceptOwnership() sur BlockLucky, depuis l'onglet « Write Contract » d'Etherscan ou le Transaction Builder du Safe. Tant que ce n'est pas fait, le déployeur reste propriétaire et peut changer le coordinateur VRF. Le script rappelle cette action en fin d'exécution.

Si l'abonnement VRF n'appartient pas au déployeur, son propriétaire ajoute aussi BlockLucky comme consommateur sur vrf.chain.link. Sans cela, tout requestDraw échoue.

#8. Automation et vérification sur Etherscan

npm run automation:sepolia

Cette commande inscrit l'upkeep Chainlink Automation et l'ajoute à deployments/sepolia.json (voir Chainlink Automation).

npm run verify:sepolia

scripts/verify-sepolia.ts publie le code source des deux contrats sur Etherscan par verifyContract de @nomicfoundation/hardhat-verify, avec les arguments de constructeur enregistrés dans deployments/sepolia.json, et affiche le lien https://sepolia.etherscan.io/address/<adresse>#code. Il lit ETHERSCAN_API_KEY dans le keystore. Le compilateur et ses réglages (0.8.34, prague, optimiseur à 200) sont repris de la configuration.

#9. Configuration du backend

Renseigner dans l'environnement du backend (voir Variables d'environnement) :

Le fonctionnement du backend en mode on-chain est détaillé dans Intégration blockchain du backend, le déploiement du serveur dans Déploiement sur etherbay.tech.

#10. Contrôles après déploiement

Pour un premier essai rapide, déployer avec une durée courte (ROUND_DURATION_SECONDS=600), puis faire remettre la durée normale par le multisig (setRoundConfig), qui s'appliquera au tour suivant.

#Redéployer

Un contrat déployé ne se modifie pas. Corriger un bug ou changer une règle impose de redéployer et de reconfigurer : voir Exploitation du contrat.