Implantar e Testar APIs do Wrapper para o Bond Marketplace

Implantando o Pacote de API do Wrapper

Para poder implantar o pacote de API do wrapper, atualize as variáveis de configuração necessárias. Algumas variáveis de configuração têm valores padrão, mas você deve atualizar manualmente qualquer variável que contenha um espaço reservado como seu valor padrão. As variáveis de configuração são armazenadas no arquivo terraform.tfvars no arquivo compactado da API wrapper. Para obter mais informações sobre como implantar APIs de wrapper e sobre variáveis de configuração, consulte Pacote de API de Wrapper CBDC Atacadista e também APIs de Wrapper no Blockchain App Builder for Oracle Blockchain Platform. A tabela a seguir lista as variáveis de configuração e seus valores padrão para o pacote de API do encapsulador do mercado de títulos.

Nome da variável	Valor padrão	Descrição
`compartment_ocid`	`<compartment_ocid>`	O OCID do compartimento no OCI (Oracle Cloud Infrastructure).
`compartment_name`	`<compartment_name>`	O nome do compartimento do OCI.
`identity_domain`	`<identity_domain>`	O domínio de identidades a ser usado.
`blockchain_channel`	`<blockchain_channel>`	O nome do canal do Oracle Blockchain Platform no qual o chaincode é implantado.
`blockchain_url`	`<blockchain_url>`	O URL do Oracle Blockchain Platform associado à implantação de chaincode.
`idcs_url`	`<idcs_url>`	O URL do Identity Cloud Service.
`idcs_port`	`<idcs_port>`	O número da porta do Identity Cloud Service.
`cbdc_chaincode`	`<cbdc_chaincode>`	O nome do chaincode CBDC de atacado.
`cbdc_channel`	`<cbdc_channel>`	O canal no qual o chaincode CBDC de atacado é implantado.
`isolation_level`	`<isolation_level>`	O nível de isolamento para transações atômicas. Normalmente, isso é `serializable`.
`blockchain_chaincode`	`BondMarketplace`	O nome do chaincode para o qual gerar APIs wrapper.
`blockchain_sync`	`true`	O valor de sincronização a ser incluído no payload para chamadas de API.
`blockchain_timeout`	`6000`	O valor de timeout a ser incluído no payload para chamadas de API.
`vcn_display_name`	`BondMarketplace`	O nome para exibição da rede virtual na nuvem do OCI.
`application_display_name`	`BondMarketplace`	O nome para exibição do aplicativo OCI.
`gateway_display_name`	`BondMarketplace`	O nome para exibição do Gateway de API.
`deployment_display_name`	`BondMarketplace`	O nome para exibição da implantação no Gateway de API.
`deployment_path_prefix`	`/BondMarketplace`	O prefixo do caminho de implantação no Gateway de API, que especifica o caminho no qual as rotas são implantadas. A variável `deployment_path_prefix` deve começar com uma barra (/).
`ocir_repo_name`	`bondmarketplace`	O nome do repositório do OCI Registry. A variável `ocir_repo_name` deve ter todas letras minúsculas.
`policy_name`	`BondMarketplace`	O nome da política que permite o gerenciamento controlado e o acesso a APIs por meio de permissões definidas para grupos e compartimentos na organização

Fluxo do Processo de Amostra do Mercado de Bond

Um fluxo de processo típico usando as APIs wrapper do mercado de títulos segue estas etapas básicas.

Os administradores usam os métodos createUserAccount e createTokenAccount para criar contas NFT individuais para todos os usuários.
Os administradores usam o método addRole para atribuir a função de mineiro aos executivos das instituições financeiras participantes (por exemplo, FI-1 Bond Issuer).
Os administradores de instituições financeiras (emissores de títulos) usam o método createBondToken para emitir títulos como NFTs fracionários.
Os administradores de instituições financeiras usam o método getTokenById para revisar e confirmar os detalhes das obrigações emitidas.
Os compradores de títulos (por exemplo, um usuário da organização) usam o método atomicTransaction para chamar o método purchaseToken para comprar o título NFT fracionário e fazer um pagamento usando o chaincode CBDC de atacado.
Os compradores usam o método balanceOfBatch para verificar o recebimento do título em sua carteira.
Os compradores usam o método getAccountBalance (código de cadeia CBDC de atacado) para confirmar a transferência em sua carteira CBDC de atacado.
Os emissores de títulos usam o método atomicTransaction para chamar o método payInterest para pagar juros periódicos aos titulares de títulos usando o chaincode CBDC de atacado.
Os compradores usam o método requestTokenRedemption para enviar uma solicitação para resgatar seu título após o vencimento.
Os administradores de instituições financeiras usam o método atomicTransaction para chamar o método approveTokenRedemption para aprovar a solicitação de resgate e transferir fundos CBDC atacadistas para o titular da obrigação.
O detentor do título usa o método balanceOfBatch (código de cadeia do mercado de títulos) e o método getAccountBalance (código de cadeia CBDC de atacado) para verificar se o título foi resgatado e se recebeu fundos em sua carteira CBDC de atacado.

Coleção Postman

A coleção Postman no pacote de API wrapper do mercado de títulos inclui atributos e métodos adicionais que suportam o chaincode do mercado de títulos. A tabela a seguir mostra as variáveis de cobrança Postman que são específicas do pacote de mercado de títulos.

Variável	Descrição	Valor padrão
`bc-instance-client-id`	O ID do cliente do serviço de nuvem do Oracle Blockchain Platform.	`bc-instância-id do cliente`
`bc-instance-client-secret`	O segredo do cliente do serviço de nuvem do Oracle Blockchain Platform.	`bc-instância-cliente-segredo`
`int-app-client-id`	O ID do cliente do aplicativo confidencial do Oracle Identity Cloud Service (IDCS), que é usado para criar um usuário do IDCS na API do usuário `CreateIDCS`.	`int-app-client-id`
`int-app-client-secret`	O segredo do cliente do aplicativo confidencial do IDCS, que é usado para criar um usuário do IDCS na API do usuário `CreateIDCS`.	`int-app-client-secret`

Para obter mais informações, consulte Componentes de Pacote de API Compactadores no Blockchain App Builder for Oracle Blockchain Platform.