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 Großhandels-CBDC-Wrapper-API-Package und auch unter Wrapper-APIs in Blockchain App Builder for Oracle Blockchain Platform. In der folgenden Tabelle sind die Konfigurationsvariablen und deren Standardwerte für das Wrapper-API-Package des Bond Marketings 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`	`BondMarketplace`	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`	`BondMarketplace`	Der Anzeigename des virtuellen OCI-Cloud-Netzwerks.
`application_display_name`	`BondMarketplace`	Der Anzeigename der OCI-Anwendung.
`gateway_display_name`	`BondMarketplace`	Der Anzeigename des API-Gateways.
`deployment_display_name`	`BondMarketplace`	Der Anzeigename des Deployments in API Gateway.
`deployment_path_prefix`	`/BondMarketplace`	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`	`bondmarketplace`	Der Name des OCI Registry-Repositorys. Die Variable `ocir_repo_name` muss alle Kleinbuchstaben enthalten.
`policy_name`	`BondMarketplace`	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

Beispielprozessablauf für Bond Marketplace

Ein typischer Prozessfluss mit den Bond Marketplace-Wrapper-APIs führt diese grundlegenden Schritte aus.

Administratoren verwenden die Methoden createUserAccount und createTokenAccount, um einzelne NFT-Konten für alle Benutzer zu erstellen.
Administratoren verwenden die Methode addRole, um die Minterrolle den Offizieren teilnehmender Finanzinstitute zuzuweisen (z.B. FI-1 Bond Issuer).
Finanzinstitutsbeamte (Anleiheemittenten) verwenden die Methode createBondToken, um Anleihen als Bruchteil-NFTs auszugeben.
Finanzinstitutsbeamte verwenden die Methode getTokenById, um die Details der emittierten Anleihen zu überprüfen und zu bestätigen.
Anleihekäufer (z.B. ein Organisationsbenutzer) verwenden die Methode atomicTransaction, um die Methode purchaseToken aufzurufen, um die partielle NFT-Anleihe zu kaufen und eine Zahlung mit dem CBDC-Großhandelskettencode vorzunehmen.
Käufer verwenden die Methode balanceOfBatch, um den Erhalt der Anleihe in ihrem Wallet zu überprüfen.
Käufer verwenden die getAccountBalance-Methode (Großhandels-CBDC-Kettencode), um die Übertragung in ihrem CBDC-Großhandels-Wallet zu bestätigen.
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.
Käufer verwenden die Methode requestTokenRedemption, um einen Antrag auf Einlösung ihrer Anleihe nach der Fälligkeit zu stellen.
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.
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-Collection im Wrapper-API-Package für Bond Marketplace umfasst zusätzliche Attribute und Methoden, die den Bond Marketplace-Chaincode unterstützen. Die folgende Tabelle zeigt die Postman-Collection-Variablen, die für das Bond Marketplace-Package spezifisch sind.

Variable	Beschreibung	Standardwert
`bc-instance-client-id`	Die Client-ID des Oracle Blockchain Platform-Cloud-Service.	`bc-instance-client-id`
`bc-instance-client-secret`	Das Client Secret des Oracle Blockchain Platform-Cloud-Service.	`bc-instance-client-secret`
`int-app-client-id`	Die Client-ID der vertraulichen Oracle Identity Cloud Service-(IDCS-)Anwendung, mit der ein IDCS-Benutzer in der Benutzer-API `CreateIDCS` erstellt wird.	`int-app-client-id`
`int-app-client-secret`	Das Client Secret der vertraulichen IDCS-Anwendung, mit dem ein IDCS-Benutzer in der Benutzer-API `CreateIDCS` erstellt wird.	`int-app-client-secret`

Weitere Informationen finden Sie unter Wrapper API Package Components in Blockchain App Builder for Oracle Blockchain Platform.