Despliegue y prueba de API de Wrapper para Bond Marketplace

Despliegue del Paquete de API de Wrapper

Antes de desplegar el paquete de API de envoltorio, debe actualizar las variables de configuración necesarias. Algunas variables de configuración tienen valores por defecto, pero debe actualizar manualmente cualquier variable que contenga un marcador de posición como valor por defecto. Las variables de configuración se almacenan en el archivo terraform.tfvars en el archivo de API de envoltorio. Para obtener más información sobre el despliegue de API de envoltorio y sobre las variables de configuración, consulte Paquete de API de envoltorio CBDC al por mayor y también API de envoltorio en Blockchain App Builder for Oracle Blockchain Platform. En la siguiente tabla, se muestran las variables de configuración y sus valores por defecto para el paquete de API de envoltorio del mercado de bonos.

Nombre de la variable Valor por defecto Descripción
compartment_ocid <compartment_ocid> OCID del compartimento en Oracle Cloud Infrastructure (OCI).
compartment_name <compartment_name> Nombre del compartimento de OCI.
identity_domain <identity_domain> Dominio de identidad que se va a utilizar.
blockchain_channel <blockchain_channel> Nombre del canal de Oracle Blockchain Platform en el que se despliega el código de cadena.
blockchain_url <blockchain_url> URL de Oracle Blockchain Platform asociada al despliegue del código de cadena.
idcs_url <idcs_url> URL de Identity Cloud Service.
idcs_port <idcs_port> Número de puerto de Identity Cloud Service.
cbdc_chaincode <cbdc_chaincode> Nombre del código de cadenas CBDC al por mayor.
cbdc_channel <cbdc_channel> Canal en el que se despliega el código de cadena CBDC mayorista.
isolation_level <isolation_level> Nivel de aislamiento para transacciones atómicas. Normalmente, es serializable.
blockchain_chaincode BondMarketplace Nombre del código de cadenas para el que se van a generar las API de envoltorio.
blockchain_sync true Valor de sincronización que se incluirá en la carga útil para llamadas de API.
blockchain_timeout 6000 Valor de timeout que se va a incluir en la carga útil para llamadas de API.
vcn_display_name BondMarketplace Nombre mostrado de la red virtual en la nube de OCI.
application_display_name BondMarketplace Nombre mostrado de la aplicación de OCI.
gateway_display_name BondMarketplace Nombre mostrado de API Gateway.
deployment_display_name BondMarketplace Nombre mostrado del despliegue en API Gateway.
deployment_path_prefix /BondMarketplace Prefijo de ruta de acceso de despliegue en API Gateway, que especifica la ruta de acceso donde se despliegan las rutas. La variable deployment_path_prefix debe comenzar con una barra inclinada (/).
ocir_repo_name bondmarketplace Nombre del repositorio de OCI Registry. La variable ocir_repo_name debe estar todas en minúsculas.
policy_name BondMarketplace Nombre de la política que permite la gestión controlada y el acceso a las API mediante permisos definidos para grupos y compartimentos de la organización

Flujo de proceso de muestra de Bond Marketplace

Un flujo de proceso típico que utiliza las API de envoltorio de mercado de bonos sigue estos pasos básicos.
  1. Los administradores utilizan los métodos createUserAccount y createTokenAccount para crear cuentas NFT individuales para todos los usuarios.
  2. Los administradores utilizan el método addRole para asignar el rol de minter a los directivos de las instituciones financieras participantes (por ejemplo, FI-1 Bond Issuer).
  3. Los funcionarios de instituciones financieras (emisores de bonos) utilizan el método createBondToken para emitir bonos como NFT fraccionales.
  4. Los funcionarios de instituciones financieras utilizan el método getTokenById para revisar y confirmar los detalles de los bonos emitidos.
  5. Los compradores de bonos (por ejemplo, un usuario de la organización) utilizan el método atomicTransaction para llamar al método purchaseToken para comprar el bono fraccional de NFT y realizar un pago utilizando el código de cadena CBDC al por mayor.
  6. Los compradores utilizan el método balanceOfBatch para verificar la recepción del bono en su cartera.
  7. Los compradores utilizan el método getAccountBalance (código de cadena CBDC al por mayor) para confirmar la transferencia en su cartera CBDC al por mayor.
  8. Los emisores de bonos utilizan el método atomicTransaction para llamar al método payInterest para pagar intereses periódicos a los tenedores de bonos utilizando el código de cadena CBDC al por mayor.
  9. Los compradores utilizan el método requestTokenRedemption para enviar una solicitud para canjear su bono después de que haya vencido.
  10. Los funcionarios de instituciones financieras utilizan el método atomicTransaction para llamar al método approveTokenRedemption para aprobar la solicitud de reembolso y transferir fondos CBDC al por mayor al titular del bono.
  11. El titular del bono utiliza el método balanceOfBatch (código de cadena de mercado de bonos) y el método getAccountBalance (código de cadena de CBDC al por mayor) para verificar que el bono fue canjeado y que recibieron fondos en su cartera de CBDC al por mayor.

Colección Postman

La colección Postman en el paquete API wrapper del mercado de bonos incluye atributos y métodos adicionales que admiten el código de cadena del mercado de bonos. La siguiente tabla muestra las variables de recopilación de Postman que son específicas del paquete de mercado de bonos.
Variable Descripción Valor por defecto
bc-instance-client-id ID de cliente del servicio en la nube de Oracle Blockchain Platform. bc-instance-client-id
bc-instance-client-secret El secreto de cliente del servicio en la nube de Oracle Blockchain Platform. bc-instance-client-secret
int-app-client-id ID de cliente de la aplicación confidencial de Oracle Identity Cloud Service (IDCS), que se utiliza para crear un usuario de IDCS en la API de usuario CreateIDCS. int-app-client-id
int-app-client-secret Secreto de cliente de la aplicación confidencial de IDCS, que se utiliza para crear un usuario de IDCS en la API de usuario CreateIDCS. int-app-client-secret

Para obtener más información, consulte Componentes de paquete de API de envoltorio en Blockchain App Builder para Oracle Blockchain Platform.