Déployer et tester des API de wrapper pour Bond Marketplace

Déployer le package d'API Wrapper

Pour pouvoir déployer le package d'API 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 de l'archive d'API de wrapper. Pour plus d'informations sur le déploiement des API de wrapper et sur les variables de configuration, reportez-vous à Package d'API de wrapper CBDC pour le commerce de gros, ainsi qu'à API de wrapper dans Blockchain App Builder for Oracle Blockchain Platform. Le tableau suivant répertorie les variables de configuration et leurs valeurs par défaut pour le package API wrapper de bond marketplace.

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.
`idcs_url`	`<idcs_url>`	URL d'Identity Cloud Service.
`idcs_port`	`<idcs_port>`	Numéro de port d'Identity Cloud Service.
`cbdc_chaincode`	`<cbdc_chaincode>`	Nom du code chaîne CBDC de gros.
`cbdc_channel`	`<cbdc_channel>`	Canal sur lequel le code 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 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`	`BondMarketplace`	Nom d'affichage du réseau cloud 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 API Gateway.
`deployment_path_prefix`	`/BondMarketplace`	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`	`bondmarketplace`	Nom du référentiel OCI Registry. La variable `ocir_repo_name` doit être en minuscules.
`policy_name`	`BondMarketplace`	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 dans l'organisation

Exemple de flux de traitement de place de marché des obligations

Un flux de processus standard utilisant les API de wrapper du marché des obligations 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 agents 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 sous forme de NFT 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 d'organisation) utilisent la méthode atomicTransaction pour appeler la méthode purchaseToken afin d'acheter l'obligation NFT fractionnée et d'effectuer un paiement à l'aide du code 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 (code chaîne CBDC en gros) 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 chaîne CBDC de gros.
Les acheteurs utilisent la méthode requestTokenRedemption pour soumettre une demande d'échange de leurs obligations après leur échéance.
Les agents des institutions financières utilisent la méthode atomicTransaction pour appeler la méthode approveTokenRedemption afin d'approuver la demande de rachat et de transférer des fonds CBDC de gros au détenteur de l'obligation.
Le détenteur de l'obligation utilise la méthode balanceOfBatch (code chaîne du marché des obligations) et la méthode getAccountBalance (code 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.

Collection Postman

La collection Postman dans le package API wrapper bond marketplace inclut des attributs et des méthodes supplémentaires qui prennent en charge le code chaîne bond marketplace. Le tableau suivant présente les variables de recouvrement Postman qui sont spécifiques au package Bond Marketplace.

Variable	Description	Valeur par défaut
`bc-instance-client-id`	ID client du service cloud Oracle Blockchain Platform.	`bc-instance-client-id`
`bc-instance-client-secret`	Clé secrète du client du service cloud Oracle Blockchain Platform.	`bc-instance-client-secret`
`int-app-client-id`	ID client de l'application confidentielle Oracle Identity Cloud Service (IDCS), qui permet de créer un utilisateur IDCS dans l'API 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 utilisateur `CreateIDCS`.	`int-app-client-secret`

Pour plus d'informations, reportez-vous à Composants de package d'API de wrapper dans Blockchain App Builder for Oracle Blockchain Platform.