Comment créer un contrat intelligent pour un calendrier d'acquisition de jetons?

Comprendre les horaires d'acquisition de jetons dans les contrats intelligents

Les horaires d'acquisition de jetons sont des mécanismes utilisés dans les projets de blockchain pour libérer progressivement les jetons aux investisseurs, aux membres de l'équipe ou aux conseillers sur une période définie. Cela garantit un engagement à long terme et empêche des dépotoirs de marché soudains qui pourraient déstabiliser le prix des jetons. La construction d'un contrat intelligent pour un calendrier d'acquisition de jeton implique de définir des paramètres tels que l'heure de début, la durée de la falaise, la durée d'acquisition et la fréquence de libération .

Un contrat d'acquisition bien structuré doit inclure une logique pour le verrouillage des jetons initialement et les libérer progressivement sur les conditions prédéfinies.

Sélection de la blockchain et des outils droits

La plupart des contrats d'acquisition de jetons sont construits sur des blockchains compatibles Ethereum en utilisant la solidité, bien que des alternatives comme Rust (pour Solana) ou vyper existent. Pour ce guide, nous nous concentrons sur le développement basé sur la solidité pour les chaînes compatibles EVM .

• Choisissez un cadre de développement comme Hardhat ou Truffe pour rationaliser la compilation, les tests et le déploiement.
• Utilisez les bibliothèques OpenZeppelin pour les implémentations sécurisées et auditées des contrats ERC20 et d'acquisition.
• Configurez un environnement de nœud local à l'aide d'outils comme Ganache ou Alchemy à des fins de test.

Concevoir la structure du contrat d'acquisition

La structure centrale d'un contrat d'acquisition tourne autour des bénéficiaires de suivi, de leur allocation et du calendrier de libération de jetons.

Les composants clés comprennent:

• Adresses du bénéficiaire - qui reçoit les jetons acquis.
• Timestamp de démarrage de la libération - Lorsque l'acquisition commence.
• Durée de la falaise - Une période d'attente avant les jetons de libération.
• Durée d'acquisition - Temps total sur lequel les jetons sont libérés.
• Indicateur de révocabilité - fonctionnalité facultative permettant l'annulation dans certaines conditions.

Les données de chaque bénéficiaire doivent être stockées dans une structure pour plus de clarté et un accès efficace.

Implémentation de la logique d'acquisition dans Solidity

Pour mettre en œuvre un contrat d'acquisition de base:

1. Importer les contrats Openzeppelin nécessaires - en particulier IERC20 et SafeERC20 .

2. Définissez la structure VestingSchedule avec des champs tels que totalAllocation , releasedAmount , startTime , cliffDuration et vestingDuration .

3. Créez une cartographie de l'adresse à VestingSchedule pour suivre les détails de chaque bénéficiaire.

4. Ajoutez une fonction pour initialiser les horaires d'acquisition pour plusieurs bénéficiaires par le propriétaire.

5. Écrivez une fonction de réclamation qui calcule la quantité de retire en fonction du temps écoulé depuis le début.

6. Assurez-vous un contrôle d'accès approprié à l'aide d'autorisations propriétaires ou basées sur les rôles.

Voici un extrait de code simplifié:

 pragma solidity ^0.8.0; import '@ openzeppelin / contracts / token / erc20 / utils / safeerc20.sol'; Importer '@ Openzeppelin / Contracts / Access / propriétaire.sol';


Le jeton de travail du contrat est propriétaire {


using SafeERC20 for IERC20; struct VestingSchedule { uint256 totalAllocation; uint256 releasedAmount; uint256 startTime; uint256 cliffDuration; uint256 vestingDuration; } IERC20 public token; mapping(address => VestingSchedule) public vestingSchedules; constructor(address _tokenAddress) { token = IERC20(_tokenAddress); } function addVestingSchedule( address beneficiary, uint256 totalAllocation, uint256 startTime, uint256 cliffDuration, uint256 vestingDuration ) external onlyOwner { require(vestingSchedules[beneficiary].totalAllocation == 0, 'Schedule already exists'); vestingSchedules[beneficiary] = VestingSchedule({ totalAllocation: totalAllocation, releasedAmount: 0, startTime: startTime, cliffDuration: cliffDuration, vestingDuration: vestingDuration }); } function claim() external { VestingSchedule storage schedule = vestingSchedules[msg.sender]; require(schedule.totalAllocation > 0, 'No vesting schedule found'); uint256 amount = releasableAmount(msg.sender); require(amount > 0, 'Nothing to claim'); schedule.releasedAmount += amount; token.safeTransfer(msg.sender, amount); } function releasableAmount(address beneficiary) public view returns (uint256) { VestingSchedule memory schedule = vestingSchedules[beneficiary]; if (block.timestamp < schedule.startTime + schedule.cliffDuration) { return 0; } uint256 elapsedTime = block.timestamp - schedule.startTime; if (elapsedTime >= schedule.vestingDuration) { return schedule.totalAllocation - schedule.releasedAmount; } uint256 vestedAmount = (schedule.totalAllocation * elapsedTime) / schedule.vestingDuration; return vestedAmount - schedule.releasedAmount; }
 }

Tester et déployer le contrat d'acquisition

Avant de se déployer sur un réseau en direct, des tests approfondis sont essentiels.

• Écrivez des tests unitaires couvrant des cas de bord comme réclamer avant la falaise, après l'acquisition complète et les réclamations partielles.
• Simulez différents horodatages à l'aide des aides à la durée de Hardhat.
• Vérifiez les contrôles de propriété pour garantir que seules les parties autorisées peuvent ajouter des horaires.
• Déployez le contrat à l'aide de scripts et vérifiez-le sur des explorateurs de blocs comme BSCSCAN ou Etherscan.
• Fonds le contrat avec le nombre approprié de jetons avant d'initialiser les horaires.

Une fois déployé, utilisez des interfaces frontales ou des appels directs via des portefeuilles comme Metamask ou des outils comme Remix pour interagir avec le contrat.

Questions fréquemment posées

Q: Puis-je modifier un calendrier d'acquisition une fois qu'il a été défini? R: En règle générale, une fois un calendrier d'acquisition ajouté, il ne peut pas être modifié, sauf codé explicitement avec une fonction de mise à jour. La plupart des projets préfèrent l'immuabilité pour des raisons de confiance.

Q: Que se passe-t-il si un bénéficiaire perd accès à son portefeuille? R: Les jetons restent enfermés dans le contrat jusqu'à ce que la réclamation. Il n'y a aucun mécanisme de récupération à moins que le contrat ne comprenne une fonction de transfert d'urgence, qui est découragée pour des raisons de sécurité.

Q: La révocation d'un calendrier d'acquisition est-elle possible? R: Oui, mais seulement si le contrat prend en charge la logique de révocation. L'acquisition révocable permet au propriétaire d'annuler les réclamations futures, généralement utilisées pour les membres de l'équipe quittant un projet.

Q: Comment gérer plusieurs types de jetons dans un seul contrat d'acquisition? R: Vous devrez soit déployer des contrats séparés par jeton ou concevoir un contrat d'acquisition multi-toenking avec des mappages et des chèques supplémentaires pour chaque adresse de jeton.