Wrapper-APIs für den Bond Marketplace 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 und Großhandels-CBDC-Wrapper-API-Package. In der folgenden Tabelle sind die Konfigurationsvariablen und ihre Standardwerte für das Bond Marketplace-Wrapper-API-Package aufgeführt.

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.
idcs_url <idcs_url> Die URL von Identity Cloud Service.
idcs_port <idcs_port> Die Portnummer des Identity Cloud Service.
cbdc_chaincode <cbdc_chaincode> Der Name des CBDC-Großhandelskettencodes.
cbdc_channel <cbdc_channel> Der Kanal, in dem der CBDC-Großhandelskettencode bereitgestellt wird.
isolation_level <isolation_level> Die Isolationsebene für atomare Transaktionen. Normalerweise ist dies serializable.
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

Beispielprozessablauf für Bond Marketplace

Ein typischer Prozessfluss mit den Bond Marketplace-Wrapper-APIs führt diese grundlegenden Schritte aus.
  1. Administratoren verwenden die Methoden createUserAccount und createTokenAccount, um einzelne NFT-Konten für alle Benutzer zu erstellen.
  2. Administratoren verwenden die Methode addRole, um die Minterrolle den Offizieren teilnehmender Finanzinstitute zuzuweisen (z.B. FI-1 Bond Issuer).
  3. Finanzinstitutsbeamte (Anleiheemittenten) verwenden die Methode createBondToken, um Anleihen als Bruchteil-NFTs auszugeben.
  4. Finanzinstitutsbeamte verwenden die Methode getTokenById, um die Details der emittierten Anleihen zu überprüfen und zu bestätigen.
  5. Anleihekäufer (z.B. FI User) verwenden die Methode atomicTransaction, um die Methode purchaseToken aufzurufen, um die fraktionierte NFT-Anleihe zu kaufen und eine Zahlung mit dem CBDC-Großhandelskettencode vorzunehmen.
  6. Käufer verwenden die Methode balanceOfBatch, um den Erhalt der Anleihe in ihrem Wallet zu überprüfen.
  7. Käufer verwenden die getAccountBalance-Methode (Großhandels-CBDC-Kettencode), um die Übertragung in ihrem CBDC-Großhandels-Wallet zu bestätigen.
  8. Anleiheemittenten verwenden die Methode atomicTransaction, um die Methode payInterest aufzurufen, um periodische Zinsen an Anleihegläubiger mit dem CBDC-Kettencode des Großhandels zu zahlen.
  9. Käufer verwenden die Methode requestTokenRedemption, um einen Antrag auf Einlösung ihrer Anleihe nach der Fälligkeit zu stellen.
  10. Führungskräfte von Finanzinstituten verwenden die Methode atomicTransaction, um die Methode approveTokenRedemption aufzurufen, um den Rücknahmeantrag zu genehmigen und CBDC-Großkundenfonds an den Anleiheinhaber zu übertragen.
  11. Der Anleiheinhaber verwendet die Methode balanceOfBatch (Bond Marketplace Chaincode) und die Methode getAccountBalance (Großhandels-CBDC-Kettencode), um zu überprüfen, ob die Anleihe eingelöst wurde und ob sie Gelder in ihrer Großhandels-CBDC-Wallet erhalten haben.

Postman-Sammlung

Die Postman-Sammlung im Bond Marketplace-Wrapper-API-Paket umfasst zusätzliche Attribute und Methoden, die den Bond Marketplace Chaincode unterstützen. Weitere Informationen finden Sie unter Komponenten des Wrapper-API-Packages.