Gerar uma Coleção Postman Proxy RPC com a Linha de Comando

Você pode criar automaticamente uma coleção Postman para um token de pacote implantado e ABIs de conta/identidade.

A tarefa Hardhat do generate-rpc-proxy-postman gera uma coleção Postman para um proxy RPC do Oracle Blockchain Platform de artefatos de contrato de conta e token. A coleção gerada contém as solicitações de proxy derivadas de ambas as ABIs.

Para poder gerar a coleção Postman, instale as dependências do projeto e compile o projeto para que Hardhat grave os arquivos JSON do artefato necessário. Certifique-se de que o arquivo hardhat.config.ts importe a tarefa generate-rpc-proxy-postman. Os projetos gerados geralmente incluem a linha a seguir.

import "./tasks/generate-rpc-proxy-postman";

Deve haver um artefato de conta e um artefato de token para executar a tarefa. Localize os arquivos de artefato na pasta artifacts/ e, em seguida, use seus caminhos completos ou relativos ao projeto no comando.

Para gerar uma coleção Postman, execute a tarefa com os dois caminhos de artefato e um caminho de saída, conforme mostrado no exemplo a seguir. Substitua os exemplos de caminhos de artefato e o nome do arquivo de saída pelos do seu projeto. O diretório output é criado quando necessário.

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

Não edite manualmente a coleção. Se o ABI for alterado, gere a coleta novamente.

Para usar a coleta gerada, execute os passos a seguir.

1. No Postman, selecione Importar e escolha o arquivo .postman.collection.json gerado.
2. Selecione ou crie um ambiente que forneça o URL base do proxy RPC e seus valores de autenticação.
3. Revise as variáveis de cobrança e os órgãos de solicitação antes de enviar uma transação. Valores como endereço do contrato, signatário e argumentos de método são específicos do ambiente ou da solicitação.

Solucionando Problemas

Condição	Resolução
Tarefa não encontrada	Confirme se o arquivo hardhat.config.ts importa ./tasks/generate-rpc-proxy-postman e, em seguida, execute o comando novamente na raiz do projeto.
Arquivo de artefato não encontrado	Execute o comando de compilação do projeto e verifique os caminhos na pasta artifacts/. Forneça o JSON do artefato do contrato, não o arquivo .sol de origem.
A coleção não inclui um método	Confirme se o método está presente na conta ou no ABI do artefato de token e gere novamente a coleta.
A solicitação do postman não está autorizada ou não pode acessar o proxy	Este é um problema de configuração do ambiente após a geração da coleta. Verifique o URL de proxy e os valores de autenticação do ambiente Postman selecionado.