Implantar e Testar APIs do Wrapper para Stablecoin

Implantando o Pacote de API 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 do wrapper e sobre variáveis de configuração, consulte APIs do wrapper no Blockchain App Builder para Oracle Blockchain Platform. A tabela a seguir lista as variáveis de configuração e seus valores padrão para o pacote de API stablecoin wrapper.

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 em que o chaincode é implantado.
blockchain_url	<blockchain_url>	O URL do Oracle Blockchain Platform associado à implantação de chaincode.
blockchain_chaincode	Stablecoin	O nome do chaincode para o qual gerar APIs do 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	Stablecoin	O nome para exibição da rede virtual na nuvem do OCI.
application_display_name	Stablecoin	O nome para exibição do aplicativo OCI.
gateway_display_name	Stablecoin	O nome para exibição do Gateway de API.
deployment_display_name	Stablecoin	O nome para exibição da implantação no Gateway de API.
deployment_path_prefix	/Stablecoin	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	Stablecoin	O nome do repositório do OCI Registry. A variável ocir_repo_name deve ter todas as letras minúsculas.
policy_name	Stablecoin	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 de Processo de Amostra de Stablecoin

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

1. O administrador de token usa o método initializeStablecoinToken para inicializar uma stablecoin com um valor currencyName fixo (por exemplo, USD) e um valor conversionRate.
2. O administrador de token usa os métodos createAccounte associateTokenToAccount para criar contas de token para todos os usuários (aprovadores, minters, notários, remetentes e receptores de vários níveis).
3. O administrador de token usa o método createStablecoinAccountPolicyCheck para criar políticas de conta. As políticas de conta são obrigatórias para todas as contas que transferem ou mantêm stablecoins. Cada política de conta inclui três parâmetros: KYC, AML e restrictionFlag.

   KYC (Conheça Seus Clientes)

   A transferência só é permitida quando os valores de KYC são true para as contas do remetente e do recebedor.

   AML (Antilavagem de Dinheiro)

   A transferência só é permitida quando os valores de AML são true para as contas do remetente e do recebedor.

   restrictionFlag

   Se o indicador de restrição estiver definido como true para a conta do remetente ou do recebedor, a transferência só será permitida na faixa de buckets da política de aprovação mais baixa, tornando uma política de aprovação obrigatória.

4. O administrador de token usa o createApprovalPolicyCheck para criar uma política de aprovação. As políticas de aprovação definem limites de transação, números obrigatórios de aprovações e detalhes do aprovador e definem a sequência para aprovações de vários níveis. Uma política de aprovação é obrigatória para uma operação de retenção. Sem uma política de aprovação, os usuários não podem manter ou transferir tokens quando as restrições se aplicam.
5. O administrador de token usa o método addRole para designar as atribuições de minter, burner e notário às contas apropriadas.
6. O mineiro usa o método requestMint para enviar uma solicitação para cunhar stablecoins.
7. O notário usa o método approveMint para aprovar a solicitação de cunhagem.
8. O remetente usa o método holdTokens para iniciar uma transferência. O sistema executa uma verificação de política de conta para o remetente e o destinatário. Se a conformidade com KYC ou AML não for atendida para nenhuma das contas, a transferência não será permitida. Se o indicador de restrição for definido como true para qualquer conta, somente o valor no intervalo de limites de política de aprovação mais baixo poderá ser colocado em retenção. Em seguida, o valor da transferência é comparado com os limites da política de aprovação, e os aprovadores necessários e suas sequências de aprovação são derivados da política de aprovação.
9. Os aprovadores de vários níveis usam o método approveTransaction para analisar e autorizar a transferência na sequência exata definida na política de aprovação. Se a política de aprovação especificar zero aprovadores, o notário poderá usar o método executeHoldTokens diretamente para concluir a transação. O sistema revalida a conformidade com KYC e AML e o flag de restrição durante cada chamada para executeHoldTokens e approveTransaction. Se alguma verificação falhar, a transação será bloqueada.
10. Depois que todas as aprovações forem concluídas com êxito, o notário atribuído usará o método executeHoldTokens para concluir a transferência para a conta do recebedor.
11. O gravador usa o método requestBurn para enviar uma solicitação para gravar stablecoins.
12. O notário usa o método approveBurn para aprovar a solicitação de gravação.
13. Os administradores e auditores de token usam o getStablecointAccountTransactionHistory e o getStablecoinAccountTransactionHistoryWithFilters para rastrear todos os eventos de token, incluindo cunhagem, retenção, fluxos de aprovação de vários níveis, transferências e gravação.

Coleção Postman

A coleção Postman no pacote API invólucro stablecoin inclui atributos e métodos adicionais que suportam o código de cadeia stablecoin. A tabela a seguir mostra as variáveis de coleção Postman que são específicas para o pacote stablecoin.

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.