為債券市集部署和測試包裝程式 API

部署包裝程式 API 套件

您必須先更新必要的組態變數,才能部署包裝函式 API 套件。部分組態變數具有預設值,但您必須手動更新任何包含預留位置的變數作為其預設值。組態變數儲存在包裝函式 API 存檔的 terraform.tfvars 檔案中。如需有關部署包裝函式 API 與組態變數的詳細資訊,請參閱包裝函式 API批發 CBDC 包裝函式 API 套件。下表列出債券市集包裝函式 API 套件的組態變數及其預設值。

變數名稱 預設值 描述
compartment_ocid <compartment_ocid> Oracle Cloud Infrastructure (OCI) 中區間的 OCID。
compartment_name <compartment_name> OCI 區間的名稱。
identity_domain <identity_domain> 要使用的識別網域。
blockchain_channel <blockchain_channel> 部署鏈碼之 Oracle Blockchain Platform 通道的名稱。
blockchain_url <blockchain_url> 與鏈碼部署關聯的 Oracle Blockchain Platform URL。
idcs_url <idcs_url> Identity Cloud Service 的 URL。
idcs_port <idcs_port> Identity Cloud Service 的連接埠號碼。
cbdc_chaincode <cbdc_chaincode> 批發 CBDC 鏈碼的名稱。
cbdc_channel <cbdc_channel> 批發 CBDC 鏈碼的部署管道。
isolation_level <isolation_level> 原子交易的隔離層次。一般來說,這是 serializable.。
blockchain_chaincode WholesaleCBDC 要產生包裝函式 API 的鏈碼名稱。
blockchain_sync true 要包含在 API 呼叫之有效負載中的同步值。
blockchain_timeout 6000 要包含在 API 呼叫之有效負載中的逾時值。
vcn_display_name WholesaleCBDC OCI 虛擬雲端網路的顯示名稱。
application_display_name WholesaleCBDC OCI 應用程式的顯示名稱。
gateway_display_name WholesaleCBDC API 閘道的顯示名稱。
deployment_display_name WholesaleCBDC API 閘道中部署的顯示名稱。
deployment_path_prefix /WholesaleCBDC API 閘道中的部署路徑前置碼,指定部署路由的路徑。deployment_path_prefix 變數的開頭必須是斜線 (/)。
ocir_repo_name wholesalecbdc OCI 登錄儲存區域名稱。ocir_repo_name 變數必須全部為小寫字母。
policy_name WholesaleCBDC 可透過組織內群組和區間的定義權限,對 API 進行控制管理和存取的原則名稱

債券市集樣本處理流程

使用債券市集包裝程式 API 的典型處理流程會遵循這些基本步驟。
  1. 管理員可以使用 createUserAccountcreateTokenAccount 方法,為所有使用者建立個別的 NFT 帳戶。
  2. 管理員會使用 addRole 方法,將 minter 角色指派給參與金融機構的主管 (例如,FI-1 Bond Issuer)。
  3. 金融機構主管 (債券發行人) 使用 createBondToken 方法將債券發行為分數 NFT。
  4. 金融機構主管使用 getTokenById 方法來複查和確認已發行債券的明細。
  5. 債券買方 (例如,FI User) 使用 atomicTransaction 方法呼叫 purchaseToken 方法來購買部分 NFT 債券,並使用批發 CBDC 鏈碼進行付款。
  6. 買方會使用 balanceOfBatch 方法來驗證其公事包中收到的債券。
  7. 採購人員使用 getAccountBalance 方法 (批發 CBDC 鏈碼) 來確認其批發 CBDC 公事包中的轉帳。
  8. 債券發行人使用 atomicTransaction 方法呼叫 payInterest 方法,使用批發 CBDC 鏈碼向債券持有人定期支付利息。
  9. 購買者使用 requestTokenRedemption 方法提交要求,以便在債券到期後贖回債券。
  10. 金融機構主管使用 atomicTransaction 方法呼叫 approveTokenRedemption 方法來核准贖回要求,以及將批發 CBDC 資金移轉給債券持有人。
  11. 債券持有人使用 balanceOfBatch 方法 (債券市集鏈碼) 和 getAccountBalance 方法 (批發 CBDC 鏈碼),以確認債券已贖回,並在其批發 CBDC 公事包中收到資金。

Postman Collection

債券市集包裝函式 API 套件中的 Postman 集合包含其他支援債券市場鏈碼的屬性與方法。如需詳細資訊,請參閱 Wrapper API Package Components