Wrapper-APIs für Confidential 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 Blockchain App Builder for Oracle Blockchain Platform. 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_chaincode <chaincode_name> Der Name des Chaincodes, für den Wrapper-APIs generiert werden sollen.
blockchain_url <blockchain_url> Die Oracle Blockchain Platform-URL, die mit dem Chaincode-Deployment verknüpft ist.
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 WholesaleCBDCWithConfidentialPayment Der Anzeigename des virtuellen OCI-Cloud-Netzwerks.
application_display_name WholesaleCBDCWithConfidentialPayment Der Anzeigename der OCI-Anwendung.
gateway_display_name WholesaleCBDCWithConfidentialPayment Der Anzeigename des API-Gateways.
gateway_ocids {} Eine Liste der OCIDs vorhandener API-Gatewayinstanzen, die verwendet werden sollen.
deployment_display_name WholesaleCBDCWithConfidentialPayment Der Anzeigename des Deployments im API-Gateway.
deployment_path_prefix /WholesaleCBDCWithConfidentialPayment 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 wholesalecbdcwithconfidentialpayment Der Name des OCI Registry-Repositorys. Die Variable ocir_repo_name muss aus Kleinbuchstaben bestehen.
policy_name WholesaleCBDCWithConfidentialPayment Der Name der Policy, die eine kontrollierte Verwaltung und Zugriff auf APIs über definierte Berechtigungen für Gruppen und Compartments in der Organisation ermöglicht
isolationLevel serializable Die Transaktionsisolationsebene, mit der die Kontrolle und Konsistenz des gleichzeitigen Zugriffs während des Zwei-Phasen-Commit-Prozesses sichergestellt wird.

Informationen zur Postman-Collection finden Sie unter Wrapper API Package Components in Blockchain App Builder for Oracle Blockchain Platform.

Großhandel CBDC Beispielprozessablauf

Ein typischer Prozessfluss mit den CBDC-Wrapper-APIs des Großhandels folgt diesen grundlegenden Schritten.
  1. Der Administrator initialisiert das CBDC-Großhandelssystem mit der API initializeCBDCToken.
  2. Der Administrator verwendet die APIs createAccount und associateTokenToAccount, um Konten zu erstellen und das Token allen Erstellern, Zentralbankgenehmigern, Emittenten, Finanzinstituten, Finanzinstitutengenehmigern und Finanzinstitutsbenutzern im System zuzuordnen.
  3. Der Administrator weist dem Ersteller über die API addRole die Rolle "Münter" und dem Genehmiger der Zentralbank die Rolle "Notar" zu.
  4. Der Tokenersteller verwendet die API requestCBDCCreation, um eine Anforderung an die Münzwährung weiterzuleiten.
  5. Der Zentralbankgenehmiger verwendet die API-Prüfung approveCBDCCreation und genehmigt die Anforderung in eine Münzwährung. Die Währung wird dem Konto des Erstellers gutgeschrieben.
  6. Der Aussteller verwendet die API getCBDCAccountBalance, um zu überprüfen, ob der gutgeschriebene Betrag korrekt ist.
  7. Der Ersteller verwendet die API transferCBDCTokens, um die Währung an den Aussteller zu übertragen.
  8. Die API holdCBDCTokens wird verwendet, um den Wechsel der Währung an einen Finanzinstitutsbeauftragten zu starten.
  9. Der Zentralbankgenehmiger verwendet die API approveHoldCBDCTokensInterOrg, um die Übertragung der Währung an den Finanzinstitutsbeauftragten zu genehmigen. Die Währung wird dem Konto des Finanzinstitutsbeauftragten gutgeschrieben.
  10. Der Finanzinstitutsbeauftragte verwendet die API getCBDCAccountBalance, um zu prüfen, ob der gutgeschriebene Betrag korrekt ist.
  11. Der Finanzinstitutsbeauftragte verwendet die API holdCBDCTokens, um den Wechsel der Währung an einen Finanzinstitutsbenutzer zu starten.
  12. Der Genehmiger des Finanzinstituts verwendet die API approveHoldCBDCTokens, um den Wechsel der Währung an den Benutzer des Finanzinstituts zu genehmigen. Die Währung wird dem Konto des Finanzinstitutsbenutzers 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 vertraulichen CBDC-Wrapper-API-Paket enthält zusätzliche Attribute und APIs, die den CBDC-Großhandelskettencode unterstützen. Weitere Informationen finden Sie unter Wrapper API Package Components in Blockchain App Builder for Oracle Blockchain Platform.