使用命令行生成 RPC 代理 Postman 集合

您可以为已部署程序包的令牌和账户/身份 ABI 自动创建 Postman 集合。

generate-rpc-proxy-postman Hardhat 任务从账户和令牌合同对象为 Oracle Blockchain Platform RPC 代理生成 Postman 集合。生成的集合包含从两个 ABI 派生的代理请求。

在生成 Postman 集合之前，必须安装项目依赖项并编译项目，以便 Hardhat 写入所需的对象 JSON 文件。确保 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 中，选择 Import 并选择生成的 .postman.collection.json 文件。
选择或创建提供 RPC 代理基本 URL 及其验证值的环境。
在发送事务处理之前检查收集变量和请求主体。合同地址、签署人和方法参数等值特定于环境或请求。

故障排除

条件	解决方法
找不到任务	确认 `hardhat.config.ts` 文件导入 `./tasks/generate-rpc-proxy-postman`，然后从项目根目录再次运行该命令。
找不到项目对象文件	运行项目的编译命令并验证 `artifacts/` 文件夹下的路径。提供合同对象 JSON，而不是源 `.sol` 文件。
集合不包括方法	确认该方法存在于账户或令牌对象 ABI 中，然后重新生成集合。
Postman 请求未经授权或无法访问代理	这是收集生成后的环境配置问题。验证所选 Postman 环境的代理 URL 和验证值。