部署及測試批發 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 的典型處理流程會遵循這些基本步驟。- 管理員使用
initializeCBDCToken
API 來初始化批發 CBDC 系統。 - 管理員使用
createAccount
和associateTokenToAccount
API 來建立帳戶,並將記號關聯至系統中所有建立者、中央銀行核准者、發行者、金融機構主管、金融機構核准者及金融機構使用者的帳戶。 - 管理員使用
addRole
API 將 minter 角色指派給建立者,並將公證人角色指派給中央銀行核准者。 - 權杖建立者使用
requestCBDCCreation
API 將要求送出貨幣提示。 - 中央銀行核准者使用
approveCBDCCreation
API 複查,並核准貨幣採礦要求。幣別會記入建立者的帳戶。 - 發行者使用
getCBDCAccountBalance
API 驗證銷退折讓金額是否正確。 - 建立者使用
transferCBDCTokens
API 將幣別移轉給核發者。 holdCBDCTokens
API 是用來開始將幣別轉移至金融機構主管。- 中央銀行核准者使用
approveHoldCBDCTokens
API 核准貨幣轉帳給金融機構主管。貨幣會記入金融機構主管的帳戶。 - 金融機構主管使用
getCBDCAccountBalance
API 驗證銷退折讓金額是否正確。 - 金融機構主管使用
holdCBDCTokens
API 開始將幣別轉移至金融機構使用者。 - 金融機構核准者使用
approveHoldCBDCTokens
API 核准貨幣轉帳給金融機構使用者。貨幣會記入金融機構使用者的帳戶。 - 金融機構使用者可使用
getCBDCAccountBalance
API 驗證銷退折讓金額是否正確。
Postman Collection
批發 CBDC 包裝函式 API 套件中的 Postman 集合包含其他支援批發 CBDC 鏈碼的屬性與 API。如需詳細資訊,請參閱 Wrapper API Package Components 。