Distribuisci e testa API wrapper per Bond Marketplace

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 Package API wrapper CBDC all'ingrosso e anche 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 marketplace delle obbligazioni.

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_url`	`<blockchain_url>`	URL di Oracle Blockchain Platform associato alla distribuzione del codice concatenato.
`idcs_url`	`<idcs_url>`	L'URL di Identity Cloud Service.
`idcs_port`	`<idcs_port>`	Il numero di porta di Identity Cloud Service.
`cbdc_chaincode`	`<cbdc_chaincode>`	Nome del codice concatenato CBDC all'ingrosso.
`cbdc_channel`	`<cbdc_channel>`	Canale in cui viene distribuito il codice concatenato CBDC all'ingrosso.
`isolation_level`	`<isolation_level>`	Livello di isolamento per le transazioni atomiche. In genere si tratta di `serializable`.
`blockchain_chaincode`	`BondMarketplace`	Nome del codice concatenato per il quale generare le API wrapper.
`blockchain_sync`	`true`	Il valore di sincronizzazione da includere nel payload per le chiamate API.
`blockchain_timeout`	`6000`	Il valore di timeout da includere nel payload per le chiamate API.
`vcn_display_name`	`BondMarketplace`	Nome visualizzato della rete cloud virtuale OCI.
`application_display_name`	`BondMarketplace`	Il nome visualizzato dell'applicazione OCI.
`gateway_display_name`	`BondMarketplace`	Nome visualizzato del gateway API.
`deployment_display_name`	`BondMarketplace`	Il nome visualizzato della distribuzione nel gateway API.
`deployment_path_prefix`	`/BondMarketplace`	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`	`bondmarketplace`	Nome del repository di OCI Registry. La variabile `ocir_repo_name` deve contenere tutte le lettere minuscole.
`policy_name`	`BondMarketplace`	Nome del criterio che consente la gestione controllata e l'accesso alle API tramite autorizzazioni definite per gruppi e compartimenti nell'organizzazione

Flusso del processo di esempio Bond Marketplace

Un tipico flusso di processo che utilizza le API wrapper del marketplace delle obbligazioni segue questi passaggi di base.

Gli amministratori utilizzano i metodi createUserAccount e createTokenAccount per creare singoli account NFT per tutti gli utenti.
Gli amministratori utilizzano il metodo addRole per assegnare il ruolo minter ai funzionari degli istituti finanziari partecipanti (ad esempio, FI-1 Bond Issuer).
I funzionari degli istituti finanziari (emittenti obbligazionari) utilizzano il metodo createBondToken per emettere obbligazioni come NFT frazionarie.
I funzionari degli istituti finanziari utilizzano il metodo getTokenById per rivedere e confermare i dettagli delle obbligazioni emesse.
Gli acquirenti di obbligazioni (ad esempio, un utente dell'organizzazione) utilizzano il metodo atomicTransaction per chiamare il metodo purchaseToken per acquistare l'obbligazione NFT frazionaria e per effettuare un pagamento utilizzando il codice concatenato CBDC all'ingrosso.
Gli acquirenti utilizzano il metodo balanceOfBatch per verificare la ricezione dell'obbligazione nel loro portafoglio.
Gli acquirenti utilizzano il metodo getAccountBalance (codice concatenato CBDC all'ingrosso) per confermare il trasferimento nel portafoglio CBDC all'ingrosso.
Gli emittenti di obbligazioni utilizzano il metodo atomicTransaction per chiamare il metodo payInterest per pagare interessi periodici agli obbligazionisti utilizzando il codice concatenato CBDC all'ingrosso.
Gli acquirenti utilizzano il metodo requestTokenRedemption per inviare una richiesta di riscatto della loro obbligazione dopo la sua scadenza.
I funzionari degli istituti finanziari utilizzano il metodo atomicTransaction per richiamare il metodo approveTokenRedemption per approvare la richiesta di rimborso e per trasferire fondi CBDC all'ingrosso al titolare dell'obbligazione.
Il titolare dell'obbligazione utilizza il metodo balanceOfBatch (codice concatenato del mercato obbligazionario) e il metodo getAccountBalance (codice concatenato CBDC all'ingrosso) per verificare che l'obbligazione sia stata riscattata e che abbia ricevuto fondi nel portafoglio CBDC all'ingrosso.

Collezione Postman

La raccolta Postman nel pacchetto API wrapper del marketplace delle obbligazioni include attributi e metodi aggiuntivi che supportano il codice concatenato del marketplace delle obbligazioni. La tabella seguente mostra le variabili di raccolta Postman specifiche del pacchetto marketplace obbligazioni.

Variabile	Descrizione	Valore predefinito
`bc-instance-client-id`	ID client del servizio cloud Oracle Blockchain Platform.	`id-cliente-istanza-bc`
`bc-instance-client-secret`	Il segreto client del servizio cloud Oracle Blockchain Platform.	`bc-instance-client-secret`
`int-app-client-id`	L'ID client dell'applicazione riservata IDCS (Oracle Identity Cloud Service), utilizzato per creare un utente IDCS nell'API utente `CreateIDCS`.	`int-app-client-id`
`int-app-client-secret`	Il segreto client dell'applicazione riservata IDCS, utilizzato per creare un utente IDCS nell'API utente `CreateIDCS`.	`segreto client int-app`

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