コマンドラインを使用したRPCプロキシ・ポストマン・コレクションの生成

デプロイされたパッケージのトークンおよびアカウント/アイデンティティ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";

タスクを実行するには、1つのアカウント・アーティファクトと1つのトークン・アーティファクトが必要です。artifacts/フォルダの下のアーティファクト・ファイルを見つけ、その完全パスまたはプロジェクト相対パスをコマンドで使用します。

Postmanコレクションを生成するには、次の例に示すように、出力パスに2つのアーティファクト・パスを指定してタスクを実行します。アーティファクト・パスおよび出力ファイル名の例をプロジェクトのものに置き換えます。出力ディレクトリは、必要に応じて作成されます。

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`をインポートしていることを確認し、プロジェクト・ルートからコマンドを再度実行します。
アーティファクト・ファイルが見つかりません	プロジェクトのコンパイル・コマンドを実行し、`artifacts/`フォルダの下のパスを確認します。ソースの`.sol`ファイルではなく、契約アーティファクトのJSONを指定します。
コレクションにメソッドが含まれていません	メソッドがアカウントまたはトークン・アーティファクトABIに存在することを確認してから、コレクションを再生成してください。
Postmanリクエストが認可されていないか、プロキシにアクセスできません	これは、収集生成後の環境構成の問題です。選択したPostman環境のプロキシURLおよび認証値を確認します。