Genera una raccolta RPC Proxy Postman con la riga di comando

È possibile creare automaticamente una raccolta Postman per gli ABI token e account/identità di un package distribuito.

Il task Hardhat generate-rpc-proxy-postman genera una raccolta Postman per un proxy RPC di Oracle Blockchain Platform dagli artifact del contratto di account e token. La raccolta generata contiene le richieste proxy derivate da entrambi gli ABI.

Prima di poter generare la raccolta Postman, è necessario installare le dipendenze del progetto e compilare il progetto in modo che Hardhat scriva i file JSON di artifact richiesti. Assicurarsi che il file hardhat.config.ts importi il task generate-rpc-proxy-postman. I progetti generati in genere includono la riga seguente.

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

Per eseguire il task, devono essere presenti un artifact dell'account e un artifact del token. Individuare i file artifact nella cartella artifacts/, quindi utilizzare i percorsi completi o relativi al progetto nel comando.

Per generare una raccolta Postman, eseguire il task con i due percorsi artifact un percorso di output, come mostrato nell'esempio seguente. Sostituire i percorsi artifact di esempio e il nome file di output con quelli per il progetto. La directory di output viene creata quando necessario.

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

Non modificare manualmente la raccolta. Se l'ABI cambia, rigenerare l'insieme.

Per utilizzare la raccolta generata, effettuare le operazioni riportate di seguito.

In Postman, selezionare Importa e scegliere il file .postman.collection.json generato.
Selezionare o creare un ambiente che fornisca l'URL di base proxy RPC e i relativi valori di autenticazione.
Esaminare le variabili di raccolta e i corpi delle richieste prima di inviare una transazione. Valori quali l'indirizzo del contratto, il firmatario e gli argomenti del metodo sono specifici dell'ambiente o della richiesta.

Risoluzione dei problemi

Condizione	Risoluzione
Task non trovata	Verificare che il file `hardhat.config.ts` importi `./tasks/generate-rpc-proxy-postman`, quindi eseguire di nuovo il comando dalla radice del progetto.
File di artifact non trovato	Eseguire il comando di compilazione del progetto e verificare i percorsi nella cartella `artifacts/`. Fornire il file JSON dell'artifact contratto, non il file `.sol` di origine.
La raccolta non include un metodo	Confermare che il metodo sia presente nell'artifact ABI dell'account o del token, quindi rigenerare la raccolta.
La richiesta Postman non è autorizzata o non può raggiungere il proxy	Si tratta di un problema di configurazione dell'ambiente dopo la generazione della raccolta. Verificare l'URL proxy e i valori di autenticazione dell'ambiente Postman selezionato.