Générer une collection Postman de proxy RPC avec la ligne de commande

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

La tâche generate-rpc-proxy-postman Hardhat génère une collection Postman pour un proxy Oracle Blockchain Platform RPC à partir d'artefacts de contrat de compte et de jeton. La collection générée contient les demandes de proxy dérivées des deux ABI.

Pour pouvoir générer la collection Postman, vous devez installer les dépendances de projet et compiler le projet afin que Hardhat écrit les fichiers JSON d'artefact requis. Assurez-vous que le fichier hardhat.config.ts importe la tâche generate-rpc-proxy-postman. Les projets générés incluent généralement la ligne suivante. 
import "./tasks/generate-rpc-proxy-postman";
Il doit y avoir un artefact de compte et un artefact de jeton pour exécuter la tâche. Localisez les fichiers d'artefact sous le dossier artifacts/, puis utilisez leur chemin complet ou relatif au projet dans la commande.

Pour générer une collection Postman, exécutez la tâche avec les deux chemins d'artefact un chemin de sortie, comme indiqué dans l'exemple suivant. Remplacez les exemples de chemin d'artefact et de nom de fichier de sortie par ceux de votre projet. Le répertoire de sortie est créé si nécessaire.

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

Ne modifiez pas manuellement la collection. Si l'ABI change, régénérez la collection.

Pour utiliser le prélèvement généré, procédez comme suit :

  1. Dans Postman, sélectionnez Importer et choisissez le fichier .postman.collection.json généré.
  2. Sélectionnez ou créez un environnement qui fournit l'URL de base du proxy RPC et ses valeurs d'authentification.
  3. Vérifiez les variables de recouvrement et les corps de demande avant d'envoyer une transaction. Les valeurs telles que l'adresse du contrat, le signataire et les arguments de méthode sont propres à l'environnement ou à la demande.

Dépannage

Condition Résolution
Tâche non trouvée Vérifiez que le fichier hardhat.config.ts importe ./tasks/generate-rpc-proxy-postman, puis réexécutez la commande à partir de la racine du projet.
Fichier d'artefact introuvable Exécutez la commande de compilation du projet et vérifiez les chemins sous le dossier artifacts/. Indiquez le fichier JSON de l'artefact de contrat, et non le fichier .sol source.
La collection ne comprend pas de méthode Vérifiez que la méthode est présente dans le compte ou l'artefact de jeton ABI, puis régénérez la collection.
La demande Postman n'est pas autorisée ou ne peut pas atteindre le proxy Il s'agit d'un problème de configuration d'environnement après la génération de la collecte. Vérifiez l'URL proxy et les valeurs d'authentification de l'environnement Postman sélectionné.