Bridge de Base vers Chiliz Chain

Pour relier un jeton existant de Base vers Chiliz Chain, vous devez écrire et déployer deux contrats intelligents distincts : un OFT Adapter sur la chaîne où le jeton existe déjà (Base) et un Native OFT sur la chaîne de destination (Chiliz Chain).

Notez que LayerZero fournissent leur propre QuickStart pour les contrats OFT, ainsi qu’un tutoriel pour apprendre à frapper de Base vers une autre chaîne EVM comme Chiliz Chain. Ce tutoriel utilise Optimism comme chaîne cible, mais vous pouvez le remplacer par les détails de Chiliz Chain.

Prérequis

Ce guide nécessite ce qui suit :

• Une adresse de contrat de jeton ERC20 sur Base.

• Un portefeuille Web3 (comme MetaMask) configuré pour fonctionner à la fois avec Base et Chiliz Chain.

  • Voir ici pour la configuration RPC de Base Mainnet.

  • Voir ici pour la configuration RPC de Chiliz Chain.

• Assez de jetons de gaz sur chaque chaîne pour payer les déploiements des contrats ainsi que les frais de gaz pour l’envoi des messages.

  • Sur Base : des jetons ETH.

  • Sur Chiliz Chain : des jetons CHZ.

Nous allons utiliser Hardhat comme environnement de développement, ainsi que Node/npx.

Étape 1 : développement du contrat

Préparation de l’ OFTAdapter sur Base

Il s’agit d’une étape préparatoire, ne le déployez pas tout de suite ! Vous le déploierez à l’étape 3.

Le OFTAdapter Le contrat agit comme un coffre-fort pour votre jeton existant. Lorsque les utilisateurs transfèrent leurs jetons depuis Base, ce contrat verrouille les jetons ERC20 d’origine.

Créez un nouveau fichier nommé BaseTokenAdapter.sol dans votre dossier contracts :

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import { OFTAdapter } from "@layerzerolabs/lz-evm-oapp-v2/contracts/oft/OFTAdapter.sol";
import { Ownable } from "@openzeppelin/contracts/access/Ownable.sol";

contract BaseTokenAdapter is OFTAdapter {
    constructor(
        address _token,      // L’adresse de votre jeton EXISTANT sur Base
        address _lzEndpoint, // L’adresse du LayerZero V2 Endpoint sur Base
        address _delegate    // L’adresse capable d’effectuer des modifications de configuration (généralement votre portefeuille)
    ) OFTAdapter(_token, _lzEndpoint, _delegate) Ownable(_delegate) {}
}

Comme vous pouvez le voir, ce contrat étend le contrat LayerZero OFT Adapter, ainsi qu’un contrat standard Ownable.sol pour attribuer les clés d’administration. Vous avez besoin des deux afin que vous seul puissiez relier les chaînes en toute sécurité.

Lors du déploiement sur Base Mainnet, vous devez passer l’adresse du contrat de votre jeton existant en tant que _token et l’adresse Base Endpoint V2 (0x1a44076050125825900e736c501f859c50fE728c) en tant que _lzEndpoint.

Voir ici tous les endpoints disponibles pour Chiliz Chain :

Base Mainnet - LayerZeroLayerZero Documentation

Préparation de l’ OFT sur Chiliz Chain

Comme le jeton n’existe pas encore nativement sur Chiliz Chain, vous devez déployer un contrat OFT standard. Ce contrat a l’autorité de frapper de nouveaux jetons lorsqu’il reçoit un message valide du OFT Adapter déployé sur Base, et de les brûler lorsque les utilisateurs effectuent le retour du bridge.

Créez un nouveau fichier nommé ChilizTokenOFT.sol dans votre dossier contracts :

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import { OFT } from "@layerzerolabs/lz-evm-oapp-v2/contracts/oft/OFT.sol";
import { Ownable } from "@openzeppelin/contracts/access/Ownable.sol";

contract ChilizTokenOFT is OFT {
    constructor(
        string memory _name,   // Le nom du jeton (doit correspondre à votre jeton Base)
        string memory _symbol, // Le symbole du jeton (doit correspondre à votre jeton Base)
        address _lzEndpoint,   // L’adresse du LayerZero V2 Endpoint sur Chiliz Chain
        address _delegate      // L’adresse capable d’effectuer des modifications de configuration
    ) OFT(_name, _symbol, _lzEndpoint, _delegate) Ownable(_delegate) {}
}

Comme vous pouvez le voir, ce contrat étend le contrat LayerZero OFT ainsi qu’un contrat standard Ownable.sol pour les mêmes raisons que celles citées ci-dessus.

