测试SolidStateDiamond库diamondCut函数时遇地址无效错误求助

Error: invalid address or ENS name (argument="name", value=undefined...)这个报错的核心原因是调用diamondCut时，传入的facet地址参数为undefined，大概率是以下两种情况：

• 功能Facet合约未成功部署，或部署后地址变量未正确赋值
• 构造DiamondCut结构体数组时，引用了未初始化的地址变量

必要前置检查 #

1. 确认测试脚本中，你的CrudFacet（功能合约）已经完成部署，且部署后的地址被正确存入变量
2. 核对DiamondCut结构体参数：每个cut项必须包含facetAddress（有效合约地址）、action（Add/Replace/Remove对应的枚举值）、functionSelectors（目标函数选择器数组）

可运行的diamondCut测试脚本（Hardhat环境） #

假设你的功能合约是CrudFacet，以下是适配SolidStateDiamond规范的测试代码：

const { expect } = require("chai");
const { ethers } = require("hardhat");

describe("Diamonds and Facets", function () {
  let diamond;
  let crudFacet;
  let diamondCutFacet;

  beforeEach(async function () {
    // 部署Diamond核心合约
    const Diamond = await ethers.getContractFactory("Diamond");
    diamond = await Diamond.deploy((await ethers.getSigners())[0].address);
    await diamond.deployed();

    // 部署CrudFacet功能合约（必须先于diamondCut调用）
    const CrudFacet = await ethers.getContractFactory("CrudFacet");
    crudFacet = await CrudFacet.deploy();
    await crudFacet.deployed();

    // 通过Diamond地址获取DiamondCutFacet接口
    diamondCutFacet = await ethers.getContractAt("DiamondCutFacet", diamond.address);
  });

  it("should add CrudFacet via diamondCut", async function () {
    // 提取CrudFacet的目标函数选择器
    const selectors = [
      crudFacet.interface.getSighash("createItem"),
      crudFacet.interface.getSighash("readItem"),
      crudFacet.interface.getSighash("updateItem"),
      crudFacet.interface.getSighash("deleteItem")
    ];

    // 构造DiamondCut数组：0代表Add操作
    const cut = [{
      facetAddress: crudFacet.address,
      action: 0,
      functionSelectors: selectors
    }];

    // 执行diamondCut
    const tx = await diamondCutFacet.diamondCut(cut, ethers.constants.AddressZero, "0x");
    await tx.wait();

    // 验证Facet已成功挂载到Diamond
    const crudAtDiamond = await ethers.getContractAt("CrudFacet", diamond.address);
    await crudAtDiamond.createItem("test data");
    const result = await crudAtDiamond.readItem(0);
    expect(result).to.equal("test data");
  });
});

关键注意事项 #

• 不要跳过Facet部署：crudFacet.address必须是已部署的有效合约地址，绝对不能是undefined
• action枚举值要正确：0=添加Facet，1=替换已有Facet，2=移除函数选择器
• 使用正确的接口调用：diamondCut方法由DiamondCutFacet提供，需通过Diamond合约地址获取该接口实例

内容的提问来源于stack exchange，提问作者Syre Musk