為 Stablecoin 部署及測試包裝函式 API
部署包裝程式 API 套裝程式
您必須先更新必要的組態變數，才能部署包裝函式 API 套裝程式。某些組態變數具有預設值，但您必須手動更新任何包含預留位置作為其預設值的變數。組態變數儲存在包裝函式 API 封存檔的 terraform.tfvars 檔案中。如需有關部署包裝函式 API 和組態變數的詳細資訊，請參閱 Blockchain App Builder for Oracle Blockchain Platform 中的 Wrapper API 。下表列出 stablecoin 包裝函式 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 |
Stablecoin |
要產生包裝程式 API 的鏈碼名稱。 |
blockchain_sync |
true |
要包含在 API 呼叫之有效負載中的同步值。 |
blockchain_timeout |
6000 |
要包含在 API 呼叫之有效負載中的逾時值。 |
vcn_display_name |
Stablecoin |
OCI 虛擬雲端網路的顯示名稱。 |
application_display_name |
Stablecoin |
OCI 應用程式的顯示名稱。 |
gateway_display_name |
Stablecoin |
API 閘道的顯示名稱。 |
deployment_display_name |
Stablecoin |
API 閘道中部署的顯示名稱。 |
deployment_path_prefix |
/Stablecoin |
API 閘道中的部署路徑前置碼，指定部署路由的路徑。deployment_path_prefix 變數必須以斜線 (/) 開頭。
|
ocir_repo_name |
Stablecoin |
OCI 登錄儲存區域名稱。ocir_repo_name 變數必須全部都是小寫字母。
|
policy_name |
Stablecoin |
透過組織中群組和區間的定義權限，啟用控制管理與存取 API 之原則的名稱 |
Stablecoin 樣本處理流程
使用穩定幣包裝程式 API 的典型處理流程遵循這些基本步驟。- 記號管理員使用
initializeStablecoinToken方法來初始化具有固定currencyName值 (例如USD) 和conversionRate值的穩定貨幣。 - 記號管理員使用
createAccount和associateTokenToAccount方法，為所有使用者 (多層級核准者、minters、notaries、寄件者及接收者) 建立記號帳戶。 - 記號管理員使用
createStablecoinAccountPolicyCheck方法來建立帳戶原則。所有轉移或持有穩定幣的帳戶都必須使用帳戶政策。每個帳戶原則包含三個參數：KYC、AML和restrictionFlag。 - 記號管理員使用
createApprovalPolicyCheck來建立核准原則。核准原則可定義異動臨界值、必要的核准數目，以及核准者詳細資訊，並設定多層次核准的順序。保留作業必須要有核准原則。若無核准原則，使用者在套用限制時無法保留或移轉權杖。 - 記號管理員使用
addRole方法，將礦工、燒錄機和公證角色指派給適當的帳戶。 - 礦工使用
requestMint方法，將要求提交至薄荷穩定幣。 - 公證人使用
approveMint方法來核准 minting 要求。 - 寄件者使用
holdTokens方法來起始傳輸。系統會對寄送方與接收方執行帳戶政策檢查。如果不符合任一帳戶的 KYC 或 AML 規範，則不允許轉移。如果任一帳戶的限制旗標設為true，則只有最低核准原則臨界值範圍中的金額可以保留。接著，移轉金額會與核准政策臨界值進行比對，必要核准者及其核准順序會衍生自核准政策。 - 多層次核准者使用
approveTransaction方法，以核准原則中定義的確切順序複查和授權傳輸。如果核准原則指定零核准者，公證人可以直接使用executeHoldTokens方法來完成交易。系統會在每次呼叫executeHoldTokens與approveTransaction時，重新驗證 KYC 與 AML 規範與限制標誌。如果有任何檢查失敗，交易就會被封鎖。 - 成功完成所有核准後，指派的公證人會使用
executeHoldTokens方法來完成轉移到接收者的帳戶。 - 燒錄機使用
requestBurn方法提交燒錄穩定幣的要求。 - 公證人使用
approveBurn方法來核准燒錄要求。 - 記號管理員和稽核者使用
getStablecointAccountTransactionHistory和getStablecoinAccountTransactionHistoryWithFilters來追蹤所有記號事件，包括探勘、保留、多層次核准流程、傳輸及燒錄。
Postman Collection
穩定幣包裝程式 API 套件中的 Postman 集合包含其他支援穩定幣鏈碼的屬性與方法。下表顯示 Stablecoin 套件特定的 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 套件元件。