在使用 Hardhat 和 Ethers.js v6 部署合约时，若调用 contract.value 获取地址会返回 undefined；正确方式是访问 contract.target 属性，它在合约部署完成后稳定返回合约地址。

在使用 hardhat 和 ethers.js v6 部署合约时，若调用 `contract.value` 获取地址会返回 `undefined`；正确方式是访问 `contract.target` 属性，它在合约部署完成后稳定返回合约地址。

在 Ethers.js v6 中，deployContract() 和 getContractFactory().deploy() 返回的对象是 ContractDeployer 实例（即 Contract 类的部署中对象），其地址不再通过 .address 或 .value 暴露，而是统一通过只读属性 .target 提供。该属性在合约成功部署、交易上链确认后即为有效地址，无需额外等待（但建议配合 deploymentTransaction().wait() 确保区块确认）。

✅ 正确写法示例

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

async function main() {
  const Lock = await ethers.getContractFactory("Lock");
  const lock = await Lock.deploy(unlockTime, { value: lockedAmount });
  await lock.deploymentTransaction().wait(1); // 等待 1 个区块确认
  console.log(`Lock deployed to: ${lock.target}`); // ✅ 正确：target 是地址

  const Token = await ethers.getContractFactory("Token");
  const token = await Token.deploy();
  await token.deploymentTransaction().wait(1);
  console.log(`Token deployed to: ${token.target}`); // ✅ 正确：不再是 token.value
}

main().catch(console.error);

⚠️ 常见误区与注意事项

• ❌ token.address：v6 中已弃用，抛出错误或返回 undefined；
• ❌ token.value：无意义属性，始终为 undefined；
• ❌ token.deployTransaction?.to：仅对失败部署有意义，成功后不反映合约地址；
• ✅ token.target：唯一推荐方式，类型为 string（0x 开头地址），兼容所有部署场景（包括 deployContract 和 getContractFactory().deploy）；
• ✅ 若需确保交易已上链，务必调用 await contract.deploymentTransaction().wait(confirms)，否则 .target 虽有值，但合约可能尚未生效。

? 补充说明：.target vs .getAddress()

Ethers.js v6 还提供了异步方法 await contract.getAddress()，它内部检查部署状态并返回地址，语义更明确。但在绝大多数同步部署流程中，.target 已足够可靠且性能更优：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

// 二者等价（推荐 target，简洁高效）
console.log(token.target);               // 同步获取
console.log(await token.getAddress());   // 异步，内部校验部署状态

总结：升级到 Ethers.js v6 后，请统一将 contract.address 或误用的 contract.value 替换为 contract.target —— 这是官方指定的、轻量且可靠的合约地址访问方式。