Lors du déploiement sur Chiliz Chain, assurez-vous que les _name et le _symbol correspondent à votre jeton d’origine sur Base afin d’éviter toute confusion chez les utilisateurs. Passez l’adresse Chiliz Chain Endpoint V2 (0x6F475642a6e85809B1c36Fa62763669b1b48DD5B) comme _lzEndpoint.

Voir ici tous les endpoints disponibles pour Chiliz Chain :

Chiliz Mainnet - LayerZeroLayerZero Documentation

Étape 2 : configuration LayerZero

Une fois vos contrats prêts, vous devez indiquer à l’outillage LayerZero comment ils se connectent. Cela se fait à l’aide d’un layerzero.config.ts fichier situé à la racine de votre projet Hardhat.

Ce fichier de configuration agit comme le plan de votre architecture inter-chaînes. Il associe vos contrats intelligents déployés à leurs identifiants de endpoint LayerZero (EID) respectifs et définit les voies (connexions) entre eux.

Le Générateur de configuration simple est la méthode recommandée pour générer la configuration de câblage, car il automatise le câblage bidirectionnel et applique en coulisses les configurations de sécurité recommandées.

Créez ou mettez à jour votre fichier layerzero.config.ts à la racine de votre projet Hardhat :

import { ExecutorOptionType } from '@layerzerolabs/lz-v2-utilities';
import { OAppEnforcedOption, OmniPointHardhat } from '@layerzerolabs/toolbox-hardhat';
import { EndpointId } from '@layerzerolabs/lz-definitions';
import { generateConnectionsConfig } from '@layerzerolabs/metadata-tools';

// Définir les contrats
const baseContract: OmniPointHardhat = {
    eid: EndpointId.BASE_V2_MAINNET,
    contractName: 'BaseTokenAdapter',
};

const chilizContract: OmniPointHardhat = {
    eid: EndpointId.CHILIZ_V2_MAINNET,
    contractName: 'ChilizNativeOFT',
};

// Définir les limites de gas EVM standard (options imposées)
const EVM_ENFORCED_OPTIONS: OAppEnforcedOption[] = [
    {
        msgType: 1,  // Transfert OFT standard
        optionType: ExecutorOptionType.LZ_RECEIVE,
        gas: 200000, // Limite de gas d’exécution
        value: 0,    // Native drop (0 pour les transferts standards)
    },
];

// Exporter la configuration générée
export default async function () {
    return {
        contracts: [
            { contract: baseContract },
            { contract: chilizContract },
        ],
        // Le générateur crée automatiquement les voies A->B et B->A !
        connections: await generateConnectionsConfig([
            [
                baseContract,      // Source
                chilizContract,    // Destination
                [['LayerZero Labs'], []], // Configuration DVN par défaut
                [1, 1],                   // Confirmations de bloc
                [EVM_ENFORCED_OPTIONS, EVM_ENFORCED_OPTIONS], // Options d’exécution [vers Chiliz, vers Base]
            ],
        ]),
    };
}

Le tableau [EVM_ENFORCED_OPTIONS, EVM_ENFORCED_OPTIONS] indique à l’Executor LayerZero d’imposer 200 000 unités de gas lors de la livraison du message vers Chiliz, et identiquement 200 000 unités de gas lors du retour du message vers Base.

Étape 3 : flux de déploiement

Avec vos contrats écrits et votre layerzero.config.ts préparé, il est temps de déployer les contrats sur leurs réseaux respectifs. La boîte à outils LayerZero V2 s’appuie sur le plugin hardhat-deploy pour gérer les déploiements efficacement.

Vous devrez créer deux scripts de déploiement dans le deploy/ répertoire de votre projet : un pour Base Mainnet et un pour Chiliz Chain Mainnet.

Le script de déploiement de l’Adapter Base

Créez un fichier nommé 01_deploy_base_adapter.ts dans votre deploy/ dossier. Ce script transmet l’adresse de votre jeton existant et l’adresse Base Endpoint V2 au constructeur.

import { DeployFunction } from 'hardhat-deploy/types';

const deployAdapter: DeployFunction = async ({ getNamedAccounts, deployments }) => {
    const { deploy } = deployments;
    const { deployer } = await getNamedAccounts();

    // L’adresse de votre jeton ERC-20 existant sur Base
    const TOKEN_ADDRESS = "0xYourTokenAddressHere"; 
    
    // L’adresse Base Mainnet Endpoint V2
    const BASE_ENDPOINT_V2 = "0x1a44076050125825900e736c501f859c50fE728c";

    console.log("Déploiement de l’OFTAdapter sur Base Mainnet...");

    await deploy('BaseTokenAdapter', {
        from: deployer,
        args: [
            TOKEN_ADDRESS,       // _token
            BASE_ENDPOINT_V2,    // _lzEndpoint
            deployer             // _delegate (propriétaire)
        ],
        log: true,
        waitConfirmations: 2,
    });
};

