Generieren einer RPC Proxy Postman Collection mit der Befehlszeile

Sie können automatisch eine Postman-Collection für Token und Konto-/Identitäts-ABIs eines bereitgestellten Pakets erstellen.

Mit der Hardhat-Aufgabe generate-rpc-proxy-postman wird eine Postman-Collection für einen Oracle Blockchain Platform RPC-Proxy aus Account- und Tokenvertragsartefakten generiert. Die generierte Collection enthält die Proxy-Anforderungen, die von beiden ABIs abgeleitet wurden.

Bevor Sie die Postman-Sammlung generieren können, müssen Sie die Projektabhängigkeiten installieren und das Projekt kompilieren, damit Hardhat die erforderlichen Artefakt-JSON-Dateien schreibt. Stellen Sie sicher, dass die Datei hardhat.config.ts die Aufgabe generate-rpc-proxy-postman importiert. Generierte Projekte enthalten in der Regel die folgende Position.

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

Um die Aufgabe auszuführen, müssen ein Accountartefakt und ein Tokenartefakt vorhanden sein. Suchen Sie die Artefaktdateien im Ordner artifacts/, und verwenden Sie dann ihre vollständigen oder projektrelativen Pfade im Befehl.

Um eine Postman-Collection zu generieren, führen Sie die Aufgabe mit den beiden Artefaktpfaden und einem Ausgabepfad aus, wie im folgenden Beispiel dargestellt. Ersetzen Sie die Beispielartefaktpfade und den Ausgabedateinamen durch die für Ihr Projekt. Das Ausgabeverzeichnis wird bei Bedarf erstellt.

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

Bearbeiten Sie die Sammlung nicht manuell. Wenn sich die ABI ändert, generieren Sie die Collection neu.

Gehen Sie folgendermaßen vor, um die generierte Abnahme zu verwenden.

Wählen Sie in Postman die Option Importieren, und wählen Sie die generierte Datei .postman.collection.json aus.
Wählen oder erstellen Sie eine Umgebung, in der die Basis-URL des RPC-Proxys und die zugehörigen Authentifizierungswerte angegeben werden.
Prüfen Sie die Collection-Variablen und Request Body, bevor Sie eine Transaktion senden. Werte wie Vertragsadresse, Signaturgeber und Methodenargumente sind umgebungs- oder anforderungsspezifisch.

Fehlerbehebung

Bedingung	Lösung
Aufgabe wurde nicht gefunden	Vergewissern Sie sich, dass die Datei `hardhat.config.ts` `./tasks/generate-rpc-proxy-postman` importiert, und führen Sie den Befehl dann erneut aus dem Projekt-Root aus.
Artefaktdatei nicht gefunden	Führen Sie den Kompilierungsbefehl des Projekts aus, und prüfen Sie die Pfade im Ordner `artifacts/`. Geben Sie das Vertragsartefakt-JSON an, nicht die Quelldatei `.sol`.
Die Sammlung enthält keine Methode	Vergewissern Sie sich, dass die Methode im Account- oder Tokenartefakt-ABI vorhanden ist, und generieren Sie dann die Collection neu.
Postman-Anforderung ist nicht autorisiert oder kann den Proxy nicht erreichen	Dies ist ein Umgebungskonfigurationsproblem nach der Collection-Generierung. Prüfen Sie die Proxy-URL und Authentifizierungswerte der ausgewählten Postman-Umgebung.