使用命令行產生 RPC 代理主機 Postman Collection

您可以自動為已部署套裝軟體的記號和帳戶 / 識別 ABI 建立 Postman 集合。

generate-rpc-proxy-postman Hardhat 工作會從帳戶和權杖合約使用者自建物件產生一個 Oracle Blockchain Platform RPC 代理主機的 Postman 集合。產生的集合包含衍生自兩個 ABI 的代理要求。

您必須先安裝專案相依性並編譯專案，以便 Hardhat 寫入必要的物件 JSON 檔案，才能產生 Postman 集合。確定 hardhat.config.ts 檔案會匯入 generate-rpc-proxy-postman 工作。產生的專案通常包含下列明細行。

import "./tasks/generate-rpc-proxy-postman";

必須有一個帳戶使用者自建物件和一個權杖使用者自建物件，才能執行此作業。找出 artifacts/ 資料夾底下的使用者自建物件檔案，然後在命令中使用其完整或專案相關路徑。

若要產生 Postman 集合，請使用兩個使用者自建物件路徑執行一個輸出路徑的工作，如下列範例所示。將範例人工因素路徑和輸出檔案名稱取代為專案的路徑。會在必要時建立輸出目錄。

npx hardhat generate-rpc-proxy-postman \
  --account-abi artifacts/contracts/Account.sol/Account.json \
  --token-abi artifacts/contracts/Token.sol/Token.json \
  --out generated/rpc-proxy-postman/token-rpc-proxy.postman.collection.json

請勿手動編輯集合。如果 ABI 變更，請重新產生集合。

若要使用產生的集合，請完成下列步驟。

在 Postman 中，選取匯入，然後選擇產生的 .postman.collection.json 檔案。
選取或建立提供 RPC 代理主機基本 URL 及其認證值的環境。
請先複查收集變數並要求主體，再傳送交易。合約地址、簽署者及方法引數等值為環境或要求特定。

疑難排解

條件	解決方式
找不到工作	確認 `hardhat.config.ts` 檔案會匯入 `./tasks/generate-rpc-proxy-postman`，然後從專案根目錄再次執行命令。
找不到構件檔案	執行專案的 compile 命令，並驗證 `artifacts/` 資料夾下的路徑。提供合約構件 JSON，而不是來源 `.sol` 檔案。
集合未包含方法	確認帳戶或權杖使用者自建物件 ABI 中有此方法，然後重新產生集合。
Postman 要求未獲授權或無法連線代理主機	這是產生集合之後的環境組態問題。請檢查所選 Postman 環境的代理主機 URL 和認證值。