RPCプロキシPostmanコレクションの生成

デプロイされたパッケージのトークンおよびアカウント/アイデンティティABIのPostmanコレクションを自動的に作成できます。

生成されたコレクションは、Oracle Blockchain Platform RPCプロキシAPIをターゲットとし、Visual Studio Codeの「Execute」フォームの外での契約コールのテストを目的としています。

プロジェクトがhardhat.config.tsまたはhardhat.config.jsのgenerate-rpc-proxy-postman Hardhatタスクをインポートすることを確認します。生成ツールは、契約をデプロイしたり、保存された環境を作成したりしません。ABIアーティファクトからPostmanコレクションを生成します。リクエストを実行する場合は、デプロイされたプロキシ・アドレスと環境変数をPostmanで指定する必要があります。

  1. Blockchain App Builder For Besuアクティビティ・バーで開発者ツールを開きます。
  2. 「Generate RPC Proxy Postman Collection」を選択します。
  3. Hardhatプロジェクトを選択します。
  4. トークン・パッケージを選択します。複合パッケージおよびサポートされているインポート済パッケージは、ペア・トークンおよびアカウント/アイデンティティ・アーティファクトを解決します。トークンおよびアカウントのアーティファクト・パスを確認して、それらが正しいことを確認します。
  5. 出力パスを入力するか、次のデフォルト・パスを保持します。 
    generated/rpc-proxy-postman/<token-name>-rpc-proxy.postman.collection.json
  6. 「生成」を選択します。ステータス領域では、出力場所がレポートされ、収集生成が失敗した場合や警告が発生した場合、完全なHardhatログが公開されます。

生成されたコレクションを使用するには、JSON出力ファイルをPostmanにインポートします。生成されたリクエストに必要な収集変数(Oracle Blockchain Platform RPCプロキシ・ホスト、認証トークン、デプロイされたトークン/アカウント・プロキシ・アドレス、エンドポイントで必要とされるコール元またはウォレット情報など)を構成します。

コレクションは、コンパイル時のABIサーフェスを表します。トークン/アカウント・ソース、生成済構成またはコンパイル済アーティファクトが変更されるたびに、これを再生成します。

Postmanコレクション生成のトラブルシューティング

条件 解決策
トークンまたはアカウント・アーティファクトが必要です 選択したプロジェクトをコンパイルしてから、トークン・パッケージを再度開くか選択します。
プロジェクトにgenerate-rpc-proxy-postmanは含まれません。 次の例に示すように、hardhat.config.tsでプロジェクト・タスクをインポートします。
import "./tasks/generate-rpc-proxy-postman";
出力ファイルがありません 選択したプロジェクト・ルートと、フル・ログ内の相対出力パスを確認します。
Postmanが予期しないメソッド・セットをコールする 現在のプロジェクトを再コンパイルし、目的のトークン・パッケージからコレクションを再生成します。