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

Déploiement du paquetage d'API de l'encapsuleur

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'encapsulation dans Blockchain App Builder for Oracle Blockchain Platform. 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 où le code de chaîne est déployé.
blockchain_chaincode <chaincode_name> Nom du code de chaîne pour lequel générer des API d'encapsuleur.
blockchain_url <blockchain_url> URL d'Oracle Blockchain Platform associée au déploiement du code de chaîne.
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 WholesaleCBDCWithConfidentialPayment Nom d'affichage du réseau en nuage virtuel OCI.
application_display_name WholesaleCBDCWithConfidentialPayment Nom d'affichage de l'application OCI.
gateway_display_name WholesaleCBDCWithConfidentialPayment Nom d'affichage de la passerelle d'API.
gateway_ocids {} Liste des OCID des instances de passerelle d'API existantes à utiliser.
deployment_display_name WholesaleCBDCWithConfidentialPayment Nom d'affichage du déploiement dans la passerelle d'API.
deployment_path_prefix /WholesaleCBDCWithConfidentialPayment 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 wholesalecbdcwithconfidentialpayment Nom du référentiel du registre OCI. La variable ocir_repo_name doit contenir toutes des lettres minuscules.
policy_name WholesaleCBDCWithConfidentialPayment Nom de la politique qui permet la 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.
isolationLevel serializable Niveau d'isolement des transactions, utilisé pour assurer le contrôle et la cohérence de la simultanéité d'accès aux données au cours du processus de validation en deux phases.

Pour plus d'informations sur la collection Postman, voir Composants d'ensemble d'API d'encapsulation dans Blockchain App Builder pour Oracle Blockchain Platform.

Flux de processus d'échantillon CBDC de gros

Un flux de processus typique utilisant les API d'encapsulation 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 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 devise minimale.
  5. L'approbateur de la banque centrale utilise l'API approveCBDCCreation pour vérifier et approuver la demande de devise minimale. 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 à un agent d'institution financière.
  9. L'approbateur de la banque centrale utilise l'API approveHoldCBDCTokensInterOrg pour approuver le transfert de devise à l'agent 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. Le responsable de l'institution financière utilise l'API holdCBDCTokens pour démarrer le transfert de devise vers un utilisateur d'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 confidentiel d'API d'encapsuleur CBDC en gros comprend des attributs et des API supplémentaires qui prennent en charge le code de chaîne CBDC en gros. Pour plus d'informations, voir Composants d'ensemble d'API d'encapsulation dans Blockchain App Builder pour Oracle Blockchain Platform.