為債券市集部署和測試包裝程式 API
部署包裝程式 API 套件
您必須先更新必要的組態變數，才能部署包裝函式 API 套裝程式。某些組態變數具有預設值，但您必須手動更新任何包含預留位置作為其預設值的變數。組態變數儲存在包裝函式 API 封存檔的 terraform.tfvars 檔案中。如需有關部署包裝函式 API 與組態變數的詳細資訊，請參閱 Wholesale CBDC 包裝函式 API 套件，以及 Blockchain App Builder for Oracle Blockchain Platform 中的包裝函式 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 |
BondMarketplace |
要產生包裝函式 API 的鏈碼名稱。 |
blockchain_sync |
true |
要包含在 API 呼叫之有效負載中的同步值。 |
blockchain_timeout |
6000 |
要包含在 API 呼叫之有效負載中的逾時值。 |
vcn_display_name |
BondMarketplace |
OCI 虛擬雲端網路的顯示名稱。 |
application_display_name |
BondMarketplace |
OCI 應用程式的顯示名稱。 |
gateway_display_name |
BondMarketplace |
API 閘道的顯示名稱。 |
deployment_display_name |
BondMarketplace |
API 閘道中部署的顯示名稱。 |
deployment_path_prefix |
/BondMarketplace |
API 閘道中的部署路徑前置碼，指定部署路由的路徑。deployment_path_prefix 變數的開頭必須是斜線 (/)。
|
ocir_repo_name |
bondmarketplace |
OCI 登錄儲存區域名稱。ocir_repo_name 變數必須全部為小寫字母。
|
policy_name |
BondMarketplace |
透過組織中群組和區間的定義權限，啟用控制管理與存取 API 之原則的名稱 |
債券市集樣本處理流程
使用債券市集包裝程式 API 的典型處理流程會遵循這些基本步驟。- 管理員可以使用
createUserAccount和createTokenAccount方法，為所有使用者建立個別的 NFT 帳戶。 - 管理員會使用
addRole方法，將 minter 角色指派給參與金融機構的主管 (例如，FI-1 Bond Issuer)。 - 金融機構主管 (債券發行人) 使用
createBondToken方法將債券發行為分數 NFT。 - 金融機構主管使用
getTokenById方法來複查和確認已發行債券的明細。 - 債券買方 (例如，組織使用者) 使用
atomicTransaction方法呼叫purchaseToken方法來購買小數 NFT 債券，並使用批發 CBDC 鏈碼進行付款。 - 買方會使用
balanceOfBatch方法來驗證其公事包中收到的債券。 - 採購人員使用
getAccountBalance方法 (批發 CBDC 鏈碼) 來確認其批發 CBDC 公事包中的轉帳。 - 債券發行人使用
atomicTransaction方法呼叫payInterest方法，使用批發 CBDC 鏈碼向債券持有人定期支付利息。 - 購買者使用
requestTokenRedemption方法提交要求，以便在債券到期後贖回債券。 - 金融機構主管使用
atomicTransaction方法呼叫approveTokenRedemption方法來核准贖回要求，以及將批發 CBDC 資金移轉給債券持有人。 - 債券持有人使用
balanceOfBatch方法 (債券市集鏈碼) 和getAccountBalance方法 (批發 CBDC 鏈碼)，以確認債券已贖回，並在其批發 CBDC 公事包中收到資金。
Postman Collection
債券市場包裝程式 API 套件中的 Postman 集合包括支援債券市場鏈碼的其他屬性和方法。下表顯示債券市集套件特定的 Postman 收集變數。
| 變數 | 描述 | 預設值 |
|---|---|---|
bc-instance-client-id |
Oracle Blockchain Platform 雲端服務的從屬端 ID。 | bc-instance-client-id |
bc-instance-client-secret |
Oracle Blockchain Platform 雲端服務的從屬端加密密碼。 | bc-instance-client-secret |
int-app-client-id |
Oracle Identity Cloud Service (IDCS) 機密應用程式的從屬端 ID，用於在 CreateIDCS 使用者 API 中建立 IDCS 使用者。
|
應用程式內部用戶端 ID |
int-app-client-secret |
IDCS 機密應用程式的從屬端加密密碼，用於在 CreateIDCS 使用者 API 中建立 IDCS 使用者。
|
應用程式內部從屬端加密密碼 |
如需詳細資訊，請參閱 Blockchain App Builder for Oracle Blockchain Platform 中的 Wrapper API 套件元件。