Wrapper-APIs für Wholesale CBDC bereitstellen und testen

Wrapper-API-Package bereitstellen

Bevor Sie das Wrapper-API-Package bereitstellen können, müssen Sie die erforderlichen Konfigurationsvariablen aktualisieren. Einige Konfigurationsvariablen haben Standardwerte. Sie müssen jedoch jede Variable, die einen Platzhalter als Standardwert enthält, manuell aktualisieren. Konfigurationsvariablen werden in der Datei terraform.tfvars im Wrapper-API-Archiv gespeichert. Weitere Informationen zum Deployment von Wrapper-APIs und zu Konfigurationsvariablen finden Sie unter Wrapper-APIs. In der folgenden Tabelle sind die Konfigurationsvariablen und ihre Standardwerte für das CBDC-Wrapper-API-Großhandelspackage aufgeführt. Wenn der Standardwert Platzhalter enthält, gibt er an, dass der Benutzer die erforderlichen Werte manuell angeben muss.

Variablenname Standardwert Beschreibung
compartment_ocid <compartment_ocid> Die OCID des Compartments in Oracle Cloud Infrastructure (OCI).
compartment_name <compartment_name> Der Name des OCI-Compartments.
identity_domain <identity_domain> Die zu verwendende Identitätsdomain.
blockchain_channel <blockchain_channel> Der Name des Oracle Blockchain Platform-Kanals, in dem der Chaincode bereitgestellt wird.
blockchain_url <blockchain_url> Die Oracle Blockchain Platform-URL, die mit dem Chaincode-Deployment verknüpft ist.
blockchain_chaincode WholesaleCBDC Der Name des Chaincodes, für den Wrapper-APIs generiert werden sollen.
blockchain_sync true Der Synchronisierungswert, der in die Payload für API-Aufrufe aufgenommen werden soll.
blockchain_timeout 6000 Der Timeoutwert, der in die Payload für API-Aufrufe aufgenommen werden soll.
vcn_display_name WholesaleCBDC Der Anzeigename des virtuellen OCI-Cloud-Netzwerks.
application_display_name WholesaleCBDC Der Anzeigename der OCI-Anwendung.
gateway_display_name WholesaleCBDC Der Anzeigename des API-Gateways.
deployment_display_name WholesaleCBDC Der Anzeigename des Deployments in API Gateway.
deployment_path_prefix /WholesaleCBDC Das Deployment-Pfadpräfix in API Gateway, das den Pfad angibt, in dem Routen bereitgestellt werden. Die Variable deployment_path_prefix muss mit einem Schrägstrich (/) beginnen.
ocir_repo_name wholesalecbdc Der Name des OCI Registry-Repositorys. Die Variable ocir_repo_name muss alle Kleinbuchstaben enthalten.
policy_name WholesaleCBDC Der Name der Policy, die über definierte Berechtigungen für Gruppen und Compartments innerhalb der Organisation eine kontrollierte Verwaltung und den Zugriff auf APIs ermöglicht

Informationen zur Postman-Sammlung finden Sie unter Komponenten des Wrapper-API-Packages.

Großhandel CBDC Probe Prozessablauf

Ein typischer Prozessfluss mit den CBDC-Wrapper-APIs im Großhandel führt diese grundlegenden Schritte aus.
  1. Der Administrator verwendet die API initializeCBDCToken, um das CBDC-Großhandelssystem zu initialisieren.
  2. Der Administrator verwendet die APIs createAccount und associateTokenToAccount, um Konten zu erstellen und das Token Konten für alle Ersteller, Zentralbankgenehmiger, Emittenten, Finanzinstitutsbeamte, Genehmiger von Finanzinstituten und Benutzer von Finanzinstituten im System zuzuordnen.
  3. Der Administrator verwendet die API addRole, um die Minter-Rolle dem Ersteller und die Notarrolle dem Genehmiger der Zentralbank zuzuweisen.
  4. Der Tokenersteller verwendet die API requestCBDCCreation, um eine Anforderung an die Münzwährung weiterzuleiten.
  5. Der Genehmiger der Zentralbank verwendet die API-Prüfung approveCBDCCreation und genehmigt die Anforderung zur Münzprägung. Die Währung wird dem Konto des Erstellers gutgeschrieben.
  6. Der Aussteller verwendet die API getCBDCAccountBalance, um zu prüfen, ob der gutgeschriebene Betrag korrekt ist.
  7. Der Ersteller verwendet die API transferCBDCTokens, um die Währung an den Emittenten zu übertragen.
  8. Mit der API holdCBDCTokens wird die Übertragung von Währungen an einen Finanzinstitutsbeauftragten gestartet.
  9. Der Zentralbankgenehmiger verwendet die API approveHoldCBDCTokens, um die Übertragung von Währungen an den Finanzinstitutsbeauftragten zu genehmigen. Die Währung wird dem Konto des Finanzinstitutsbeauftragten gutgeschrieben.
  10. Der Finanzinstitutsbeamte prüft mit der API getCBDCAccountBalance, ob der gutgeschriebene Betrag korrekt ist.
  11. Der Finanzinstitutsbeamte verwendet die API holdCBDCTokens, um die Übertragung von Währungen an einen Benutzer eines Finanzinstituts zu starten.
  12. Der Genehmiger des Finanzinstituts verwendet die API approveHoldCBDCTokens, um die Übertragung von Währungen an den Benutzer des Finanzinstituts zu genehmigen. Die Währung wird dem Konto des Benutzers des Finanzinstituts gutgeschrieben.
  13. Der Benutzer des Finanzinstituts verwendet die API getCBDCAccountBalance, um zu prüfen, ob der gutgeschriebene Betrag korrekt ist.

Postman-Sammlung

Die Postman-Collection im CBDC-Wrapper-API-Großhandelspaket enthält zusätzliche Attribute und APIs, die den CBDC-Kettencode im Großhandel unterstützen. Weitere Informationen finden Sie unter Komponenten des Wrapper-API-Packages.