Generación de una recopilación Postman de proxy RPC con la línea de comandos

Puede crear automáticamente una recopilación Postman para el token de un paquete desplegado y las ABI de cuenta/identidad.

La tarea generate-rpc-proxy-postman Hardhat genera una recopilación Postman para un proxy de RPC de Oracle Blockchain Platform a partir de artefactos de contrato de token y cuenta. La recopilación generada contiene las solicitudes de proxy derivadas de ambas ABI.

Antes de poder generar la recopilación Postman, debe instalar las dependencias del proyecto y compilar el proyecto para que Hardhat escriba los archivos JSON de artefacto necesarios. Asegúrese de que el archivo hardhat.config.ts importe la tarea generate-rpc-proxy-postman. Los proyectos generados suelen incluir la siguiente línea. 
import "./tasks/generate-rpc-proxy-postman";
Debe haber un artefacto de cuenta y un artefacto de token para ejecutar la tarea. Localice los archivos de artefacto en la carpeta artifacts/ y, a continuación, utilice sus rutas completas o relativas al proyecto en el comando.

Para generar una recopilación de Postman, ejecute la tarea con las dos rutas de artefacto y una ruta de salida, como se muestra en el siguiente ejemplo. Sustituya las rutas de artefacto de ejemplo y el nombre de archivo de salida por las del proyecto. El directorio de salida se crea cuando es necesario.

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

No edite manualmente la recopilación. Si cambia la ABI, vuelva a generar el cobro.

Para utilizar la toma generada, complete los pasos siguientes.

  1. En Postman, seleccione Importar y elija el archivo .postman.collection.json generado.
  2. Seleccione o cree un entorno que proporcione la URL base del proxy RPC y sus valores de autenticación.
  3. Revise las variables de recopilación y los cuerpos de solicitud antes de enviar una transacción. Los valores como la dirección del contrato, el firmante y los argumentos de método son específicos del entorno o de la solicitud.

Solución de problemas

Condición Resolución
No se ha encontrado la Tarea Confirme que el archivo hardhat.config.ts importe ./tasks/generate-rpc-proxy-postman y, a continuación, vuelva a ejecutar el comando desde la raíz del proyecto.
No se ha encontrado el archivo de artefactos Ejecute el comando de compilación del proyecto y verifique las rutas en la carpeta artifacts/. Proporcione el JSON de artefacto de contrato, no el archivo .sol de origen.
La recopilación no incluye un método Confirme que el método está presente en la ABI de artefacto de token o cuenta y, a continuación, vuelva a generar la recopilación.
La solicitud de Postman no está autorizada o no puede acceder al proxy Se trata de un problema de configuración del entorno después de la generación de la recopilación. Verifique la URL de proxy y los valores de autenticación del entorno de Postman seleccionado.