Générer une collection Postman de proxy RPC

Vous pouvez créer automatiquement une collection Postman pour les identifiants ABI de jeton et de compte/identité d'un package déployé.

La collecte générée cible l'API proxy Oracle Blockchain Platform RPC et est destinée au test des appels de contrat en dehors du formulaire Exécuter de code Visual Studio.

Confirmez que le projet importe la tâche Hardhat generate-rpc-proxy-postman dans hardhat.config.ts ou hardhat.config.js. L'outil de génération ne déploie pas de contrats ni ne crée un environnement enregistré. Il génère une collection Postman à partir d'artefacts ABI. Vous devez fournir les adresses proxy déployées et les variables d'environnement dans Postman lorsque vous exécutez des demandes.

  1. Ouvrez les outils de développeur dans la barre d'activité Blockchain App Builder For Besu.
  2. Sélectionnez Générer une collection de postman de proxy RPC.
  3. Sélectionnez le projet Hardhat.
  4. Sélectionnez le package de jetons. Les packages composés et les packages importés pris en charge résolvent leurs artefacts de jeton et d'identité associés. Vérifiez les chemins d'artefact de jeton et de compte pour vous assurer qu'ils sont corrects.
  5. Entrez un chemin de sortie ou conservez le chemin par défaut suivant : 
    generated/rpc-proxy-postman/<token-name>-rpc-proxy.postman.collection.json
  6. Sélectionnez Générer. La zone d'état indique l'emplacement de sortie et affiche le journal Hardhat complet en cas d'échec ou d'avertissement de la génération de la collection.

Pour utiliser la collection générée, importez le fichier de sortie JSON dans Postman. Configurez les variables de collecte requises par les demandes générées, telles que l'hôte proxy Oracle Blockchain Platform RPC, le jeton d'authentification, les adresses de proxy de compte/jeton déployé et toutes les informations d'appelant ou de portefeuille requises par l'adresse.

La collection représente la surface ABI au moment de la compilation. Régénérez-le à chaque fois que les sources de jeton/compte, la composition générée ou les artefacts compilés changent.

Dépannage de la génération de collecte Postman

Condition Résolution
Le jeton ou l'artefact de compte est requis Compilez le projet sélectionné, puis ouvrez ou sélectionnez à nouveau le package de jetons.
Le projet ne comprend pas generate-rpc-proxy-postman Importez la tâche de projet dans hardhat.config.ts, comme indiqué dans l'exemple suivant.
import "./tasks/generate-rpc-proxy-postman";
Le fichier de sortie est manquant Vérifiez la racine du projet sélectionné et le chemin de sortie relatif dans le journal complet.
Postman appelle un ensemble de méthodes inattendu Recompilez le projet actuel et regénérez la collection à partir du package de jetons prévu.