Déployer et tester des API d'emballage pour CBDC de gros

Déploiement du paquetage d'API Wrapper

Avant de déployer l'ensemble d'API d'encapsuleur, 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 paramètre fictif en tant que valeur par défaut. Les variables de configuration sont stockées dans le fichier terraform.tfvars dans l'archive de l'API d'encapsulation. Pour plus d'informations sur le déploiement des API d'encapsuleur et sur les variables de configuration, voir API d'encapsuleur. Le tableau suivant répertorie les variables de configuration et leurs valeurs par défaut pour l'ensemble d'API d'encapsulation CBDC de gros. Si la valeur par défaut contient des paramètres fictifs, 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 dans lequel le code de chaîne est déployé.
blockchain_url <blockchain_url> URL Oracle Blockchain Platform associée au déploiement de code de chaîne.
blockchain_chaincode WholesaleCBDC Nom du code de chaîne pour lequel générer les API d'encapsulation.
blockchain_sync true Valeur de synchronisation à inclure dans les données utiles pour les appels d'API.
blockchain_timeout 6000 Valeur de temporisation à inclure dans les données utiles pour les appels d'API.
vcn_display_name WholesaleCBDC Nom d'affichage du réseau en nuage 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 la passerelle d'API.
deployment_path_prefix /WholesaleCBDC Préfixe du chemin de déploiement dans la passerelle d'API, qui spécifie le chemin où les routes sont déployées. La variable deployment_path_prefix doit commencer par une barre oblique (/).
ocir_repo_name wholesalecbdc Nom du référentiel du registre OCI. La variable ocir_repo_name doit contenir toutes des lettres minuscules.
policy_name WholesaleCBDC Nom de la politique qui permet une gestion contrôlée et l'accès aux API au moyen d'autorisations définies pour les groupes et les compartiments de l'organisation.

Pour plus d'informations sur la collection Postman, voir Composants d'ensemble d'API d'encapsuleur.

Flux de traitement d'échantillon CBDC de gros

Un flux de processus type utilisant les API d'emballage CBDC de 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 aux comptes de 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 créateur et le rôle de notaire à l'approbateur de la banque centrale.
  4. Le créateur du jeton utilise l'API requestCBDCCreation pour soumettre une demande de modification de devise.
  5. L'approbateur de la banque centrale utilise la vérification de l'API approveCBDCCreation et approuve la demande de modification de devise. La devise est créditée au 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 commencer le transfert de devise à un agent d'institution financière.
  9. L'approbateur de la banque centrale utilise l'API approveHoldCBDCTokens pour approuver le transfert de devise à l'agent de l'institution financière. La devise est créditée au compte de l'agent de l'institution financière.
  10. L'agent des institutions financières utilise l'API getCBDCAccountBalance pour vérifier que le montant crédité est exact.
  11. Le dirigeant de l'institution financière utilise l'API holdCBDCTokens pour commencer le transfert de devise à 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 vers 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 du paquet d'API d'encapsulation CBDC de gros comprend des attributs et des API supplémentaires qui prennent en charge le code de chaîne CBDC de gros. Pour plus d'informations, voir Composants d'ensemble d'API d'encapsuleur.