export default deployAdapter;
deployAdapter.tags = ['BaseTokenAdapter'];

Le script de déploiement OFT de Chiliz Chain

Créez un second fichier nommé 02_deploy_chiliz_oft.ts dans votre deploy/ dossier. Ce script initialise le nouveau Native OFT sur Chiliz Chain.

import { DeployFunction } from 'hardhat-deploy/types';

const deployOFT: DeployFunction = async ({ getNamedAccounts, deployments }) => {
    const { deploy } = deployments;
    const { deployer } = await getNamedAccounts();

    // Détails du jeton (doivent correspondre à votre jeton Base)
    const TOKEN_NAME = "My Token";
    const TOKEN_SYMBOL = "TKN";

    // L’adresse Chiliz Chain Mainnet Endpoint V2 
    const CHILIZ_ENDPOINT_V2 = "0x6F475642a6e85809B1c36Fa62763669b1b48DD5B";

    console.log("Déploiement du Native OFT sur Base Mainnet...");

    await deploy('BaseTokenOFT', {
        from: deployer,
        args: [
            TOKEN_NAME,           // _name
            TOKEN_SYMBOL,         // _symbol
            CHILIZ_ENDPOINT_V2,   // _lzEndpoint
            deployer              // _delegate (propriétaire)
        ],
        log: true,
        waitConfirmations: 2,
    });
};

export default deployOFT;
deployOFT.tags = ['BaseTokenOFT'];

Exécution des déploiements

Assurez-vous que votre hardhat.config.ts a les URL RPC et les clés privées correctement configurées pour Base et Chiliz Chain.

Connecting to Base - Base DocumentationBase documentation

Se connecter via RPC

Exécutez les commandes suivantes dans votre terminal pour déployer les contrats :

# 1. Déployer l’Adapter sur Base
npx hardhat deploy --network chiliz --tags BaseTokenAdapter

# 2. Déployer le Native OFT sur Chiliz Chain
npx hardhat deploy --network base --tags ChilizTokenOFT

Une fois les déploiements terminés, Hardhat enregistrera les adresses des contrats dans un deployments/ dossier. L’outillage LayerZero lira automatiquement ces adresses lorsque nous exécuterons la commande de liaison à l’étape suivante.

Étape 4 : câblage et pairage

À ce stade, vos BaseTokenAdapter et le ChilizTokenOFT contrats sont déployés sur chaque chaîne, mais ils sont complètement isolés. Si le contrat Chiliz Chain reçoit un message lui ordonnant de frapper des jetons, il doit savoir que le message provient bien de votre Adapter sur Base, et non d’un acteur malveillant.

Vous devez établir cette confiance en « reliant » cryptographiquement les contrats entre eux en tant que pairs.

Cela se fait en exécutant la commande wire , qui générera et exécutera des transactions sur Chiliz et Base.

Que se passe-t-il en coulisses ?

Une configuration complète de voie LayerZero V2 nécessite en réalité 6 transactions sur chaque chaîne :

• setSendLibrary: assigne la MessageLib LayerZero responsable de l’envoi des messages (par exemple, la configurer pour utiliser la bibliothèque d’envoi V2).

• setReceiveLibrary: assigne la MessageLib responsable de la réception des messages. (Inclut un gracePeriod, généralement défini sur 0).

• setConfig (Send Library) : définit les Decentralized Verifier Networks (DVN) et les Executors spécifiques pour les messages sortants.

• setConfig (Receive Library) : définit les DVN spécifiques requis pour vérifier les messages entrants.

• setEnforcedOptions: définit les limites de gas d’exécution requises. Lorsqu’un utilisateur envoie un message depuis Base, il paie à l’avance le gas de la destination. La définition d’options imposées garantit qu’il paie suffisamment de gas pour que l’Executor LayerZero puisse traiter avec succès la transaction sur Chiliz Chain.

• setPeer: associe un EID de destination à une adresse de contrat de confiance. Vous devez indiquer au contrat Base de faire confiance au contrat Chiliz Chain, et au contrat Chiliz Chain de faire confiance au contrat Base.

Exécution de la tâche de câblage

Exécutez la commande suivante dans votre terminal :

npx hardhat lz:oapp:wire --oapp-config layerzero.config.ts

La chaîne d’outils calculera automatiquement les paramètres requis, vous présentera un tableau des transactions qu’elle s’apprête à exécuter et les soumettra à Chiliz et Base à l’aide de votre portefeuille de déploiement.

Une fois les transactions confirmées sur les deux réseaux, votre bridge de jeton est officiellement en service et entièrement configuré ! L’Adapter Base est désormais autorisé à envoyer des commandes de frappe à Chiliz Chain, et Chiliz Chain est autorisé à envoyer des commandes de déverrouillage vers Base.

