部署及測試批發 CBDC 的包裝程式 API

部署包裝程式 API 套件

您必須先更新必要的組態變數,才能部署包裝函式 API 套件。部分組態變數具有預設值,但您必須手動更新任何包含預留位置的變數作為其預設值。組態變數儲存在包裝函式 API 存檔的 terraform.tfvars 檔案中。如需有關部署包裝函式 API 與組態變數的詳細資訊,請參閱包裝函式 API 。下表列出批發 CBDC 包裝程式 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。
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 進行控制管理和存取的原則名稱

如需 Postman 集合的相關資訊,請參閱 Wrapper API Package Components

批發 CBDC 樣品處理流程

使用批發 CBDC 包裝函式 API 的典型處理流程會遵循這些基本步驟。
  1. 管理員使用 initializeCBDCToken API 來初始化批發 CBDC 系統。
  2. 管理員使用 createAccountassociateTokenToAccount API 來建立帳戶,並將記號關聯至系統中所有建立者、中央銀行核准者、發行者、金融機構主管、金融機構核准者及金融機構使用者的帳戶。
  3. 管理員使用 addRole API 將 minter 角色指派給建立者,並將公證人角色指派給中央銀行核准者。
  4. 權杖建立者使用 requestCBDCCreation API 將要求送出貨幣提示。
  5. 中央銀行核准者使用 approveCBDCCreation API 複查,並核准貨幣採礦要求。幣別會記入建立者的帳戶。
  6. 發行者使用 getCBDCAccountBalance API 驗證銷退折讓金額是否正確。
  7. 建立者使用 transferCBDCTokens API 將幣別移轉給核發者。
  8. holdCBDCTokens API 是用來開始將幣別轉移至金融機構主管。
  9. 中央銀行核准者使用 approveHoldCBDCTokens API 核准貨幣轉帳給金融機構主管。貨幣會記入金融機構主管的帳戶。
  10. 金融機構主管使用 getCBDCAccountBalance API 驗證銷退折讓金額是否正確。
  11. 金融機構主管使用 holdCBDCTokens API 開始將幣別轉移至金融機構使用者。
  12. 金融機構核准者使用 approveHoldCBDCTokens API 核准貨幣轉帳給金融機構使用者。貨幣會記入金融機構使用者的帳戶。
  13. 金融機構使用者可使用 getCBDCAccountBalance API 驗證銷退折讓金額是否正確。

Postman Collection

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