Déployer et tester des API d'encapsuleur pour le marché des obligations

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 Ensemble d'API d'encapsuleur CBDC en gros et API d'encapsuleur dans Blockchain App Builder pour Oracle Blockchain Platform. Le tableau suivant répertorie les variables de configuration et leurs valeurs par défaut pour l'ensemble API wrapper du marché des obligations.

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.
`idcs_url`	`<idcs_url>`	URL de l'application Identity Cloud Service.
`idcs_port`	`<idcs_port>`	Numéro de port de l'application Identity Cloud Service.
`cbdc_chaincode`	`<cbdc_chaincode>`	Nom du code de chaîne CBDC en gros.
`cbdc_channel`	`<cbdc_channel>`	Canal sur lequel le code de chaîne CBDC de gros est déployé.
`isolation_level`	`<isolation_level>`	Niveau d'isolement pour les transactions atomiques. En général, il s'agit de `serializable`.
`blockchain_chaincode`	`BondMarketplace`	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`	`BondMarketplace`	Nom d'affichage du réseau en nuage virtuel OCI.
`application_display_name`	`BondMarketplace`	Nom d'affichage de l'application OCI.
`gateway_display_name`	`BondMarketplace`	Nom d'affichage de la passerelle d'API.
`deployment_display_name`	`BondMarketplace`	Nom d'affichage du déploiement dans la passerelle d'API.
`deployment_path_prefix`	`/BondMarketplace`	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`	`bondmarketplace`	Nom du référentiel du registre OCI. La variable `ocir_repo_name` doit contenir toutes des lettres minuscules.
`policy_name`	`BondMarketplace`	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.

Flux de traitement des échantillons du marché des applications d'obligations

Un flux de processus type utilisant les API d'encapsulation du marché des liaisons suit ces étapes de base.

Les administrateurs utilisent les méthodes createUserAccount et createTokenAccount pour créer des comptes NFT individuels pour tous les utilisateurs.
Les administrateurs utilisent la méthode addRole pour affecter le rôle de mineur aux dirigeants des institutions financières participantes (par exemple, FI-1 Bond Issuer).
Les agents des institutions financières (émetteurs d'obligations) utilisent la méthode createBondToken pour émettre des obligations en tant que TNF fractionnaires.
Les agents des institutions financières utilisent la méthode getTokenById pour examiner et confirmer les détails des obligations émises.
Les acheteurs d'obligations (par exemple, un utilisateur de l'organisation) utilisent la méthode atomicTransaction pour appeler la méthode purchaseToken pour acheter l'obligation NFT fractionnelle et effectuer un paiement à l'aide du code de chaîne CBDC de gros.
Les acheteurs utilisent la méthode balanceOfBatch pour vérifier la réception de l'obligation dans leur portefeuille.
Les acheteurs utilisent la méthode getAccountBalance (gros code de chaîne CBDC) pour confirmer le transfert dans leur portefeuille CBDC en gros.
Les émetteurs d'obligations utilisent la méthode atomicTransaction pour appeler la méthode payInterest afin de payer des intérêts périodiques aux détenteurs d'obligations à l'aide du code de chaîne CBDC de gros.
Les acheteurs utilisent la méthode requestTokenRedemption pour soumettre une demande de remboursement de leur obligation après son échéance.
Les agents des institutions financières utilisent la méthode atomicTransaction pour appeler la méthode approveTokenRedemption pour approuver la demande de remboursement et pour transférer des fonds CBDC de gros au détenteur d'obligations.
Le détenteur d'obligations utilise la méthode balanceOfBatch (code de chaîne du marché des obligations) et la méthode getAccountBalance (code de chaîne CBDC en gros) pour vérifier que l'obligation a été échangée et qu'il a reçu des fonds dans son portefeuille CBDC en gros.

Palette Postman Collection

La collection Postman du package API wrapper du marché obligataire comprend des attributs et des méthodes supplémentaires qui prennent en charge le code de chaîne du marché obligataire. Le tableau suivant présente les variables de collection Postman propres au paquetage du marché des obligations.

Variable	Description	Valeur par défaut
`bc-instance-client-id`	ID client du service Oracle Blockchain Platform Cloud.	`bc-instance-client-id`
`bc-instance-client-secret`	Clé secrète client du service Oracle Blockchain Platform Cloud.	`bc-instance-client-secret`
`int-app-client-id`	ID client de l'application confidentielle Oracle Identity Cloud Service (IDCS), utilisée pour créer un utilisateur IDCS dans l'API d'utilisateur `CreateIDCS`.	`int-app-client-id`
`int-app-client-secret`	Clé secrète client de l'application confidentielle IDCS, utilisée pour créer un utilisateur IDCS dans l'API d'utilisateur `CreateIDCS`.	`int-app-client-secret`

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