Guide développeur Bitroot

Bitroot est une chaîne 100 % compatible EVM : l'outillage Ethereum que vous utilisez déjà — portefeuilles, SDK, frameworks de contrats — fonctionne en grande partie tel quel. Il vous suffit de le configurer pour qu'il pointe vers les paramètres réseau de Bitroot. Ce guide couvre la connexion au réseau, le déploiement et le débogage de contrats, ainsi que les composants de l'architecture à trois moteurs destinés aux développeurs.

1. Vue d'ensemble

Quelques points d'entrée auxquels vous reviendrez tout au long de ce guide :

• Explorateur de blocs (BRTSCAN) : https://devnet.bitroot.co/overview — consultez les blocs, les transactions et l'état des contrats. C'est aussi la source faisant autorité pour l'URL RPC et l'ID de chaîne en vigueur, car ces valeurs peuvent changer à mesure que le réseau évolue — considérez toute autre copie de ces valeurs, y compris une version antérieure de cette page, comme potentiellement obsolète.
• Robinet de testnet (faucet) : https://devnet.bitroot.co/faucet — récupérez des BRT de testnet gratuits pour déployer et déboguer vos contrats.
• Pont : https://bridge.bitroot.co/ — transférez des actifs à l'entrée comme à la sortie.
• Dépôt du protocole : https://github.com/brt-chain/bitroot — l'installation des nœuds, les détails d'implémentation du protocole et l'ABI exacte des interfaces d'appel de l'agent IA s'y trouvent.

2. Se connecter au réseau Bitroot

Bitroot parle le JSON-RPC standard : tout portefeuille prenant en charge les réseaux EVM personnalisés (MetaMask, Rabby, OKX Wallet et similaires) peut donc l'ajouter directement. Exemple avec MetaMask :

1. Ouvrez MetaMask, cliquez sur le sélecteur de réseau → « Add network » → « Add a network manually ».
2. Ouvrez BRTSCAN (https://devnet.bitroot.co/overview) ; l'en-tête de page ou le panneau d'informations réseau indique le nom du réseau, l'URL RPC, l'ID de chaîne, le symbole de la devise et l'URL de l'explorateur de blocs en vigueur — recopiez ces valeurs dans le formulaire MetaMask comme indiqué.
3. Enregistrez, puis basculez sur le réseau Bitroot. Le solde de votre compte devrait s'afficher (0 BRT est normal tant que vous n'avez pas réclamé de jetons de testnet auprès du robinet).

Nous ne figeons volontairement ni URL RPC ni ID de chaîne sur cette page : les paramètres du testnet peuvent changer entre les mises à niveau, et une valeur figée obsolète risquerait davantage de vous connecter au mauvais réseau que de vous aider. Utilisez toujours ce que BRTSCAN affiche actuellement.

3. Obtenir des jetons de testnet

