为机密批发 CBDC 部署和测试包装 API
部署 Wrapper API 程序包
必须先更新所需的配置变量，然后才能部署包装 API 软件包。某些配置变量具有默认值，但必须手动更新包含占位符作为其默认值的任何变量。配置变量存储在包装器 API 档案中的 terraform.tfvars 文件中。有关部署包装 API 和配置变量的更多信息，请参见 Blockchain App Builder for Oracle Blockchain Platform 中的 Wrapper 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_chaincode |
<chaincode_name> |
要为其生成包装 API 的链代码的名称。 |
blockchain_url |
<blockchain_url> |
与链代码部署关联的 Oracle Blockchain Platform URL。 |
blockchain_sync |
true |
要包括在 API 调用有效负载中的同步值。 |
blockchain_timeout |
6000 |
要包括在 API 调用有效负载中的超时值。 |
vcn_display_name |
WholesaleCBDCWithConfidentialPayment |
OCI 虚拟云网络的显示名称。 |
application_display_name |
WholesaleCBDCWithConfidentialPayment |
OCI 应用程序的显示名称。 |
gateway_display_name |
WholesaleCBDCWithConfidentialPayment |
API 网关的显示名称。 |
gateway_ocids |
{} |
要使用的现有 API 网关实例的 OCID 列表。 |
deployment_display_name |
WholesaleCBDCWithConfidentialPayment |
API 网关中部署的显示名称。 |
deployment_path_prefix |
/WholesaleCBDCWithConfidentialPayment |
API 网关中的部署路径前缀，用于指定部署路由的路径。deployment_path_prefix 变量必须以斜杠 (/) 开头。
|
ocir_repo_name |
wholesalecbdcwithconfidentialpayment |
OCI 注册表资料档案库名称。ocir_repo_name 变量必须全部为小写字母。
|
policy_name |
WholesaleCBDCWithConfidentialPayment |
该策略的名称，通过为组织中的组和区间定义的权限来控制对 API 的管理和访问 |
isolationLevel |
serializable |
事务隔离级别，用于确保两阶段提交过程中的并发控制和一致性。 |
有关 Postman 集合的信息，请参阅 Blockchain App Builder for Oracle Blockchain Platform 中的 Wrapper API Package Components 。
批发 CBDC 样品处理流程
使用批发 CBDC 包装 API 的典型流程遵循以下基本步骤。- 管理员使用
initializeCBDCTokenAPI 初始化批发 CBDC 系统。 - 管理员使用
createAccount和associateTokenToAccountAPI 创建帐户，并将令牌与系统中所有创建者、中央银行审批人、发行人、金融机构高管、金融机构审批人和金融机构用户的帐户关联。 - 管理员使用
addRoleAPI 将 minter 角色分配给创建者，将公证角色分配给中央银行审批者。 - 令牌创建者使用
requestCBDCCreationAPI 向 mint 货币提交请求。 - 央行批准人使用
approveCBDCCreationAPI 审查并批准薄荷货币申请。货币贷记到创建者的账户。 - 发卡商使用
getCBDCAccountBalanceAPI 验证贷记金额是否准确。 - 创建者使用
transferCBDCTokensAPI 将货币转移给发行者。 holdCBDCTokensAPI 用于开始将货币转移给金融机构官员。- 央行批准人使用
approveHoldCBDCTokensInterOrgAPI 批准将货币转移给金融机构官员。该货币贷记到金融机构官员的帐户中。 - 金融机构负责人使用
getCBDCAccountBalanceAPI 验证贷记金额是否准确。 - 金融机构负责人使用
holdCBDCTokensAPI 开始将货币转移给金融机构用户。 - 金融机构审批人使用
approveHoldCBDCTokensAPI 批准将货币转移给金融机构用户。货币贷记到金融机构用户的帐户。 - 金融机构用户使用
getCBDCAccountBalanceAPI 验证贷记金额是否准确。
邮递员
机密批发 CBDC 包装 API 包中的 Postman 集合包括支持批发 CBDC 链代码的其他属性和 API。有关详细信息，请参阅 Blockchain App Builder for Oracle Blockchain Platform 中的 Wrapper API Package Components 。