為債券市集部署和測試包裝程式 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 的典型處理流程會遵循這些基本步驟。- 管理員可以使用
createUserAccount
和createTokenAccount
方法,為所有使用者建立個別的 NFT 帳戶。 - 管理員會使用
addRole
方法,將 minter 角色指派給參與金融機構的主管 (例如,FI-1 Bond Issuer
)。 - 金融機構主管 (債券發行人) 使用
createBondToken
方法將債券發行為分數 NFT。 - 金融機構主管使用
getTokenById
方法來複查和確認已發行債券的明細。 - 債券買方 (例如,
FI User
) 使用atomicTransaction
方法呼叫purchaseToken
方法來購買部分 NFT 債券,並使用批發 CBDC 鏈碼進行付款。 - 買方會使用
balanceOfBatch
方法來驗證其公事包中收到的債券。 - 採購人員使用
getAccountBalance
方法 (批發 CBDC 鏈碼) 來確認其批發 CBDC 公事包中的轉帳。 - 債券發行人使用
atomicTransaction
方法呼叫payInterest
方法,使用批發 CBDC 鏈碼向債券持有人定期支付利息。 - 購買者使用
requestTokenRedemption
方法提交要求,以便在債券到期後贖回債券。 - 金融機構主管使用
atomicTransaction
方法呼叫approveTokenRedemption
方法來核准贖回要求,以及將批發 CBDC 資金移轉給債券持有人。 - 債券持有人使用
balanceOfBatch
方法 (債券市集鏈碼) 和getAccountBalance
方法 (批發 CBDC 鏈碼),以確認債券已贖回,並在其批發 CBDC 公事包中收到資金。
Postman Collection
債券市集包裝函式 API 套件中的 Postman 集合包含其他支援債券市場鏈碼的屬性與方法。如需詳細資訊,請參閱 Wrapper API Package Components 。