Fazer Atualizações Atômicas entre Chaincodes e Canais

Você pode usar transações atômicas para concluir várias transações entre canais e chaincodes de maneira atômica.

Uma transação atômica é uma série indivisível de operações de dados que são bem-sucedidas ou que nenhuma é bem-sucedida.

As transações atômicas podem ser úteis em situações complexas em que vários chaincodes são implantados em canais separados. Você pode usar transações atômicas para manter a consistência dos dados ao executar várias transações de blockchain, mesmo que ocorra uma falha na rede ou no sistema. O Oracle Blockchain Platform suporta transações atômicas usando o protocolo de commit de duas fases, em que uma fase inicial em que cada operação de dados é preparada é seguida por uma fase em que cada operação de dados é realmente confirmada.

As transações atômicas funcionam no nível do aplicativo. Normalmente, não é necessário alterar a lógica de chaincode existente para suportar transações atômicas. Como um ou mais argumentos adicionais são adicionados pela estrutura de transações atômicas, certifique-se de que qualquer chaincode existente não execute verificações rigorosas do número de argumentos passados no método chaincode. As transações atômicas são suportadas pelo seguinte ponto final da API REST:
  • restproxy/api/v2/atomicTransactions
O ponto final da API REST prepara as transações conforme definido pelo seu chaincode e, em seguida, usa funções integradas de chaincode para fazer commit de todas as transações ou reverter todas as transações se houver erros durante a fase de preparação. Para obter mais informações sobre os pontos finais REST a serem usados para implementar transações atômicas, consulte Pontos Finais REST de Transações Atômicas.

Cada transação atômica é composta por duas ou mais transações de blockchain. O resultado (o valor returnCode) da transação atômica é Success ou Failure. Em uma transação atômica, cada transação blockchain solicitada é dividida em duas operações distintas: uma fase de preparação e, em seguida, uma fase de commit ou rollback.

  • Na fase de preparação, cada transação é endossada como de costume, mas em vez de ser finalizada, as alterações são preparadas e os valores são bloqueados para impedir que outras transações modifiquem os valores de preparação.
  • Se a fase de preparação for bem-sucedida para cada transação blockchain, as transações serão endossadas e confirmadas usando chaincode incorporado. Os valores bloqueados anteriormente são desbloqueados e o resultado da transação atômica é Success.
  • Se a fase de preparação falhar para qualquer transação blockchain, todas as outras transações em que a fase de preparação foi bem-sucedida serão revertidas, novamente usando chaincode incorporado. As alterações preparadas são removidas e os valores bloqueados anteriormente são desbloqueados. O resultado da transação atômica é Failure.
Como as transações atômicas funcionam bloqueando chaves, você poderá receber um erro Two_Phase_Commit_Lock se uma transação diferente tentar modificar uma chave bloqueada por uma transação atômica ativa no momento que está preparada. Isso pode ocorrer em um dos dois cenários a seguir:
  • Uma transação atômica ainda está na fase preparada e outra transação tenta modificar uma chave que foi bloqueada pela transação preparada. Neste caso, o sistema está funcionando como projetado. Se você encontrar esse erro, repita a segunda transação. Isso é análogo ao modo como os aplicativos lidam com erros de leitura fantasma ou erros de MVCC (Multi-version Concurrency Control).
  • O valor GlobalStatus retornado pela transação atômica é HeuristicOutcome. Nesse caso, uma operação de transação atômica foi cancelada porque uma das operações de commit falhou. Esta é uma ocorrência rara e pode precisar ser resolvida manualmente. Um efeito colateral de um resultado heurístico é que algumas chaves podem ser bloqueadas por transações que não foram confirmadas ou revertidas. Nesse caso, use o seguinte ponto final da API REST para desbloquear a transação atômica:
    • restproxy/api/v2/atomicTransactions/{globalTransactionId}
    Para obter mais informações sobre o ponto final REST a ser usado para desbloquear transações atômicas, consulte Desbloquear Transação Atômica.

Cenário: Explorar Transações Atômicas Usando Amostras

Considere o exemplo a seguir, que usa dois dos códigos de cadeia de amostra incluídos no Oracle Blockchain Platform, Balance Transfer e Marbles. A amostra de Transferência de Saldo representa duas partes com a capacidade de transferir fundos entre saldos de conta. A amostra Marbles permite que você crie mármores e troque-os entre os proprietários. Você pode usar transações individuais (não atômicas) para comprar um mármore trocando fundos no código da cadeia de Transferência de Saldo e alterando a propriedade do mármore no código da cadeia de mármores. No entanto, se ocorrer um erro com uma dessas transações, o razão pode ser deixado em um estado inconsistente: ou os fundos foram transferidos, mas não o mármore ou o mármore é transferido, mas não pago.

Nesse cenário, você pode usar o chaincode existente com os pontos finais da API REST que suportam transações atômicas. A troca de fundos e a transferência de propriedade do mármore devem ter sucesso ou ambos falhar. Se uma das transações encontrar um erro, nenhuma delas será confirmada. Para explorar esse cenário, execute as seguintes etapas:

  1. Instale as amostras Balance Transfer e Marbles em diferentes canais. Para obter mais informações sobre como instalar as amostras, consulte Explorar o Oracle Blockchain Platform Usando Amostras.
  2. Na amostra de Mármores, chame a ação Create a new marble para criar vários mármores para vários proprietários de mármore.
  3. Use o ponto final REST Invoke Atomic Transaction para concluir transações atômicas que chamam os Mármores e as amostras de Transferência de Saldo.

Por exemplo, a transação a seguir transfere um mármore chamado marble1 para Tom e envia 50 moedas da conta a para a conta b. 

{
 "transactions": [
   {"chaincode":"obcs-marbles","args":["transferMarble", "marble1", "tom"],"timeout":0, "channel":"goods"},
   {"chaincode":"obcs-example02","args":["invoke", "a", "b", "50"],"timeout":0, "channel":"wallet"}
 ],
 "isolationLevel": "serializable",
 "prepareTimeout": 10000,
 "sync": true
}

Na transação anterior, se ambas as transações forem bem-sucedidas na fase de preparação, ambas serão confirmadas no razão. Se houver um erro em uma das transações, nenhuma delas será confirmada durante a segunda fase. Em vez disso, ambas as transações são submetidas a rollback. Por exemplo, se houver menos de 50 moedas na conta a, nenhum dinheiro será retirado da conta e nenhum mármore será transferido para Tom.