# 使用 Foundry 或 Hardhat 部署合約

> Source: https://docs.blockvectra.com/zh-hant/guides/deploy-contract/

## 選擇網路

請依照目標鏈的整合指南（從[支援的鏈](https://docs.blockvectra.com/zh-hant/chains/)進入）建立 `network.mjs` 並匯出 `RPC_URL` 與 `CHAIN_ID`。鏈指南會從 [GET /v1/chains](https://api.blockvectra.com/v1/chains) 讀取 chain ID 與方法策略，並說明 gas 代幣、是否需要另用可廣播的 RPC，以及各鏈專屬的部署設定。

選擇下方其中一種工具。兩者都會部署同一個不含建構子引數的小型合約。

為部署者提供所選網路的原生 gas 代幣。在本機環境中安全設定 `DEPLOYER_PRIVATE_KEY`，切勿提交。以下命令會廣播交易並花費 gas。

建立不含建構子引數的 `Hello.sol`：

```solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
contract Hello {
    event Ping(address indexed sender);
    function ping() external { emit Ping(msg.sender); }
    function hello() external pure returns (string memory) {
        return "hello";
    }
}
```

### Foundry

在已初始化的 Foundry 專案中，將合約放在 `src/Hello.sol`，並使用下列 `foundry.toml`：

```toml
[profile.default]
src = "src"
out = "out"
libs = ["lib"]
solc_version = "0.8.24"
evm_version = "paris"

[rpc_endpoints]
target = "${RPC_URL}"
```

```bash
: "${RPC_URL:?Set RPC_URL}" "${CHAIN_ID:?Set CHAIN_ID}" "${DEPLOYER_PRIVATE_KEY:?Set deployer key}"
test "$(cast chain-id --rpc-url "$RPC_URL")" = "$CHAIN_ID" || exit 1
forge build
forge create src/Hello.sol:Hello --rpc-url target \
  --chain "$CHAIN_ID" --private-key "$DEPLOYER_PRIVATE_KEY" --broadcast
```

保留交易雜湊與部署地址。使用 `cast receipt "$TX_HASH" --rpc-url "$RPC_URL"` 檢查是否納入區塊與狀態，再以 `cast call "$CONTRACT_ADDRESS" "hello()(string)" --rpc-url "$RPC_URL"` 讀取合約。請從部署輸出設定這兩個變數。

### Hardhat 2 與 ethers 6

在獨立的 CommonJS 專案（`npm init -y`）中，安裝 `npm install --save-dev hardhat@2 @nomicfoundation/hardhat-ethers@3 ethers@6`。將同一份合約放在 `contracts/Hello.sol`。將以下內容存為 `hardhat.config.cjs`：

```js
require('@nomicfoundation/hardhat-ethers');
const { RPC_URL, CHAIN_ID, DEPLOYER_PRIVATE_KEY } = process.env;
if (!RPC_URL || !/^[1-9][0-9]*$/.test(CHAIN_ID ?? '') || !DEPLOYER_PRIVATE_KEY) {
  throw new Error('Set RPC_URL, CHAIN_ID and DEPLOYER_PRIVATE_KEY');
}
module.exports = {
  solidity: { version: '0.8.24', settings: { evmVersion: 'paris' } },
  networks: {
    target: { url: RPC_URL, chainId: Number(CHAIN_ID), accounts: [DEPLOYER_PRIVATE_KEY] },
  },
};
```

建立 `scripts` 目錄並存為 `scripts/deploy.cjs`：

```js
const { ethers } = require('hardhat');
async function main() {
  const contract = await ethers.deployContract('Hello');
  console.log(contract.deploymentTransaction().hash);
  await contract.waitForDeployment();
  console.log(await contract.getAddress());
}
main().catch(error => { console.error(error); process.exitCode = 1; });
```

```bash
npx hardhat compile
npx hardhat run scripts/deploy.cjs --network target
```

網路的 `chainId` 會與 RPC 核對。請參閱 [Hardhat 2 網路設定](https://v2.hardhat.org/hardhat-runner/docs/config)與 [Foundry 設定](https://www.getfoundry.sh/config/index.html)（存取日期：2026-10-07）。

## 讀取事件

將 `LOG_ADDRESS` 設為部署地址。呼叫 `ping()` 後，依照目標鏈指南中的事件讀取方式（WebSocket 訂閱或 HTTP 分段輪詢，取決於該鏈在 `/v1/chains` 的 `ws` 欄位）讀取 `Ping` 事件。