Rendez-vous sur le robinet (https://devnet.bitroot.co/faucet) et indiquez l'adresse de votre portefeuille pour recevoir des BRT de testnet destinés au déploiement de contrats et au paiement du gaz. Les frais de gaz moyens étant d'environ 0,00007 $, une petite réclamation au robinet couvre généralement un grand nombre de déploiements et d'appels pendant le développement.

4. Développement de contrats intelligents : réutilisez les outils que vous connaissez déjà

Comme Bitroot est 100 % compatible EVM, aucun des éléments suivants n'a besoin d'une couche d'adaptation — il suffit de faire pointer la configuration réseau vers Bitroot.

Hardhat (hardhat.config.js) :

module.exports = {
  solidity: "0.8.24",
  networks: {
    bitrootTestnet: {
      url: process.env.BITROOT_RPC_URL, // get the current RPC URL from BRTSCAN
      chainId: Number(process.env.BITROOT_CHAIN_ID), // get the current Chain ID from BRTSCAN
      accounts: [process.env.DEPLOYER_PRIVATE_KEY],
    },
  },
};

Foundry (foundry.toml plus une variable d'environnement) :

[rpc_endpoints]
bitroot_testnet = "${BITROOT_RPC_URL}"

Le déploiement fonctionne comme sur n'importe quelle autre chaîne EVM :

forge create src/MyContract.sol:MyContract \
  --rpc-url $BITROOT_RPC_URL \
  --private-key $DEPLOYER_PRIVATE_KEY

Remix : dans le panneau « Deploy & Run », choisissez « Injected Provider - MetaMask ». Tant que MetaMask est connecté à Bitroot, la compilation, le déploiement et les appels de contrats fonctionnent exactement comme sur le réseau principal Ethereum.

5. Interagir avec le réseau depuis ethers.js / viem

import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider(process.env.BITROOT_RPC_URL);
const wallet = new ethers.Wallet(process.env.DEPLOYER_PRIVATE_KEY!, provider);

const balance = await provider.getBalance(wallet.address);
console.log(`Balance: ${ethers.formatEther(balance)} BRT`);

Comme le moteur d'exécution intelligent parallélisé exécute simultanément les transactions qui n'entrent pas en conflit, vous pouvez envoyer sans risque un lot de transactions indépendantes (un airdrop, une émission en masse) sans les sérialiser manuellement une confirmation à la fois — le réseau détermine lui-même celles qui peuvent s'exécuter en parallèle.

6. Explorateur de blocs et vérification des contrats

Une fois un contrat déployé, vérifiez son code source sur BRTSCAN afin que vous et les autres utilisateurs puissiez examiner son comportement et appeler des méthodes en lecture seule directement depuis l'explorateur pendant le débogage. Suivez le parcours de vérification et les champs requis tels qu'indiqués sur la page BRTSCAN elle-même.

7. Utiliser l'EVM natif IA

La plus grande différence entre Bitroot et une chaîne EVM classique réside dans l'interface d'appel d'agent IA intégrée : un contrat intelligent peut invoquer directement une inférence de modèle IA, sans oracle ni relais hors chaîne distinct. Cette interface évolue encore rapidement ; l'interface de contrat exacte, les adresses de précompilés et l'ABI se trouvent dans le dépôt du protocole (https://github.com/brt-chain/bitroot) — nous ne dupliquerons pas ici une signature qui pourrait devenir obsolète. Conceptuellement, voyez-la comme un « précompilé d'inférence IA » que vous pouvez appeler (call) directement depuis Solidity ; les entrées et les sorties sont enregistrées via la couche d'audit vérifiable à divulgation nulle de connaissance, de sorte que le résultat de l'inférence peut être vérifié par un tiers on-chain ou hors chaîne sans exposer les poids du modèle sous-jacent.

8. Sécurité et bonnes pratiques

• Gestion des clés : un fichier .env en clair convient au débogage sur testnet, mais les déploiements en production doivent passer par un portefeuille matériel ou une solution de conservation fondée sur le MPC — ne codez jamais en dur une clé privée dans un dépôt.
• Audits de contrats : la couche d'audit vérifiable à divulgation nulle de connaissance ne remplace pas un audit de la logique de votre propre contrat. Elle vérifie qu'un calcul et son résultat sont dignes de confiance — elle ne peut pas vous dire si votre logique métier contient un bug.
• Estimation du gaz : les frais de gaz sont bien inférieurs à ceux du réseau principal Ethereum, mais les opérations par lots en production méritent tout de même une passe d'estimation du gaz, pour qu'une limite de gaz par transaction trop basse ne provoque pas d'échecs partiels.
• Vérification des paramètres réseau : validez l'ID de chaîne au moment de l'exécution (comparez-le à provider.getNetwork()) pour qu'une faute de frappe dans un fichier de configuration ne dirige pas silencieusement votre déploiement vers la mauvaise chaîne.

9. FAQ

Un contrat Ethereum existant peut-il être déployé tel quel sur Bitroot ? Dans la plupart des cas, oui — tant que le contrat ne présuppose pas d'adresses de précompilés propres à Ethereum, les contrats Solidity standard se compilent et se déploient sans modification du code.

Le testnet et le réseau principal partagent-ils les mêmes paramètres réseau ? Non. Vérifiez toujours sur BRTSCAN l'environnement que vous visez — l'URL RPC et l'ID de chaîne diffèrent entre le testnet et tout futur réseau principal.

L'appel du module EVM natif IA entraîne-t-il des frais supplémentaires ? Le modèle de frais exact est défini dans le dépôt du protocole et les annonces officielles ; cette page ne prend pas d'engagement à ce sujet.

10. Ressources

Si vous rencontrez un point non couvert par ce guide, contactez-nous via la page Contact média ou nos canaux communautaires.