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.- L'administrateur utilise l'API
initializeCBDCToken
pour initialiser le système CBDC de gros. - L'administrateur utilise les API
createAccount
etassociateTokenToAccount
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. - 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. - Le créateur du jeton utilise l'API
requestCBDCCreation
pour soumettre une demande de modification de devise. - 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. - L'émetteur utilise l'API
getCBDCAccountBalance
pour vérifier que le montant crédité est exact. - Le créateur utilise l'API
transferCBDCTokens
pour transférer la devise à l'émetteur. - L'API
holdCBDCTokens
est utilisée pour commencer le transfert de devise à un agent d'institution financière. - 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. - L'agent des institutions financières utilise l'API
getCBDCAccountBalance
pour vérifier que le montant crédité est exact. - Le dirigeant de l'institution financière utilise l'API
holdCBDCTokens
pour commencer le transfert de devise à un utilisateur de l'institution financière. - 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. - 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.