Déployer et tester des API Wrapper pour Wholesale CBDC

Déployer le package d'API Wrapper

Pour pouvoir déployer le package d'API de 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 dans l'archive d'API de wrapper. Pour plus d'informations sur le déploiement d'API de wrapper et sur les variables de configuration, reportez-vous à API de wrapper. 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, cela 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_url <blockchain_url> URL Oracle Blockchain Platform associée au déploiement de code chaîne.
blockchain_chaincode WholesaleCBDC Nom du code chaîne pour lequel générer les API de wrapper.
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 WholesaleCBDC Nom d'affichage du réseau cloud virtuel OCI.
application_display_name WholesaleCBDC Nom d'affichage de l'application OCI.
gateway_display_name WholesaleCBDC Nom d'affichage de la passerelle d'API.
deployment_display_name WholesaleCBDC Nom d'affichage du déploiement dans API Gateway.
deployment_path_prefix /WholesaleCBDC 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 wholesalecbdc Nom du référentiel OCI Registry. La variable ocir_repo_name doit être en minuscules.
policy_name WholesaleCBDC 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 au sein de l'organisation

Pour plus d'informations sur la collection Postman, reportez-vous à Composants du package d'API wrapper.

Wholesale CBDC - Exemple de flux de processus

Un flux de processus typique 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'institution financière, approbateurs d'institution financière et utilisateurs d'institution financière 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 à la devise menthe.
  5. L'approbateur de la banque centrale utilise la vérification de l'API approveCBDCCreation et approuve la demande de monnaie. 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 est utilisée pour démarrer le transfert de devise vers un agent d'institution financière.
  9. L'approbateur de la banque centrale utilise l'API approveHoldCBDCTokens 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. L'agent de l'institution financière utilise l'API getCBDCAccountBalance pour vérifier que le montant crédité est exact.
  11. L'agent 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'établissement financier.
  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 du package d'API de wrapper CBDC de gros comprend 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.