Migrate Hardhat V2 Project to V3: Understanding Hook System and HRE Usage in New Extensibility Model

[AlirezaEthDev]

I am currently working on a project using Hardhat V2, which incorporates HRE and extendEnvironment. I need to migrate this project to Hardhat V3. While reviewing the V3 documentation, I noticed the statement: These extensibility points were replaced by the hook system. We'll add details on how to migrate them soon. How can I learn more about the hook system and how to utilize HRE in Hardhat V3?

[kanej]

Hey @AlirezaEthDev, improving the documentation is our top priority - including documenting the extensibility via the hook system. But we are not there yet (we are putting together an extensibility guide for plugins at the moment).

Is it a plugin you are migrating or where you using extendEnvironment directly from your hardhat.config.{js,ts}?

If your project is up on github can you link it so I can take a look?

[AlirezaEthDev]

I'm using extendEnvironment directly from my hardhat.config.js:

extendEnvironment((hre) => { ... }

I need do know how to extend hre in V3! Is it possible now?

The project is on GitHub but is private! I'm not allowed share it with somebody else!

[kanej]

Are you able to share the rest of the extendEnvironment so we can see what you features you need to replicate the functionality in Hardhat 3?

[AlirezaEthDev]

@kanej
Yes, sure:

extendEnvironment((hre) => {

  const fs = require('fs');
  const path = require('path');
  const ethers = require('ethers');
  const getEvent = require('./utils/getEvent.js');
  const serialize = require('./utils/serialize.js');
  const getError = require('./utils/getError.js');
  const objects = require('./scripts/objects.js');
  const { expect, assert } = require('chai');
  const extendDiamond = require('./utils/extendDiamond.js');
  const contractPath = require('./utils/contract-path-resolver.js');
  const adminCongArgs = require('./admin-config-args.js');
  const diamondArgs = require('./diamond-args.js');

  // Extend to packages
  hre.fs = fs;
  hre.path = path;
  hre.ethers = ethers;
  hre.getEvent = getEvent;
  hre.serialize = serialize;
  hre.getError = getError;
  hre.objects = objects;
  hre.expect = expect;
  hre.assert = assert;
  hre.extendDiamond = extendDiamond;
  hre.contractPath = contractPath;
  hre.adminCongArgs = adminCongArgs;
  hre.diamondArgs = diamondArgs;


  // Constants
  hre.SONIC_MAINNET = process.env.SONIC_MAINNET_ENDPOINT;
  hre.ADMIN_1_KEY = process.env.ADMIN_1_KEY;
  hre.ADMIN_1 = process.env.ADMIN_1;
  hre.ADMIN_2_KEY = process.env.ADMIN_2_KEY;
  hre.ADMIN_2 = process.env.ADMIN_2;
  hre.MODERATOR_1_KEY = process.env.MODERATOR_1_KEY;
  hre.MODERATOR_1 = process.env.MODERATOR_1;
  hre.MODERATOR_2_KEY = process.env.MODERATOR_2_KEY;
  hre.MODERATOR_2 = process.env.MODERATOR_2;
  hre.LIQUIDATOR_1_KEY = process.env.LIQUIDATOR_1_KEY;
  hre.LIQUIDATOR_1 = process.env.LIQUIDATOR_1;
  hre.USER_1_KEY = process.env.USER_1_KEY;
  hre.USER_1 = process.env.USER_1;
  hre.USER_2_KEY = process.env.USER_2_KEY;
  hre.USER_2 = process.env.USER_2;
  hre.LENDER_KEY = process.env.LENDER_KEY;
  hre.LENDER = process.env.LENDER;
  hre.DIAMOND = process.env.DIAMOND;
  hre.LP = process.env.LP_TOKEN;
  hre.TOTAL_SUPPLY = ethers.parseEther('1000000000');
  hre.LIQ_TRH = 8000;
  hre.LIQ_BONUS = 1;
  hre.VOLATILITY_DISCOUNT = 1000;
  hre.LOAN_AMOUNT = ethers.parseEther('150');
  hre.DEADLINE = 1753173162;
  hre.INSTALLMENT = 10;
  hre.SPAXG = process.env.SPAXG;
  hre.SPAXG_AGG = process.env.SPAXG_AGGREGATOR;
  hre.USDT = process.env.USDT;
  hre.USDT_AGG = process.env.USDT_ORACLE;


  // Set provider
  hre.provider = new ethers.JsonRpcProvider(hre.SONIC_MAINNET);

  // Set accounts
  hre.admin1 = new ethers.Wallet(hre.ADMIN_1_KEY, hre.provider);
  hre.admin2 = new ethers.Wallet(hre.ADMIN_2_KEY, hre.provider);
  hre.moderator1 = new ethers.Wallet(hre.MODERATOR_1_KEY, hre.provider);
  hre.moderator2 = new ethers.Wallet(hre.MODERATOR_2_KEY, hre.provider);
  hre.liquidator1 = new ethers.Wallet(hre.LIQUIDATOR_1_KEY, hre.provider);
  hre.user1 = new ethers.Wallet(hre.USER_1_KEY, hre.provider);
  hre.user2 = new ethers.Wallet(hre.USER_2_KEY, hre.provider);
  hre.lender = new ethers.Wallet(hre.LENDER_KEY, hre.provider);

  // Import abis
  hre.diamondObj = JSON.parse(hre.fs.readFileSync('artifacts/contracts/Diamond.sol/Diamond.json'));
  hre.diamondCutObj = JSON.parse(hre.fs.readFileSync('artifacts/contracts/facets/DiamondCut.sol/DiamondCut.json'));
  hre.diamondLoupeObj = JSON.parse(hre.fs.readFileSync('artifacts/contracts/facets/DiamondLoupe.sol/DiamondLoupe.json'));
  hre.pairObj = JSON.parse(hre.fs.readFileSync('artifacts/contracts/mocks/MockPair.sol/MockPair.json'));
  hre.lpAdminObj = JSON.parse(hre.fs.readFileSync('artifacts/contracts/facets/administration/LpTokenAdministration.sol/LpTokenAdministration.json'));
  hre.oracleObj = JSON.parse(hre.fs.readFileSync('artifacts/contracts/facets/oracle/OracleManager.sol/OracleManager.json'));
  hre.loanObj = JSON.parse(hre.fs.readFileSync('artifacts/contracts/facets/lending/LoanManagment.sol/LoanManagement.json'));
  hre.userObj = JSON.parse(hre.fs.readFileSync('artifacts/contracts/facets/lending/UserAsset.sol/UserAsset.json'));
  hre.aggObj = JSON.parse(hre.fs.readFileSync('artifacts/contracts/mocks/MockV3Aggregator.sol/MockV3Aggregator.json'));
  hre.adminConfigObj = JSON.parse(hre.fs.readFileSync('artifacts/contracts/facets/administration/AdminConfig.sol/AdminConfig.json'));
  hre.loanMgmntObj = JSON.parse(hre.fs.readFileSync('artifacts/contracts/facets/lending/LoanManagment.sol/LoanManagement.json'));

})