Distribuisci e testa API wrapper per CBDC all'ingrosso riservato

Distribuzione del package API wrapper

Prima di poter distribuire il package API wrapper, è necessario aggiornare le variabili di configurazione richieste. Alcune variabili di configurazione hanno valori predefiniti, ma è necessario aggiornare manualmente qualsiasi variabile che contiene un segnaposto come valore predefinito. Le variabili di configurazione vengono memorizzate nel file terraform.tfvars nell'archivio API wrapper. Per ulteriori informazioni sulla distribuzione delle API wrapper e sulle variabili di configurazione, vedere API wrapper in Blockchain App Builder for Oracle Blockchain Platform. Nella tabella seguente sono elencate le variabili di configurazione e i relativi valori predefiniti per il package API wrapper CBDC all'ingrosso. Se il valore predefinito contiene segnaposto, indica che l'utente deve fornire manualmente i valori necessari.

Nome variabile Valore predefinito Descrizione
compartment_ocid <compartment_ocid> OCID del compartimento in Oracle Cloud Infrastructure (OCI).
compartment_name <compartment_name> Nome del compartimento OCI.
identity_domain <identity_domain> Il dominio di Identity da utilizzare.
blockchain_channel <blockchain_channel> Nome del canale Oracle Blockchain Platform in cui viene distribuito il codice concatenato.
blockchain_chaincode <chaincode_name> Nome del codice concatenato per il quale generare le API wrapper.
blockchain_url <blockchain_url> URL di Oracle Blockchain Platform associato alla distribuzione del codice concatenato.
blockchain_sync true Il valore di sincronizzazione da includere nel payload per le chiamate API.
blockchain_timeout 6000 Valore di timeout da includere nel payload per le chiamate API.
vcn_display_name WholesaleCBDCWithConfidentialPayment Nome visualizzato della rete cloud virtuale OCI.
application_display_name WholesaleCBDCWithConfidentialPayment Nome visualizzato dell'applicazione OCI.
gateway_display_name WholesaleCBDCWithConfidentialPayment Nome visualizzato del gateway API.
gateway_ocids {} Lista di OCID delle istanze di gateway API esistenti da utilizzare.
deployment_display_name WholesaleCBDCWithConfidentialPayment Nome visualizzato della distribuzione nel gateway API.
deployment_path_prefix /WholesaleCBDCWithConfidentialPayment Prefisso del percorso di distribuzione nel gateway API, che specifica il percorso in cui vengono distribuiti gli instradamenti. La variabile deployment_path_prefix deve iniziare con una barra (/).
ocir_repo_name wholesalecbdcwithconfidentialpayment Nome del repository del registro OCI. La variabile ocir_repo_name deve essere composta da tutte le lettere minuscole.
policy_name WholesaleCBDCWithConfidentialPayment Nome del criterio che consente la gestione controllata e l'accesso alle API tramite autorizzazioni definite per gruppi e compartimenti nell'organizzazione
isolationLevel serializable Livello di isolamento delle transazioni, utilizzato per garantire il controllo e la coerenza della concorrenza durante il processo di commit in due fasi.

Per informazioni sulla raccolta Postman, vedere Componenti del package API wrapper in Blockchain App Builder for Oracle Blockchain Platform.

Flusso processo campione CBDC all'ingrosso

Un tipico flusso di processo che utilizza le API wrapper CBDC all'ingrosso segue questi passaggi di base.
  1. L'amministratore utilizza l'API initializeCBDCToken per inizializzare il sistema CBDC all'ingrosso.
  2. L'amministratore utilizza le API createAccount e associateTokenToAccount per creare conti e associare il token a conti per tutti gli autori, gli approvatori delle banche centrali, gli emittenti, i funzionari degli istituti finanziari, gli approvatori degli istituti finanziari e gli utenti degli istituti finanziari nel sistema.
  3. L'amministratore utilizza l'API addRole per assegnare il ruolo più piccolo all'autore e il ruolo notaio all'approvatore della banca centrale.
  4. L'autore del token utilizza l'API requestCBDCCreation per sottomettere una richiesta alla valuta di conversione.
  5. L'approvatore della banca centrale utilizza la revisione dell'API approveCBDCCreation e approva la richiesta di conversione della valuta. La valuta viene accreditata sul conto dell'autore.
  6. L'emittente utilizza l'API getCBDCAccountBalance per verificare che l'importo accreditato sia accurato.
  7. L'autore utilizza l'API transferCBDCTokens per trasferire la valuta all'emittente.
  8. L'API holdCBDCTokens viene utilizzata per avviare il trasferimento di valuta a un funzionario dell'istituto finanziario.
  9. L'approvatore della banca centrale utilizza l'API approveHoldCBDCTokensInterOrg per approvare il trasferimento di valuta al responsabile dell'istituto finanziario. La valuta viene accreditata sul conto del funzionario dell'istituto finanziario.
  10. Il responsabile dell'istituto finanziario utilizza l'API getCBDCAccountBalance per verificare che l'importo accreditato sia accurato.
  11. Il responsabile dell'istituto finanziario utilizza l'API holdCBDCTokens per avviare il trasferimento di valuta a un utente dell'istituto finanziario.
  12. L'approvatore dell'istituto finanziario utilizza l'API approveHoldCBDCTokens per approvare il trasferimento di valuta all'utente dell'istituto finanziario. La valuta viene accreditata sul conto dell'utente dell'istituto finanziario.
  13. L'utente dell'istituto finanziario utilizza l'API getCBDCAccountBalance per verificare che l'importo accreditato sia accurato.

Collezione Postman

La raccolta Postman nel pacchetto API wrapper CBDC all'ingrosso riservato include attributi e API aggiuntivi che supportano il codice concatenato CBDC all'ingrosso. Per ulteriori informazioni, vedere Componenti del package API wrapper in Blockchain App Builder for Oracle Blockchain Platform.