Étape 5 : fonctionnement et tests

Avec vos contrats déployés et reliés de manière sécurisée, votre jeton est désormais omnichaîne. La dernière étape consiste à exécuter un transfert inter-chaînes de Base Mainnet vers Chiliz Chain Mainnet.

1) Exécution du transfert inter-chaînes

La boîte à outils LayerZero V2 fournit une tâche Hardhat intégrée pour tester les transferts OFT directement depuis votre terminal. Cette commande estimera les frais de gas inter-chaînes, débitera votre portefeuille en $ETH (le jeton de gas natif sur la chaîne source, Base) et initiera le transfert.

Exécutez la commande suivante :

npx hardhat lz:oft:send --oapp-config layerzero.config.ts --from-eid 30184 --to-eid 30409 --amount 10

Ce que fait cette commande :

1. Recherche Base Mainnet (30184) et Chiliz Mainnet (30409) dans votre configuration.

2. Estime les frais inter-chaînes requis par l’Executor LayerZero.

3. Appelle la send() fonction sur votre Adapter Base.

4. L’Adapter verrouille 10 jetons et émet un paquet vers le Endpoint LayerZero.

2) Suivi du paquet sur LayerZero Scan

Les transactions inter-chaînes sont asynchrones. Bien que votre transaction Chiliz se confirme en quelques secondes, le message doit encore être vérifié et exécuté sur Base.

Pour suivre ce parcours en temps réel, cliquez sur le lien LayerZero Scan qui apparaît dans la sortie du CLI.

En savoir plus sur cet outil ici :

LayerZero Scan - LayerZeroLayerZero Documentation

Configuration des limites de gas

Il est très important de définir des limites de gas, car l’omission de cette étape peut faire échouer vos messages inter-chaînes sur le réseau de destination.

Lorsqu’un utilisateur transfère un jeton de Base vers Chiliz Chain, il paie les frais de gas pour les deux chaînes à l’avance dans une seule transaction sur Base (en utilisant $ETH). LayerZero utilise ensuite une partie de ces frais pour payer le gas ETH réel nécessaire à l’exécution de la transaction de frappe sur Chiliz Chain.

Pour garantir que LayerZero dispose de suffisamment de gas pour traiter avec succès la lzReceive fonction sur la chaîne de destination, vous devez définir des options imposées. Si elles ne sont pas définies, la transaction peut être annulée sur la chaîne de destination en raison d’une erreur « Out of Gas ».

Configuration des options

Cette option est configurée dans votre layerzero.config.ts fichier. Mettez à jour le connections tableau pour inclure le enforcedOptions bloc pour chaque voie :

import { EndpointId } from '@layerzerolabs/lz-definitions';

// ... (définitions de contrats comme précédemment)

connections: [
    {
        from: 'BaseTokenAdapter',
        to: 'ChilizTokenOFT',
        config: {
            enforcedOptions: [
                {
                    msgType: 1,        // 1 = Transfert OFT standard (SEND)
                    optionType: 1,     // 1 = option lzReceive
                    gas: 200000,       // Limite de gas estimée pour frapper sur Chiliz Chain
                },
                {
                    msgType: 2,        // 2 = Transfert OFT avec charge utile (SEND_AND_CALL)
                    optionType: 1,
                    gas: 250000,       // Limite de gas légèrement plus élevée pour les appels complexes
                }
            ]
        },
    },
    {
        from: 'ChilizTokenOFT',
        to: 'BaseTokenAdapter',
        config: {
            enforcedOptions: [
                {
                    msgType: 1,
                    optionType: 1,
                    gas: 200000,       // Limite de gas estimée pour déverrouiller sur Base
                }
            ]
        },
    },
],
// ...

Explication des paramètres :

• msgType: 1: Représente un transfert de jeton standard. msgType: 2 est utilisé pour les appels « composés » (par exemple, transférer un jeton et le staker immédiatement en un seul clic).

• optionType: 1: demande à l’Executor d’exécuter simplement la lzReceive fonction.

• gas: 200000: Une limite de gas de base sûre pour les frappes et déverrouillages OFT standards. Vous pouvez l’ajuster en fonction de la consommation réelle de gas de vos contrats déployés.

Si vous avez défini cette option après avoir déjà relié les chaînes, vous pouvez relier à nouveau avec les options désormais en place en utilisant la même commande :

npx hardhat lz:oapp:wire --oapp-config layerzero.config.ts

L’outillage détectera automatiquement les changements et soumettra une setEnforcedOptions() transaction à vos contrats sur Base et Chiliz. Désormais, chaque fois qu’un utilisateur déclenche un bridge, les contrats exigeront que l’utilisateur paie au moins 200 000 unités de gas sur la chaîne de destination, garantissant une livraison fiable.