部署首个智能合约遇到问题求助

常见问题及修复步骤 #

1. Locklift实例未初始化 #

代码直接调用locklift对象但未完成导入和初始化，会导致运行时找不到该对象。修复方式：

• 在文件顶部添加Locklift导入
• 在main函数开头执行初始化操作

// 顶部新增导入
import locklift from "locklift";

async function main() {
  // 新增初始化逻辑，加载配置文件中的部署设置
  await locklift.deployments.initialize();
  // ... 原有代码
}

2. 密钥编号无效或不存在 #

keystore.getSigner返回undefined时，强制使用!会抛出空值错误。需添加校验逻辑：

const signer = await locklift.keystore.getSigner(keyNumber.toString());
if (!signer) {
  throw new Error(`未找到编号为 ${keyNumber} 的签名密钥`);
}

3. Giver配置错误导致余额转账失败 #

部署合约需要Giver账户提供初始EVER余额，需检查：

• 确认locklift.config.ts中giver字段配置了对应网络的有效地址
• 确保Giver账户有足够的测试网/主网EVER余额（测试网可通过 faucet 获取）
• 若使用自定义Giver，需验证其合约逻辑正常

4. Balance参数转换异常 #

虽然有输入校验，但仍需处理非有效数字的边界情况：

const balance = +(options.balance || response.balance);
if (isNaN(balance) || balance <= 0) {
  throw new Error("余额必须是正数");
}

5. Account合约未注册到工厂 #

调用locklift.factory.getAccountsFactory("Account")报错时，需确认：

• locklift.config.ts的contracts数组中已注册Account合约
• 合约已编译，artifact文件存在于指定目录（默认build/）

完整修复后的代码示例 #

import { Command } from "commander";
import prompts, { PromptObject } from "prompts";
import locklift from "locklift";
import { isNumeric, Migration } from "./utils";

const program = new Command();
const migration = new Migration();

async function main() {
  await locklift.deployments.initialize();
  const promptsData: PromptObject[] = [];
  
  program
    .allowUnknownOption()
    .option("-kn, --key_number <key_number>", "公钥编号")
    .option("-b, --balance <balance>", "初始余额（单位：EVER，将从Giver账户转入）");
  
  program.parse(process.argv);
  const options = program.opts();

  if (!options.key_number) {
    promptsData.push({
      type: "text",
      name: "keyNumber",
      message: "请输入公钥编号",
      validate: value => (isNumeric(value) ? true : "无效编号，请输入数字"),
    });
  }
  if (!options.balance) {
    promptsData.push({
      type: "text",
      name: "balance",
      message: "请输入初始余额（单位：EVER）",
      validate: value => (isNumeric(value) ? true : "无效余额，请输入数字"),
    });
  }

  const response = await prompts(promptsData);

  const keyNumber = +(options.key_number || response.keyNumber);
  const balance = +(options.balance || response.balance);

  const signer = await locklift.keystore.getSigner(keyNumber.toString());
  if (!signer) {
    throw new Error(`未找到编号为 ${keyNumber} 的签名密钥`);
  }
  if (isNaN(balance) || balance <= 0) {
    throw new Error("余额必须是正数");
  }

  let accountsFactory = locklift.factory.getAccountsFactory("Account");

  const { account: Account } = await accountsFactory.deployNewAccount({
    publicKey: signer.publicKey,
    initParams: {
      _randomNonce: locklift.utils.getRandomNonce(),
    },
    constructorParams: {},
    value: locklift.utils.toNano(balance),
  });
  
  migration.store(Account, "account");
  console.log(`账户部署完成，地址：${Account.address}`);
}

main()
  .then(() => process.exit(0))
  .catch(e => {
    console.error("部署失败：", e);
    process.exit(1);
  });

内容的提问来源于stack exchange，提问作者Sergey Parfenov