Déployer et tester des API de wrapper pour les CBDC de gros confidentiels

Déploiement du package d'API Wrapper

Pour pouvoir déployer le package d'API wrapper, vous devez mettre à jour les variables de configuration requises. Certaines variables de configuration ont des valeurs par défaut, mais vous devez mettre à jour manuellement toute variable contenant un espace réservé comme valeur par défaut. Les variables de configuration sont stockées dans le fichier terraform.tfvars de l'archive d'API de wrapper. Pour plus d'informations sur le déploiement des API de wrapper et sur les variables de configuration, reportez-vous à API de wrapper dans Blockchain App Builder for Oracle Blockchain Platform. Le tableau suivant répertorie les variables de configuration et leurs valeurs par défaut pour le package d'API de wrapper CBDC de gros. Si la valeur par défaut contient des espaces réservés, elle indique que l'utilisateur doit fournir manuellement les valeurs nécessaires.

Nom de variable Valeur par défaut Description
compartment_ocid <compartment_ocid> OCID du compartiment dans Oracle Cloud Infrastructure (OCI).
compartment_name <compartment_name> Nom du compartiment OCI.
identity_domain <identity_domain> Domaine d'identité à utiliser.
blockchain_channel <blockchain_channel> Nom du canal Oracle Blockchain Platform sur lequel le code chaîne est déployé.
blockchain_chaincode <chaincode_name> Nom du code chaîne pour lequel générer des API de wrapper.
blockchain_url <blockchain_url> URL Oracle Blockchain Platform associée au déploiement de code chaîne.
blockchain_sync true Valeur de synchronisation à inclure dans la charge utile pour les appels d'API.
blockchain_timeout 6000 Valeur de délai d'expiration à inclure dans la charge utile pour les appels d'API.
vcn_display_name WholesaleCBDCWithConfidentialPayment Nom d'affichage du réseau cloud virtuel OCI.
application_display_name WholesaleCBDCWithConfidentialPayment Nom d'affichage de l'application OCI.
gateway_display_name WholesaleCBDCWithConfidentialPayment Nom d'affichage de API Gateway.
gateway_ocids {} Liste des OCID des instances API Gateway existantes à utiliser.
deployment_display_name WholesaleCBDCWithConfidentialPayment Nom d'affichage du déploiement dans API Gateway.
deployment_path_prefix /WholesaleCBDCWithConfidentialPayment Préfixe de chemin de déploiement dans API Gateway, qui indique le chemin où les routages sont déployés. La variable deployment_path_prefix doit commencer par une barre oblique (/).
ocir_repo_name wholesalecbdcwithconfidentialpayment Nom du référentiel OCI Registry. La variable ocir_repo_name doit être composée de lettres minuscules.
policy_name WholesaleCBDCWithConfidentialPayment Nom de la stratégie qui permet une gestion contrôlée et un accès aux API via des droits d'accès définis pour les groupes et les compartiments dans l'organisation
isolationLevel serializable Niveau d'isolement de la transaction, utilisé pour assurer le contrôle et la cohérence de la simultanéité d'accès aux données lors du processus de validation en deux phases.

Pour plus d'informations sur la collection Postman, reportez-vous à Composants de package d'API de wrapper dans Blockchain App Builder for Oracle Blockchain Platform.

Wholesale CBDC - Exemple de flux de traitement

Un flux de processus standard utilisant les API de wrapper CBDC en gros suit ces étapes de base.
  1. L'administrateur utilise l'API initializeCBDCToken pour initialiser le système CBDC de gros.
  2. L'administrateur utilise les API createAccount et associateTokenToAccount pour créer des comptes et associer le jeton à des comptes pour tous les créateurs, approbateurs de banque centrale, émetteurs, responsables d'institutions financières, approbateurs d'institutions financières et utilisateurs d'institutions financières dans le système.
  3. L'administrateur utilise l'API addRole pour affecter le rôle de mineur au créateur et le rôle de notaire à l'approbateur de la banque centrale.
  4. Le créateur de jeton utilise l'API requestCBDCCreation pour soumettre une demande de devise d'extraction.
  5. L'approbateur de la banque centrale utilise la vérification de l'API approveCBDCCreation et approuve la demande d'extraction de devise. La devise est créditée sur le compte du créateur.
  6. L'émetteur utilise l'API getCBDCAccountBalance pour vérifier que le montant crédité est exact.
  7. Le créateur utilise l'API transferCBDCTokens pour transférer la devise à l'émetteur.
  8. L'API holdCBDCTokens permet de démarrer le transfert de devise vers un responsable d'institution financière.
  9. L'approbateur de la banque centrale utilise l'API approveHoldCBDCTokensInterOrg pour approuver le transfert de devise au responsable de l'institution financière. La devise est créditée sur le compte de l'agent de l'institution financière.
  10. Le responsable de l'institution financière utilise l'API getCBDCAccountBalance pour vérifier que le montant crédité est exact.
  11. Le responsable de l'institution financière utilise l'API holdCBDCTokens pour démarrer le transfert de devise vers un utilisateur de l'institution financière.
  12. L'approbateur de l'institution financière utilise l'API approveHoldCBDCTokens pour approuver le transfert de devise à l'utilisateur de l'institution financière. La devise est créditée sur le compte de l'utilisateur de l'institution financière.
  13. L'utilisateur de l'institution financière utilise l'API getCBDCAccountBalance pour vérifier que le montant crédité est exact.

Collection Postman

La collection Postman dans le package d'API de wrapper CBDC de gros confidentiel inclut des attributs et des API supplémentaires qui prennent en charge le code chaîne CBDC de gros. Pour plus d'informations, reportez-vous à Composants de package d'API de wrapper dans Blockchain App Builder for Oracle Blockchain Platform.